Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: align examples with installed distribution
kashorin504e0ef6b2a2
diff --git a/docs/quickstart/generation.md b/docs/quickstart/generation.mdindex 9a5a1839..dcced0ea 100644--- a/docs/quickstart/generation.md+++ b/docs/quickstart/generation.md@@ -15,7 +15,7 @@ Every component shown here must be imported by its package specifier before use:<import as="mediaop" from="@hypit/media-pipeline@1"/><import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/>```## media:Image@@ -143,7 +143,7 @@ video and audio references within the model's declared limits.```svml<seedance:ReferenceVideo id="alice-take" model="mini"prompt={alice-direction}- duration={alice-duration.duration}+ duration="5"generate-audio="true"><seedance:Reference image={alice-reference}/><seedance:Reference audio={alice-voice}/>@@ -180,9 +180,10 @@ Runtime Endpoints for these exact Needs; neither changes the author graph.generic `text:Render` to produce the prompt, then connect that Text and the real media references tothe low-level Seedance Surface.-Copy only the selected Kit `.svs` files into the video project's `./kits/` directory. Import the-vendored project copy so the Kit bytes remain inside the Source Closure; do not reach back into the-installed Hypit Distribution from project source.+Import the selected public Kit Source from its installed package. The package manager or active+Distribution owns its installed version, while the Source Closure follows that explicit package+import. A production can instead author and import its own project Kit when the shared wording does+not fit the work.Read the[`@hypit/seedance-kits` guide](https://github.com/hypit-ai/hypit/blob/main/packages/seedance-kits/README.md)@@ -194,7 +195,7 @@ language for the selected model, keeping dialogue in the language it should be s```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="broll-kit" source="./kits/broll-v1.svs"/>+<import as="broll-kit" source="@hypit/seedance-kits/broll"/><text:Value id="product-story">Show the product opening, the primary feature activating, and the finished result in one readable sequence.@@ -207,7 +208,7 @@ language for the selected model, keeping dialogue in the language it should be s<seedance:ReferenceVideo id="demo" model="mini"prompt={demo-prompt}- duration={demo-duration.duration}+ duration="5"resolution="720p"aspect-ratio="9:16"generate-audio="false">@@ -244,7 +245,7 @@ camera changes and performance in its authored action, in the exact order they s```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="interview-kit" source="./kits/street-interview-v1.svs"/>+<import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><text:Value id="interview-action">Begin with the shared view from @image3 while A asks the question.@@ -259,7 +260,7 @@ camera changes and performance in its authored action, in the exact order they s</text:Render><seedance:ReferenceVideo id="interview-take" model="mini"- prompt={interview-prompt} duration={interview-duration.duration}+ prompt={interview-prompt} duration="8"resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={interviewer-view}/><seedance:Reference image={guest-view}/>@@ -282,7 +283,7 @@ module. The result enters Seedance through the same explicit `prompt` edge as an```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><text:Value id="hook-action">Begin with urgent direct eye contact, then let the final admission land more quietly.@@ -297,7 +298,7 @@ module. The result enters Seedance through the same explicit `prompt` edge as an<seedance:ReferenceVideo id="hook-take" model="mini"prompt={hook-prompt}- duration={hook-duration.duration}+ duration="8"resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-clean}/><seedance:Reference audio={presenter-voice}/>@@ -318,7 +319,7 @@ generation:<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/><import as="recipes" source="./recipes.svs"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/><media:Image id="presenter-alt" src="./assets/presenter-alt.png"/>@@ -337,12 +338,12 @@ generation:</text:Render><seedance:ReferenceVideo id="hook-take" model="mini" prompt={hook-prompt}- duration={hook-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">+ duration="8" resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-clean}/><seedance:Reference audio={presenter-voice}/></seedance:ReferenceVideo><seedance:ReferenceVideo id="meeting-take" model="mini" prompt={meeting-prompt}- duration={meeting-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">+ duration="6" resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-alt}/><seedance:Reference audio={presenter-voice}/></seedance:ReferenceVideo>diff --git a/docs/quickstart/run.md b/docs/quickstart/run.mdindex 9fd9e5d0..ecb712ef 100644--- a/docs/quickstart/run.md+++ b/docs/quickstart/run.md@@ -46,7 +46,7 @@ my-video/takes.svrun another executable intentionfinal.svrun final delivery intentionassets/ project-owned input media- kits/ optional vendored Recipe Kits+ kits/ optional project-authored Recipe Kitspackages/ optional project-local Author packagesoutput/ explicit exports for people and other toolshypit.runtime.json execution environmentdiff --git a/docs/zh/quickstart/generation.md b/docs/zh/quickstart/generation.mdindex 9a9ffc80..209c0c35 100644--- a/docs/zh/quickstart/generation.md+++ b/docs/zh/quickstart/generation.md@@ -12,10 +12,9 @@ description: 声明媒体资源并使用 Seedance 生成视频。```svml<import as="media" from="@hypit/media@1"/><import as="mediaop" from="@hypit/media-pipeline@1"/>-<import as="estimate" from="@hypit/estimate@1"/><import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/>```## media:Image@@ -129,7 +128,7 @@ Seedance 2.5 复用同样的 Surface,而不是由 Runtime 把别的模型偷```svml<seedance:ReferenceVideo id="alice-take" model="mini"prompt={alice-direction}- duration={alice-duration.duration}+ duration="5"generate-audio="true"><seedance:Reference image={alice-reference}/><seedance:Reference audio={alice-voice}/>@@ -161,7 +160,8 @@ Endpoint,不会改变作者图。`@hypit/seedance-kits` 包含七个纯数据 Text Template。Kit 不是模型包装器:先用通用`text:Render` 生成 prompt,再把该 Text 与真实媒体引用显式接入低层 Seedance Surface。-只把项目实际选择的 Kit `.svs` 文件复制进视频项目的 `./kits/` 目录,并导入这份项目内副本,使 Kit 字节保持在 Source Closure 内;项目源码不要反向引用已安装的 Hypit Distribution。+直接从已安装的包导入选中的公开 Kit Source。包管理器或当前 Distribution 管理实际安装版本,+Source Closure 沿着这个显式包导入读取内容。如果共享措辞不适合当前作品,也可以在项目里创作并导入自己的 Kit。创作前阅读[`@hypit/seedance-kits` 指南](https://github.com/hypit-ai/hypit/blob/main/packages/seedance-kits/README.md)@@ -170,7 +170,7 @@ Endpoint,不会改变作者图。```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="broll-kit" source="./kits/broll-v1.svs"/>+<import as="broll-kit" source="@hypit/seedance-kits/broll"/><text:Value id="product-story">Show the product opening, the primary feature activating, and the finished result in one readable sequence.@@ -182,7 +182,7 @@ Endpoint,不会改变作者图。</text:Render><seedance:ReferenceVideo id="demo" model="mini"- prompt={demo-prompt} duration={demo-duration.duration}+ prompt={demo-prompt} duration="5"resolution="720p" aspect-ratio="9:16" generate-audio="false"><seedance:Reference image={scene}/><seedance:Reference image={product}/>@@ -210,7 +210,7 @@ Endpoint,不会改变作者图。```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="interview-kit" source="./kits/street-interview-v1.svs"/>+<import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><text:Value id="interview-action">Begin with the shared view from @image3 while A asks the question.@@ -225,7 +225,7 @@ Endpoint,不会改变作者图。</text:Render><seedance:ReferenceVideo id="interview-take" model="mini"- prompt={interview-prompt} duration={interview-duration.duration}+ prompt={interview-prompt} duration="8"resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={interviewer-view}/><seedance:Reference image={guest-view}/>@@ -245,7 +245,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一```svml<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><text:Value id="hook-action">Begin with urgent direct eye contact, then let the final admission land more quietly.@@ -259,7 +259,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一</text:Render><seedance:ReferenceVideo id="hook-take" model="mini"- prompt={hook-prompt} duration={hook-duration.duration}+ prompt={hook-prompt} duration="8"resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-clean}/><seedance:Reference audio={presenter-voice}/>@@ -278,7 +278,7 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一<import as="text" from="@hypit/text@1"/><import as="seedance" from="@hypit/seedance@1"/><import as="recipes" source="./recipes.svs"/>-<import as="speaker-kit" source="./kits/speaker-v1.svs"/>+<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/><media:Image id="presenter-alt" src="./assets/presenter-alt.png"/>@@ -297,12 +297,12 @@ dialogue/action 由普通 Text 模块组装,结果再像其他生成任务一</text:Render><seedance:ReferenceVideo id="hook-take" model="mini" prompt={hook-prompt}- duration={hook-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">+ duration="8" resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-clean}/><seedance:Reference audio={presenter-voice}/></seedance:ReferenceVideo><seedance:ReferenceVideo id="meeting-take" model="mini" prompt={meeting-prompt}- duration={meeting-duration.duration} resolution="720p" aspect-ratio="9:16" generate-audio="true">+ duration="6" resolution="720p" aspect-ratio="9:16" generate-audio="true"><seedance:Reference image={presenter-alt}/><seedance:Reference audio={presenter-voice}/></seedance:ReferenceVideo>diff --git a/examples/interview/kits/street-interview-v1.svs b/examples/interview/kits/street-interview-v1.svsdeleted file mode 100644index c89c2d5d..00000000--- a/examples/interview/kits/street-interview-v1.svs+++ /dev/null@@ -1,49 +0,0 @@-<?svml using="@hypit/text/svs@1"?>--<sheet version="1" id="street-interview-v1">- text-template.street-interview-v1 {- separator: paragraph;- default-framing: soft-handheld;- default-pacing: compact;- default-performance: natural-street;- default-reaction: active;- default-gesture: natural;- }- text-template.street-interview-v1.block.base { kind: fixed; order: 10; text: "Create a realistic vertical street-interview clip from three final reference views."; }- text-template.street-interview-v1.block.reference { kind: fixed; order: 20; text: "REFERENCE CONTRACT: @image1 is interviewer A's final camera setup, @image2 is guest B's final camera setup, and @image3 is their final shared two-person camera setup. These three supplied setups are a closed shot set, not loose subject references: every authored shot selects exactly one of them as its complete frame, and cuts go directly from one supplied setup to another. Never invent a fourth camera position or pass through an intermediate framing. Within each selected setup, obey the FRAMING direction below. Preserve both identities, outfits, street location, props, microphone, lighting, camera sides, and spatial relationship."; }- text-template.street-interview-v1.block.roles { kind: fixed; order: 30; text: "ROLE MAP: A is the interviewer holding the microphone. B is the guest. Follow A: and B: exactly. A uses @audio1; B uses @audio2; only the current speaker moves their mouth."; }- text-template.street-interview-v1.block.microphone { kind: fixed; order: 40; text: "MICROPHONE CONTRACT: A always holds the same microphone. On A: lines it stays near A's mouth; on B: lines A naturally extends it toward B with realistic wrist, hand, and arm adjustments."; }- text-template.street-interview-v1.block.order { kind: fixed; order: 50; text: "Follow the authored ACTION DIRECTION in order for camera changes, performance, and physical interaction."; }-- text-template.street-interview-v1.block.framing { kind: axis; order: 60; parameter: framing; }- text-template.street-interview-v1.choice.framing.locked-scene { text: "FRAMING: locked camera. Hold the selected reference setup as the exact complete frame, preserving its composition, crop, scale, camera height, angle, and lens feel. No handheld drift, push, pan, tilt, zoom, reframe, orbit, or transitional camera movement."; }- text-template.street-interview-v1.choice.framing.soft-handheld { text: "FRAMING: realistic tiny handheld sway and operator breathing inside the selected camera setup while preserving its composition and camera side. Never turn that movement into a new crop, angle, camera position, or transition between setups."; }- text-template.street-interview-v1.choice.framing.subject-push { text: "FRAMING: make one modest push toward the active speaker inside the selected camera setup, then settle back to that same supplied composition. Never create another angle or camera position."; }-- text-template.street-interview-v1.block.pacing { kind: axis; order: 80; parameter: pacing; }- text-template.street-interview-v1.choice.pacing.measured { text: "PACING: measured question and answer delivery with a natural beat between thoughts."; }- text-template.street-interview-v1.choice.pacing.compact { text: "PACING: compact responsive handoffs while every line remains understandable."; }- text-template.street-interview-v1.choice.pacing.rapid-qna { text: "PACING: rapid street Q and A with crisp short-form momentum."; }- text-template.street-interview-v1.choice.pacing.varied-emphasis { text: "PACING: compact handoffs with important punchlines slowed slightly to land meaning."; }-- text-template.street-interview-v1.block.performance { kind: axis; order: 90; parameter: performance; }- text-template.street-interview-v1.choice.performance.natural-street { text: "PERFORMANCE: curious interviewer and candid, spontaneous, believable guest."; }- text-template.street-interview-v1.choice.performance.high-energy { text: "PERFORMANCE: vivid, fast, charismatic short-form street energy."; }- text-template.street-interview-v1.choice.performance.calm-expert { text: "PERFORMANCE: composed thoughtful guest and visibly attentive interviewer."; }- text-template.street-interview-v1.choice.performance.playful-skeptic { text: "PERFORMANCE: playful skepticism, teasing smiles, reversals, and small laughs."; }-- text-template.street-interview-v1.block.reaction { kind: axis; order: 100; parameter: reaction; }- text-template.street-interview-v1.choice.reaction.subtle { text: "REACTIONS: tiny nods, eye focus, breath, and small expression changes."; }- text-template.street-interview-v1.choice.reaction.active { text: "REACTIONS: visible nods, smiles, eye movement, and readable facial shifts."; }- text-template.street-interview-v1.choice.reaction.big { text: "REACTIONS: lively but realistic surprise, laughter, disbelief, and delight."; }-- text-template.street-interview-v1.block.gesture { kind: axis; order: 110; parameter: gesture; }- text-template.street-interview-v1.choice.gesture.restrained { text: "GESTURE: restrained body language; face, voice, and microphone movement carry meaning."; }- text-template.street-interview-v1.choice.gesture.compact { text: "GESTURE: compact semantic beats near the body, bag, and microphone."; }- text-template.street-interview-v1.choice.gesture.natural { text: "GESTURE: natural open palms, small points, nods, and posture shifts."; }- text-template.street-interview-v1.choice.gesture.expressive { text: "GESTURE: richer hand, shoulder, posture, and face changes while preserving candid realism."; }-- text-template.street-interview-v1.block.hygiene { kind: fixed; order: 120; text: "AUDIO AND TEXTURE: clean dialogue, natural outdoor room tone, stable faces, hands, microphone, and photoreal motion. Add no subtitles, captions, labels, cards, or overlays; preserve physical signs and text already in the scene."; }- text-template.street-interview-v1.block.dialogue { kind: slot; order: 130; slot: dialogue; optional: false; label: "DIALOGUE SCRIPT TO DELIVER:"; }- text-template.street-interview-v1.block.action { kind: slot; order: 140; slot: action; optional: true; label: "ACTION DIRECTION:"; }-</sheet>diff --git a/examples/interview/reference.svml b/examples/interview/reference.svmlindex 087e6e0e..596e3e98 100644--- a/examples/interview/reference.svml+++ b/examples/interview/reference.svml@@ -22,7 +22,7 @@<import as="emoji" from="@hypit/interview-emoji-reveal@1"/><import as="recipes" source="./reference.svs"/><import as="image-kit" source="@hypit/gpt-image-kits/phone-ugc-v1"/>- <import as="interview-kit" source="./kits/street-interview-v1.svs"/>+ <import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><script id="story"><manifest-rule>diff --git a/examples/interview/swap-host.svml b/examples/interview/swap-host.svmlindex 0362446b..ad377a5d 100644--- a/examples/interview/swap-host.svml+++ b/examples/interview/swap-host.svml@@ -20,7 +20,7 @@<import as="render" from="@hypit/render-hyperframes@1"/><import as="emoji" from="@hypit/interview-emoji-reveal@1"/><import as="recipes" source="./recipes.svs"/>- <import as="interview-kit" source="./kits/street-interview-v1.svs"/>+ <import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><import as="wojak-tracking" source="./wojak-tracking.svs"/><script id="story">diff --git a/examples/interview/swap-lang.svml b/examples/interview/swap-lang.svmlindex 0bfea064..2a30c49d 100644--- a/examples/interview/swap-lang.svml+++ b/examples/interview/swap-lang.svml@@ -22,7 +22,7 @@<import as="emoji" from="@hypit/interview-emoji-reveal@1"/><import as="recipes" source="./recipes.svs"/><import as="tracking" source="./spanish-tracking.svs"/>- <import as="interview-kit" source="./kits/street-interview-v1.svs"/>+ <import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><script id="story"><manifest-rule>diff --git a/examples/interview/swap-ride.svml b/examples/interview/swap-ride.svmlindex d4db6abd..2a2c9225 100644--- a/examples/interview/swap-ride.svml+++ b/examples/interview/swap-ride.svml@@ -21,7 +21,7 @@<import as="emoji" from="@hypit/interview-emoji-reveal@1"/><import as="recipes" source="./recipes.svs"/><import as="tracking" source="./ada-tracking.svs"/>- <import as="interview-kit" source="./kits/street-interview-v1.svs"/>+ <import as="interview-kit" source="@hypit/seedance-kits/street-interview"/><script id="story"><uber-rule>diff --git a/examples/podcast/kits/broll-v1.svs b/examples/podcast/kits/broll-v1.svsdeleted file mode 100644index 662d59f5..00000000--- a/examples/podcast/kits/broll-v1.svs+++ /dev/null@@ -1,52 +0,0 @@-<?svml using="@hypit/text/svs@1"?>--<sheet version="1" id="broll-v1">- text-template.broll-v1 {- separator: paragraph;- default-material-mode: practical-real;- default-story-shape: single-moment;- default-edit-language: continuous-shot;- default-camera-language: reference-locked;- default-motion-intensity: readable;- }-- text-template.broll-v1.block.base { kind: fixed; order: 10; text: "Create a silent B-roll micro-film using the provided reference image or images."; }- text-template.broll-v1.block.contract { kind: fixed; order: 20; text: "B-ROLL CONTRACT: create visual support footage. Focus on visible action, object behavior, camera movement, and editing rhythm. Visible people perform visual actions rather than speaking to camera."; }- text-template.broll-v1.block.reference { kind: fixed; order: 30; text: "REFERENCE CONTRACT: preserve the intended identity, product, UI, props, setting, lighting, texture, wardrobe, and composition from the reference images. Use the references in their authored order and follow the story's explicit description of each reference's role."; }-- text-template.broll-v1.block.material { kind: axis; order: 40; parameter: material-mode; }- text-template.broll-v1.choice.material.practical-real { text: "MATERIAL MODE: practical real-world UGC footage with believable physical causality and a lived-in phone-camera feeling."; }- text-template.broll-v1.choice.material.screen-demo { text: "MATERIAL MODE: a practical filmed screen demo. Interface elements remain physically contained on the device screen."; }- text-template.broll-v1.choice.material.product-beauty { text: "MATERIAL MODE: product beauty footage focused on object presence, packaging, texture, tabletop detail, or studio product motion."; }- text-template.broll-v1.choice.material.proof-capture { text: "MATERIAL MODE: proof capture such as a website, certificate, receipt, review, chart, or credibility page, treated as visual evidence."; }- text-template.broll-v1.choice.material.stylized-vfx { text: "MATERIAL MODE: an intentional visual-effects metaphor used as an expressive explainer rather than practical documentation."; }-- text-template.broll-v1.block.story-shape { kind: axis; order: 60; parameter: story-shape; }- text-template.broll-v1.choice.story-shape.single-moment { text: "STORY SHAPE: one continuous visual moment with a small readable change or payoff."; }- text-template.broll-v1.choice.story-shape.reaction-beat { text: "STORY SHAPE: stimulus, realization, then a clearly visible reaction."; }- text-template.broll-v1.choice.story-shape.process-demo { text: "STORY SHAPE: a stepwise demonstration whose practical stages remain legible."; }- text-template.broll-v1.choice.story-shape.before-after { text: "STORY SHAPE: a clear and visually legible contrast between before and after states."; }- text-template.broll-v1.choice.story-shape.montage-sequence { text: "STORY SHAPE: several short shots around one idea, each adding distinct evidence or feeling."; }-- text-template.broll-v1.block.edit { kind: axis; order: 70; parameter: edit-language; }- text-template.broll-v1.choice.edit.continuous-shot { text: "EDIT LANGUAGE: continuous-shot timing; let the visual action play as one coherent moment."; }- text-template.broll-v1.choice.edit.jump-cut-beats { text: "EDIT LANGUAGE: crisp jump-cut beats, with each meaningful action stage landing cleanly."; }- text-template.broll-v1.choice.edit.match-cut-montage { text: "EDIT LANGUAGE: match-cut montage connecting similar framing, motion, or composition across shots."; }- text-template.broll-v1.choice.edit.insert-cutaway { text: "EDIT LANGUAGE: relevant detail cutaways such as hand, screen, product, face, or reaction."; }-- text-template.broll-v1.block.camera { kind: axis; order: 80; parameter: camera-language; }- text-template.broll-v1.choice.camera.reference-locked { text: "CAMERA LANGUAGE: preserve the reference framing with minimal drift and let subject action carry the shot."; }- text-template.broll-v1.choice.camera.selfie-vlog { text: "CAMERA LANGUAGE: intimate selfie, mirror, or vlog phone camera with natural arm and camera bob."; }- text-template.broll-v1.choice.camera.handheld-follow { text: "CAMERA LANGUAGE: a handheld follow camera moving with the subject or object through space."; }- text-template.broll-v1.choice.camera.push-reveal { text: "CAMERA LANGUAGE: a motivated push, tilt, or reveal guiding attention to the key discovery."; }- text-template.broll-v1.choice.camera.product-macro { text: "CAMERA LANGUAGE: close product macro, orbit, parallax, or detail-focused movement."; }-- text-template.broll-v1.block.motion { kind: axis; order: 90; parameter: motion-intensity; }- text-template.broll-v1.choice.motion.micro { text: "MOTION INTENSITY: micro motion only, prioritizing proof, product, or still-evidence clarity."; }- text-template.broll-v1.choice.motion.readable { text: "MOTION INTENSITY: readable action with clear movement that remains easy to understand."; }- text-template.broll-v1.choice.motion.lively { text: "MOTION INTENSITY: lively UGC body, camera, or object movement."; }- text-template.broll-v1.choice.motion.impact { text: "MOTION INTENSITY: high-impact physical or sensory motion such as splash, burst, or fast reveal."; }-- text-template.broll-v1.block.hygiene { kind: fixed; order: 100; text: "SCREEN AND TEXT HYGIENE: add no subtitles, captions, floating words, labels, logos, or ad overlays. Referenced physical labels, screens, websites, and documents remain attached to their objects."; }- text-template.broll-v1.block.story { kind: slot; order: 110; slot: story; optional: false; label: "MICRO-STORY PROMPT:"; }-</sheet>diff --git a/examples/podcast/kits/podcast-v1.svs b/examples/podcast/kits/podcast-v1.svsdeleted file mode 100644index a236adb4..00000000--- a/examples/podcast/kits/podcast-v1.svs+++ /dev/null@@ -1,55 +0,0 @@-<?svml using="@hypit/text/svs@1"?>--<sheet version="1" id="podcast-v1">- text-template.podcast-v1 {- separator: paragraph;- default-framing: locked-view;- default-edit-language: speaker-cuts;- default-pacing: compact;- default-performance: natural-banter;- default-reaction: active-listening;- default-gesture: natural;- }- text-template.podcast-v1.block.base { kind: fixed; order: 10; text: "Create a realistic vertical edited two-person podcast clip from two final camera-view reference images."; }- text-template.podcast-v1.block.reference { kind: fixed; order: 20; text: "REFERENCE CONTRACT: @image1 is Host A's final camera view and @image2 is Host B's final camera view. Preserve both identities, outfits, room, lighting, props, camera sides, lens feel, and seating relationship."; }- text-template.podcast-v1.block.speaker-map { kind: fixed; order: 30; text: "SPEAKER MAP: follow the A: and B: dialogue order exactly. Only the host assigned to the current line moves their mouth; any listener cutaway remains silent."; }- text-template.podcast-v1.block.voice-map { kind: fixed; order: 40; text: "VOICE MAP: Host A uses @audio1 and speaks only A: lines. Host B uses @audio2 and speaks only B: lines."; }-- text-template.podcast-v1.block.framing { kind: axis; order: 50; parameter: framing; }- text-template.podcast-v1.choice.framing.locked-view { text: "FRAMING: keep each host's baseline reference crop and scale."; }- text-template.podcast-v1.choice.framing.soft-push-in { text: "FRAMING: use one subtle push-in on an important phrase or reaction, then return to baseline."; }- text-template.podcast-v1.choice.framing.emphasis-closeup { text: "FRAMING: use one modest emphasis close-up, then return to the baseline view."; }-- text-template.podcast-v1.block.edit { kind: axis; order: 60; parameter: edit-language; }- text-template.podcast-v1.choice.edit.speaker-cuts { text: "CUT PATTERN: stay on the host who is currently speaking."; }- text-template.podcast-v1.choice.edit.reaction-cuts { text: "CUT PATTERN: briefly cut to the silent listener during longer explanations, then return to the speaker."; }-- text-template.podcast-v1.block.pacing { kind: axis; order: 70; parameter: pacing; }- text-template.podcast-v1.choice.pacing.measured { text: "PACING: measured turn-taking, readable articulation, and breathing room between thoughts."; }- text-template.podcast-v1.choice.pacing.compact { text: "PACING: compact immediate handoffs while each line remains a natural continuous take."; }- text-template.podcast-v1.choice.pacing.rapid-banter { text: "PACING: rapid banter with quick backchannel energy while every line remains intelligible."; }- text-template.podcast-v1.choice.pacing.varied-emphasis { text: "PACING: compact handoffs, slowing slightly for important names, numbers, doubts, and payoffs."; }-- text-template.podcast-v1.block.performance { kind: axis; order: 80; parameter: performance; }- text-template.podcast-v1.choice.performance.natural-banter { text: "PERFORMANCE: natural podcast banter with warm eye focus and believable intonation."; }- text-template.podcast-v1.choice.performance.high-energy { text: "PERFORMANCE: vivid high-energy short-form podcast delivery."; }- text-template.podcast-v1.choice.performance.calm-expert { text: "PERFORMANCE: composed, precise, trustworthy expert discussion."; }- text-template.podcast-v1.choice.performance.playful-skeptic { text: "PERFORMANCE: playful skeptical chemistry with teasing smiles and amused disbelief."; }-- text-template.podcast-v1.block.reaction { kind: axis; order: 90; parameter: reaction; }- text-template.podcast-v1.choice.reaction.subtle-listening { text: "REACTIONS: tiny nods, eye focus, breath, and small expression changes."; }- text-template.podcast-v1.choice.reaction.active-listening { text: "REACTIONS: readable nods, smiles, eye movement, and line-by-line facial shifts."; }- text-template.podcast-v1.choice.reaction.skeptical-reacts { text: "REACTIONS: skeptical eyebrows, amused disbelief, small laughs, and attentive eye movement."; }- text-template.podcast-v1.choice.reaction.big-reacts { text: "REACTIONS: strong but believable surprise, laughter, disbelief, and recognition."; }-- text-template.podcast-v1.block.gesture { kind: axis; order: 100; parameter: gesture; }- text-template.podcast-v1.choice.gesture.restrained { text: "GESTURE: restrained podcast body language with very small hand beats."; }- text-template.podcast-v1.choice.gesture.compact { text: "GESTURE: compact semantic hand beats near the torso and table."; }- text-template.podcast-v1.choice.gesture.natural { text: "GESTURE: natural open palms, small points, nods, and posture shifts."; }- text-template.podcast-v1.choice.gesture.expressive { text: "GESTURE: richer hand, shoulder, posture, and face changes while staying coherent."; }-- text-template.podcast-v1.block.action-contract { kind: fixed; order: 110; text: "ACTION PROMPT: optional segment direction controls specified lines, gestures, expressions, and timing."; }- text-template.podcast-v1.block.audio { kind: fixed; order: 120; text: "AUDIO AND TEXTURE: clean dialogue, natural room tone, stable faces and hands, microphones, props, and photoreal motion. Add no subtitles, captions, labels, UI text, or floating words."; }- text-template.podcast-v1.block.dialogue { kind: slot; order: 130; slot: dialogue; optional: false; label: "DIALOGUE SCRIPT TO DELIVER:"; }- text-template.podcast-v1.block.action { kind: slot; order: 140; slot: action; optional: true; label: "ACTION DIRECTION:"; }-</sheet>diff --git a/examples/podcast/reference.svml b/examples/podcast/reference.svmlindex 484fe2ff..85ca5e54 100644--- a/examples/podcast/reference.svml+++ b/examples/podcast/reference.svml@@ -22,8 +22,8 @@<import as="recipes" source="./reference.svs"/><import as="image-kit" source="@hypit/gpt-image-kits/phone-ugc-v1"/><import as="opening-kit" source="./kits/split-opening.svs"/>- <import as="broll-kit" source="./kits/broll-v1.svs"/>- <import as="podcast-kit" source="./kits/podcast-v1.svs"/>+ <import as="broll-kit" source="@hypit/seedance-kits/broll"/>+ <import as="podcast-kit" source="@hypit/seedance-kits/podcast"/><script id="story"><opening-question>diff --git a/examples/podcast/swap-app.svml b/examples/podcast/swap-app.svmlindex a2eef185..222e5c00 100644--- a/examples/podcast/swap-app.svml+++ b/examples/podcast/swap-app.svml@@ -19,8 +19,8 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="broll-kit" source="./kits/broll-v1.svs"/>- <import as="podcast-kit" source="./kits/podcast-v1.svs"/>+ <import as="broll-kit" source="@hypit/seedance-kits/broll"/>+ <import as="podcast-kit" source="@hypit/seedance-kits/podcast"/><script id="story"><opening-question>diff --git a/examples/podcast/swap-host.svml b/examples/podcast/swap-host.svmlindex daf914a2..18340852 100644--- a/examples/podcast/swap-host.svml+++ b/examples/podcast/swap-host.svml@@ -20,8 +20,8 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="broll-kit" source="./kits/broll-v1.svs"/>- <import as="podcast-kit" source="./kits/podcast-v1.svs"/>+ <import as="broll-kit" source="@hypit/seedance-kits/broll"/>+ <import as="podcast-kit" source="@hypit/seedance-kits/podcast"/><script id="story"><opening-question>diff --git a/examples/podcast/swap-item.svml b/examples/podcast/swap-item.svmlindex 9c0e7556..0fd2bc85 100644--- a/examples/podcast/swap-item.svml+++ b/examples/podcast/swap-item.svml@@ -19,8 +19,8 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="broll-kit" source="./kits/broll-v1.svs"/>- <import as="podcast-kit" source="./kits/podcast-v1.svs"/>+ <import as="broll-kit" source="@hypit/seedance-kits/broll"/>+ <import as="podcast-kit" source="@hypit/seedance-kits/podcast"/><script id="story"><opening-question>diff --git a/examples/ranking-football/kits/speaker-v1.svs b/examples/ranking-football/kits/speaker-v1.svsdeleted file mode 100644index 4537dd20..00000000--- a/examples/ranking-football/kits/speaker-v1.svs+++ /dev/null@@ -1,136 +0,0 @@-<?svml using="@hypit/text/svs@1"?>--<sheet version="1" id="speaker-v1">- text-template.speaker-v1 {- separator: paragraph;- default-composition-stability: soft-locked;- default-camera-motion: none;- default-edit-rhythm: continuous-take;- default-performance: natural-explainer;- default-gesture: natural;- }-- text-template.speaker-v1.block.base {- kind: fixed;- order: 10;- text: "Create a realistic vertical phone-shot talking-head video. @image1 is the visible speaker and scene reference. Preserve the person's identity, face, outfit, setting, lighting, lens feel, and broad composition. @audio1 is the speaker's voice-timbre reference.";- }-- text-template.speaker-v1.block.script-contract {- kind: fixed;- order: 20;- text: "Deliver the supplied script exactly in order with clear lip-sync. The visible person speaks every line. Do not rewrite, summarize, add, remove, or reorder words.";- }-- text-template.speaker-v1.block.composition-stability {- kind: axis;- order: 30;- parameter: composition-stability;- }-- text-template.speaker-v1.choice.composition-stability.flexible-ugc {- text: "COMPOSITION: preserve the reference person and setup while allowing normal lively creator-video framing variation.";- }-- text-template.speaker-v1.choice.composition-stability.soft-locked {- text: "COMPOSITION: keep the speaker in the same general region and preserve the reference composition, allowing natural posture changes and tiny crop or scale breathing.";- }-- text-template.speaker-v1.choice.composition-stability.strict-locked {- text: "COMPOSITION: preserve subject placement, perspective, left-right orientation, background relationship, and framing envelope throughout the shot.";- }-- text-template.speaker-v1.block.camera-motion {- kind: axis;- order: 40;- parameter: camera-motion;- }-- text-template.speaker-v1.choice.camera-motion.none {- text: "CAMERA: hold a steady fixed framing.";- }-- text-template.speaker-v1.choice.camera-motion.subtle-punch-in-return {- text: "CAMERA: use one subtle push-in on the most important phrase, then return smoothly to the original framing.";- }-- text-template.speaker-v1.block.edit-rhythm {- kind: axis;- order: 50;- parameter: edit-rhythm;- }-- text-template.speaker-v1.choice.edit-rhythm.continuous-take {- text: "EDIT RHYTHM: one continuous creator explanation with natural breath timing.";- }-- text-template.speaker-v1.choice.edit-rhythm.pause-trim-jump-cuts {- text: "EDIT RHYTHM: polished pause-trim jump cuts at phrase boundaries while keeping the framing coherent.";- }-- text-template.speaker-v1.block.performance {- kind: axis;- order: 60;- parameter: performance;- }-- text-template.speaker-v1.choice.performance.natural-explainer {- text: "PERFORMANCE: natural explainer energy with clear eye focus, expressive eyebrows, small nods, and a friendly conversational rhythm.";- }-- text-template.speaker-v1.choice.performance.high-energy-ugc {- text: "PERFORMANCE: vivid high-energy short-form delivery with expressive face changes on key words.";- }-- text-template.speaker-v1.choice.performance.calm-authority {- text: "PERFORMANCE: composed, confident, precise, and trustworthy, with deliberate emphasis.";- }-- text-template.speaker-v1.choice.performance.reactive-playful {- text: "PERFORMANCE: playful and reactive, with amused looks, quick smiles, skeptical eyebrows, and lively timing.";- }-- text-template.speaker-v1.block.gesture {- kind: axis;- order: 70;- parameter: gesture;- }-- text-template.speaker-v1.choice.gesture.restrained {- text: "GESTURE: restrained body language; let face, eyes, and voice carry the meaning.";- }-- text-template.speaker-v1.choice.gesture.compact {- text: "GESTURE: compact explanatory hand movement close to the torso and inside the frame.";- }-- text-template.speaker-v1.choice.gesture.natural {- text: "GESTURE: natural creator gestures such as open palms, small pointing beats, nods, and posture shifts where the script calls for them.";- }-- text-template.speaker-v1.choice.gesture.expressive {- text: "GESTURE: richer hand, shoulder, and posture changes that support the spoken idea while remaining physically coherent.";- }-- text-template.speaker-v1.block.hygiene {- kind: fixed;- order: 80;- text: "Keep face, hands, skin texture, lighting, and motion photoreal and stable. Add no subtitles, captions, labels, logos, UI text, floating words, or other readable on-screen text.";- }-- text-template.speaker-v1.block.dialogue {- kind: slot;- order: 90;- slot: dialogue;- optional: false;- label: "SCRIPT TO DELIVER:";- }-- text-template.speaker-v1.block.action {- kind: slot;- order: 100;- slot: action;- optional: true;- label: "ACTION DIRECTION:";- }-</sheet>diff --git a/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml b/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svmlindex 0b18ade3..914848e6 100644--- a/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml+++ b/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/reference-banana/reference-banana.svml b/examples/ranking-football/reference-banana/reference-banana.svmlindex 0b18ade3..914848e6 100644--- a/examples/ranking-football/reference-banana/reference-banana.svml+++ b/examples/ranking-football/reference-banana/reference-banana.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/reference-gpt.svml b/examples/ranking-football/reference-gpt.svmlindex 21a6cd1a..2ed06ac6 100644--- a/examples/ranking-football/reference-gpt.svml+++ b/examples/ranking-football/reference-gpt.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/reference.svml b/examples/ranking-football/reference.svmlindex 0c3f1975..3f9cdfb2 100644--- a/examples/ranking-football/reference.svml+++ b/examples/ranking-football/reference.svml@@ -22,7 +22,7 @@<import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./recipes.svs"/><import as="image-kit" source="@hypit/gpt-image-kits/phone-ugc-v1"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml b/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svmlindex 1abc65a9..09482d87 100644--- a/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml+++ b/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./hybrid-recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml b/examples/ranking-football/swap-effect-banana/swap-effect-banana.svmlindex f08d4dd5..c859597a 100644--- a/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml+++ b/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./column-recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- Cue boundaries remain explicit author intent. The complete Messi andRonaldo Segments are also the two disjoint Column reveal windows. -->diff --git a/examples/ranking-football/swap-effect.svml b/examples/ranking-football/swap-effect.svmlindex f68420cf..7dd77426 100644--- a/examples/ranking-football/swap-effect.svml+++ b/examples/ranking-football/swap-effect.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./column-recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- Cue boundaries remain explicit author intent. The complete Messi andRonaldo Segments are also the two disjoint Column reveal windows. -->diff --git a/examples/ranking-football/swap-host.svml b/examples/ranking-football/swap-host.svmlindex 834e4663..9d6938ff 100644--- a/examples/ranking-football/swap-host.svml+++ b/examples/ranking-football/swap-host.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./tier-banana-recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- The Program projection owns the complete board lifetime. Each discussedfootballer's complete Segment projects its disjoint reveal window, sodiff --git a/examples/ranking-football/swap-topic.svml b/examples/ranking-football/swap-topic.svmlindex 0bfa0a36..7a2a8eb5 100644--- a/examples/ranking-football/swap-topic.svml+++ b/examples/ranking-football/swap-topic.svml@@ -21,7 +21,7 @@<import as="film" from="@hypit/film@1"/><import as="render" from="@hypit/render-hyperframes@1"/><import as="recipes" source="./tech-tier-recipes.svs"/>- <import as="speaker-kit" source="./kits/speaker-v1.svs"/>+ <import as="speaker-kit" source="@hypit/seedance-kits/speaker"/><!-- Each executive is one continuous spoken Segment and one generated Take.Every B-roll insert consumes an authored semantic Selection. -->diff --git a/packages/seedance/src/index.ts b/packages/seedance/src/index.tsindex bdaa3fb3..8bb027f5 100644--- a/packages/seedance/src/index.ts+++ b/packages/seedance/src/index.ts@@ -296,7 +296,7 @@ export const seedanceMarkupSurfaces = [id="hook-take"model="mini"prompt={hook-prompt}- duration={hook-duration.duration}+ duration="8"resolution="720p"aspect-ratio="9:16"generate-audio="true"diff --git a/skills/hypit/references/environment/distribution.md b/skills/hypit/references/environment/distribution.mdindex 4f16c097..768ce6df 100644--- a/skills/hypit/references/environment/distribution.md+++ b/skills/hypit/references/environment/distribution.md@@ -66,6 +66,10 @@ executable Distribution. After installation or an update, use the selected launc`--help`, and `paths`, then continue with`profile.md` for the current project's capabilities and Runtime choices.+The installed Distribution is the authority for exact Surface syntax. If a package or Surface named+by the Skill is absent from `hypit vocabulary`, report the version mismatch and update the selected+installation instead of inventing a translation.+A contributor checkout can execute its own Distribution after its documented workspace setup, but itis a development arrangement, not an assumed location for ordinary production. Use one only when theuser explicitly supplied or selected that checkout.