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 production guidance with 0.3 author model
kashorinaa07d1eb5ef6
diff --git a/docs/guide/author-packages.md b/docs/guide/author-packages.mdindex 9b9ae6a7..c4a581c3 100644--- a/docs/guide/author-packages.md+++ b/docs/guide/author-packages.md@@ -60,7 +60,7 @@ actual composition too, where its content, space and timing have a purpose.For richer interactive editing, add a Studio Companion. The[Companion SDK](https://github.com/hypit-ai/hypit/blob/main/packages/studio-companion/README.md)-shows how to expose timeline entities, properties and source bindings. The rendering code and+shows how to expose timeline Items, properties and source bindings. The rendering code andCompanion are separate contributions in the same package.## Use and share itdiff --git a/docs/guide/component-anatomy.md b/docs/guide/component-anatomy.mdindex 0614e71b..bcb284af 100644--- a/docs/guide/component-anatomy.md+++ b/docs/guide/component-anatomy.md@@ -24,7 +24,7 @@ These roles can be organized into files that suit the component's size:| Value and Style helpers | Validate inputs, apply documented defaults and decode the accepted Recipe properties || Schedule and drawing | Project events and draw the scene at each frame || Activation | Publish the contributions the selected package offers |-| Studio Companion | Describe timeline entities and editable properties for Studio |+| Studio Companion | Describe timeline Items and editable properties for Studio |The [Author Package guide](./author-packages.md) and included example route each exact object shape toits owning API. A small component can keep related roles together;diff --git a/docs/guide/studio-companion-architecture.md b/docs/guide/studio-companion-architecture.mdindex 3af6a64f..6dff920d 100644--- a/docs/guide/studio-companion-architecture.md+++ b/docs/guide/studio-companion-architecture.md@@ -1,6 +1,6 @@---title: Studio Companions-description: Give a component useful timeline entities and editing controls in Studio.+description: Give a component useful timeline Items and editing controls in Studio.---A component draws the video. Its **Studio Companion** explains that component to the editor: which@@ -22,20 +22,27 @@ the installed code so the new contribution is loaded.## Describe the author-facing objectsA Track Companion matches the component's terminal Type and authored Surface. It describes timeline-entities, labels, material previews and Inspector fields using the component's public values.+Items, labels, material previews and Inspector fields using the component's public values.A graphic can expose its appearance, content, placement and event timing without exposing everyinternal drawing value.Studio supplies the controls and interactions. A Companion selects scalar, list or record controlsand binds them to source values. A Film Companion identifies the Film's time source and Tracks;-a Script Companion supports the source mapping needed to relocate Selection and Moment markers.-The same Timeline supports animation with no performance media or Script lane; its authored end defines the extent.+domain Companions can contribute mapping and evidence rows for each exact projection. A Temporal+relation Companion describes how one package's producer traces to its inputs and, where meaningful,+how an edit constrains its authored inputs. The same Timeline supports animation with no performance+media or domain projection; its authored end defines the extent.++Track-owned rules that are not occurrences belong in Inspector objects. Caption Uses, for example,+remain editable without becoming draggable Timeline Items. Independently represented child content+can still use an attached Track with its own Items.## Make edits meaningful-Timeline editing follows the chosen temporal relationship. Moving a shared Script event changes the-marker and its consumers. A parameter-based handle changes that authored parameter. Values with no-supported inverse remain available for inspection.+Timeline editing follows the chosen temporal relationship. Studio solves the requested move or trim+through the executed relation graph and writes every required author endpoint together. Shared+upstream changes naturally update all consumers after recompilation. Values with no unique supported+inverse remain available for inspection.Inspector fields bind to the author values they change. A shared Recipe or Frame may affect severaluses, so the property represents that shared decision. Studio applies the edit to the correspondingdiff --git a/docs/guide/studio-temporal-windows.md b/docs/guide/studio-temporal-windows.mdindex f51128bf..79233b0f 100644--- a/docs/guide/studio-temporal-windows.md+++ b/docs/guide/studio-temporal-windows.md@@ -59,4 +59,4 @@ Unedited expressions retain their units: `2s` remains two seconds when frame ratcurrent Timeline.[Studio](../quickstart/preview.md) explains the editing interface. The-[Companion guide](./studio-companion-architecture.md) explains package-owned entities and controls.+[Companion guide](./studio-companion-architecture.md) explains package-owned Items and controls.diff --git a/docs/quickstart/script.md b/docs/quickstart/script.mdindex 81356b87..dc206940 100644--- a/docs/quickstart/script.md+++ b/docs/quickstart/script.md@@ -78,7 +78,7 @@ Role Cues produce different text projections:The dialogue `Text` includes Role Cue prefixes. Speech `Text` and the CaptionDocument strip them.Prompt programs feeding `seedance:ReferenceVideo` may use `{story.segment.dialogue.dialogue}` (with labels).Script emits `{story.caption}` as one CaptionDocument containing Display Words, N:M Alignment Units-and authored Cue Breaks. It contains no seconds or frames.+and authored Cues. It contains no seconds or frames.## Dual Text@@ -126,7 +126,7 @@ Here the left side also supplies speech, so markers can be written and moved thestill owns its own markers. The explicit or shared speech must contain a spoken word; a form suchas `<API|...>` supplies no timed correspondence and is invalid.-`||` is the **Caption Cue Break** syntax. It records a boundary between complete Alignment Units;+`||` is the **Caption Cue separator**. It ends the current Cue after a complete Alignment Unit;it cannot appear inside Dual Text or split an N:M unit. Cue timing is still obtained later byprojecting its peer NarrativeCaptionBinding through explicit Narrative time.@@ -160,7 +160,8 @@ Caption Style; attributes do not split, wrap or retime a Dual Alignment Unit.- **Display Word** — one rendered lexical surface, including display punctuation;- **Alignment Unit** — the smallest display-to-speech correspondence, including N:M Dual Text;-- **Cue Break** — an authored boundary after a complete Alignment Unit, written `||`.+- **Cue** — one ordered group of complete Alignment Units. Segment and Role boundaries end Cues;+ `||` explicitly ends the current Cue inside a turn.Punctuation is not a speech token and never receives its own timing window. Closing punctuation aftera Dual Text attaches to the preceding Display Word (`<test | now>. here` displays as `test. here`),diff --git a/docs/zh/guide/author-packages.md b/docs/zh/guide/author-packages.mdindex 18e2f427..284dbe79 100644--- a/docs/zh/guide/author-packages.md+++ b/docs/zh/guide/author-packages.md@@ -37,7 +37,7 @@ Style 一类 Surface 在裸作者 id 下公开其值,例如 `style={board-stylpreview Source 为作者提供可打开或渲染的小例子。查看能说明行为的状态:进入、关键变化、停留布局和退出。也要在实际编排中查看,这时内容、空间和时机才有具体用途。-需要更丰富的交互编辑时,可以添加 Studio Companion。[Companion SDK](https://github.com/hypit-ai/hypit/blob/main/packages/studio-companion/README.md) 介绍如何公开时间线实体、属性和 Source 绑定。绘制代码和 Companion 是同一个包中分别提供的贡献。+需要更丰富的交互编辑时,可以添加 Studio Companion。[Companion SDK](https://github.com/hypit-ai/hypit/blob/main/packages/studio-companion/README.md) 介绍如何公开时间线 Item、属性和 Source 绑定。绘制代码和 Companion 是同一个包中分别提供的贡献。## 使用与分享diff --git a/docs/zh/guide/component-anatomy.md b/docs/zh/guide/component-anatomy.mdindex 304cc696..6de970f4 100644--- a/docs/zh/guide/component-anatomy.md+++ b/docs/zh/guide/component-anatomy.md@@ -20,7 +20,7 @@ description: 将场景的创作接口变成可复用的图贡献。| 值与样式辅助函数 | 验证输入、应用已说明的默认值、解析接受的 Recipe 属性 || 调度与绘制 | 投影事件,并在每一帧绘制场景 || Activation | 公开所选包提供的贡献 |-| Studio Companion | 描述时间线实体与可编辑属性 |+| Studio Companion | 描述时间线 Item 与可编辑属性 |精确对象形状由 [Author Package 指南](./author-packages.md) 和随包示例指向各自所有者。小组件可以把相关职责放在一起;大组件则可以分离可复用的调度、样式和绘制逻辑。diff --git a/docs/zh/guide/studio-companion-architecture.md b/docs/zh/guide/studio-companion-architecture.mdindex 8eda359d..61a2b2a3 100644--- a/docs/zh/guide/studio-companion-architecture.md+++ b/docs/zh/guide/studio-companion-architecture.md@@ -1,6 +1,6 @@---title: Studio Companion-description: 为组件提供有意义的时间线实体和 Studio 编辑控件。+description: 为组件提供有意义的时间线 Item 和 Studio 编辑控件。---组件绘制视频,**Studio Companion** 向编辑器解释组件:哪些对象出现在时间线上,标签代表什么,哪些 Source 属性可以编辑。项目组件由此可以提供实用控件,同时保持视觉实现的可复用性。@@ -13,13 +13,15 @@ Companion 是应用贡献。项目组件可以在同一个物理包中,以独## 描述作者面对的对象-Track Companion 匹配组件的终端 Type 与作者 Surface,使用组件公开值描述时间线实体、标签、素材预览和 Inspector 字段。图形可以公开外观、内容、位置和事件时间,而不必暴露每一个内部绘制数值。+Track Companion 匹配组件的终端 Type 与作者 Surface,使用组件公开值描述时间线 Item、标签、素材预览和 Inspector 字段。图形可以公开外观、内容、位置和事件时间,而不必暴露每一个内部绘制数值。-控件与交互由 Studio 提供,Companion 选择标量、列表或记录控件,并将其绑定到 Source 值。Film Companion 指明 Film 的 Timeline 与 Track;Script Companion 支持移动 Selection、Moment 标记所需的源码映射。同一种 Timeline 也支持没有表演媒体和 Script 行的动画,其作者声明的结束时间定义完整范围。+控件与交互由 Studio 提供,Companion 选择标量、列表或记录控件,并将其绑定到 Source 值。Film Companion 指明 Film 的 Timeline 与 Track;领域 Companion 可以为每一次准确投影提供映射行和证据行。Temporal relation Companion 说明一个包的 Producer 如何追溯输入,以及在含义明确时如何把编辑反解为作者输入约束。同一种 Timeline 也支持没有表演媒体和领域投影的动画,其作者声明的结束时间定义完整范围。++不代表一次内容出现的 Track 规则属于 Inspector object。例如 Caption Use 仍可编辑,但不会伪装成可拖拽的时间线 Item。真正独立呈现的子内容可以使用带有自身 Item 的附属 Track。## 让编辑保留含义-时间线编辑沿用所选时间关系。移动共享 Script 事件会改变标记与其消费者;基于参数的手柄修改对应作者参数。没有可支持反向编辑的值,仍可供查看。+时间线编辑沿用所选时间关系。Studio 沿已执行的关系图求解一次完整的移动或裁剪,并原子地写入所有必要的作者端点。共享上游改变后,所有消费者通过重新编译自然更新。没有唯一且受支持的反解时,该值仍可供查看。Inspector 字段绑定到实际修改的作者值。共享 Recipe 或 Frame 可能影响多个使用位置,因此字段代表的是这项共享决定。Studio 将修改写到对应 Source,以同一份 Run 重新编译;修改无法发布时,显示错误并恢复之前的文件。diff --git a/docs/zh/guide/studio-temporal-windows.md b/docs/zh/guide/studio-temporal-windows.mdindex d997b787..2e62fe7a 100644--- a/docs/zh/guide/studio-temporal-windows.md+++ b/docs/zh/guide/studio-temporal-windows.md@@ -10,8 +10,8 @@ description: 修改产生绝对 Instant 或 Window 的声明。| 作者写法 | 移动时改变什么 | 裁剪时改变什么 || --- | --- | --- |-| `from="2s" for="8f"` | 改 `from`,时长仍为八帧 | `from` 或 `for` |-| `until="3s" for="8f"` | 改 `until`,时长仍为八帧 | `for` 或 `until` |+| `from="2s" for="8f"` | 改 `from`,时长仍为八帧 | 左侧:同时改 `from` 与 `for`;右侧:改 `for` |+| `until="3s" for="8f"` | 改 `until`,时长仍为八帧 | 左侧:改 `for`;右侧:同时改 `until` 与 `for` || `from="1s" until="3s"` | 两个端点移动相同帧数 | 被选择的端点 || 使用 `from`/`until`/`for` 声明的具名 Window | 修改该具名声明 | 修改所选端点关系 || 组件 `during={named-window}` | 修改具名值的生产者 | 修改具名值的生产者 |@@ -41,8 +41,12 @@ Narrative 投影声明保留 Companion 写回 Selection 或 Moment 所需的来如果生产者没有声明逆操作,解析出的值仍然可以正常使用,但 Studio 不会猜测写回目标。这使共享语义、局部时钟值和组件行为彼此分离。+每次拖动都作为一个完整约束求解:裁剪左侧时保持原结束点,裁剪右侧时保持原开始点,整体移动时保持原长度。Studio 沿已执行的 Temporal 图找到准确作者端点,并把所有必要的 Source 修改一起提交。++`<time:Timeline>` 内构造的具名值遵守同一规则。Timeline Author 保留每个字面偏移或时长所属的子声明,因此 Studio 可以修改准确的 `Instant.at`、`Window.from`、`Window.until` 或 `Window.for`。裸引用继续向上游追溯;若修改 `earliest(...)` 或 `latest(...)` 必须替作者选择某一个分支,它就保持只读。+未修改的表达保留原单位:帧率变化后 `2s` 仍是两秒,`60f` 仍是六十帧。修改后的时钟值按当前 Timeline 写在整数帧边界上。[Studio](../quickstart/preview.md) 介绍编辑界面,[Companion 指南](./studio-companion-architecture.md)-介绍包自己拥有的实体与控件。+介绍包自己拥有的 Item 与控件。diff --git a/docs/zh/quickstart/preview.md b/docs/zh/quickstart/preview.mdindex 42b52fd3..244a23ef 100644--- a/docs/zh/quickstart/preview.md+++ b/docs/zh/quickstart/preview.md@@ -45,9 +45,9 @@ hypit studio --run build.svrun中央 Preview 求值编排生成的 `HtmlProgram`;组件布局、素材采样和动作与编码成片来自同一份编排。调整字幕位置、图形重点或覆盖画面时,可以对照真实素材查看。-Timeline 把组件的出现放在同一时钟上。语义编排还会显示 Segment、Word、Selection 和 Moment。选择实体即可定位;播放、逐帧、缩放和滚动便于查看具体转场或版面。+Timeline 把组件的出现放在同一时钟上。领域投影还可以贡献映射行与证据行,作者声明的 Instant 和 Window 则共享一条时间行。选择 Item 即可定位;播放、逐帧、缩放和滚动便于查看具体转场或版面。-Inspector 显示所选实体的属性。可编辑字段与时间线手柄由组件的 **Studio Companion** 提供,它负责向 Studio 描述组件。项目组件可以随绘制代码一起提供自己的 Companion。组件能够渲染,与它开放了哪些编辑控件,是两件事:字段或手势需要明确可修改的 Source 值。+Inspector 显示所选 Item 的属性。可编辑字段与时间线手柄由组件的 **Studio Companion** 提供,它负责向 Studio 描述组件。项目组件可以随绘制代码一起提供自己的 Companion。组件能够渲染,与它开放了哪些编辑控件,是两件事:字段或手势需要明确可修改的 Source 值。## 修改作品@@ -59,6 +59,6 @@ Source 编辑修改所选 `.svml`、`.svs` 或 `.svrun` 文件。支持的 Inspe预览播放包含 Film 选中的 AudioTrack,例如口播、音乐与音效。导出视频的音频由渲染的媒体管线装配。作品准备好交付后,运行导出 Build 得到编码后的成片;Studio 与 Comments 仍可用于查看可编辑作品、沟通后续修改。-组件作者可以阅读 [Studio 中的时间编辑](../guide/studio-temporal-windows.md) 了解语义编辑,以及 [Companion SDK](https://github.com/hypit-ai/hypit/blob/main/packages/studio-companion/README.md) 了解如何公开组件实体和控件。+组件作者可以阅读 [Studio 中的时间编辑](../guide/studio-temporal-windows.md) 了解时间关系编辑,以及 [Companion SDK](https://github.com/hypit-ai/hypit/blob/main/packages/studio-companion/README.md) 了解如何公开组件 Item 和控件。需要其他界面语言时,可以通过 `--locale-pack ./language.json` 加载本地 JSON 译文。[本地化指南](https://github.com/hypit-ai/hypit/blob/main/packages/studio/LOCALIZATION.md) 介绍译文格式、缺项检查和语言包分享方法。diff --git a/docs/zh/quickstart/script.md b/docs/zh/quickstart/script.mdindex 9c237c4e..39596799 100644--- a/docs/zh/quickstart/script.md+++ b/docs/zh/quickstart/script.md@@ -71,7 +71,7 @@ Role Cue 会产生不同的文本投影:dialogue `Text` 包含 Role Cue 前缀,speech `Text` 和 CaptionDocument 会去除前缀。给`seedance:ReferenceVideo` 提供输入的 Prompt Program 可以使用 `{story.segment.dialogue.dialogue}`(带标签)。Script 输出一份 `{story.caption}` CaptionDocument,里面有显示词、N:M 对齐单元-和作者写出的 Cue 分界;里面没有秒数或帧数。+和作者 Cue;里面没有秒数或帧数。## Dual Text@@ -116,7 +116,7 @@ Cue 的切换。这同样适用于其他语言的短语或名字,例如 `<Git`<组@{beat!}件化|>`。标记和显示属性不会成为口播内容。若明确写了右侧口播,标记仍然属于右侧。明确或共享的口播都必须包含可说出的词;`<API|...>` 只有标点,无法建立时间对应,因此无效。-`||` 是 **Caption Cue Break** 语法,只能位于完整对齐单元之间,不能写进 Dual Text 或切开+`||` 是 **Caption Cue 分隔符**,它在一个完整对齐单元之后结束当前 Cue,不能写进 Dual Text 或切开N:M 单元。字幕稍后通过独立 NarrativeCaptionBinding 与 NarrativeProjection 得到绝对帧时间。### 空格与拼写@@ -143,11 +143,11 @@ N:M 单元。字幕稍后通过独立 NarrativeCaptionBinding 与 NarrativeProje### CaptionDocument 的组成-`CaptionDocument` 是 Caption 拥有、Script 可由同一源码生成的显示值,包含三种明确的语法对象:+`CaptionDocument` 是 Caption 拥有、Script 可由同一源码生成的显示值,包含三种明确的内容对象:- **Display Word(显示词)**:一个用于渲染的词面,包含应该显示的标点;- **Alignment Unit(对齐单元)**:最小的显示-口播对应关系,Dual Text 的 N:M 映射也保持为一个单元;-- **Cue Break(Cue 分界)**:作者写出的 `||`,只能放在完整对齐单元之后。+- **Cue**:由完整对齐单元组成的有序组。Segment 和 Role 边界会结束 Cue;`||` 可以在同一轮话语内显式结束当前 Cue。标点不是口播 token,也不会获得独立时间窗。Dual Text 后面的句号会吸附到前一个显示词:`<test | now>. here` 显示为 `test. here`,口播投影仍是 `now. here`。英文按词拆分;汉字、diff --git a/docs/zh/quickstart/tracks.md b/docs/zh/quickstart/tracks.mdindex 8544db40..b19a62ce 100644--- a/docs/zh/quickstart/tracks.md+++ b/docs/zh/quickstart/tracks.md@@ -15,7 +15,7 @@ Track 的作者语法。```textScript → CaptionDocument + NarrativeCaptionBinding绑定 + NarrativeProjection → 完整 Unit CaptionTiming-CaptionDocument + CaptionTiming + Uses → 家族 Cue Schedule → VisualTrack+作者 Cues + CaptionTiming + Uses → 家族呈现 Schedule → VisualTrack``````svml@@ -25,8 +25,7 @@ CaptionDocument + CaptionTiming + Uses → 家族 Cue Schedule → VisualTrack<import as="fonts" from="@hypit/fontsource@1"/>```-公共 Caption 负责 CaptionDocument、完整 Alignment Unit 的 Selection/Role 投影、样式分配与扁平-Timeline 时间连接。Fine 是一种样式族,负责形成 Cue,并拥有自己的几何、字形/Cue/Pill Paint 与局部动画。+公共 Caption 负责包含有序 Word、对应 Unit 和作者 Cue 的 CaptionDocument,以及完整 Alignment Unit 的 Selection/Role 查询、样式分配与扁平 Timeline 时间连接。Fine 是一种样式族,负责呈现这些 Cue,并拥有自己的几何、字形/Cue/Pill Paint 与局部动画。### caption-fine:Style@@ -64,7 +63,7 @@ caption.primary {必填的 `font=` 边携带一个按字节复现的 `FontStackRef`。字体家族、字重和字形只在这条边上声明一次;每个 Fallback 保留自己的真实字体信息。省略字体栈会在编译时失败,不会退回当前机器上的同名字体。-Cue 边界由 Script 的 Segment、Role、样式变化和作者写出的 `||` 决定。Fine 不声明任何+Cue 成员由 Script 的 Segment、Role 和作者写出的 `||` 决定;样式变化不改写 Cue。Fine 不声明任何逐词规划字段;其他字幕包可以定义完全不同的渲染方式,无需修改公共 Caption。Fine 不是一组互斥预设。基础/激活渐变、描边、阴影、长阴影、外发光、下划线、Pilldiff --git a/skills/hypit/SKILL.md b/skills/hypit/SKILL.mdindex eb8c62ba..99e1f054 100644--- a/skills/hypit/SKILL.md+++ b/skills/hypit/SKILL.md@@ -276,7 +276,7 @@ practical, revisit that choice and carry the improvement into the work and its n| defining the target: what the user asked for, and what the new piece will be | `references/creation/brief.md` || reshaping a reference while changing a person, object, world, performance, Script or sound; combining references | `references/creation/transformations.md` || choosing wording, pronunciation, performable passages, semantic relationships or measured delivery | `references/creation/script-and-time.md` |-| writing `<script>`: current syntax, display/speech, spaces, grouping, Roles, Cue breaks, attributes or marker affinities | `references/production/script-syntax.md` |+| writing `<script>`: current syntax, display/speech, spaces, grouping, Roles, authored Cues, attributes or marker affinities | `references/production/script-syntax.md` || placing a component in time: semantic bindings, authored clock positions, offsets, durations or what a timeline edit changes | `references/production/timing.md` || project layout, picking work back up, or handing an editable production to someone else | `references/creation/project-files.md` || directing a generated person, setting, product, B-roll image, camera view, visual reference or image prompt | `references/playbooks/craft/image-direction.md` |@@ -316,7 +316,7 @@ practical, revisit that choice and carry the improvement into the work and its n| writing a Caption family with new word relationships, scheduling or layout | `references/production/caption-authoring.md` || `plan`, Provider pricing information, `build`, a retry or interrupted submission, following work, Results and exports | `references/production/builds.md` || showing the editable work before export: Comments, Studio timeline, parameters, timestamped feedback and interface language | `references/production/studio.md` |-| giving a component useful timeline entities, picture selection and author controls | `references/production/studio-companions.md` |+| giving a component useful timeline Items, picture selection and author controls | `references/production/studio-companions.md` || Film assembly, pure MG with authored time, picture and sound, final rendering or a selected frame interval | `references/production/rendering.md` || exact frames or paginated grids of an existing production, without a new render Build | `references/production/snapshots.md` || judging the preview or finished Result and deciding what to fix | `references/production/review.md` |diff --git a/skills/hypit/references/creation/brief.md b/skills/hypit/references/creation/brief.mdindex 7c0f88bf..081c4d12 100644--- a/skills/hypit/references/creation/brief.md+++ b/skills/hypit/references/creation/brief.md@@ -75,7 +75,7 @@ one dominant reference. These are different sources of creative evidence.The spoken wording becomes authoritative only in the Author Source's `<script>`. During drafting, copymay live in `drafts/`; once adopted, move it into Source and stop maintaining a second full transcriptin Brief or Treatment. Brief can preserve mandatory claims or exact user-supplied phrases. Treatment-can describe what each passage must accomplish. Source owns the actual words, roles, Cue breaks,+can describe what each passage must accomplish. Source owns the actual words, roles, Cues,Selections, and Moments.## Revise the owner of the changed factdiff --git a/skills/hypit/references/playbooks/craft/captions.md b/skills/hypit/references/playbooks/craft/captions.mdindex 12bcc451..5052fb81 100644--- a/skills/hypit/references/playbooks/craft/captions.md+++ b/skills/hypit/references/playbooks/craft/captions.md@@ -42,10 +42,10 @@ performed speech. The following sections connect these decisions to the actual p## Keep wording and timing in their owners-Script owns display words, speaking Roles, Dual Text units, attributes and `||` Cue Breaks. Its-CaptionDocument contains no seconds or frames. A source-domain adapter produces complete, flat Unit-CaptionTiming on the actual Timeline; a visual family then forms and presents its Cues from those-timed units. Reuse those units rather than retyping spoken words into independent Typography merely+Script owns display words, speaking Roles, Dual Text units, attributes and authored Cues; `||` ends+the current Cue. Its CaptionDocument contains no seconds or frames. A source-domain adapter produces+complete, flat Unit CaptionTiming on the actual Timeline; a visual family joins that timing to the+authored Cues and presents them. Reuse those units rather than retyping spoken words into independent Typography merelybecause it can draw the desired shape.Use the produced performance's normalized and aligned audio. A change to that audio, its speed ordiff --git a/skills/hypit/references/playbooks/formats/talking-head.md b/skills/hypit/references/playbooks/formats/talking-head.mdindex 17e9468e..17495ef9 100644--- a/skills/hypit/references/playbooks/formats/talking-head.md+++ b/skills/hypit/references/playbooks/formats/talking-head.md@@ -68,7 +68,7 @@ See [Generated video direction](../craft/video-direction.md) for listeners, gestWrite natural stages in Script. For newly generated clips, estimate each Segment before choosing aliteral generation duration. When the work retains recorded speech, its edited delivery suppliesthe actual duration; [media preparation](../../production/media.md) explains how to prepare and-align it. A Segment can contain several edited shots, Caption Cue Breaks, graphic changes and+align it. A Segment can contain several edited shots, Caption Cue separators, graphic changes andspeaking turns. Choose its boundaries from the performance it carries.Normalize the produced speaking media, align its own audio to its Segment, construct its equal-lengthdiff --git a/skills/hypit/references/production/authoring.md b/skills/hypit/references/production/authoring.mdindex 67162c9d..87461ff9 100644--- a/skills/hypit/references/production/authoring.md+++ b/skills/hypit/references/production/authoring.md@@ -209,7 +209,7 @@ relevant parts of its Brief and Treatment and the affected Source, Recipe or RunRuntime activity when reuse or active execution matters. Read the relevant diff and preserve unrelated work.- Revise Treatment when the creative design changed.-- Revise Script when words, Cue breaks, Selections, or Moments changed.+- Revise Script when words, Cue membership, Selections, or Moments changed.- Revise Source or Recipe when composition, parameters, or authored timing relations changed.- Revise the Run when the demanded deliverable or selected Candidate changed.- Revise a project package when its fixed or reusable behavior needs to change; an unexposed localdiff --git a/skills/hypit/references/production/caption-authoring.md b/skills/hypit/references/production/caption-authoring.mdindex 3567cbf7..791da975 100644--- a/skills/hypit/references/production/caption-authoring.md+++ b/skills/hypit/references/production/caption-authoring.md@@ -155,8 +155,8 @@ Expose the family with useful vocabulary and a designed preview. Keep wording, fand authored word roles editable in the project. The package adds its rendering language whileconsuming the existing Script, Caption and semantic-time owners.-For live Cue entities and Inspector editing, add a [Studio Companion](studio.md#give-a-project-component-a-useful-companion)-that presents complete Cue content and authored Uses as separate lanes. Read the Track's resolved-Use collection, retain each child's Source range and temporal lineage, and expose the referenced-Style on that Use. Caption Fine's+For live Cue Items and Inspector editing, add a [Studio Companion](studio.md#give-a-project-component-a-useful-companion)+that presents complete Cue content on the Timeline and authored Uses as Inspector objects. Read the+Track's resolved Use collection, retain each Use's Source range and temporal lineage, and expose the+referenced Style on that Use. Caption Fine'sCompanion is a useful example of these relationships; the new family's layout stays in its renderer.diff --git a/skills/hypit/references/production/component-design.md b/skills/hypit/references/production/component-design.mdindex 79e4ac1d..dfe886cf 100644--- a/skills/hypit/references/production/component-design.md+++ b/skills/hypit/references/production/component-design.md@@ -216,6 +216,6 @@ An empty parameter panel alone is no reason to widen the component interface.[Companion authoring](studio-companions.md) owns those bindings.If the current project deliberately installed `@hypit/ranking`, its README is one example of-semantic reveals, settled state, layout and editor entities. Do not assume that optional package is+semantic reveals, settled state, layout and editor Items. Do not assume that optional package ispart of the Distribution or install it merely to begin a component. Carry only a relationship thatanswers the current video's need into the project component's own design.diff --git a/skills/hypit/references/production/index.md b/skills/hypit/references/production/index.mdindex 0b1641b8..ab72c0d6 100644--- a/skills/hypit/references/production/index.md+++ b/skills/hypit/references/production/index.md@@ -54,7 +54,7 @@ A-roll-only or B-roll-only.| How do I connect Surface, projections, Fragment and Producers? | [Track authoring](track-authoring.md) || How do I draw elements, video, graphics and frame-driven motion? | [Component visuals](component-visuals.md) || How do I create a new Caption layout using existing wording and timing? | [Caption authoring](caption-authoring.md) |-| How do I expose meaningful Studio entities and actual author controls? | [Studio Companions](studio-companions.md) |+| How do I expose meaningful Studio Items and actual author controls? | [Studio Companions](studio-companions.md) || How does an owner distribute and update a package across projects? | [Component sharing](component-sharing.md) |## Execute, revise and deliverdiff --git a/skills/hypit/references/production/review.md b/skills/hypit/references/production/review.mdindex 21aa6dd6..2553006a 100644--- a/skills/hypit/references/production/review.md+++ b/skills/hypit/references/production/review.md@@ -84,7 +84,7 @@ Use whichever view can answer the current question:- On an encoded Result, focused media operations such as frames, cut, and tile can expose exactpixels, adjacent frames, or a short passage.- Open Studio when interactive playback, parameter editing or a component's Companion helps the- current work. Seek or select semantic entities to inspect their place in the composition.+ current work. Seek projected domain evidence or select Track Items to inspect their place in the composition.- Use a [range render](rendering.md#choose-a-render-interval-in-frames) when the question requiresan encoded clip with sound, such as testing an export setting or delivering a passage.- Watch the whole deliverable when the question concerns Hook clarity, story movement, payoff,@@ -155,7 +155,7 @@ which of those choices belong in this piece.| What the review reveals | Where the correction belongs || --- | --- || The intended story, shot logic, or visual system is wrong | `TREATMENT.md` |-| Words, speakers, Cue breaks, Selections, or Moments are wrong | the Author Source's Script |+| Words, speakers, Cue membership, Selections, or Moments are wrong | the Author Source's Script || Composition, authored parameters, or semantic/clock relation is wrong | Author Source or Recipe || The wrong file or earlier Output is selected | Run Source || A reusable visual role cannot express or render its intended design | the project Author Package |diff --git a/skills/hypit/references/production/script-syntax.md b/skills/hypit/references/production/script-syntax.mdindex 499f74db..1f0e97ca 100644--- a/skills/hypit/references/production/script-syntax.md+++ b/skills/hypit/references/production/script-syntax.md@@ -53,7 +53,7 @@ or character asset by itself.Dual Text can contain several visible or spoken words on either side; its display side feeds Captionand its spoken side feeds pronunciation. An empty display side intentionally omits those spoken wordsfrom Caption while keeping them in the Narrative and semantic timing. Selections and Moments can be-placed on the spoken side because that side owns the speech anchors. Place Cue Breaks around the+placed on the spoken side because that side owns the speech anchors. End a Cue before or after thecomplete Dual Text unit, not inside it. Attributes for a displayed Dual Text word belong on thedisplay side before the pipe. Inside that display side, use `\@` when the visible text itself needs anat-sign.@@ -104,7 +104,7 @@ escaping described in [Source syntax](../production/source-syntax.md).Script derives speech tokens from words and numbers. Punctuation remains attached to the displayedword it belongs with and does not create another speech time unit. CJK prose commonly contributesone Han, Hiragana or Katakana character per lexical unit; compounds, decimal numbers and the spoken-side of Dual Text preserve their own lexical structure. This is why Cue breaks, word attributes and+side of Dual Text preserve their own lexical structure. This is why Cue boundaries, word attributes andsemantic markers attach to complete authored units instead of punctuation or visual line positions.Character-level timing does not call for character-sized Cues: use `||` for meaningful readingphrases. [Caption craft](../playbooks/craft/captions.md#language-changes-the-reading-unit) explainsdiff --git a/skills/hypit/references/production/source-syntax.md b/skills/hypit/references/production/source-syntax.mdindex d352c6dd..dc034afb 100644--- a/skills/hypit/references/production/source-syntax.md+++ b/skills/hypit/references/production/source-syntax.md@@ -1,7 +1,7 @@# Reading and writing Source syntaxRead this for the language around a production: imports, references, literal values, Recipes and-Run choices. [Script syntax](script-syntax.md) owns prose, Roles, Dual Text, Cue breaks, display+Run choices. [Script syntax](script-syntax.md) owns prose, Roles, Dual Text, authored Cues, displayattributes and markers. [Timing](timing.md) explains how components consume those identities.[System relationships](system.md) explains authored values and computed Outputs.diff --git a/skills/hypit/references/production/system.md b/skills/hypit/references/production/system.mdindex 531a106a..f126aa6e 100644--- a/skills/hypit/references/production/system.md+++ b/skills/hypit/references/production/system.md@@ -100,5 +100,5 @@ A Build executes the demanded graph and records completed public Outputs in itsProfiles select already installed Providers, Endpoints and credentials for external work.Studio reads the authored and executed relationships exposed by the selected packages. Companions-give useful entities and controls to a component by following its real inputs and outputs.+give useful Items and controls to a component by following its real inputs and outputs.[Authoring](authoring.md), [Runs](runs.md), [Builds](builds.md) and [Studio](studio.md) own those workflows.diff --git a/skills/hypit/references/production/track-authoring.md b/skills/hypit/references/production/track-authoring.mdindex acf661e2..a0f1f2ac 100644--- a/skills/hypit/references/production/track-authoring.md+++ b/skills/hypit/references/production/track-authoring.md@@ -127,7 +127,7 @@ Frame, fit and source-time relations. Optional examples are evidence, not prereqRanking's repository README links its implementation: `surface.ts` resolves authored time references,`fragment.ts` connects typed inputs, `schedule.ts` computes reveal and settled spans, `render.ts`-draws them, and `studio.ts` turns the same program into editor entities. Read it only when that+draws them, and `studio.ts` turns the same program into editor Items. Read it only when thatexample is relevant and available; a new project component may use fewer operations or different state.The Surface exposes author intent and resolves absolute temporal inputs through@@ -156,7 +156,7 @@ The useful pieces of a project package are:| Producer | Compute the immutable state or render program from declared inputs || Activation | Register the Manifest, deterministic handlers and Markup facets with their matching Facet ABI || Vocabulary and preview | Explain the role and show a recognizable, configured example |-| Optional Studio Companion | Project meaningful editor entities, real parameter bindings and temporal lineage without changing video rendering |+| Optional Studio Companion | Project meaningful editor Items, real parameter bindings and temporal lineage without changing video rendering |Resolve the Track's `timeline` through `resolveTemporalContext` and wire `context.timeline.ref`directly to its Timeline input. Source footage is supplied explicitly through media inputs. The@@ -197,7 +197,7 @@ Document which Outputs are public, including useful deterministic program values## Verify the behavior the component introduced-When the new role needs its own timeline entities or Inspector, read+When the new role needs its own timeline Items or Inspector, read[Companion authoring](studio-companions.md). Expose the domainschedule and temporal identities at their actual boundaries so the editor consumes them directlyinstead of reconstructing them from pixels.diff --git a/skills/hypit/references/production/vocabulary.md b/skills/hypit/references/production/vocabulary.mdindex 3f6f3df7..fb1d270f 100644--- a/skills/hypit/references/production/vocabulary.md+++ b/skills/hypit/references/production/vocabulary.md@@ -99,7 +99,7 @@ For existing Track composition, read [Tracks](tracks.md). For a new Track,state, preset content and peer visual/audio outputs. [Caption authoring](caption-authoring.md) coversa new speech-text family without rebuilding its transcript or timing.-[Studio and Companions](studio.md) covers timeline entities and Inspector editing for the new+[Studio and Companions](studio.md) covers timeline Items and Inspector editing for the newcomponent.[Component visuals](component-visuals.md) explains the actual Track and element representation,