Scene document: accept the Stories fields only from version 7

stories, storyThumb and storyTags arrived with version 7, so they are
gated by version like anchors and dataPacks.
This commit is contained in:
Sameh Khamis committed 2026-11-16 13:40:17 -08:00
1 parent 1fa053e22d
commit 20f6ceb74c
4 files changed
+30 -14

No files matched your search

+1 -1
View File
@@ -1639,7 +1639,7 @@ rules own presentation overrides and Nepal map fallback without changing saved
shots or content. Scene-document validation and legacy migration now have separate
owners. Invalid imports preserve the current project; unreadable saved projects
are protected from fallback writes. Version 7 adds Scenes' optional Stories
metadata and reads prior project files, including version 6 drafts, with
metadata (accepted only in version 7 documents) and reads prior project files with
zero pitch, low camera heights, scope and detection edits preserved. See [the document contract](SCENE-DOCUMENT.md);
see [Director](DIRECTOR.md) for camera, pack, action and sharing support.
+4 -5
View File
@@ -1,8 +1,7 @@
# Scene document format
Authoring exports a UTF-8 JSON project. Version 7 records Stories metadata.
Versions 1 through 6 and unversioned legacy files migrate on import, including
version 6 projects written by early Stories builds. Existing shots keep their
Versions 1 through 6 and unversioned legacy files migrate on import. Existing shots keep their
camera behavior. Unknown versions or unsupported fields are rejected with a
field path before the current project, selection or saved bytes change.
@@ -34,9 +33,9 @@ Each scene requires a `shots` array; optional fields are `id`, `title`,
`releaseLayerIds`, `appliedShotPacks` and version-4 `anchors`. A pack marker has `id`, optional numeric
`version` and `shotBindings` (original shot title to saved shot ID). These markers
retain the editor's existing pack-update and rename behavior.
Scenes may include `stories` (true when saved to Stories), `storyThumb`
(a JPEG or PNG data URL of at most 300,000 characters) and `storyTags` (up to
five supported topic keys).
From version 7, scenes may include `stories` (true when saved to Stories),
`storyThumb` (a JPEG or PNG data URL of at most 300,000 characters) and
`storyTags` (up to five supported topic keys).
Shots accept `id`, `title`, `durationSec`, `holdSec`, `camera`, `visual`, `layers`,
`sourcePackId`, `sourcePackVersion` and version-4 `move`. Scene IDs are unique within the project;