Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
merge: integrate v2 architecture with main tooling
kashorine366167a63bb
diff --cc docs/guide/packages.mdindex d63df416,629d9764..f07cc636--- a/docs/guide/packages.md+++ b/docs/guide/packages.md@@@ -66,10 -71,11 +71,10 @@@ Depends on Layer 1 and 2 but not on an@narratage/media media types@narratage/narrative authored narrative products@narratage/program-space exact frame/sample domain- @narratage/generation image/video product contracts+ @narratage/generation image/video/audio generation contracts@narratage/model-kit model family abstractions@narratage/seedance Seedance model family + author Surface- @narratage/seedance-speaker Seedance Speaker binding+ @narratage/seedance-kits data-only Seedance semantic Text Templates-@narratage/seedance-speaker Seedance Speaker binding@narratage/minimax-h3 MiniMax H3 model family@narratage/gemini-omni Gemini Omni model family@narratage/grok-imagine Grok Imagine model family@@@ -132,7 -151,7 +150,7 @@@ never on exact-model packages or the CL3. **CLI independence.** Neither `@narratage/cli` nor `@narratage/video-cli` transitively depends on anyProvider package. The video CLI also does not depend on any author-level video package- (`@narratage/script`, `@narratage/seedance-speaker`, `@narratage/broll`, `@narratage/text-track`, `@narratage/film`).- (`@narratage/script`, `@narratage/seedance-speaker`, `@narratage/media-track`, `@narratage/typography-track`, `@narratage/film`).++ (`@narratage/script`, `@narratage/seedance`, `@narratage/media-track`, `@narratage/typography-track`, `@narratage/film`).Author packages are activated through the explicit package lock, not compile-time CLIdependencies.diff --cc docs/guide/playground.mdindex 7d6d8524,00000000..1321ae04mode 100644,000000..100644--- a/docs/guide/playground.md+++ b/docs/guide/playground.md@@@ -1,106 -1,0 +1,107 @@@+---+title: Component Playground+description: Previewing a visual component without running a Build.+---++# Component Playground++Seeing what a caption or an overlay looks like normally costs a whole Build:+Author Source, Run Source, a Runtime Profile, generation, alignment, render. The+playground renders one component on its own, in a browser, in milliseconds.++```bash+pnpm playground+```++Then open `http://localhost:5178`. Nothing else is needed — no Runtime Profile,+no credentials, no local services.++## What you see++| Control | What it does |+|---|---|+| Component list | Every module that can put pixels on a frame |+| W / H / fps / sec | The canvas and the frame domain |- | Canvas from a stylesheet | Adopt a `.svs` file's frame size |++| Appearance from a stylesheet | Adopt a `.svs` Film Recipe's background |+| Input forms | One per input the component takes |+| Scrubber | Frame-exact; the counter shows `frame / last` |+- The preview is the real thing. Each component's own renderer runs —- `renderCaptionTrack`, `renderTextTrack`, `compileBrollProduct`,- `projectSpeechVisual` — and `compileHyperframesDocument` produces the same++The preview uses the installed modules' real Producer handlers. For example,++Fine Caption, Media Track, Screen Overlay, Speech Basis and Typography Track++all lower to `VisualTrack`, then `compileHyperframesDocument` produces the same+document a Build would render.++## It lists nothing++The playground has no list of components. It reads the manifests and offers+every module that declares a Producer whose output type is `VisualTrack`. Add a+module that emits one and it appears; stop emitting one and it disappears.++Everything else is read the same way:++| Question | Answered by |+|---|---|+| What a component needs | that Producer's `inputs` |+| What shape each input has | the declaring module's `TypeDeclaration.schema` |+| What to start from | that type's `TypeDeclaration.default` |+| What a control looks like | `ValueSchema.format` |++So a caption's `mode` is a dropdown because its schema declares an `enum`, and+its `display` is a text area because the field is `format: "multiline"`. Neither+is configured here.++## Formats++`format` is how a module says what a value means when its type alone is+ambiguous — a colour and a font family are both strings.++| Format | Control |+|---|---|+| `color` | Swatch beside a text box. The text is authoritative, because `#RRGGBBAA` carries alpha a swatch cannot. |+| `unit-fraction` | Slider plus a number box |+| `multiline` | Text area |+| `digest` | File picker |+| `duration` | Number box, in seconds |++`color` and `digest` have an exact shape, so `validateStoredValue` enforces+them. The others describe without narrowing.++## Media++A `format: "digest"` field takes a file. The playground hashes it with SHA-256+and registers a real content-addressed identity, because a compiled document+cross-checks every Artifact reference and would reject a stub.++Modules that draw supplied footage — B-roll, speaker footage — therefore have no+default: a module has no bytes to point at, so it says nothing rather than+inventing a digest. Until you choose a file those components draw nothing, which+is a state to pass through and not an error.++## Stylesheets+- Choosing a `.svs` file reads **only its Film Recipe**, and only for the frame- size. Point it at `examples/talking-film-golden/studio.svs` and the canvas- becomes 1080×1920 at 30 with that sheet's background.++Choosing a `.svs` file reads **only its Film Recipe**, and only for Film++appearance. Point it at `examples/talking-film-golden/studio.svs` and the++preview adopts that Recipe's background. Canvas dimensions and time remain++explicit preview-environment controls.++Nothing else in the sheet is read. What a component looks like comes from the+module that owns it, not from a stylesheet the playground happened to open.++## When something is wrong++Nothing in the playground validates. The modules' own `seal` and `assert`+functions are the judge, because they are what a real Build runs. A rejected+value shows the compiler's own message under the canvas and leaves the last good+frame on screen, so you can read the error and the picture together.++## Known divergences from a real render++- Fonts lower to a plain CSS `font-family` string. The production+ `FontArtifactRef` path with hashed `@font-face` families is not exercised.+- Audio tracks are not played.+- A `ProgramSpace` input is filled from the canvas controls rather than offered+ in a form, so there is only one place to change the frame domain.++See [`tools/playground/README.md`](https://github.com/cashdiffusion/svml/blob/main/tools/playground/README.md)+for how the timeline shim works and what a module must declare to be+previewable.diff --cc docs/guide/services.mdindex 3b116718,5fe981e2..dc270ef4--- a/docs/guide/services.md+++ b/docs/guide/services.md@@@ -5,36 -5,19 +5,46 @@@ description: Setting up the WhisperX an# Local Services- Two Python services support local Builds. They are Runtime deployment packages, not part- of Core or the author language.+ Local Builds may depend on managed sidecars, managed tool assets or operator-owned executables.+ They are Runtime deployment concerns, not part of Core or the author language.++ For an installed Runtime Profile, prefer the profile-scoped lifecycle:++ ```bash+ pnpm narratage services up svml.runtime.json+ pnpm narratage doctor svml.runtime.json+ ```++ Only Providers selected by that Profile are prepared. `services up` may prepare or start deployment+ state; `doctor` is read-only. The commands below are the equivalent manual operations.+## Automatic setup++You normally do not run any of the commands on this page. `pnpm install` prepares every service+that an installed Provider declares, and `narratage build` starts them:++```bash+pnpm install # prepares the Python environments+pnpm narratage build build.svrun --runtime svml.runtime.json --follow+```++A Build starts only the services its Runtime Profile declares, leaves them running between Builds+so a warm model is not reloaded, and stops before its first Operation if one cannot be reached —+so an unavailable service never costs a paid generation.++Manage them directly when you need to:++```bash+pnpm narratage services status svml.runtime.json # what is running+pnpm narratage services up svml.runtime.json # start without building+pnpm narratage services down svml.runtime.json # stop what this project started+pnpm narratage build … --no-services # build against what is already running+```++`pnpm install` skips preparation when `uv` is absent and says so; it never fails the install. The+rest of this page is what those commands run, for when one of them fails or you are deploying+outside this repository.+## WhisperXProvides ASR and language-specific alignment for speech timing measurement.@@@ -99,16 -78,10 +109,16 @@@ pnpm test:whisperx-servic## OpenCV image service- Provides bounded image transforms (e.g. the GPT Image YCrCb denoise preset) through- `@narratage/provider-image-opencv-local`.+ Provides one bounded Raster interpreter for both image transforms (e.g. the GPT Image YCrCb denoise+ preset) and explicit ordered Canvas/Layer composition through `@narratage/provider-image-opencv-local`.-### Install+OpenCV runs as one bounded process per Need, so there is no program to keep warm — preparing the+environment is the whole job, and `narratage services status` reports whether the interpreter+carries a usable `cv2` and `numpy`.++### Install by hand++`pnpm install` runs this:```bashuv python install 3.13diff --cc docs/quickstart.mdindex 65309d27,24eb3a3e..6c3f922c--- a/docs/quickstart.md+++ b/docs/quickstart.md@@@ -60,9 -62,13 +62,8 @@@ before spending money|---|---|| [Script](./quickstart/script.md) | Segments, Role Cues, Dual Text, Selections, Moments, text projections || [SVS Stylesheets](./quickstart/styles.md) | CSS-like Recipes for film, caption, B-roll, text, speech and fonts |--| [Media & Generation](./quickstart/generation.md) | media:Image, media:Audio, estimate:Speech, Seedance, speaker:Take |++| [Media & Generation](./quickstart/generation.md) | media:Image, media:Audio, estimate:Speech, Text Templates, Seedance || [Timing & Assembly](./quickstart/timing.md) | speech:Spine, whisperx:Alignment, ProgramSpace, SemanticMap |- | [Caption, B-roll & Text](./quickstart/tracks.md) | caption:Style/Program/Planner/Track, broll:Track, text:Track |+ | [Caption, Media & Text](./quickstart/tracks.md) | caption-fine:Style/Track, caption:Program, Planner, Media Track and Text || [Film & Rendering](./quickstart/composition.md) | film:Film, render:Video, full pipeline walkthrough || [Run Source & Builds](./quickstart/run.md) | .svrun syntax, targets, reuse, runtime profile, build workflow |--## Next---- [Development guide](./guide/develop.md) — repository layout, package architecture, extension- patterns.diff --cc docs/quickstart/generation.mdindex e4faec92,5fb19cb1..3c7312f5--- a/docs/quickstart/generation.md+++ b/docs/quickstart/generation.md@@@ -12,9 -12,10 +12,11 @@@ Every component shown here must be impo```svml<import as="media" from="@narratage/media@1"/>+ <import as="mediaop" from="@narratage/media-pipeline@1"/><import as="estimate" from="@narratage/estimate@1"/>++<import as="text" from="@narratage/text@1"/><import as="seedance" from="@narratage/seedance@1"/>--<import as="speaker" from="@narratage/seedance-speaker@1"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/>```## media:Image@@@ -46,7 -47,7 +48,7 @@@ Declares a content-addressed audio asse| `id` | yes | Unique identifier || `src` | yes | Path to the audio file, relative to the `.svml` source |--Typically used as a voice-timbre reference for `speaker:Take`.++Typically used as a voice-timbre reference for `seedance:ReferenceVideo`.## estimate:Speech@@@ -104,140 -116,182 +117,156 @@@ declared text port|---|---|---|| `id` | yes | Unique identifier |- The element body is the prompt text. Referenced by `seedance:Speech` and `seedance:Video` via their- `prompt` attribute.+ The element body is the exact Text value. `text:Render` can produce the same type from a template+ and explicit graph inputs.++ ## Seedance invocation shapes++ Seedance exposes model capabilities, not creative usages. `standard`, `fast` and `mini` choose the+ model variant independently of three invocation shapes. All shapes consume a complete ordinary+ `Text` prompt and output `{id.video}`.- ## seedance:Speech+ ### seedance:TextVideo- Generates a talking-head video clip via the Seedance model. This is the low-level generation- component — it directly specifies the dialogue, prompt, and duration.+ Prompt-only generation. This is the only shape that accepts `web-search`.```svml- <seedance:Speech id="alice-take" model="mini"- dialogue={story.segment.opening.dialogue}- prompt={alice-direction}- duration="8">- <seedance:Reference image={alice-reference} role="character"/>- </seedance:Speech>+ <seedance:TextVideo id="ambient" model="mini"+ prompt={ambient-direction} duration="5" web-search="false"/>```- | Attribute | Required | Description |- |---|---|---|- | `id` | yes | Unique identifier |- | `model` | yes | Seedance model name: `mini` |- | `dialogue` | yes | Script text to lip-sync — typically `{script.segment.NAME.dialogue}` |- | `prompt` | yes | Visual direction — reference to a `seedance:Prompt` |- | `duration` | yes | Clip duration in seconds (number or `{estimate.duration}` reference) |- | `resolution` | no | Output resolution: `480p`, `720p` (default varies by model) |- | `aspect-ratio` | no | Output aspect ratio: `9:16`, `16:9`, `1:1` |-- ### seedance:Reference+ ### seedance:FrameVideo- Child element that provides a reference image for character consistency:+ First-frame generation with an optional last frame:```svml- <seedance:Reference image={alice-reference} role="character"/>+ <seedance:FrameVideo id="transition" model="fast"+ prompt={transition-direction} duration="5"+ first-frame={opening-image} last-frame={closing-image}/>```- | Attribute | Required | Description |- |---|---|---|- | `image` | yes | Reference to a `media:Image` component |- | `role` | yes | How this reference is used: `character`, `subject` |-- **Output:** `{alice-take}` or `{alice-take.video}` — the generated video, passed to `speech:Spine`.-- ## seedance:Video+ ### seedance:ReferenceVideo- Generates a standalone video clip (not a talking-head — no dialogue lip-sync).+ Multimodal reference generation. It requires at least one `Reference` child and accepts image,+ video and audio references within the model's declared limits.```svml- <seedance:Video id="product-motion" model="mini"- prompt={product-direction} duration="5">- <seedance:Reference image={product-reference} role="subject"/>- </seedance:Video>+ <seedance:ReferenceVideo id="alice-take" model="mini"+ prompt={alice-direction}+ duration={alice-duration.duration}+ generate-audio="true">+ <seedance:Reference image={alice-reference}/>+ <seedance:Reference audio={alice-voice}/>+ </seedance:ReferenceVideo>```- | Attribute | Required | Description |- |---|---|---|- | `id` | yes | Unique identifier |- | `model` | yes | Seedance model name: `mini` |- | `prompt` | yes | Visual direction — reference to a `seedance:Prompt` |- | `duration` | yes | Clip duration in seconds |-The component does not know that this is a talking head. That meaning lives in the supplied Text or-a higher-level package such as `speaker:Take`.++The component does not know that this is a talking head. That meaning lives in the supplied Text.- Also accepts `<seedance:Reference>` children for reference images.+ Common attributes are `id`, `model`, `prompt`, `duration`, `resolution`, `aspect-ratio` and+ `generate-audio`. `duration` may be literal or an explicit `{estimate.duration}` edge.- **Output:** `{product-motion.video}` — used as a B-roll source.-- ## speaker:Take-- A higher-level talking-head component built on top of Prompt Kit. Instead of writing a raw prompt,- you provide a Recipe with generation settings and a Kit that assembles the prompt automatically.+ The audio generated in an earlier take can be reused as a later reference through an ordinary graph+ edge. Extraction does not turn it into speech evidence or attach speaker meaning:```svml- <import as="speaker" from="@narratage/seedance-speaker@1"/>- <import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>-- <speaker:Take id="hook-take"- dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration}- recipe={studio.speaker.host}- kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>- </speaker:Take>+ <mediaop:ExtractAudio id="voice-from-opening"+ source={opening.video} audio="default"/>++ <seedance:ReferenceVideo id="follow-up" model="mini"+ prompt={follow-up-direction} duration="5" generate-audio="true">+ <seedance:Reference image={presenter-reference}/>+ <seedance:Reference audio={voice-from-opening.audio}/>+ </seedance:ReferenceVideo>```- | Attribute | Required | Description |- |---|---|---|- | `id` | yes | Unique identifier |- | `dialogue` | yes | Script text — typically `{script.segment.NAME.dialogue}` |- | `duration` | yes | Estimated duration from `estimate:Speech` |- | `recipe` | yes | SVS speaker Recipe (see [SVS Stylesheets](./styles.md#speaker)) |- | `kit` | yes | Prompt Kit SVS — the template that assembles the prompt |+ The same media-operation package exposes `Transform` for ordered trim/retime and `ExtractFrame` for+ first, last, indexed or timestamped still extraction. Local FFmpeg and AWS Lambda are interchangeable+ Runtime Endpoints for these exact Needs; neither changes the author graph.- ### speaker:Reference+ ## Seedance semantic Kits- Child element providing reference media. Accepts both images and audio:-`@narratage/seedance-kits` contains six data-only Text Templates. A Kit is not a model wrapper: use++`@narratage/seedance-kits` contains seven data-only Text Templates. A Kit is not a model wrapper: use+ generic `text:Render` to produce the prompt, then connect that Text and the real media references to+ the low-level Seedance Surface.```svml- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>+ <import as="text" from="@narratage/text@1"/>+ <import as="seedance" from="@narratage/seedance@1"/>+ <import as="broll-kit" source="../../packages/seedance-kits/kits/broll-v1.svs"/>++ <text:Render id="demo-prompt"+ template={broll-kit.broll-v1}+ recipe={studio.broll.product-demo}>+ <text:Set name="story" text={copy.product-demo}/>+ </text:Render>++ <seedance:ReferenceVideo id="demo" model="mini"+ prompt={demo-prompt}+ duration={demo-duration.duration}+ resolution="720p"+ aspect-ratio="9:16"+ generate-audio="false">+ <seedance:Reference image={scene}/>+ <seedance:Reference image={product}/>+ </seedance:ReferenceVideo>```- | Attribute | Required | Description |- |---|---|---|- | `image` | one of image/audio | Reference to a `media:Image` |- | `audio` | one of image/audio | Reference to a `media:Audio` |- | `role` | yes | Reference purpose: `character-and-scene`, `voice-timbre` |+ The project Recipe selects axes such as `material-mode`, `story-shape` and `camera-language`.+ `text:Render` reads only properties declared by the template; an explicit `text:Param` overrides a+ Recipe value. Dynamic story/dialogue/action/extra content remains a `Text` edge through `Set`.- **Output:** `{hook-take.video}` — the generated video, passed to `speech:Spine`.-Available templates are `broll-v1`, `podcast-v1`, `call-v1`, `street-interview-v1`,++Available templates are `speaker-v1`, `broll-v1`, `podcast-v1`, `call-v1`, `street-interview-v1`,+ `motion-reference-v1` and `camera-reference-v1`. Podcast and Call expect two ordered image+ references plus two ordered audio references; Street Interview expects one scene image plus two+ ordered voices; the two reference-transfer templates expect one subject image and one reference+ video. Those shapes are visible in `seedance:ReferenceVideo`, not hidden in Kit execution code.- ### Prompt Kits-## speaker:Take++## Talking-head prompt assembly- A Prompt Kit is a special SVS file that defines a structured prompt template with ordered blocks,- variant choices, axis parameters, and slots. The official kit is at- `packages/seedance-speaker/kits/official-ugc-v1.svs`.-A higher-level talking-head component built on the domain-neutral Text Program. Instead of writing-a raw prompt, you provide a Recipe with generation settings and a Text Template that assembles the-model input explicitly in the graph.++Talking-head authoring does not need a special executable component. The data-only `speaker-v1`++Template, the project's Recipe and the per-take dialogue/action are assembled by the ordinary Text++module. The result enters Seedance through the same explicit `prompt` edge as any other generation.- The kit is imported using the Prompt Kit SVS parser:+ ```svml-<import as="speaker" from="@narratage/seedance-speaker@1"/>-<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>--<speaker:Take id="hook-take"- dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration}- recipe={studio.speaker.host}- kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>-</speaker:Take>-```--| Attribute | Required | Description |-|---|---|---|-| `id` | yes | Unique identifier |-| `dialogue` | yes | Script text — typically `{script.segment.NAME.dialogue}` |-| `duration` | yes | Estimated duration from `estimate:Speech` |-| `recipe` | yes | SVS speaker Recipe (see [SVS Stylesheets](./styles.md#speaker)) |-| `kit` | yes | Text Template SVS — the template that assembles model input text |--### speaker:Reference--Child element providing reference media. Accepts both images and audio:--```svml-<speaker:Reference image={presenter-clean} role="character-and-scene"/>-<speaker:Reference audio={presenter-voice} role="voice-timbre"/>-```--| Attribute | Required | Description |-|---|---|---|-| `image` | one of image/audio | Reference to a `media:Image` |-| `audio` | one of image/audio | Reference to a `media:Audio` |-| `role` | yes | Reference purpose: `character-and-scene`, `voice-timbre` |--**Output:** `{hook-take.video}` — the generated video, passed to `speech:Spine`.--### Text Templates++<import as="text" from="@narratage/text@1"/>++<import as="seedance" from="@narratage/seedance@1"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/>- ```svs- <?svml using="@narratage/prompt-kit/svs@1"?>-A Text Template can be authored as an SVS file with ordered blocks, variant choices, axis-parameters and slots. The official template is at-`packages/seedance-speaker/kits/official-ugc-v1.svs`.++<text:Value id="hook-action">++ Begin with urgent direct eye contact, then let the final admission land more quietly.++</text:Value>+-That source selects the optional Text Template SVS Frontend itself:++<text:Render id="hook-prompt"++ template={speaker-kit.speaker-v1}++ recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>+-```svs-<?svml using="@narratage/text/svs@1"?>++<seedance:ReferenceVideo id="hook-take" model="mini"++ prompt={hook-prompt}++ duration={hook-duration.duration}++ resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-clean}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>```- The Recipe in `studio.svs` sets the axis parameter values (composition-stability, camera-motion,- edit-rhythm, performance, gesture, voice-mode), and the kit assembles them into a complete prompt- automatically.-The Recipe in `studio.svs` sets the axis parameter values. `speaker:Take` turns those values and-Script dialogue into explicit Text Bindings; the Text render output then enters Seedance's exact-`prompt` port through an ordinary graph edge.++`speaker-v1.svs` selects its own Text Template Frontend. `studio.svs` supplies the named axis values;++`dialogue` and `action` remain ordinary graph inputs. Neither the Kit nor Text chooses a model,++reference media or generation endpoint.## Combination example--A four-take setup with estimated durations feeding into `speaker:Take` generation:++A two-take setup with estimated durations feeding explicit Text assembly and Seedance generation:```svml<import as="media" from="@narratage/media@1"/><import as="estimate" from="@narratage/estimate@1"/>--<import as="speaker" from="@narratage/seedance-speaker@1"/>++<import as="text" from="@narratage/text@1"/>++<import as="seedance" from="@narratage/seedance@1"/><import as="studio" source="./studio.svs"/>--<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/><media:Image id="presenter-alt" src="./assets/presenter-alt.png"/>@@@ -247,40 -301,40 +276,30 @@@source={story.segment.hook.speech} policy={studio.speech.normal}/><estimate:Speech id="meeting-duration"source={story.segment.meeting.speech} policy={studio.speech.normal}/>--<estimate:Speech id="evidence-duration"-- source={story.segment.evidence.speech} policy={studio.speech.normal}/>--<estimate:Speech id="payoff-duration"-- source={story.segment.payoff.speech} policy={studio.speech.normal}/>----<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}-- duration={hook-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-clean} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="meeting-take" dialogue={story.segment.meeting.dialogue}-- duration={meeting-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-alt} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="evidence-take" dialogue={story.segment.evidence.dialogue}-- duration={evidence-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-alt} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="payoff-take" dialogue={story.segment.payoff.dialogue}-- duration={payoff-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-clean} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>++<text:Value id="hook-action">Start urgently, then become quieter.</text:Value>++<text:Value id="meeting-action">Indicate the product, then return to the lens.</text:Value>++++<text:Render id="hook-prompt" template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>++<text:Render id="meeting-prompt" template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.meeting.dialogue}/>++ <text:Set name="action" text={meeting-action}/>++</text:Render>++++<seedance:ReferenceVideo id="hook-take" model="mini" prompt={hook-prompt}++ duration={hook-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-clean}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>++<seedance:ReferenceVideo id="meeting-take" model="mini" prompt={meeting-prompt}++ duration={meeting-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-alt}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>```--Each `speaker:Take` produces a `{*.video}` output that feeds into `speech:Spine` in the next stage.--Different takes can use different reference images (e.g. the presenter holding a product in some--Segments but not others) while sharing the same voice timbre and generation recipe.++Each `seedance:ReferenceVideo` produces a `{*.video}` output that feeds into `speech:Spine` in the++next stage. Different takes can use different reference images while sharing the same voice timbre++and prompt Recipe.diff --cc docs/quickstart/styles.mdindex cdee23ae,14429026..6d67b4db--- a/docs/quickstart/styles.md+++ b/docs/quickstart/styles.md@@@ -255,62 -279,78 +279,71 @@@ Referenced by `estimate:Speech` via thpolicy={studio.speech.normal}/>```--## Speaker++## Speaker Text Template--Seedance Speaker generation settings — the Recipe that controls how `speaker:Take` generates a--talking-head clip.++The Recipe selects the prompt axes declared by the data-only `speaker-v1` Text Template. Model,++resolution, references and duration remain explicit inputs to `seedance:ReferenceVideo`; they are++not hidden in this Recipe.```svsspeaker.host {-- kind: ugc-talking-head;-- model: mini;-- resolution: 720p;-- aspect-ratio: 9:16;composition-stability: soft-locked;camera-motion: none;edit-rhythm: continuous-take;performance: natural-explainer;gesture: natural;-- voice-mode: single-speaker;}```| Property | Description ||---|---|--| `kind` | Generation kind (e.g. `ugc-talking-head`) |--| `model` | Model name: `mini` |--| `resolution` | Output resolution: `480p`, `720p`, `1080p` |--| `aspect-ratio` | Output aspect ratio: `9:16`, `16:9`, `1:1` || `composition-stability` | Camera/composition consistency: `flexible-ugc`, `soft-locked`, `strict-locked` || `camera-motion` | Camera movement: `none`, `subtle-punch-in-return` || `edit-rhythm` | Editing style: `continuous-take`, `pause-trim-jump-cuts` || `performance` | Acting style: `natural-explainer`, `high-energy-ugc`, `calm-authority`, `reactive-playful` || `gesture` | Gesture intensity: `restrained`, `compact`, `natural`, `expressive` |--| `voice-mode` | Voice configuration: `single-speaker` |----Referenced by `speaker:Take` via the `recipe` attribute:++Referenced by `text:Render` together with the Kit's Template:```svml--<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}-- duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>++<text:Render id="hook-prompt"++ template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>```- ## Font declarations+ ## Generic Text Template Recipes- Declare local font files for use in captions and text overlays.+ The same precedence is available without a domain wrapper. `text:Render` can read any SVS Recipe,+ project only properties declared by its template, and let explicit `text:Param` children override+ them. This is how the data-only Seedance B-roll, Podcast, Call, Street Interview and reference+ transfer Kits remain separate from Seedance execution.```svs- font.inter-semibold {- src: ./assets/Inter-SemiBold.woff2;- weight: 600;- style: normal;+ broll.product-demo {+ material-mode: product-beauty;+ reference-plan: scene-plus-refs;+ story-shape: process-demo;+ edit-language: insert-cutaway;+ camera-language: product-macro;+ motion-intensity: readable;}+ ```- font.inter-black {- src: ./assets/Inter-Black.woff2;- weight: 900;- style: normal;- }+ Model, resolution, duration and reference media are not template policy. They stay on the exact+ model Surface and graph edges.++ ## Exact font declarations++ SVS describes typography policy, but it does not choose or open font bytes. For common open fonts,+ import the private pre-release catalog and select only the faces the Author Graph uses:++ ```svml+ <import as="fonts" from="@narratage/fonts-open@1"/>++ <fonts:Stack id="caption-fonts" family="inter" weight="600" style="normal" emoji="color">+ <fonts:Fallback family="noto-sans-sc" weight="600" style="normal"/>+ </fonts:Stack>```| Property | Description |@@@ -347,16 -403,16 +396,11 @@@ A complete `studio.svs` file for a four}speaker.host {-- kind: ugc-talking-head;-- model: mini;-- resolution: 720p;-- aspect-ratio: 9:16;composition-stability: soft-locked;camera-motion: none;edit-rhythm: continuous-take;performance: natural-explainer;gesture: natural;-- voice-mode: single-speaker;}film.vertical {@@@ -392,9 -447,10 +435,11 @@@ This file is imported once in the `.svm<estimate:Speech id="hook-duration" source={story.segment.hook.speech}policy={studio.speech.normal}/>--<speaker:Take id="hook-take" ... recipe={studio.speaker.host} .../>++<text:Render id="hook-prompt" template={speaker-kit.speaker-v1}++ recipe={studio.speaker.host}>...</text:Render>- <caption:Style id="primary-caption" appearance={studio.caption.primary} .../>+ <caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>- <film:Film id="main" space={speech.space} appearance={studio.film.vertical}>+ <space:Canvas id="vertical" width="720" height="1280"/>+ <film:Film id="main" canvas={vertical} space={speech.space} appearance={studio.film.vertical}>```diff --cc docs/quickstart/timing.mdindex a11dbc39,64667493..2f51da57--- a/docs/quickstart/timing.md+++ b/docs/quickstart/timing.md@@@ -38,7 -41,7 +41,7 @@@ Each `<speech:Take>` child binds a gene| Attribute | Required | Description ||---|---|---|- | `source` | yes | Generated video — from `seedance:Speech`, `speaker:Take`, etc. |-| `source` | yes | Generated video — from `seedance:ReferenceVideo`, `speaker:Take`, etc. |++| `source` | yes | Generated video — for example, from `seedance:ReferenceVideo` || `segment` | yes | Script Segment this take corresponds to — e.g. `{story.segment.hook}` |The order of `<speech:Take>` children **determines the program order**. The first take starts at@@@ -148,7 -152,7 +152,7 @@@ The complete timing stage, from generatThe data flow:```text--speaker:Take outputs ──► speech:Spine ──► whisperx:Alignment++generated video(s) ─────► speech:Spine ──► whisperx:Alignment│ │.visual .map (SemanticMap).audio │diff --cc docs/zh/guide/packages.mdindex c0c86223,12019601..b6752e67--- a/docs/zh/guide/packages.md+++ b/docs/zh/guide/packages.md@@@ -61,10 -66,11 +66,10 @@@ Sticker、Deck 或任何模型家族�@narratage/media media types@narratage/narrative authored narrative products@narratage/program-space exact frame/sample domain- @narratage/generation image/video product contracts+ @narratage/generation 图像/视频/音频生成合同@narratage/model-kit model family abstractions@narratage/seedance Seedance model family + author Surface- @narratage/seedance-speaker Seedance Speaker binding+ @narratage/seedance-kits 数据化的 Seedance 语义 Text Template-@narratage/seedance-speaker Seedance Speaker binding@narratage/minimax-h3 MiniMax H3 model family@narratage/gemini-omni Gemini Omni model family@narratage/grok-imagine Grok Imagine model family@@@ -123,7 -142,7 +141,7 @@@2. **领域无关闭包。** 每个 Layer 1 包的传递闭包只包含 Layer 1 的包。`@narratage/core` 只依赖 `@narratage/protocol`。- 3. **CLI 独立性。** `@narratage/cli` 和 `@narratage/video-cli` 都不会传递依赖任何 Provider 包。video CLI 同样不依赖任何作者层的视频包(`@narratage/script`、`@narratage/seedance-speaker`、`@narratage/broll`、`@narratage/text-track`、`@narratage/film`)。作者包通过显式的 package lock 被 activate,而不是通过编译期的 CLI 依赖。-3. **CLI 独立性。** `@narratage/cli` 和 `@narratage/video-cli` 都不会传递依赖任何 Provider 包。video CLI 同样不依赖任何作者层的视频包(`@narratage/script`、`@narratage/seedance-speaker`、`@narratage/media-track`、`@narratage/typography-track`、`@narratage/film`)。作者包通过显式的 package lock 被 activate,而不是通过编译期的 CLI 依赖。++3. **CLI 独立性。** `@narratage/cli` 和 `@narratage/video-cli` 都不会传递依赖任何 Provider 包。video CLI 同样不依赖任何作者层的视频包(`@narratage/script`、`@narratage/seedance`、`@narratage/media-track`、`@narratage/typography-track`、`@narratage/film`)。作者包通过显式的 package lock 被 activate,而不是通过编译期的 CLI 依赖。## 包的结构diff --cc docs/zh/guide/playground.mdindex 48f040ef,00000000..bf6beafamode 100644,000000..100644--- a/docs/zh/guide/playground.md+++ b/docs/zh/guide/playground.md@@@ -1,90 -1,0 +1,91 @@@+---+title: 组件 Playground+description: 不跑 Build 也能预览视觉组件。+---++# 组件 Playground++想看一条字幕或一个文字层长什么样,通常要付出一整次 Build 的代价:Author Source、Run Source、+Runtime Profile、生成、对齐、渲染。Playground 在浏览器里单独渲染一个组件,耗时以毫秒计。++```bash+pnpm playground+```++然后打开 `http://localhost:5178`。不需要别的——没有 Runtime Profile,没有凭据,也不需要本地服务。++## 界面++| 控件 | 作用 |+|---|---|+| 组件下拉 | 所有能在画面上产生像素的模块 |+| W / H / fps / sec | 画布与帧域 |- | Canvas from a stylesheet | 采用某个 `.svs` 的画幅 |++| Appearance from a stylesheet | 采用某个 `.svs` Film Recipe 的背景 |+| 输入表单 | 组件每个输入各一份 |+| 刻度条 | 帧精确,计数显示为 `当前帧 / 末帧` |+- 预览的是真实结果。跑的是各组件自己的渲染器——`renderCaptionTrack`、`renderTextTrack`、- `compileBrollProduct`、`projectSpeechVisual`——再由 `compileHyperframesDocument` 产出与- Build 相同的文档。++预览运行的是已安装模块真正的 Producer handler。例如 Fine Caption、Media Track、++Screen Overlay、Speech Basis 和 Typography Track 都会降低为 `VisualTrack`,再由++`compileHyperframesDocument` 产出与 Build 相同的文档。++## 它不维护任何清单++Playground 里没有组件列表。它读取各 manifest,把所有声明了「输出 `VisualTrack` 的 Producer」的模块+列出来。新增这样的模块,它自己会出现;不再输出,它自己会消失。++其余信息同样是读出来的:++| 问题 | 来源 |+|---|---|+| 组件需要什么 | 该 Producer 的 `inputs` |+| 每个输入什么形状 | 声明方的 `TypeDeclaration.schema` |+| 从什么值开始 | 该类型的 `TypeDeclaration.default` |+| 控件长什么样 | `ValueSchema.format` |++所以字幕的 `mode` 是下拉框,因为它的 schema 声明了 `enum`;`display` 是多行文本框,因为该字段是+`format: "multiline"`。这两者都不在 Playground 里配置。++## format++当类型本身不足以表达含义时,模块用 `format` 说明——颜色和字体名同样都是字符串。++| format | 控件 |+|---|---|+| `color` | 色板配文本框。以文本框为准,因为 `#RRGGBBAA` 带的 alpha 色板表达不了 |+| `unit-fraction` | 滑块加数字框 |+| `multiline` | 多行文本框 |+| `digest` | 文件选择 |+| `duration` | 数字框,单位秒 |++`color` 和 `digest` 有确切形状,由 `validateStoredValue` 校验。其余只描述,不收窄。++## 媒体++`format: "digest"` 的字段接受一个文件。Playground 用 SHA-256 计算并注册真实的内容寻址标识——+编译产出的文档会交叉校验每一个 Artifact 引用,占位值会被拒绝。++因此绘制外部素材的模块(B-roll、说话人画面)**没有默认值**:模块手里没有那些字节,与其编造一个+digest,不如什么都不说。在你选择文件之前这些组件不画任何东西,这是一个可以经过的状态,不是错误。++## 样式表+- 选择 `.svs` 文件**只读其中的 Film Recipe**,且只用于画幅。指向- `examples/talking-film-golden/studio.svs`,画布就会变成 1080×1920@30 并采用该表的背景色。++选择 `.svs` 文件**只读其中的 Film Recipe**,且只用于 Film 外观。指向++`examples/talking-film-golden/studio.svs`,预览会采用该 Recipe 的背景色;画布尺寸与时间仍由++预览环境的显式控件决定。++表里其余内容一概不读。组件长什么样由拥有它的模块决定,而不是由 Playground 恰好打开的某张样式表决定。++## 出错时++Playground 自身不做任何校验。裁判是各模块自己的 `seal` 与 `assert` 函数——它们正是真实 Build 会跑的+东西。被拒绝的值会把编译器原本的报错显示在画布下方,并保留上一帧正确画面,让你能同时看到错误和图像。++## 与真实渲染的已知偏差++- 字体降级为普通 CSS `font-family` 字符串,不会走生产环境中带哈希 `@font-face` 的+ `FontArtifactRef` 路径。+- 不播放音频轨。+- `ProgramSpace` 输入由画布控件填充而非出现在表单里,使帧域只有一处可改。++时间线 shim 的原理、以及一个模块需要声明什么才能被预览,见+[`tools/playground/README.md`](https://github.com/cashdiffusion/svml/blob/main/tools/playground/README.md)。diff --cc docs/zh/quickstart.mdindex 923b3709,9f3981f8..c2d7df65--- a/docs/zh/quickstart.md+++ b/docs/zh/quickstart.md@@@ -57,9 -58,12 +58,8 @@@ pnpm narratage plan examples/talking-fi|---|---|| [Script](./quickstart/script.md) | Segment、Role Cue、Dual Text、Selection、Moment、文字投影 || [SVS 样式表](./quickstart/styles.md) | CSS 风格的 Recipe:film、caption、B-roll、text、speech、字体 |--| [媒体与生成](./quickstart/generation.md) | media:Image、media:Audio、estimate:Speech、Seedance、speaker:Take |++| [媒体与生成](./quickstart/generation.md) | media:Image、media:Audio、estimate:Speech、Text Template、Seedance || [时序与装配](./quickstart/timing.md) | speech:Spine、whisperx:Alignment、ProgramSpace、SemanticMap |- | [字幕、B-roll 与文字](./quickstart/tracks.md) | caption:Style/Program/Planner/Track、broll:Track、text:Track |+ | [字幕、Media 与文字](./quickstart/tracks.md) | caption-fine:Style/Track、caption:Program、Planner、Media Track 与 Text || [Film 与渲染](./quickstart/composition.md) | film:Film、render:Video、完整流水线演练 || [Run Source 与 Build](./quickstart/run.md) | .svrun 语法、targets、复用、runtime profile、build 工作流 |--## 下一步---- [开发指南](./guide/develop.md) —— 仓库结构、包架构、扩展模式。diff --cc docs/zh/quickstart/generation.mdindex 3fd670e1,cafff625..224567aa--- a/docs/zh/quickstart/generation.md+++ b/docs/zh/quickstart/generation.md@@@ -11,9 -11,10 +11,11 @@@ description: 声明媒体资源并使�```svml<import as="media" from="@narratage/media@1"/>+ <import as="mediaop" from="@narratage/media-pipeline@1"/><import as="estimate" from="@narratage/estimate@1"/>++<import as="text" from="@narratage/text@1"/><import as="seedance" from="@narratage/seedance@1"/>--<import as="speaker" from="@narratage/seedance-speaker@1"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/>```## media:Image@@@ -44,7 -45,7 +46,7 @@@| `id` | 是 | 唯一标识符 || `src` | 是 | 音频文件路径,相对于 `.svml` 源文件 |--通常用作 `speaker:Take` 的语音音色参考。++通常用作 `seedance:ReferenceVideo` 的语音音色参考。## estimate:Speech@@@ -100,133 -108,163 +109,141 @@@ speech.normal|---|---|---|| `id` | 是 | 唯一标识符 |- 元素主体即为提示文本。通过 `seedance:Speech` 和 `seedance:Video` 的 `prompt` 属性引用。-- ## seedance:Speech-- 通过 Seedance 模型生成说话人头部视频片段。这是低层级的生成组件——直接指定对话、提示和时长。+ 元素主体就是精确的 Text 值。`text:Render` 也能用模板和显式图输入产出同一类型。- ```svml- <seedance:Speech id="alice-take" model="mini"- dialogue={story.segment.opening.dialogue}- prompt={alice-direction}- duration="8">- <seedance:Reference image={alice-reference} role="character"/>- </seedance:Speech>- ```+ ## Seedance 三种调用形状- | 属性 | 必填 | 说明 |- |---|---|---|- | `id` | 是 | 唯一标识符 |- | `model` | 是 | Seedance 模型名称:`mini` |- | `dialogue` | 是 | 要进行口型同步的 Script 文本——通常为 `{script.segment.NAME.dialogue}` |- | `prompt` | 是 | 视觉指导——引用 `seedance:Prompt` |- | `duration` | 是 | 片段时长(秒)(数字或 `{estimate.duration}` 引用) |- | `resolution` | 否 | 输出分辨率:`480p`、`720p`(默认值因模型而异) |- | `aspect-ratio` | 否 | 输出宽高比:`9:16`、`16:9`、`1:1` |+ Seedance 只暴露模型能力,不暴露“口播”“B-roll”等创作用途。`standard`、`fast`、`mini`+ 选择模型版本;调用形状则独立分为三种。三者都消费完整的普通 `Text` Prompt,并输出+ `{id.video}`。- ### seedance:Reference+ ### seedance:TextVideo- 提供参考图片以保持角色一致性的子元素:+ 纯 Prompt 生成。只有这种形状允许 `web-search`:```svml- <seedance:Reference image={alice-reference} role="character"/>+ <seedance:TextVideo id="ambient" model="mini"+ prompt={ambient-direction} duration="5" web-search="false"/>```- | 属性 | 必填 | 说明 |- |---|---|---|- | `image` | 是 | 引用 `media:Image` 组件 |- | `role` | 是 | 该参考的用途:`character`、`subject` |-- **输出:** `{alice-take}` 或 `{alice-take.video}`——生成的视频,传递给 `speech:Spine`。-- ## seedance:Video+ ### seedance:FrameVideo- 生成独立的视频片段(非说话人头部——无对话口型同步)。+ 必须给首帧,可以额外给尾帧:```svml- <seedance:Video id="product-motion" model="mini"- prompt={product-direction} duration="5">- <seedance:Reference image={product-reference} role="subject"/>- </seedance:Video>+ <seedance:FrameVideo id="transition" model="fast"+ prompt={transition-direction} duration="5"+ first-frame={opening-image} last-frame={closing-image}/>```- | 属性 | 必填 | 说明 |- |---|---|---|- | `id` | 是 | 唯一标识符 |- | `model` | 是 | Seedance 模型名称:`mini` |- | `prompt` | 是 | 视觉指导——引用 `seedance:Prompt` |- | `duration` | 是 | 片段时长(秒) |+ ### seedance:ReferenceVideo- 同样接受 `<seedance:Reference>` 子元素作为参考图片。+ 多模态参考生成。至少需要一个 `Reference` 子元素,可以显式接入图片、视频和音频:- **输出:** `{product-motion.video}`——用作 B-roll 来源。+ ```svml+ <seedance:ReferenceVideo id="alice-take" model="mini"+ prompt={alice-direction}+ duration={alice-duration.duration}+ generate-audio="true">+ <seedance:Reference image={alice-reference}/>+ <seedance:Reference audio={alice-voice}/>+ </seedance:ReferenceVideo>+ ```- ## speaker:Take-这个低层组件并不知道它被用来做口播;用途只存在于传入的 Text 或 `speaker:Take` 之类的-高层包中。公共属性包括 `id`、`model`、`prompt`、`duration`、`resolution`、++这个低层组件并不知道它被用来做口播;用途只存在于传入的 Text 中。公共属性包括++`id`、`model`、`prompt`、`duration`、`resolution`、+ `aspect-ratio`、`generate-audio`;`duration` 可以是字面量或显式 `{estimate.duration}` 边。- 基于 Prompt Kit 构建的更高层级说话人头部组件。无需编写原始提示,你只需提供一个包含生成设置的 Recipe 和一个自动组装提示的 Kit。+ 可以直接抽取前一段生成视频里的音频,并通过普通图边给后续片段当作参考。这个操作不会+ 把音频提升成语音证据,也不会凭空附加说话人语义:```svml- <import as="speaker" from="@narratage/seedance-speaker@1"/>- <import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>-- <speaker:Take id="hook-take"- dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration}- recipe={studio.speaker.host}- kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>- </speaker:Take>+ <mediaop:ExtractAudio id="voice-from-opening"+ source={opening.video} audio="default"/>++ <seedance:ReferenceVideo id="follow-up" model="mini"+ prompt={follow-up-direction} duration="5" generate-audio="true">+ <seedance:Reference image={presenter-reference}/>+ <seedance:Reference audio={voice-from-opening.audio}/>+ </seedance:ReferenceVideo>```- | 属性 | 必填 | 说明 |- |---|---|---|- | `id` | 是 | 唯一标识符 |- | `dialogue` | 是 | Script 文本——通常为 `{script.segment.NAME.dialogue}` |- | `duration` | 是 | 来自 `estimate:Speech` 的估算时长 |- | `recipe` | 是 | SVS speaker Recipe(参见 [SVS 样式表](./styles.md#speaker)) |- | `kit` | 是 | Prompt Kit SVS——用于组装提示的模板 |+ 同一个媒体操作包还提供 `Transform`(按顺序截取、变速)和 `ExtractFrame`(首帧、尾帧、+ 指定帧或指定时间取图)。本地 FFmpeg 与 AWS Lambda 只是这些精确 Need 的可互换 Runtime+ Endpoint,不会改变作者图。- ### speaker:Reference+ ## Seedance 语义 Kit- 提供参考媒体的子元素。同时接受图片和音频:-`@narratage/seedance-kits` 包含六个纯数据 Text Template。Kit 不是模型包装器:先用通用++`@narratage/seedance-kits` 包含七个纯数据 Text Template。Kit 不是模型包装器:先用通用+ `text:Render` 生成 prompt,再把该 Text 与真实媒体引用显式接入低层 Seedance Surface。```svml- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>+ <import as="text" from="@narratage/text@1"/>+ <import as="seedance" from="@narratage/seedance@1"/>+ <import as="broll-kit" source="../../packages/seedance-kits/kits/broll-v1.svs"/>++ <text:Render id="demo-prompt"+ template={broll-kit.broll-v1}+ recipe={studio.broll.product-demo}>+ <text:Set name="story" text={copy.product-demo}/>+ </text:Render>++ <seedance:ReferenceVideo id="demo" model="mini"+ prompt={demo-prompt} duration={demo-duration.duration}+ resolution="720p" aspect-ratio="9:16" generate-audio="false">+ <seedance:Reference image={scene}/>+ <seedance:Reference image={product}/>+ </seedance:ReferenceVideo>```- | 属性 | 必填 | 说明 |- |---|---|---|- | `image` | image/audio 二选一 | 引用 `media:Image` |- | `audio` | image/audio 二选一 | 引用 `media:Audio` |- | `role` | 是 | 参考用途:`character-and-scene`、`voice-timbre` |-- **输出:** `{hook-take.video}`——生成的视频,传递给 `speech:Spine`。-- ### Prompt Kits+ 项目 Recipe 选择模板声明的轴;显式 `text:Param` 可以覆盖 Recipe。动态 story、dialogue、-action 和 extra 仍经由 `text:Set` 作为图边进入。现有六个模板是 `broll-v1`、`podcast-v1`、++action 和 extra 仍经由 `text:Set` 作为图边进入。现有模板包括 `speaker-v1`、`broll-v1`、`podcast-v1`、+ `call-v1`、`street-interview-v1`、`motion-reference-v1`、`camera-reference-v1`。+ 媒体数量与顺序仍清楚地写在 `seedance:ReferenceVideo` 里,不藏进 Kit 代码。- Prompt Kit 是一种特殊的 SVS 文件,定义了包含有序块、变体选择、轴参数和 Slot 的结构化提示模板。官方 Kit 位于 `packages/seedance-speaker/kits/official-ugc-v1.svs`。-## speaker:Take++## 口播 Prompt 组装- 该 Kit 使用 Prompt Kit SVS 解析器导入:-基于领域无关 Text Program 构建的更高层口播组件。无需内联原始提示,只需提供生成 Recipe 和显式组装模型输入文字的 Text Template。++口播创作不需要一个特殊的可执行组件。数据化的 `speaker-v1` Template、项目 Recipe 与每段的++dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一样通过显式 `prompt` 边进入 Seedance。- ```svs- <?svml using="@narratage/prompt-kit/svs@1"?>+ ```svml-<import as="speaker" from="@narratage/seedance-speaker@1"/>-<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>--<speaker:Take id="hook-take"- dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration}- recipe={studio.speaker.host}- kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-clean} role="character-and-scene"/>- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>-</speaker:Take>-```--| 属性 | 必填 | 说明 |-|---|---|---|-| `id` | 是 | 唯一标识符 |-| `dialogue` | 是 | Script 文本——通常为 `{script.segment.NAME.dialogue}` |-| `duration` | 是 | 来自 `estimate:Speech` 的估算时长 |-| `recipe` | 是 | SVS speaker Recipe(参见 [SVS 样式表](./styles.md#speaker)) |-| `kit` | 是 | Text Template SVS——用于组装模型输入文字的模板 |--### speaker:Reference--提供参考媒体的子元素。同时接受图片和音频:--```svml-<speaker:Reference image={presenter-clean} role="character-and-scene"/>-<speaker:Reference audio={presenter-voice} role="voice-timbre"/>-```--| 属性 | 必填 | 说明 |-|---|---|---|-| `image` | image/audio 二选一 | 引用 `media:Image` |-| `audio` | image/audio 二选一 | 引用 `media:Audio` |-| `role` | 是 | 参考用途:`character-and-scene`、`voice-timbre` |--**输出:** `{hook-take.video}`——生成的视频,传递给 `speech:Spine`。--### Text Template++<import as="text" from="@narratage/text@1"/>++<import as="seedance" from="@narratage/seedance@1"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/>+-Text Template 可以用 SVS 表达有序块、有限分支、轴参数和 Slot。官方模板位于 `packages/seedance-speaker/kits/official-ugc-v1.svs`。++<text:Value id="hook-action">++ 先紧迫地直视镜头,最后一句收住声音。++</text:Value>+-该源码自己选择可选的 Text Template SVS Frontend:++<text:Render id="hook-prompt"++ template={speaker-kit.speaker-v1}++ recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>+-```svs-<?svml using="@narratage/text/svs@1"?>++<seedance:ReferenceVideo id="hook-take" model="mini"++ prompt={hook-prompt} duration={hook-duration.duration}++ resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-clean}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>```- `studio.svs` 中的 Recipe 设置轴参数值(composition-stability、camera-motion、edit-rhythm、performance、gesture、voice-mode),Kit 会自动将它们组装成完整的提示。-`studio.svs` 中的 Recipe 设置轴参数值。`speaker:Take` 把这些值和 Script 台词变成显式 Text Bindings;Text 渲染结果再通过普通图边进入 Seedance 的精确 `prompt` 端口。++`speaker-v1.svs` 自己选择 Text Template Frontend。`studio.svs` 提供具名轴值,`dialogue` 与++`action` 保持为普通图输入。Kit 和 Text 都不选择模型、参考素材或 Provider。## 组合示例--一个四段拍摄的设置,估算时长作为输入传递给 `speaker:Take` 生成:++一个两段拍摄的设置,估算时长进入显式 Text 组装与 Seedance 生成:```svml<import as="media" from="@narratage/media@1"/><import as="estimate" from="@narratage/estimate@1"/>--<import as="speaker" from="@narratage/seedance-speaker@1"/>++<import as="text" from="@narratage/text@1"/>++<import as="seedance" from="@narratage/seedance@1"/><import as="studio" source="./studio.svs"/>--<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/>++<import as="speaker-kit" source="../../packages/seedance-kits/kits/speaker-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/><media:Image id="presenter-alt" src="./assets/presenter-alt.png"/>@@@ -236,38 -274,38 +253,29 @@@source={story.segment.hook.speech} policy={studio.speech.normal}/><estimate:Speech id="meeting-duration"source={story.segment.meeting.speech} policy={studio.speech.normal}/>--<estimate:Speech id="evidence-duration"-- source={story.segment.evidence.speech} policy={studio.speech.normal}/>--<estimate:Speech id="payoff-duration"-- source={story.segment.payoff.speech} policy={studio.speech.normal}/>----<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}-- duration={hook-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-clean} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="meeting-take" dialogue={story.segment.meeting.dialogue}-- duration={meeting-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-alt} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="evidence-take" dialogue={story.segment.evidence.dialogue}-- duration={evidence-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-alt} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>----<speaker:Take id="payoff-take" dialogue={story.segment.payoff.dialogue}-- duration={payoff-duration.duration} recipe={studio.speaker.host}-- kit={ugc.official-ugc-v1}>-- <speaker:Reference image={presenter-clean} role="character-and-scene"/>-- <speaker:Reference audio={presenter-voice} role="voice-timbre"/>--</speaker:Take>++<text:Value id="hook-action">紧迫开场,最后一句放轻。</text:Value>++<text:Value id="meeting-action">示意产品,然后回到镜头。</text:Value>++++<text:Render id="hook-prompt" template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>++<text:Render id="meeting-prompt" template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.meeting.dialogue}/>++ <text:Set name="action" text={meeting-action}/>++</text:Render>++++<seedance:ReferenceVideo id="hook-take" model="mini" prompt={hook-prompt}++ duration={hook-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-clean}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>++<seedance:ReferenceVideo id="meeting-take" model="mini" prompt={meeting-prompt}++ duration={meeting-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">++ <seedance:Reference image={presenter-alt}/>++ <seedance:Reference audio={presenter-voice}/>++</seedance:ReferenceVideo>```--每个 `speaker:Take` 生成一个 `{*.video}` 输出,传递给下一阶段的 `speech:Spine`。不同的拍摄段可以使用不同的参考图片(例如,演示者在某些 Segment 中持有产品而在其他段中没有),同时共享相同的语音音色和生成 Recipe。++每个 `seedance:ReferenceVideo` 产出 `{*.video}`,进入下一阶段的 `speech:Spine`。不同 Take++可以使用不同参考图,同时共享相同的音色与 Prompt Recipe。diff --cc docs/zh/quickstart/styles.mdindex fb1933f5,d07e366f..ab12469a--- a/docs/zh/quickstart/styles.md+++ b/docs/zh/quickstart/styles.md@@@ -251,61 -273,75 +273,68 @@@ speech.normalpolicy={studio.speech.normal}/>```--## Speaker++## Speaker Text Template--Seedance Speaker 生成设置——控制 `speaker:Take` 如何生成说话人头像片段的 Recipe。++这个 Recipe 选择纯数据 `speaker-v1` Text Template 声明的 Prompt 轴。模型、分辨率、参考素材++与时长仍是 `seedance:ReferenceVideo` 的显式输入,不藏在 Recipe 里。```svsspeaker.host {-- kind: ugc-talking-head;-- model: mini;-- resolution: 720p;-- aspect-ratio: 9:16;composition-stability: soft-locked;camera-motion: none;edit-rhythm: continuous-take;performance: natural-explainer;gesture: natural;-- voice-mode: single-speaker;}```| 属性 | 描述 ||---|---|--| `kind` | 生成类型(如 `ugc-talking-head`) |--| `model` | 模型名称:`mini` |--| `resolution` | 输出分辨率:`480p`、`720p`、`1080p` |--| `aspect-ratio` | 输出宽高比:`9:16`、`16:9`、`1:1` || `composition-stability` | 镜头/构图一致性:`flexible-ugc`、`soft-locked`、`strict-locked` || `camera-motion` | 镜头运动:`none`、`subtle-punch-in-return` || `edit-rhythm` | 剪辑风格:`continuous-take`、`pause-trim-jump-cuts` || `performance` | 表演风格:`natural-explainer`、`high-energy-ugc`、`calm-authority`、`reactive-playful` || `gesture` | 手势强度:`restrained`、`compact`、`natural`、`expressive` |--| `voice-mode` | 语音配置:`single-speaker` |----通过 `speaker:Take` 的 `recipe` 属性引用:++与 Kit 的 Template 一起由 `text:Render` 引用:```svml--<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}-- duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>++<text:Render id="hook-prompt"++ template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>++ <text:Set name="dialogue" text={story.segment.hook.dialogue}/>++ <text:Set name="action" text={hook-action}/>++</text:Render>```- ## 字体声明+ ## 通用 Text Template Recipe- 声明本地字体文件,以便在字幕和文本叠加层中使用。+ 无需领域包装器也能使用同一优先级。`text:Render` 可以读取任意 SVS Recipe,只投影模板+ 明确声明的属性,并允许显式 `text:Param` 覆盖。这使 Seedance 的 B-roll、Podcast、Call、+ Street Interview 与参考迁移 Kit 可以保持为纯数据,而不进入 Seedance 执行代码。```svs- font.inter-semibold {- src: ./assets/Inter-SemiBold.woff2;- weight: 600;- style: normal;+ broll.product-demo {+ material-mode: product-beauty;+ reference-plan: scene-plus-refs;+ story-shape: process-demo;+ edit-language: insert-cutaway;+ camera-language: product-macro;+ motion-intensity: readable;}+ ```- font.inter-black {- src: ./assets/Inter-Black.woff2;- weight: 900;- style: normal;- }+ 模型、分辨率、时长和参考媒体不是模板策略;它们继续存在于精确模型 Surface 与显式图边中。++ ## 精确字体声明++ SVS 描述字体策略,但不选择或打开字体字节。常用开源字体由私有的预发布字体目录显式+ 导入;只有作者图真正引用的字体会进入本次 Build:++ ```svml+ <import as="fonts" from="@narratage/fonts-open@1"/>++ <fonts:Stack id="caption-fonts" family="inter" weight="600" style="normal" emoji="color">+ <fonts:Fallback family="noto-sans-sc" weight="600" style="normal"/>+ </fonts:Stack>```| 属性 | 描述 |@@@ -341,16 -392,16 +385,11 @@@}speaker.host {-- kind: ugc-talking-head;-- model: mini;-- resolution: 720p;-- aspect-ratio: 9:16;composition-stability: soft-locked;camera-motion: none;edit-rhythm: continuous-take;performance: natural-explainer;gesture: natural;-- voice-mode: single-speaker;}film.vertical {@@@ -386,9 -436,10 +424,11 @@@<estimate:Speech id="hook-duration" source={story.segment.hook.speech}policy={studio.speech.normal}/>--<speaker:Take id="hook-take" ... recipe={studio.speaker.host} .../>++<text:Render id="hook-prompt" template={speaker-kit.speaker-v1}++ recipe={studio.speaker.host}>...</text:Render>- <caption:Style id="primary-caption" appearance={studio.caption.primary} .../>+ <caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>- <film:Film id="main" space={speech.space} appearance={studio.film.vertical}>+ <space:Canvas id="vertical" width="720" height="1280"/>+ <film:Film id="main" canvas={vertical} space={speech.space} appearance={studio.film.vertical}>```diff --cc docs/zh/quickstart/timing.mdindex 54a7aaa4,1cca7c32..c395ad8b--- a/docs/zh/quickstart/timing.md+++ b/docs/zh/quickstart/timing.md@@@ -35,7 -38,7 +38,7 @@@ description: Speech Spine 装配与 Whi| 属性 | 必填 | 描述 ||---|---|---|- | `source` | 是 | 生成的视频——来自 `seedance:Speech`、`speaker:Take` 等 |-| `source` | 是 | 生成的视频——来自 `seedance:ReferenceVideo`、`speaker:Take` 等 |++| `source` | 是 | 生成的视频——例如来自 `seedance:ReferenceVideo` || `segment` | 是 | 此片段对应的 Script Segment——例如 `{story.segment.hook}` |`<speech:Take>` 子元素的排列顺序**决定了节目顺序**。第一个片段从时间零点开始;后续片段依次紧接。@@@ -136,7 -139,7 +139,7 @@@ Map 只包含最终词窗口和语义�数据流向:```text--speaker:Take outputs ──► speech:Spine ──► whisperx:Alignment++生成的视频 ─────────────► speech:Spine ──► whisperx:Alignment│ │.visual .map (SemanticMap).audio │diff --cc examples/talking-film-graph-check/svml.packages.lockindex 40fff1b6,7bf23d81..1e4217ab--- a/examples/talking-film-graph-check/svml.packages.lock+++ b/examples/talking-film-graph-check/svml.packages.lock@@@ -4,12 -549,12 +549,12 @@@{"name": "@narratage/artifact","version": "0.0.0-dev",- "digest": "sha256:b16107fdad5256905782fe28142cd19e77673f190691e839fd12d4f1f536ea0f"- "digest": "sha256:6e236d38a96432e6ef45532a2e28d01706eec216593243f1c8127c122d65dad9"++ "digest": "sha256:0821530c8f8bdede8095bbb2bdcc27c11c3e92a1cdfd126758d1d441999a9bad"},{- "name": "@narratage/broll",+ "name": "@narratage/caption-fine","version": "0.0.0-dev",- "digest": "sha256:f058e3161f5ab570e5f180d548ef31e8c70945e8f37d7530caced1d9db31e368"+ "digest": "sha256:8094384ca1980ee72e0a5621a7ee9d62aec167521fdb536eb068eeeecee2ec9c"},{"name": "@narratage/caption-gemini",@@@ -34,7 -579,7 +579,7 @@@{"name": "@narratage/core","version": "0.0.0-dev",- "digest": "sha256:50e6dbf1298fccd3f1fe5cfbcd9968d10ecfdc055adb5a8f79db7db441d37db7"- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"++ "digest": "sha256:44e4bf3a81a43ef3104caca89648963e4d8f7c84dbc0bb75432b1787c4ee8f27"},{"name": "@narratage/elaborator",@@@ -44,7 -589,12 +589,12 @@@{"name": "@narratage/film","version": "0.0.0-dev",- "digest": "sha256:c847365263d42a5136daeac728188dfabb00b9ad4dac669682022d33e7d8f997"- "digest": "sha256:cf696aea5fd093832875c12a7f22e5ee3dbc45679069a1d8644aed0c0309bd19"++ "digest": "sha256:95f89761b3bcadd3c4111244787e8ab4e8695d0980e6da69ea1a77ed9fee6ebe"+ },+ {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev",+ "digest": "sha256:14f53b6b08cfa1a24d0e62c80755e9e24891de9fec7285bfca449019fd0cf965"},{"name": "@narratage/generation",@@@ -59,7 -609,12 +609,12 @@@{"name": "@narratage/hyperframes","version": "0.0.0-dev",- "digest": "sha256:ce3902f4d69c5057a1795fd2d201c189716436c8501f8790d6b1df4ebd2fd691"- "digest": "sha256:cbe9359d2a59fcde65e3b8d4fef43c9965b5e825b2d517fb25babad4c18ed512"++ "digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"+ },+ {+ "name": "@narratage/markup",+ "version": "0.0.0-dev",+ "digest": "sha256:d038863cedf4d22162dc0b390485131caf0977be11032861415a766d068e3745"},{"name": "@narratage/media-pipeline",@@@ -69,7 -629,7 +629,7 @@@{"name": "@narratage/media","version": "0.0.0-dev",- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"- "digest": "sha256:bec05028a561e1e9272756b47df52be20534c235e918df08a4f5f6c4a1db58f7"++ "digest": "sha256:b1d896926ad91ce34ccbd743a6b6785e0c21c90b1072b337421225e5f876a209"},{"name": "@narratage/model-kit",@@@ -84,12 -644,12 +644,12 @@@{"name": "@narratage/program-space","version": "0.0.0-dev",- "digest": "sha256:3a321f064e7f763ae056662ed07bbe4b0fdf1b1628502891c4c73beb5a20edd6"- "digest": "sha256:7f5e69b2642332f7f901569609ac8840d0c8f52d5aa9ff9dad0d894d91895b28"++ "digest": "sha256:e7bbc857d07483aecce6d35fff1e91a51a6c785d13f3223607a91c3fe6e93b5f"},{"name": "@narratage/protocol","version": "0.0.0-dev",- "digest": "sha256:ba71856c619670704e209ea38efdd21fa2af097e4b746206422c9d75334d1939"- "digest": "sha256:b541192f2738fc10940592a6082fb1669967608cbd9b715296b9e5f576aedebd"++ "digest": "sha256:6774f0461a8a248b6f24aa9014738bca328e8aff9704175656ee04f255d8b083"},{"name": "@narratage/render-hyperframes",@@@ -124,7 -684,12 +684,12 @@@{"name": "@narratage/source","version": "0.0.0-dev",- "digest": "sha256:8bbfa48c0fde45639578902c907d9190bd5bbb8a03bd59fca8fd364b820a3184"+ "digest": "sha256:cdf2bca700af10b30f2c29117ed7492fae82a434f4fd3e48747e8c51a7aab4c7"+ },+ {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev",- "digest": "sha256:4b41917023c9a9fc9b1e4a3a2c6d82fafeb3d732733c6e4ca6721ae2009edbdf"++ "digest": "sha256:651ab54204dba22f2815536bf0c03656b17dac8e01032c589f6be132d3921ed3"},{"name": "@narratage/speech-alignment",@@@ -139,7 -704,7 +704,7 @@@{"name": "@narratage/speech-evidence","version": "0.0.0-dev",- "digest": "sha256:a70759a336549bb4f622ff59b0259384d726211afa0cab5d0fcde89eef78fab1"- "digest": "sha256:9aee09fb21db5d3b4a1fd78113a2cb919bd14e2d621a888136ce4fa20faac05c"++ "digest": "sha256:c3b19b7647f203d6dc506b94d2a45203acbb29a66660da6f1771fd0af4910808"},{"name": "@narratage/speech-spine",@@@ -154,12 -719,12 +719,12 @@@{"name": "@narratage/svs","version": "0.0.0-dev",- "digest": "sha256:8973ec01d5c9390da4e5a3f74c7e5af0a4bb49e15796e98e748b75ce62363d9d"+ "digest": "sha256:e44ae945c23e041602eb2f029a4c72b96fc2525e6c767e117e2bf0f11a830e0e"},{- "name": "@narratage/text-track",+ "name": "@narratage/temporal","version": "0.0.0-dev",- "digest": "sha256:19e86a9c77c9a0ad18ec6b02f90babc1dcd659928dc893c69aaf187cd7f16537"- "digest": "sha256:12d53493f58be066b213644f73a127d09d9242f2ccbc3f60eff5b3c2d1f25470"++ "digest": "sha256:b20cb315f5fc365a2e9994c63989a0cc1edc46b5843e06a337827d21d74068a1"},{"name": "@narratage/text",@@@ -174,7 -744,7 +744,7 @@@{"name": "@narratage/visual-ir","version": "0.0.0-dev",- "digest": "sha256:7a112d37e211797b680b2aa37382be47a65a6182e91fdcc93da50e684e50373c"- "digest": "sha256:89d7617f33873d68a3b56ef82f9410b8acd8fef5c4f0fc66b61c7a870595575f"++ "digest": "sha256:a42b9bcc204bf96f9416d786a06dd80c4a08d9a2c8b8d75f1956f8c03134e724"},{"name": "@narratage/whisperx",@@@ -189,26 -759,26 +759,26 @@@"name": "@narratage/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:cf6435732ab7b25c8d0c225042482d940344d5541fe37a4d9cbf905a0d0dad7a",- "closureDigest": "sha256:686a71608546c633b2e43eba93e9386182c60943b26a25da1c036ffbec70ed36"+ "facetsDigest": "sha256:72524ad8d5599450b4ab199680a6382c72c40cbf760f9c0265687f340aa60650",- "closureDigest": "sha256:1fef8a554b4163d5b414f7775df6f43a34cf5e786a142ca84da182e035c08107"++ "closureDigest": "sha256:d946eba0e895f2db33d4418ad9ba96bbf73eb21a66d870d1974b6c73494a886f"},{- "specifier": "@narratage/broll",+ "specifier": "@narratage/caption","package": {- "name": "@narratage/broll",+ "name": "@narratage/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:a30c9a993e7f24f39a78b80f8262022ca8d6250b4d454fc8de91c8922bf8d45a",- "closureDigest": "sha256:7b547f5f2b14bec1640f1c3d683f02899ef394265018b213058c103b9f9bca1b"- "facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",- "closureDigest": "sha256:529d7acaf8f115a20421887944acb5c9a55fa5096d9890f7fb311e0367ff4f3a"++ "facetsDigest": "sha256:6506137d8b76a283947b2ed6566cfd58562ef2a691cc05b665dd70484f6c2e2a",++ "closureDigest": "sha256:f03d80ca88bcc9eb68f72f4382451b7a889b1e2be086a93b3ce285e313bf1f8e"},{- "specifier": "@narratage/caption",+ "specifier": "@narratage/caption-fine","package": {- "name": "@narratage/caption",+ "name": "@narratage/caption-fine","version": "0.0.0-dev"},- "facetsDigest": "sha256:86b692dc498c7d51fb87aab99ceb88464f2e3a86ac48a8abf64349dcc38fb7d0",- "closureDigest": "sha256:0895c2f9a768c88b5ade0b3fa2a8e55b542c56f7badc2250ec196353d0aba40e"- "facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",- "closureDigest": "sha256:a3cc02f32c347960e86e6ba1d9a9d5421c630a1f022c9344dcd0a1fdc41fbf21"++ "facetsDigest": "sha256:b196d99feded56f1ca6ae43414205ab6aa54ade2b22cb24e6d6feb166598a6f4",++ "closureDigest": "sha256:92bfc425dbdec98728a62278b0a2e460eaafecf1a1ebbf62619f002d9fc749d6"},{"specifier": "@narratage/caption-gemini",@@@ -216,8 -786,8 +786,8 @@@"name": "@narratage/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:bee8a4fce6b8213bd1ca1a94811cdcf261b71ecc39ecbf1593afa67f203b7cd5",- "closureDigest": "sha256:92ac37f4f303c1b9f5046f132f660e709181e292365f43b52e9b45cd1fb9dcd0"- "facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",- "closureDigest": "sha256:63e3530e59b9d6a2ba5d43484a4ebdb56d92dbc4b969327400cc11f72775e67a"++ "facetsDigest": "sha256:a1c673e347cee4543ab8949b8fae2e61248979db7851556114ec968756c72e60",++ "closureDigest": "sha256:1277a330bb685cca60066c794d9e86d7860c3ba2cf0a5c889b61c04b6946ea84"},{"specifier": "@narratage/composition",@@@ -225,8 -795,8 +795,8 @@@"name": "@narratage/composition","version": "0.0.0-dev"},- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",- "closureDigest": "sha256:6933f739ef5d87b55dca7acab6be16889011b69d33bc7813ae829b2f4b9de828"- "facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",- "closureDigest": "sha256:99ab833c7be2e6ce9591f5aebeef43cec6b327b126f2c174591af01cb56290a9"++ "facetsDigest": "sha256:855f4123e5ac2b40c32e621c0167e515588c33a9a2f9bbf327a1a57676327223",++ "closureDigest": "sha256:a968d73e961354a8c98fd72954540e47de4c1a55dcc0b1cd6d922f921f949ada"},{"specifier": "@narratage/film",@@@ -234,8 -804,17 +804,17 @@@"name": "@narratage/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",- "closureDigest": "sha256:57bb0ddbf39bdab7fafb7d5c8fdbcb2bcd56f05e7c966aca23523e25ea8891db"- "facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",- "closureDigest": "sha256:cca6cb3b76b6e0744ee9ad00b666076e1db5098e39a8b844d432002019d2b75b"++ "facetsDigest": "sha256:6fd852de1476acf47779dd072d13a02a0e7e01469dee85d366a0152d7fb3c9a8",++ "closureDigest": "sha256:bd74ec8c440e8c450935884f672b5441c54732075c38cea750775a92314300e1"+ },+ {+ "specifier": "@narratage/fonts-open",+ "package": {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",- "closureDigest": "sha256:31d17d4d2f19841ed32f85ac7f9ffe6e77b45b2514cd4cd52a96a979cc848ba0"++ "facetsDigest": "sha256:c81fd5ff3f42020cf6800e77cbbeb6b3f187af135fc4af11c30a3573dd92306f",++ "closureDigest": "sha256:8e9bdf2a8b9d9abc6d66e7a4016ed8987432c0878bf1ff255abcfe6e1f036603"},{"specifier": "@narratage/generation",@@@ -243,8 -822,8 +822,8 @@@"name": "@narratage/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:c52730036a392448eb17cada1dd16b22be9ecb721ba47fb8d8a8633f74e4e039",- "closureDigest": "sha256:4bc35fc3ab4e4808586f26601acc3c72beec98806aeaa0f11d98781e123ca93c"+ "facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",- "closureDigest": "sha256:9afb6284d3dad9ce1213e06afb011211b4b4e4b28a536252b0c5c1849412b78a"++ "closureDigest": "sha256:a2adfd7204c85a3b62711f1ca9693466392390eb6ab78d8bf2732905f834ba91"},{"specifier": "@narratage/hyperframes",@@@ -252,8 -831,8 +831,8 @@@"name": "@narratage/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:a85021fad5a6ad3ab248ddd51ce8473f7e90cee6f9da50c8ec124558e67d5971",- "closureDigest": "sha256:e6b5c90fb98d40a1501e79fa5987e39708f7a59f6e9b66819912332f9d02c2ec"- "facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",- "closureDigest": "sha256:0652bed735647218d6f25a1e5dd2be5341f9a387a7fa5b5748865058bae4cd55"++ "facetsDigest": "sha256:23f1883197740f2896dfa29a4ead467bfc1564b41634e0c14dd55a1d9c77bc17",++ "closureDigest": "sha256:d5bc78df0e42b3a7c2d63caf8cd80d50b375a973a41837a3510f555f6cd68913"},{"specifier": "@narratage/media",@@@ -261,8 -840,8 +840,8 @@@"name": "@narratage/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",- "closureDigest": "sha256:d28634c2265a2d36cff72e149f11a8fba0fa5caf561431d542d5fd6ff5463544"- "facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",- "closureDigest": "sha256:8e3cfeef1b2a0b0bab78e5ac27ac6bbe763ae0216c58d30fdd0688634efcda78"++ "facetsDigest": "sha256:a072c27c26f19f0fcaf7f423ee027c639571d369bca9bef48400a4a035616310",++ "closureDigest": "sha256:28a7c1fbb74bb456e2cad33ba62063762b5b6fc97cb54930e1568a473362ec2b"},{"specifier": "@narratage/media-pipeline",@@@ -270,8 -849,17 +849,17 @@@"name": "@narratage/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:783aeed74e2586b3f4cff5350a27d06de9cb9472a237dabc0d5c68680cca3546",- "closureDigest": "sha256:36e72ba079f2b473f997bec1f8944a7c36ebd6946a828b84161908576b3c314a"- "facetsDigest": "sha256:976b989d377ddaeee207cdf64d76bac74ed3c95f6a6b00e4b9220f4aa2680c50",- "closureDigest": "sha256:db3b293ad595f268a833af091f960119dc966989f4f500b50b196996abb72fc9"++ "facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",++ "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"+ },+ {+ "specifier": "@narratage/media-track",+ "package": {+ "name": "@narratage/media-track",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:b3e32ad8fd0f074d9e7cb707383e45c79f89ed1c28044f6d70294c96411cb393",- "closureDigest": "sha256:f5b519c4164b49cb4c530d9ab0b7efcab58a55f4a8f19decd4428096a25e992e"++ "facetsDigest": "sha256:0d3f3910c8c01dd910cbb30836768302d7bfbca2bb96dc5ed9dd5ace0c6ae055",++ "closureDigest": "sha256:b9a5aa60f8ef122cb440884ab87611d5f212f9091e09da725799db8606c048e1"},{"specifier": "@narratage/narrative",@@@ -279,8 -867,8 +867,8 @@@"name": "@narratage/narrative","version": "0.0.0-dev"},- "facetsDigest": "sha256:849b7e49ef228b44d07ae57a106b18a24c7730c88783057bcdbad1e2e61153d3",- "closureDigest": "sha256:40c0f9e814f4c09567f45ca2cbfabeec756aa2aa317c914c3bdd40ea2cab3473"+ "facetsDigest": "sha256:703db7ad343b00701dc39e3b316992dc371307f0c6c2ad15d1e0269257ffb326",- "closureDigest": "sha256:923877d78b1b2e9c3ae6a57990e8feebb31ef2b528a6b27de5a91c850998d362"++ "closureDigest": "sha256:112da177d39db502da452b13d7bf17d42c39bc9db4a20102e0078adf8f0ca277"},{"specifier": "@narratage/program-space",@@@ -288,8 -876,8 +876,8 @@@"name": "@narratage/program-space","version": "0.0.0-dev"},- "facetsDigest": "sha256:5fa9b120e8d37ca2edd478e3388c3dc4e398113e74c6589c6d25ef604a1d348a",- "closureDigest": "sha256:15e746b7fe84630f61f08499c52ce810b48919881000e40d97e87358be8779d8"- "facetsDigest": "sha256:b1e4eab41a135914556872f0f47a0c02b8ce76920366cbf86121b720af069052",- "closureDigest": "sha256:d108ad2d1d34a512288faa0dc43fc11cc451b9816ff51d6c19dd1e892dade92a"++ "facetsDigest": "sha256:45ebd22857f2d6817cb8e464ceeb37bea742e01e95edaaa3f3e6867621d2a3cb",++ "closureDigest": "sha256:b849886764e88c35396a5295ce20c265bb7ecfac979fd5b9b4a4d177145e2e49"},{"specifier": "@narratage/render-hyperframes",@@@ -297,17 -885,17 +885,17 @@@"name": "@narratage/render-hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:8fcb965f660a24bfbe2808f0e288d0afb316d772ec5d6f189530d3602a9f9186",- "closureDigest": "sha256:eace40b956a40685862e46b9cd3b8e29f32120bb74d8c41d09977ea354522af7"- "facetsDigest": "sha256:4210736adc699b3b5f86bf8b0cd84cd7a3c946754c8f19ceae5e0390a3d1d9c5",- "closureDigest": "sha256:396057461f2715ea0a2890418e237c35a51ccc379ead2cef85392cdfb54015dd"++ "facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",++ "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"},{- "specifier": "@narratage/run-text",+ "specifier": "@narratage/run-markup","package": {- "name": "@narratage/run-text",+ "name": "@narratage/run-markup","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbcab7cea86223fe00ea04b51c2160bb534aafbb99067f5877e6825b0ce4eefc",- "closureDigest": "sha256:9d0cf75312cee931dd5c5d3c7f87134178ea9671d99858dd5ed601b7d5d1ac6a"+ "facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"++ "closureDigest": "sha256:0f3f2c4da7f40e8ae0a6c82ae76df71e82524258ddeff474a141790beb779425"},{"specifier": "@narratage/script",@@@ -315,8 -903,8 +903,8 @@@"name": "@narratage/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:42d654cd2ce1e48b6a0edb036e4ef742ab59cd73abb2bb42f66ab522ae41e34e",- "closureDigest": "sha256:29f695f2d8584b0ddd80f53252df0127911b182fa59d41b430112eaa5eff01b2"+ "facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",- "closureDigest": "sha256:dfded35adc0aa0d163fba58d375fccc9a69b4ad1168744dc9c2826b9f914cd78"++ "closureDigest": "sha256:715402ed32dc6ee82909ba4e3e331df2200360003d85855af608228dc6d7723d"},{"specifier": "@narratage/seedance",@@@ -324,8 -912,8 +912,8 @@@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:25a6e78020082829e4ad5b41609f11b82933fb99d6fdb7958d392fa646eaa94b",- "closureDigest": "sha256:138c8e96a9f08d92fde7a6b81d2d7c464d3263234c9930aac5a7faafa0a727b5"- "facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",- "closureDigest": "sha256:29c64c13377e07b6fb100a57c66cda66a05cb671e2d45c663b9bd0c9c926ffac"++ "facetsDigest": "sha256:e9e09bc47e47706f9d5a6a69ba27df6f60aad62f27b131e0a98899ecdb1cad11",++ "closureDigest": "sha256:88e2b038cd1513a4cf3667c296621c4215efe2b9d5e754a22edf47e7b70eeab5"},{"specifier": "@narratage/semantic-map",@@@ -333,8 -921,17 +921,17 @@@"name": "@narratage/semantic-map","version": "0.0.0-dev"},- "facetsDigest": "sha256:4f041c5844a3eb9a70e8472d4cf4f534de960a77745819366dac0061ec600e76",- "closureDigest": "sha256:07e886c67958b327fe79726a2f6ac967cb79088fa4ca33882196922ce740532a"- "facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",- "closureDigest": "sha256:548f991bc177fe8f99a09c1b25158f9e6e3575e9cc69b3b43717991b77f804e2"++ "facetsDigest": "sha256:6c4a27fc5cd63a59002f3cd433ae432b7129acb3a501a117fee1db19fb1900aa",++ "closureDigest": "sha256:b032e7e27224d005a1d1eb147b0bb0b73ce17a712919b6182d88f2ba715c4203"+ },+ {+ "specifier": "@narratage/spatial",+ "package": {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"++ "facetsDigest": "sha256:6cc59a18d8dda2312f3a315eb4d60a57163df1334e2ccd62641118c2304c06dc",++ "closureDigest": "sha256:28ab5737ee6d4af10593dd7d443ca56c68102b7482aecdf8fe915eeb2611e457"},{"specifier": "@narratage/speech",@@@ -342,8 -939,8 +939,8 @@@"name": "@narratage/speech","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbecf0c9334b34c91f49c4edd9f2592d7b49856ec2d8a875dd272f47ade29a18",- "closureDigest": "sha256:919377b0b462538e1071bb1aa48bb1603a29b9b7c8b9054861343b8e62f59d23"- "facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",- "closureDigest": "sha256:4c39cb573f1f8515368edd0793079e46d36ef22740cdebb515f9b8565f124970"++ "facetsDigest": "sha256:212c25bf0eb71a0f4bbb29da485370b4011fd37e27187746f6f0e83799e4fd68",++ "closureDigest": "sha256:9904ffdd31df20cae6a638f7d2797c8f0af7f86194f928077158931bffbf1012"},{"specifier": "@narratage/speech-alignment",@@@ -351,8 -948,8 +948,8 @@@"name": "@narratage/speech-alignment","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3f48d736480bd0e1911a9195d9143ffb5c38a91bdcc55584845d6488cccc14f",- "closureDigest": "sha256:b7604040e35473309ca5843cbcbe3d0f1a453fa1f8353da1bdc4361ceec14519"- "facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",- "closureDigest": "sha256:0ae8008b1373a4a7383f34e2d81629a47c012ab7f397064436919072c3f39d54"++ "facetsDigest": "sha256:e921cb1351e86fe1bf072a0e9166cf5f5ee14c0ec5d59dacca08bfc5eb4ada65",++ "closureDigest": "sha256:36f92d5d9ff633c143206d5b09e2bee00e1d05eb5e0c652791d6d56eeabe2855"},{"specifier": "@narratage/speech-basis",@@@ -360,8 -957,8 +957,8 @@@"name": "@narratage/speech-basis","version": "0.0.0-dev"},- "facetsDigest": "sha256:9703845ab4a67b1a1fba98b276f5c913baec80748a08c0d63dc1b10caef8466f",- "closureDigest": "sha256:62f0ee7705817ba70a94c78a6d00377628f8548f22d7d6ce8daed97048112e0b"- "facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",- "closureDigest": "sha256:d7b8dbd8a162c49da9848c2d9f052c0d4a3786464041b9dec8c8f8d9c08cf8e8"++ "facetsDigest": "sha256:3f0fb57eddecbede68f9f56f96e47db0412f26ac444261ca90748550b483b79f",++ "closureDigest": "sha256:047fd7922dc29b5dba22c3aaa4e72d979f1c528be7ab9a9bf777787a5cb9c57d"},{"specifier": "@narratage/speech-evidence",@@@ -369,8 -966,8 +966,8 @@@"name": "@narratage/speech-evidence","version": "0.0.0-dev"},- "facetsDigest": "sha256:69110ba7b1740b0e609f6beef673fe4ef113ba5b0c803fb785ecf1dc9325f0a7",- "closureDigest": "sha256:ebe2ab569881b98726bbc3aafc3dc546794530cd3f656b1b4fdf2d5b30a297ae"- "facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",- "closureDigest": "sha256:e373b232b2ede34607c6f3cb591a8f6f08154f629061f78b0f573828db7d4ba0"++ "facetsDigest": "sha256:9980230b5a602f483267f5ab5fd0edafc54d67bdd6d8d2691eb489075505a72e",++ "closureDigest": "sha256:2e6610858ff681da612b5922c04cc7f4b489996e841177cbb8d1124cf9e0a409"},{"specifier": "@narratage/speech-spine",@@@ -378,8 -975,8 +975,8 @@@"name": "@narratage/speech-spine","version": "0.0.0-dev"},- "facetsDigest": "sha256:a4cdbee32b5752810b440adb83ba73a4261b4a61f5a750c6712a721f3265ad48",- "closureDigest": "sha256:3d7f54d31a3c38ee46e104f68349539d023d0b59b230ef07b407268452834ada"- "facetsDigest": "sha256:4af25fdcd03b5dde7c6151419885646c6862978aa5c88fe3df66c7daec1b0199",- "closureDigest": "sha256:8bd3cecc005cb3fb83d4dbc67cbbe6dba2d1c786b82108f54ff9fa6ea21bda76"++ "facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",++ "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"},{"specifier": "@narratage/svs",@@@ -388,16 -985,34 +985,34 @@@"version": "0.0.0-dev"},"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",- "closureDigest": "sha256:e86149074328a4cd324f8b90249e7a991ac2166dd121a0f1837410a697c2c4f0"- "closureDigest": "sha256:6ee450114180d7f6f515b834a9cf1000795007b3ec8e57ba6860b30320fb2eba"++ "closureDigest": "sha256:68904cf8f1024e6d0d034592b7246a47346cde3aa5b1e5cc1009b3601e9d5465"+ },+ {+ "specifier": "@narratage/temporal",+ "package": {+ "name": "@narratage/temporal",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:2e9c4804f142e08e87b2e11af79aa17770109fb573e865397bed14ed7a4f1d0e",- "closureDigest": "sha256:a44823659b48d81219ce43c86a5d1c6c527da3382d30c5f72501bd0536557f91"++ "closureDigest": "sha256:889c7d995b72b77acd480c87e0d4572b3ad323456d527086d2f1d6b958caa132"+ },+ {+ "specifier": "@narratage/text",+ "package": {+ "name": "@narratage/text",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",- "closureDigest": "sha256:888a51aafa5225bee3cd589318f12e2974735ddea62e96d2bf8a098ad39b1389"++ "closureDigest": "sha256:3b287bedddfcb409e2809cc8383d881da4220a201d80cd287aacfc85b01cf9a4"},{- "specifier": "@narratage/text-track",+ "specifier": "@narratage/typography-track","package": {- "name": "@narratage/text-track",+ "name": "@narratage/typography-track","version": "0.0.0-dev"},- "facetsDigest": "sha256:9384a365dc85a38dcbd32fa316b9ecca1f226587494bb958a285d797f7babac6",- "closureDigest": "sha256:e2d3491d96b7cbe13e9355a12a5002d79aaf4b26afe2ce919a2aff48d4055767"- "facetsDigest": "sha256:cc8349fec027f43e01a8832ba8a7050490e924851cee3325d3568cb5bc5fd57f",- "closureDigest": "sha256:1f945b0e7cc10f4de4520dfe0e444cda87aada5892b084966b5675c600078dac"++ "facetsDigest": "sha256:c48b80647a5026f671e34663e494635f0303e639142561984470cbb3e065e55f",++ "closureDigest": "sha256:96e7d161b701e5d598e57e12757c640533e4340764cb0c31089ac8cce59da77d"},{"specifier": "@narratage/visual-ir",@@@ -405,8 -1020,8 +1020,8 @@@"name": "@narratage/visual-ir","version": "0.0.0-dev"},- "facetsDigest": "sha256:a8d72579639a41123f5ac017e98781819012adc52d94a8116c5a072dc9e6fc05",- "closureDigest": "sha256:99f2af6ebe97abebe141f78baedf87c67c547f62bfce5c966706dc4c8ee86c47"+ "facetsDigest": "sha256:8c577a635a48ee04441068df1f3dc2c18a602bff091fddca8883a3843ce4ce37",- "closureDigest": "sha256:a66c982075fe02c746a5802cc8c67b6e08481ae2fb159a0fa496510c5172c60c"++ "closureDigest": "sha256:6d001437aa17e2f5c6aab656cdb2b02830fea5db834c1397ae321cddf6da35da"},{"specifier": "@narratage/whisperx",@@@ -414,9 -1029,9 +1029,9 @@@"name": "@narratage/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:0eb8b7e5605851c873e0d37385577242a761e23d6eae9b0a495a2667ba71a082",- "closureDigest": "sha256:e596704f26f2aafcacc647dc02c54dc3ede198de4a06e7b5bc097758e2249682"- "facetsDigest": "sha256:73fceef213e8d6bcad92532c5d712842e62921743b81bc7bb4d9022a92067359",- "closureDigest": "sha256:6866f06f64152df2bf378c2788d187cfc1718a83e7471104342ef6818d5da5e7"++ "facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",++ "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"}],- "digest": "sha256:fd90a74f3de7f6af3952538a47d1f565607265a15f9bcfa25d892bc38668ee6f"- "digest": "sha256:22c0e0bb1449e0e44a60132912cae3552647861eccc85aacc957788d10df9489"++ "digest": "sha256:1cbafbf8d879d9ebcb4b008928919c40d7d00158c97ba316ef638f61c03daaf5"}diff --cc examples/talking-film-live/svml.packages.lockindex 0463fac1,6ecebe31..064c671e--- a/examples/talking-film-live/svml.packages.lock+++ b/examples/talking-film-live/svml.packages.lock@@@ -4,7 -549,12 +549,12 @@@{"name": "@narratage/artifact","version": "0.0.0-dev",- "digest": "sha256:b16107fdad5256905782fe28142cd19e77673f190691e839fd12d4f1f536ea0f"- "digest": "sha256:6e236d38a96432e6ef45532a2e28d01706eec216593243f1c8127c122d65dad9"++ "digest": "sha256:0821530c8f8bdede8095bbb2bdcc27c11c3e92a1cdfd126758d1d441999a9bad"+ },+ {+ "name": "@narratage/caption-fine",+ "version": "0.0.0-dev",+ "digest": "sha256:8094384ca1980ee72e0a5621a7ee9d62aec167521fdb536eb068eeeecee2ec9c"},{"name": "@narratage/caption-gemini",@@@ -29,7 -579,7 +579,7 @@@{"name": "@narratage/core","version": "0.0.0-dev",- "digest": "sha256:b1fafa8715899f565a03794849045846b5cc08fd3f51a12d5f7374a9c66d8534"- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"++ "digest": "sha256:44e4bf3a81a43ef3104caca89648963e4d8f7c84dbc0bb75432b1787c4ee8f27"},{"name": "@narratage/elaborator",@@@ -44,7 -594,12 +594,12 @@@{"name": "@narratage/film","version": "0.0.0-dev",- "digest": "sha256:c847365263d42a5136daeac728188dfabb00b9ad4dac669682022d33e7d8f997"- "digest": "sha256:cf696aea5fd093832875c12a7f22e5ee3dbc45679069a1d8644aed0c0309bd19"++ "digest": "sha256:95f89761b3bcadd3c4111244787e8ab4e8695d0980e6da69ea1a77ed9fee6ebe"+ },+ {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev",+ "digest": "sha256:14f53b6b08cfa1a24d0e62c80755e9e24891de9fec7285bfca449019fd0cf965"},{"name": "@narratage/generation",@@@ -59,7 -614,12 +614,12 @@@{"name": "@narratage/hyperframes","version": "0.0.0-dev",- "digest": "sha256:fa8536f53f6f9d84dbe587eba814d97299767a359a95fe76a437b257659c27f6"- "digest": "sha256:cbe9359d2a59fcde65e3b8d4fef43c9965b5e825b2d517fb25babad4c18ed512"++ "digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"+ },+ {+ "name": "@narratage/markup",+ "version": "0.0.0-dev",+ "digest": "sha256:d038863cedf4d22162dc0b390485131caf0977be11032861415a766d068e3745"},{"name": "@narratage/media-pipeline",@@@ -69,7 -634,7 +634,7 @@@{"name": "@narratage/media","version": "0.0.0-dev",- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"- "digest": "sha256:bec05028a561e1e9272756b47df52be20534c235e918df08a4f5f6c4a1db58f7"++ "digest": "sha256:b1d896926ad91ce34ccbd743a6b6785e0c21c90b1072b337421225e5f876a209"},{"name": "@narratage/model-kit",@@@ -84,12 -649,12 +649,12 @@@{"name": "@narratage/program-space","version": "0.0.0-dev",- "digest": "sha256:3a321f064e7f763ae056662ed07bbe4b0fdf1b1628502891c4c73beb5a20edd6"- "digest": "sha256:7f5e69b2642332f7f901569609ac8840d0c8f52d5aa9ff9dad0d894d91895b28"++ "digest": "sha256:e7bbc857d07483aecce6d35fff1e91a51a6c785d13f3223607a91c3fe6e93b5f"},{"name": "@narratage/protocol","version": "0.0.0-dev",- "digest": "sha256:aba55408fd1ffec38c1ce2e81706aaadad48277a2fe4b9adc6323674e1b23ce6"- "digest": "sha256:b541192f2738fc10940592a6082fb1669967608cbd9b715296b9e5f576aedebd"++ "digest": "sha256:6774f0461a8a248b6f24aa9014738bca328e8aff9704175656ee04f255d8b083"},{"name": "@narratage/render-hyperframes",@@@ -124,7 -689,12 +689,12 @@@{"name": "@narratage/source","version": "0.0.0-dev",- "digest": "sha256:8bbfa48c0fde45639578902c907d9190bd5bbb8a03bd59fca8fd364b820a3184"+ "digest": "sha256:cdf2bca700af10b30f2c29117ed7492fae82a434f4fd3e48747e8c51a7aab4c7"+ },+ {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev",- "digest": "sha256:4b41917023c9a9fc9b1e4a3a2c6d82fafeb3d732733c6e4ca6721ae2009edbdf"++ "digest": "sha256:651ab54204dba22f2815536bf0c03656b17dac8e01032c589f6be132d3921ed3"},{"name": "@narratage/speech-alignment",@@@ -139,7 -709,7 +709,7 @@@{"name": "@narratage/speech-evidence","version": "0.0.0-dev",- "digest": "sha256:a70759a336549bb4f622ff59b0259384d726211afa0cab5d0fcde89eef78fab1"- "digest": "sha256:9aee09fb21db5d3b4a1fd78113a2cb919bd14e2d621a888136ce4fa20faac05c"++ "digest": "sha256:c3b19b7647f203d6dc506b94d2a45203acbb29a66660da6f1771fd0af4910808"},{"name": "@narratage/speech-spine",@@@ -154,12 -724,12 +724,12 @@@{"name": "@narratage/svs","version": "0.0.0-dev",- "digest": "sha256:8973ec01d5c9390da4e5a3f74c7e5af0a4bb49e15796e98e748b75ce62363d9d"+ "digest": "sha256:e44ae945c23e041602eb2f029a4c72b96fc2525e6c767e117e2bf0f11a830e0e"},{- "name": "@narratage/text-track",+ "name": "@narratage/temporal","version": "0.0.0-dev",- "digest": "sha256:19e86a9c77c9a0ad18ec6b02f90babc1dcd659928dc893c69aaf187cd7f16537"- "digest": "sha256:12d53493f58be066b213644f73a127d09d9242f2ccbc3f60eff5b3c2d1f25470"++ "digest": "sha256:b20cb315f5fc365a2e9994c63989a0cc1edc46b5843e06a337827d21d74068a1"},{"name": "@narratage/text",@@@ -174,7 -749,7 +749,7 @@@{"name": "@narratage/visual-ir","version": "0.0.0-dev",- "digest": "sha256:7a112d37e211797b680b2aa37382be47a65a6182e91fdcc93da50e684e50373c"- "digest": "sha256:89d7617f33873d68a3b56ef82f9410b8acd8fef5c4f0fc66b61c7a870595575f"++ "digest": "sha256:a42b9bcc204bf96f9416d786a06dd80c4a08d9a2c8b8d75f1956f8c03134e724"},{"name": "@narratage/whisperx",@@@ -189,8 -769,8 +769,8 @@@"name": "@narratage/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:cf6435732ab7b25c8d0c225042482d940344d5541fe37a4d9cbf905a0d0dad7a",- "closureDigest": "sha256:d4386b53042e584f162c2882bdc3b515c19f10a87b23c3e9634852fdad75c1ae"+ "facetsDigest": "sha256:72524ad8d5599450b4ab199680a6382c72c40cbf760f9c0265687f340aa60650",- "closureDigest": "sha256:1fef8a554b4163d5b414f7775df6f43a34cf5e786a142ca84da182e035c08107"++ "closureDigest": "sha256:d946eba0e895f2db33d4418ad9ba96bbf73eb21a66d870d1974b6c73494a886f"},{"specifier": "@narratage/caption",@@@ -198,8 -778,17 +778,17 @@@"name": "@narratage/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:86b692dc498c7d51fb87aab99ceb88464f2e3a86ac48a8abf64349dcc38fb7d0",- "closureDigest": "sha256:04e096f78374a1ac9dd53988a5356c06d4b59f1989fedb495c459cfc12df275b"- "facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",- "closureDigest": "sha256:529d7acaf8f115a20421887944acb5c9a55fa5096d9890f7fb311e0367ff4f3a"++ "facetsDigest": "sha256:6506137d8b76a283947b2ed6566cfd58562ef2a691cc05b665dd70484f6c2e2a",++ "closureDigest": "sha256:f03d80ca88bcc9eb68f72f4382451b7a889b1e2be086a93b3ce285e313bf1f8e"+ },+ {+ "specifier": "@narratage/caption-fine",+ "package": {+ "name": "@narratage/caption-fine",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",- "closureDigest": "sha256:a3cc02f32c347960e86e6ba1d9a9d5421c630a1f022c9344dcd0a1fdc41fbf21"++ "facetsDigest": "sha256:b196d99feded56f1ca6ae43414205ab6aa54ade2b22cb24e6d6feb166598a6f4",++ "closureDigest": "sha256:92bfc425dbdec98728a62278b0a2e460eaafecf1a1ebbf62619f002d9fc749d6"},{"specifier": "@narratage/caption-gemini",@@@ -207,8 -796,8 +796,8 @@@"name": "@narratage/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:bee8a4fce6b8213bd1ca1a94811cdcf261b71ecc39ecbf1593afa67f203b7cd5",- "closureDigest": "sha256:3764226d419778d413d503110fef77ee05f506c7c3ac61f18d341b8c038ad8bc"- "facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",- "closureDigest": "sha256:63e3530e59b9d6a2ba5d43484a4ebdb56d92dbc4b969327400cc11f72775e67a"++ "facetsDigest": "sha256:a1c673e347cee4543ab8949b8fae2e61248979db7851556114ec968756c72e60",++ "closureDigest": "sha256:1277a330bb685cca60066c794d9e86d7860c3ba2cf0a5c889b61c04b6946ea84"},{"specifier": "@narratage/composition",@@@ -216,8 -805,8 +805,8 @@@"name": "@narratage/composition","version": "0.0.0-dev"},- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",- "closureDigest": "sha256:ce5d73afa84939ee528d9095b711df49191e4695797e25ede03ccf2ae3ccf0b0"- "facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",- "closureDigest": "sha256:99ab833c7be2e6ce9591f5aebeef43cec6b327b126f2c174591af01cb56290a9"++ "facetsDigest": "sha256:855f4123e5ac2b40c32e621c0167e515588c33a9a2f9bbf327a1a57676327223",++ "closureDigest": "sha256:a968d73e961354a8c98fd72954540e47de4c1a55dcc0b1cd6d922f921f949ada"},{"specifier": "@narratage/estimate",@@@ -225,8 -814,8 +814,8 @@@"name": "@narratage/estimate","version": "0.0.0-dev"},- "facetsDigest": "sha256:b737a89381747c16afbc9cc026f268b83e8e6c02b707f85a44c28f66c8807eaa",- "closureDigest": "sha256:2159640d3162218483d6c5fddf5503fba86dd862570c8b11c6890ba799a775c3"- "facetsDigest": "sha256:9975815b3109520eb6bba276554a90767a9aebff6498c2768d9faf4763219bef",- "closureDigest": "sha256:eff306b2cca813d5664417770289b752038491b1ad6c93e38801c9411ff180c6"++ "facetsDigest": "sha256:430724962414edc2ce462168db5e55190da4845f2cfaddfaa9a1891b77dfa14a",++ "closureDigest": "sha256:366cba8d88f097f916531187d0e267c4340959eea7b916a86fd43d340187af38"},{"specifier": "@narratage/film",@@@ -234,8 -823,17 +823,17 @@@"name": "@narratage/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",- "closureDigest": "sha256:ff9630a80e02f73efdfc06b6eec8f76cd5d8feeaf0f4332d25512a4d637b3a35"- "facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",- "closureDigest": "sha256:cca6cb3b76b6e0744ee9ad00b666076e1db5098e39a8b844d432002019d2b75b"++ "facetsDigest": "sha256:6fd852de1476acf47779dd072d13a02a0e7e01469dee85d366a0152d7fb3c9a8",++ "closureDigest": "sha256:bd74ec8c440e8c450935884f672b5441c54732075c38cea750775a92314300e1"+ },+ {+ "specifier": "@narratage/fonts-open",+ "package": {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",- "closureDigest": "sha256:31d17d4d2f19841ed32f85ac7f9ffe6e77b45b2514cd4cd52a96a979cc848ba0"++ "facetsDigest": "sha256:c81fd5ff3f42020cf6800e77cbbeb6b3f187af135fc4af11c30a3573dd92306f",++ "closureDigest": "sha256:8e9bdf2a8b9d9abc6d66e7a4016ed8987432c0878bf1ff255abcfe6e1f036603"},{"specifier": "@narratage/generation",@@@ -243,8 -841,8 +841,8 @@@"name": "@narratage/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:c52730036a392448eb17cada1dd16b22be9ecb721ba47fb8d8a8633f74e4e039",- "closureDigest": "sha256:b3e11e3be1161e7ce0cf7bac7a2dbfc61fea637ee4fbbc6dcb7144ff060d9112"+ "facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",- "closureDigest": "sha256:9afb6284d3dad9ce1213e06afb011211b4b4e4b28a536252b0c5c1849412b78a"++ "closureDigest": "sha256:a2adfd7204c85a3b62711f1ca9693466392390eb6ab78d8bf2732905f834ba91"},{"specifier": "@narratage/hyperframes",@@@ -252,8 -850,8 +850,8 @@@"name": "@narratage/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:a85021fad5a6ad3ab248ddd51ce8473f7e90cee6f9da50c8ec124558e67d5971",- "closureDigest": "sha256:1f91f9acc75cf392150311c6952078c400b8c23f6425514412b4328d0ee60b09"- "facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",- "closureDigest": "sha256:0652bed735647218d6f25a1e5dd2be5341f9a387a7fa5b5748865058bae4cd55"++ "facetsDigest": "sha256:23f1883197740f2896dfa29a4ead467bfc1564b41634e0c14dd55a1d9c77bc17",++ "closureDigest": "sha256:d5bc78df0e42b3a7c2d63caf8cd80d50b375a973a41837a3510f555f6cd68913"},{"specifier": "@narratage/media",@@@ -261,8 -859,8 +859,8 @@@"name": "@narratage/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",- "closureDigest": "sha256:5fc9bfafba5249455364fc8b4ce60dd21fc861a0888ca21c7c8de33996481bf3"- "facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",- "closureDigest": "sha256:8e3cfeef1b2a0b0bab78e5ac27ac6bbe763ae0216c58d30fdd0688634efcda78"++ "facetsDigest": "sha256:a072c27c26f19f0fcaf7f423ee027c639571d369bca9bef48400a4a035616310",++ "closureDigest": "sha256:28a7c1fbb74bb456e2cad33ba62063762b5b6fc97cb54930e1568a473362ec2b"},{"specifier": "@narratage/media-pipeline",@@@ -270,8 -868,17 +868,17 @@@"name": "@narratage/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:783aeed74e2586b3f4cff5350a27d06de9cb9472a237dabc0d5c68680cca3546",- "closureDigest": "sha256:cc85343af360eca7440e3c700b86650eb080882be737df0aeb0ca9a4f7ab8106"- "facetsDigest": "sha256:976b989d377ddaeee207cdf64d76bac74ed3c95f6a6b00e4b9220f4aa2680c50",- "closureDigest": "sha256:db3b293ad595f268a833af091f960119dc966989f4f500b50b196996abb72fc9"++ "facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",++ "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"+ },+ {+ "specifier": "@narratage/media-track",+ "package": {+ "name": "@narratage/media-track",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:b3e32ad8fd0f074d9e7cb707383e45c79f89ed1c28044f6d70294c96411cb393",- "closureDigest": "sha256:f5b519c4164b49cb4c530d9ab0b7efcab58a55f4a8f19decd4428096a25e992e"++ "facetsDigest": "sha256:0d3f3910c8c01dd910cbb30836768302d7bfbca2bb96dc5ed9dd5ace0c6ae055",++ "closureDigest": "sha256:b9a5aa60f8ef122cb440884ab87611d5f212f9091e09da725799db8606c048e1"},{"specifier": "@narratage/narrative",@@@ -279,8 -886,8 +886,8 @@@"name": "@narratage/narrative","version": "0.0.0-dev"},- "facetsDigest": "sha256:849b7e49ef228b44d07ae57a106b18a24c7730c88783057bcdbad1e2e61153d3",- "closureDigest": "sha256:e8030a009c4904f38373be51c372d5fcf0947aff81ed07317fce62b1930904cb"+ "facetsDigest": "sha256:703db7ad343b00701dc39e3b316992dc371307f0c6c2ad15d1e0269257ffb326",- "closureDigest": "sha256:923877d78b1b2e9c3ae6a57990e8feebb31ef2b528a6b27de5a91c850998d362"++ "closureDigest": "sha256:112da177d39db502da452b13d7bf17d42c39bc9db4a20102e0078adf8f0ca277"},{"specifier": "@narratage/program-space",@@@ -288,8 -895,8 +895,8 @@@"name": "@narratage/program-space","version": "0.0.0-dev"},- "facetsDigest": "sha256:5fa9b120e8d37ca2edd478e3388c3dc4e398113e74c6589c6d25ef604a1d348a",- "closureDigest": "sha256:802f9ab8cf9bd284b8df0ef8ab78fc780339b175996d3626e5ba30f18f5349f1"- "facetsDigest": "sha256:b1e4eab41a135914556872f0f47a0c02b8ce76920366cbf86121b720af069052",- "closureDigest": "sha256:d108ad2d1d34a512288faa0dc43fc11cc451b9816ff51d6c19dd1e892dade92a"++ "facetsDigest": "sha256:45ebd22857f2d6817cb8e464ceeb37bea742e01e95edaaa3f3e6867621d2a3cb",++ "closureDigest": "sha256:b849886764e88c35396a5295ce20c265bb7ecfac979fd5b9b4a4d177145e2e49"},{"specifier": "@narratage/render-hyperframes",@@@ -297,17 -904,17 +904,17 @@@"name": "@narratage/render-hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:8fcb965f660a24bfbe2808f0e288d0afb316d772ec5d6f189530d3602a9f9186",- "closureDigest": "sha256:4c49f355407f2bd9824cb1d28ccda1628dc98b498e869bafe5c4d2ef5490385e"- "facetsDigest": "sha256:4210736adc699b3b5f86bf8b0cd84cd7a3c946754c8f19ceae5e0390a3d1d9c5",- "closureDigest": "sha256:396057461f2715ea0a2890418e237c35a51ccc379ead2cef85392cdfb54015dd"++ "facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",++ "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"},{- "specifier": "@narratage/run-text",+ "specifier": "@narratage/run-markup","package": {- "name": "@narratage/run-text",+ "name": "@narratage/run-markup","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbcab7cea86223fe00ea04b51c2160bb534aafbb99067f5877e6825b0ce4eefc",- "closureDigest": "sha256:de91d32eab3d3cfb7068f729dad5c41e1b6134f1360b799f3d8982d46ee34aa1"+ "facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"++ "closureDigest": "sha256:0f3f2c4da7f40e8ae0a6c82ae76df71e82524258ddeff474a141790beb779425"},{"specifier": "@narratage/script",@@@ -315,8 -922,8 +922,8 @@@"name": "@narratage/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:42d654cd2ce1e48b6a0edb036e4ef742ab59cd73abb2bb42f66ab522ae41e34e",- "closureDigest": "sha256:c29b5586b3a6a1d88a7805f828cd96548f6a1e787b2163dcbf46ee235646d4e4"+ "facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",- "closureDigest": "sha256:dfded35adc0aa0d163fba58d375fccc9a69b4ad1168744dc9c2826b9f914cd78"++ "closureDigest": "sha256:715402ed32dc6ee82909ba4e3e331df2200360003d85855af608228dc6d7723d"},{"specifier": "@narratage/seedance",@@@ -324,8 -931,8 +931,8 @@@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:25a6e78020082829e4ad5b41609f11b82933fb99d6fdb7958d392fa646eaa94b",- "closureDigest": "sha256:6887a5187321112b887630c45cc4ee1aca638de2fe0c5e9bba9f8b0dbb317f2d"- "facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",- "closureDigest": "sha256:29c64c13377e07b6fb100a57c66cda66a05cb671e2d45c663b9bd0c9c926ffac"++ "facetsDigest": "sha256:e9e09bc47e47706f9d5a6a69ba27df6f60aad62f27b131e0a98899ecdb1cad11",++ "closureDigest": "sha256:88e2b038cd1513a4cf3667c296621c4215efe2b9d5e754a22edf47e7b70eeab5"},{"specifier": "@narratage/semantic-map",@@@ -333,8 -940,17 +940,17 @@@"name": "@narratage/semantic-map","version": "0.0.0-dev"},- "facetsDigest": "sha256:4f041c5844a3eb9a70e8472d4cf4f534de960a77745819366dac0061ec600e76",- "closureDigest": "sha256:5cb3e8f8cf64ab9bb3359541d0c8252fbf032daaf82602873680e576de7e7aa7"- "facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",- "closureDigest": "sha256:548f991bc177fe8f99a09c1b25158f9e6e3575e9cc69b3b43717991b77f804e2"++ "facetsDigest": "sha256:6c4a27fc5cd63a59002f3cd433ae432b7129acb3a501a117fee1db19fb1900aa",++ "closureDigest": "sha256:b032e7e27224d005a1d1eb147b0bb0b73ce17a712919b6182d88f2ba715c4203"+ },+ {+ "specifier": "@narratage/spatial",+ "package": {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"++ "facetsDigest": "sha256:6cc59a18d8dda2312f3a315eb4d60a57163df1334e2ccd62641118c2304c06dc",++ "closureDigest": "sha256:28ab5737ee6d4af10593dd7d443ca56c68102b7482aecdf8fe915eeb2611e457"},{"specifier": "@narratage/speech",@@@ -342,8 -958,8 +958,8 @@@"name": "@narratage/speech","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbecf0c9334b34c91f49c4edd9f2592d7b49856ec2d8a875dd272f47ade29a18",- "closureDigest": "sha256:dd94752413a319c64150b3a996e184adc1e4c16b02947e69cf1c63285b7a2fb4"- "facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",- "closureDigest": "sha256:4c39cb573f1f8515368edd0793079e46d36ef22740cdebb515f9b8565f124970"++ "facetsDigest": "sha256:212c25bf0eb71a0f4bbb29da485370b4011fd37e27187746f6f0e83799e4fd68",++ "closureDigest": "sha256:9904ffdd31df20cae6a638f7d2797c8f0af7f86194f928077158931bffbf1012"},{"specifier": "@narratage/speech-alignment",@@@ -351,8 -967,8 +967,8 @@@"name": "@narratage/speech-alignment","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3f48d736480bd0e1911a9195d9143ffb5c38a91bdcc55584845d6488cccc14f",- "closureDigest": "sha256:b1a33d3356007e8176506a74d13f71792e2aa30737510057870a25fce91120b7"- "facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",- "closureDigest": "sha256:0ae8008b1373a4a7383f34e2d81629a47c012ab7f397064436919072c3f39d54"++ "facetsDigest": "sha256:e921cb1351e86fe1bf072a0e9166cf5f5ee14c0ec5d59dacca08bfc5eb4ada65",++ "closureDigest": "sha256:36f92d5d9ff633c143206d5b09e2bee00e1d05eb5e0c652791d6d56eeabe2855"},{"specifier": "@narratage/speech-basis",@@@ -360,8 -976,8 +976,8 @@@"name": "@narratage/speech-basis","version": "0.0.0-dev"},- "facetsDigest": "sha256:9703845ab4a67b1a1fba98b276f5c913baec80748a08c0d63dc1b10caef8466f",- "closureDigest": "sha256:98ed38a0984bc88908a3c6c93fdb3fa0c157aa1c8bb1cfbb92ec2c935cf1d407"- "facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",- "closureDigest": "sha256:d7b8dbd8a162c49da9848c2d9f052c0d4a3786464041b9dec8c8f8d9c08cf8e8"++ "facetsDigest": "sha256:3f0fb57eddecbede68f9f56f96e47db0412f26ac444261ca90748550b483b79f",++ "closureDigest": "sha256:047fd7922dc29b5dba22c3aaa4e72d979f1c528be7ab9a9bf777787a5cb9c57d"},{"specifier": "@narratage/speech-evidence",@@@ -369,8 -985,8 +985,8 @@@"name": "@narratage/speech-evidence","version": "0.0.0-dev"},- "facetsDigest": "sha256:69110ba7b1740b0e609f6beef673fe4ef113ba5b0c803fb785ecf1dc9325f0a7",- "closureDigest": "sha256:aecda63214714d98f86022490f25eb3124851dcb4f2b86fdfe3f8f648511305d"- "facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",- "closureDigest": "sha256:e373b232b2ede34607c6f3cb591a8f6f08154f629061f78b0f573828db7d4ba0"++ "facetsDigest": "sha256:9980230b5a602f483267f5ab5fd0edafc54d67bdd6d8d2691eb489075505a72e",++ "closureDigest": "sha256:2e6610858ff681da612b5922c04cc7f4b489996e841177cbb8d1124cf9e0a409"},{"specifier": "@narratage/speech-spine",@@@ -378,8 -994,8 +994,8 @@@"name": "@narratage/speech-spine","version": "0.0.0-dev"},- "facetsDigest": "sha256:a4cdbee32b5752810b440adb83ba73a4261b4a61f5a750c6712a721f3265ad48",- "closureDigest": "sha256:ebe5a7e7e9738f05ff64bc11d3cee37eecbc6ab57895786e8fb3991bff5d72b6"- "facetsDigest": "sha256:4af25fdcd03b5dde7c6151419885646c6862978aa5c88fe3df66c7daec1b0199",- "closureDigest": "sha256:8bd3cecc005cb3fb83d4dbc67cbbe6dba2d1c786b82108f54ff9fa6ea21bda76"++ "facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",++ "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"},{"specifier": "@narratage/svs",@@@ -388,16 -1004,34 +1004,34 @@@"version": "0.0.0-dev"},"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",- "closureDigest": "sha256:19a883fb2968a038f29f4fb496922f25c3e0fcc48783cc886f6ee472a32b1d21"- "closureDigest": "sha256:6ee450114180d7f6f515b834a9cf1000795007b3ec8e57ba6860b30320fb2eba"++ "closureDigest": "sha256:68904cf8f1024e6d0d034592b7246a47346cde3aa5b1e5cc1009b3601e9d5465"+ },+ {+ "specifier": "@narratage/temporal",+ "package": {+ "name": "@narratage/temporal",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:2e9c4804f142e08e87b2e11af79aa17770109fb573e865397bed14ed7a4f1d0e",- "closureDigest": "sha256:a44823659b48d81219ce43c86a5d1c6c527da3382d30c5f72501bd0536557f91"++ "closureDigest": "sha256:889c7d995b72b77acd480c87e0d4572b3ad323456d527086d2f1d6b958caa132"+ },+ {+ "specifier": "@narratage/text",+ "package": {+ "name": "@narratage/text",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",- "closureDigest": "sha256:888a51aafa5225bee3cd589318f12e2974735ddea62e96d2bf8a098ad39b1389"++ "closureDigest": "sha256:3b287bedddfcb409e2809cc8383d881da4220a201d80cd287aacfc85b01cf9a4"},{- "specifier": "@narratage/text-track",+ "specifier": "@narratage/typography-track","package": {- "name": "@narratage/text-track",+ "name": "@narratage/typography-track","version": "0.0.0-dev"},- "facetsDigest": "sha256:9384a365dc85a38dcbd32fa316b9ecca1f226587494bb958a285d797f7babac6",- "closureDigest": "sha256:babbd16b76ec0bddeca470420c2f0b3556cdb93fa322e766b99e16c23a988dea"- "facetsDigest": "sha256:cc8349fec027f43e01a8832ba8a7050490e924851cee3325d3568cb5bc5fd57f",- "closureDigest": "sha256:1f945b0e7cc10f4de4520dfe0e444cda87aada5892b084966b5675c600078dac"++ "facetsDigest": "sha256:c48b80647a5026f671e34663e494635f0303e639142561984470cbb3e065e55f",++ "closureDigest": "sha256:96e7d161b701e5d598e57e12757c640533e4340764cb0c31089ac8cce59da77d"},{"specifier": "@narratage/visual-ir",@@@ -405,8 -1039,8 +1039,8 @@@"name": "@narratage/visual-ir","version": "0.0.0-dev"},- "facetsDigest": "sha256:a8d72579639a41123f5ac017e98781819012adc52d94a8116c5a072dc9e6fc05",- "closureDigest": "sha256:026709127336795d41295ad4d67d3fb13e7765e4ae4fc3689661d5b7991282c6"+ "facetsDigest": "sha256:8c577a635a48ee04441068df1f3dc2c18a602bff091fddca8883a3843ce4ce37",- "closureDigest": "sha256:a66c982075fe02c746a5802cc8c67b6e08481ae2fb159a0fa496510c5172c60c"++ "closureDigest": "sha256:6d001437aa17e2f5c6aab656cdb2b02830fea5db834c1397ae321cddf6da35da"},{"specifier": "@narratage/whisperx",@@@ -414,9 -1048,9 +1048,9 @@@"name": "@narratage/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:0eb8b7e5605851c873e0d37385577242a761e23d6eae9b0a495a2667ba71a082",- "closureDigest": "sha256:21bc9028708ff5e1f98d6bfcdc33c69238b4985baee9dcef24868c7759f6be45"- "facetsDigest": "sha256:73fceef213e8d6bcad92532c5d712842e62921743b81bc7bb4d9022a92067359",- "closureDigest": "sha256:6866f06f64152df2bf378c2788d187cfc1718a83e7471104342ef6818d5da5e7"++ "facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",++ "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"}],- "digest": "sha256:349c3da59cd80ebd267e578b032f76f12c7bfe136aefbcfd7ee7ce5fbb1bd5cf"- "digest": "sha256:7006af694856f3e7e10e2c5bc00d653fbe7f7702f6172ec292ccbe4de459293f"++ "digest": "sha256:a61026c5834c98ccb9860a45a679bc82408cd4f64d68332b8b7d67a61a60c2a4"}diff --cc examples/talking-film-live/svml.runtime-packages.lockindex 0ab0d939,8b71d264..bce286e1--- a/examples/talking-film-live/svml.runtime-packages.lock+++ b/examples/talking-film-live/svml.runtime-packages.lock@@@ -29,7 -29,12 +29,12 @@@{"name": "@narratage/artifact","version": "0.0.0-dev",- "digest": "sha256:b16107fdad5256905782fe28142cd19e77673f190691e839fd12d4f1f536ea0f"- "digest": "sha256:6e236d38a96432e6ef45532a2e28d01706eec216593243f1c8127c122d65dad9"++ "digest": "sha256:0821530c8f8bdede8095bbb2bdcc27c11c3e92a1cdfd126758d1d441999a9bad"+ },+ {+ "name": "@narratage/background-removal",+ "version": "0.0.0-dev",+ "digest": "sha256:a9d70daf4af81911b62cd38ce04cecc5c7f157ef0150b9236bfe9db8ad688954"},{"name": "@narratage/caption-gemini",@@@ -54,7 -59,7 +59,7 @@@{"name": "@narratage/core","version": "0.0.0-dev",- "digest": "sha256:b1fafa8715899f565a03794849045846b5cc08fd3f51a12d5f7374a9c66d8534"- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"++ "digest": "sha256:44e4bf3a81a43ef3104caca89648963e4d8f7c84dbc0bb75432b1787c4ee8f27"},{"name": "@narratage/elaborator",@@@ -79,7 -84,12 +84,12 @@@{"name": "@narratage/hyperframes","version": "0.0.0-dev",- "digest": "sha256:fa8536f53f6f9d84dbe587eba814d97299767a359a95fe76a437b257659c27f6"- "digest": "sha256:cbe9359d2a59fcde65e3b8d4fef43c9965b5e825b2d517fb25babad4c18ed512"++ "digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"+ },+ {+ "name": "@narratage/markup",+ "version": "0.0.0-dev",+ "digest": "sha256:d038863cedf4d22162dc0b390485131caf0977be11032861415a766d068e3745"},{"name": "@narratage/media-execution",@@@ -89,37 -99,37 +99,37 @@@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:4ceb5c9ef785e456f3807809b0384cbd40d463c4e5f1878375dcc8b017799922"- "digest": "sha256:27b943e3fd51adefaf329c84717dae9174b5126a745116f6cf5e9df372fd886e"++ "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"},{"name": "@narratage/media","version": "0.0.0-dev",- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"- "digest": "sha256:bec05028a561e1e9272756b47df52be20534c235e918df08a4f5f6c4a1db58f7"++ "digest": "sha256:b1d896926ad91ce34ccbd743a6b6785e0c21c90b1072b337421225e5f876a209"},{"name": "@narratage/narrative","version": "0.0.0-dev",- "digest": "sha256:85e98e61021310c2dd6473189dcbcc9daa54039277169cbb5ed51ed70277a894"- "digest": "sha256:c25b30b1881baa443ca91447f2529ac744feebe54eb2e4fbf3d2ba1d797a457d"++ "digest": "sha256:04a9e9aaf2005e9a12befea7a29d24ab0aa74fda87e4ff39eb149342c6f8a256"},{"name": "@narratage/program-space","version": "0.0.0-dev",- "digest": "sha256:3a321f064e7f763ae056662ed07bbe4b0fdf1b1628502891c4c73beb5a20edd6"- "digest": "sha256:7f5e69b2642332f7f901569609ac8840d0c8f52d5aa9ff9dad0d894d91895b28"++ "digest": "sha256:e7bbc857d07483aecce6d35fff1e91a51a6c785d13f3223607a91c3fe6e93b5f"},{"name": "@narratage/protocol","version": "0.0.0-dev",- "digest": "sha256:aba55408fd1ffec38c1ce2e81706aaadad48277a2fe4b9adc6323674e1b23ce6"- "digest": "sha256:b541192f2738fc10940592a6082fb1669967608cbd9b715296b9e5f576aedebd"++ "digest": "sha256:6774f0461a8a248b6f24aa9014738bca328e8aff9704175656ee04f255d8b083"},{"name": "@narratage/provider-google-vertex","version": "0.0.0-dev",- "digest": "sha256:04bf0234e5f3e2a28fb08c112b987e812568b8bbfd26748fbbc1ea082f1aeb65"- "digest": "sha256:dfccb8527a11fb609e66993e801d842185f1a5527670bc13b9f5bd3329bc0afb"++ "digest": "sha256:64e7d806f93eafc73312af93515d65d0f8116ec42c6167de671ccd0a5907d363"},{"name": "@narratage/provider-hyperframes-local","version": "0.0.0-dev",- "digest": "sha256:0281e943dbf30074f75ba4551c462ea634f8d14d7490a75bf60cc672aaceee91"- "digest": "sha256:879316b49c5299e506e39594f58713a45b849d73c2f2b8c67ad2faab786ce05a"++ "digest": "sha256:218adf5c62f11a4490b9a02a9cc1087f5eb2d493c3d99b16682cf70dbb2704f7"},{"name": "@narratage/provider-kie",@@@ -134,12 -144,12 +144,12 @@@{"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev",- "digest": "sha256:628e36f35f21bd7f3150e49f0eb023a95eb33614515e7caf2509331e3ee4437b"- "digest": "sha256:c2cc2b608cf1f76ebaff70bfdaf26e9638892143be76304aa0792b930eec04e5"++ "digest": "sha256:debcae78e6911a98bd3abf0ffaa6e22a5fe20cac0372eb28f0ac8fb8e24c5d65"},{"name": "@narratage/render-hyperframes","version": "0.0.0-dev",- "digest": "sha256:74ff1e25ed72fb22ab17068959373162c58dd9f0cc8a5c2a811615c02666cf23"- "digest": "sha256:28847756a67fc7a9c304d9ed358964e422956d86da6f53e3b7d2ebccdff54cad"++ "digest": "sha256:5f30fd4c9ce4de8984408d125498f58b06899011d6e07b43bea6ff3498490fe1"},{"name": "@narratage/runtime-adapter-node",@@@ -154,7 -164,7 +164,7 @@@{"name": "@narratage/runtime","version": "0.0.0-dev",- "digest": "sha256:234bc81f6651e2a291110e74d9ed68c866c35f2591f1f571c581ea7133ddcd0d"- "digest": "sha256:9d98c83147c511fc5604ddd19656d2d290a750de6a094d1f27169846df98dad4"++ "digest": "sha256:8e1e15aaed7ee09ac2aa51d9be0484706caae6481a4eaa1dc2e96bcc2d38be00"},{"name": "@narratage/semantic-map",@@@ -164,7 -174,12 +174,12 @@@{"name": "@narratage/source","version": "0.0.0-dev",- "digest": "sha256:8bbfa48c0fde45639578902c907d9190bd5bbb8a03bd59fca8fd364b820a3184"+ "digest": "sha256:cdf2bca700af10b30f2c29117ed7492fae82a434f4fd3e48747e8c51a7aab4c7"+ },+ {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev",- "digest": "sha256:4b41917023c9a9fc9b1e4a3a2c6d82fafeb3d732733c6e4ca6721ae2009edbdf"++ "digest": "sha256:651ab54204dba22f2815536bf0c03656b17dac8e01032c589f6be132d3921ed3"},{"name": "@narratage/speech-alignment",@@@ -174,7 -189,7 +189,7 @@@{"name": "@narratage/speech-evidence","version": "0.0.0-dev",- "digest": "sha256:a70759a336549bb4f622ff59b0259384d726211afa0cab5d0fcde89eef78fab1"- "digest": "sha256:9aee09fb21db5d3b4a1fd78113a2cb919bd14e2d621a888136ce4fa20faac05c"++ "digest": "sha256:c3b19b7647f203d6dc506b94d2a45203acbb29a66660da6f1771fd0af4910808"},{"name": "@narratage/speech",@@@ -189,7 -204,7 +204,7 @@@{"name": "@narratage/text","version": "0.0.0-dev",- "digest": "sha256:95d4d335bf4b4bad846a1dc2945bff0832083f7930726a8144159aa1c78a87d7"- "digest": "sha256:ec9b6917a6f9d52efa6f62a9f40c4d1e3ae85623b15bdc7dffa60f96c50a7b4b"++ "digest": "sha256:7062a1e07d011fcedd49655a7ddfcb9c8272bea1904b444146dc1da8fa939cd1"},{"name": "@narratage/validation",@@@ -199,12 -214,12 +214,12 @@@{"name": "@narratage/visual-ir","version": "0.0.0-dev",- "digest": "sha256:7a112d37e211797b680b2aa37382be47a65a6182e91fdcc93da50e684e50373c"- "digest": "sha256:89d7617f33873d68a3b56ef82f9410b8acd8fef5c4f0fc66b61c7a870595575f"++ "digest": "sha256:a42b9bcc204bf96f9416d786a06dd80c4a08d9a2c8b8d75f1956f8c03134e724"},{"name": "@narratage/whisperx","version": "0.0.0-dev",- "digest": "sha256:92683f7866c852eda0a71c8935a522bbc2579219ebde680b289eabb39f51f77a"- "digest": "sha256:7209d52d61e9c9237b59695a30f2f04a055d83053f06439ba9e9a31dd6cd189c"++ "digest": "sha256:7ee7f559fdc0508b6a7447838eb0a121cbe60c03522c6969638e0e8d3c04068f"},{"name": "@protobufjs/aspromise",@@@ -854,8 -869,8 +869,8 @@@"name": "@narratage/provider-google-vertex","version": "0.0.0-dev"},- "facetsDigest": "sha256:58eb269b382f90295525fbc3802ffe5792d730812e1d06fbd57f03cf907077bc",- "closureDigest": "sha256:6b87c3f1f221f0f63ea59cd731a91498921e120f56f2b71fb281f359a9961e74"+ "facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",- "closureDigest": "sha256:4f2f3ddd8072d04af19f9b3f2dcec5b4a9c909c1dc3fe4aa789b190992fea9ee"++ "closureDigest": "sha256:46c187a7b5c287e895e72d5016a8ce66abbba7d6d014e68332dfcea688446aad"},{"specifier": "@narratage/provider-hyperframes-local",@@@ -863,8 -878,8 +878,8 @@@"name": "@narratage/provider-hyperframes-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:d91d461c882da5517de5aaf6be0939755f38fc0341fe429c76a19aa2b0d547ad",- "closureDigest": "sha256:dbb7c7688eb5fb2bd8cb22720d829abe05c621ca6e7754fdd695684d389033a7"+ "facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:fa04cd3045315c2331c4466967c4e6e1c411bff578b6afd5e451dd6074f7940c"++ "closureDigest": "sha256:08c58ec73f6d4aa7bf210ab2fd53c904171fc9d8489e190c72a06cf687a1a128"},{"specifier": "@narratage/provider-kie",@@@ -872,8 -887,8 +887,8 @@@"name": "@narratage/provider-kie","version": "0.0.0-dev"},- "facetsDigest": "sha256:283e9fe0d14d4e9095760ca71cafff272278905a689ca27fd1dd8ceb0f5f70f2",- "closureDigest": "sha256:45b2b4dd8b204e87bf204b908cf9ebd993f5ec60f644d38d81d5915b3ad3a73f"+ "facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",- "closureDigest": "sha256:081710459182986ed07fc269457303e6063c21acf0ee418d1edb083ec82bb53a"++ "closureDigest": "sha256:51336290bc59dac73c36bbe38d4d6f2d4627a446c2cad081cea082f5be23e86a"},{"specifier": "@narratage/provider-media-local",@@@ -881,8 -896,8 +896,8 @@@"name": "@narratage/provider-media-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:bc6bf655a84f19a7ad4e033b9b851a1efaa3651ee4d2deeb52455225d7fc86df",- "closureDigest": "sha256:2e184bf93046b7147879d634e67278f70132f2bc2e8f57c05542d1b2f2dca680"+ "facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:bacffa564f65f413425b2bf895e4cb01dcd2266fa64e1836b7f7fd92d42af186"++ "closureDigest": "sha256:c1fa50524692077ce52f4f6800837fd5c022335bbd61d87163a41872060e8e52"},{"specifier": "@narratage/provider-whisperx-local",@@@ -890,9 -905,9 +905,9 @@@"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:731c3192863b5bfd661a5bec776f85965d3952f377daa9bc0c2cfe04018fd2ae",- "closureDigest": "sha256:a0aa80f41e65c3053ca6715c47f6451b95354105da5e3299eeadf73c7ff527b9"+ "facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:bd4ab81b2d7e24531824ff85c4a97013f08f34c95570dc674884026c0ce18018"++ "closureDigest": "sha256:e89dccda3bf1410e9ac0a39aa51831bd1423318b4e005093e0d35084949218b6"}],- "digest": "sha256:254afa2c992724a26cb2c0cdda86b4bbd3e8a3fa3b5fcfb19cebe3bcd1ebcfc4"- "digest": "sha256:9f01815de837f7af502b90eda6f7f37d3a48016671cb010cedb23892fbd4c5c6"++ "digest": "sha256:c66fb23f7c7c0906f4e99028600d2ba20394f446f579df4f69c6616e9bf2f289"}diff --cc examples/talking-head-aroll/svml.packages.lockindex 6f6d3dc4,cd643cf3..7d1542ad--- a/examples/talking-head-aroll/svml.packages.lock+++ b/examples/talking-head-aroll/svml.packages.lock@@@ -4,7 -549,12 +549,12 @@@{"name": "@narratage/artifact","version": "0.0.0-dev",- "digest": "sha256:b16107fdad5256905782fe28142cd19e77673f190691e839fd12d4f1f536ea0f"- "digest": "sha256:6e236d38a96432e6ef45532a2e28d01706eec216593243f1c8127c122d65dad9"++ "digest": "sha256:0821530c8f8bdede8095bbb2bdcc27c11c3e92a1cdfd126758d1d441999a9bad"+ },+ {+ "name": "@narratage/caption-fine",+ "version": "0.0.0-dev",+ "digest": "sha256:8094384ca1980ee72e0a5621a7ee9d62aec167521fdb536eb068eeeecee2ec9c"},{"name": "@narratage/caption-gemini",@@@ -29,7 -579,7 +579,7 @@@{"name": "@narratage/core","version": "0.0.0-dev",- "digest": "sha256:b1fafa8715899f565a03794849045846b5cc08fd3f51a12d5f7374a9c66d8534"- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"++ "digest": "sha256:44e4bf3a81a43ef3104caca89648963e4d8f7c84dbc0bb75432b1787c4ee8f27"},{"name": "@narratage/elaborator",@@@ -44,7 -594,12 +594,12 @@@{"name": "@narratage/film","version": "0.0.0-dev",- "digest": "sha256:c847365263d42a5136daeac728188dfabb00b9ad4dac669682022d33e7d8f997"- "digest": "sha256:cf696aea5fd093832875c12a7f22e5ee3dbc45679069a1d8644aed0c0309bd19"++ "digest": "sha256:95f89761b3bcadd3c4111244787e8ab4e8695d0980e6da69ea1a77ed9fee6ebe"+ },+ {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev",+ "digest": "sha256:14f53b6b08cfa1a24d0e62c80755e9e24891de9fec7285bfca449019fd0cf965"},{"name": "@narratage/generation",@@@ -59,7 -614,12 +614,12 @@@{"name": "@narratage/hyperframes","version": "0.0.0-dev",- "digest": "sha256:fa8536f53f6f9d84dbe587eba814d97299767a359a95fe76a437b257659c27f6"- "digest": "sha256:cbe9359d2a59fcde65e3b8d4fef43c9965b5e825b2d517fb25babad4c18ed512"++ "digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"+ },+ {+ "name": "@narratage/markup",+ "version": "0.0.0-dev",+ "digest": "sha256:d038863cedf4d22162dc0b390485131caf0977be11032861415a766d068e3745"},{"name": "@narratage/media-pipeline",@@@ -69,7 -634,7 +634,7 @@@{"name": "@narratage/media","version": "0.0.0-dev",- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"- "digest": "sha256:bec05028a561e1e9272756b47df52be20534c235e918df08a4f5f6c4a1db58f7"++ "digest": "sha256:b1d896926ad91ce34ccbd743a6b6785e0c21c90b1072b337421225e5f876a209"},{"name": "@narratage/model-kit",@@@ -84,17 -649,12 +649,12 @@@{"name": "@narratage/program-space","version": "0.0.0-dev",- "digest": "sha256:3a321f064e7f763ae056662ed07bbe4b0fdf1b1628502891c4c73beb5a20edd6"- },- {- "name": "@narratage/prompt-kit",- "version": "0.0.0-dev",- "digest": "sha256:2a8ef5fa05cfbde5feb4b1b525e74666874632fc4fd6531a7a54b0f5d2797342"- "digest": "sha256:7f5e69b2642332f7f901569609ac8840d0c8f52d5aa9ff9dad0d894d91895b28"++ "digest": "sha256:e7bbc857d07483aecce6d35fff1e91a51a6c785d13f3223607a91c3fe6e93b5f"},{"name": "@narratage/protocol","version": "0.0.0-dev",- "digest": "sha256:aba55408fd1ffec38c1ce2e81706aaadad48277a2fe4b9adc6323674e1b23ce6"- "digest": "sha256:b541192f2738fc10940592a6082fb1669967608cbd9b715296b9e5f576aedebd"++ "digest": "sha256:6774f0461a8a248b6f24aa9014738bca328e8aff9704175656ee04f255d8b083"},{"name": "@narratage/render-hyperframes",@@@ -134,7 -689,12 +689,12 @@@{"name": "@narratage/source","version": "0.0.0-dev",- "digest": "sha256:8bbfa48c0fde45639578902c907d9190bd5bbb8a03bd59fca8fd364b820a3184"+ "digest": "sha256:cdf2bca700af10b30f2c29117ed7492fae82a434f4fd3e48747e8c51a7aab4c7"+ },+ {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev",- "digest": "sha256:4b41917023c9a9fc9b1e4a3a2c6d82fafeb3d732733c6e4ca6721ae2009edbdf"++ "digest": "sha256:651ab54204dba22f2815536bf0c03656b17dac8e01032c589f6be132d3921ed3"},{"name": "@narratage/speech-alignment",@@@ -149,7 -709,7 +709,7 @@@{"name": "@narratage/speech-evidence","version": "0.0.0-dev",- "digest": "sha256:a70759a336549bb4f622ff59b0259384d726211afa0cab5d0fcde89eef78fab1"- "digest": "sha256:9aee09fb21db5d3b4a1fd78113a2cb919bd14e2d621a888136ce4fa20faac05c"++ "digest": "sha256:c3b19b7647f203d6dc506b94d2a45203acbb29a66660da6f1771fd0af4910808"},{"name": "@narratage/speech-spine",@@@ -164,7 -724,12 +724,12 @@@{"name": "@narratage/svs","version": "0.0.0-dev",- "digest": "sha256:8973ec01d5c9390da4e5a3f74c7e5af0a4bb49e15796e98e748b75ce62363d9d"+ "digest": "sha256:e44ae945c23e041602eb2f029a4c72b96fc2525e6c767e117e2bf0f11a830e0e"+ },+ {+ "name": "@narratage/temporal",+ "version": "0.0.0-dev",- "digest": "sha256:12d53493f58be066b213644f73a127d09d9242f2ccbc3f60eff5b3c2d1f25470"++ "digest": "sha256:b20cb315f5fc365a2e9994c63989a0cc1edc46b5843e06a337827d21d74068a1"},{"name": "@narratage/text",@@@ -179,7 -744,7 +744,7 @@@{"name": "@narratage/visual-ir","version": "0.0.0-dev",- "digest": "sha256:7a112d37e211797b680b2aa37382be47a65a6182e91fdcc93da50e684e50373c"- "digest": "sha256:89d7617f33873d68a3b56ef82f9410b8acd8fef5c4f0fc66b61c7a870595575f"++ "digest": "sha256:a42b9bcc204bf96f9416d786a06dd80c4a08d9a2c8b8d75f1956f8c03134e724"},{"name": "@narratage/whisperx",@@@ -194,8 -764,8 +764,8 @@@"name": "@narratage/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:cf6435732ab7b25c8d0c225042482d940344d5541fe37a4d9cbf905a0d0dad7a",- "closureDigest": "sha256:d4386b53042e584f162c2882bdc3b515c19f10a87b23c3e9634852fdad75c1ae"+ "facetsDigest": "sha256:72524ad8d5599450b4ab199680a6382c72c40cbf760f9c0265687f340aa60650",- "closureDigest": "sha256:1fef8a554b4163d5b414f7775df6f43a34cf5e786a142ca84da182e035c08107"++ "closureDigest": "sha256:d946eba0e895f2db33d4418ad9ba96bbf73eb21a66d870d1974b6c73494a886f"},{"specifier": "@narratage/caption",@@@ -203,8 -773,17 +773,17 @@@"name": "@narratage/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:86b692dc498c7d51fb87aab99ceb88464f2e3a86ac48a8abf64349dcc38fb7d0",- "closureDigest": "sha256:04e096f78374a1ac9dd53988a5356c06d4b59f1989fedb495c459cfc12df275b"- "facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",- "closureDigest": "sha256:529d7acaf8f115a20421887944acb5c9a55fa5096d9890f7fb311e0367ff4f3a"++ "facetsDigest": "sha256:6506137d8b76a283947b2ed6566cfd58562ef2a691cc05b665dd70484f6c2e2a",++ "closureDigest": "sha256:f03d80ca88bcc9eb68f72f4382451b7a889b1e2be086a93b3ce285e313bf1f8e"+ },+ {+ "specifier": "@narratage/caption-fine",+ "package": {+ "name": "@narratage/caption-fine",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",- "closureDigest": "sha256:a3cc02f32c347960e86e6ba1d9a9d5421c630a1f022c9344dcd0a1fdc41fbf21"++ "facetsDigest": "sha256:b196d99feded56f1ca6ae43414205ab6aa54ade2b22cb24e6d6feb166598a6f4",++ "closureDigest": "sha256:92bfc425dbdec98728a62278b0a2e460eaafecf1a1ebbf62619f002d9fc749d6"},{"specifier": "@narratage/caption-gemini",@@@ -212,8 -791,8 +791,8 @@@"name": "@narratage/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:bee8a4fce6b8213bd1ca1a94811cdcf261b71ecc39ecbf1593afa67f203b7cd5",- "closureDigest": "sha256:3764226d419778d413d503110fef77ee05f506c7c3ac61f18d341b8c038ad8bc"- "facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",- "closureDigest": "sha256:63e3530e59b9d6a2ba5d43484a4ebdb56d92dbc4b969327400cc11f72775e67a"++ "facetsDigest": "sha256:a1c673e347cee4543ab8949b8fae2e61248979db7851556114ec968756c72e60",++ "closureDigest": "sha256:1277a330bb685cca60066c794d9e86d7860c3ba2cf0a5c889b61c04b6946ea84"},{"specifier": "@narratage/composition",@@@ -221,8 -800,8 +800,8 @@@"name": "@narratage/composition","version": "0.0.0-dev"},- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",- "closureDigest": "sha256:ce5d73afa84939ee528d9095b711df49191e4695797e25ede03ccf2ae3ccf0b0"- "facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",- "closureDigest": "sha256:99ab833c7be2e6ce9591f5aebeef43cec6b327b126f2c174591af01cb56290a9"++ "facetsDigest": "sha256:855f4123e5ac2b40c32e621c0167e515588c33a9a2f9bbf327a1a57676327223",++ "closureDigest": "sha256:a968d73e961354a8c98fd72954540e47de4c1a55dcc0b1cd6d922f921f949ada"},{"specifier": "@narratage/estimate",@@@ -230,8 -809,8 +809,8 @@@"name": "@narratage/estimate","version": "0.0.0-dev"},- "facetsDigest": "sha256:b737a89381747c16afbc9cc026f268b83e8e6c02b707f85a44c28f66c8807eaa",- "closureDigest": "sha256:2159640d3162218483d6c5fddf5503fba86dd862570c8b11c6890ba799a775c3"- "facetsDigest": "sha256:9975815b3109520eb6bba276554a90767a9aebff6498c2768d9faf4763219bef",- "closureDigest": "sha256:eff306b2cca813d5664417770289b752038491b1ad6c93e38801c9411ff180c6"++ "facetsDigest": "sha256:430724962414edc2ce462168db5e55190da4845f2cfaddfaa9a1891b77dfa14a",++ "closureDigest": "sha256:366cba8d88f097f916531187d0e267c4340959eea7b916a86fd43d340187af38"},{"specifier": "@narratage/film",@@@ -239,8 -818,17 +818,17 @@@"name": "@narratage/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",- "closureDigest": "sha256:ff9630a80e02f73efdfc06b6eec8f76cd5d8feeaf0f4332d25512a4d637b3a35"- "facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",- "closureDigest": "sha256:cca6cb3b76b6e0744ee9ad00b666076e1db5098e39a8b844d432002019d2b75b"++ "facetsDigest": "sha256:6fd852de1476acf47779dd072d13a02a0e7e01469dee85d366a0152d7fb3c9a8",++ "closureDigest": "sha256:bd74ec8c440e8c450935884f672b5441c54732075c38cea750775a92314300e1"+ },+ {+ "specifier": "@narratage/fonts-open",+ "package": {+ "name": "@narratage/fonts-open",+ "version": "0.0.0-dev"+ },- "facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",- "closureDigest": "sha256:31d17d4d2f19841ed32f85ac7f9ffe6e77b45b2514cd4cd52a96a979cc848ba0"++ "facetsDigest": "sha256:c81fd5ff3f42020cf6800e77cbbeb6b3f187af135fc4af11c30a3573dd92306f",++ "closureDigest": "sha256:8e9bdf2a8b9d9abc6d66e7a4016ed8987432c0878bf1ff255abcfe6e1f036603"},{"specifier": "@narratage/generation",@@@ -248,8 -836,8 +836,8 @@@"name": "@narratage/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:c52730036a392448eb17cada1dd16b22be9ecb721ba47fb8d8a8633f74e4e039",- "closureDigest": "sha256:b3e11e3be1161e7ce0cf7bac7a2dbfc61fea637ee4fbbc6dcb7144ff060d9112"+ "facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",- "closureDigest": "sha256:9afb6284d3dad9ce1213e06afb011211b4b4e4b28a536252b0c5c1849412b78a"++ "closureDigest": "sha256:a2adfd7204c85a3b62711f1ca9693466392390eb6ab78d8bf2732905f834ba91"},{"specifier": "@narratage/hyperframes",@@@ -257,8 -845,8 +845,8 @@@"name": "@narratage/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:a85021fad5a6ad3ab248ddd51ce8473f7e90cee6f9da50c8ec124558e67d5971",- "closureDigest": "sha256:1f91f9acc75cf392150311c6952078c400b8c23f6425514412b4328d0ee60b09"- "facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",- "closureDigest": "sha256:0652bed735647218d6f25a1e5dd2be5341f9a387a7fa5b5748865058bae4cd55"++ "facetsDigest": "sha256:23f1883197740f2896dfa29a4ead467bfc1564b41634e0c14dd55a1d9c77bc17",++ "closureDigest": "sha256:d5bc78df0e42b3a7c2d63caf8cd80d50b375a973a41837a3510f555f6cd68913"},{"specifier": "@narratage/media",@@@ -266,8 -854,8 +854,8 @@@"name": "@narratage/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",- "closureDigest": "sha256:5fc9bfafba5249455364fc8b4ce60dd21fc861a0888ca21c7c8de33996481bf3"- "facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",- "closureDigest": "sha256:8e3cfeef1b2a0b0bab78e5ac27ac6bbe763ae0216c58d30fdd0688634efcda78"++ "facetsDigest": "sha256:a072c27c26f19f0fcaf7f423ee027c639571d369bca9bef48400a4a035616310",++ "closureDigest": "sha256:28a7c1fbb74bb456e2cad33ba62063762b5b6fc97cb54930e1568a473362ec2b"},{"specifier": "@narratage/media-pipeline",@@@ -275,8 -863,8 +863,8 @@@"name": "@narratage/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:783aeed74e2586b3f4cff5350a27d06de9cb9472a237dabc0d5c68680cca3546",- "closureDigest": "sha256:cc85343af360eca7440e3c700b86650eb080882be737df0aeb0ca9a4f7ab8106"- "facetsDigest": "sha256:976b989d377ddaeee207cdf64d76bac74ed3c95f6a6b00e4b9220f4aa2680c50",- "closureDigest": "sha256:db3b293ad595f268a833af091f960119dc966989f4f500b50b196996abb72fc9"++ "facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",++ "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"},{"specifier": "@narratage/narrative",@@@ -284,8 -872,8 +872,8 @@@"name": "@narratage/narrative","version": "0.0.0-dev"},- "facetsDigest": "sha256:849b7e49ef228b44d07ae57a106b18a24c7730c88783057bcdbad1e2e61153d3",- "closureDigest": "sha256:e8030a009c4904f38373be51c372d5fcf0947aff81ed07317fce62b1930904cb"+ "facetsDigest": "sha256:703db7ad343b00701dc39e3b316992dc371307f0c6c2ad15d1e0269257ffb326",- "closureDigest": "sha256:923877d78b1b2e9c3ae6a57990e8feebb31ef2b528a6b27de5a91c850998d362"++ "closureDigest": "sha256:112da177d39db502da452b13d7bf17d42c39bc9db4a20102e0078adf8f0ca277"},{"specifier": "@narratage/program-space",@@@ -293,17 -881,8 +881,8 @@@"name": "@narratage/program-space","version": "0.0.0-dev"},- "facetsDigest": "sha256:5fa9b120e8d37ca2edd478e3388c3dc4e398113e74c6589c6d25ef604a1d348a",- "closureDigest": "sha256:802f9ab8cf9bd284b8df0ef8ab78fc780339b175996d3626e5ba30f18f5349f1"- },- {- "specifier": "@narratage/prompt-kit",- "package": {- "name": "@narratage/prompt-kit",- "version": "0.0.0-dev"- },- "facetsDigest": "sha256:f04988c69c3b953fd02c4c791bf542bff61464c6aa593f49c71347cc03a422f9",- "closureDigest": "sha256:2e116ad7ccbc1cd52780fab61efa1de0c2d7d744a9c11f1379e418b6d328ca8b"- "facetsDigest": "sha256:b1e4eab41a135914556872f0f47a0c02b8ce76920366cbf86121b720af069052",- "closureDigest": "sha256:d108ad2d1d34a512288faa0dc43fc11cc451b9816ff51d6c19dd1e892dade92a"++ "facetsDigest": "sha256:45ebd22857f2d6817cb8e464ceeb37bea742e01e95edaaa3f3e6867621d2a3cb",++ "closureDigest": "sha256:b849886764e88c35396a5295ce20c265bb7ecfac979fd5b9b4a4d177145e2e49"},{"specifier": "@narratage/render-hyperframes",@@@ -311,17 -890,17 +890,17 @@@"name": "@narratage/render-hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:8fcb965f660a24bfbe2808f0e288d0afb316d772ec5d6f189530d3602a9f9186",- "closureDigest": "sha256:4c49f355407f2bd9824cb1d28ccda1628dc98b498e869bafe5c4d2ef5490385e"- "facetsDigest": "sha256:4210736adc699b3b5f86bf8b0cd84cd7a3c946754c8f19ceae5e0390a3d1d9c5",- "closureDigest": "sha256:396057461f2715ea0a2890418e237c35a51ccc379ead2cef85392cdfb54015dd"++ "facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",++ "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"},{- "specifier": "@narratage/run-text",+ "specifier": "@narratage/run-markup","package": {- "name": "@narratage/run-text",+ "name": "@narratage/run-markup","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbcab7cea86223fe00ea04b51c2160bb534aafbb99067f5877e6825b0ce4eefc",- "closureDigest": "sha256:de91d32eab3d3cfb7068f729dad5c41e1b6134f1360b799f3d8982d46ee34aa1"+ "facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"++ "closureDigest": "sha256:0f3f2c4da7f40e8ae0a6c82ae76df71e82524258ddeff474a141790beb779425"},{"specifier": "@narratage/script",@@@ -329,8 -908,8 +908,8 @@@"name": "@narratage/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:42d654cd2ce1e48b6a0edb036e4ef742ab59cd73abb2bb42f66ab522ae41e34e",- "closureDigest": "sha256:c29b5586b3a6a1d88a7805f828cd96548f6a1e787b2163dcbf46ee235646d4e4"+ "facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",- "closureDigest": "sha256:dfded35adc0aa0d163fba58d375fccc9a69b4ad1168744dc9c2826b9f914cd78"++ "closureDigest": "sha256:715402ed32dc6ee82909ba4e3e331df2200360003d85855af608228dc6d7723d"},{"specifier": "@narratage/seedance",@@@ -338,26 -917,26 +917,26 @@@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:25a6e78020082829e4ad5b41609f11b82933fb99d6fdb7958d392fa646eaa94b",- "closureDigest": "sha256:6887a5187321112b887630c45cc4ee1aca638de2fe0c5e9bba9f8b0dbb317f2d"- "facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",- "closureDigest": "sha256:29c64c13377e07b6fb100a57c66cda66a05cb671e2d45c663b9bd0c9c926ffac"++ "facetsDigest": "sha256:e9e09bc47e47706f9d5a6a69ba27df6f60aad62f27b131e0a98899ecdb1cad11",++ "closureDigest": "sha256:88e2b038cd1513a4cf3667c296621c4215efe2b9d5e754a22edf47e7b70eeab5"},{- "specifier": "@narratage/seedance-speaker",+ "specifier": "@narratage/semantic-map","package": {- "name": "@narratage/seedance-speaker",+ "name": "@narratage/semantic-map","version": "0.0.0-dev"},- "facetsDigest": "sha256:6d913b16f5ffd7c5cc4969c6ec78d5a1b87060ec4ec4fbd59df1dff12ec52b94",- "closureDigest": "sha256:52ee32e40b14180bc6ea1ae6a2186bdee2a782eb8816447b5a527eb1f56e75b6"- "facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",- "closureDigest": "sha256:548f991bc177fe8f99a09c1b25158f9e6e3575e9cc69b3b43717991b77f804e2"++ "facetsDigest": "sha256:6c4a27fc5cd63a59002f3cd433ae432b7129acb3a501a117fee1db19fb1900aa",++ "closureDigest": "sha256:b032e7e27224d005a1d1eb147b0bb0b73ce17a712919b6182d88f2ba715c4203"},{- "specifier": "@narratage/semantic-map",+ "specifier": "@narratage/spatial","package": {- "name": "@narratage/semantic-map",+ "name": "@narratage/spatial","version": "0.0.0-dev"},- "facetsDigest": "sha256:4f041c5844a3eb9a70e8472d4cf4f534de960a77745819366dac0061ec600e76",- "closureDigest": "sha256:5cb3e8f8cf64ab9bb3359541d0c8252fbf032daaf82602873680e576de7e7aa7"- "facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"++ "facetsDigest": "sha256:6cc59a18d8dda2312f3a315eb4d60a57163df1334e2ccd62641118c2304c06dc",++ "closureDigest": "sha256:28ab5737ee6d4af10593dd7d443ca56c68102b7482aecdf8fe915eeb2611e457"},{"specifier": "@narratage/speech",@@@ -365,8 -944,8 +944,8 @@@"name": "@narratage/speech","version": "0.0.0-dev"},- "facetsDigest": "sha256:fbecf0c9334b34c91f49c4edd9f2592d7b49856ec2d8a875dd272f47ade29a18",- "closureDigest": "sha256:dd94752413a319c64150b3a996e184adc1e4c16b02947e69cf1c63285b7a2fb4"- "facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",- "closureDigest": "sha256:4c39cb573f1f8515368edd0793079e46d36ef22740cdebb515f9b8565f124970"++ "facetsDigest": "sha256:212c25bf0eb71a0f4bbb29da485370b4011fd37e27187746f6f0e83799e4fd68",++ "closureDigest": "sha256:9904ffdd31df20cae6a638f7d2797c8f0af7f86194f928077158931bffbf1012"},{"specifier": "@narratage/speech-alignment",@@@ -374,8 -953,8 +953,8 @@@"name": "@narratage/speech-alignment","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3f48d736480bd0e1911a9195d9143ffb5c38a91bdcc55584845d6488cccc14f",- "closureDigest": "sha256:b1a33d3356007e8176506a74d13f71792e2aa30737510057870a25fce91120b7"- "facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",- "closureDigest": "sha256:0ae8008b1373a4a7383f34e2d81629a47c012ab7f397064436919072c3f39d54"++ "facetsDigest": "sha256:e921cb1351e86fe1bf072a0e9166cf5f5ee14c0ec5d59dacca08bfc5eb4ada65",++ "closureDigest": "sha256:36f92d5d9ff633c143206d5b09e2bee00e1d05eb5e0c652791d6d56eeabe2855"},{"specifier": "@narratage/speech-basis",@@@ -383,8 -962,8 +962,8 @@@"name": "@narratage/speech-basis","version": "0.0.0-dev"},- "facetsDigest": "sha256:9703845ab4a67b1a1fba98b276f5c913baec80748a08c0d63dc1b10caef8466f",- "closureDigest": "sha256:98ed38a0984bc88908a3c6c93fdb3fa0c157aa1c8bb1cfbb92ec2c935cf1d407"- "facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",- "closureDigest": "sha256:d7b8dbd8a162c49da9848c2d9f052c0d4a3786464041b9dec8c8f8d9c08cf8e8"++ "facetsDigest": "sha256:3f0fb57eddecbede68f9f56f96e47db0412f26ac444261ca90748550b483b79f",++ "closureDigest": "sha256:047fd7922dc29b5dba22c3aaa4e72d979f1c528be7ab9a9bf777787a5cb9c57d"},{"specifier": "@narratage/speech-evidence",@@@ -392,8 -971,8 +971,8 @@@"name": "@narratage/speech-evidence","version": "0.0.0-dev"},- "facetsDigest": "sha256:69110ba7b1740b0e609f6beef673fe4ef113ba5b0c803fb785ecf1dc9325f0a7",- "closureDigest": "sha256:aecda63214714d98f86022490f25eb3124851dcb4f2b86fdfe3f8f648511305d"- "facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",- "closureDigest": "sha256:e373b232b2ede34607c6f3cb591a8f6f08154f629061f78b0f573828db7d4ba0"++ "facetsDigest": "sha256:9980230b5a602f483267f5ab5fd0edafc54d67bdd6d8d2691eb489075505a72e",++ "closureDigest": "sha256:2e6610858ff681da612b5922c04cc7f4b489996e841177cbb8d1124cf9e0a409"},{"specifier": "@narratage/speech-spine",@@@ -401,8 -980,8 +980,8 @@@"name": "@narratage/speech-spine","version": "0.0.0-dev"},- "facetsDigest": "sha256:a4cdbee32b5752810b440adb83ba73a4261b4a61f5a750c6712a721f3265ad48",- "closureDigest": "sha256:ebe5a7e7e9738f05ff64bc11d3cee37eecbc6ab57895786e8fb3991bff5d72b6"- "facetsDigest": "sha256:4af25fdcd03b5dde7c6151419885646c6862978aa5c88fe3df66c7daec1b0199",- "closureDigest": "sha256:8bd3cecc005cb3fb83d4dbc67cbbe6dba2d1c786b82108f54ff9fa6ea21bda76"++ "facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",++ "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"},{"specifier": "@narratage/svs",@@@ -411,7 -990,16 +990,16 @@@"version": "0.0.0-dev"},"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",- "closureDigest": "sha256:19a883fb2968a038f29f4fb496922f25c3e0fcc48783cc886f6ee472a32b1d21"- "closureDigest": "sha256:6ee450114180d7f6f515b834a9cf1000795007b3ec8e57ba6860b30320fb2eba"++ "closureDigest": "sha256:68904cf8f1024e6d0d034592b7246a47346cde3aa5b1e5cc1009b3601e9d5465"+ },+ {+ "specifier": "@narratage/text",+ "package": {+ "name": "@narratage/text",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",- "closureDigest": "sha256:888a51aafa5225bee3cd589318f12e2974735ddea62e96d2bf8a098ad39b1389"++ "closureDigest": "sha256:3b287bedddfcb409e2809cc8383d881da4220a201d80cd287aacfc85b01cf9a4"},{"specifier": "@narratage/visual-ir",@@@ -419,8 -1007,8 +1007,8 @@@"name": "@narratage/visual-ir","version": "0.0.0-dev"},- "facetsDigest": "sha256:a8d72579639a41123f5ac017e98781819012adc52d94a8116c5a072dc9e6fc05",- "closureDigest": "sha256:026709127336795d41295ad4d67d3fb13e7765e4ae4fc3689661d5b7991282c6"+ "facetsDigest": "sha256:8c577a635a48ee04441068df1f3dc2c18a602bff091fddca8883a3843ce4ce37",- "closureDigest": "sha256:a66c982075fe02c746a5802cc8c67b6e08481ae2fb159a0fa496510c5172c60c"++ "closureDigest": "sha256:6d001437aa17e2f5c6aab656cdb2b02830fea5db834c1397ae321cddf6da35da"},{"specifier": "@narratage/whisperx",@@@ -428,9 -1016,9 +1016,9 @@@"name": "@narratage/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:0eb8b7e5605851c873e0d37385577242a761e23d6eae9b0a495a2667ba71a082",- "closureDigest": "sha256:21bc9028708ff5e1f98d6bfcdc33c69238b4985baee9dcef24868c7759f6be45"- "facetsDigest": "sha256:73fceef213e8d6bcad92532c5d712842e62921743b81bc7bb4d9022a92067359",- "closureDigest": "sha256:6866f06f64152df2bf378c2788d187cfc1718a83e7471104342ef6818d5da5e7"++ "facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",++ "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"}],- "digest": "sha256:07b9ff0a0ca973a52733fa3fdda48144b2867cff5ed7a736adcc30c3a377a88a"- "digest": "sha256:092bff04b86d49a97af233935b64275981add795d1c4ab55624a61ccf4be57c1"++ "digest": "sha256:fcba312519c09e7239cb25a1dc65627bb2cb7c83dca13640de79dfbd30b1eb71"}diff --cc examples/talking-head-aroll/svml.runtime-packages.lockindex 0ab0d939,8b71d264..bce286e1--- a/examples/talking-head-aroll/svml.runtime-packages.lock+++ b/examples/talking-head-aroll/svml.runtime-packages.lock@@@ -29,7 -29,12 +29,12 @@@{"name": "@narratage/artifact","version": "0.0.0-dev",- "digest": "sha256:b16107fdad5256905782fe28142cd19e77673f190691e839fd12d4f1f536ea0f"- "digest": "sha256:6e236d38a96432e6ef45532a2e28d01706eec216593243f1c8127c122d65dad9"++ "digest": "sha256:0821530c8f8bdede8095bbb2bdcc27c11c3e92a1cdfd126758d1d441999a9bad"+ },+ {+ "name": "@narratage/background-removal",+ "version": "0.0.0-dev",+ "digest": "sha256:a9d70daf4af81911b62cd38ce04cecc5c7f157ef0150b9236bfe9db8ad688954"},{"name": "@narratage/caption-gemini",@@@ -54,7 -59,7 +59,7 @@@{"name": "@narratage/core","version": "0.0.0-dev",- "digest": "sha256:b1fafa8715899f565a03794849045846b5cc08fd3f51a12d5f7374a9c66d8534"- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"++ "digest": "sha256:44e4bf3a81a43ef3104caca89648963e4d8f7c84dbc0bb75432b1787c4ee8f27"},{"name": "@narratage/elaborator",@@@ -79,7 -84,12 +84,12 @@@{"name": "@narratage/hyperframes","version": "0.0.0-dev",- "digest": "sha256:fa8536f53f6f9d84dbe587eba814d97299767a359a95fe76a437b257659c27f6"- "digest": "sha256:cbe9359d2a59fcde65e3b8d4fef43c9965b5e825b2d517fb25babad4c18ed512"++ "digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"+ },+ {+ "name": "@narratage/markup",+ "version": "0.0.0-dev",+ "digest": "sha256:d038863cedf4d22162dc0b390485131caf0977be11032861415a766d068e3745"},{"name": "@narratage/media-execution",@@@ -89,37 -99,37 +99,37 @@@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:4ceb5c9ef785e456f3807809b0384cbd40d463c4e5f1878375dcc8b017799922"- "digest": "sha256:27b943e3fd51adefaf329c84717dae9174b5126a745116f6cf5e9df372fd886e"++ "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"},{"name": "@narratage/media","version": "0.0.0-dev",- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"- "digest": "sha256:bec05028a561e1e9272756b47df52be20534c235e918df08a4f5f6c4a1db58f7"++ "digest": "sha256:b1d896926ad91ce34ccbd743a6b6785e0c21c90b1072b337421225e5f876a209"},{"name": "@narratage/narrative","version": "0.0.0-dev",- "digest": "sha256:85e98e61021310c2dd6473189dcbcc9daa54039277169cbb5ed51ed70277a894"- "digest": "sha256:c25b30b1881baa443ca91447f2529ac744feebe54eb2e4fbf3d2ba1d797a457d"++ "digest": "sha256:04a9e9aaf2005e9a12befea7a29d24ab0aa74fda87e4ff39eb149342c6f8a256"},{"name": "@narratage/program-space","version": "0.0.0-dev",- "digest": "sha256:3a321f064e7f763ae056662ed07bbe4b0fdf1b1628502891c4c73beb5a20edd6"- "digest": "sha256:7f5e69b2642332f7f901569609ac8840d0c8f52d5aa9ff9dad0d894d91895b28"++ "digest": "sha256:e7bbc857d07483aecce6d35fff1e91a51a6c785d13f3223607a91c3fe6e93b5f"},{"name": "@narratage/protocol","version": "0.0.0-dev",- "digest": "sha256:aba55408fd1ffec38c1ce2e81706aaadad48277a2fe4b9adc6323674e1b23ce6"- "digest": "sha256:b541192f2738fc10940592a6082fb1669967608cbd9b715296b9e5f576aedebd"++ "digest": "sha256:6774f0461a8a248b6f24aa9014738bca328e8aff9704175656ee04f255d8b083"},{"name": "@narratage/provider-google-vertex","version": "0.0.0-dev",- "digest": "sha256:04bf0234e5f3e2a28fb08c112b987e812568b8bbfd26748fbbc1ea082f1aeb65"- "digest": "sha256:dfccb8527a11fb609e66993e801d842185f1a5527670bc13b9f5bd3329bc0afb"++ "digest": "sha256:64e7d806f93eafc73312af93515d65d0f8116ec42c6167de671ccd0a5907d363"},{"name": "@narratage/provider-hyperframes-local","version": "0.0.0-dev",- "digest": "sha256:0281e943dbf30074f75ba4551c462ea634f8d14d7490a75bf60cc672aaceee91"- "digest": "sha256:879316b49c5299e506e39594f58713a45b849d73c2f2b8c67ad2faab786ce05a"++ "digest": "sha256:218adf5c62f11a4490b9a02a9cc1087f5eb2d493c3d99b16682cf70dbb2704f7"},{"name": "@narratage/provider-kie",@@@ -134,12 -144,12 +144,12 @@@{"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev",- "digest": "sha256:628e36f35f21bd7f3150e49f0eb023a95eb33614515e7caf2509331e3ee4437b"- "digest": "sha256:c2cc2b608cf1f76ebaff70bfdaf26e9638892143be76304aa0792b930eec04e5"++ "digest": "sha256:debcae78e6911a98bd3abf0ffaa6e22a5fe20cac0372eb28f0ac8fb8e24c5d65"},{"name": "@narratage/render-hyperframes","version": "0.0.0-dev",- "digest": "sha256:74ff1e25ed72fb22ab17068959373162c58dd9f0cc8a5c2a811615c02666cf23"- "digest": "sha256:28847756a67fc7a9c304d9ed358964e422956d86da6f53e3b7d2ebccdff54cad"++ "digest": "sha256:5f30fd4c9ce4de8984408d125498f58b06899011d6e07b43bea6ff3498490fe1"},{"name": "@narratage/runtime-adapter-node",@@@ -154,7 -164,7 +164,7 @@@{"name": "@narratage/runtime","version": "0.0.0-dev",- "digest": "sha256:234bc81f6651e2a291110e74d9ed68c866c35f2591f1f571c581ea7133ddcd0d"- "digest": "sha256:9d98c83147c511fc5604ddd19656d2d290a750de6a094d1f27169846df98dad4"++ "digest": "sha256:8e1e15aaed7ee09ac2aa51d9be0484706caae6481a4eaa1dc2e96bcc2d38be00"},{"name": "@narratage/semantic-map",@@@ -164,7 -174,12 +174,12 @@@{"name": "@narratage/source","version": "0.0.0-dev",- "digest": "sha256:8bbfa48c0fde45639578902c907d9190bd5bbb8a03bd59fca8fd364b820a3184"+ "digest": "sha256:cdf2bca700af10b30f2c29117ed7492fae82a434f4fd3e48747e8c51a7aab4c7"+ },+ {+ "name": "@narratage/spatial",+ "version": "0.0.0-dev",- "digest": "sha256:4b41917023c9a9fc9b1e4a3a2c6d82fafeb3d732733c6e4ca6721ae2009edbdf"++ "digest": "sha256:651ab54204dba22f2815536bf0c03656b17dac8e01032c589f6be132d3921ed3"},{"name": "@narratage/speech-alignment",@@@ -174,7 -189,7 +189,7 @@@{"name": "@narratage/speech-evidence","version": "0.0.0-dev",- "digest": "sha256:a70759a336549bb4f622ff59b0259384d726211afa0cab5d0fcde89eef78fab1"- "digest": "sha256:9aee09fb21db5d3b4a1fd78113a2cb919bd14e2d621a888136ce4fa20faac05c"++ "digest": "sha256:c3b19b7647f203d6dc506b94d2a45203acbb29a66660da6f1771fd0af4910808"},{"name": "@narratage/speech",@@@ -189,7 -204,7 +204,7 @@@{"name": "@narratage/text","version": "0.0.0-dev",- "digest": "sha256:95d4d335bf4b4bad846a1dc2945bff0832083f7930726a8144159aa1c78a87d7"- "digest": "sha256:ec9b6917a6f9d52efa6f62a9f40c4d1e3ae85623b15bdc7dffa60f96c50a7b4b"++ "digest": "sha256:7062a1e07d011fcedd49655a7ddfcb9c8272bea1904b444146dc1da8fa939cd1"},{"name": "@narratage/validation",@@@ -199,12 -214,12 +214,12 @@@{"name": "@narratage/visual-ir","version": "0.0.0-dev",- "digest": "sha256:7a112d37e211797b680b2aa37382be47a65a6182e91fdcc93da50e684e50373c"- "digest": "sha256:89d7617f33873d68a3b56ef82f9410b8acd8fef5c4f0fc66b61c7a870595575f"++ "digest": "sha256:a42b9bcc204bf96f9416d786a06dd80c4a08d9a2c8b8d75f1956f8c03134e724"},{"name": "@narratage/whisperx","version": "0.0.0-dev",- "digest": "sha256:92683f7866c852eda0a71c8935a522bbc2579219ebde680b289eabb39f51f77a"- "digest": "sha256:7209d52d61e9c9237b59695a30f2f04a055d83053f06439ba9e9a31dd6cd189c"++ "digest": "sha256:7ee7f559fdc0508b6a7447838eb0a121cbe60c03522c6969638e0e8d3c04068f"},{"name": "@protobufjs/aspromise",@@@ -854,8 -869,8 +869,8 @@@"name": "@narratage/provider-google-vertex","version": "0.0.0-dev"},- "facetsDigest": "sha256:58eb269b382f90295525fbc3802ffe5792d730812e1d06fbd57f03cf907077bc",- "closureDigest": "sha256:6b87c3f1f221f0f63ea59cd731a91498921e120f56f2b71fb281f359a9961e74"+ "facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",- "closureDigest": "sha256:4f2f3ddd8072d04af19f9b3f2dcec5b4a9c909c1dc3fe4aa789b190992fea9ee"++ "closureDigest": "sha256:46c187a7b5c287e895e72d5016a8ce66abbba7d6d014e68332dfcea688446aad"},{"specifier": "@narratage/provider-hyperframes-local",@@@ -863,8 -878,8 +878,8 @@@"name": "@narratage/provider-hyperframes-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:d91d461c882da5517de5aaf6be0939755f38fc0341fe429c76a19aa2b0d547ad",- "closureDigest": "sha256:dbb7c7688eb5fb2bd8cb22720d829abe05c621ca6e7754fdd695684d389033a7"+ "facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:fa04cd3045315c2331c4466967c4e6e1c411bff578b6afd5e451dd6074f7940c"++ "closureDigest": "sha256:08c58ec73f6d4aa7bf210ab2fd53c904171fc9d8489e190c72a06cf687a1a128"},{"specifier": "@narratage/provider-kie",@@@ -872,8 -887,8 +887,8 @@@"name": "@narratage/provider-kie","version": "0.0.0-dev"},- "facetsDigest": "sha256:283e9fe0d14d4e9095760ca71cafff272278905a689ca27fd1dd8ceb0f5f70f2",- "closureDigest": "sha256:45b2b4dd8b204e87bf204b908cf9ebd993f5ec60f644d38d81d5915b3ad3a73f"+ "facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",- "closureDigest": "sha256:081710459182986ed07fc269457303e6063c21acf0ee418d1edb083ec82bb53a"++ "closureDigest": "sha256:51336290bc59dac73c36bbe38d4d6f2d4627a446c2cad081cea082f5be23e86a"},{"specifier": "@narratage/provider-media-local",@@@ -881,8 -896,8 +896,8 @@@"name": "@narratage/provider-media-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:bc6bf655a84f19a7ad4e033b9b851a1efaa3651ee4d2deeb52455225d7fc86df",- "closureDigest": "sha256:2e184bf93046b7147879d634e67278f70132f2bc2e8f57c05542d1b2f2dca680"+ "facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:bacffa564f65f413425b2bf895e4cb01dcd2266fa64e1836b7f7fd92d42af186"++ "closureDigest": "sha256:c1fa50524692077ce52f4f6800837fd5c022335bbd61d87163a41872060e8e52"},{"specifier": "@narratage/provider-whisperx-local",@@@ -890,9 -905,9 +905,9 @@@"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev"},- "facetsDigest": "sha256:731c3192863b5bfd661a5bec776f85965d3952f377daa9bc0c2cfe04018fd2ae",- "closureDigest": "sha256:a0aa80f41e65c3053ca6715c47f6451b95354105da5e3299eeadf73c7ff527b9"+ "facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:bd4ab81b2d7e24531824ff85c4a97013f08f34c95570dc674884026c0ce18018"++ "closureDigest": "sha256:e89dccda3bf1410e9ac0a39aa51831bd1423318b4e005093e0d35084949218b6"}],- "digest": "sha256:254afa2c992724a26cb2c0cdda86b4bbd3e8a3fa3b5fcfb19cebe3bcd1ebcfc4"- "digest": "sha256:9f01815de837f7af502b90eda6f7f37d3a48016671cb010cedb23892fbd4c5c6"++ "digest": "sha256:c66fb23f7c7c0906f4e99028600d2ba20394f446f579df4f69c6616e9bf2f289"}diff --cc package.jsonindex 0a91cace,74184b0b..e5d79649--- a/package.json+++ b/package.json@@@ -3,9 -3,9 +3,10 @@@"version": "0.0.1","private": true,"type": "module",+ "packageManager": "[email protected]","scripts": {"check": "tsc -p tsconfig.json --noEmit",+ "postinstall": "node tools/postinstall-services.mjs","docs:dev": "vitepress dev docs","docs:build": "vitepress build docs","docs:preview": "vitepress preview docs",@@@ -35,11 -41,12 +43,13 @@@"@narratage/image-transform": "workspace:*","@narratage/local": "workspace:*","@narratage/media": "workspace:*",+ "@narratage/media-track": "workspace:*","@narratage/media-pipeline": "workspace:*",+ "@narratage/mimo-tts": "workspace:*","@narratage/narrative": "workspace:*","@narratage/program-space": "workspace:*",- "@narratage/prompt-kit": "workspace:*",+ "@narratage/protocol": "workspace:*",+ "@narratage/ranking": "workspace:*","@narratage/provider-google-vertex": "workspace:*","@narratage/provider-hyperframes-local": "workspace:*","@narratage/provider-image-opencv-local": "workspace:*",diff --cc packages/artifact/src/manifest.tsindex 00000000,00000000..2652e5f2new file mode 100644--- /dev/null+++ b/packages/artifact/src/manifest.ts@@@ -1,0 -1,0 +1,5 @@@++export {++ artifactDependency,++ artifactManifest,++ artifactManifestDigest,++} from "./index.js";diff --cc packages/driver-node/src/index.tsindex dc4c9d50,dc4c9d50..bf0396eb--- a/packages/driver-node/src/index.ts+++ b/packages/driver-node/src/index.ts@@@ -3,9 -3,9 +3,11 @@@ export { NodeDriver } from "./driver.jsexport {loadModuleManifest,loadResolvedClosure,++} from "./module-files.js";++export {parseModuleManifest,parseModuleManifestText,--} from "./manifest.js";++} from "@narratage/protocol";export { parseBuildState, serializeBuildState } from "./persistence.js";export {ProducerRegistry,diff --cc packages/driver-node/src/module-files.tsindex 37e3444d,37e3444d..a9859ba0--- a/packages/driver-node/src/module-files.ts+++ b/packages/driver-node/src/module-files.ts@@@ -1,14 -1,14 +1,9 @@@import { readFile } from "node:fs/promises";import { createResolvedClosure } from "@narratage/core";--import {-- parseModuleManifest,-- parseModuleManifestText,--} from "@narratage/protocol";++import { parseModuleManifestText } from "@narratage/protocol";import type { ModuleManifest, ResolvedModuleClosure } from "@narratage/protocol";--export { parseModuleManifest, parseModuleManifestText } from "@narratage/protocol";--export async function loadModuleManifest(path: string): Promise<ModuleManifest> {return parseModuleManifestText(await readFile(path, "utf8"));}diff --cc packages/film/src/index.tsindex 6a46a276,6d2adbe2..06f8d2a8--- a/packages/film/src/index.ts+++ b/packages/film/src/index.ts@@@ -21,15 -21,7 +21,15 @@@ exportcompileFilmCompositionImplementationDigest,createFilmTrackSet,createFilmTrackSetImplementationDigest,+ defaultFilmProgram,sealFilmProgram,} from "./program.js";+export {+ assertFilmRecipe,+ defaultFilmRecipe,- filmCanvasFromRecipe,++ filmAppearanceFromRecipe,+ filmRecipeKeys,+} from "./recipe.js";- export type { FilmCanvas } from "./recipe.js";++export type { FilmAppearance } from "./recipe.js";export { decodeFilmSurface } from "./surface.js";export type * from "./types.js";diff --cc packages/film/src/manifest.tsindex c182395b,8a46ea5c..fce50e78--- a/packages/film/src/manifest.ts+++ b/packages/film/src/manifest.ts@@@ -9,10 -10,9 +10,10 @@@ importappendFilmVisualTrackImplementationDigest,compileFilmCompositionImplementationDigest,createFilmTrackSetImplementationDigest,+ defaultFilmProgram,} from "./program.js";- export const filmModuleRef = { name: "@narratage/film", version: "0.0.0-dev" } as const;+ export const filmModuleRef = { name: "@narratage/film", version: "1" } as const;export const filmSurfaceImplementationDigest = digestOf("@narratage/film/surface@1");export const filmTypes = {program: { module: filmModuleRef, name: "FilmProgram" },diff --cc packages/film/src/program.tsindex cbb20ec7,e687c22b..ce8188c2--- a/packages/film/src/program.ts+++ b/packages/film/src/program.ts@@@ -37,23 -38,6 +38,15 @@@ function filmTrackSetContent(value: Fil};}- /**- * One vertical frame at 30, for anything that must choose a canvas before an- * author has declared a Film.- *- * The package that defines what a frame is decides what an undeclared one- * looks like. Anything else picking its own numbers would be a second, silent- * answer.- */++/** One neutral Film appearance for tools that need an editable starting value. */+export function defaultFilmProgram(id = "film"): FilmProgram {+ return sealFilmProgram({+ contract: "svml.film-program@1",+ id,- frameRate: { numerator: 30, denominator: 1 },- canvas: { width: 1080, height: 1920, clearColor: "#09090b" },++ clearColor: "#09090b",+ });+}+export function sealFilmProgram(value: FilmProgram): FilmProgram {return filmProgramContent(value);}diff --cc packages/film/src/recipe.tsindex d437d7d6,00000000..be1eaea7mode 100644,000000..100644--- a/packages/film/src/recipe.ts+++ b/packages/film/src/recipe.ts@@@ -1,57 -1,0 +1,31 @@@+import type { SvsRecipe } from "@narratage/svs";+- import type { FilmProgram } from "./types.js";-+/**- * The Film Recipe: what a stylesheet says about the frame itself.- *- * Not an appearance among others — a Film Recipe is where a canvas comes from,- * so anything that has to choose a frame size before compiling reads it here.++ * The Film Recipe owns Film appearance only. Canvas geometry and ProgramSpace++ * remain separate graph inputs and cannot be smuggled into a stylesheet.+ */+- export type FilmCanvas = {- readonly frameRate: FilmProgram["frameRate"];- readonly canvas: FilmProgram["canvas"];- };++export type FilmAppearance = { readonly clearColor: string };+- /** One vertical frame at 30. Its keys are the Recipe's required property set. */- export const defaultFilmRecipe: Readonly<Record<string, string | number>> = {++export const defaultFilmRecipe: Readonly<Record<string, string>> = {+ background: "#09090b",- "frame-rate": 30,- height: 1920,- width: 1080,+};++export const filmRecipeKeys: readonly string[] = Object.keys(defaultFilmRecipe);+- function number(properties: SvsRecipe["properties"], name: string): number {- const property = properties[name];- if (typeof property !== "number" || !Number.isFinite(property)) {- throw new Error(`Film Recipe ${name} must be a number`);- }- return property;- }-+export function assertFilmRecipe(properties: SvsRecipe["properties"]): void {+ const actual = Object.keys(properties).sort().join(" ");+ const expected = [...filmRecipeKeys].sort().join(" ");+ if (actual !== expected) {+ throw new Error(`Film Recipe requires exactly ${[...filmRecipeKeys].sort().join(", ")}`);+ }+}+- export function filmCanvasFromRecipe(properties: SvsRecipe["properties"]): FilmCanvas {++export function filmAppearanceFromRecipe(properties: SvsRecipe["properties"]): FilmAppearance {+ assertFilmRecipe(properties);+ const background = properties["background"];- if (typeof background !== "string" || !background.trim()) {- throw new Error("Film Recipe background must be a string");++ if (typeof background !== "string" || !/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(background)) {++ throw new Error("Film Recipe background must be a hexadecimal color");+ }- return {- frameRate: { numerator: number(properties, "frame-rate"), denominator: 1 },- canvas: {- width: number(properties, "width"),- height: number(properties, "height"),- clearColor: background.trim(),- },- };++ return { clearColor: background };+}diff --cc packages/film/src/surface.tsindex 75d067cc,359a98e4..c03161a2--- a/packages/film/src/surface.ts+++ b/packages/film/src/surface.ts@@@ -15,7 -16,6 +16,7 @@@ import typeimport { createFilmAssemblyFragment } from "./fragment.js";import { filmTypes } from "./manifest.js";import { sealFilmProgram } from "./program.js";- import { filmCanvasFromRecipe } from "./recipe.js";++import { filmAppearanceFromRecipe } from "./recipe.js";function localName(value: string): string {return value.includes(":") ? value.slice(value.lastIndexOf(":") + 1) : value;@@@ -72,22 -72,14 +73,6 @@@ function recipe(reference: SurfaceResolreturn value.value as SvsRecipe;}- function numberProperty(value: SvsRecipe, name: string): number {- const property = value.properties[name];- if (typeof property !== "number" || !Number.isSafeInteger(property) || property <= 0) {- throw new Error(`Film Recipe ${name} must be a positive integer`);- }- return property;- }---function colorProperty(value: SvsRecipe, name: string): string {-- const property = value.properties[name];-- if (typeof property !== "string" || !/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(property)) {-- throw new Error(`Film Recipe ${name} must be a six- or eight-digit hex color`);-- }-- return property;--}--function trackChildren(element: StructuredElement): StructuredElement[] {const tracks: StructuredElement[] = [];for (const child of element.children) {@@@ -117,13 -113,18 +106,15 @@@ export const decodeFilmSurface: Structuthrow new Error(`${element.name}.space must reference ProgramSpace`);}const appearanceReference = requiredReference(element, "appearance", resolveReference);-- const appearance = recipe(appearanceReference, `${element.name}.appearance`);- const expectedProperties = ["background"];- const actualProperties = Object.keys(appearance.properties).sort();- if (actualProperties.join("\u0000") !== expectedProperties.join("\u0000")) {- throw new Error(`Film Recipe requires exactly ${expectedProperties.join(", ")}`);- }++ const appearance = filmAppearanceFromRecipe(++ recipe(appearanceReference, `${element.name}.appearance`).properties,++ );const programId = `${id}.program`;const program = sealFilmProgram({contract: "svml.film-program@1",id,- ...filmCanvasFromRecipe(appearance.properties),- clearColor: colorProperty(appearance, "background"),++ clearColor: appearance.clearColor,});const tracks = trackChildren(element).map((child) => {diff --cc packages/gpt-image/src/manifest.tsindex 00000000,00000000..077af757new file mode 100644--- /dev/null+++ b/packages/gpt-image/src/manifest.ts@@@ -1,0 -1,0 +1,6 @@@++export {++ gptImageCleanManifest,++ gptImageCleanManifestDigest,++ gptImageManifest,++ gptImageManifestDigest,++} from "./index.js";diff --cc packages/hyperframes/package.jsonindex 73ad370d,73ad370d..277c2b87--- a/packages/hyperframes/package.json+++ b/packages/hyperframes/package.json@@@ -4,7 -4,7 +4,8 @@@"private": true,"type": "module","exports": {-- ".": "./src/index.ts"++ ".": "./src/index.ts",++ "./project": "./src/project.ts"},"svml": {"activation": "./src/activation.ts"diff --cc packages/hyperframes/src/index.tsindex 190ea9a8,f305d6df..a64beb0e--- a/packages/hyperframes/src/index.ts+++ b/packages/hyperframes/src/index.ts@@@ -19,5 -19,5 +19,3 @@@ exporthyperframesTypes,} from "./manifest.js";export type * from "./types.js";--export { stageHyperframesProject } from "./project.js";- export type { HyperframesArtifactReader } from "./project.js";-export type { HyperframesArtifactReader, HyperframesSurfaceValidator } from "./project.js";diff --cc packages/program-space/src/manifest.tsindex 00000000,00000000..20d68c73new file mode 100644--- /dev/null+++ b/packages/program-space/src/manifest.ts@@@ -1,0 -1,0 +1,5 @@@++export {++ programSpaceDependency,++ programSpaceManifest,++ programSpaceManifestDigest,++} from "./index.js";diff --cc packages/provider-hyperframes-aws-lambda/src/provider.tsindex 21de7add,fe127537..5f960484--- a/packages/provider-hyperframes-aws-lambda/src/provider.ts+++ b/packages/provider-hyperframes-aws-lambda/src/provider.ts@@@ -15,9 -15,9 +15,9 @@@ import type} from "@narratage/endpoint-kit";import {assertHyperframesDocument,-- stageHyperframesProject,} from "@narratage/hyperframes";import type { HyperframesDocument } from "@narratage/hyperframes";++import { stageHyperframesProject } from "@narratage/hyperframes/project";import {mediaTypes,sealRenderedVisual,diff --cc packages/provider-hyperframes-local/src/provider.tsindex 42959609,34c0e732..79c24025--- a/packages/provider-hyperframes-local/src/provider.ts+++ b/packages/provider-hyperframes-local/src/provider.ts@@@ -5,15 -7,16 +7,17 @@@ import { tmpdir } from "node:os"import { dirname, join } from "node:path";import { mediaTypes, sealRenderedVisual } from "@narratage/media";import type { RenderedVisual } from "@narratage/media";+ import { verifyCompositableSurfaceBytes } from "@narratage/media-execution";import type { EndpointInvocationContext, EndpointFulfillment } from "@narratage/endpoint-kit";--import { assertHyperframesDocument, stageHyperframesProject } from "@narratage/hyperframes";++import { assertHyperframesDocument } from "@narratage/hyperframes";import type { HyperframesDocument } from "@narratage/hyperframes";++import { stageHyperframesProject } from "@narratage/hyperframes/project";import { renderHyperframesCapabilities } from "@narratage/render-hyperframes";import { canonicalize, digestOf } from "@narratage/protocol";- import type { BlobRef, CanonicalValue } from "@narratage/protocol";+ import type { BlobRef, CanonicalValue, Digest } from "@narratage/protocol";import { defineEndpointPackage } from "@narratage/endpoint-kit";- const HYPERFRAMES_VERSION = "0.7.84";+ const HYPERFRAMES_VERSION = "0.7.101";export const localHyperframesProviderModuleRef = {name: "@narratage/provider-hyperframes-local",diff --cc packages/screen-overlay/src/index.tsindex 00000000,e7a8a70e..8b7c05eamode 000000,100644..100644--- a/packages/screen-overlay/src/index.ts+++ b/packages/screen-overlay/src/index.ts@@@ -1,0 -1,17 +1,17 @@@+ export { screenOverlayComponent } from "./component.js";+ export { createScreenOverlayFragment, programScreenOverlayFragment } from "./fragment.js";+ export type { ScreenOverlayFragmentItem } from "./fragment.js";+ export {+ screenOverlayDependency, screenOverlayHeaderSchema, screenOverlayItemSpecSchema, screenOverlayManifest,+ screenOverlayManifestDigest, screenOverlayModuleRef, screenOverlayProducers, screenOverlayProgramSchema,+ screenOverlaySetSchema, screenOverlaySurfaceImplementationDigest, screenOverlayTypes,+ } from "./manifest.js";+ export {+ appendMomentScreenOverlay, appendProgramScreenOverlay, appendSelectionScreenOverlay,+ assertScreenOverlayComponent, assertScreenOverlayHeader, assertScreenOverlayItemSpec,+ assertScreenOverlayProgram, assertScreenOverlaySet, createScreenOverlaySet, finalizeScreenOverlay,- renderScreenOverlay, screenOverlayImplementationDigests, screenOverlayValidatorDigests,++ defaultScreenOverlayProgram, renderScreenOverlay, screenOverlayImplementationDigests, screenOverlayValidatorDigests,+ sealScreenOverlayHeader, sealScreenOverlayItemSpec, sealScreenOverlayProgram,+ } from "./program.js";+ export { decodeScreenOverlaySurface } from "./surface.js";+ export type * from "./types.js";diff --cc packages/screen-overlay/src/manifest.tsindex 00000000,254306fe..0f115219mode 000000,100644..100644--- a/packages/screen-overlay/src/manifest.ts+++ b/packages/screen-overlay/src/manifest.ts@@@ -1,0 -1,98 +1,98 @@@+ import { compositionDependency, compositionTypes } from "@narratage/composition";+ import { narrativeDependency, narrativeTypes } from "@narratage/narrative";+ import { programSpaceDependency, programSpaceTypes } from "@narratage/program-space";+ import { digestOf } from "@narratage/protocol";+ import type { ModuleManifest, ProducerRef, TypeRef, ValueSchema } from "@narratage/protocol";+ import { semanticMapDependency, semanticMapTypes } from "@narratage/semantic-map";+ import { spatialDependency, spatialTypes } from "@narratage/spatial";+ import { temporalDependency } from "@narratage/temporal";+-import { screenOverlayImplementationDigests, screenOverlayValidatorDigests } from "./program.js";++import { defaultScreenOverlayProgram, screenOverlayImplementationDigests, screenOverlayValidatorDigests } from "./program.js";++ export const screenOverlayModuleRef = { name: "@narratage/screen-overlay", version: "1" } as const;+ export const screenOverlayTypes = {+ header: { module: screenOverlayModuleRef, name: "ScreenOverlayHeader" },+ itemSpec: { module: screenOverlayModuleRef, name: "ScreenOverlayItemSpec" },+ set: { module: screenOverlayModuleRef, name: "ScreenOverlaySet" },+ program: { module: screenOverlayModuleRef, name: "ScreenOverlayProgram" },+ } satisfies Record<string, TypeRef>;+ export const screenOverlayProducers = {+ createSet: { module: screenOverlayModuleRef, name: "create-screen-overlay-set" },+ appendProgram: { module: screenOverlayModuleRef, name: "append-program-screen-overlay" },+ appendSelection: { module: screenOverlayModuleRef, name: "append-selection-screen-overlay" },+ appendMoment: { module: screenOverlayModuleRef, name: "append-moment-screen-overlay" },+ finalize: { module: screenOverlayModuleRef, name: "finalize-screen-overlay" },+ render: { module: screenOverlayModuleRef, name: "render-screen-overlay" },+ } satisfies Record<string, ProducerRef>;++ const string = { kind: "string", minLength: 1 } as const;+ const number = { kind: "number" } as const;+ const nonNegative = { kind: "number", minimum: 0 } as const;+ const integer = { kind: "number", integer: true } as const;+ const unsignedInteger = { kind: "number", integer: true, minimum: 0 } as const;+ const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({ kind: "object", fields });+ const pointDuration: ValueSchema = { kind: "oneOf", variants: [+ object({ unit: { schema: { kind: "literal", value: "frames" } }, value: { schema: integer } }),+ object({ unit: { schema: { kind: "literal", value: "milliseconds" } }, value: { schema: integer } }),+ object({ unit: { schema: { kind: "literal", value: "seconds" } }, numerator: { schema: integer }, denominator: { schema: { kind: "number", integer: true, minimum: 1 } } }),+ ] };+ const point: ValueSchema = { kind: "oneOf", variants: [+ ...["program.start", "program.end", "selection.start", "selection.end", "moment.cue"].map((ref) => object({ ref: { schema: { kind: "literal", value: ref } }, offset: { schema: pointDuration, optional: true } })),+ object({ ref: { schema: { kind: "literal", value: "absolute" } }, at: { schema: pointDuration } }),+ ] };+ const projection = object({ start: { schema: point }, end: { schema: point } });+ const normalizedPoint = object({ x: { schema: number }, y: { schema: number } });+ const colorArray: ValueSchema = { kind: "array", minItems: 1, items: string };+ const component: ValueSchema = { kind: "oneOf", variants: [+ object({ kind: { schema: { kind: "literal", value: "flash" } }, color: { schema: string }, intensity: { schema: nonNegative }, attackFrames: { schema: unsignedInteger }, holdFrames: { schema: unsignedInteger }, decayFrames: { schema: unsignedInteger } }),+ object({ kind: { schema: { kind: "literal", value: "color-wash" } }, color: { schema: string }, opacity: { schema: nonNegative } }),+ object({ kind: { schema: { kind: "literal", value: "vignette" } }, center: { schema: normalizedPoint }, radius: { schema: normalizedPoint }, softness: { schema: nonNegative }, color: { schema: string }, opacity: { schema: nonNegative } }),+ object({ kind: { schema: { kind: "literal", value: "scan-lines" } }, spacingPx: { schema: nonNegative }, thicknessPx: { schema: nonNegative }, angleDeg: { schema: number }, opacity: { schema: nonNegative }, travelPx: { schema: number } }),+ object({ kind: { schema: { kind: "literal", value: "directional-matte" } }, angleDeg: { schema: number }, coverage: { schema: nonNegative }, feather: { schema: nonNegative }, color: { schema: string }, opacity: { schema: nonNegative }, progress: { schema: object({ from: { schema: number }, to: { schema: number } }) } }),+ object({ kind: { schema: { kind: "literal", value: "whip-veil" } }, direction: { schema: { kind: "string", enum: ["left", "right", "up", "down"] } }, widthPx: { schema: nonNegative }, softnessPx: { schema: nonNegative }, travelPx: { schema: nonNegative }, opacity: { schema: nonNegative } }),+ object({ kind: { schema: { kind: "literal", value: "glitch-veil" } }, bars: { schema: unsignedInteger }, colors: { schema: colorArray }, opacity: { schema: nonNegative }, travelPx: { schema: number }, seed: { schema: unsignedInteger } }),+ object({ kind: { schema: { kind: "literal", value: "grain" } }, amount: { schema: nonNegative }, grainSizePx: { schema: nonNegative }, chroma: { schema: { kind: "string", enum: ["monochrome", "color"] } }, motionRatePxPerFrame: { schema: number }, seed: { schema: unsignedInteger } }),+ object({ kind: { schema: { kind: "literal", value: "light-leak" } }, colors: { schema: colorArray }, angleDeg: { schema: number }, softness: { schema: nonNegative }, travelPx: { schema: number }, intensity: { schema: nonNegative }, seed: { schema: unsignedInteger } }),+ object({ kind: { schema: { kind: "literal", value: "bokeh" } }, amount: { schema: nonNegative }, sizeMinPx: { schema: nonNegative }, sizeMaxPx: { schema: nonNegative }, color: { schema: string }, warmth: { schema: number }, driftPx: { schema: number }, seed: { schema: unsignedInteger } }),+ object({ kind: { schema: { kind: "literal", value: "tv-static" } }, amount: { schema: nonNegative }, noiseSizePx: { schema: nonNegative }, scanLineOpacity: { schema: nonNegative }, motionRatePxPerFrame: { schema: number }, seed: { schema: unsignedInteger } }),+ ] };+ const itemSpec = object({+ contract: { schema: { kind: "literal", value: "svml.screen-overlay-item-spec@1" } }, id: { schema: string },+ content: { schema: component }, projection: { schema: projection },+ expansion: { schema: object({ kind: { schema: { kind: "string", enum: ["one", "each"] } } }) },+ stackingOrder: { schema: integer },+ });+ const frameSpan = object({ startFrame: { schema: unsignedInteger }, endFrameExclusive: { schema: unsignedInteger } });+ const item = object({+ id: { schema: string }, sourceOccurrenceId: { schema: string }, span: { schema: frameSpan }, content: { schema: component },+ stacking: { schema: object({ order: { schema: integer }, tieBreak: { schema: string } }) },+ });+ export const screenOverlayHeaderSchema: ValueSchema = object({ contract: { schema: { kind: "literal", value: "svml.screen-overlay-header@1" } }, id: { schema: string } });+ export const screenOverlayItemSpecSchema: ValueSchema = itemSpec;+ export const screenOverlaySetSchema: ValueSchema = object({ contract: { schema: { kind: "literal", value: "svml.screen-overlay-set@1" } }, items: { schema: { kind: "array", items: item } } });+ export const screenOverlayProgramSchema: ValueSchema = object({ contract: { schema: { kind: "literal", value: "svml.screen-overlay-program@1" } }, id: { schema: string }, items: { schema: { kind: "array", minItems: 1, items: item } } });+ export const screenOverlaySurfaceImplementationDigest = digestOf("@narratage/screen-overlay/track-surface@1");+ const validator = (locator: string, digest: ReturnType<typeof digestOf>) => ({ abi: "svml.type-validator@1" as const, implementation: { kind: "registered" as const, locator, digest } });+ const appendInputs = [{ name: "set", type: screenOverlayTypes.set }, { name: "header", type: screenOverlayTypes.header }, { name: "space", type: programSpaceTypes.programSpace }, { name: "spec", type: screenOverlayTypes.itemSpec }] as const;++ export const screenOverlayManifest: ModuleManifest = {+ format: "svml.module@1", name: screenOverlayModuleRef.name, version: screenOverlayModuleRef.version,+ dependencies: [narrativeDependency, semanticMapDependency, programSpaceDependency, spatialDependency, temporalDependency, compositionDependency],+ types: [+ { name: screenOverlayTypes.header.name, schema: screenOverlayHeaderSchema },+ { name: screenOverlayTypes.itemSpec.name, schema: screenOverlayItemSpecSchema },+ { name: screenOverlayTypes.set.name, schema: screenOverlaySetSchema },- { name: screenOverlayTypes.program.name, schema: screenOverlayProgramSchema, validator: validator("@narratage/screen-overlay/validate-program", screenOverlayValidatorDigests.program) },++ { name: screenOverlayTypes.program.name, schema: screenOverlayProgramSchema, default: defaultScreenOverlayProgram(), validator: validator("@narratage/screen-overlay/validate-program", screenOverlayValidatorDigests.program) },+ ], capabilities: [],+ surfaces: [{ name: "track", tag: "Track", mode: "structured", outputs: [screenOverlayTypes.header, screenOverlayTypes.itemSpec, screenOverlayTypes.program, compositionTypes.visualTrack], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/screen-overlay/track-surface", digest: screenOverlaySurfaceImplementationDigest } }],+ producers: [+ { name: screenOverlayProducers.createSet.name, inputs: [], outputs: [{ name: "set", type: screenOverlayTypes.set }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/create-set", digest: screenOverlayImplementationDigests.createSet } },+ { name: screenOverlayProducers.appendProgram.name, inputs: [...appendInputs], outputs: [{ name: "set", type: screenOverlayTypes.set }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/append-program", digest: screenOverlayImplementationDigests.appendProgram } },+ { name: screenOverlayProducers.appendSelection.name, inputs: [...appendInputs, { name: "map", type: semanticMapTypes.complete }, { name: "selection", type: narrativeTypes.selection }], outputs: [{ name: "set", type: screenOverlayTypes.set }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/append-selection", digest: screenOverlayImplementationDigests.appendSelection } },+ { name: screenOverlayProducers.appendMoment.name, inputs: [...appendInputs, { name: "map", type: semanticMapTypes.complete }, { name: "moment", type: narrativeTypes.moment }], outputs: [{ name: "set", type: screenOverlayTypes.set }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/append-moment", digest: screenOverlayImplementationDigests.appendMoment } },+ { name: screenOverlayProducers.finalize.name, inputs: [{ name: "set", type: screenOverlayTypes.set }, { name: "header", type: screenOverlayTypes.header }], outputs: [{ name: "program", type: screenOverlayTypes.program }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/finalize", digest: screenOverlayImplementationDigests.finalize } },+ { name: screenOverlayProducers.render.name, inputs: [{ name: "canvas", type: spatialTypes.canvas }, { name: "space", type: programSpaceTypes.programSpace }, { name: "program", type: screenOverlayTypes.program }], outputs: [{ name: "track", type: compositionTypes.visualTrack }], needs: [], implementation: { kind: "registered", locator: "@narratage/screen-overlay/render", digest: screenOverlayImplementationDigests.render } },+ ],+ };+ export const screenOverlayManifestDigest = digestOf(screenOverlayManifest);+ export const screenOverlayDependency = { module: screenOverlayModuleRef, digest: screenOverlayManifestDigest } as const;diff --cc packages/screen-overlay/src/program.tsindex 00000000,1bf4f56d..7aec170fmode 000000,100644..100644--- a/packages/screen-overlay/src/program.ts+++ b/packages/screen-overlay/src/program.ts@@@ -1,0 -1,333 +1,348 @@@+ import { assertVisualTrackIdentity, sealVisualTrack } from "@narratage/composition";+ import type { VisualAnimation, VisualElement, VisualStyleDeclaration, VisualTrack } from "@narratage/composition";+ import type { NarrativeMomentRef, NarrativeSelectionRef } from "@narratage/narrative";+ import { assertProgramSpaceIdentity } from "@narratage/program-space";+ import type { ProgramSpace } from "@narratage/program-space";+ import { canonicalize, digestOf } from "@narratage/protocol";+ import type { CompleteSemanticMap } from "@narratage/semantic-map";+ import { assertCanvasSpace } from "@narratage/spatial";+ import type { CanvasSpace } from "@narratage/spatial";+ import { projectMomentWindows, projectProgramWindow, projectSelectionWindows } from "@narratage/temporal";+ import type { ProjectedOccurrence } from "@narratage/temporal";++ import type {+ ScreenOverlayComponent,+ ScreenOverlayHeader,+ ScreenOverlayItemProgram,+ ScreenOverlayItemSpec,+ ScreenOverlayProgram,+ ScreenOverlaySet,+ } from "./types.js";++ export const screenOverlayImplementationDigests = {+ createSet: digestOf("@narratage/screen-overlay/create-set@1"),+ appendProgram: digestOf("@narratage/screen-overlay/append-program@1"),+ appendSelection: digestOf("@narratage/screen-overlay/append-selection@1"),+ appendMoment: digestOf("@narratage/screen-overlay/append-moment@1"),+ finalize: digestOf("@narratage/screen-overlay/finalize@1"),+ render: digestOf("@narratage/screen-overlay/render@1"),+ } as const;+ export const screenOverlayValidatorDigests = { program: digestOf("@narratage/screen-overlay/validate-program@1") } as const;+++/** A one-frame, self-contained overlay that gives visual tools an honest starting value. */++export function defaultScreenOverlayProgram(): ScreenOverlayProgram {++ return sealScreenOverlayProgram({++ contract: "svml.screen-overlay-program@1",++ id: "overlay-preview",++ items: [{++ id: "overlay-preview:1",++ sourceOccurrenceId: "preview",++ span: { startFrame: 0, endFrameExclusive: 1 },++ content: { kind: "color-wash", color: "#6c5ce7", opacity: 0.35 },++ stacking: { order: 100, tieBreak: "overlay-preview" },++ }],++ });++}+++ function assert(condition: unknown, message: string): asserts condition { if (!condition) throw new Error(message); }+ function identity(value: string, label: string): void {+ assert(/^[A-Za-z][A-Za-z0-9_.:#-]{0,191}$/u.test(value), `${label} is invalid.`);+ }+ function finite(value: number, label: string): void { assert(Number.isFinite(value), `${label} is invalid.`); }+ function range(value: number, minimum: number, maximum: number, label: string): void {+ finite(value, label); assert(value >= minimum && value <= maximum, `${label} is outside ${minimum}..${maximum}.`);+ }+ function positive(value: number, label: string): void { finite(value, label); assert(value > 0, `${label} must be positive.`); }+ function nonNegativeInteger(value: number, label: string): void {+ assert(Number.isSafeInteger(value) && value >= 0, `${label} must be a non-negative integer.`);+ }+ function color(value: string, label: string): void {+ assert(/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(value), `${label} must be a hexadecimal color.`);+ }+ function colors(values: readonly string[], label: string): void {+ assert(values.length > 0, `${label} requires at least one color.`);+ values.forEach((value, index) => color(value, `${label}.${index + 1}`));+ }++ export function assertScreenOverlayComponent(value: ScreenOverlayComponent): void {+ switch (value.kind) {+ case "flash":+ color(value.color, "Flash color"); range(value.intensity, 0, 1, "Flash intensity");+ nonNegativeInteger(value.attackFrames, "Flash attack"); nonNegativeInteger(value.holdFrames, "Flash hold");+ nonNegativeInteger(value.decayFrames, "Flash decay"); return;+ case "color-wash": color(value.color, "ColorWash color"); range(value.opacity, 0, 1, "ColorWash opacity"); return;+ case "vignette":+ range(value.center.x, 0, 1, "Vignette center.x"); range(value.center.y, 0, 1, "Vignette center.y");+ positive(value.radius.x, "Vignette radius.x"); positive(value.radius.y, "Vignette radius.y");+ range(value.softness, 0, 1, "Vignette softness"); color(value.color, "Vignette color");+ range(value.opacity, 0, 1, "Vignette opacity"); return;+ case "scan-lines":+ positive(value.spacingPx, "ScanLines spacing"); positive(value.thicknessPx, "ScanLines thickness");+ assert(value.thicknessPx <= value.spacingPx, "ScanLines thickness exceeds spacing.");+ finite(value.angleDeg, "ScanLines angle"); range(value.opacity, 0, 1, "ScanLines opacity");+ finite(value.travelPx, "ScanLines travel"); return;+ case "directional-matte":+ finite(value.angleDeg, "DirectionalMatte angle"); range(value.coverage, 0, 1, "DirectionalMatte coverage");+ range(value.feather, 0, 1, "DirectionalMatte feather"); color(value.color, "DirectionalMatte color");+ range(value.opacity, 0, 1, "DirectionalMatte opacity"); range(value.progress.from, -1, 2, "DirectionalMatte progress.from");+ range(value.progress.to, -1, 2, "DirectionalMatte progress.to"); return;+ case "whip-veil":+ assert(["left", "right", "up", "down"].includes(value.direction), "WhipVeil direction is invalid.");+ positive(value.widthPx, "WhipVeil width"); assert(Number.isFinite(value.softnessPx) && value.softnessPx >= 0, "WhipVeil softness is invalid.");+ positive(value.travelPx, "WhipVeil travel"); range(value.opacity, 0, 1, "WhipVeil opacity"); return;+ case "glitch-veil":+ assert(Number.isSafeInteger(value.bars) && value.bars > 0 && value.bars <= 256, "GlitchVeil bars are invalid.");+ colors(value.colors, "GlitchVeil colors"); range(value.opacity, 0, 1, "GlitchVeil opacity");+ finite(value.travelPx, "GlitchVeil travel"); nonNegativeInteger(value.seed, "GlitchVeil seed"); return;+ case "grain":+ range(value.amount, 0, 1, "Grain amount"); positive(value.grainSizePx, "Grain size");+ assert(value.chroma === "monochrome" || value.chroma === "color", "Grain chroma is invalid.");+ finite(value.motionRatePxPerFrame, "Grain motion rate"); nonNegativeInteger(value.seed, "Grain seed"); return;+ case "light-leak":+ colors(value.colors, "LightLeak colors"); finite(value.angleDeg, "LightLeak angle");+ range(value.softness, 0, 1, "LightLeak softness"); finite(value.travelPx, "LightLeak travel");+ range(value.intensity, 0, 1, "LightLeak intensity"); nonNegativeInteger(value.seed, "LightLeak seed"); return;+ case "bokeh":+ range(value.amount, 0, 1, "Bokeh amount"); positive(value.sizeMinPx, "Bokeh minimum size");+ assert(Number.isFinite(value.sizeMaxPx) && value.sizeMaxPx >= value.sizeMinPx, "Bokeh size range is invalid.");+ color(value.color, "Bokeh color"); range(value.warmth, -1, 1, "Bokeh warmth"); finite(value.driftPx, "Bokeh drift");+ nonNegativeInteger(value.seed, "Bokeh seed"); return;+ case "tv-static":+ range(value.amount, 0, 1, "TVStatic amount"); positive(value.noiseSizePx, "TVStatic noise size");+ range(value.scanLineOpacity, 0, 1, "TVStatic scan-line opacity");+ finite(value.motionRatePxPerFrame, "TVStatic motion rate"); nonNegativeInteger(value.seed, "TVStatic seed"); return;+ }+ throw new Error("Screen Overlay component kind is unsupported.");+ }++ export function sealScreenOverlayHeader(value: ScreenOverlayHeader): ScreenOverlayHeader {+ assertScreenOverlayHeader(value); return canonicalize(value) as unknown as ScreenOverlayHeader;+ }+ export function assertScreenOverlayHeader(value: ScreenOverlayHeader): void {+ assert(value.contract === "svml.screen-overlay-header@1", "Unsupported ScreenOverlayHeader contract."); identity(value.id, "ScreenOverlayHeader.id");+ }+ export function sealScreenOverlayItemSpec(value: ScreenOverlayItemSpec): ScreenOverlayItemSpec {+ assertScreenOverlayItemSpec(value); return canonicalize(value) as unknown as ScreenOverlayItemSpec;+ }+ export function assertScreenOverlayItemSpec(value: ScreenOverlayItemSpec): void {+ assert(value.contract === "svml.screen-overlay-item-spec@1", "Unsupported ScreenOverlayItemSpec contract.");+ identity(value.id, "ScreenOverlayItemSpec.id"); assertScreenOverlayComponent(value.content);+ assert(value.expansion.kind === "one" || value.expansion.kind === "each", "ScreenOverlay expansion is invalid.");+ assert(Number.isSafeInteger(value.stackingOrder), "ScreenOverlay stacking order must be an integer.");+ }+ export function createScreenOverlaySet(): ScreenOverlaySet { return { contract: "svml.screen-overlay-set@1", items: [] }; }+ export function assertScreenOverlaySet(value: ScreenOverlaySet): void {+ assert(value.contract === "svml.screen-overlay-set@1" && Array.isArray(value.items), "ScreenOverlaySet is invalid.");+ }++ function realized(+ set: ScreenOverlaySet, header: ScreenOverlayHeader, spec: ScreenOverlayItemSpec,+ occurrences: readonly ProjectedOccurrence[],+ ): ScreenOverlaySet {+ assertScreenOverlaySet(set); assertScreenOverlayHeader(header); assertScreenOverlayItemSpec(spec);+ const additions = occurrences.map((occurrence, index) => ({+ id: occurrence.id,+ sourceOccurrenceId: occurrence.sourceOccurrenceId,+ span: { ...occurrence.span },+ content: structuredClone(spec.content),+ stacking: { order: spec.stackingOrder, tieBreak: `${header.id}:${spec.id}:${index + 1}` },+ } satisfies ScreenOverlayItemProgram));+ const ids = new Set(set.items.map((item) => item.id));+ additions.forEach((item) => { assert(!ids.has(item.id), `Screen Overlay already contains Item ${item.id}.`); ids.add(item.id); });+ return { contract: "svml.screen-overlay-set@1", items: [...set.items, ...additions] };+ }+ export function appendProgramScreenOverlay(set: ScreenOverlaySet, header: ScreenOverlayHeader, space: ProgramSpace, spec: ScreenOverlayItemSpec): ScreenOverlaySet {+ assert(spec.expansion.kind === "one", `Program Overlay ${spec.id} must use one occurrence.`);+ return realized(set, header, spec, [projectProgramWindow({ itemId: spec.id, space, projection: spec.projection })]);+ }+ export function appendSelectionScreenOverlay(set: ScreenOverlaySet, header: ScreenOverlayHeader, space: ProgramSpace, map: CompleteSemanticMap, selection: NarrativeSelectionRef, spec: ScreenOverlayItemSpec): ScreenOverlaySet {+ return realized(set, header, spec, projectSelectionWindows({ itemId: spec.id, map, selection, space, expansion: spec.expansion, projection: spec.projection }));+ }+ export function appendMomentScreenOverlay(set: ScreenOverlaySet, header: ScreenOverlayHeader, space: ProgramSpace, map: CompleteSemanticMap, moment: NarrativeMomentRef, spec: ScreenOverlayItemSpec): ScreenOverlaySet {+ return realized(set, header, spec, projectMomentWindows({ itemId: spec.id, map, moment, space, expansion: spec.expansion, projection: spec.projection }));+ }+ export function sealScreenOverlayProgram(value: ScreenOverlayProgram): ScreenOverlayProgram {+ const normalized = { contract: "svml.screen-overlay-program@1" as const, id: value.id,+ items: [...value.items].map((item) => structuredClone(item)).sort((a, b) => a.id.localeCompare(b.id)) };+ assertScreenOverlayProgram(normalized); return canonicalize(normalized) as unknown as ScreenOverlayProgram;+ }+ export function finalizeScreenOverlay(set: ScreenOverlaySet, header: ScreenOverlayHeader): ScreenOverlayProgram {+ assertScreenOverlaySet(set); assertScreenOverlayHeader(header); assert(set.items.length > 0, "Screen Overlay requires at least one Item.");+ return sealScreenOverlayProgram({ contract: "svml.screen-overlay-program@1", id: header.id, items: set.items });+ }+ export function assertScreenOverlayProgram(value: ScreenOverlayProgram): void {+ assert(value.contract === "svml.screen-overlay-program@1", "Unsupported ScreenOverlayProgram contract.");+ identity(value.id, "ScreenOverlayProgram.id"); assert(value.items.length > 0, "ScreenOverlayProgram requires Items.");+ const ids = new Set<string>();+ for (const item of value.items) {+ identity(item.id, "ScreenOverlayItemProgram.id"); assert(!ids.has(item.id), `Duplicate Screen Overlay Item ${item.id}.`); ids.add(item.id);+ assert(item.sourceOccurrenceId.length > 0 && item.span.startFrame >= 0 && item.span.endFrameExclusive > item.span.startFrame,+ `Screen Overlay Item ${item.id} timing is invalid.`);+ assertScreenOverlayComponent(item.content); assert(Number.isSafeInteger(item.stacking.order) && item.stacking.tieBreak.length > 0,+ `Screen Overlay Item ${item.id} stacking is invalid.`);+ }+ }++ type Random = () => number;+ function random(seed: number): Random {+ let state = seed >>> 0;+ return () => {+ state += 0x6d2b79f5;+ let value = state;+ value = Math.imul(value ^ value >>> 15, value | 1);+ value ^= value + Math.imul(value ^ value >>> 7, value | 61);+ return ((value ^ value >>> 14) >>> 0) / 4_294_967_296;+ };+ }+ function px(value: number): string { return `${Number(value.toFixed(6))}px`; }+ function percent(value: number): string { return `${Number((value * 100).toFixed(6))}%`; }+ function rootStyle(): VisualStyleDeclaration[] { return [+ { name: "inset", value: "0" }, { name: "overflow", value: "hidden" }, { name: "position", value: "absolute" },+ ]; }+ function fullChild(+ id: string,+ style: readonly VisualStyleDeclaration[],+ animation?: VisualAnimation,+ order = 1,+ ): VisualElement {+ const names = new Set(style.map((item) => item.name));+ return { id, parent: "root", order, kind: "box", style: [+ ...(names.has("inset") ? [] : [{ name: "inset", value: "0" }]),+ ...(names.has("position") ? [] : [{ name: "position", value: "absolute" }]),+ ...style,+ ], ...(animation === undefined ? {} : { animation }) };+ }+ function animation(duration: number, start: readonly VisualStyleDeclaration[], end: readonly VisualStyleDeclaration[]): VisualAnimation {+ return { keyframes: [{ atFrame: 0, style: start }, { atFrame: duration, style: end }] };+ }+ function flashElements(content: Extract<ScreenOverlayComponent, { kind: "flash" }>, duration: number): readonly VisualElement[] {+ const total = content.attackFrames + content.holdFrames + content.decayFrames;+ if (total === 0) return [{ id: "root", order: 0, kind: "box", style: [...rootStyle(), { name: "background-color", value: content.color }, { name: "opacity", value: content.intensity }] }];+ const marks = new Map<number, number>();+ marks.set(0, content.attackFrames === 0 ? content.intensity : 0);+ marks.set(content.attackFrames, content.intensity);+ marks.set(content.attackFrames + content.holdFrames, content.intensity);+ marks.set(total, 0);+ marks.set(duration, 0);+ return [{ id: "root", order: 0, kind: "box", style: [...rootStyle(), { name: "background-color", value: content.color }],+ animation: { keyframes: [...marks].sort(([a], [b]) => a - b).map(([atFrame, opacity]) => ({ atFrame, style: [{ name: "opacity", value: opacity }] })) } }];+ }++ function overlayElements(content: ScreenOverlayComponent, canvas: CanvasSpace, duration: number): readonly VisualElement[] {+ if (content.kind === "flash") return flashElements(content, duration);+ const root: VisualElement = { id: "root", order: 0, kind: "box", style: rootStyle() };+ switch (content.kind) {+ case "color-wash": return [root, fullChild("wash", [{ name: "background-color", value: content.color }, { name: "opacity", value: content.opacity }])];+ case "vignette": {+ const inner = Math.max(0, 1 - content.softness) * 100;+ return [root, fullChild("vignette", [{ name: "background-image", value: `radial-gradient(ellipse ${percent(content.radius.x)} ${percent(content.radius.y)} at ${percent(content.center.x)} ${percent(content.center.y)},transparent ${inner}%,${content.color} 100%)` }, { name: "opacity", value: content.opacity }])];+ }+ case "scan-lines": {+ const travel = `translate3d(${px(content.travelPx * Math.cos(content.angleDeg * Math.PI / 180))},${px(content.travelPx * Math.sin(content.angleDeg * Math.PI / 180))},0)`;+ return [root, fullChild("scan-lines", [+ { name: "background-image", value: `repeating-linear-gradient(${content.angleDeg}deg,#ffffff 0 ${px(content.thicknessPx)},transparent ${px(content.thicknessPx)} ${px(content.spacingPx)})` },+ { name: "inset", value: "-20%" }, { name: "opacity", value: content.opacity },+ ], animation(duration, [{ name: "transform", value: "translate3d(0px,0px,0)" }], [{ name: "transform", value: travel }]))];+ }+ case "directional-matte": {+ const extent = Math.hypot(canvas.widthPx, canvas.heightPx) * 2;+ const move = (progress: number) => `rotate(${content.angleDeg}deg) translate3d(${px((progress - 0.5) * extent)},0px,0)`;+ const edge = Math.max(0.001, content.feather) * 100;+ return [root, fullChild("matte", [+ { name: "background-image", value: `linear-gradient(90deg,${content.color} 0 ${100 - edge}%,transparent 100%)` },+ { name: "height", value: "200%" }, { name: "left", value: "-50%" }, { name: "opacity", value: content.opacity },+ { name: "top", value: "-50%" }, { name: "width", value: `${200 * content.coverage}%` },+ ], animation(duration, [{ name: "transform", value: move(content.progress.from) }], [{ name: "transform", value: move(content.progress.to) }]))];+ }+ case "whip-veil": {+ const horizontal = content.direction === "left" || content.direction === "right";+ const sign = content.direction === "left" || content.direction === "up" ? -1 : 1;+ const gradient = horizontal ? "90deg" : "180deg";+ const transform = (distance: number) => horizontal ? `translate3d(${px(distance)},0px,0)` : `translate3d(0px,${px(distance)},0)`;+ return [root, fullChild("veil", [+ { name: "background-image", value: `linear-gradient(${gradient},transparent 0,#ffffff ${px(content.softnessPx)},#ffffff calc(100% - ${px(content.softnessPx)}),transparent 100%)` },+ { name: "height", value: horizontal ? "100%" : px(content.widthPx) }, { name: "opacity", value: content.opacity },+ { name: "width", value: horizontal ? px(content.widthPx) : "100%" },+ ], animation(duration, [{ name: "transform", value: transform(-sign * content.travelPx) }], [{ name: "transform", value: transform(sign * content.travelPx) }]))];+ }+ case "glitch-veil": {+ const rng = random(content.seed);+ return [root, ...Array.from({ length: content.bars }, (_, index): VisualElement => {+ const height = 1 + rng() * 12;+ const y = rng() * 100;+ const x = (rng() - 0.5) * 20;+ const colorValue = content.colors[index % content.colors.length]!;+ return { id: `bar-${index + 1}`, parent: "root", order: index + 1, kind: "box", style: [+ { name: "background-color", value: colorValue }, { name: "height", value: percent(height / 100) },+ { name: "left", value: percent(x / 100) }, { name: "opacity", value: content.opacity * (0.35 + rng() * 0.65) },+ { name: "position", value: "absolute" }, { name: "top", value: percent(y / 100) }, { name: "width", value: "120%" },+ ], animation: animation(duration, [{ name: "transform", value: "translate3d(0px,0px,0)" }], [{ name: "transform", value: `translate3d(${px(content.travelPx * (rng() < 0.5 ? -1 : 1))},0px,0)` }]) };+ })];+ }+ case "grain": {+ const rng = random(content.seed); const count = Math.max(1, Math.round(content.amount * 160));+ return [root, ...Array.from({ length: count }, (_, index): VisualElement => {+ const hue = content.chroma === "color" ? Math.round(rng() * 360) : 0;+ const shade = Math.round(rng() * 255);+ const background = content.chroma === "color" ? `hsl(${hue} 85% 60%)` : `rgb(${shade} ${shade} ${shade})`;+ const drift = content.motionRatePxPerFrame * duration * (rng() < 0.5 ? -1 : 1);+ return { id: `grain-${index + 1}`, parent: "root", order: index + 1, kind: "box", style: [+ { name: "background-color", value: background }, { name: "height", value: px(content.grainSizePx) },+ { name: "left", value: percent(rng()) }, { name: "opacity", value: 0.08 + content.amount * 0.42 },+ { name: "position", value: "absolute" }, { name: "top", value: percent(rng()) }, { name: "width", value: px(content.grainSizePx) },+ ], animation: animation(duration, [{ name: "transform", value: "translate3d(0px,0px,0)" }], [{ name: "transform", value: `translate3d(${px(drift)},${px(-drift)},0)` }]) };+ })];+ }+ case "light-leak": {+ const rng = random(content.seed); const offset = (rng() - 0.5) * 30;+ const stops = content.colors.map((entry, index) => `${entry} ${Number(index * 100 / Math.max(1, content.colors.length - 1)).toFixed(3)}%`).join(",");+ return [root, fullChild("light-leak", [+ { name: "background-image", value: `linear-gradient(${content.angleDeg + offset}deg,transparent 0,${stops},transparent 100%)` },+ { name: "filter", value: `blur(${px(content.softness * 80)})` }, { name: "inset", value: "-20%" },+ { name: "opacity", value: content.intensity },+ ], animation(duration, [{ name: "transform", value: `translate3d(${px(-content.travelPx)},0px,0)` }], [{ name: "transform", value: `translate3d(${px(content.travelPx)},0px,0)` }]))];+ }+ case "bokeh": {+ const rng = random(content.seed); const count = Math.max(1, Math.round(content.amount * 48));+ return [root, ...Array.from({ length: count }, (_, index): VisualElement => {+ const size = content.sizeMinPx + rng() * (content.sizeMaxPx - content.sizeMinPx);+ const warmthFilter = content.warmth === 0 ? "" : `sepia(${Math.abs(content.warmth)}) hue-rotate(${content.warmth < 0 ? 180 : 0}deg) `;+ return { id: `bokeh-${index + 1}`, parent: "root", order: index + 1, kind: "box", style: [+ { name: "background-color", value: content.color }, { name: "border-radius", value: "50%" },+ { name: "filter", value: `${warmthFilter}blur(${px(size * 0.08)})` }, { name: "height", value: px(size) },+ { name: "left", value: percent(rng()) }, { name: "opacity", value: 0.08 + rng() * 0.32 },+ { name: "position", value: "absolute" }, { name: "top", value: percent(rng()) }, { name: "width", value: px(size) },+ ], animation: animation(duration, [{ name: "transform", value: "translate3d(0px,0px,0)" }], [{ name: "transform", value: `translate3d(${px((rng() - 0.5) * content.driftPx)},${px((rng() - 0.5) * content.driftPx)},0)` }]) };+ })];+ }+ case "tv-static": {+ const rng = random(content.seed); const columns = Math.ceil(canvas.widthPx / content.noiseSizePx);+ const rows = Math.ceil(canvas.heightPx / content.noiseSizePx); const count = Math.min(512, Math.max(1, Math.round(columns * rows * content.amount)));+ const cells = Array.from({ length: count }, (_, index): VisualElement => {+ const shade = Math.round(rng() * 255); const drift = content.motionRatePxPerFrame * duration;+ return { id: `static-${index + 1}`, parent: "root", order: index + 1, kind: "box", style: [+ { name: "background-color", value: `rgb(${shade} ${shade} ${shade})` }, { name: "height", value: px(content.noiseSizePx) },+ { name: "left", value: percent(rng()) }, { name: "opacity", value: 0.2 + content.amount * 0.6 },+ { name: "position", value: "absolute" }, { name: "top", value: percent(rng()) }, { name: "width", value: px(content.noiseSizePx) },+ ], animation: animation(duration, [{ name: "transform", value: "translate3d(0px,0px,0)" }], [{ name: "transform", value: `translate3d(0px,${px(drift * (rng() < 0.5 ? -1 : 1))},0)` }]) };+ });+ return [root, ...cells, fullChild("static-scan-lines", [+ { name: "background-image", value: "repeating-linear-gradient(180deg,transparent 0 3px,#000000 3px 4px)" },+ { name: "opacity", value: content.scanLineOpacity },+ ], undefined, cells.length + 1)];+ }+ }+ }++ export function renderScreenOverlay(canvas: CanvasSpace, space: ProgramSpace, program: ScreenOverlayProgram): VisualTrack {+ assertCanvasSpace(canvas); assertProgramSpaceIdentity(space); assertScreenOverlayProgram(program);+ const track = sealVisualTrack({+ contract: "svml.visual-track@1", visualIr: "svml.visual-ir@1", id: program.id,+ presents: program.items.map((item) => ({+ id: item.id, span: { ...item.span }, stacking: { ...item.stacking },+ elements: overlayElements(item.content, canvas, item.span.endFrameExclusive - item.span.startFrame),+ })),+ });+ assertVisualTrackIdentity(track, space);+ return track;+ }diff --cc packages/spatial/src/geometry.tsindex 00000000,b9e71bfe..3cea7d1dmode 000000,100644..100644--- a/packages/spatial/src/geometry.ts+++ b/packages/spatial/src/geometry.ts@@@ -1,0 -1,248 +1,261 @@@+ import { digestOf } from "@narratage/protocol";++ import type {+ AnchoredFrameProgram,+ AspectFrameProgram,+ CanvasSpace,+ ContentFit,+ FittedContent,+ FrameEdgesProgram,+ IntrinsicExtent,+ SpatialAnchor,+ SpatialFrame,+ SpatialLength,+ SpatialPath,+ SpatialPoint,+ } from "./types.js";++ export const spatialImplementationDigests = {+ canvasFrame: digestOf("@narratage/spatial/canvas-frame@1"),+ frameEdges: digestOf("@narratage/spatial/frame-edges@1"),+ anchoredFrame: digestOf("@narratage/spatial/anchored-frame@1"),+ aspectFrame: digestOf("@narratage/spatial/aspect-frame@1"),+ fitContent: digestOf("@narratage/spatial/fit-content@1"),+ } as const;++ export const spatialValidatorDigests = {+ canvas: digestOf("@narratage/spatial/validate-canvas@1"),+ point: digestOf("@narratage/spatial/validate-point@1"),+ frame: digestOf("@narratage/spatial/validate-frame@1"),+ path: digestOf("@narratage/spatial/validate-path@1"),+ extent: digestOf("@narratage/spatial/validate-extent@1"),+ fit: digestOf("@narratage/spatial/validate-fit@1"),+ fitted: digestOf("@narratage/spatial/validate-fitted@1"),+ } as const;+++/** One portrait square-pixel Canvas for editors and previews before author input. */++export function defaultCanvasSpace(): CanvasSpace {++ return {++ contract: "svml.canvas-space@1",++ widthPx: 1080,++ heightPx: 1920,++ origin: "top-left",++ xDirection: "right",++ yDirection: "down",++ pixelAspect: "square",++ };++}+++ function finite(value: number, label: string): void {+ if (!Number.isFinite(value)) throw new Error(`${label} must be finite.`);+ }++ function positive(value: number, label: string): void {+ finite(value, label);+ if (value <= 0) throw new Error(`${label} must be positive.`);+ }++ export function assertCanvasSpace(value: CanvasSpace): void {+ if (value.contract !== "svml.canvas-space@1"+ || !Number.isSafeInteger(value.widthPx) || value.widthPx <= 0+ || !Number.isSafeInteger(value.heightPx) || value.heightPx <= 0+ || value.origin !== "top-left" || value.xDirection !== "right"+ || value.yDirection !== "down" || value.pixelAspect !== "square") {+ throw new Error("CanvasSpace is invalid.");+ }+ }++ export function assertSpatialPoint(value: SpatialPoint): void {+ if (value.contract !== "svml.spatial-point@1") throw new Error("Unsupported SpatialPoint contract.");+ finite(value.xPx, "SpatialPoint.xPx");+ finite(value.yPx, "SpatialPoint.yPx");+ }++ export function assertSpatialFrame(value: SpatialFrame): void {+ if (value.contract !== "svml.spatial-frame@1") throw new Error("Unsupported SpatialFrame contract.");+ finite(value.xPx, "SpatialFrame.xPx");+ finite(value.yPx, "SpatialFrame.yPx");+ positive(value.widthPx, "SpatialFrame.widthPx");+ positive(value.heightPx, "SpatialFrame.heightPx");+ }++ export function assertIntrinsicExtent(value: IntrinsicExtent): void {+ if (value.contract !== "svml.intrinsic-extent@1") throw new Error("Unsupported IntrinsicExtent contract.");+ positive(value.widthPx, "IntrinsicExtent.widthPx");+ positive(value.heightPx, "IntrinsicExtent.heightPx");+ }++ function assertNormalizedPoint(value: { readonly x: number; readonly y: number }, label: string): void {+ finite(value.x, `${label}.x`);+ finite(value.y, `${label}.y`);+ if (value.x < 0 || value.x > 1 || value.y < 0 || value.y > 1) {+ throw new Error(`${label} must lie inside [0, 1].`);+ }+ }++ export function assertContentFit(value: ContentFit): void {+ if (value.contract !== "svml.content-fit@1") throw new Error("Unsupported ContentFit contract.");+ if (!["contain", "cover", "fit-width", "fit-height", "native", "scale-down", "stretch"].includes(value.sizing)) {+ throw new Error("ContentFit.sizing is invalid.");+ }+ assertNormalizedPoint(value.framePoint, "ContentFit.framePoint");+ assertNormalizedPoint(value.contentPoint, "ContentFit.contentPoint");+ finite(value.offsetPx.x, "ContentFit.offsetPx.x");+ finite(value.offsetPx.y, "ContentFit.offsetPx.y");+ if (value.constraint !== "bounded" && value.constraint !== "free") throw new Error("ContentFit.constraint is invalid.");+ }++ export function assertFittedContent(value: FittedContent): void {+ if (value.contract !== "svml.fitted-content@1") throw new Error("Unsupported FittedContent contract.");+ assertSpatialFrame(value.contentFrame);+ }++ function commandNumbers(command: SpatialPath["commands"][number]): readonly number[] {+ switch (command.kind) {+ case "move":+ case "line": return [command.xPx, command.yPx];+ case "quadratic": return [command.controlX, command.controlY, command.xPx, command.yPx];+ case "cubic": return [command.control1X, command.control1Y, command.control2X, command.control2Y, command.xPx, command.yPx];+ case "close": return [];+ }+ }++ export function assertSpatialPath(value: SpatialPath): void {+ if (value.contract !== "svml.spatial-path@1" || value.commands.length < 2 || value.commands[0]?.kind !== "move") {+ throw new Error("SpatialPath must begin with move and contain drawable commands.");+ }+ let open = true;+ let drawable = false;+ for (const [index, command] of value.commands.entries()) {+ for (const coordinate of commandNumbers(command)) finite(coordinate, `SpatialPath command ${index}`);+ if (command.kind === "move") {+ open = true;+ } else if (command.kind === "close") {+ if (!open) throw new Error("SpatialPath cannot close an already closed subpath.");+ open = false;+ } else {+ if (!open) throw new Error("SpatialPath requires move after a closed subpath.");+ drawable = true;+ }+ }+ if (!drawable) throw new Error("SpatialPath contains no drawable segment.");+ }++ function length(value: SpatialLength, dimension: number, label: string): number {+ finite(value.value, label);+ if (value.unit === "px") return value.value;+ if (value.unit === "percent") return dimension * value.value / 100;+ throw new Error(`${label} uses an unsupported unit.`);+ }++ function anchorPoint(anchor: SpatialAnchor): { readonly x: number; readonly y: number } {+ const [vertical, horizontal] = anchor === "center" ? ["middle", "center"] : anchor.split("-");+ const x = horizontal === "left" ? 0 : horizontal === "center" ? 0.5 : horizontal === "right" ? 1 : undefined;+ const y = vertical === "top" ? 0 : vertical === "middle" ? 0.5 : vertical === "bottom" ? 1 : undefined;+ if (x === undefined || y === undefined) throw new Error(`Spatial anchor ${anchor} is invalid.`);+ return { x, y };+ }++ function sealFrame(value: Omit<SpatialFrame, "contract">): SpatialFrame {+ const frame = { contract: "svml.spatial-frame@1" as const, ...value };+ assertSpatialFrame(frame);+ return frame;+ }++ export function canvasFrame(canvas: CanvasSpace): SpatialFrame {+ assertCanvasSpace(canvas);+ return sealFrame({ xPx: 0, yPx: 0, widthPx: canvas.widthPx, heightPx: canvas.heightPx });+ }++ export function frameFromEdges(parent: SpatialFrame, program: FrameEdgesProgram): SpatialFrame {+ assertSpatialFrame(parent);+ if (program.contract !== "svml.frame-edges-program@1") throw new Error("Unsupported FrameEdgesProgram contract.");+ const left = parent.xPx + length(program.left, parent.widthPx, "Frame left");+ const right = parent.xPx + length(program.right, parent.widthPx, "Frame right");+ const top = parent.yPx + length(program.top, parent.heightPx, "Frame top");+ const bottom = parent.yPx + length(program.bottom, parent.heightPx, "Frame bottom");+ return sealFrame({ xPx: left, yPx: top, widthPx: right - left, heightPx: bottom - top });+ }++ export function anchoredFrame(parent: SpatialFrame, program: AnchoredFrameProgram): SpatialFrame {+ assertSpatialFrame(parent);+ if (program.contract !== "svml.anchored-frame-program@1") throw new Error("Unsupported AnchoredFrameProgram contract.");+ const widthPx = length(program.width, parent.widthPx, "AnchoredFrame width");+ const heightPx = length(program.height, parent.heightPx, "AnchoredFrame height");+ positive(widthPx, "AnchoredFrame width");+ positive(heightPx, "AnchoredFrame height");+ const targetX = parent.xPx + length(program.x, parent.widthPx, "AnchoredFrame x");+ const targetY = parent.yPx + length(program.y, parent.heightPx, "AnchoredFrame y");+ finite(program.offsetPx.x, "AnchoredFrame offset x");+ finite(program.offsetPx.y, "AnchoredFrame offset y");+ const anchor = anchorPoint(program.anchor);+ return sealFrame({+ xPx: targetX - widthPx * anchor.x + program.offsetPx.x,+ yPx: targetY - heightPx * anchor.y + program.offsetPx.y,+ widthPx,+ heightPx,+ });+ }++ export function aspectFrame(parent: SpatialFrame, extent: IntrinsicExtent, program: AspectFrameProgram): SpatialFrame {+ assertSpatialFrame(parent);+ assertIntrinsicExtent(extent);+ if (program.contract !== "svml.aspect-frame-program@1") throw new Error("Unsupported AspectFrameProgram contract.");+ const primary = length(program.size, program.primary === "width" ? parent.widthPx : parent.heightPx, "AspectFrame size");+ positive(primary, "AspectFrame size");+ const widthPx = program.primary === "width" ? primary : primary * extent.widthPx / extent.heightPx;+ const heightPx = program.primary === "height" ? primary : primary * extent.heightPx / extent.widthPx;+ return anchoredFrame(parent, {+ contract: "svml.anchored-frame-program@1",+ x: program.x,+ y: program.y,+ width: { unit: "px", value: widthPx },+ height: { unit: "px", value: heightPx },+ anchor: program.anchor,+ offsetPx: program.offsetPx,+ });+ }++ function boundedCoordinate(position: number, contentSize: number, frameStart: number, frameSize: number): number {+ const first = frameStart;+ const second = frameStart + frameSize - contentSize;+ const low = Math.min(first, second);+ const high = Math.max(first, second);+ return Math.min(high, Math.max(low, position));+ }++ export function fitContent(frame: SpatialFrame, extent: IntrinsicExtent, fit: ContentFit): FittedContent {+ assertSpatialFrame(frame);+ assertIntrinsicExtent(extent);+ assertContentFit(fit);+ const containScale = Math.min(frame.widthPx / extent.widthPx, frame.heightPx / extent.heightPx);+ const scale = fit.sizing === "contain" ? containScale+ : fit.sizing === "cover" ? Math.max(frame.widthPx / extent.widthPx, frame.heightPx / extent.heightPx)+ : fit.sizing === "fit-width" ? frame.widthPx / extent.widthPx+ : fit.sizing === "fit-height" ? frame.heightPx / extent.heightPx+ : fit.sizing === "native" ? 1+ : fit.sizing === "scale-down" ? Math.min(1, containScale)+ : undefined;+ const widthPx = fit.sizing === "stretch" ? frame.widthPx : extent.widthPx * (scale ?? 1);+ const heightPx = fit.sizing === "stretch" ? frame.heightPx : extent.heightPx * (scale ?? 1);+ let xPx = frame.xPx + frame.widthPx * fit.framePoint.x - widthPx * fit.contentPoint.x + fit.offsetPx.x;+ let yPx = frame.yPx + frame.heightPx * fit.framePoint.y - heightPx * fit.contentPoint.y + fit.offsetPx.y;+ if (fit.constraint === "bounded") {+ xPx = boundedCoordinate(xPx, widthPx, frame.xPx, frame.widthPx);+ yPx = boundedCoordinate(yPx, heightPx, frame.yPx, frame.heightPx);+ }+ const result: FittedContent = {+ contract: "svml.fitted-content@1",+ contentFrame: sealFrame({ xPx, yPx, widthPx, heightPx }),+ };+ assertFittedContent(result);+ return result;+ }++ export function sealCanvasSpace(value: CanvasSpace): CanvasSpace { assertCanvasSpace(value); return structuredClone(value); }+ export function sealSpatialPoint(value: SpatialPoint): SpatialPoint { assertSpatialPoint(value); return structuredClone(value); }+ export function sealSpatialFrame(value: SpatialFrame): SpatialFrame { assertSpatialFrame(value); return structuredClone(value); }+ export function sealSpatialPath(value: SpatialPath): SpatialPath { assertSpatialPath(value); return structuredClone(value); }+ export function sealIntrinsicExtent(value: IntrinsicExtent): IntrinsicExtent { assertIntrinsicExtent(value); return structuredClone(value); }+ export function sealContentFit(value: ContentFit): ContentFit { assertContentFit(value); return structuredClone(value); }+ export function sealFittedContent(value: FittedContent): FittedContent { assertFittedContent(value); return structuredClone(value); }diff --cc packages/spatial/src/manifest.tsindex 00000000,9736e522..56a26a2emode 000000,100644..100644--- a/packages/spatial/src/manifest.ts+++ b/packages/spatial/src/manifest.ts@@@ -1,0 -1,89 +1,89 @@@+ import { digestOf } from "@narratage/protocol";+ import type { ModuleManifest, ProducerRef, TypeRef } from "@narratage/protocol";+-import { spatialImplementationDigests, spatialValidatorDigests } from "./geometry.js";++import { defaultCanvasSpace, spatialImplementationDigests, spatialValidatorDigests } from "./geometry.js";+ import {+ anchoredFrameProgramSchema,+ aspectFrameProgramSchema,+ canvasSpaceSchema,+ contentFitSchema,+ fittedContentSchema,+ frameEdgesProgramSchema,+ intrinsicExtentSchema,+ spatialFrameSchema,+ spatialPathSchema,+ spatialPointSchema,+ } from "./schema.js";++ export const spatialModuleRef = { name: "@narratage/spatial", version: "1" } as const;+ export const spatialSurfaceDigests = {+ canvas: digestOf("@narratage/spatial/canvas-surface@1"),+ point: digestOf("@narratage/spatial/point-surface@1"),+ path: digestOf("@narratage/spatial/path-surface@1"),+ extent: digestOf("@narratage/spatial/extent-surface@1"),+ frame: digestOf("@narratage/spatial/frame-surface@1"),+ anchoredFrame: digestOf("@narratage/spatial/anchored-frame-surface@1"),+ aspectFrame: digestOf("@narratage/spatial/aspect-frame-surface@1"),+ } as const;+ export const spatialTypes = {+ canvas: { module: spatialModuleRef, name: "CanvasSpace" },+ point: { module: spatialModuleRef, name: "SpatialPoint" },+ frame: { module: spatialModuleRef, name: "SpatialFrame" },+ path: { module: spatialModuleRef, name: "SpatialPath" },+ extent: { module: spatialModuleRef, name: "IntrinsicExtent" },+ fit: { module: spatialModuleRef, name: "ContentFit" },+ fitted: { module: spatialModuleRef, name: "FittedContent" },+ frameEdgesProgram: { module: spatialModuleRef, name: "FrameEdgesProgram" },+ anchoredFrameProgram: { module: spatialModuleRef, name: "AnchoredFrameProgram" },+ aspectFrameProgram: { module: spatialModuleRef, name: "AspectFrameProgram" },+ } satisfies Record<string, TypeRef>;+ export const spatialProducers = {+ canvasFrame: { module: spatialModuleRef, name: "canvas-frame" },+ frameEdges: { module: spatialModuleRef, name: "frame-edges" },+ anchoredFrame: { module: spatialModuleRef, name: "anchored-frame" },+ aspectFrame: { module: spatialModuleRef, name: "aspect-frame" },+ fitContent: { module: spatialModuleRef, name: "fit-content" },+ } satisfies Record<string, ProducerRef>;++ const validator = (locator: string, digest: ReturnType<typeof digestOf>) => ({+ abi: "svml.type-validator@1" as const,+ implementation: { kind: "registered" as const, locator, digest },+ });++ export const spatialManifest: ModuleManifest = {+ format: "svml.module@1",+ name: spatialModuleRef.name,+ version: spatialModuleRef.version,+ dependencies: [],+ types: [- { name: spatialTypes.canvas.name, schema: canvasSpaceSchema, validator: validator("@narratage/spatial/validate-canvas", spatialValidatorDigests.canvas) },++ { name: spatialTypes.canvas.name, schema: canvasSpaceSchema, default: defaultCanvasSpace(), validator: validator("@narratage/spatial/validate-canvas", spatialValidatorDigests.canvas) },+ { name: spatialTypes.point.name, schema: spatialPointSchema, validator: validator("@narratage/spatial/validate-point", spatialValidatorDigests.point) },+ { name: spatialTypes.frame.name, schema: spatialFrameSchema, validator: validator("@narratage/spatial/validate-frame", spatialValidatorDigests.frame) },+ { name: spatialTypes.path.name, schema: spatialPathSchema, validator: validator("@narratage/spatial/validate-path", spatialValidatorDigests.path) },+ { name: spatialTypes.extent.name, schema: intrinsicExtentSchema, validator: validator("@narratage/spatial/validate-extent", spatialValidatorDigests.extent) },+ { name: spatialTypes.fit.name, schema: contentFitSchema, validator: validator("@narratage/spatial/validate-fit", spatialValidatorDigests.fit) },+ { name: spatialTypes.fitted.name, schema: fittedContentSchema, validator: validator("@narratage/spatial/validate-fitted", spatialValidatorDigests.fitted) },+ { name: spatialTypes.frameEdgesProgram.name, schema: frameEdgesProgramSchema },+ { name: spatialTypes.anchoredFrameProgram.name, schema: anchoredFrameProgramSchema },+ { name: spatialTypes.aspectFrameProgram.name, schema: aspectFrameProgramSchema },+ ],+ capabilities: [],+ surfaces: [+ { name: "canvas", tag: "Canvas", mode: "structured", outputs: [spatialTypes.canvas], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/canvas-surface", digest: spatialSurfaceDigests.canvas } },+ { name: "point", tag: "Point", mode: "structured", outputs: [spatialTypes.point], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/point-surface", digest: spatialSurfaceDigests.point } },+ { name: "path", tag: "Path", mode: "structured", outputs: [spatialTypes.path], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/path-surface", digest: spatialSurfaceDigests.path } },+ { name: "extent", tag: "Extent", mode: "structured", outputs: [spatialTypes.extent], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/extent-surface", digest: spatialSurfaceDigests.extent } },+ { name: "frame", tag: "Frame", mode: "structured", outputs: [spatialTypes.frame, spatialTypes.frameEdgesProgram], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/frame-surface", digest: spatialSurfaceDigests.frame } },+ { name: "anchored-frame", tag: "AnchoredFrame", mode: "structured", outputs: [spatialTypes.frame, spatialTypes.anchoredFrameProgram], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/anchored-frame-surface", digest: spatialSurfaceDigests.anchoredFrame } },+ { name: "aspect-frame", tag: "AspectFrame", mode: "structured", outputs: [spatialTypes.frame, spatialTypes.extent, spatialTypes.aspectFrameProgram], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/spatial/aspect-frame-surface", digest: spatialSurfaceDigests.aspectFrame } },+ ],+ producers: [+ { name: spatialProducers.canvasFrame.name, inputs: [{ name: "canvas", type: spatialTypes.canvas }], outputs: [{ name: "frame", type: spatialTypes.frame }], needs: [], implementation: { kind: "registered", locator: "@narratage/spatial/canvas-frame", digest: spatialImplementationDigests.canvasFrame } },+ { name: spatialProducers.frameEdges.name, inputs: [{ name: "parent", type: spatialTypes.frame }, { name: "program", type: spatialTypes.frameEdgesProgram }], outputs: [{ name: "frame", type: spatialTypes.frame }], needs: [], implementation: { kind: "registered", locator: "@narratage/spatial/frame-edges", digest: spatialImplementationDigests.frameEdges } },+ { name: spatialProducers.anchoredFrame.name, inputs: [{ name: "parent", type: spatialTypes.frame }, { name: "program", type: spatialTypes.anchoredFrameProgram }], outputs: [{ name: "frame", type: spatialTypes.frame }], needs: [], implementation: { kind: "registered", locator: "@narratage/spatial/anchored-frame", digest: spatialImplementationDigests.anchoredFrame } },+ { name: spatialProducers.aspectFrame.name, inputs: [{ name: "parent", type: spatialTypes.frame }, { name: "extent", type: spatialTypes.extent }, { name: "program", type: spatialTypes.aspectFrameProgram }], outputs: [{ name: "frame", type: spatialTypes.frame }], needs: [], implementation: { kind: "registered", locator: "@narratage/spatial/aspect-frame", digest: spatialImplementationDigests.aspectFrame } },+ { name: spatialProducers.fitContent.name, inputs: [{ name: "frame", type: spatialTypes.frame }, { name: "extent", type: spatialTypes.extent }, { name: "fit", type: spatialTypes.fit }], outputs: [{ name: "fitted", type: spatialTypes.fitted }], needs: [], implementation: { kind: "registered", locator: "@narratage/spatial/fit-content", digest: spatialImplementationDigests.fitContent } },+ ],+ };+ export const spatialManifestDigest = digestOf(spatialManifest);+ export const spatialDependency = { module: spatialModuleRef, digest: spatialManifestDigest } as const;diff --cc packages/speech-evidence/src/manifest.tsindex 00000000,00000000..b257ae5dnew file mode 100644--- /dev/null+++ b/packages/speech-evidence/src/manifest.ts@@@ -1,0 -1,0 +1,5 @@@++export {++ speechEvidenceDependency,++ speechEvidenceManifest,++ speechEvidenceManifestDigest,++} from "./index.js";diff --cc packages/temporal/src/manifest.tsindex 00000000,00000000..4d9e8515new file mode 100644--- /dev/null+++ b/packages/temporal/src/manifest.ts@@@ -1,0 -1,0 +1,5 @@@++export {++ temporalDependency,++ temporalManifest,++ temporalManifestDigest,++} from "./index.js";diff --cc packages/visual-ir/src/manifest.tsindex 00000000,00000000..92ecc9c3new file mode 100644--- /dev/null+++ b/packages/visual-ir/src/manifest.ts@@@ -1,0 -1,0 +1,5 @@@++export {++ visualIrDependency,++ visualIrManifest,++ visualIrManifestDigest,++} from "./index.js";diff --cc pnpm-lock.yamlindex 16e8712d,e0ec9c66..23fce033--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@@ -53,12 -77,6 +77,9 @@@ importers'@narratage/program-space':specifier: workspace:*version: link:packages/program-space- '@narratage/prompt-kit':- specifier: workspace:*- version: link:packages/prompt-kit+ '@narratage/protocol':+ specifier: workspace:*+ version: link:packages/protocol'@narratage/provider-google-vertex':specifier: workspace:*version: link:packages/provider-google-vertexdiff --cc test/playground-discovery.test.tsindex 5034e37b,00000000..01e154d4mode 100644,000000..100644--- a/test/playground-discovery.test.ts+++ b/test/playground-discovery.test.ts@@@ -1,103 -1,0 +1,111 @@@+import assert from "node:assert/strict";+import { readdirSync } from "node:fs";+import test from "node:test";+import { fileURLToPath } from "node:url";++import { assertHyperframesDocument, compileHyperframesDocument } from "@narratage/hyperframes";+import { sealComposition } from "@narratage/composition";+import { sealProgramSpace } from "@narratage/program-space";++import { discoverPreviewProducers } from "../tools/playground/src/discovery/producers.js";+import type { PreviewSources } from "../tools/playground/src/discovery/producers.js";++/**+ * The playground lists no components. It finds them, by asking the manifests+ * which modules declare a Producer that outputs a VisualTrack.+ *+ * These tests run that discovery over the real workspace, so a module that+ * gains or loses a visual Producer changes the result here without anybody+ * editing a list — which is the property the whole arrangement exists for.+ */++const packages = fileURLToPath(new URL("../packages", import.meta.url));++function workspace(): PreviewSources {+ const entries: Record<string, () => Promise<unknown>> = {};+ const components: Record<string, () => Promise<unknown>> = {};+ for (const dir of readdirSync(packages, { withFileTypes: true })) {+ if (!dir.isDirectory()) continue;- // A small module states its manifest in its entry rather than in a file of- // its own, and a Producer taking one of its types still needs the schema.++ // The browser follows this same dedicated metadata boundary. Importing++ // package indexes would pull Node-only Providers and Drivers into Vite.+ entries[`${dir.name}/manifest`] = async () => await import(`${packages}/${dir.name}/src/manifest.ts`);- entries[`${dir.name}/index`] = async () => await import(`${packages}/${dir.name}/src/index.ts`);+ components[dir.name] = async () => await import(`${packages}/${dir.name}/src/component.ts`);+ }+ return { manifests: entries, components };+}++const programSpace = sealProgramSpace({+ contract: "svml.program-space@1",+ durationSec: 4,+ frameRate: { numerator: 30, denominator: 1 },+});+const canvas = { width: 1080, height: 1920, clearColor: "#09090b" };++test("previewable modules are the ones declaring a VisualTrack Producer", async () => {+ const found = await discoverPreviewProducers(workspace());+ assert.deepEqual(+ [...new Set(found.map((producer) => producer.moduleName))].sort(),- ["@narratage/broll", "@narratage/caption", "@narratage/speech-basis", "@narratage/text-track"],++ [++ "@narratage/caption-fine",++ "@narratage/comment-sticker",++ "@narratage/deck-track",++ "@narratage/media-track",++ "@narratage/ranking",++ "@narratage/screen-overlay",++ "@narratage/speech-basis",++ "@narratage/typography-track",++ ],+ );+});++test("each producer carries its inputs' declared schemas", async () => {+ for (const producer of await discoverPreviewProducers(workspace())) {+ assert.ok(producer.inputs.length > 0, `${producer.id} declares no inputs`);+ for (const input of producer.inputs) {+ assert.notEqual(input.schema, undefined,+ `${producer.id} input ${input.name} has no schema, so no form can be built for it`);+ }+ }+});++test("a producer whose inputs all carry defaults renders without anything being typed", async () => {+ const found = await discoverPreviewProducers(workspace());+ const ready = found.filter((producer) =>+ producer.inputs.every((input) => input.initial !== undefined));+- // The modules that can answer for themselves entirely: caption and text.- // B-roll and speech take content-addressed media, which no module can default.- assert.ok(ready.length >= 2, "at least two producers should be fully defaulted");++ assert.deepEqual(ready.map((producer) => producer.id), [++ "@narratage/screen-overlay#render-screen-overlay",++ ]);++ for (const producer of ready) {+ const values = Object.fromEntries(producer.inputs.map((input) =>+ [input.name, input.type.name === "ProgramSpace" ? programSpace : input.initial]));+ const track = producer.invoke(values as never);+ const document = compileHyperframesDocument(sealComposition({+ contract: "svml.composition@1",+ id: producer.moduleName,+ canvas,+ tracks: [track as never],+ }), programSpace);+ assert.doesNotThrow(() => assertHyperframesDocument(document),+ `${producer.id} produced an illegal document from its own declared defaults`);+ assert.match(document.html, /class="clip svml-visual-present"/u);+ }+});++test("a module offering no default for a media input says so rather than inventing one", async () => {+ const found = await discoverPreviewProducers(workspace());- // B-roll and speech both take a value carrying a content-addressed Artifact,++ // Media Track and speech both take a value carrying a content-addressed Artifact,+ // and a module has no bytes to point at, so neither offers a default. Saying+ // nothing is the honest answer; a stub digest would be rejected downstream.- for (const moduleName of ["@narratage/broll", "@narratage/speech-basis"]) {++ for (const moduleName of ["@narratage/media-track", "@narratage/speech-basis"]) {+ const producer = found.find((entry) => entry.moduleName === moduleName)!;+ assert.ok(producer.inputs.some((input) => input.initial === undefined),+ `${moduleName} should decline to default its media-bearing input`);+ }+});+- test("each producer is discovered once, however many files re-export its module", async () => {++test("each producer is discovered exactly once", async () => {+ const found = await discoverPreviewProducers(workspace());+ assert.equal(new Set(found.map((producer) => producer.id)).size, found.length);+});diff --cc tools/playground/README.mdindex 135dce8e,00000000..d692d577mode 100644,000000..100644--- a/tools/playground/README.md+++ b/tools/playground/README.md@@@ -1,69 -1,0 +1,69 @@@+# Component playground++Look at a visual component without running a Build.++```bash+pnpm playground+```++Pick a producer, fill in its inputs, and it renders on a canvas of the size you- choose. Choose a `.svs` stylesheet and its Film Recipe fills in the frame.++choose. Choose a `.svs` stylesheet and its Film Recipe fills in Film appearance;++canvas size and time stay explicit preview-environment controls.++[The guide page](../../docs/guide/playground.md) covers using it. This file+covers how it works.++## It lists nothing++There is no registry here, and no per-component code. Everything comes from+what the compiler already declares about itself:++| Question | Answered by |+|---|---|+| Which modules can be previewed | manifests declaring a Producer whose output type is `@narratage/composition.VisualTrack` |+| What each needs | that Producer's `inputs`, each a `TypeRef` |+| What shape each input has | the declaring module's `TypeDeclaration.schema` |+| What a control should look like | `ValueSchema.format` — `color`, `unit-fraction`, `multiline`, `digest`, `duration` |+| What to start from | `TypeDeclaration.default`, given by the module that owns the type |+| How to run it | the module's `component.producers[].handler` |++A module that gains a visual Producer appears here on its own. One that loses+it disappears. Neither requires editing anything in this directory.++Nothing here validates, either: `validateStoredValue` and the modules' own+`seal*` and `assert*` functions are the judge, because they are what a real+Build runs. A rejected value shows the compiler's own message beside the form+and leaves the last good frame up.++## Two things a Build supplies that the document does not++`compileHyperframesDocument` emits a page that is self-contained but not+self-sufficient — a real render supplies a producer for the rest. The shim in+`src/preview/runtime-shim.ts` stands in for it:++- **Size.** The composition root carries `data-width` / `data-height` as data,+ not as layout. Unsized it computes to zero height, and `overflow: hidden`+ clips every Present away.+- **Timeline.** Every clip is marked visible and every animation starts at load.+ The shim gates each Present to its span and seeks its animations with+ `getAnimations()` plus an explicit `currentTime` — the same technique the+ production renderer uses.++## Making a module previewable++Nothing to add here. In the module: declare a Producer that outputs a+`VisualTrack`, give each input type a `schema`, and give it a `default` where+you honestly can. A type carrying content-addressed media has no default — say+nothing rather than inventing a digest, and the playground will ask the operator+for a file instead.++Annotate a field with `format` where its type alone is ambiguous: a colour and+a font family are both strings, and only the module knows which is which.++## Known divergences from a real render++- Fonts lower to a plain CSS `font-family` string. The production- `FontArtifactRef` path with hashed `@font-face` families is not exercised,- because `renderCaptionTrack` and `renderTextTrack` do not attach one.++ `FontArtifactRef` path with hashed `@font-face` families is not exercised.+- Audio tracks are not played.+- The frame domain is the shell's, not the form's: a `ProgramSpace` input is+ filled from the canvas controls, so there is only one place to change it.diff --cc tools/playground/src/discovery/workspace.tsindex e7e53d12,00000000..5a0fb1e9mode 100644,000000..100644--- a/tools/playground/src/discovery/workspace.ts+++ b/tools/playground/src/discovery/workspace.ts@@@ -1,24 -1,0 +1,20 @@@+/// <reference types="vite/client" />++import { discoverPreviewProducers } from "./producers.js";+import type { PreviewProducer } from "./producers.js";++/**+ * Every workspace module, handed to the discovery as loaders.+ *+ * The glob is the only part of discovery that is Vite's rather than the+ * compiler's, so it is the only part kept here — which also leaves the+ * discovery itself runnable, and testable, outside a browser.+ */+export async function workspacePreviewProducers(): Promise<readonly PreviewProducer[]> {+ return await discoverPreviewProducers({- // Both, because a small module states its manifest in its entry rather than- // in a file of its own — ProgramSpace is one, and a Producer that takes one- // needs its schema to build a form.- manifests: {- ...import.meta.glob("../../../../packages/*/src/manifest.ts"),- ...import.meta.glob("../../../../packages/*/src/index.ts"),- },++ // Manifests have a dedicated, browser-safe entry. Globbing package indexes++ // would also bundle Node Drivers and Providers merely to discover metadata.++ manifests: import.meta.glob("../../../../packages/*/src/manifest.ts"),+ components: import.meta.glob("../../../../packages/*/src/component.ts"),+ });+}diff --cc tools/playground/src/svml.tsindex b9ecf831,00000000..5cf80839mode 100644,000000..100644--- a/tools/playground/src/svml.ts+++ b/tools/playground/src/svml.ts@@@ -1,50 -1,0 +1,50 @@@+/**+ * The browser-safe surface of the compiler, in one place.+ *- * Almost every package the playground needs is pure, but- * `@narratage/hyperframes`'s entry re-exports `stageHyperframesProject`, which- * writes a project to disk through `node:fs/promises`. Importing the package- * entry would therefore drag a filesystem into the browser for a function the- * playground never calls, so the document module is imported by path instead.++ * HyperFrames keeps its browser-safe compiler at the package root and its++ * Node-only project staging behind `@narratage/hyperframes/project`. The++ * document module is imported directly here so that boundary stays visible.+ *+ * Only the render path is named here. Components are not: they are discovered+ * from the manifests at run time, and a list of them in this file would be the+ * very coupling the discovery exists to avoid.+ */++export {+ assertHyperframesDocument,+ compileHyperframesDocument,+ materializeHyperframesHtml,+} from "../../../packages/hyperframes/src/document.js";+export type { HyperframesDocument } from "../../../packages/hyperframes/src/types.js";++export { sealComposition } from "@narratage/composition";+export type { Composition, Track, VisualTrack } from "@narratage/composition";++export {+ defaultProgramSpace,+ programSpaceFrameCount,+ sealProgramSpace,+} from "@narratage/program-space";+export type { ProgramSpace } from "@narratage/program-space";+++export { defaultCanvasSpace } from "@narratage/spatial";+++export { validateStoredValue } from "@narratage/core";++export type {+ CanonicalValue,+ ModuleManifest,+ ProducerDeclaration,+ TypeRef,+ ValueFormat,+ ValueSchema,+} from "@narratage/protocol";++export type { MediaArtifactRef } from "@narratage/media";++// Stylesheets are read to fill a form, never to decide what a component is.+export { parseSvs } from "@narratage/svs";+export type { SvsRecipe } from "@narratage/svs";+export { maskSourceHeader, parseSourceHeader } from "@narratage/source";+- export { defaultFilmProgram, filmCanvasFromRecipe, filmRecipeKeys } from "@narratage/film";++export { defaultFilmProgram, filmAppearanceFromRecipe, filmRecipeKeys } from "@narratage/film";diff --cc tools/playground/src/ui/shell.tsindex be44af3a,00000000..b3dd26damode 100644,000000..100644--- a/tools/playground/src/ui/shell.ts+++ b/tools/playground/src/ui/shell.ts@@@ -1,279 -1,0 +1,281 @@@+import type { PreviewProducer } from "../discovery/producers.js";+import { workspacePreviewProducers } from "../discovery/workspace.js";+import { renderPreview } from "../preview/render.js";+import {++ defaultCanvasSpace,+ defaultFilmProgram,+ defaultProgramSpace,- filmCanvasFromRecipe,++ filmAppearanceFromRecipe,+ filmRecipeKeys,+ maskSourceHeader,+ parseSourceHeader,+ parseSvs,+ sealProgramSpace,+} from "../svml.js";+import type { CanonicalValue, ProgramSpace, Track } from "../svml.js";+import { FORM_CSS, blankValue, buildForm } from "./form.js";+import { createStage } from "./stage.js";++const CSS = `+.rail {+ width: 356px; flex: 0 0 356px; border-right: 1px solid var(--line);+ background: var(--panel); display: flex; flex-direction: column; min-height: 0;+}+.rail-head { padding: 12px 14px; border-bottom: 1px solid var(--line); }+.rail-head h1 { margin: 0 0 10px; font-size: 13px; font-weight: 600; letter-spacing: .02em; }+.rail-body { flex: 1; min-height: 0; overflow-y: auto; padding: 10px 14px 24px; }+.rail select, .rail input[type=number] {+ background: #1c1c21; color: var(--text); border: 1px solid var(--line);+ border-radius: 5px; padding: 4px 7px; font: inherit; font-size: 12px; min-width: 0; width: 100%;+}+.rail-canvas { display: grid; grid-template-columns: auto 1fr auto 1fr; gap: 6px; align-items: center; margin-top: 9px; }+.rail-canvas span { color: var(--muted); font-size: 11px; }+.section { color: var(--accent); font-size: 11px; margin: 15px 0 4px; }+.section:first-child { margin-top: 0; }+.module { color: var(--muted); font-size: 11px; font-family: ui-monospace, monospace; margin-top: 4px; }+.sheet-note { color: var(--muted); font-size: 12px; margin-top: 7px; }+.sheet-note b { color: var(--accent); font-weight: 500; }+.sheet-file { font-size: 11px; color: var(--muted); max-width: 100%; }+.sheet-file::file-selector-button {+ border: 1px solid var(--line); border-radius: 5px; background: #1c1c21;+ color: var(--text); font: inherit; font-size: 11px; padding: 3px 9px; margin-right: 7px; cursor: pointer;+}+.sheet-file::file-selector-button:hover { border-color: #3a3a42; }+${FORM_CSS}+`;++export async function mountShell(root: HTMLElement): Promise<void> {+ const style = document.createElement("style");+ style.textContent = CSS;+ document.head.append(style);++ const rail = document.createElement("div");+ rail.className = "rail";+ rail.innerHTML = `+ <div class="rail-head">+ <h1>Component playground</h1>+ <select data-producer></select>+ <div class="module" data-module></div>+ <div class="rail-canvas">+ <span>W</span><input type="number" data-width min="16" step="2" />+ <span>H</span><input type="number" data-height min="16" step="2" />+ <span>fps</span><input type="number" data-fps min="1" step="1" />+ <span>sec</span><input type="number" data-duration min="0.1" step="0.1" />+ </div>+ </div>+ <div class="rail-body"></div>+ `;++ const picker = rail.querySelector<HTMLSelectElement>("[data-producer]")!;+ const moduleLine = rail.querySelector<HTMLElement>("[data-module]")!;+ const body = rail.querySelector<HTMLElement>(".rail-body")!;+ const widthInput = rail.querySelector<HTMLInputElement>("[data-width]")!;+ const heightInput = rail.querySelector<HTMLInputElement>("[data-height]")!;+ const fpsInput = rail.querySelector<HTMLInputElement>("[data-fps]")!;+ const durationInput = rail.querySelector<HTMLInputElement>("[data-duration]")!;++ const stage = createStage();+ root.append(rail, stage.element);++ const producers = await workspacePreviewProducers();+ if (producers.length === 0) {+ stage.showError("No module declares a Producer that outputs a VisualTrack.");+ return;+ }+ for (const producer of producers) {+ const option = document.createElement("option");+ option.value = producer.id;+ option.textContent = producer.label;+ picker.append(option);+ }+- // The Film module owns what an undeclared frame looks like, so the canvas- // starts as whatever it says rather than as numbers chosen here.++ // Spatial owns geometry, Film owns appearance and ProgramSpace owns time.++ // The preview starts from those three package-owned values instead of a++ // second playground-specific model of a frame.++ const canvasSpace = defaultCanvasSpace();+ const film = defaultFilmProgram();- const canvas = { ...film.canvas };++ const defaultSpace = defaultProgramSpace();++ const canvas = {++ width: canvasSpace.widthPx,++ height: canvasSpace.heightPx,++ clearColor: film.clearColor,++ };+ const space = {- fps: film.frameRate.numerator / film.frameRate.denominator,- durationSec: defaultProgramSpace().durationSec,++ fps: defaultSpace.frameRate.numerator / defaultSpace.frameRate.denominator,++ durationSec: defaultSpace.durationSec,+ };++ /**+ * Values a ProgramSpace input must agree with.+ *+ * Producers take a ProgramSpace as an ordinary input, but the canvas controls+ * and the scrubber describe the same thing, so the shell owns it and the form+ * does not offer a second copy to disagree with.+ */+ function programSpace(): ProgramSpace {+ return sealProgramSpace({+ contract: "svml.program-space@1",+ durationSec: space.durationSec,+ frameRate: { numerator: space.fps, denominator: 1 },+ });+ }++ const drafts = new Map<string, Record<string, CanonicalValue>>();+ // Open on something that draws. A producer whose inputs its own modules can+ // all supply shows a frame immediately; one waiting on media would greet the+ // operator with a failure they have not caused yet.+ let active: PreviewProducer = producers.find((producer) =>+ producer.inputs.every((input) => input.initial !== undefined)) ?? producers[0]!;+ picker.value = active.id;++ function draft(producer: PreviewProducer): Record<string, CanonicalValue> {+ const existing = drafts.get(producer.id);+ if (existing !== undefined) return existing;+ const created: Record<string, CanonicalValue> = {};+ for (const input of producer.inputs) {+ // Whatever the declaring module says one of these looks like. Where it+ // declines — because the value carries media it has no bytes for — the+ // schema still says what shape the operator has to fill in.+ created[input.name] = input.initial !== undefined+ ? structuredClone(input.initial) as CanonicalValue+ : input.schema === undefined ? null : blankValue(input.schema);+ }+ drafts.set(producer.id, created);+ return created;+ }++ function isProgramSpace(name: string, producer: PreviewProducer): boolean {+ return producer.inputs.some((input) =>+ input.name === name && input.type.name === "ProgramSpace");+ }++ let queued = 0;+ function schedule(): void {+ if (queued !== 0) clearTimeout(queued);+ queued = window.setTimeout(render, 120);+ }++ function render(): void {+ const values = { ...draft(active) };+ try {+ const resolved = programSpace();+ for (const input of active.inputs) {+ if (isProgramSpace(input.name, active)) values[input.name] = resolved as never;+ }+ const track = active.invoke(values) as Track;+ stage.show(renderPreview({+ id: active.moduleName,+ canvas,+ programSpace: resolved,+ tracks: [track],+ }));+ } catch (error) {+ // The compiler's own message. The last good frame stays up.+ stage.showError(error instanceof Error ? error.message : String(error));+ }+ }++ const note = document.createElement("div");+ note.className = "sheet-note";++ /**- * Reads a chosen stylesheet for its canvas.++ * Reads a chosen stylesheet for Film appearance.+ *- * A Film Recipe is where a frame size comes from, so a sheet is offered as- * a way to adopt one. Nothing else in it is read: what a component looks- * like comes from the module that owns it.++ * Geometry and time are graph inputs, not style. A Film Recipe may therefore++ * change only the Composition background; component Recipes remain owned by++ * their own modules.+ */+ function loadSheet(file: File): void {+ void file.text().then((source) => {+ const header = parseSourceHeader(file.name, source);+ if (!header.using.startsWith("@narratage/svs@")) {+ throw new Error(`${file.name} is a ${header.using} source, not a stylesheet.`);+ }+ const sheet = parseSvs(file.name, maskSourceHeader(source, header));+ const filmShape = [...filmRecipeKeys].sort().join(" ");+ const found = sheet.recipes.find((recipe) =>+ Object.keys(recipe.value.properties).sort().join(" ") === filmShape);+ if (found === undefined) {- note.textContent = `${file.name} declares no Film Recipe, so the canvas is unchanged.`;++ note.textContent = `${file.name} declares no Film Recipe, so the background is unchanged.`;+ return;+ }- const read = filmCanvasFromRecipe(found.value.properties);- canvas.width = read.canvas.width;- canvas.height = read.canvas.height;- canvas.clearColor = read.canvas.clearColor;- space.fps = read.frameRate.numerator / read.frameRate.denominator;- widthInput.value = String(canvas.width);- heightInput.value = String(canvas.height);- fpsInput.value = String(space.fps);- note.replaceChildren(document.createTextNode("Canvas from "));++ const read = filmAppearanceFromRecipe(found.value.properties);++ canvas.clearColor = read.clearColor;++ note.replaceChildren(document.createTextNode("Background from "));+ const which = document.createElement("b");+ which.textContent = found.value.path;+ note.append(which);+ render();+ }).catch((error: unknown) => {+ note.textContent = error instanceof Error ? error.message : String(error);+ });+ }++ const sheetPicker = document.createElement("input");+ sheetPicker.type = "file";+ sheetPicker.accept = ".svs";+ sheetPicker.className = "sheet-file";+ sheetPicker.addEventListener("change", () => {+ const file = sheetPicker.files?.[0];+ if (file !== undefined) loadSheet(file);+ });++ function section(title: string): HTMLElement {+ const element = document.createElement("div");+ element.className = "section";+ element.textContent = title;+ return element;+ }++ function renderRail(): void {+ const values = draft(active);+ moduleLine.textContent = active.moduleName;- body.replaceChildren(section("Canvas from a stylesheet"), sheetPicker, note);++ body.replaceChildren(section("Appearance from a stylesheet"), sheetPicker, note);++ for (const input of active.inputs) {+ // The shell owns the frame domain; offering it again would be a second+ // answer free to disagree with the canvas controls.+ if (isProgramSpace(input.name, active)) continue;+ body.append(section(input.name));+ if (input.schema === undefined) {+ const missing = document.createElement("div");+ missing.className = "sheet-note";+ missing.textContent = `${input.type.module.name} declares no schema for ${input.type.name}.`;+ body.append(missing);+ continue;+ }+ if (values[input.name] === null || values[input.name] === undefined) {+ const empty = document.createElement("div");+ empty.className = "sheet-note";+ empty.textContent = `${input.type.module.name} offers no default for ${input.type.name}.`;+ body.append(empty);+ }+ body.append(buildForm(input.schema, values[input.name] ?? {}, schedule));+ }+ }++ picker.addEventListener("input", () => {+ active = producers.find((entry) => entry.id === picker.value) ?? active;+ renderRail();+ render();+ });++ widthInput.value = String(canvas.width);+ heightInput.value = String(canvas.height);+ fpsInput.value = String(space.fps);+ durationInput.value = String(space.durationSec);+ for (const [input, apply] of [+ [widthInput, (n: number) => { canvas.width = n; }],+ [heightInput, (n: number) => { canvas.height = n; }],+ [fpsInput, (n: number) => { space.fps = n; }],+ [durationInput, (n: number) => { space.durationSec = n; }],+ ] as const) {+ input.addEventListener("input", () => {+ const value = Number(input.value);+ if (Number.isFinite(value) && value > 0) { apply(value); schedule(); }+ });+ }++ renderRail();+ render();+}diff --cc tools/recipe-defaults.test.mjsindex 35241803,00000000..6857c4f3mode 100644,000000..100644--- a/tools/recipe-defaults.test.mjs+++ b/tools/recipe-defaults.test.mjs@@@ -1,78 -1,0 +1,35 @@@+import assert from "node:assert/strict";+import test from "node:test";+- import {- captionAppearanceFromRecipe,- captionAppearanceRecipeKeys,- defaultCaptionAppearanceRecipe,- } from "../packages/caption/src/index.ts";- import {- brollAppearanceFromRecipe,- brollAppearanceRecipeKeys,- defaultBrollAppearanceRecipe,- } from "../packages/broll/src/index.ts";+import {+ defaultFilmRecipe,- filmCanvasFromRecipe,++ filmAppearanceFromRecipe,+ filmRecipeKeys,+} from "../packages/film/src/index.ts";- import {- defaultTextAppearanceRecipe,- textAppearanceFromRecipe,- textAppearanceRecipeKeys,- } from "../packages/text-track/src/index.ts";++/**+ * A module's default Recipe has to be a Recipe its own Surface would admit.+ *+ * The default and the required key set used to be stated twice — once as a+ * literal in the Surface handler and once wherever a consumer needed one — and+ * a copy that can drift silently is worse than no copy. Now the default is the+ * declaration and the key set is read off it, so the only thing left to check+ * is that the default actually survives the mapping it describes.+ */+const MODULES = [- {- name: "caption",- keys: captionAppearanceRecipeKeys,- recipe: defaultCaptionAppearanceRecipe,- read: captionAppearanceFromRecipe,- },- {- name: "text-track",- keys: textAppearanceRecipeKeys,- recipe: defaultTextAppearanceRecipe,- read: textAppearanceFromRecipe,- },- {- name: "broll",- keys: brollAppearanceRecipeKeys,- recipe: defaultBrollAppearanceRecipe,- read: brollAppearanceFromRecipe,- },- { name: "film", keys: filmRecipeKeys, recipe: defaultFilmRecipe, read: filmCanvasFromRecipe },++ { name: "film", keys: filmRecipeKeys, recipe: defaultFilmRecipe, read: filmAppearanceFromRecipe },+];++for (const module of MODULES) {+ test(`the ${module.name} default Recipe is one its own reader admits`, () => {+ assert.deepEqual([...module.keys].sort(), Object.keys(module.recipe).sort(),+ "the key set must be read off the default, not restated");+ assert.doesNotThrow(() => module.read(module.recipe));+ });++ test(`the ${module.name} reader refuses a Recipe with the wrong shape`, () => {+ const { [module.keys[0]]: _dropped, ...missing } = module.recipe;+ assert.throws(() => module.read(missing), /requires exactly/u);+ assert.throws(() => module.read({ ...module.recipe, unexpected: 1 }), /requires exactly/u);+ });+}-- test("no two modules claim the same Recipe shape", () => {- const seen = new Map();- for (const module of MODULES) {- const shape = [...module.keys].sort().join(" ");- assert.equal(seen.get(shape), undefined,- `${module.name} and ${seen.get(shape)} are indistinguishable to a reader matching on shape`);- seen.set(shape, module.name);- }- });