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
Rename the Playground to Studio wherever a reader is sent
rpone03d0257b0b2c
diff --git a/.agents/skills/hypit/references/local-author-package.md b/.agents/skills/hypit/references/local-author-package.mdindex f576f218..87e73d75 100644--- a/.agents/skills/hypit/references/local-author-package.md+++ b/.agents/skills/hypit/references/local-author-package.md@@ -138,11 +138,11 @@ nothing.slot as a Fragment input carrying the Artifact type, give the Producer that consumes it a secondform for the case where the slot is filled, and read it from `inputs` as the Artifact it is —a blob input arrives as the `BlobRef` itself rather than wrapped inline like every authored value.-- **The element kind follows the Artifact, not the slot.** A picture slot holds an image once the- document has built one and a stand-in *video* frame before it has, because that is what the- Playground substitutes for an output nothing has produced yet. Hard-code `kind: "image"` and the- component builds for nobody until the whole graph has run, which is the opposite of what a preview- is for. Decide from the Artifact's `mediaType` and the same code serves both.+- **The element kind follows the Artifact, not the slot.** A picture slot holds an image when the+ document built one and a video when a Run satisfied it with footage, and which of those arrives is+ not something the slot's name settles. Hard-code `kind: "image"` and the component builds for+ whichever half of that the author did not choose. Decide from the Artifact's `mediaType` and the+ same code serves both.- Never require an input the installing project has no reason to choose. If a Run Source exists onlyto produce the component's own texture, the texture is in the wrong place.- **A slot that is not filled yet costs its own cell and nothing more.** The component's structure —@@ -188,12 +188,12 @@ Use only existing checks:```bashpnpm checkpnpm hypit check path/to/main.svml-pnpm hypit check path/to/studio.svs+pnpm hypit check path/to/recipes.svspnpm hypit check path/to/build.svrun```A package that cannot be *seen* is not done. `hypit check` proves the Source is legal, and nothing-more; it will not tell you that the track a package produces fails to build when the Playground+more; it will not tell you that the track a package produces fails to build when Studiorenders it. Run the preview check and repair until it passes with no failures — a build failure isnot a difference to weigh, it is work that is not finished, and it is not bounded by the loop'sattempt ceiling:diff --git a/.agents/skills/hypit/references/playbooks/craft/b-roll.md b/.agents/skills/hypit/references/playbooks/craft/b-roll.mdindex 7f7b4023..62247764 100644--- a/.agents/skills/hypit/references/playbooks/craft/b-roll.md+++ b/.agents/skills/hypit/references/playbooks/craft/b-roll.md@@ -8,15 +8,17 @@ program audio.## See it before you generate itWhere a cutaway lands, how long it holds, and whether its Frame sits in the right part of the-picture are all decided by the Source, not by the footage. The SVML Playground answers all three-without a generation: an Item whose material exists shows real frames, and one whose material does-not is still placed, still scrubbable, and marked as standing in. Timings are estimated until a-build or a Run Source supplies measured ones, and an estimated cut point will move once WhisperX has-heard the audio.+picture are all decided by the Source, not by the footage. Hypit Studio answers all three without a+generation, provided the Run satisfies the material it places: cut points come from the aligned+`SemanticTrack`, so where a cutaway falls against the speech is measured rather than guessed.++Studio does not stand anything in. An Item whose material no Candidate supplies makes the Run+unopenable rather than appearing as a placeholder, so satisfy the B-roll outputs in the Run Source+with whatever footage you already have before expecting to see the placement.Do this after placing a Selection and before paying for a generation. Startup and arguments are in`docs/quickstart/preview.md`; for how to see placed items against their real frames, read-`../../preview.md` and start the SVML Playground.+`../../preview.md` and start Studio.## Choose the story beats first@@ -47,7 +49,7 @@ Do this after placing a Selection and before paying for a generation. Startup an</copy:Value><copy:Render id="demo-prompt"- template={broll-kit.broll-v1} recipe={studio.broll.screen-demo}>+ template={broll-kit.broll-v1} recipe={recipes.broll.screen-demo}><copy:Set name="story" text={demo-story}/></copy:Render>diff --git a/.agents/skills/hypit/references/playbooks/craft/captions.md b/.agents/skills/hypit/references/playbooks/craft/captions.mdindex acb3e487..1634690a 100644--- a/.agents/skills/hypit/references/playbooks/craft/captions.md+++ b/.agents/skills/hypit/references/playbooks/craft/captions.md@@ -47,7 +47,7 @@ exact font → caption-fine:Style → caption:Program → caption-ai:Planner<fonts:Stack id="caption-font" family="inter" weight="700"style="normal" emoji="color"/><caption-fine:Style id="primary-caption"- recipe={studio.caption.primary} font={caption-font}/>+ recipe={recipes.caption.primary} font={caption-font}/><caption:Program id="caption-program" display={story.caption}default={primary-caption}>diff --git a/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md b/.agents/skills/hypit/references/playbooks/craft/pip-overlay.mdindex 181c135a..835b0ca6 100644--- a/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md+++ b/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md@@ -25,7 +25,7 @@ secondary feed, or supporting image stays visible.<media-track:Track id="presenter-overlay" semantic={speech.semantic} canvas={vertical}><media-track:Item image={presenter-cutout.image} extent={presenter-extent}frame={presenter-pip} during="program"- appearance={studio.media.pip} motion={studio.motion.pip}/>+ appearance={recipes.media.pip} motion={recipes.motion.pip}/></media-track:Track>```diff --git a/.agents/skills/hypit/references/playbooks/formats/mass-tarot.md b/.agents/skills/hypit/references/playbooks/formats/mass-tarot.mdindex a6a321fa..7dd38675 100644--- a/.agents/skills/hypit/references/playbooks/formats/mass-tarot.md+++ b/.agents/skills/hypit/references/playbooks/formats/mass-tarot.md@@ -17,7 +17,7 @@ ordered reveals and interpretations.<whisperx:SemanticTake id="narration-semantic" narrative={story}segment={story.segment.reading} media={narration-media.media}/><speech:Track id="speech"- visual-frame={full-frame} visual-appearance={studio.speech.visual} visual-z="0">+ visual-frame={full-frame} visual-appearance={recipes.speech.visual} visual-z="0"><speech:Take source={narration-semantic.take}/></speech:Track>```diff --git a/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md b/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.mdindex c133acc0..60ee1a3f 100644--- a/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md+++ b/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md@@ -17,7 +17,7 @@ screen, product, hand, or proof changes.<whisperx:SemanticTake id="narration-semantic" narrative={story}segment={story.segment.narration} media={narration-media.media}/><speech:Track id="speech"- visual-frame={full-frame} visual-appearance={studio.speech.visual} visual-z="0">+ visual-frame={full-frame} visual-appearance={recipes.speech.visual} visual-z="0"><speech:Take source={narration-semantic.take}/></speech:Track>```diff --git a/.agents/skills/hypit/references/preview.md b/.agents/skills/hypit/references/preview.mdindex c38cb43d..1fec63bf 100644--- a/.agents/skills/hypit/references/preview.md+++ b/.agents/skills/hypit/references/preview.md@@ -1,15 +1,19 @@# Preview current source-After a meaningful Author Source change, start the SVML Playground and give the author the actual-URL. Kill the previous server first so the user does not inspect a stale composition.+After a meaningful Author Source change, start Hypit Studio and give the author the actual URL.+Kill the previous server first so the user does not inspect a stale composition.```bash-pkill -f svml-playground || true-pnpm svml:playground -- --source path/to/main.svml \- --run path/to/build.svrun \+pkill -f "@hypit/studio" || true+pnpm studio -- --run path/to/build.svrun \--runtime path/to/hypit.runtime.json &```-Read the startup output for the chosen port. Pass `--run` only when the preview needs Run Source-material or timing, and `--runtime` only when the Author Source reuses accepted Build records.+Read the startup output for the chosen port. `--run` is required: Studio's unit of work is the Run+Source, and it reads the Author SVML back out of it. Pass `--runtime` only when the Author Source+reuses accepted Build records.++Studio does not degrade. It has no stand-ins and no estimated timing — when a projection is missing+it refuses to open and names the issue, so a Run that opens is a Run whose Tracks all resolved.+`docs/quickstart/preview.md` is authoritative.diff --git a/.agents/skills/hypit/references/reconstruction/final-sources.md b/.agents/skills/hypit/references/reconstruction/final-sources.mdindex 8997b71f..95e8f688 100644--- a/.agents/skills/hypit/references/reconstruction/final-sources.md+++ b/.agents/skills/hypit/references/reconstruction/final-sources.md@@ -6,7 +6,7 @@ systems this reference actually contains, and write one complete project:- `main.svml` describes the whole video in original time order, keeps continuing base/sound intact,and represents one continuing overlay as one visual track.-- `studio.svs` contains every Recipe actually referenced by `main.svml`, using only declared+- `recipes.svs` contains every Recipe actually referenced by `main.svml`, using only declaredproperties and admitted values.- `build.svrun` references the Author Source and declares the required Targets with resolvabledependencies.@@ -61,13 +61,13 @@ Use existing checks only:```bashpnpm checkpnpm hypit check path/to/main.svml-pnpm hypit check path/to/studio.svs+pnpm hypit check path/to/recipes.svspnpm hypit check path/to/build.svrun````hypit check` proves a Source is legal; it proves nothing about whether the tracks it declares canactually be built. A track that fails the local preview fails the same way the moment the author-opens the Playground — a new package with a bad schedule, a media edge whose artifact is not an+opens Studio — a new package with a bad schedule, a media edge whose artifact is not animage, a reference that does not resolve. Find that now, not on the author's screen:```bash@@ -82,7 +82,7 @@ window, a media edge whose artifact is not an image). This is not a guessing prowhat is wrong, and you repair that. A track that cannot be built is not done, and this is not theloop: the two-attempt ceiling governs how *well* a buildable element is tuned to the reference; itdoes not govern whether the element builds at all. Every failure this check reports must be repaired-until the check passes — the author should never open the Playground and find that something they+until the check passes — the author should never open Studio and find that something theywere delivered cannot be seen. Repair as many times as the failure needs, then re-run the check.One failure is not a defect, and it is worth knowing before spending repairs on it. The preview hasdiff --git a/.agents/skills/hypit/references/reconstruction/index.md b/.agents/skills/hypit/references/reconstruction/index.mdindex 9ec32238..cb33070d 100644--- a/.agents/skills/hypit/references/reconstruction/index.md+++ b/.agents/skills/hypit/references/reconstruction/index.md@@ -1,6 +1,6 @@# Reference-video reconstruction route-This route reconstructs a complete reference video as usable `main.svml`, `studio.svs`, and+This route reconstructs a complete reference video as usable `main.svml`, `recipes.svs`, and`build.svrun`. The main agent owns all decisions and source code; Gemini supplies natural-languagevisual and audio evidence only.@@ -8,11 +8,11 @@ visual and audio evidence only.The deliverable is **the components the video needs, the three source files, and the Runtime Profilethat binds what they demand**, and it must be **visible**: the preview check builds every track the-sources declare, so the author can open the Playground and see what was reconstructed. Every+sources declare, so the author can open Studio and see what was reconstructed. Everygeneration the Source declares is declared, not performed: no Build is submitted for the pictures,and no video generation, speech synthesis, alignment or final render is run. Those belong to a laterstep that the author starts deliberately, after reading what was written. What is *not* deferred is-that the declared tracks build — the author should never open the Playground to find that something+that the declared tracks build — the author should never open Studio to find that somethingdelivered cannot be seen.One exception, because it is not a generation of the video: a component's own surface — the field itsdiff --git a/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md b/.agents/skills/hypit/references/reconstruction/reconstruction-loop.mdindex b612773b..3417cc92 100644--- a/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md+++ b/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md@@ -60,7 +60,7 @@ repaired. It is not caught by looking at the frame yourself and choosing a fontresemble it — that route silently depends on the loop model having vision, and stops working themoment it does not.-The SVML Playground in `../preview.md` is a browser preview for a person to look at. It is not a+Hypit Studio in `../preview.md` is a browser preview for a person to look at. It is not asource of the image this loop needs.Repairing one element never re-runs the others. Do not rebuild the whole video to inspect one piece,diff --git a/.agents/skills/hypit/references/reconstruction/workflow.md b/.agents/skills/hypit/references/reconstruction/workflow.mdindex 5d7adda3..0cda6a0e 100644--- a/.agents/skills/hypit/references/reconstruction/workflow.md+++ b/.agents/skills/hypit/references/reconstruction/workflow.md@@ -20,11 +20,11 @@ list_svml_packages→ narrow observe_reference questions for unresolved appearance and conflicts→ inspect_svml_vocabulary for candidate packages→ develop a project-local package only for a proven vocabulary gap-→ read final-sources.md, then author complete main.svml, studio.svs, build.svrun+→ read final-sources.md, then author complete main.svml, recipes.svs, build.svrunand the hypit.runtime.json that binds every capability they demand→ use existing checks and repair until legal→ run preview-check (final-sources.md) and repair until every track builds —- this has no attempt ceiling; a track the Playground cannot show is not done+ this has no attempt ceiling; a track Studio cannot show is not done→ read reconstruction-loop.md, then render each authored element and compare it```diff --git a/.agents/skills/hypit/references/seedance-kits.md b/.agents/skills/hypit/references/seedance-kits.mdindex 6ace00ff..ea26e6f7 100644--- a/.agents/skills/hypit/references/seedance-kits.md+++ b/.agents/skills/hypit/references/seedance-kits.md@@ -18,7 +18,7 @@ slots carry shot-specific dialogue or action.1. Read `packages/seedance-kits/README.md` and the selected Kit file for exact axes and defaults.2. Copy only that `.svs` file into the video project's `./kits/` directory; import the vendored copy.-3. Put stable axis choices in `studio.svs` as a named Recipe.+3. Put stable axis choices in `recipes.svs` as a named Recipe.4. Import `@hypit/text@1` as `copy`. Use `copy:Render` with the Kit Template and Recipe, thenconnect dynamic slots with `copy:Set`.5. Feed the rendered Text to the appropriate low-level Seedance Surface. Keep duration, resolution,diff --git a/.agents/skills/hypit/scripts/preview-check.mjs b/.agents/skills/hypit/scripts/preview-check.mjsindex cf221d80..4a16a251 100644--- a/.agents/skills/hypit/scripts/preview-check.mjs+++ b/.agents/skills/hypit/scripts/preview-check.mjs@@ -3,50 +3,91 @@* Preview-check a reconstruction before it is delivered.** `pnpm hypit check` proves a Source is legal; it proves nothing about whether- * the tracks it declares can actually be built by the local preview. A track- * that fails here fails the same way when the author opens the playground, so- * find out now.+ * the tracks it declares can actually be built. A track that fails here fails+ * the same way when the author opens Studio, so find out now.*- * Usage: node --import tsx .agents/skills/hypit/scripts/preview-check.mjs <main.svml> [<build.svrun>]- * Exit: 0 when every track built and nothing is waiting on an error.- * 1 otherwise, listing the failing tracks and their errors.+ * Usage: node --import tsx .agents/skills/hypit/scripts/preview-check.mjs <build.svrun> [<hypit.runtime.json>]+ * Exit: 0 when Studio opens and every Track resolved.+ * 1 otherwise, naming what refused and why.+ *+ * The argument is the Run Source, not the Author SVML. Studio's unit of work is+ * the Run — it reads the Author SVML back out of it — so a check that took the+ * `.svml` would be checking something Studio never opens.+ *+ * Studio does not degrade. It has no stand-ins and no estimated timing: when a+ * projection is missing it refuses to open and names the issue, so preflight+ * throwing is itself the failure report rather than something to inspect around.** Run it from the repository root. `tsx` is the repository's own dependency, so* a working directory outside the repository fails to resolve it before this* script runs at all — the error names `tsx`, not the source being checked.*/-// The script lives under `.agents/`; resolve the playground's preview pipeline from the repo root.+import { dirname, resolve } from "node:path";++// The script lives under `.agents/`; resolve Studio from the repo root.// Stay in URL space the whole way: a specifier built from a filesystem path is read as a URL, so// on Windows the drive letter becomes a scheme and the import fails before it resolves anything.-const { preview } = await import(- new URL("../../../../packages/svml-playground/src/pipeline/preview.js", import.meta.url).href);+const studio = (name) => new URL(`../../../../packages/studio/src/${name}`, import.meta.url).href;+const { openStudioArchive } = await import(studio("archive.js"));+const { loadStudioDomain } = await import(studio("domain.js"));+const { loadStudioRun } = await import(studio("run.js"));+const { readStudioSession } = await import(studio("session.js"));+const { inspectStudioRun } = await import(studio("studio-preflight.js"));-const source = process.argv[2];-if (source === undefined) {- console.error("usage: preview-check.mjs <main.svml> [<build.svrun>]");+const runArgument = process.argv[2];+if (runArgument === undefined) {+ console.error("usage: preview-check.mjs <build.svrun> [<hypit.runtime.json>]");process.exit(2);}-const run = process.argv[3];+const invokedFrom = process.env.INIT_CWD ?? process.cwd();+const runPath = resolve(invokedFrom, runArgument);+const runtimeArgument = process.argv[3];+const runtimePath = runtimeArgument === undefined ? undefined : resolve(invokedFrom, runtimeArgument);+const packageRoot = resolve(invokedFrom);+const workspaceRoot = dirname(runPath);++const domain = await loadStudioDomain({ run: runPath, workspaceRoot, packageRoot });+const archive = await openStudioArchive(runtimePath, packageRoot);+let session;+let refusal;+try {+ const run = await loadStudioRun({+ run: runPath,+ domain,+ ...(archive === undefined ? {} : { archive }),+ });+ // Preflight first, so an unopenable Run is reported as the refusal it is+ // rather than as whatever the build happens to fail on afterwards.+ inspectStudioRun(run.source, run);+ session = await readStudioSession({+ domain,+ run,+ ...(archive === undefined ? {} : { archive }),+ revision: 0,+ });+} catch (error) {+ refusal = error instanceof Error ? error.message : String(error);+} finally {+ // Close before reporting: `process.exit` in a `try` skips the `finally`, and+ // a runtime archive left open outlives the check.+ await archive?.close();+}++if (refusal !== undefined) {+ console.log(JSON.stringify({ refused: refusal }, null, 2));+ process.exit(1);+}-const built = await preview(source, run, undefined);const problems = [];-for (const track of built.tracks ?? []) {- const errors = track.errors ?? [];- if (errors.length > 0) problems.push({ track: track.name, errors });- else if ((track.waiting ?? []).length > 0) {- // A track waiting on a capability is normal when a Provider is absent; it- // is only a problem when it waits on an actual error rather than a Provider.- const fatal = track.waiting.filter((w) => !/Provider|credential|capability/iu.test(String(w)));- if (fatal.length > 0) problems.push({ track: track.name, waiting: fatal });- }+for (const track of session.snapshot.tracks) {+ const { status, errors, output } = track.provenance;+ if (errors.length > 0) problems.push({ track: track.label, errors });+ else if (status === "unresolved") problems.push({ track: track.label, unresolved: output });}-const refused = (built.refused ?? []).map((r) => ({ refused: r }));-const unserved = (built.unserved ?? []).length > 0 ? { unserved: built.unserved } : undefined;-const all = [...problems, ...refused, ...(unserved === undefined ? [] : [unserved])];-if (all.length === 0) {- console.log("preview-check: every track built.");+if (problems.length === 0) {+ console.log(`preview-check: every Track resolved (${session.snapshot.tracks.length}).`);process.exit(0);}-for (const item of all) console.log(JSON.stringify(item, null, 2));+for (const item of problems) console.log(JSON.stringify(item, null, 2));process.exit(1);diff --git a/docs/guide/packages.md b/docs/guide/packages.mdindex 7a4633cb..f7c0b20e 100644--- a/docs/guide/packages.md+++ b/docs/guide/packages.md@@ -151,7 +151,7 @@ queues, stores, credentials and process lifecycle; they never define author synt```text@hypit/cli generic command engine (requires explicit Distribution)@hypit/video-cli video command application (selects Markup compiler, no built-in author packages)-@hypit/svml-playground development preview for a Source, never runs a Provider+@hypit/studio development preview for a Run, never runs a Provider```## Dependency rulesdiff --git a/docs/quickstart.md b/docs/quickstart.mdindex ab55568f..0d35941b 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -84,7 +84,7 @@ Operations and external Needs that a Build would use. It never starts a ProviderOpen the three source files next:- [`main.svml`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/main.svml) — the video;-- [`studio.svs`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/studio.svs) — reusable visual Recipes;+- [`recipes.svs`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/recipes.svs) — reusable visual Recipes;- [`build.svrun`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/build.svrun) — the requested output.## 3. Understand the project files@@ -94,7 +94,7 @@ A working video project normally has four authored or configured inputs:| File | Answers ||---|---|| `main.svml` | What video are you making? |-| `studio.svs` | Which reusable Recipe values does it use? |+| `recipes.svs` | Which reusable Recipe values does it use? || `build.svrun` | Which outputs and Candidates does this Run select? || `hypit.runtime.json` | Which machine, stores and Provider endpoints execute it? |diff --git a/docs/quickstart/composition.md b/docs/quickstart/composition.mdindex 993bb616..d82de83c 100644--- a/docs/quickstart/composition.md+++ b/docs/quickstart/composition.md@@ -22,7 +22,7 @@ and layers them by stacking order.```svml<space:Canvas id="vertical" width="1080" height="1920"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={captions.track}/>@@ -131,7 +131,7 @@ The complete data flow from Script to rendered video. This example is based on<import as="program" from="@hypit/program-space@1"/><import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/>- <import as="studio" source="./studio.svs"/>+ <import as="recipes" source="./recipes.svs"/><!-- 1. Script: the semantic truth --><script id="story">@@ -176,14 +176,14 @@ The complete data flow from Script to rendered video. This example is based on<whisperx:SemanticTake id="opening-semantic" narrative={story}segment={story.segment.opening} media={take-media.media}/><speech:Track id="speech"- visual-frame={speech-frame} visual-appearance={studio.speech.visual} visual-z="0">+ visual-frame={speech-frame} visual-appearance={recipes.speech.visual} visual-z="0"><speech:Take source={opening-semantic.take}/></speech:Track><!-- 4. Tracks: captions, Media, text --><fonts:Stack id="caption-font" family="inter" weight="700" style="normal"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>- <caption-fine:Style id="base-caption" recipe={studio.caption.base} font={caption-font}/>+ <caption-fine:Style id="base-caption" recipe={recipes.caption.base} font={caption-font}/><caption:Program id="caption-program" display={story.caption}default={base-caption}/><caption-ai:Planner id="cue-plan" display={story.caption}@@ -192,9 +192,9 @@ The complete data flow from Script to rendered video. This example is based on<media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item media={motion-media.media} during={story.selection.demo}- frame={card-frame} appearance={studio.media.card} motion={studio.motion.card}/>+ frame={card-frame} appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track>- <text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+ <text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING@@ -203,7 +203,7 @@ The complete data flow from Script to rendered video. This example is based on<!-- 5. Film: compose all tracks --><film:Film id="main" canvas={vertical} semantic={speech.semantic}- appearance={studio.film.vertical}>+ appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>@@ -221,7 +221,7 @@ The complete data flow from Script to rendered video. This example is based onits parent is `left="10%" right="90%"`, not `left="10%" right="10%"` — the second resolves to zerowidth and is rejected.-### Stylesheet (`studio.svs`)+### Stylesheet (`recipes.svs`)```svs<?svml using="@hypit/svs@1"?>diff --git a/docs/quickstart/generation.md b/docs/quickstart/generation.mdindex a9c03923..7070b179 100644--- a/docs/quickstart/generation.md+++ b/docs/quickstart/generation.md@@ -58,7 +58,7 @@ duration is computed locally from pronunciation units and a delivery-density pol```svml<estimate:Speech id="hook-duration"source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/>```| Attribute | Required | Description |@@ -226,7 +226,7 @@ spoken verbatim. Write a freeform English prompt only when none of the seven Kit</text:Value><text:Render id="demo-prompt"template={broll-kit.broll-v1}- recipe={studio.broll.product-demo}>+ recipe={recipes.broll.product-demo}><text:Set name="story" text={product-story}/></text:Render>@@ -277,7 +277,7 @@ the authored dialogue and optional per-take action as dynamic Text edges:<text:Render id="interview-prompt"template={interview-kit.street-interview-v1}- recipe={studio.interview.street}>+ recipe={recipes.interview.street}><text:Set name="dialogue" text={story.segment.interview.dialogue}/><text:Set name="action" text={interview-action}/></text:Render>@@ -312,7 +312,7 @@ module. The result enters Seedance through the same explicit `prompt` edge as an<text:Render id="hook-prompt"template={speaker-kit.speaker-v1}- recipe={studio.speaker.host}>+ recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.hook.dialogue}/><text:Set name="action" text={hook-action}/></text:Render>@@ -326,7 +326,7 @@ module. The result enters Seedance through the same explicit `prompt` edge as an</seedance:ReferenceVideo>```-`speaker-v1.svs` selects its own Text Template Frontend. `studio.svs` supplies the named axis values;+`speaker-v1.svs` selects its own Text Template Frontend. `recipes.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.@@ -339,7 +339,7 @@ A two-take setup with estimated durations feeding explicit Text assembly and See<import as="estimate" from="@hypit/estimate@1"/><import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/><import as="speaker-kit" source="./kits/speaker-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/>@@ -347,17 +347,17 @@ A two-take setup with estimated durations feeding explicit Text assembly and See<media:Audio id="presenter-voice" src="./assets/presenter-voice.mp3"/><estimate:Speech id="hook-duration"- source={story.segment.hook.speech} policy={studio.speech.normal}/>+ source={story.segment.hook.speech} policy={recipes.speech.normal}/><estimate:Speech id="meeting-duration"- source={story.segment.meeting.speech} policy={studio.speech.normal}/>+ source={story.segment.meeting.speech} policy={recipes.speech.normal}/><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:Render id="hook-prompt" template={speaker-kit.speaker-v1} recipe={recipes.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:Render id="meeting-prompt" template={speaker-kit.speaker-v1} recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.meeting.dialogue}/><text:Set name="action" text={meeting-action}/></text:Render>diff --git a/docs/quickstart/preview.md b/docs/quickstart/preview.mdindex 1c32debd..7afa55d8 100644--- a/docs/quickstart/preview.md+++ b/docs/quickstart/preview.md@@ -1,133 +1,123 @@---title: Live Preview-description: Read a Source as a timeline before anything has been generated.+description: Read a Run whose material exists as an editable timeline.---# Live Preview-Everything up to this point has been declarative: a Script, some Recipes, a request for a generated-shot. None of it has produced a picture, and a Seedance take costs money and minutes.+**Hypit Studio** opens a Run, traces its Film or Render target back to the projections it can edit,+and draws them — the code on the right, the picture top-left, a timeline bottom-left. It never+writes anything but the Author SVML, and it never calls a Provider.-The **SVML Playground** reads the Source itself and draws it — the code on the right, the picture-top-left, a timeline bottom-left. It never writes, and it never calls a Provider.+That last clause is the one to read twice. Studio builds only what it can derive deterministically+from Candidates the Run already supplies, so **a Source that still declares ungenerated shots will+not open.** Studio is where you inspect and adjust a programme whose material exists; it is not a+way to look at one before the material does.```bash-pnpm svml:playground -- --source examples/all-components-preview/main.svml+pnpm studio -- --run path/to/build.svrun# ➜ http://localhost:5179/```+::: warning No example in this repository currently opens+Every Run Source under `examples/` is either pre-generation — its shots still need Seedance, GPT+Image, WhisperX or caption planning — or depends on footage under `examples/**/assets/`, which is+not committed. Both cases refuse. Point Studio at a Run of your own whose outputs are satisfied.+:::+| Argument | Meaning || --- | --- |-| `--source <main.svml>` | The Author Source to read. Required. |-| `--run <build.svrun>` | A Run Source, read for material and timings it already names. |-| `--runtime <hypit.runtime.json>` | Where material earlier Builds produced is kept. Only a Source that reuses an accepted shot through `<build-record>` needs one. |+| `--run <build.svrun>` | The Run Source to open. Required. Studio reads the Author SVML back out of it. |+| `--runtime <hypit.runtime.json>` | Where material earlier Builds produced is kept. Only a Run that reuses an accepted shot through `<build-record>` needs one. |+| `--workspace <directory>` | Defaults to the directory holding the Run. || `--port <number>` | Defaults to `5179`. |-Both optional arguments are additive. With neither, the Playground still runs on a directory holding-nothing but `main.svml` and its `.svs` style sheet — no Runtime Profile and no Build.+The unit of work is the Run, not the `.svml`. What a Source is read *with* — which files stand for+which outputs, which Build records are reused — is an authoring decision, and the Run Source is+where that decision is written down. See [Run Source & Builds](./run).::: tip Stop the previous server before starting another-A second Playground silently takes another port, and you end up reading a stale preview while+A second Studio silently takes another port, and you end up reading a stale preview whiledescribing a new one. Stop the old one first:```bash-pkill -f svml-playground || true+pkill -f "@hypit/studio" || true```-Use `--port` when you genuinely want two Sources side by side.+Use `--port` when you genuinely want two Runs side by side.:::-## Why it can draw a video nobody has made+## What Studio will and will not do-A Track cannot be built without the material it places. Refusing to draw anything until every shot-exists would make the preview useless for exactly the part of the work it is meant for, so the-Playground separates what it **knows** from what it **assumes**, and says which is which.+Studio builds the deterministic closure of the Run and nothing else. Opening it never invokes a+Provider and never creates a Build, so every projection it draws was either supplied by the Run as+a Candidate or derived deterministically from one.**Everything structural is real.** Placement Frames, padding, stacking order, motion and the Track-layout are computed by the same functions a build calls, from your Source and your style sheet. A-card in the wrong part of the frame is wrong here too.--**Timings are estimated** until a build has aligned real audio. Word durations come from-`@hypit/estimate`, the same syllable model the pipeline uses before generation. An estimated-timeline is a proportion, not a prediction — real cut points move once WhisperX has run.--**Missing material stands in**, and each stand-in is announced rather than presented as fact:+layout are computed by the same functions a build calls, from your Source and your Recipes. A card+in the wrong part of the frame is wrong here too.-| Missing | Shown instead |-| --- | --- |-| A generated shot that names a picture | That picture, held for the length the shot declares |-| A generated shot that names nothing | A black frame of the programme's shape |-| Caption phrasing nobody has planned | The words cut every few Atoms, in the Program's own runs |--The first row is the one that makes this worth opening early. Take the chain from-[Media & Generation](./generation):+**Timings are measured, always.** The timeline comes from the `SemanticTrack` — the aligned Takes+themselves — so a cut point you see is the cut point a build produces. There is no estimated mode.-```svml-<gpt:Image id="presenter" prompt={look} aspect-ratio="9:16" resolution="2K"/>+**Nothing stands in.** Studio has no placeholder pictures, no black frames and no fabricated+timings. This is the deliberate half of the trade: rather than draw something it cannot justify and+label it, Studio refuses to open and says what is missing.-<seedance:ReferenceVideo id="take-opening" model="mini" prompt={direction} duration="8">- <seedance:Reference image={presenter.image}/>-</seedance:ReferenceVideo>+```+Studio cannot start:+- the Studio projection closure requires unresolved capabilities: seedance.video```-`take-opening.video` does not exist until Seedance runs. But the Source says what it will be made-from — `presenter.image` — and how long it will last: `duration="8"`. So the Playground draws the-reference picture, held for eight seconds, in the Frame the take is placed in.--That is not the take. It is the right subject, in the right shape, for the right length, which is-enough to answer whether the framing works and whether the cutaway lands where the speech needs it —-**before** the picture flows into video generation, and before you have paid for a take that turns-out to be cut at the wrong moment.--A declared duration is honoured wherever one exists. Where none does, words are placed at an-ordinary delivery pace and the remaining time is divided evenly.--This applies to every Track the Source produces, whichever package made it. The Playground asks the-compiled Source for its exports and builds the ones typed `VisualTrack` or `AudioTrack`, so a-package that grows a new kind of Track appears here without the Playground being taught about it.--Drawing stand-ins needs `ffmpeg` on your `PATH`. Without it the shots stay unmade and the Tracks say-so, rather than the preview pretending they were drawn.--## Reading the badges--The header carries two separate claims, because they answer different questions:+The refusals you are likely to meet:-| Badge | Meaning |+| Refusal | What it means || --- | --- |-| `timing: measured` | Read from a completed build's aligned transcript. |-| `timing: estimated` | Derived from the Script text at normal delivery pace. |-| `picture: measured` | Every element shows real material. |-| `picture: estimated` | Some shots have not been made, and stand in. |+| `the Run Source has no target; Studio requires Film or Render` | Nothing in the Run names a finished programme to trace back from. |+| `the Run target is not a Film or Render output from the current SVML` | The target named does not exist in the Source as it stands now. |+| `Film has no traceable SemanticTake / Speech Track chain` | There is no semantic spine to hang a timeline on. |+| `the Studio projection closure requires unresolved capabilities: …` | A Track needs a Provider to exist. Satisfy it in the Run, or accept a Build. |+| `Render target … is an opaque media Candidate; Studio needs the current Film graph` | The Run points at a finished video file. Studio edits the graph, not the output. |-A Source can have all its footage and still have an estimated timeline: where a cut lands is a-question about speech, not about files. On the timeline itself each Track says whether it was-`made`, is a `stand-in`, or is a black frame, and selecting a clip names the reason in full.+The fourth is the one you will meet most, and it is all-or-nothing: one unresolved capability+anywhere in the closure refuses the whole Run, rather than that Track alone going dark. So a+programme becomes openable in one step — when the last of its generated outputs is satisfied — and+not gradually.## Supplying material you already have-As material accumulates, the same preview gets more real without any change to `main.svml`. What a-Source is read with is an authoring decision, so it is made in a Run Source — see-[Run Source & Builds](./run):-```svml<file id="take-1" type="@hypit/artifact@1#BlobArtifact"from="./assets/take-1.mp4" media-type="video/mp4"/><satisfy output="take-opening.video" candidate="take-1"/>```-Point the Playground at it with `--run`, and that shot stops standing in. A `<build-record>`-candidate names something an earlier Build made rather than a path, and needs `--runtime` to find-it; without one, that shot alone is refused **by name** and everything else still draws.+A `<build-record>` candidate names something an earlier Build made rather than a path, and needs+`--runtime` to find it.++## Reading the badges++The header carries two claims, and on a Run that opens they are both `measured` — that is what+opening means. They stay in the interface because they say *what* they are standing for:++| Badge | Meaning |+| --- | --- |+| `timing: measured` | Read from the aligned `SemanticTrack`. |+| `picture: measured` | Every element shows real material. |++Selecting a Track names the Candidate that produced it and where it came from — the Run, the Source,+or neither.## When an agent is doing the workIf you are working through the [Hypit skill](https://github.com/hypit-ai/hypit/blob/main/.agents/skills/hypit/SKILL.md),-the agent starts the Playground for you and sends you the link after each step that changes the-Source — a Script edit, a Frame moved, a B-roll placed, a Recipe adjusted.+the agent starts Studio for you and sends you the link after a step that changes the Source — a+Script edit, a Frame moved, a B-roll placed, a Recipe adjusted — once the Run it is working against+opens at all.-Reading a diff is not the same as seeing where a cutaway lands, and this is the cheapest moment to-say "that card is too high" — before a single Provider has run.+Reading a diff is not the same as seeing where a cutaway lands. On a Run whose material exists this+is the cheapest moment to say "that card is too high"; on one whose shots are still declared, the+agent has nothing to show you and will say so rather than send a link.## Moving around it@@ -144,6 +134,19 @@ inside is outlined as it passes, whether or not a Track was hung on it.Drag the ruler to scrub. `Space` plays and pauses, `←` and `→` step one frame with `Shift` for ten,`Home` and `End` jump to the ends, and `Esc` clears the selection.+## The semantic lane++Above the Tracks is a lane that is not a Track: the `SemanticTrack` itself, drawn as one block per+Segment. It is the skeleton every other row is positioned against.++At the whole-programme view a Segment is the useful unit, so that is all it draws. Zoom in and once+a Segment has enough width its words open into a real sub-lane beneath it, the way a pattern opens+into a piano roll. Double-click a Segment to zoom to it; the toolbar has explicit zoom controls, and+`Ctrl`-wheel pinches.++Clicking a word moves the playhead to the frame that word starts on, which is the fastest way to+answer "does this cutaway land on the right sentence".+## SoundHyperFrames renders a silent picture on purpose: programme audio is a separate Track the mediadiff --git a/docs/quickstart/styles.md b/docs/quickstart/styles.mdindex a108de07..00bc95ea 100644--- a/docs/quickstart/styles.md+++ b/docs/quickstart/styles.md@@ -38,10 +38,10 @@ immutable typed Records that consuming components validate and interpret.Import an SVS file in your `.svml` source with a namespace prefix:```svml-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/>```-Then reference individual Recipes via `{studio.film.vertical}`, `{studio.caption.primary}`, etc.+Then reference individual Recipes via `{recipes.film.vertical}`, `{recipes.caption.primary}`, etc.The prefix comes from the `as=` attribute; the path comes from `namespace.name` in the sheet.## Film@@ -63,7 +63,7 @@ Referenced by `film:Film` via the `appearance` attribute:```svml<space:Canvas id="vertical" width="1080" height="1920"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}>```## Caption Fine@@ -107,7 +107,7 @@ Record to the Fine Style. Family, weight and style have one source of truth on t```svml<fonts:Face id="caption-font" family="inter" weight="600" style="normal"/>-<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}+<caption-fine:Style id="primary-caption" recipe={recipes.caption.dialogue}font={caption-font}/>```@@ -141,9 +141,9 @@ Then assign them via `caption:Program`:```svml<fonts:Stack id="caption-font" family="inter" weight="600" style="normal"/>-<caption-fine:Style id="default-caption" recipe={studio.caption.dialogue} font={caption-font}/>-<caption-fine:Style id="alice-caption" recipe={studio.caption.alice} font={caption-font}/>-<caption-fine:Style id="bob-caption" recipe={studio.caption.bob} font={caption-font}/>+<caption-fine:Style id="default-caption" recipe={recipes.caption.dialogue} font={caption-font}/>+<caption-fine:Style id="alice-caption" recipe={recipes.caption.alice} font={caption-font}/>+<caption-fine:Style id="bob-caption" recipe={recipes.caption.bob} font={caption-font}/><caption:Program id="caption-program" display={story.caption} default={default-caption}><caption:Use role="ALICE" style={alice-caption}/><caption:Use role="BOB" style={bob-caption}/>@@ -202,7 +202,7 @@ Position remains an explicit graph edge:left="8%" top="20%" right="92%" bottom="68%"/><media-track:Item video={product-motion.video}during={story.selection.demo} frame={product-frame}- appearance={studio.media.product} motion={studio.motion.product}/>+ appearance={recipes.media.product} motion={recipes.motion.product}/>```## Text@@ -233,7 +233,7 @@ Compiled with exact font bytes into a `text:Style`, then referenced by a concret```svml<fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING</text:Area>@@ -272,7 +272,7 @@ Referenced by `estimate:Speech` via the `policy` attribute:```svml<estimate:Speech id="hook-duration" source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/>```## Speaker Text Template@@ -302,7 +302,7 @@ Referenced by `text:Render` together with the Kit's Template:```svml<text:Render id="hook-prompt"- template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>+ template={speaker-kit.speaker-v1} recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.hook.dialogue}/><text:Set name="action" text={hook-action}/></text:Render>@@ -373,7 +373,7 @@ bytes into content-addressed font values. It performs no download during a buildnever guesses a font:```svml-<caption-fine:Style id="dialogue" recipe={studio.caption.dialogue}+<caption-fine:Style id="dialogue" recipe={recipes.caption.dialogue}font={caption-fonts}/>```@@ -394,7 +394,7 @@ Brand and custom fonts remain explicit author assets rather than additions to th## Combination example-A complete `studio.svs` file for a four-take talking-head project:+A complete `recipes.svs` file for a four-take talking-head project:```svs<?svml using="@hypit/svs@1"?>@@ -441,16 +441,16 @@ A complete `studio.svs` file for a four-take talking-head project:This file is imported once in the `.svml` source and its values are referenced throughout:```svml-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/><estimate:Speech id="hook-duration" source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/><text:Render id="hook-prompt" template={speaker-kit.speaker-v1}- recipe={studio.speaker.host}>...</text:Render>+ recipe={recipes.speaker.host}>...</text:Render>-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>+<caption-fine:Style id="primary-caption" recipe={recipes.caption.primary} font={caption-font}/><space:Canvas id="vertical" width="720" height="1280"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}>```diff --git a/docs/quickstart/timing.md b/docs/quickstart/timing.mdindex c9c4a6d6..7b078fe1 100644--- a/docs/quickstart/timing.md+++ b/docs/quickstart/timing.md@@ -20,7 +20,7 @@ before it enters the Track.<import as="whisperx" from="@hypit/whisperx@1"/><import as="speech" from="@hypit/speech-track@1"/><import as="space" from="@hypit/spatial@1"/>-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/>```## Normalize each take@@ -69,7 +69,7 @@ facets from the same items:<speech:Track id="speech"visual-frame={speech-frame}- visual-appearance={studio.speech.visual}+ visual-appearance={recipes.speech.visual}visual-z="0"><speech:Take source={opening-semantic.take}/><speech:Take source={answer-semantic.take}/>@@ -96,7 +96,7 @@ deterministic Track:<media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item image={card.image} extent={card-extent}during={story.selection.demo} frame={card-frame}- appearance={studio.media.card} motion={studio.motion.card}/>+ appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track><caption-fine:Track id="captions"@@ -107,7 +107,7 @@ deterministic Track:plan={caption-plan.plan}/><film:Film id="main" canvas={vertical}- semantic={speech.semantic} appearance={studio.film.vertical}>+ semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>diff --git a/docs/quickstart/tracks.md b/docs/quickstart/tracks.mdindex 308bfef1..a81057e2 100644--- a/docs/quickstart/tracks.md+++ b/docs/quickstart/tracks.md@@ -69,7 +69,7 @@ caption.primary {<fonts:Stack id="caption-fonts" family="inter" weight="700" style="normal" emoji="color"><fonts:Fallback family="noto-sans-sc" weight="700" style="normal"/></fonts:Stack>-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}+<caption-fine:Style id="primary-caption" recipe={recipes.caption.primary}font={caption-fonts}/>```@@ -178,8 +178,8 @@ Placement is an explicit Spatial Frame edge; appearance and motion remain reusab<media-track:Track id="product-broll" semantic={speech.semantic} canvas={vertical}><media-track:Item video={product-motion.video} frame={product-frame}during={story.selection.product-demo}- appearance={studio.media.product}- motion={studio.motion.product}/>+ appearance={recipes.media.product}+ motion={recipes.motion.product}/></media-track:Track>```@@ -264,7 +264,7 @@ Container for text items.<space:Frame id="title-frame" within={vertical}left="6%" top="6%" right="94%" bottom="16%"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="title" placement={title-frame} style={title-style} during="program">EDIT MEANING, NOT TIMELINES@@ -301,7 +301,7 @@ The `during` attribute accepts either the literal string `"program"` for the comor a Selection reference for semantic timing:```svml-<text:Style id="callout-style" recipe={studio.text.callout} font={title-font}/>+<text:Style id="callout-style" recipe={recipes.text.callout} font={title-font}/><text:Track id="callout" semantic={speech.semantic}><text:Area id="callout-copy" placement={callout-frame}style={callout-style} during={story.selection.callout}>@@ -374,7 +374,7 @@ Each variant takes its own, at least one, and ids must be unique within a board.`icon` and `stack`. `TopThree` takes at most three.```svml-<ranking:ColumnStyle id="board-style" recipe={studio.ranking.board} font={ui-font}/>+<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/><ranking:Column id="board" semantic={speech.semantic} frame={board-frame}during={story.selection.board} triggers={story.moment.place} terminal={story.moment.done}style={board-style}>@@ -424,7 +424,7 @@ give both and it is refused. `size`, `color`, `align`, `block` and `padding` are```svml<space:Frame id="deck-frame" within={vertical} left="44%" top="60%" right="98%" bottom="88%"/><deck:DepthStack id="deck" semantic={speech.semantic} canvas={vertical}- frame={deck-frame} appearance={studio.deck.stack} until={story.moment.done}>+ frame={deck-frame} appearance={recipes.deck.stack} until={story.moment.done}><deck:Card id="card-spatial" source={icon-spatial} extent={square} at={story.moment.deal-one}/><deck:Card id="card-type" source={icon-type} extent={square} at={story.moment.deal-two}/></deck:DepthStack>@@ -493,7 +493,7 @@ optional `author`, `header` and `meta` each take a string or a Text reference, `image, and there is no `z`: stacking order comes from the recipe's `stack-order`.```svml-<comment:Style id="social" recipe={studio.comment} font={ui-font}/>+<comment:Style id="social" recipe={recipes.comment} font={ui-font}/><comment:Track id="comments" canvas={vertical} semantic={speech.semantic}><comment:Sticker id="one" frame={comment-frame} style={social} avatar={viewer-avatar}author="@viewer" meta="Featured" during={story.selection.reaction}>@@ -523,7 +523,7 @@ All four track families together in one source file:<!-- Captions: primary style for all text --><fonts:Stack id="caption-font" family="inter" weight="700" style="normal"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<caption-fine:Style id="base-caption" recipe={studio.caption.base} font={caption-font}/>+<caption-fine:Style id="base-caption" recipe={recipes.caption.base} font={caption-font}/><caption:Program id="caption-program" display={story.caption} default={base-caption}/><caption-ai:Planner id="cue-plan" display={story.caption}program={caption-program} model="gemini-2.5-flash"/>@@ -539,11 +539,11 @@ All four track families together in one source file:<!-- Media: one ordinary Item used editorially as B-roll --><media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item video={motion.video} frame={card-frame}- during={story.selection.demo} appearance={studio.media.card} motion={studio.motion.card}/>+ during={story.selection.demo} appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track><!-- Text: persistent title overlay -->-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING@@ -560,7 +560,7 @@ All four track families together in one source file:</audio:Track><!-- All peer tracks feed into Film -->-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>diff --git a/docs/zh/guide/packages.md b/docs/zh/guide/packages.mdindex 15c89e14..294e9889 100644--- a/docs/zh/guide/packages.md+++ b/docs/zh/guide/packages.md@@ -145,7 +145,7 @@ Frontend;不存在一个认识全部语法的中央解析器。```text@hypit/cli generic command engine (requires explicit Distribution)@hypit/video-cli video command application (selects Markup compiler, no built-in author packages)-@hypit/svml-playground development preview for a Source, never runs a Provider+@hypit/studio development preview for a Run, never runs a Provider```## 依赖规则diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.mdindex 87cb02b2..747b0f84 100644--- a/docs/zh/quickstart.md+++ b/docs/zh/quickstart.md@@ -81,7 +81,7 @@ Operations 与外部 Needs。它绝不会启动 Provider。现在可以直接打开三份源码阅读:- [`main.svml`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/main.svml):视频本身;-- [`studio.svs`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/studio.svs):可复用的视觉 Recipe;+- [`recipes.svs`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/recipes.svs):可复用的视觉 Recipe;- [`build.svrun`](https://github.com/hypit-ai/hypit/blob/main/examples/talking-film-graph-check/build.svrun):这次要求得到的输出。## 3. 认识项目里的文件@@ -91,7 +91,7 @@ Operations 与外部 Needs。它绝不会启动 Provider。| 文件 | 回答的问题 ||---|---|| `main.svml` | 要做的是什么视频? |-| `studio.svs` | 使用哪些可复用的 Recipe 值? |+| `recipes.svs` | 使用哪些可复用的 Recipe 值? || `build.svrun` | 这一次 Run 要哪些输出、选择哪些 Candidate? || `hypit.runtime.json` | 在哪台机器、哪些 Store 和 Provider Endpoint 上执行? |diff --git a/docs/zh/quickstart/composition.md b/docs/zh/quickstart/composition.mdindex 55322f4b..f0f4f9b7 100644--- a/docs/zh/quickstart/composition.md+++ b/docs/zh/quickstart/composition.md@@ -21,7 +21,7 @@ Composition。然后渲染器将该 Composition 编译为 MP4 视频。```svml<space:Canvas id="vertical" width="1080" height="1920"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={captions.track}/>@@ -127,7 +127,7 @@ Build Target,也可以直接接到媒体裁切、音频/帧提取或模型参<import as="program" from="@hypit/program-space@1"/><import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/>- <import as="studio" source="./studio.svs"/>+ <import as="recipes" source="./recipes.svs"/><!-- 1. Script: the semantic truth --><script id="story">@@ -172,14 +172,14 @@ Build Target,也可以直接接到媒体裁切、音频/帧提取或模型参<whisperx:SemanticTake id="opening-semantic" narrative={story}segment={story.segment.opening} media={take-media.media}/><speech:Track id="speech"- visual-frame={speech-frame} visual-appearance={studio.speech.visual} visual-z="0">+ visual-frame={speech-frame} visual-appearance={recipes.speech.visual} visual-z="0"><speech:Take source={opening-semantic.take}/></speech:Track><!-- 4. Tracks: captions, Media, text --><fonts:Stack id="caption-font" family="inter" weight="700" style="normal"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>- <caption-fine:Style id="base-caption" recipe={studio.caption.base} font={caption-font}/>+ <caption-fine:Style id="base-caption" recipe={recipes.caption.base} font={caption-font}/><caption:Program id="caption-program" display={story.caption}default={base-caption}/><caption-ai:Planner id="cue-plan" display={story.caption}@@ -188,9 +188,9 @@ Build Target,也可以直接接到媒体裁切、音频/帧提取或模型参<media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item media={motion-media.media} during={story.selection.demo}- frame={card-frame} appearance={studio.media.card} motion={studio.motion.card}/>+ frame={card-frame} appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track>- <text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+ <text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING@@ -199,7 +199,7 @@ Build Target,也可以直接接到媒体裁切、音频/帧提取或模型参<!-- 5. Film: compose all tracks --><film:Film id="main" canvas={vertical} semantic={speech.semantic}- appearance={studio.film.vertical}>+ appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>@@ -215,7 +215,7 @@ Build Target,也可以直接接到媒体裁切、音频/帧提取或模型参`right` 与 `bottom` 是绝对的边位置,不是内缩量。一个占父级中间 80% 的 Frame 写作 `left="10%" right="90%"`,而不是 `left="10%" right="10%"`——后者解出的宽度为零,会被拒绝。-### 样式表 (`studio.svs`)+### 样式表 (`recipes.svs`)```svs<?svml using="@hypit/svs@1"?>diff --git a/docs/zh/quickstart/generation.md b/docs/zh/quickstart/generation.mdindex d3f47d6b..6a3a3f11 100644--- a/docs/zh/quickstart/generation.md+++ b/docs/zh/quickstart/generation.md@@ -55,7 +55,7 @@ description: 声明媒体资源并使用 Seedance 生成视频。```svml<estimate:Speech id="hook-duration"source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/>```| 属性 | 必填 | 说明 |@@ -201,7 +201,7 @@ Endpoint,不会改变作者图。</text:Value><text:Render id="demo-prompt"template={broll-kit.broll-v1}- recipe={studio.broll.product-demo}>+ recipe={recipes.broll.product-demo}><text:Set name="story" text={product-story}/></text:Render>@@ -242,7 +242,7 @@ Endpoint,不会改变作者图。<text:Render id="interview-prompt"template={interview-kit.street-interview-v1}- recipe={studio.interview.street}>+ recipe={recipes.interview.street}><text:Set name="dialogue" text={story.segment.interview.dialogue}/><text:Set name="action" text={interview-action}/></text:Render>@@ -274,7 +274,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一<text:Render id="hook-prompt"template={speaker-kit.speaker-v1}- recipe={studio.speaker.host}>+ recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.hook.dialogue}/><text:Set name="action" text={hook-action}/></text:Render>@@ -287,7 +287,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一</seedance:ReferenceVideo>```-`speaker-v1.svs` 自己选择 Text Template Frontend。`studio.svs` 提供具名轴值,`dialogue` 与+`speaker-v1.svs` 自己选择 Text Template Frontend。`recipes.svs` 提供具名轴值,`dialogue` 与`action` 保持为普通图输入。Kit 和 Text 都不选择模型、参考素材或 Provider。## 组合示例@@ -299,7 +299,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一<import as="estimate" from="@hypit/estimate@1"/><import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/><import as="speaker-kit" source="./kits/speaker-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/>@@ -307,17 +307,17 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一<media:Audio id="presenter-voice" src="./assets/presenter-voice.mp3"/><estimate:Speech id="hook-duration"- source={story.segment.hook.speech} policy={studio.speech.normal}/>+ source={story.segment.hook.speech} policy={recipes.speech.normal}/><estimate:Speech id="meeting-duration"- source={story.segment.meeting.speech} policy={studio.speech.normal}/>+ source={story.segment.meeting.speech} policy={recipes.speech.normal}/><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:Render id="hook-prompt" template={speaker-kit.speaker-v1} recipe={recipes.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:Render id="meeting-prompt" template={speaker-kit.speaker-v1} recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.meeting.dialogue}/><text:Set name="action" text={meeting-action}/></text:Render>diff --git a/docs/zh/quickstart/preview.md b/docs/zh/quickstart/preview.mdindex 1c91ca50..2581e909 100644--- a/docs/zh/quickstart/preview.md+++ b/docs/zh/quickstart/preview.md@@ -1,104 +1,95 @@---title: 实时预览-description: 在任何素材生成之前,把 Source 当作时间线来读。+description: 把一个素材已经存在的 Run 当作可编辑的时间线来读。---# 实时预览-到这里为止的一切都还是声明式的:一段 Script、若干 Recipe、一个生成镜头的请求。它们都还没有产出任何画面,而一次 Seedance 生成既花钱又花时间。+**Hypit Studio** 打开一个 Run,把它的 Film 或 Render target 回溯到自己能编辑的那些投影,然后画出来——右侧是代码,左上是画面,左下是时间线。除了 Author SVML 之外它不写入任何东西,也从不调用 Provider。-**SVML Playground** 直接读取 Source 并把它画出来——右侧是代码,左上是画面,左下是时间线。它从不写入任何东西,也从不调用 Provider。+最后这半句值得读两遍。Studio 只构建它能从 Run 已经提供的 Candidate 确定性推导出来的东西,因此**一份仍然声明着未生成镜头的 Source 是打不开的**。Studio 是你检视并调整一个素材已经存在的节目的地方;它不是一个在素材出现之前先看看它的办法。```bash-pnpm svml:playground -- --source examples/all-components-preview/main.svml+pnpm studio -- --run path/to/build.svrun# ➜ http://localhost:5179/```+::: warning 本仓库当前没有任何示例能打开+`examples/` 下的每一个 Run Source,要么处于生成之前——它的镜头仍然需要 Seedance、GPT Image、WhisperX 或字幕规划——要么依赖 `examples/**/assets/` 下的素材,而那些素材并未提交。这两种情况都会被拒绝。请把 Studio 指向你自己的、output 已被满足的 Run。+:::+| 参数 | 含义 || --- | --- |-| `--source <main.svml>` | 要读取的 Author Source。必填。 |-| `--run <build.svrun>` | 一个 Run Source,从中读取它已经指名的素材与时序。 |-| `--runtime <hypit.runtime.json>` | 早先 Build 产出的素材存放在哪里。只有通过 `<build-record>` 复用已接受镜头的 Source 才需要。 |+| `--run <build.svrun>` | 要打开的 Run Source。必填。Studio 会从它里面把 Author SVML 读回来。 |+| `--runtime <hypit.runtime.json>` | 早先 Build 产出的素材存放在哪里。只有通过 `<build-record>` 复用已接受镜头的 Run 才需要。 |+| `--workspace <directory>` | 默认为 Run 所在的目录。 || `--port <number>` | 默认 `5179`。 |-两个可选参数是叠加的。两个都不给时,Playground 依然能在一个只有 `main.svml` 和 `.svs` 样式表的目录上运行,不需要 Runtime Profile 或已有 Build。+工作单元是 Run,不是 `.svml`。用什么去读一个 Source——哪些文件顶替哪些 output、复用哪些 Build 记录——是一项创作决策,而 Run Source 正是写下这项决策的地方。见 [Run Source 与 Build](./run)。::: tip 启动新服务前先停掉上一个-第二个 Playground 会悄悄占用另一个端口,于是你一边读着过期的预览,一边描述着新的改动。先把旧的停掉:+第二个 Studio 会悄悄占用另一个端口,于是你一边读着过期的预览,一边描述着新的改动。先把旧的停掉:```bash-pkill -f svml-playground || true+pkill -f "@hypit/studio" || true```-确实想并排看两个 Source 时,再用 `--port`。+确实想并排看两个 Run 时,再用 `--port`。:::-## 为什么它能画出还没人做出来的视频--一条 Track 离开它所安放的素材就无法构建。但如果非要等到每个镜头都存在才肯画,预览恰好会在它最该派上用场的那个阶段变得毫无用处。所以 Playground 把**已知**的和**假设**的分开,并明确告诉你哪个是哪个。--**所有结构性的东西都是真的。** Placement Frame、padding、堆叠顺序、动效以及 Track 布局,都由构建时调用的同一批函数、从你的 Source 和样式表算出。一张卡片如果在画面里的位置不对,在这里同样是不对的。+## Studio 会做什么,不会做什么-**时序是估算的**,直到某次构建对真实音频做过对齐为止。词的时长来自 `@hypit/estimate`——正是流水线在生成之前使用的那套音节模型。估算出的时间线是一种比例,而不是一个预言:等 WhisperX 对齐了真实音频,实际的剪切点会移动。+Studio 只构建 Run 的确定性闭包,除此之外什么都不做。打开 Studio 从不调用 Provider,也从不创建 Build,因此它画出的每一个投影,要么由 Run 作为 Candidate 提供,要么可以从这样一个 Candidate 确定性地推导出来。-**缺失的素材会有替身**,而且每个替身都会被明确标注,不会被当作事实呈现:+**所有结构性的东西都是真的。** Placement Frame、padding、堆叠顺序、动效以及 Track 布局,都由构建时调用的同一批函数、从你的 Source 和 Recipe 算出。一张卡片如果在画面里的位置不对,在这里同样是不对的。-| 缺失的 | 代之以 |-| --- | --- |-| 一个指名了参考图片的生成镜头 | 那张图片,按镜头声明的时长持续 |-| 一个什么都没指名的生成镜头 | 一帧符合节目画幅的黑场 |-| 无人规划过的字幕分句 | 按 Program 自己的 run,每隔几个 Atom 切一次 |--第一行正是值得你尽早打开它的理由。看[媒体与生成](./generation)里的这条链路:+**时序永远是实测的。** 时间线来自 `SemanticTrack`——也就是已对齐的那些 Take 本身——所以你看到的剪切点就是构建产出的剪切点。这里没有估算模式。-```svml-<gpt:Image id="presenter" prompt={look} aspect-ratio="9:16" resolution="2K"/>+**没有任何东西会有替身。** Studio 没有占位图片、没有黑场、也不会伪造时序。这是这笔交易里刻意的那一半:与其画出一个自己无法交代的东西再给它贴个标签,Studio 宁可拒绝打开,并说清楚缺的是什么。-<seedance:ReferenceVideo id="take-opening" model="mini" prompt={direction} duration="8">- <seedance:Reference image={presenter.image}/>-</seedance:ReferenceVideo>+```+Studio cannot start:+- the Studio projection closure requires unresolved capabilities: seedance.video```-在 Seedance 跑起来之前,`take-opening.video` 并不存在。但 Source 说清楚了它将由什么做成——`presenter.image`——以及它会持续多久:`duration="8"`。于是 Playground 就把那张参考图画出来,持续八秒,放在这个镜头所在的 Frame 里。--那不是最终的镜头。但它是**正确的主体、正确的画幅、正确的时长**,这已经足以回答构图对不对、以及这个空镜是否落在语音需要它的位置上——**在**这张图片流入视频生成之前,也在你为一个剪切点其实不对的镜头付钱之前。--凡是存在声明时长的地方都会被遵守。没有声明的地方,词按正常语速安放,剩余时间平均分配。--这对 Source 产出的每一条 Track 都成立,无论它出自哪个包。Playground 向编译后的 Source 索要它的 export,并构建其中类型为 `VisualTrack` 或 `AudioTrack` 的那些——因此某个包新长出一种 Track 时,它会直接出现在这里,不需要 Playground 事先认识它。--绘制替身需要 `PATH` 上有 `ffmpeg`。没有它,这些镜头就保持未绘制状态、Track 会如实说明,而不是假装它们已经画好了。--## 读懂徽章--顶部有两个彼此独立的判断,因为它们回答的是不同的问题:+你比较可能遇到的几种拒绝:-| 徽章 | 含义 |+| 拒绝 | 含义 || --- | --- |-| `timing: measured` | 读自一次已完成构建的对齐转录。 |-| `timing: estimated` | 由 Script 文本按正常语速推导。 |-| `picture: measured` | 每个元素展示的都是真实素材。 |-| `picture: estimated` | 有镜头尚未做出来,正由替身顶替。 |+| `the Run Source has no target; Studio requires Film or Render` | Run 里没有任何东西指名一个可供回溯的成片。 |+| `the Run target is not a Film or Render output from the current SVML` | 指名的 target 在当前这份 Source 里并不存在。 |+| `Film has no traceable SemanticTake / Speech Track chain` | 没有语义骨架可以用来挂时间线。 |+| `the Studio projection closure requires unresolved capabilities: …` | 某条 Track 需要 Provider 才能存在。要么在 Run 里满足它,要么接受一次 Build。 |+| `Render target … is an opaque media Candidate; Studio needs the current Film graph` | Run 指向的是一个已经渲染好的视频文件。Studio 编辑的是图,不是产物。 |-一个 Source 完全可能素材齐备、时间线却仍是估算的:剪切点落在哪里是关于语音的问题,不是关于文件的问题。在时间线上,每条 Track 会标明自己是 `made`、是 `stand-in`、还是黑场;选中某个片段则会完整说明原因。+第四条是你最常遇到的,而且它是全有或全无:闭包里任何一个未解决的 capability 都会拒绝整个 Run,而不是让那一条 Track 单独变黑。所以一个节目是在某一步里整个变得可打开的——当它最后一个生成 output 被满足时——而不是逐步变得可打开。## 提供你已经有的素材-随着素材逐渐积累,同一个预览会越来越接近真实,而 `main.svml` 一个字都不用改。用什么去读一个 Source 是一项创作决策,因此它写在 Run Source 里——见 [Run Source 与 Build](./run):-```svml<file id="take-1" type="@hypit/artifact@1#BlobArtifact"from="./assets/take-1.mp4" media-type="video/mp4"/><satisfy output="take-opening.video" candidate="take-1"/>```-用 `--run` 指向它,那个镜头就不再是替身。`<build-record>` 候选指名的是早先某次 Build 做出的东西而非一个路径,需要 `--runtime` 才能找到;没有 `--runtime` 时,**只有那一个**镜头会被指名拒绝,其余一切照常绘制。+`<build-record>` 候选指名的是早先某次 Build 做出的东西而非一个路径,需要 `--runtime` 才能找到。++## 读懂徽章++顶部有两个判断;在一个能被打开的 Run 上它们都是 `measured`——能打开本身就意味着如此。它们仍然留在界面里,是因为它们说明了自己代表的是什么:++| 徽章 | 含义 |+| --- | --- |+| `timing: measured` | 读自已对齐的 `SemanticTrack`。 |+| `picture: measured` | 每个元素展示的都是真实素材。 |++选中一条 Track,会说明是哪个 Candidate 产出了它,以及它从哪里来——Run、Source,或者都不是。## 当由 agent 来做这件事时-如果你正在通过 [Hypit skill](https://github.com/hypit-ai/hypit/blob/main/.agents/skills/hypit/SKILL.md)工作,那么每当某个步骤改动了 Source——改了 Script、移了 Frame、放了 B-roll、调了 Recipe——agent 会为你启动 Playground 并把链接发给你。+如果你正在通过 [Hypit skill](https://github.com/hypit-ai/hypit/blob/main/.agents/skills/hypit/SKILL.md)工作,那么当某个步骤改动了 Source——改了 Script、移了 Frame、放了 B-roll、调了 Recipe——只要它所针对的那个 Run 本身能打开,agent 就会为你启动 Studio 并把链接发给你。-读 diff 和亲眼看见空镜落在哪里不是一回事,而此刻正是说出"那张卡片太靠上了"的最便宜的时机——在任何一个 Provider 跑起来之前。+读 diff 和亲眼看见空镜落在哪里不是一回事。在一个素材已经存在的 Run 上,此刻正是说出"那张卡片太靠上了"的最便宜的时机;而在一个镜头仍然只是被声明的 Run 上,agent 没有任何东西可以给你看,它会如实说明,而不是发一个链接过来。## 在里面移动@@ -108,6 +99,14 @@ Segment 包着 Selection,Selection 还能再包 Selection。每一层有自己拖动标尺即可走带。`Space` 播放与暂停,`←` 和 `→` 步进一帧、按住 `Shift` 为十帧,`Home` 和 `End` 跳到首尾,`Esc` 清除选中。+## 语义泳道++Track 之上有一条并不是 Track 的泳道:`SemanticTrack` 本身,每个 Segment 画成一块。它是其余每一行赖以定位的骨架。++在整片视图下,Segment 就是有用的单位,所以它只画到这一层。放大之后,一旦某个 Segment 有了足够的宽度,它的词就会在它下方展开成一条真正的子泳道,就像一个 pattern 展开成钢琴卷帘那样。双击一个 Segment 可以缩放到它;工具栏上有显式的缩放控件,`Ctrl` + 滚轮可以捏合缩放。++点击一个词,播放头会移到那个词开始的帧——这是回答"这个空镜是不是落在正确的那句话上"最快的方式。+## 声音HyperFrames 刻意只渲染无声画面:programme audio 是一条独立的 Track,由 media pipeline 在最后 mux 进去。但把 B-roll 对着语音安放,前提就是能听见那句话,所以走带播放时 Speech Track 自己的素材允许发声。Cutaway 保持静音——除非显式声明要带音频,这和真实构建里的行为一致。喇叭按钮可以关掉。diff --git a/docs/zh/quickstart/styles.md b/docs/zh/quickstart/styles.mdindex 8485cfef..cd264f21 100644--- a/docs/zh/quickstart/styles.md+++ b/docs/zh/quickstart/styles.md@@ -35,10 +35,10 @@ SVS(`.svs`)文件使用类 CSS 语法定义可复用的类型化配置值。在 `.svml` 源文件中通过命名空间前缀导入 SVS 文件:```svml-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/>```-然后通过 `{studio.film.vertical}`、`{studio.caption.primary}` 等方式引用各个 Recipe。前缀来自 `as=` 属性;路径来自样式表中的 `namespace.name`。+然后通过 `{recipes.film.vertical}`、`{recipes.caption.primary}` 等方式引用各个 Recipe。前缀来自 `as=` 属性;路径来自样式表中的 `namespace.name`。## Film@@ -59,7 +59,7 @@ film.vertical {```svml<space:Canvas id="vertical" width="1080" height="1920"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}>```## Caption Fine@@ -103,7 +103,7 @@ Style。字体家族、字重和字形只在这条精确字体边上声明一次```svml<fonts:Face id="caption-font" family="inter" weight="600" style="normal"/>-<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}+<caption-fine:Style id="primary-caption" recipe={recipes.caption.dialogue}font={caption-font}/>```@@ -137,9 +137,9 @@ caption.bob {```svml<fonts:Stack id="caption-font" family="inter" weight="600" style="normal"/>-<caption-fine:Style id="default-caption" recipe={studio.caption.dialogue} font={caption-font}/>-<caption-fine:Style id="alice-caption" recipe={studio.caption.alice} font={caption-font}/>-<caption-fine:Style id="bob-caption" recipe={studio.caption.bob} font={caption-font}/>+<caption-fine:Style id="default-caption" recipe={recipes.caption.dialogue} font={caption-font}/>+<caption-fine:Style id="alice-caption" recipe={recipes.caption.alice} font={caption-font}/>+<caption-fine:Style id="bob-caption" recipe={recipes.caption.bob} font={caption-font}/><caption:Program id="caption-program" display={story.caption} default={default-caption}><caption:Use role="ALICE" style={alice-caption}/><caption:Use role="BOB" style={bob-caption}/>@@ -197,7 +197,7 @@ motion.product {left="8%" top="20%" right="92%" bottom="68%"/><media-track:Item video={product-motion.video}during={story.selection.demo} frame={product-frame}- appearance={studio.media.product} motion={studio.motion.product}/>+ appearance={recipes.media.product} motion={recipes.motion.product}/>```## 文本@@ -228,7 +228,7 @@ text.title {```svml<fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING</text:Area>@@ -264,7 +264,7 @@ speech.normal {```svml<estimate:Speech id="hook-duration" source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/>```## Speaker Text Template@@ -292,7 +292,7 @@ speaker.host {```svml<text:Render id="hook-prompt"- template={speaker-kit.speaker-v1} recipe={studio.speaker.host}>+ template={speaker-kit.speaker-v1} recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.hook.dialogue}/><text:Set name="action" text={hook-action}/></text:Render>@@ -354,7 +354,7 @@ SVS 描述字体策略,但不选择或打开字体字节。常用开源字体也不猜字体:```svml-<caption-fine:Style id="dialogue" recipe={studio.caption.dialogue}+<caption-fine:Style id="dialogue" recipe={recipes.caption.dialogue}font={caption-fonts}/>```@@ -371,7 +371,7 @@ Caption Recipe 不再重复家族、字重或字形。CJK 与 Emoji 即使由多## 综合示例-一个完整的 `studio.svs` 文件,用于四段式说话人头像项目:+一个完整的 `recipes.svs` 文件,用于四段式说话人头像项目:```svs<?svml using="@hypit/svs@1"?>@@ -418,16 +418,16 @@ Caption Recipe 不再重复家族、字重或字形。CJK 与 Emoji 即使由多该文件在 `.svml` 源文件中导入一次,其值在整个文件中被引用:```svml-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/><estimate:Speech id="hook-duration" source={story.segment.hook.speech}- policy={studio.speech.normal}/>+ policy={recipes.speech.normal}/><text:Render id="hook-prompt" template={speaker-kit.speaker-v1}- recipe={studio.speaker.host}>...</text:Render>+ recipe={recipes.speaker.host}>...</text:Render>-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>+<caption-fine:Style id="primary-caption" recipe={recipes.caption.primary} font={caption-font}/><space:Canvas id="vertical" width="720" height="1280"/>-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}>```diff --git a/docs/zh/quickstart/timing.md b/docs/zh/quickstart/timing.mdindex 0f6c9aea..d31781d7 100644--- a/docs/zh/quickstart/timing.md+++ b/docs/zh/quickstart/timing.md@@ -19,7 +19,7 @@ Hypit 的时间真相是 `SemanticTrack`。它按 Segment 粒度构建:<import as="whisperx" from="@hypit/whisperx@1"/><import as="speech" from="@hypit/speech-track@1"/><import as="space" from="@hypit/spatial@1"/>-<import as="studio" source="./studio.svs"/>+<import as="recipes" source="./recipes.svs"/>```## 逐 Take 归一化@@ -64,7 +64,7 @@ SemanticTrack 内的所有 Take 共享作者显式声明的 Clock。<speech:Track id="speech"visual-frame={speech-frame}- visual-appearance={studio.speech.visual}+ visual-appearance={recipes.speech.visual}visual-z="0"><speech:Take source={opening-semantic.take}/><speech:Take source={answer-semantic.take}/>@@ -89,7 +89,7 @@ SemanticTrack,并在构建确定性 Track 时把这些身份投影成帧:<media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item image={card.image} extent={card-extent}during={story.selection.demo} frame={card-frame}- appearance={studio.media.card} motion={studio.motion.card}/>+ appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track><caption-fine:Track id="captions"@@ -100,7 +100,7 @@ SemanticTrack,并在构建确定性 Track 时把这些身份投影成帧:plan={caption-plan.plan}/><film:Film id="main" canvas={vertical}- semantic={speech.semantic} appearance={studio.film.vertical}>+ semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>diff --git a/docs/zh/quickstart/tracks.md b/docs/zh/quickstart/tracks.mdindex 59d203db..c54c5158 100644--- a/docs/zh/quickstart/tracks.md+++ b/docs/zh/quickstart/tracks.md@@ -53,7 +53,7 @@ caption.primary {<fonts:Stack id="caption-fonts" family="inter" weight="700" style="normal" emoji="color"><fonts:Fallback family="noto-sans-sc" weight="700" style="normal"/></fonts:Stack>-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}+<caption-fine:Style id="primary-caption" recipe={recipes.caption.primary}font={caption-fonts}/>```@@ -135,8 +135,8 @@ B-roll 是通用 Media Track 的一种剪辑用途,不是独立 Track 家族<media-track:Track id="product-broll" semantic={speech.semantic} canvas={vertical}><media-track:Item video={product-motion.video} frame={product-frame}during={story.selection.product-demo}- appearance={studio.media.product}- motion={studio.motion.product}/>+ appearance={recipes.media.product}+ motion={recipes.motion.product}/></media-track:Track>```@@ -211,7 +211,7 @@ Track 都会作为独立输入进入 Film。输出 `{music-bed.track}` 是普通<space:Frame id="title-frame" within={vertical}left="6%" top="6%" right="94%" bottom="16%"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="title" placement={title-frame} style={title-style} during="program">EDIT MEANING, NOT TIMELINES@@ -247,7 +247,7 @@ Track 都会作为独立输入进入 Film。输出 `{music-bed.track}` 是普通`during` 属性接受字面字符串 `"program"`(表示完整 ProgramSpace),或用于语义计时的 Selection 引用:```svml-<text:Style id="callout-style" recipe={studio.text.callout} font={title-font}/>+<text:Style id="callout-style" recipe={recipes.text.callout} font={title-font}/><text:Track id="callout" semantic={speech.semantic}><text:Area id="callout-copy" placement={callout-frame}style={callout-style} during={story.selection.callout}>@@ -312,7 +312,7 @@ Run 时,继续使用内联 `P`/`Span`/`Break`。- **`ColumnItem`** 与 **`TopThreeItem`** —— `label`(必填:字符串或 Text 引用),可选 `icon` 与 `stack`。`TopThree` 最多三条。```svml-<ranking:ColumnStyle id="board-style" recipe={studio.ranking.board} font={ui-font}/>+<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/><ranking:Column id="board" semantic={speech.semantic} frame={board-frame}during={story.selection.board} triggers={story.moment.place} terminal={story.moment.done}style={board-style}>@@ -355,7 +355,7 @@ DepthStack 的直接子元素,自闭合,至少一张,按书写顺序发出```svml<space:Frame id="deck-frame" within={vertical} left="44%" top="60%" right="98%" bottom="88%"/><deck:DepthStack id="deck" semantic={speech.semantic} canvas={vertical}- frame={deck-frame} appearance={studio.deck.stack} until={story.moment.done}>+ frame={deck-frame} appearance={recipes.deck.stack} until={story.moment.done}><deck:Card id="card-spatial" source={icon-spatial} extent={square} at={story.moment.deal-one}/><deck:Card id="card-type" source={icon-type} extent={square} at={story.moment.deal-two}/></deck:DepthStack>@@ -408,7 +408,7 @@ DepthStack 的直接子元素,自闭合,至少一张,按书写顺序发出`comment:Sticker` 必填 `id`、`frame` 与 `style`,时间窗与上面的屏幕叠加层相同。它的文案来自 `comment=` 属性或元素自身的文字,两个都给会被拒绝。可选的 `author`、`header` 与 `meta` 各接受字符串或 Text 引用,`avatar` 接受一张图片;这里没有 `z`,层叠顺序来自 recipe 的 `stack-order`。```svml-<comment:Style id="social" recipe={studio.comment} font={ui-font}/>+<comment:Style id="social" recipe={recipes.comment} font={ui-font}/><comment:Track id="comments" canvas={vertical} semantic={speech.semantic}><comment:Sticker id="one" frame={comment-frame} style={social} avatar={viewer-avatar}author="@viewer" meta="Featured" during={story.selection.reaction}>@@ -438,7 +438,7 @@ DepthStack 的直接子元素,自闭合,至少一张,按书写顺序发出<!-- Captions: primary style for all text --><fonts:Stack id="caption-font" family="inter" weight="700" style="normal"/><fonts:Stack id="title-font" family="inter" weight="900" style="normal"/>-<caption-fine:Style id="base-caption" recipe={studio.caption.base} font={caption-font}/>+<caption-fine:Style id="base-caption" recipe={recipes.caption.base} font={caption-font}/><caption:Program id="caption-program" display={story.caption} default={base-caption}/><caption-ai:Planner id="cue-plan" display={story.caption}program={caption-program} model="gemini-2.5-flash"/>@@ -454,11 +454,11 @@ DepthStack 的直接子元素,自闭合,至少一张,按书写顺序发出<!-- Media:Selection 期间显示一个普通 Item --><media-track:Track id="cards" semantic={speech.semantic} canvas={vertical}><media-track:Item video={motion.video} frame={card-frame}- during={story.selection.demo} appearance={studio.media.card} motion={studio.motion.card}/>+ during={story.selection.demo} appearance={recipes.media.card} motion={recipes.motion.card}/></media-track:Track><!-- Text: persistent title overlay -->-<text:Style id="title-style" recipe={studio.text.title} font={title-font}/>+<text:Style id="title-style" recipe={recipes.text.title} font={title-font}/><text:Track id="titles" semantic={speech.semantic}><text:Area id="meaning" placement={title-frame} style={title-style} during="program">MEANING@@ -475,7 +475,7 @@ DepthStack 的直接子元素,自闭合,至少一张,按书写顺序发出</audio:Track><!-- 所有对等 Track 都进入 Film -->-<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>+<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}><film:Track source={speech.visual}/><film:Track source={speech.audio}/><film:Track source={cards.visual}/>diff --git a/examples/all-components-preview/README.md b/examples/all-components-preview/README.mdindex bc4105a4..6f41c687 100644--- a/examples/all-components-preview/README.md+++ b/examples/all-components-preview/README.md@@ -4,15 +4,22 @@ One Source that writes every kind of Track at once: speech, a ranking board, amedia card, a screen treatment, typography and captions, over a take nobody hasgenerated yet.-It exists to be previewed rather than built. A Source in this state — no-footage, no recording, no caption plan — is the state most Sources are in for-most of their life, and it is the state the preview has to be honest about:+It exists to exercise the vocabulary: every Track kind declared once, in one+Source, so a change that breaks one of them breaks something a reader can see.+`hypit check` proves it is legal, and the graph-shape tests read it.++**It does not currently open in Studio.** Studio builds only the deterministic+closure of a Run, so a Source in this state — no footage, no recording, no+caption plan — refuses:```-pnpm svml:playground -- --source examples/all-components-preview/main.svml+Studio cannot start:+- the Studio projection closure requires unresolved capabilities:+ @hypit/caption-gemini@1#gemini-caption-planning, @hypit/gpt-image@1#gpt-image-2,+ @hypit/media-pipeline@1#inspect-media, @hypit/media-pipeline@1#normalize-media,+ @hypit/media-pipeline@1#project-speech-evidence-audio,+ @hypit/seedance@1#seedance-2-mini, @hypit/whisperx@1#whisperx-alignment```-Every Track builds. The takes stand in as the reference picture they name, held-for the length they declare; the words are placed at an ordinary delivery pace;-the captions are cut every few words because nothing has phrased them. All three-are reported as estimates rather than shown as fact.+Opening it means satisfying those outputs in a Run Source, or accepting a Build+that produced them. See `docs/quickstart/preview.md`.diff --git a/examples/talking-film-broll-preview/README.md b/examples/talking-film-broll-preview/README.mdindex 4208d795..8436b52b 100644--- a/examples/talking-film-broll-preview/README.md+++ b/examples/talking-film-broll-preview/README.md@@ -1,11 +1,7 @@# talking-film-broll-preview-A vertical talking film with two B-roll inserts on one Media Track, written to be-read by the SVML Playground:--```bash-pnpm svml:playground -- --source examples/talking-film-broll-preview/main.svml-```+A vertical talking film with two B-roll inserts on one Media Track, written so+that a placement mistake is visible by eye.## What it demonstrates@@ -17,8 +13,8 @@ lay them out.dimension, so a coordinate mistake is visible rather than accidentally correct.**Frame versus content box.** `media.card` is rounded and padded; `media.wide` is-flush with a border. The Playground draws the Placement Frame and the painted-content box separately, and only the first Item has an inset.+flush with a border. Studio draws the Placement Frame and the painted content box+separately, and only the first Item has an inset.**Motion.** `motion.card` slides in and fades out, so the box moves across thefirst frames of `broll-one` and holds still for `broll-two`, which declares none.@@ -32,5 +28,8 @@ insets. `card-a` spans `left="8%"` to `right="92%"` — 86.4px to 993.6px of a## Building itThe Source is complete, so it builds like any other example once a Runtime-Profile and credentials are in place. Nothing here is required to preview it: the-Playground reads `main.svml` and `studio.svs` alone.+Profile and credentials are in place.++There is no Run Source here, and Studio requires one — so this example cannot be+opened in Studio as it stands. Write a `.svrun` that satisfies its generated+outputs first; see `docs/quickstart/preview.md`.diff --git a/packages/caption-fine/README.md b/packages/caption-fine/README.mdindex 5e147bec..b13d18fd 100644--- a/packages/caption-fine/README.md+++ b/packages/caption-fine/README.md@@ -13,7 +13,7 @@ declares no planning fields and has no `important`, random sizing or inferred Wo<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>-<fine:Style id="primary" recipe={studio.caption.primary} font={caption-fonts}/>+<fine:Style id="primary" recipe={recipes.caption.primary} font={caption-fonts}/><caption:Program id="captions" display={story.caption} default={primary}/>diff --git a/packages/caption-fine/src/manifest.ts b/packages/caption-fine/src/manifest.tsindex 14957e3e..178e40cf 100644--- a/packages/caption-fine/src/manifest.ts+++ b/packages/caption-fine/src/manifest.ts@@ -237,7 +237,7 @@ export const captionFineMarkupSurfaces = [] },],example: `<fonts:Stack id="caption-font" family="inter" weight="800" style="normal"/>-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>`,+<caption-fine:Style id="primary-caption" recipe={recipes.caption.primary} font={caption-font}/>`,notes: ["Referencing a font stack in `font` and writing `<Fallback>` children are both allowed; the stack's faces come first.","The Style is addressed by its own id, and the element accepts no text.",diff --git a/packages/caption/README.md b/packages/caption/README.mdindex 2617f9e4..2bde53f3 100644--- a/packages/caption/README.md+++ b/packages/caption/README.md@@ -12,8 +12,8 @@ It owns no Script parser, concrete font, box model, field meaning, renderer, LLMRuntime policy.```xml-<caption-fine:Style id="plain" recipe={studio.caption.plain} font={caption-font}/>-<caption-fine:Style id="impact" recipe={studio.caption.impact} font={caption-font}/>+<caption-fine:Style id="plain" recipe={recipes.caption.plain} font={caption-font}/>+<caption-fine:Style id="impact" recipe={recipes.caption.impact} font={caption-font}/><caption:Program id="captions" display={story.caption} default={plain}><caption:Use role="ALICE" style={impact}/>diff --git a/packages/deck-track/README.md b/packages/deck-track/README.mdindex 23de6b38..6e38b84d 100644--- a/packages/deck-track/README.md+++ b/packages/deck-track/README.md@@ -19,7 +19,7 @@ Media layer lowerer, but Deck is not a Media mode and exports only an ordinary pcanvas={vertical}frame={layout.proof-stack}until={story.selection.proof}- appearance={studio.deck.proof}+ appearance={recipes.deck.proof}><deck:Card id="proof-1" source={proof1.image} extent={proof1.extent}at={story.moment.proof1} label={proof-label-style}/>diff --git a/packages/deck-track/src/manifest.ts b/packages/deck-track/src/manifest.tsindex 99ffecef..2c84eb64 100644--- a/packages/deck-track/src/manifest.ts+++ b/packages/deck-track/src/manifest.ts@@ -391,7 +391,7 @@ export const depthStackMarkupSurfaces = [canvas={vertical}frame={layout.proof-stack}until={story.selection.proof}- appearance={studio.deck.proof}+ appearance={recipes.deck.proof}><deck:Card id="proof-1" source={proof1.image} extent={proof1.extent}at={story.moment.proof1} label={proof-label-style}/>diff --git a/packages/deck-track/test/deck-track.test.ts b/packages/deck-track/test/deck-track.test.tsindex eaaf6289..6718455e 100644--- a/packages/deck-track/test/deck-track.test.ts+++ b/packages/deck-track/test/deck-track.test.ts@@ -502,7 +502,7 @@ test("another Deck family can coexist by contributing only the existing VisualTrtest("SVS decoding exposes all documented depth, frame, motion and playback axes", () => {const value = decodeDepthStackSpec({- path: "studio.deck.proof",+ path: "recipes.deck.proof",properties: {"visible-previous": 3, "visible-next": 2, wrap: false,"previous-y-step": 24, "previous-scale-step": 0.93, "previous-rotation-mode": "alternate",diff --git a/packages/film/src/manifest.ts b/packages/film/src/manifest.tsindex 93d28e7a..5cf9ba44 100644--- a/packages/film/src/manifest.ts+++ b/packages/film/src/manifest.ts@@ -79,7 +79,7 @@ export const filmMarkupSurfaces = [{summary: "The assembled Composition, addressed as `<id>.composition`." },],example: [- '<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={studio.film.vertical}>',+ '<film:Film id="main" canvas={vertical} semantic={speech.semantic} appearance={recipes.film.vertical}>'," <film:Track source={speech.visual}/>"," <film:Track source={speech.audio}/>"," <film:Track source={captions.track}/>",diff --git a/packages/film/test/surface.test.ts b/packages/film/test/surface.test.tsindex 168e75a7..0253b7be 100644--- a/packages/film/test/surface.test.ts+++ b/packages/film/test/surface.test.ts@@ -138,10 +138,10 @@ async function compileFilm(options: { readonly styles?: string } = {}) {<import as="fixture" from="example.film-fixture@1"/><import as="film" from="@hypit/film@1"/><import as="space" from="@hypit/spatial@1"/>- <import as="studio" source="./recipes.svs"/>+ <import as="recipes" source="./recipes.svs"/><fixture:Inputs/><space:Canvas id="vertical" width="1080" height="1920"/>- <film:Film id="main" canvas={vertical} semantic={semantic} appearance={studio.film.vertical}>+ <film:Film id="main" canvas={vertical} semantic={semantic} appearance={recipes.film.vertical}><film:Track source={visual}/><film:Track source={audio}/></film:Film></svml>`),diff --git a/packages/fonts-open/README.md b/packages/fonts-open/README.mdindex 306a6a72..4c672b50 100644--- a/packages/fonts-open/README.md+++ b/packages/fonts-open/README.md@@ -30,7 +30,7 @@ intent into one reusable Author Graph value:<fonts:Fallback family="noto-sans-sc" weight="700" style="normal"/></fonts:Stack>-<caption-fine:Style id="caption" recipe={studio.caption.primary}+<caption-fine:Style id="caption" recipe={recipes.caption.primary}font={caption-fonts}/>```diff --git a/packages/markup/README.md b/packages/markup/README.mdindex 424690c2..a366db7c 100644--- a/packages/markup/README.md+++ b/packages/markup/README.md@@ -14,7 +14,7 @@ sandbox for third-party parser code.<?svml using="@hypit/markup@1"?><svml><import from="@hypit/script@1"/>- <import as="studio" source="./studio.svs"/>+ <import as="recipes" source="./recipes.svs"/><script id="story"><opening><ALICE>Hello.</opening>diff --git a/packages/media-track/src/manifest.ts b/packages/media-track/src/manifest.tsindex aab25484..9ce9e79c 100644--- a/packages/media-track/src/manifest.ts+++ b/packages/media-track/src/manifest.ts@@ -478,7 +478,7 @@ export const mediaTrackMarkupSurfaces = [{],example: `<media-track:Track id="cutaways" semantic={speech.semantic} canvas={vertical}><media-track:Item id="bags" video={cutaway-bags.video} during={story.selection.bags}- frame={full} appearance={studio.media.cutaway} motion={studio.motion.cut}/>+ frame={full} appearance={recipes.media.cutaway} motion={recipes.motion.cut}/></media-track:Track>`,notes: ["A Track requires at least one Item or Sequence and accepts no text content.",diff --git a/packages/ranking/src/manifest.ts b/packages/ranking/src/manifest.tsindex 5c78e35b..f45da6a4 100644--- a/packages/ranking/src/manifest.ts+++ b/packages/ranking/src/manifest.ts@@ -244,7 +244,7 @@ export const rankingMarkupSurfaces = [{ name: "sound", type: rankingTypes.soundStyle,summary: "The compiled sound Style, connected only when the board authors a sound." },],- example: `<ranking:TierBoardStyle id="tier-style" recipe={studio.ranking.tier} font={ui-font}/>`,+ example: `<ranking:TierBoardStyle id="tier-style" recipe={recipes.ranking.tier} font={ui-font}/>`,notes: ["The element is empty; it accepts no children and no text.","The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",@@ -338,7 +338,7 @@ export const rankingMarkupSurfaces = [{ name: "sound", type: rankingTypes.soundStyle,summary: "The compiled sound Style, connected only when the board authors a sound." },],- example: `<ranking:ColumnStyle id="board-style" recipe={studio.ranking.board} font={ui-font}/>`,+ example: `<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/>`,notes: ["The element is empty; it accepts no children and no text.","The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",@@ -409,7 +409,7 @@ export const rankingMarkupSurfaces = [{ name: "sound", type: rankingTypes.soundStyle,summary: "The compiled sound Style, connected only when the board authors a sound." },],- example: `<ranking:TopThreeStyle id="podium-style" recipe={studio.ranking.podium} font={ui-font}/>`,+ example: `<ranking:TopThreeStyle id="podium-style" recipe={recipes.ranking.podium} font={ui-font}/>`,notes: ["The element is empty; it accepts no children and no text.","The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",@@ -469,7 +469,7 @@ export const rankingMarkupSurfaces = [{ name: "audio", type: compositionTypes.audioTrack,summary: "The rendered board sound, published only when a sound is authored." },],- example: `<ranking:TierBoardStyle id="tier-style" recipe={studio.ranking.tier} font={ui-font}/>+ example: `<ranking:TierBoardStyle id="tier-style" recipe={recipes.ranking.tier} font={ui-font}/><ranking:TierBoard id="tiers" semantic={speech.semantic} frame={board-frame}during={story.selection.board} triggers={story.moment.place} terminal={story.moment.done}style={tier-style}>@@ -536,7 +536,7 @@ export const rankingMarkupSurfaces = [{ name: "audio", type: compositionTypes.audioTrack,summary: "The rendered board sound, published only when a sound is authored." },],- example: `<ranking:ColumnStyle id="board-style" recipe={studio.ranking.board} font={ui-font}/>+ example: `<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/><ranking:Column id="board" semantic={speech.semantic} canvas={vertical} frame={board-frame}during={story.segment.ranking}style={board-style}>@@ -600,7 +600,7 @@ export const rankingMarkupSurfaces = [{ name: "audio", type: compositionTypes.audioTrack,summary: "The rendered board sound, published only when a sound is authored." },],- example: `<ranking:TopThreeStyle id="podium-style" recipe={studio.ranking.podium} font={ui-font}/>+ example: `<ranking:TopThreeStyle id="podium-style" recipe={recipes.ranking.podium} font={ui-font}/><ranking:TopThree id="podium" semantic={speech.semantic} frame={board-frame}during={story.selection.board} triggers={story.moment.place} terminal={story.moment.done}style={podium-style}>diff --git a/packages/seedance-kits/README.md b/packages/seedance-kits/README.mdindex 408f4fef..be03518f 100644--- a/packages/seedance-kits/README.md+++ b/packages/seedance-kits/README.md@@ -16,7 +16,7 @@ ordinary explicit graph edges:<import as="seedance" from="@hypit/seedance@1"/><import as="broll-kit" source="./kits/broll-v1.svs"/>-<text:Render id="broll-prompt" template={broll-kit.broll-v1} recipe={studio.broll}>+<text:Render id="broll-prompt" template={broll-kit.broll-v1} recipe={recipes.broll}><text:Set name="story" text={copy.broll}/></text:Render>@@ -35,7 +35,7 @@ Speaker uses the same graph vocabulary. The Kit assumes `@image1` is the visible<text:Render id="hook-prompt"template={speaker-kit.speaker-v1}- recipe={studio.speaker.host}>+ recipe={recipes.speaker.host}><text:Set name="dialogue" text={story.segment.hook.dialogue}/><text:Set name="action" text={hook-action}/></text:Render>diff --git a/packages/speech-track/src/manifest.ts b/packages/speech-track/src/manifest.tsindex d7c02758..bc36425b 100644--- a/packages/speech-track/src/manifest.ts+++ b/packages/speech-track/src/manifest.ts@@ -122,7 +122,7 @@ export const speechTrackMarkupSurfaces = [{summary: "The speech sound clips projected from the SemanticTrack, an ordinary peer AudioTrack." },],example: `<speech:Track id="speech"- visual-frame={speech-frame} visual-appearance={studio.speech.visual} visual-z="0">+ visual-frame={speech-frame} visual-appearance={recipes.speech.visual} visual-z="0"><speech:Take source={opening.take}/><speech:Take source={closing.take}/></speech:Track>`,diff --git a/packages/text/README.md b/packages/text/README.mdindex 08a07b07..222ea154 100644--- a/packages/text/README.md+++ b/packages/text/README.md@@ -15,7 +15,7 @@ hiding the graph:<import as="ugc" source="./ugc-template.svs"/><text:Value id="extra">Keep the product readable.</text:Value>-<text:Render id="prompt" template={ugc.product-shot} recipe={studio.product-shot}>+<text:Render id="prompt" template={ugc.product-shot} recipe={recipes.product-shot}><text:Param name="camera" value="handheld"/><text:Param name="strict" value="true" type="boolean"/><text:Set name="dialogue" text={story.segment.hook.dialogue}/>diff --git a/packages/text/src/manifest.ts b/packages/text/src/manifest.tsindex ae16cc0e..1dc34d76 100644--- a/packages/text/src/manifest.ts+++ b/packages/text/src/manifest.ts@@ -108,7 +108,7 @@ export const textMarkupSurfaces = [{{ name: "", type: textTypes.text,summary: "The rendered Text, addressed by the element's own id." },],- example: `<text:Render id="prompt" template={ugc.product-shot} recipe={studio.product-shot}>+ example: `<text:Render id="prompt" template={ugc.product-shot} recipe={recipes.product-shot}><text:Param name="camera" value="handheld"/><text:Param name="strict" value="true" type="boolean"/><text:Set name="dialogue" text={story.segment.hook.dialogue}/>diff --git a/packages/text/test/text.test.ts b/packages/text/test/text.test.tsindex 4883b1bf..04e1c02b 100644--- a/packages/text/test/text.test.ts+++ b/packages/text/test/text.test.ts@@ -184,7 +184,7 @@ test("Text Render projects only declared SVS Recipe properties and lets explicit});const element = parseStructuredElement({name: "recipe.svml",- text: `<text:Render id="prompt" template={kit} recipe={studio.shot}>+ text: `<text:Render id="prompt" template={kit} recipe={recipes.shot}><text:Param name="energy" value="calm"/></text:Render>`,}, 0).element;@@ -193,11 +193,11 @@ test("Text Render projects only declared SVS Recipe properties and lets explicitpath: "kit", ref: { kind: "record", id: "kit" }, type: textTypes.template,record: { value: { kind: "inline", value: template } } as unknown as NonNullable<SurfaceResolvedReference["record"]>,}],- ["studio.shot", {- path: "studio.shot", ref: { kind: "record", id: "studio.shot" }, type: svsRecipeType,+ ["recipes.shot", {+ path: "recipes.shot", ref: { kind: "record", id: "recipes.shot" }, type: svsRecipeType,record: { value: { kind: "inline", value: {- path: "studio.shot",+ path: "recipes.shot",properties: { camera: "handheld", energy: "high", model: "mini" },} } } as unknown as NonNullable<SurfaceResolvedReference["record"]>,}],