Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

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.md
index 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 second
form 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 only
to 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:
```bash
pnpm check
pnpm hypit check path/to/main.svml
-pnpm hypit check path/to/studio.svs
+pnpm hypit check path/to/recipes.svs
pnpm 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 Studio
renders it. Run the preview check and repair until it passes with no failures — a build failure is
not a difference to weigh, it is work that is not finished, and it is not bounded by the loop's
attempt ceiling:
diff --git a/.agents/skills/hypit/references/playbooks/craft/b-roll.md b/.agents/skills/hypit/references/playbooks/craft/b-roll.md
index 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 it
Where 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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 declared
properties and admitted values.
- `build.svrun` references the Author Source and declares the required Targets with resolvable
dependencies.
@@ -61,13 +61,13 @@ Use existing checks only:
```bash
pnpm check
pnpm hypit check path/to/main.svml
-pnpm hypit check path/to/studio.svs
+pnpm hypit check path/to/recipes.svs
pnpm hypit check path/to/build.svrun
```
`hypit check` proves a Source is legal; it proves nothing about whether the tracks it declares can
actually 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 an
image, 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 pro
what is wrong, and you repair that. A track that cannot be built is not done, and this is not the
loop: the two-attempt ceiling governs how *well* a buildable element is tuned to the reference; it
does 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 they
were 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 has
diff --git a/.agents/skills/hypit/references/reconstruction/index.md b/.agents/skills/hypit/references/reconstruction/index.md
index 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-language
visual 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 Profile
that 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. Every
generation 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 later
step 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 something
delivered cannot be seen.
One exception, because it is not a generation of the video: a component's own surface — the field its
diff --git a/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md b/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md
index 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 font
resemble it — that route silently depends on the loop model having vision, and stops working the
moment 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 a
source 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.md
index 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.svrun
and 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.md
index 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, then
connect 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.mjs
index 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.md
index 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 rules
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 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 Provider
Open 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.md
index 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 on
its parent is `left="10%" right="90%"`, not `left="10%" right="10%"` — the second resolves to zero
width 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.md
index 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.md
index 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 while
describing 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 work
If 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".
+
## Sound
HyperFrames renders a silent picture on purpose: programme audio is a separate Track the media
diff --git a/docs/quickstart/styles.md b/docs/quickstart/styles.md
index 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 build
never 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.md
index 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.md
index 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 com
or 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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, a
media card, a screen treatment, typography and captions, over a take nobody has
generated 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.md
index 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 the
first 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 it
The 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.md
index 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.ts
index 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.md
index 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, LLM
Runtime 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.md
index 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 p
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/src/manifest.ts b/packages/deck-track/src/manifest.ts
index 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.ts
index 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 VisualTr
test("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.ts
index 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.ts
index 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.md
index 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.md
index 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.ts
index 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.ts
index 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.md
index 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.ts
index 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.md
index 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.ts
index 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.ts
index 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 explicit
path: "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"]>,
}],