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.

feat: bind exact fonts to fine captions

kashorin872fc521de92
diff --git a/docs/quickstart/styles.md b/docs/quickstart/styles.md
index 5ea30d86..587c0d9e 100644
--- a/docs/quickstart/styles.md
+++ b/docs/quickstart/styles.md
@@ -7,7 +7,7 @@ description: The SVS Recipe language — CSS-like stylesheets for film, caption,
SVS (`.svs`) files define reusable, typed configuration values using a CSS-like syntax. They
configure film dimensions, caption appearance, B-roll layout, text styling, speech estimation
-parameters, generation settings, and custom fonts. SVS values are called **Recipes** — they are
+parameters, generation settings, and typography choices. SVS values are called **Recipes** — they are
immutable typed Records that consuming components validate and interpret.
## Basic syntax
@@ -103,8 +103,8 @@ caption.dialogue {
| `stack-order` | Z-stacking order among all Tracks (higher = on top) |
| `x`, `y` | Position as fraction of canvas (0–1) |
| `width` | Width as fraction of canvas |
-| `font` | Font family name or SVS font reference |
-| `weight` | Font weight (400–900) |
+| `font` | Readable font-family label and environment fallback |
+| `weight` | Requested font weight (1–1000) |
| `size` | Font size in pixels |
| `line-height` | Line height multiplier |
| `align` | Text alignment: `left`, `center`, `right` |
@@ -113,10 +113,14 @@ caption.dialogue {
| `padding` | Container padding in pixels (single value or `vertical horizontal`) |
| `radius` | Container border radius in pixels |
-Resolved by the Fine Style family:
+For reproducible rendering, declare exact font bytes in the `.svml` source and pass that Record to
+the Fine Style. Its `weight` and `style` must match the Recipe:
```svml
-<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}/>
+<media:Font id="caption-font" src="./assets/Inter-SemiBold.woff2"
+ weight="600" style="normal"/>
+<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}
+ font={caption-font}/>
```
### Per-role caption styles
@@ -303,40 +307,37 @@ Referenced by `speaker:Take` via the `recipe` attribute:
duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>
```
-## Font declarations
+## Exact font declarations
-Declare local font files for use in captions and text overlays.
+SVS describes typography policy, but it does not open files. Declare each concrete font face in
+the author source with the independently imported Media package:
-```svs
-font.inter-semibold {
- src: ./assets/Inter-SemiBold.woff2;
- weight: 600;
- style: normal;
-}
+```svml
+<import as="media" from="@narratage/media@1"/>
-font.inter-black {
- src: ./assets/Inter-Black.woff2;
- weight: 900;
- style: normal;
-}
+<media:Font id="inter-semibold" src="./assets/Inter-SemiBold.woff2"
+ weight="600" style="normal"/>
+<media:Font id="inter-black" src="./assets/Inter-Black.woff2"
+ weight="900" style="normal"/>
```
| Property | Description |
|---|---|
-| `src` | Path to the font file (relative to the SVS file) |
+| `src` | Path to the font file, relative to the author source |
| `weight` | Font weight this file provides |
-| `style` | Font style: `normal`, `italic` |
+| `style` | Font style: `normal`, `italic`, `oblique` |
-Font paths are resolved at compile time and become `FontArtifactRef` values. Reference them by name
-in other SVS blocks:
+The compiler resolves the source bytes into a content-addressed `FontArtifactRef`. A consuming
+component chooses it with a normal source reference; the Runtime never guesses a font:
-```svs
-caption.dialogue {
- font: inter-semibold;
- /* ... */
-}
+```svml
+<caption-fine:Style id="dialogue" recipe={studio.caption.dialogue}
+ font={inter-semibold}/>
```
+Omitting `font=` keeps the Recipe's `font` family as an environment fallback, which is convenient
+for prototypes but is not byte-reproducible.
+
## Combination example
A complete `studio.svs` file for a four-take talking-head project:
diff --git a/docs/quickstart/tracks.md b/docs/quickstart/tracks.md
index 2e7c835d..6bc93748 100644
--- a/docs/quickstart/tracks.md
+++ b/docs/quickstart/tracks.md
@@ -21,6 +21,7 @@ Script Display → Caption Program → Planner + measured Atom timing → Style-
<import as="caption" from="@narratage/caption@1"/>
<import as="caption-fine" from="@narratage/caption-fine@1"/>
<import as="caption-ai" from="@narratage/caption-gemini@1"/>
+<import as="media" from="@narratage/media@1"/>
```
`@narratage/caption` owns only common Cue bounds, generic optional per-Word fields, total Style
@@ -56,9 +57,16 @@ caption.primary {
```
```svml
-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}/>
+<media:Font id="caption-font" src="./assets/Inter-Bold.woff2"
+ weight="700" style="normal"/>
+<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}
+ font={caption-font}/>
```
+The explicit `font=` edge makes the rendered face byte-reproducible. Omitting it deliberately uses
+the Recipe's `font` family as an environment fallback; neither Caption nor the Runtime chooses a
+font on the author's behalf.
+
Another Caption package may define completely different planning fields and visual parameters
without changing the common package.
diff --git a/docs/zh/quickstart/styles.md b/docs/zh/quickstart/styles.md
index 232f4562..a1995cbb 100644
--- a/docs/zh/quickstart/styles.md
+++ b/docs/zh/quickstart/styles.md
@@ -5,7 +5,7 @@ description: SVS Recipe 语言——用于影片、字幕、B-roll、文本及
# SVS 样式表
-SVS(`.svs`)文件使用类 CSS 语法定义可复用的类型化配置值。它们用于配置影片尺寸、字幕外观、B-roll 布局、文本样式、语音估算参数、生成设置和自定义字体。SVS 中的值称为 **Recipe**——它们是不可变的类型化记录,由消费组件进行验证和解释。
+SVS(`.svs`)文件使用类 CSS 语法定义可复用的类型化配置值。它们用于配置影片尺寸、字幕外观、B-roll 布局、文本样式、语音估算参数、生成设置和字体选择。SVS 中的值称为 **Recipe**——它们是不可变的类型化记录,由消费组件进行验证和解释。
## 基本语法
@@ -99,8 +99,8 @@ caption.dialogue {
| `stack-order` | 所有 Track 之间的 Z 轴层叠顺序(值越大越靠前) |
| `x`、`y` | 位置,以画布比例表示(0–1) |
| `width` | 宽度,以画布比例表示 |
-| `font` | 字体族名称或 SVS 字体引用 |
-| `weight` | 字体粗细(400–900) |
+| `font` | 便于阅读的字体族标签,也是环境字体兜底名 |
+| `weight` | 请求的字体粗细(1–1000) |
| `size` | 字体大小(像素) |
| `line-height` | 行高倍数 |
| `align` | 文本对齐方式:`left`、`center`、`right` |
@@ -109,10 +109,14 @@ caption.dialogue {
| `padding` | 容器内边距(像素)(单个值或 `垂直 水平`) |
| `radius` | 容器圆角半径(像素) |
-由 Fine 样式族解析:
+若要可复现渲染,应在 `.svml` 源码中显式声明字体字节,并把该 Record 传给 Fine Style。
+它的 `weight` 与 `style` 必须和 Recipe 一致:
```svml
-<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}/>
+<media:Font id="caption-font" src="./assets/Inter-SemiBold.woff2"
+ weight="600" style="normal"/>
+<caption-fine:Style id="primary-caption" recipe={studio.caption.dialogue}
+ font={caption-font}/>
```
### 按角色设置字幕样式
@@ -298,39 +302,36 @@ speaker.host {
duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>
```
-## 字体声明
+## 精确字体声明
-声明本地字体文件,以便在字幕和文本叠加层中使用。
+SVS 描述字体策略,但不负责打开文件。具体字体文件由独立导入的 Media 包在作者源码中
+声明:
-```svs
-font.inter-semibold {
- src: ./assets/Inter-SemiBold.woff2;
- weight: 600;
- style: normal;
-}
+```svml
+<import as="media" from="@narratage/media@1"/>
-font.inter-black {
- src: ./assets/Inter-Black.woff2;
- weight: 900;
- style: normal;
-}
+<media:Font id="inter-semibold" src="./assets/Inter-SemiBold.woff2"
+ weight="600" style="normal"/>
+<media:Font id="inter-black" src="./assets/Inter-Black.woff2"
+ weight="900" style="normal"/>
```
| 属性 | 描述 |
|---|---|
-| `src` | 字体文件路径(相对于 SVS 文件) |
+| `src` | 字体文件路径(相对于作者源码) |
| `weight` | 该文件提供的字体粗细 |
-| `style` | 字体样式:`normal`、`italic` |
+| `style` | 字体样式:`normal`、`italic`、`oblique` |
-字体路径在编译时解析,并成为 `FontArtifactRef` 值。在其他 SVS 块中通过名称引用:
+编译器把字体字节解析为内容寻址的 `FontArtifactRef`。消费组件通过普通源码引用选择它,
+Runtime 不猜字体:
-```svs
-caption.dialogue {
- font: inter-semibold;
- /* ... */
-}
+```svml
+<caption-fine:Style id="dialogue" recipe={studio.caption.dialogue}
+ font={inter-semibold}/>
```
+省略 `font=` 时会使用 Recipe 的环境字体兜底名,适合原型,但不能保证字节级复现。
+
## 综合示例
一个完整的 `studio.svs` 文件,用于四段式说话人头像项目:
diff --git a/docs/zh/quickstart/tracks.md b/docs/zh/quickstart/tracks.md
index 397eb78a..9e210c94 100644
--- a/docs/zh/quickstart/tracks.md
+++ b/docs/zh/quickstart/tracks.md
@@ -19,6 +19,7 @@ Script 显示全集 → Caption Program → Planner + Atom 实测时间 → 样
<import as="caption" from="@narratage/caption@1"/>
<import as="caption-fine" from="@narratage/caption-fine@1"/>
<import as="caption-ai" from="@narratage/caption-gemini@1"/>
+<import as="media" from="@narratage/media@1"/>
```
公共 Caption 只负责 Cue 字数边界、可选的通用逐词字段、完整样式分配、Plan 校验与时间
@@ -30,9 +31,15 @@ Script 显示全集 → Caption Program → Planner + Atom 实测时间 → 样
同时解析两者:
```svml
-<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}/>
+<media:Font id="caption-font" src="./assets/Inter-Bold.woff2"
+ weight="700" style="normal"/>
+<caption-fine:Style id="primary-caption" recipe={studio.caption.primary}
+ font={caption-font}/>
```
+显式的 `font=` 边让最终字体按字节复现。省略它则明确使用 Recipe 的环境字体兜底名;
+Caption 和 Runtime 都不会替作者猜字体。
+
Recipe 同时包含 `cue-min-words`、`cue-max-words` 和完整字体/框参数。Fine 不声明任何
逐词字段;其他字幕包可以定义完全不同的字段和渲染方式,无需修改公共 Caption。
diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lock
index cb9703a9..87812392 100644
--- a/examples/talking-film-graph-check/svml.packages.lock
+++ b/examples/talking-film-graph-check/svml.packages.lock
@@ -14,7 +14,7 @@
{
"name": "@narratage/caption-fine",
"version": "0.0.0-dev",
- "digest": "sha256:0452abadd910c04ffe197aaf574dab31e86aa5b7ecbb290b96e707dc56270301"
+ "digest": "sha256:5e13972ce06fd1b210f983f78d773bf88512995145e1356c1962d8b7d9fee944"
},
{
"name": "@narratage/caption-gemini",
@@ -46,6 +46,11 @@
"version": "0.0.0-dev",
"digest": "sha256:9ae85decc3e3678dbe05a1322c5f595277afcd649242ad5c36b3782252e89037"
},
+ {
+ "name": "@narratage/estimate",
+ "version": "0.0.0-dev",
+ "digest": "sha256:48a96423e9f8a7fdf59f139231a5ec3fdbcbd862c99fa3277d879cf12be2d60e"
+ },
{
"name": "@narratage/film",
"version": "0.0.0-dev",
@@ -64,7 +69,7 @@
{
"name": "@narratage/hyperframes",
"version": "0.0.0-dev",
- "digest": "sha256:0820d7ff158593d190a7d111a51575bb0134e3e6aadbc369ac2cd7462e2027ff"
+ "digest": "sha256:fc1c5605c166c53e2d378cf5cfac7f8dc6ba20a40fcfdcd89a96e8447577d9bf"
},
{
"name": "@narratage/media-pipeline",
@@ -74,7 +79,7 @@
{
"name": "@narratage/media",
"version": "0.0.0-dev",
- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"
+ "digest": "sha256:12749906e7765272675e84f49ca6f693db35ff2fa1c7017fdf76848e0b320fd6"
},
{
"name": "@narratage/model-kit",
@@ -203,8 +208,8 @@
"name": "@narratage/broll",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:22290ed789d8ca7425ad00f88c69f59db17d85ad3bd6c359528941a3b7f56498",
- "closureDigest": "sha256:aca8a03f76c53ecb87efec9b94ddf2b6754ed35a8428cee005451ba116ce60c4"
+ "facetsDigest": "sha256:bb932858857392bc32be3d7118847cb5617c674c947e0448c5af2c3063d10467",
+ "closureDigest": "sha256:971901ee2ebd3083873295bfc8c41e0e369c9c1bc4b312e19d86ec7c7e0bb7e0"
},
{
"specifier": "@narratage/caption",
@@ -212,8 +217,8 @@
"name": "@narratage/caption",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b92b73928d937b1825a4f026a5864ddd0d4bd6af73ae7a4699c4dbd0ce3a8e0",
- "closureDigest": "sha256:98690f96d5049bd1627db8b69774abc83dbe4593dd7fd40038ff6da43b6d091a"
+ "facetsDigest": "sha256:f55b3793382d3914af4e1610b018f46f09c3c8698c24b452f00fb7822a47e61d",
+ "closureDigest": "sha256:ac8ea0abc90b57bc81f45c00b1fb7494b558d343dd69d09bf903675e8b0382cc"
},
{
"specifier": "@narratage/caption-fine",
@@ -221,8 +226,8 @@
"name": "@narratage/caption-fine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:932f0dc0aeb21c2725938e909fdcb725f78cfb9e84acdde757312ecd4c6bf98b",
- "closureDigest": "sha256:6f4255b153c991ebaf98505f385ddcea258fef7f43372d5795d239060b6aa85f"
+ "facetsDigest": "sha256:7c1efe270d1d063fbdfb2ee652ca568860b09b007ced8d01068ff8052175d320",
+ "closureDigest": "sha256:6ef02ec445f09476d1ebb6d25acb1b6eccdb27eb76727a450f990273e8ec1182"
},
{
"specifier": "@narratage/caption-gemini",
@@ -230,8 +235,8 @@
"name": "@narratage/caption-gemini",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:bdb5bc2561b4f91f72db885edbcef4caaeb8665861009166d0965c2d97182666",
- "closureDigest": "sha256:33f7f84ca4e31c17262831816af63d7336fd1d706e79e02372f30f807254adfc"
+ "facetsDigest": "sha256:f8c1f1732560ec1ca6d53d00ba2641306498d8cee04fb71ea8f425703b58824f",
+ "closureDigest": "sha256:596afdb0b7c7c6972a5cf39e4e2c571656a5497347d57ff26da072d6345c1e42"
},
{
"specifier": "@narratage/composition",
@@ -239,8 +244,17 @@
"name": "@narratage/composition",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",
- "closureDigest": "sha256:0d3642864d00b894d390e68f4ef575baa278414935ea227202fb3b572ecf1efb"
+ "facetsDigest": "sha256:8102164a4e7d552a0c6f0b71a11a187a92f4937dda70fc77aef0c87be5d0de97",
+ "closureDigest": "sha256:c34c7577473640ec1bd7ef6603e482360ad10c0c12e8c848f7e9bcd241dacc5c"
+ },
+ {
+ "specifier": "@narratage/estimate",
+ "package": {
+ "name": "@narratage/estimate",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:01a9f9480e5148b935189822a882cd97b97864210e749d5b938ad5ed70cae480",
+ "closureDigest": "sha256:ee696bd54cac9315e4468b8be3e3cacb232358084e15b1a0ce5c4157f90c6707"
},
{
"specifier": "@narratage/film",
@@ -248,8 +262,8 @@
"name": "@narratage/film",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",
- "closureDigest": "sha256:d5b125075c494cd26a4d428d4a6caed63ce911771ef28fcebf361602e85e6e73"
+ "facetsDigest": "sha256:b53df97a3a79570783d42d259525bf8c0c5b22bdc3e2bcd5cc1b70ed99b8b3f0",
+ "closureDigest": "sha256:3b1548a91f396fb8b10dc075b84718ebdd6e54ae7b586c1603bd0e74c3e360ee"
},
{
"specifier": "@narratage/generation",
@@ -266,8 +280,8 @@
"name": "@narratage/hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:34bcacd52b6d396bf53f3b9709b43d54377a48c3b0332180079c3488a7fbe6ec",
- "closureDigest": "sha256:42d6b8d39c487e32626945db0064babdd7f833277d8c22f0f5f1cce01b9ab926"
+ "facetsDigest": "sha256:8a18bd638a89adcd7e3865db23f82f6b56ffe79353cb7c71ef906d3485559a28",
+ "closureDigest": "sha256:0d9b05c526fa0a6c2cb8ab1542e0de9b601187a3101dc23d784ea1bc20a5eb96"
},
{
"specifier": "@narratage/media",
@@ -275,8 +289,8 @@
"name": "@narratage/media",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",
- "closureDigest": "sha256:0906fb66319369378e604c5afdf4a466d215a575c679cd9ff244d68c6f8986c1"
+ "facetsDigest": "sha256:2c64e5461601b35f1f4fd33cb6d1aacffe1626997826b3ad0e7cd3022e5ea97d",
+ "closureDigest": "sha256:af9c33fbecf18356f0aedc6c325ddd5dcc0d49c083acb2cdadede0f8ccbde002"
},
{
"specifier": "@narratage/media-pipeline",
@@ -284,8 +298,8 @@
"name": "@narratage/media-pipeline",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b66155f5949570bfb11b31b20645615188cd6b0ffd034b1386b20f81a9bed42",
- "closureDigest": "sha256:e4c966ba99f2f0f8a08bb732c7ca431a46e7af4c6a5eeec204dff7c11194af92"
+ "facetsDigest": "sha256:f47ad9f4294bba90db402bbc31433bc7047d79c094aced1f82d351662083d08c",
+ "closureDigest": "sha256:7226552b961ae944672c413fa930972ffada24fe9e1d141c0e04c97aa6ef5887"
},
{
"specifier": "@narratage/narrative",
@@ -311,8 +325,8 @@
"name": "@narratage/render-hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:146a78ac53e7d5bf6910c62534e729d7567043636068ac9026e6ee6002cbc947",
- "closureDigest": "sha256:19ffeb84182908e096d97aa96d33420e80c9626b653711cbf55b87dededdbf4d"
+ "facetsDigest": "sha256:dd7a1214338a4622e92dba3ff8b9368609905f99d36f8f178be7e29a2e8022d8",
+ "closureDigest": "sha256:b50c56f978353cba701f31434c567ce9f1b4421d82c1f4533c3245f3d4c52815"
},
{
"specifier": "@narratage/run-text",
@@ -338,8 +352,8 @@
"name": "@narratage/seedance",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:e33699a3f4b87279ca22fa2c3422012013a3b91368355cffd10a5a529b6a7ca4",
- "closureDigest": "sha256:11a501219f1f0f2d0f8ded90f24892ff16f8230a3e89136b8ebc71d842ef0e94"
+ "facetsDigest": "sha256:779bdf82621e2620d80b3fbb28c26c4b17b444edec2c34d734cbe09fda37e940",
+ "closureDigest": "sha256:accb9f0d3c04396dc23a0b3a699025fe2d0f37aadc8825786a4b4e97644c700f"
},
{
"specifier": "@narratage/semantic-map",
@@ -347,8 +361,8 @@
"name": "@narratage/semantic-map",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ee0976d45ddcf1c3ad79e0e2b1dc3d3481035a11bc1752e437407aa1e2055f34",
- "closureDigest": "sha256:099227a8ca88bc795efe84b06862fb914e6ed52c2778dbee521378b1a9ab232d"
+ "facetsDigest": "sha256:fa5c3dc9284ea29640882446576ec85d3fc403c659418cc089c85f2432e3d1eb",
+ "closureDigest": "sha256:fd8e5ce84b61dd74cead0c4b5636e7afbb774f3602641cb82e6404fa0eba116e"
},
{
"specifier": "@narratage/speech",
@@ -356,8 +370,8 @@
"name": "@narratage/speech",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:0c006d9930a89bf8eb30db761c533ce478fcfc2f6c3697ffb76e0684284f63c1",
- "closureDigest": "sha256:3af835a772697839c4f2eff6da7f44636767ebc54071353a917ce9ad3a2be542"
+ "facetsDigest": "sha256:93fea1a4354429848dcc8cc07c0794584076c31b23174af04a7a1049fe894e7a",
+ "closureDigest": "sha256:7901f6de03dc5571fed05d83dae4c6fd67cdce80564a0f6b62d7c4988395557f"
},
{
"specifier": "@narratage/speech-alignment",
@@ -365,8 +379,8 @@
"name": "@narratage/speech-alignment",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:75e2dc61bb3cc417c5be0a04712b41bf9769c1940ec1764378d1a117bfd004d8",
- "closureDigest": "sha256:fb2641832716592148a15a5f6cee2c05e8aa26311ad35d84a58ce7affcb5e74c"
+ "facetsDigest": "sha256:2b20c17351fb4dc00153a8780994fbc55024353bdb6e9f0840b75f7ccc410624",
+ "closureDigest": "sha256:9146e19f65beca2db7c471b85da38a2a0a595dd862faa84ea6e12077f9fef71c"
},
{
"specifier": "@narratage/speech-basis",
@@ -374,8 +388,8 @@
"name": "@narratage/speech-basis",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:cc802b2e713bd0e92e838eb1803bed926e07658972b18aa6da596a89017bffd0",
- "closureDigest": "sha256:2da1a922a375087e76ada57d92cfa9510a6e119218ca12756c59202ccc46e137"
+ "facetsDigest": "sha256:5b6bdbe8919dde81ef3fa115b403a63540238eae0709580474c807139b9b9500",
+ "closureDigest": "sha256:45f88ffd8bc59920fca94ae0365492978d198c50c43b3f7d6c633a68e5303664"
},
{
"specifier": "@narratage/speech-evidence",
@@ -383,8 +397,8 @@
"name": "@narratage/speech-evidence",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:4814f163a676c156b5a436182a041c3ea7c3154459b48108897395d015d65098",
- "closureDigest": "sha256:3c253b02645a0fde101f85b0997a116485227fed74dad05fe58c8d7bfe5f0a7a"
+ "facetsDigest": "sha256:4bbf8af020b61f2f3bd466ad4430af454fa19ff0af6009a74ff25d61c355ca70",
+ "closureDigest": "sha256:768eadf4f7b7d85770bcf04af3cddd106c191274c96d5bfe7ced72a02453b2a7"
},
{
"specifier": "@narratage/speech-spine",
@@ -392,8 +406,8 @@
"name": "@narratage/speech-spine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:2d5b77c3e4fe6e1f2737134659877198999ba4e7b43f6ba6c5477db615632817",
- "closureDigest": "sha256:902ed264e7876cef0b96bdd73d75301761984a4f772e25083280b22a7335f4cb"
+ "facetsDigest": "sha256:97f981766691c75e6cfc88a89587c2b51dc2a77f351b2517b5470be24f43ed6f",
+ "closureDigest": "sha256:361c66a9f4c0d9257bda4e2c4077e4d865675a870a62afab9a7a5f1c055eb962"
},
{
"specifier": "@narratage/svs",
@@ -410,8 +424,8 @@
"name": "@narratage/text-track",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c86bf1dacd060148ce6b7d1151c5c9ccb9640c92aee9348fa3cac02f76e7491b",
- "closureDigest": "sha256:a553084e5e5f46971364a9b763ca2d0a876133169bd4e5f312f6318c3119e7aa"
+ "facetsDigest": "sha256:73bb6171b032c98f1498ccdf811fed8e6d49f0fe6472cf01ba9c48cf2a636454",
+ "closureDigest": "sha256:396e5bb24ce44e423cb3d9197e568a80bcd8f85e443200c85a728bcf4e9c4f7e"
},
{
"specifier": "@narratage/visual-ir",
@@ -428,9 +442,9 @@
"name": "@narratage/whisperx",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c53108f29b771a1238fe124428927d200c0dadef6a25724f77ce62c8d80a4738",
- "closureDigest": "sha256:c6634d4fdc7dfafb8b16e4219018957528f27e581c892a9344f894c820bde296"
+ "facetsDigest": "sha256:7f105887894a1271ee3edabc46a65d653138a11cf01137368c35ad6e65f76185",
+ "closureDigest": "sha256:4e3758c963992904ed7997e3dfcad69f8c6547d8a36ca52ffd62ac2bb913530b"
}
],
- "digest": "sha256:8b85a7310c8dce55f460d1505e427f19f3ca644185b30c6c4372aa1c4f927273"
+ "digest": "sha256:3c5b0371cd2f7a143bba634f8739c3b4978f48c81ac8697349899642a6d456d4"
}
diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lock
index 84841948..fa8bbc34 100644
--- a/examples/talking-film-live/svml.packages.lock
+++ b/examples/talking-film-live/svml.packages.lock
@@ -9,7 +9,7 @@
{
"name": "@narratage/caption-fine",
"version": "0.0.0-dev",
- "digest": "sha256:0452abadd910c04ffe197aaf574dab31e86aa5b7ecbb290b96e707dc56270301"
+ "digest": "sha256:5e13972ce06fd1b210f983f78d773bf88512995145e1356c1962d8b7d9fee944"
},
{
"name": "@narratage/caption-gemini",
@@ -64,7 +64,7 @@
{
"name": "@narratage/hyperframes",
"version": "0.0.0-dev",
- "digest": "sha256:0820d7ff158593d190a7d111a51575bb0134e3e6aadbc369ac2cd7462e2027ff"
+ "digest": "sha256:fc1c5605c166c53e2d378cf5cfac7f8dc6ba20a40fcfdcd89a96e8447577d9bf"
},
{
"name": "@narratage/media-pipeline",
@@ -74,7 +74,7 @@
{
"name": "@narratage/media",
"version": "0.0.0-dev",
- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"
+ "digest": "sha256:12749906e7765272675e84f49ca6f693db35ff2fa1c7017fdf76848e0b320fd6"
},
{
"name": "@narratage/model-kit",
@@ -203,8 +203,8 @@
"name": "@narratage/caption",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b92b73928d937b1825a4f026a5864ddd0d4bd6af73ae7a4699c4dbd0ce3a8e0",
- "closureDigest": "sha256:98690f96d5049bd1627db8b69774abc83dbe4593dd7fd40038ff6da43b6d091a"
+ "facetsDigest": "sha256:f55b3793382d3914af4e1610b018f46f09c3c8698c24b452f00fb7822a47e61d",
+ "closureDigest": "sha256:ac8ea0abc90b57bc81f45c00b1fb7494b558d343dd69d09bf903675e8b0382cc"
},
{
"specifier": "@narratage/caption-fine",
@@ -212,8 +212,8 @@
"name": "@narratage/caption-fine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:932f0dc0aeb21c2725938e909fdcb725f78cfb9e84acdde757312ecd4c6bf98b",
- "closureDigest": "sha256:6f4255b153c991ebaf98505f385ddcea258fef7f43372d5795d239060b6aa85f"
+ "facetsDigest": "sha256:7c1efe270d1d063fbdfb2ee652ca568860b09b007ced8d01068ff8052175d320",
+ "closureDigest": "sha256:6ef02ec445f09476d1ebb6d25acb1b6eccdb27eb76727a450f990273e8ec1182"
},
{
"specifier": "@narratage/caption-gemini",
@@ -221,8 +221,8 @@
"name": "@narratage/caption-gemini",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:bdb5bc2561b4f91f72db885edbcef4caaeb8665861009166d0965c2d97182666",
- "closureDigest": "sha256:33f7f84ca4e31c17262831816af63d7336fd1d706e79e02372f30f807254adfc"
+ "facetsDigest": "sha256:f8c1f1732560ec1ca6d53d00ba2641306498d8cee04fb71ea8f425703b58824f",
+ "closureDigest": "sha256:596afdb0b7c7c6972a5cf39e4e2c571656a5497347d57ff26da072d6345c1e42"
},
{
"specifier": "@narratage/composition",
@@ -230,8 +230,8 @@
"name": "@narratage/composition",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",
- "closureDigest": "sha256:0d3642864d00b894d390e68f4ef575baa278414935ea227202fb3b572ecf1efb"
+ "facetsDigest": "sha256:8102164a4e7d552a0c6f0b71a11a187a92f4937dda70fc77aef0c87be5d0de97",
+ "closureDigest": "sha256:c34c7577473640ec1bd7ef6603e482360ad10c0c12e8c848f7e9bcd241dacc5c"
},
{
"specifier": "@narratage/estimate",
@@ -239,8 +239,8 @@
"name": "@narratage/estimate",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:e12b59419cfadb67a2066ef31977f2f23aa5540dbadb20215599f1f7eab16824",
- "closureDigest": "sha256:17dde773aa24a177093ced2060e14216f7b47e1732688965f6354ca5132d521e"
+ "facetsDigest": "sha256:01a9f9480e5148b935189822a882cd97b97864210e749d5b938ad5ed70cae480",
+ "closureDigest": "sha256:ee696bd54cac9315e4468b8be3e3cacb232358084e15b1a0ce5c4157f90c6707"
},
{
"specifier": "@narratage/film",
@@ -248,8 +248,8 @@
"name": "@narratage/film",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",
- "closureDigest": "sha256:d5b125075c494cd26a4d428d4a6caed63ce911771ef28fcebf361602e85e6e73"
+ "facetsDigest": "sha256:b53df97a3a79570783d42d259525bf8c0c5b22bdc3e2bcd5cc1b70ed99b8b3f0",
+ "closureDigest": "sha256:3b1548a91f396fb8b10dc075b84718ebdd6e54ae7b586c1603bd0e74c3e360ee"
},
{
"specifier": "@narratage/generation",
@@ -266,8 +266,8 @@
"name": "@narratage/hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:34bcacd52b6d396bf53f3b9709b43d54377a48c3b0332180079c3488a7fbe6ec",
- "closureDigest": "sha256:42d6b8d39c487e32626945db0064babdd7f833277d8c22f0f5f1cce01b9ab926"
+ "facetsDigest": "sha256:8a18bd638a89adcd7e3865db23f82f6b56ffe79353cb7c71ef906d3485559a28",
+ "closureDigest": "sha256:0d9b05c526fa0a6c2cb8ab1542e0de9b601187a3101dc23d784ea1bc20a5eb96"
},
{
"specifier": "@narratage/media",
@@ -275,8 +275,8 @@
"name": "@narratage/media",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",
- "closureDigest": "sha256:0906fb66319369378e604c5afdf4a466d215a575c679cd9ff244d68c6f8986c1"
+ "facetsDigest": "sha256:2c64e5461601b35f1f4fd33cb6d1aacffe1626997826b3ad0e7cd3022e5ea97d",
+ "closureDigest": "sha256:af9c33fbecf18356f0aedc6c325ddd5dcc0d49c083acb2cdadede0f8ccbde002"
},
{
"specifier": "@narratage/media-pipeline",
@@ -284,8 +284,8 @@
"name": "@narratage/media-pipeline",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b66155f5949570bfb11b31b20645615188cd6b0ffd034b1386b20f81a9bed42",
- "closureDigest": "sha256:e4c966ba99f2f0f8a08bb732c7ca431a46e7af4c6a5eeec204dff7c11194af92"
+ "facetsDigest": "sha256:f47ad9f4294bba90db402bbc31433bc7047d79c094aced1f82d351662083d08c",
+ "closureDigest": "sha256:7226552b961ae944672c413fa930972ffada24fe9e1d141c0e04c97aa6ef5887"
},
{
"specifier": "@narratage/narrative",
@@ -311,8 +311,8 @@
"name": "@narratage/render-hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:146a78ac53e7d5bf6910c62534e729d7567043636068ac9026e6ee6002cbc947",
- "closureDigest": "sha256:19ffeb84182908e096d97aa96d33420e80c9626b653711cbf55b87dededdbf4d"
+ "facetsDigest": "sha256:dd7a1214338a4622e92dba3ff8b9368609905f99d36f8f178be7e29a2e8022d8",
+ "closureDigest": "sha256:b50c56f978353cba701f31434c567ce9f1b4421d82c1f4533c3245f3d4c52815"
},
{
"specifier": "@narratage/run-text",
@@ -338,8 +338,8 @@
"name": "@narratage/seedance",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:e33699a3f4b87279ca22fa2c3422012013a3b91368355cffd10a5a529b6a7ca4",
- "closureDigest": "sha256:11a501219f1f0f2d0f8ded90f24892ff16f8230a3e89136b8ebc71d842ef0e94"
+ "facetsDigest": "sha256:779bdf82621e2620d80b3fbb28c26c4b17b444edec2c34d734cbe09fda37e940",
+ "closureDigest": "sha256:accb9f0d3c04396dc23a0b3a699025fe2d0f37aadc8825786a4b4e97644c700f"
},
{
"specifier": "@narratage/semantic-map",
@@ -347,8 +347,8 @@
"name": "@narratage/semantic-map",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ee0976d45ddcf1c3ad79e0e2b1dc3d3481035a11bc1752e437407aa1e2055f34",
- "closureDigest": "sha256:099227a8ca88bc795efe84b06862fb914e6ed52c2778dbee521378b1a9ab232d"
+ "facetsDigest": "sha256:fa5c3dc9284ea29640882446576ec85d3fc403c659418cc089c85f2432e3d1eb",
+ "closureDigest": "sha256:fd8e5ce84b61dd74cead0c4b5636e7afbb774f3602641cb82e6404fa0eba116e"
},
{
"specifier": "@narratage/speech",
@@ -356,8 +356,8 @@
"name": "@narratage/speech",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:0c006d9930a89bf8eb30db761c533ce478fcfc2f6c3697ffb76e0684284f63c1",
- "closureDigest": "sha256:3af835a772697839c4f2eff6da7f44636767ebc54071353a917ce9ad3a2be542"
+ "facetsDigest": "sha256:93fea1a4354429848dcc8cc07c0794584076c31b23174af04a7a1049fe894e7a",
+ "closureDigest": "sha256:7901f6de03dc5571fed05d83dae4c6fd67cdce80564a0f6b62d7c4988395557f"
},
{
"specifier": "@narratage/speech-alignment",
@@ -365,8 +365,8 @@
"name": "@narratage/speech-alignment",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:75e2dc61bb3cc417c5be0a04712b41bf9769c1940ec1764378d1a117bfd004d8",
- "closureDigest": "sha256:fb2641832716592148a15a5f6cee2c05e8aa26311ad35d84a58ce7affcb5e74c"
+ "facetsDigest": "sha256:2b20c17351fb4dc00153a8780994fbc55024353bdb6e9f0840b75f7ccc410624",
+ "closureDigest": "sha256:9146e19f65beca2db7c471b85da38a2a0a595dd862faa84ea6e12077f9fef71c"
},
{
"specifier": "@narratage/speech-basis",
@@ -374,8 +374,8 @@
"name": "@narratage/speech-basis",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:cc802b2e713bd0e92e838eb1803bed926e07658972b18aa6da596a89017bffd0",
- "closureDigest": "sha256:2da1a922a375087e76ada57d92cfa9510a6e119218ca12756c59202ccc46e137"
+ "facetsDigest": "sha256:5b6bdbe8919dde81ef3fa115b403a63540238eae0709580474c807139b9b9500",
+ "closureDigest": "sha256:45f88ffd8bc59920fca94ae0365492978d198c50c43b3f7d6c633a68e5303664"
},
{
"specifier": "@narratage/speech-evidence",
@@ -383,8 +383,8 @@
"name": "@narratage/speech-evidence",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:4814f163a676c156b5a436182a041c3ea7c3154459b48108897395d015d65098",
- "closureDigest": "sha256:3c253b02645a0fde101f85b0997a116485227fed74dad05fe58c8d7bfe5f0a7a"
+ "facetsDigest": "sha256:4bbf8af020b61f2f3bd466ad4430af454fa19ff0af6009a74ff25d61c355ca70",
+ "closureDigest": "sha256:768eadf4f7b7d85770bcf04af3cddd106c191274c96d5bfe7ced72a02453b2a7"
},
{
"specifier": "@narratage/speech-spine",
@@ -392,8 +392,8 @@
"name": "@narratage/speech-spine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:2d5b77c3e4fe6e1f2737134659877198999ba4e7b43f6ba6c5477db615632817",
- "closureDigest": "sha256:902ed264e7876cef0b96bdd73d75301761984a4f772e25083280b22a7335f4cb"
+ "facetsDigest": "sha256:97f981766691c75e6cfc88a89587c2b51dc2a77f351b2517b5470be24f43ed6f",
+ "closureDigest": "sha256:361c66a9f4c0d9257bda4e2c4077e4d865675a870a62afab9a7a5f1c055eb962"
},
{
"specifier": "@narratage/svs",
@@ -410,8 +410,8 @@
"name": "@narratage/text-track",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c86bf1dacd060148ce6b7d1151c5c9ccb9640c92aee9348fa3cac02f76e7491b",
- "closureDigest": "sha256:a553084e5e5f46971364a9b763ca2d0a876133169bd4e5f312f6318c3119e7aa"
+ "facetsDigest": "sha256:73bb6171b032c98f1498ccdf811fed8e6d49f0fe6472cf01ba9c48cf2a636454",
+ "closureDigest": "sha256:396e5bb24ce44e423cb3d9197e568a80bcd8f85e443200c85a728bcf4e9c4f7e"
},
{
"specifier": "@narratage/visual-ir",
@@ -428,9 +428,9 @@
"name": "@narratage/whisperx",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c53108f29b771a1238fe124428927d200c0dadef6a25724f77ce62c8d80a4738",
- "closureDigest": "sha256:c6634d4fdc7dfafb8b16e4219018957528f27e581c892a9344f894c820bde296"
+ "facetsDigest": "sha256:7f105887894a1271ee3edabc46a65d653138a11cf01137368c35ad6e65f76185",
+ "closureDigest": "sha256:4e3758c963992904ed7997e3dfcad69f8c6547d8a36ca52ffd62ac2bb913530b"
}
],
- "digest": "sha256:1a1c839057fe0c4a575f5dc660868d8008cdf33a1f9a6e690c046abb3a04ecc0"
+ "digest": "sha256:61881034be53f952835f1d3d069f8393ac3350028d6e77cf26ad0faa2473ea31"
}
diff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lock
index c0313a61..b6b2aa68 100644
--- a/examples/talking-head-aroll/svml.packages.lock
+++ b/examples/talking-head-aroll/svml.packages.lock
@@ -9,7 +9,7 @@
{
"name": "@narratage/caption-fine",
"version": "0.0.0-dev",
- "digest": "sha256:0452abadd910c04ffe197aaf574dab31e86aa5b7ecbb290b96e707dc56270301"
+ "digest": "sha256:5e13972ce06fd1b210f983f78d773bf88512995145e1356c1962d8b7d9fee944"
},
{
"name": "@narratage/caption-gemini",
@@ -64,7 +64,7 @@
{
"name": "@narratage/hyperframes",
"version": "0.0.0-dev",
- "digest": "sha256:0820d7ff158593d190a7d111a51575bb0134e3e6aadbc369ac2cd7462e2027ff"
+ "digest": "sha256:fc1c5605c166c53e2d378cf5cfac7f8dc6ba20a40fcfdcd89a96e8447577d9bf"
},
{
"name": "@narratage/media-pipeline",
@@ -74,7 +74,7 @@
{
"name": "@narratage/media",
"version": "0.0.0-dev",
- "digest": "sha256:d92f53d5060df53a7a671b58b8c0d1305be99384bd34e71bda0f7f1296550f4b"
+ "digest": "sha256:12749906e7765272675e84f49ca6f693db35ff2fa1c7017fdf76848e0b320fd6"
},
{
"name": "@narratage/model-kit",
@@ -208,8 +208,8 @@
"name": "@narratage/caption",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b92b73928d937b1825a4f026a5864ddd0d4bd6af73ae7a4699c4dbd0ce3a8e0",
- "closureDigest": "sha256:98690f96d5049bd1627db8b69774abc83dbe4593dd7fd40038ff6da43b6d091a"
+ "facetsDigest": "sha256:f55b3793382d3914af4e1610b018f46f09c3c8698c24b452f00fb7822a47e61d",
+ "closureDigest": "sha256:ac8ea0abc90b57bc81f45c00b1fb7494b558d343dd69d09bf903675e8b0382cc"
},
{
"specifier": "@narratage/caption-fine",
@@ -217,8 +217,8 @@
"name": "@narratage/caption-fine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:932f0dc0aeb21c2725938e909fdcb725f78cfb9e84acdde757312ecd4c6bf98b",
- "closureDigest": "sha256:6f4255b153c991ebaf98505f385ddcea258fef7f43372d5795d239060b6aa85f"
+ "facetsDigest": "sha256:7c1efe270d1d063fbdfb2ee652ca568860b09b007ced8d01068ff8052175d320",
+ "closureDigest": "sha256:6ef02ec445f09476d1ebb6d25acb1b6eccdb27eb76727a450f990273e8ec1182"
},
{
"specifier": "@narratage/caption-gemini",
@@ -226,8 +226,8 @@
"name": "@narratage/caption-gemini",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:bdb5bc2561b4f91f72db885edbcef4caaeb8665861009166d0965c2d97182666",
- "closureDigest": "sha256:33f7f84ca4e31c17262831816af63d7336fd1d706e79e02372f30f807254adfc"
+ "facetsDigest": "sha256:f8c1f1732560ec1ca6d53d00ba2641306498d8cee04fb71ea8f425703b58824f",
+ "closureDigest": "sha256:596afdb0b7c7c6972a5cf39e4e2c571656a5497347d57ff26da072d6345c1e42"
},
{
"specifier": "@narratage/composition",
@@ -235,8 +235,8 @@
"name": "@narratage/composition",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ec680d429d88ec1c55531125a18c1620fea0c81600de55ba6d43c4fbf873e480",
- "closureDigest": "sha256:0d3642864d00b894d390e68f4ef575baa278414935ea227202fb3b572ecf1efb"
+ "facetsDigest": "sha256:8102164a4e7d552a0c6f0b71a11a187a92f4937dda70fc77aef0c87be5d0de97",
+ "closureDigest": "sha256:c34c7577473640ec1bd7ef6603e482360ad10c0c12e8c848f7e9bcd241dacc5c"
},
{
"specifier": "@narratage/estimate",
@@ -244,8 +244,8 @@
"name": "@narratage/estimate",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:e12b59419cfadb67a2066ef31977f2f23aa5540dbadb20215599f1f7eab16824",
- "closureDigest": "sha256:17dde773aa24a177093ced2060e14216f7b47e1732688965f6354ca5132d521e"
+ "facetsDigest": "sha256:01a9f9480e5148b935189822a882cd97b97864210e749d5b938ad5ed70cae480",
+ "closureDigest": "sha256:ee696bd54cac9315e4468b8be3e3cacb232358084e15b1a0ce5c4157f90c6707"
},
{
"specifier": "@narratage/film",
@@ -253,8 +253,8 @@
"name": "@narratage/film",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:61839fefb8cf723e9b55f4ac0932928b2dba5de4935ca03c0c4335246c6ab5d8",
- "closureDigest": "sha256:d5b125075c494cd26a4d428d4a6caed63ce911771ef28fcebf361602e85e6e73"
+ "facetsDigest": "sha256:b53df97a3a79570783d42d259525bf8c0c5b22bdc3e2bcd5cc1b70ed99b8b3f0",
+ "closureDigest": "sha256:3b1548a91f396fb8b10dc075b84718ebdd6e54ae7b586c1603bd0e74c3e360ee"
},
{
"specifier": "@narratage/generation",
@@ -271,8 +271,8 @@
"name": "@narratage/hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:34bcacd52b6d396bf53f3b9709b43d54377a48c3b0332180079c3488a7fbe6ec",
- "closureDigest": "sha256:42d6b8d39c487e32626945db0064babdd7f833277d8c22f0f5f1cce01b9ab926"
+ "facetsDigest": "sha256:8a18bd638a89adcd7e3865db23f82f6b56ffe79353cb7c71ef906d3485559a28",
+ "closureDigest": "sha256:0d9b05c526fa0a6c2cb8ab1542e0de9b601187a3101dc23d784ea1bc20a5eb96"
},
{
"specifier": "@narratage/media",
@@ -280,8 +280,8 @@
"name": "@narratage/media",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c883f03447734dc30a6c239c828083e6e9708258e457f845c2cfa5a2f95c0387",
- "closureDigest": "sha256:0906fb66319369378e604c5afdf4a466d215a575c679cd9ff244d68c6f8986c1"
+ "facetsDigest": "sha256:2c64e5461601b35f1f4fd33cb6d1aacffe1626997826b3ad0e7cd3022e5ea97d",
+ "closureDigest": "sha256:af9c33fbecf18356f0aedc6c325ddd5dcc0d49c083acb2cdadede0f8ccbde002"
},
{
"specifier": "@narratage/media-pipeline",
@@ -289,8 +289,8 @@
"name": "@narratage/media-pipeline",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:1b66155f5949570bfb11b31b20645615188cd6b0ffd034b1386b20f81a9bed42",
- "closureDigest": "sha256:e4c966ba99f2f0f8a08bb732c7ca431a46e7af4c6a5eeec204dff7c11194af92"
+ "facetsDigest": "sha256:f47ad9f4294bba90db402bbc31433bc7047d79c094aced1f82d351662083d08c",
+ "closureDigest": "sha256:7226552b961ae944672c413fa930972ffada24fe9e1d141c0e04c97aa6ef5887"
},
{
"specifier": "@narratage/narrative",
@@ -325,8 +325,8 @@
"name": "@narratage/render-hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:146a78ac53e7d5bf6910c62534e729d7567043636068ac9026e6ee6002cbc947",
- "closureDigest": "sha256:19ffeb84182908e096d97aa96d33420e80c9626b653711cbf55b87dededdbf4d"
+ "facetsDigest": "sha256:dd7a1214338a4622e92dba3ff8b9368609905f99d36f8f178be7e29a2e8022d8",
+ "closureDigest": "sha256:b50c56f978353cba701f31434c567ce9f1b4421d82c1f4533c3245f3d4c52815"
},
{
"specifier": "@narratage/run-text",
@@ -352,8 +352,8 @@
"name": "@narratage/seedance",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:e33699a3f4b87279ca22fa2c3422012013a3b91368355cffd10a5a529b6a7ca4",
- "closureDigest": "sha256:11a501219f1f0f2d0f8ded90f24892ff16f8230a3e89136b8ebc71d842ef0e94"
+ "facetsDigest": "sha256:779bdf82621e2620d80b3fbb28c26c4b17b444edec2c34d734cbe09fda37e940",
+ "closureDigest": "sha256:accb9f0d3c04396dc23a0b3a699025fe2d0f37aadc8825786a4b4e97644c700f"
},
{
"specifier": "@narratage/seedance-speaker",
@@ -361,8 +361,8 @@
"name": "@narratage/seedance-speaker",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:2ee6645b4e1707f33fd3db99b285098644fff13b4329e0a107612b800b087b95",
- "closureDigest": "sha256:d6e27a8ba274c2e9a05d1d35619fad87a65dd5406925ed05761263df0ebb297e"
+ "facetsDigest": "sha256:e203b50acdba039a246287a880c5fe00d5d614a9c64d88e47b7faf13cc5fe0b2",
+ "closureDigest": "sha256:ba7421ef831e6075fb00477b9721ca4520a1b1938fdb6c41b27a12ba4bc879a9"
},
{
"specifier": "@narratage/semantic-map",
@@ -370,8 +370,8 @@
"name": "@narratage/semantic-map",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ee0976d45ddcf1c3ad79e0e2b1dc3d3481035a11bc1752e437407aa1e2055f34",
- "closureDigest": "sha256:099227a8ca88bc795efe84b06862fb914e6ed52c2778dbee521378b1a9ab232d"
+ "facetsDigest": "sha256:fa5c3dc9284ea29640882446576ec85d3fc403c659418cc089c85f2432e3d1eb",
+ "closureDigest": "sha256:fd8e5ce84b61dd74cead0c4b5636e7afbb774f3602641cb82e6404fa0eba116e"
},
{
"specifier": "@narratage/speech",
@@ -379,8 +379,8 @@
"name": "@narratage/speech",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:0c006d9930a89bf8eb30db761c533ce478fcfc2f6c3697ffb76e0684284f63c1",
- "closureDigest": "sha256:3af835a772697839c4f2eff6da7f44636767ebc54071353a917ce9ad3a2be542"
+ "facetsDigest": "sha256:93fea1a4354429848dcc8cc07c0794584076c31b23174af04a7a1049fe894e7a",
+ "closureDigest": "sha256:7901f6de03dc5571fed05d83dae4c6fd67cdce80564a0f6b62d7c4988395557f"
},
{
"specifier": "@narratage/speech-alignment",
@@ -388,8 +388,8 @@
"name": "@narratage/speech-alignment",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:75e2dc61bb3cc417c5be0a04712b41bf9769c1940ec1764378d1a117bfd004d8",
- "closureDigest": "sha256:fb2641832716592148a15a5f6cee2c05e8aa26311ad35d84a58ce7affcb5e74c"
+ "facetsDigest": "sha256:2b20c17351fb4dc00153a8780994fbc55024353bdb6e9f0840b75f7ccc410624",
+ "closureDigest": "sha256:9146e19f65beca2db7c471b85da38a2a0a595dd862faa84ea6e12077f9fef71c"
},
{
"specifier": "@narratage/speech-basis",
@@ -397,8 +397,8 @@
"name": "@narratage/speech-basis",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:cc802b2e713bd0e92e838eb1803bed926e07658972b18aa6da596a89017bffd0",
- "closureDigest": "sha256:2da1a922a375087e76ada57d92cfa9510a6e119218ca12756c59202ccc46e137"
+ "facetsDigest": "sha256:5b6bdbe8919dde81ef3fa115b403a63540238eae0709580474c807139b9b9500",
+ "closureDigest": "sha256:45f88ffd8bc59920fca94ae0365492978d198c50c43b3f7d6c633a68e5303664"
},
{
"specifier": "@narratage/speech-evidence",
@@ -406,8 +406,8 @@
"name": "@narratage/speech-evidence",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:4814f163a676c156b5a436182a041c3ea7c3154459b48108897395d015d65098",
- "closureDigest": "sha256:3c253b02645a0fde101f85b0997a116485227fed74dad05fe58c8d7bfe5f0a7a"
+ "facetsDigest": "sha256:4bbf8af020b61f2f3bd466ad4430af454fa19ff0af6009a74ff25d61c355ca70",
+ "closureDigest": "sha256:768eadf4f7b7d85770bcf04af3cddd106c191274c96d5bfe7ced72a02453b2a7"
},
{
"specifier": "@narratage/speech-spine",
@@ -415,8 +415,8 @@
"name": "@narratage/speech-spine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:2d5b77c3e4fe6e1f2737134659877198999ba4e7b43f6ba6c5477db615632817",
- "closureDigest": "sha256:902ed264e7876cef0b96bdd73d75301761984a4f772e25083280b22a7335f4cb"
+ "facetsDigest": "sha256:97f981766691c75e6cfc88a89587c2b51dc2a77f351b2517b5470be24f43ed6f",
+ "closureDigest": "sha256:361c66a9f4c0d9257bda4e2c4077e4d865675a870a62afab9a7a5f1c055eb962"
},
{
"specifier": "@narratage/svs",
@@ -442,9 +442,9 @@
"name": "@narratage/whisperx",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:c53108f29b771a1238fe124428927d200c0dadef6a25724f77ce62c8d80a4738",
- "closureDigest": "sha256:c6634d4fdc7dfafb8b16e4219018957528f27e581c892a9344f894c820bde296"
+ "facetsDigest": "sha256:7f105887894a1271ee3edabc46a65d653138a11cf01137368c35ad6e65f76185",
+ "closureDigest": "sha256:4e3758c963992904ed7997e3dfcad69f8c6547d8a36ca52ffd62ac2bb913530b"
}
],
- "digest": "sha256:b745b8193c9659e651cb612d17550702cb3deaedfd37c7cca01061d20a188af1"
+ "digest": "sha256:ea0ecf1eea16ea80dc8a88a900fb4206d723971a8c2a3c3b2d5b582c05f8e2c3"
}
diff --git a/packages/caption-fine/README.md b/packages/caption-fine/README.md
index c4c63e40..d26275b4 100644
--- a/packages/caption-fine/README.md
+++ b/packages/caption-fine/README.md
@@ -9,7 +9,8 @@ per-word timing while a Dual Text Atom remains one honest indivisible activation
no planning fields and has no `important`, random sizing or inferred Word timestamps.
```xml
-<fine:Style id="primary" recipe={studio.caption.primary}/>
+<media:Font id="caption-font" src="./Inter-SemiBold.woff2" weight="600" style="normal"/>
+<fine:Style id="primary" recipe={studio.caption.primary} font={caption-font}/>
<caption:Program id="captions" display={story.caption} default={primary}/>
@@ -24,6 +25,8 @@ no planning fields and has no `important`, random sizing or inferred Word timest
/>
```
-One Track handles the default and ordered Style replacements. Common Caption, Media, Composition
-and Core know none of Fine's Recipe fields or layout policy. See `spec/caption-fine.md` for the full
-parameter surface, defaults, non-goals and remaining visual evidence gates.
+One Track handles the default and ordered Style replacements. `font=` is optional for environment
+font prototyping and explicit for reproducible builds; it references the existing Media
+`FontArtifactRef` and must match the Recipe's weight/style. Common Caption, Composition and Core
+know none of Fine's Recipe fields or layout policy. See `spec/caption-fine.md` for the full parameter
+surface, defaults, non-goals and remaining visual evidence gates.
diff --git a/packages/caption-fine/package.json b/packages/caption-fine/package.json
index 920b1fef..58e57a50 100644
--- a/packages/caption-fine/package.json
+++ b/packages/caption-fine/package.json
@@ -14,6 +14,7 @@
"@narratage/component-kit": "workspace:*",
"@narratage/composition": "workspace:*",
"@narratage/elaborator": "workspace:*",
+ "@narratage/media": "workspace:*",
"@narratage/narrative": "workspace:*",
"@narratage/program-space": "workspace:*",
"@narratage/protocol": "workspace:*",
diff --git a/packages/caption-fine/src/manifest.ts b/packages/caption-fine/src/manifest.ts
index 36cd7ce5..5f2f63a5 100644
--- a/packages/caption-fine/src/manifest.ts
+++ b/packages/caption-fine/src/manifest.ts
@@ -1,5 +1,6 @@
import { captionManifest, captionModuleRef, captionTypes } from "@narratage/caption";
import { compositionDependency, compositionTypes } from "@narratage/composition";
+import { mediaDependency } from "@narratage/media";
import { programSpaceDependency, programSpaceTypes } from "@narratage/program-space";
import { narrativeDependency, narrativeTypes } from "@narratage/narrative";
import { semanticMapDependency } from "@narratage/semantic-map";
@@ -12,7 +13,7 @@ export const captionFineModuleRef = { name: "@narratage/caption-fine", version:
export const captionFineProducers = {
render: { module: captionFineModuleRef, name: "render-fine-caption" },
} satisfies Record<string, ProducerRef>;
-export const captionFineStyleSurfaceImplementationDigest = digestOf("@narratage/caption-fine/complete-style-surface@1");
+export const captionFineStyleSurfaceImplementationDigest = digestOf("@narratage/caption-fine/exact-font-style-surface@1");
export const captionFineTrackSurfaceImplementationDigest = digestOf("@narratage/caption-fine/whole-atom-track-surface@1");
export const captionFineManifest: ModuleManifest = {
@@ -22,6 +23,7 @@ export const captionFineManifest: ModuleManifest = {
dependencies: [
{ module: captionModuleRef, digest: digestOf(captionManifest) },
compositionDependency,
+ mediaDependency,
narrativeDependency,
programSpaceDependency,
semanticMapDependency,
diff --git a/packages/caption-fine/src/render.ts b/packages/caption-fine/src/render.ts
index 0defd29d..deac2033 100644
--- a/packages/caption-fine/src/render.ts
+++ b/packages/caption-fine/src/render.ts
@@ -55,10 +55,12 @@ function glyphStyle(parameters: FineCaptionParameters, paint: FineCaptionGlyphPa
}
return [
{ name: "color", value: paint.fill },
- { name: "font-family", value: parameters.typography.fontFamily },
{ name: "font-size", value: `${compactNumber(parameters.typography.fontSizePx)}px` },
- { name: "font-style", value: parameters.typography.fontStyle },
- { name: "font-weight", value: parameters.typography.fontWeight },
+ ...(parameters.typography.exactFont === undefined ? [
+ { name: "font-family", value: parameters.typography.fontFamily },
+ { name: "font-style", value: parameters.typography.fontStyle },
+ { name: "font-weight", value: parameters.typography.fontWeight },
+ ] as const : []),
{ name: "letter-spacing", value: `${compactNumber(parameters.layout.letterSpacingPx)}px` },
{ name: "line-height", value: parameters.layout.lineHeight },
{ name: "opacity", value: paint.opacity },
@@ -253,6 +255,7 @@ function cueElements(
kind: "text",
text,
style: glyphStyle(parameters, parameters.basePaint),
+ ...(parameters.typography.exactFont === undefined ? {} : { fonts: [parameters.typography.exactFont] }),
attributes: [{ name: "data-caption-word", value: wordId }],
});
}
@@ -282,6 +285,7 @@ function cueElements(
kind: "text",
text,
style: glyphStyle(parameters, parameters.activePaint),
+ ...(parameters.typography.exactFont === undefined ? {} : { fonts: [parameters.typography.exactFont] }),
attributes: [{ name: "data-caption-active-word", value: wordId }],
});
}
diff --git a/packages/caption-fine/src/style.ts b/packages/caption-fine/src/style.ts
index 575ea829..10430811 100644
--- a/packages/caption-fine/src/style.ts
+++ b/packages/caption-fine/src/style.ts
@@ -1,5 +1,7 @@
import type { CaptionStyleIntent } from "@narratage/caption";
import { sealCaptionStyle } from "@narratage/caption";
+import { assertFontArtifactRef } from "@narratage/media";
+import type { FontArtifactRef } from "@narratage/media";
import type { SvsRecipe } from "@narratage/svs";
import type { FineCaptionGlyphPaint, FineCaptionParameters } from "./types.js";
@@ -130,7 +132,7 @@ function assertPaint(value: FineCaptionGlyphPaint, label: string): void {
}
}
-export function fineCaptionParameters(recipe: SvsRecipe): FineCaptionParameters {
+export function fineCaptionParameters(recipe: SvsRecipe, exactFont?: FontArtifactRef): FineCaptionParameters {
for (const name of REQUIRED_PROPERTIES) required(recipe, name);
const unknown = Object.keys(recipe.properties).filter((name) => !ALLOWED_PROPERTIES.has(name));
if (unknown.length > 0) throw new Error(`Fine Caption Recipe contains unknown property ${unknown[0]}`);
@@ -159,7 +161,8 @@ export function fineCaptionParameters(recipe: SvsRecipe): FineCaptionParameters
fontFamily: string(recipe, "font"),
fontSizePx,
fontWeight: integer(recipe, "weight"),
- fontStyle: choice(recipe, "font-style", ["normal", "italic"] as const, "normal"),
+ fontStyle: choice(recipe, "font-style", ["normal", "italic", "oblique"] as const, "normal"),
+ ...(exactFont === undefined ? {} : { exactFont }),
},
basePaint,
activePaint: glyphPaint(recipe, "active-", basePaint),
@@ -207,13 +210,20 @@ export function assertFineCaptionParameters(value: FineCaptionParameters): void
if (!value.typography.fontFamily.trim() || value.typography.fontWeight < 1 || value.typography.fontWeight > 1000) {
throw new Error("Fine Caption typography is invalid");
}
+ if (value.typography.exactFont !== undefined) {
+ assertFontArtifactRef(value.typography.exactFont, "Fine Caption exact Font");
+ if (value.typography.exactFont.weight !== value.typography.fontWeight
+ || value.typography.exactFont.style !== value.typography.fontStyle) {
+ throw new Error("Fine Caption exact Font face must match Recipe weight and font-style");
+ }
+ }
assertColor(value.cueBox.background, "Fine Caption background");
assertColor(value.cueBox.borderColor, "Fine Caption border color");
assertPaint(value.basePaint, "Fine Caption base Paint");
assertPaint(value.activePaint, "Fine Caption active Paint");
}
-export function fineCaptionStyle(id: string, recipe: SvsRecipe): CaptionStyleIntent {
+export function fineCaptionStyle(id: string, recipe: SvsRecipe, exactFont?: FontArtifactRef): CaptionStyleIntent {
const minimumWords = integer(recipe, "cue-min-words");
const maximumWords = integer(recipe, "cue-max-words");
if (minimumWords <= 0 || maximumWords < minimumWords) {
@@ -232,7 +242,7 @@ export function fineCaptionStyle(id: string, recipe: SvsRecipe): CaptionStyleInt
},
rendering: {
family: FINE_CAPTION_FAMILY,
- parameters: fineCaptionParameters(recipe),
+ parameters: fineCaptionParameters(recipe, exactFont),
},
});
}
diff --git a/packages/caption-fine/src/surface.ts b/packages/caption-fine/src/surface.ts
index e2bcaddc..6901ccbc 100644
--- a/packages/caption-fine/src/surface.ts
+++ b/packages/caption-fine/src/surface.ts
@@ -1,4 +1,6 @@
import { captionTypes } from "@narratage/caption";
+import { assertFontArtifactRef, mediaTypes } from "@narratage/media";
+import type { FontArtifactRef } from "@narratage/media";
import { narrativeTypes } from "@narratage/narrative";
import { programSpaceTypes } from "@narratage/program-space";
import { semanticMapTypes } from "@narratage/semantic-map";
@@ -18,10 +20,12 @@ function sameType(left: SurfaceResolvedReference["type"], right: SurfaceResolved
return left.module.name === right.module.name && left.module.version === right.module.version && left.name === right.name;
}
-function attributes(element: StructuredElement, required: readonly string[]): void {
+function attributes(element: StructuredElement, required: readonly string[], optional: readonly string[] = []): void {
const actual = Object.keys(element.attributes);
- if (required.some((name) => element.attributes[name] === undefined) || actual.some((name) => !required.includes(name))) {
- throw new Error(`${element.name} requires exactly ${required.join(", ")}`);
+ const allowed = new Set([...required, ...optional]);
+ if (required.some((name) => element.attributes[name] === undefined) || actual.some((name) => !allowed.has(name))) {
+ const suffix = optional.length === 0 ? "" : `, with optional ${optional.join(", ")}`;
+ throw new Error(`${element.name} requires ${required.join(", ")}${suffix}`);
}
}
@@ -53,13 +57,21 @@ function inline<T>(referenceValue: SurfaceResolvedReference, subject: string): T
}
export const decodeFineCaptionStyleSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {
- attributes(element, ["id", "recipe"]);
+ attributes(element, ["id", "recipe"], ["font"]);
if (element.children.some((child) => child.kind === "element" || child.value.trim())) {
throw new Error(`${element.name} does not accept children`);
}
const id = stringAttribute(element, "id");
const recipe = inline<SvsRecipe>(reference(element, "recipe", svsRecipeType, resolveReference), `${element.name}.recipe`);
- const style = fineCaptionStyle(id, recipe);
+ const fontAttribute = element.attributes.font;
+ const exactFont = fontAttribute === undefined
+ ? undefined
+ : inline<FontArtifactRef>(
+ reference(element, "font", mediaTypes.fontArtifact, resolveReference),
+ `${element.name}.font`,
+ );
+ if (exactFont !== undefined) assertFontArtifactRef(exactFont, `${element.name}.font`);
+ const style = fineCaptionStyle(id, recipe, exactFont);
return {
records: [{ id, type: captionTypes.style, value: { kind: "inline", value: style }, range: element.range }],
components: [],
diff --git a/packages/caption-fine/src/types.ts b/packages/caption-fine/src/types.ts
index a1de7466..ee3e9fd6 100644
--- a/packages/caption-fine/src/types.ts
+++ b/packages/caption-fine/src/types.ts
@@ -1,3 +1,5 @@
+import type { FontArtifactRef } from "@narratage/media";
+
export type FineCaptionGlyphPaint = {
readonly fill: string;
readonly opacity: number;
@@ -40,7 +42,8 @@ export type FineCaptionParameters = {
readonly fontFamily: string;
readonly fontSizePx: number;
readonly fontWeight: number;
- readonly fontStyle: "normal" | "italic";
+ readonly fontStyle: "normal" | "italic" | "oblique";
+ readonly exactFont?: FontArtifactRef;
};
readonly basePaint: FineCaptionGlyphPaint;
readonly activePaint: FineCaptionGlyphPaint;
diff --git a/packages/caption-fine/test/caption-fine.test.ts b/packages/caption-fine/test/caption-fine.test.ts
index 92f0da95..b1f6cf45 100644
--- a/packages/caption-fine/test/caption-fine.test.ts
+++ b/packages/caption-fine/test/caption-fine.test.ts
@@ -4,7 +4,9 @@ import test from "node:test";
import { resolveCaptionProgram } from "@narratage/caption";
import type { TimedCaptionProjection } from "@narratage/caption";
import { fineCaptionParameters, fineCaptionStyle, renderFineCaption } from "@narratage/caption-fine";
+import type { FontArtifactRef } from "@narratage/media";
import { sealProgramSpace } from "@narratage/program-space";
+import { digestOf } from "@narratage/protocol";
import { captionDisplaySequence, parseScript } from "@narratage/script";
import type { SvsRecipe } from "@narratage/svs";
@@ -30,6 +32,13 @@ const recipe: SvsRecipe = {
},
};
+const exactFont: FontArtifactRef = {
+ contract: "svml.font-artifact@1",
+ artifact: { kind: "blob", digest: digestOf("caption-fine:test-font"), size: 1_024, mediaType: "font/woff2" },
+ weight: 800,
+ style: "normal",
+};
+
test("one Fine renderer handles uniform Cue appearance as one peer VisualTrack", () => {
const narrative = parseScript("fine.svml", "<line>Meaning becomes visible.</line>");
const display = captionDisplaySequence(narrative, "story.caption");
@@ -190,6 +199,37 @@ test("Fine rejects unknown or obsolete Recipe dimensions instead of silently acc
}), /unknown property important/u);
});
+test("an exact Font is explicit Style input and reaches every base and active glyph", () => {
+ const narrative = parseScript("font.svml", "<line>Exact words.</line>");
+ const display = captionDisplaySequence(narrative, "font.caption");
+ const style = fineCaptionStyle("font", {
+ ...recipe,
+ properties: { ...recipe.properties, karaoke: "current", "active-fill": "#FFD54A" },
+ }, exactFont);
+ const program = resolveCaptionProgram(display, "font-program", style, []);
+ const projection: TimedCaptionProjection = {
+ contract: "svml.timed-caption-projection@1",
+ displaySequenceId: display.id,
+ cues: [{
+ id: "cue:font", runId: program.runs[0]!.id, styleId: style.id, segmentId: "line",
+ startSec: 0, endSec: 1,
+ atoms: display.atoms.map((atom) => ({ atomId: atom.id, startSec: 0, endSec: 1 })),
+ fields: [],
+ }],
+ };
+ const space = sealProgramSpace({
+ contract: "svml.program-space@1", durationSec: 1, frameRate: { numerator: 30, denominator: 1 },
+ });
+ const track = renderFineCaption(projection, program, display, space);
+ const glyphs = track.presents[0]!.elements.filter((element) => element.kind === "text");
+ assert.ok(glyphs.length > display.words.length);
+ assert.equal(glyphs.every((element) => element.kind === "text" && element.fonts?.length === 1), true);
+ for (const glyph of glyphs) {
+ if (glyph.kind === "text") assert.deepEqual(glyph.fonts, [exactFont]);
+ }
+ assert.throws(() => fineCaptionStyle("mismatch", recipe, { ...exactFont, weight: 700 }), /must match/u);
+});
+
test("current/trail by step/wipe have four distinct frame-exact Atom histories", () => {
const narrative = parseScript("modes.svml", "<line>First second.</line>");
const display = captionDisplaySequence(narrative, "story.caption");
diff --git a/packages/hyperframes/test/browser-visual.test.ts b/packages/hyperframes/test/browser-visual.test.ts
index 003f1c71..8a1b09e1 100644
--- a/packages/hyperframes/test/browser-visual.test.ts
+++ b/packages/hyperframes/test/browser-visual.test.ts
@@ -99,19 +99,22 @@ async function collectPngs(directory: string): Promise<string[]> {
return result.sort();
}
-function yellowPixels(file: string, width: number, height: number): number {
+function yellowPixelsByColumns(file: string, width: number, height: number, columns: number): number[] {
const decoded = spawnSync("ffmpeg", [
"-v", "error", "-i", file, "-f", "rawvideo", "-pix_fmt", "rgba", "pipe:1",
], { encoding: "buffer", timeout: 30_000 });
assert.equal(decoded.status, 0, decoded.stderr.toString());
assert.equal(decoded.stdout.byteLength, width * height * 4);
- let count = 0;
+ const counts = Array.from({ length: columns }, () => 0);
for (let index = 0; index < decoded.stdout.byteLength; index += 4) {
if (decoded.stdout[index]! > 180 && decoded.stdout[index + 1]! > 130 && decoded.stdout[index + 2]! < 140) {
- count += 1;
+ const pixel = index / 4;
+ const x = pixel % width;
+ const column = Math.min(columns - 1, Math.floor(x * columns / width));
+ counts[column]! += 1;
}
}
- return count;
+ return counts;
}
test("locked font and straight-alpha Surface survive one real Hyperframes browser frame", {
@@ -266,57 +269,80 @@ test("locked font and straight-alpha Surface survive one real Hyperframes browse
}
});
-test("Fine Caption Paint and trail wipe survive real frame rendering", {
- skip: !enabled,
+test("Fine Caption exact font, wrapping and all karaoke modes survive real browser frames", {
+ skip: !enabled || localFont === undefined,
timeout: 120_000,
}, async () => {
+ assert(localFont !== undefined);
const temp = await mkdtemp(path.join(os.tmpdir(), "svml-caption-fine-visual-"));
try {
- const width = 360;
- const height = 180;
+ const width = 720;
+ const height = 240;
const space = sealProgramSpace({
contract: "svml.program-space@1",
- durationSec: 2,
+ durationSec: 4,
frameRate: { numerator: 10, denominator: 1 },
});
- const narrative = parseScript("visual.svml", "<line>First second.</line>");
+ const narrative = parseScript("visual.svml", "<line>One two three four.</line>");
const display = captionDisplaySequence(narrative, "visual.caption");
- const recipe: SvsRecipe = {
- contract: "svml.svs-recipe@1",
- path: "caption.visual",
- properties: {
- "cue-min-words": 1, "cue-max-words": 4,
- "stack-order": 10, x: 0.5, y: 0.82, width: 0.92,
- "anchor-x": "center", "anchor-y": "bottom",
- font: "Arial", weight: 800, size: 44, "line-height": 1,
- align: "center", fill: "#FFFFFF",
- "stroke-color": "#000000", "stroke-width": 2,
- "shadow-color": "#000000", "shadow-opacity": 0.8,
- "shadow-x": 0, "shadow-y": 2, "shadow-blur": 4,
- background: "#111111CC", padding: "10 14", radius: 10,
- karaoke: "trail", "karaoke-transition": "wipe", "active-fill": "#FFD54A",
- },
- };
- const style = fineCaptionStyle("visual", recipe);
- const program = resolveCaptionProgram(display, "visual-program", style, []);
- const projection: TimedCaptionProjection = {
- contract: "svml.timed-caption-projection@1",
- displaySequenceId: display.id,
- cues: [{
- id: "visual-cue", runId: program.runs[0]!.id, styleId: style.id, segmentId: "line",
- startSec: 0, endSec: 2,
- atoms: display.atoms.map((atom, index) => ({ atomId: atom.id, startSec: index, endSec: index + 1 })),
- fields: [],
- }],
+ const fontBytes = await import("node:fs/promises").then(({ readFile }) => readFile(localFont));
+ const font: FontArtifactRef = {
+ contract: "svml.font-artifact@1",
+ artifact: { kind: "blob", digest: digest(fontBytes), size: fontBytes.byteLength, mediaType: "font/ttf" },
+ weight: 400,
+ style: "normal",
};
- const track = renderFineCaption(projection, program, display, space);
+ const modes = [
+ { mode: "current", transition: "step" },
+ { mode: "current", transition: "wipe" },
+ { mode: "trail", transition: "step" },
+ { mode: "trail", transition: "wipe" },
+ ] as const;
+ const tracks = modes.map(({ mode, transition }, index) => {
+ const recipe: SvsRecipe = {
+ contract: "svml.svs-recipe@1",
+ path: `caption.${mode}-${transition}`,
+ properties: {
+ "cue-min-words": 1, "cue-max-words": 4,
+ "stack-order": 10 + index, x: 0.125 + index * 0.25, y: 0.82, width: 0.22,
+ "anchor-x": "center", "anchor-y": "bottom",
+ font: "Exact Test Font", weight: 400, size: 32, "line-height": 1,
+ align: "center", fill: "#FFFFFF",
+ "stroke-color": "#000000", "stroke-width": 1,
+ "shadow-color": "#000000", "shadow-opacity": 0.8,
+ "shadow-x": 0, "shadow-y": 2, "shadow-blur": 3,
+ background: "#111111CC", padding: "8 10", radius: 8,
+ karaoke: mode, "karaoke-transition": transition, "active-fill": "#FFD54A",
+ },
+ };
+ const style = fineCaptionStyle(`${mode}-${transition}`, recipe, font);
+ const program = resolveCaptionProgram(display, `${mode}-${transition}-program`, style, []);
+ const projection: TimedCaptionProjection = {
+ contract: "svml.timed-caption-projection@1",
+ displaySequenceId: display.id,
+ cues: [{
+ id: `${mode}-${transition}-cue`, runId: program.runs[0]!.id, styleId: style.id, segmentId: "line",
+ startSec: 0, endSec: 4,
+ atoms: display.atoms.map((atom, atomIndex) => ({
+ atomId: atom.id, startSec: atomIndex, endSec: atomIndex + 1,
+ })),
+ fields: [],
+ }],
+ };
+ return renderFineCaption(projection, program, display, space);
+ });
const document = compileHyperframesDocument(sealComposition({
contract: "svml.composition@1",
id: "caption-fine-visual",
canvas: { width, height, clearColor: "#000000" },
- tracks: [track],
+ tracks,
}), space);
- await writeFile(path.join(temp, "index.html"), document.html);
+ assert.deepEqual(document.artifacts, [font.artifact]);
+ await copyFile(localFont, path.join(temp, "caption.ttf"));
+ await writeFile(path.join(temp, "index.html"), materializeHyperframesHtml(document, (artifact) => {
+ if (artifact.digest === font.artifact.digest) return "./caption.ttf";
+ throw new Error(`Unexpected Fine Caption visual-test Artifact ${artifact.digest}`);
+ }));
const output = path.join(temp, "frames");
await mkdir(output);
const render = spawnSync(process.execPath, [
@@ -326,11 +352,16 @@ test("Fine Caption Paint and trail wipe survive real frame rendering", {
], { encoding: "utf8", timeout: 110_000 });
assert.equal(render.status, 0, `${render.stdout}\n${render.stderr}`);
const frames = await collectPngs(output);
- assert.equal(frames.length, 20);
- const initialYellow = yellowPixels(frames[0]!, width, height);
- const finalYellow = yellowPixels(frames.at(-1)!, width, height);
- assert.ok(initialYellow < 10, `first wipe frame unexpectedly painted ${initialYellow} active pixels`);
- assert.ok(finalYellow > 100, `trail wipe painted only ${finalYellow} active pixels at the end`);
+ assert.equal(frames.length, 40);
+ const initial = yellowPixelsByColumns(frames[0]!, width, height, modes.length);
+ const final = yellowPixelsByColumns(frames.at(-1)!, width, height, modes.length);
+ assert.ok(initial[0]! > 20, `current step painted only ${initial[0]} active pixels at Cue start`);
+ assert.ok(initial[1]! < 10, `current wipe unexpectedly painted ${initial[1]} active pixels at Cue start`);
+ assert.ok(initial[2]! > 20, `trail step painted only ${initial[2]} active pixels at Cue start`);
+ assert.ok(initial[3]! < 10, `trail wipe unexpectedly painted ${initial[3]} active pixels at Cue start`);
+ assert.ok(final[0]! > 20 && final[1]! > 20, `current modes lost the final active Atom: ${final}`);
+ assert.ok(final[2]! > final[0]! * 2, `trail step did not retain prior Atoms: ${final}`);
+ assert.ok(final[3]! > final[1]! * 2, `trail wipe did not retain prior Atoms: ${final}`);
} finally {
await rm(temp, { recursive: true, force: true });
}
diff --git a/packages/media/README.md b/packages/media/README.md
index 02888aca..6265fe17 100644
--- a/packages/media/README.md
+++ b/packages/media/README.md
@@ -2,7 +2,9 @@
Author-facing media declarations for the neutral `@narratage/media` contract module.
-`<media:Image>` and `<media:Audio>` request bytes through the Host-owned source-asset capability and
-emit one content-addressed `BlobArtifact`. They do not open files themselves, inspect media, call a
-Provider or promote declared audio to speech. The consuming author package decides whether an audio
-artifact is a voice reference, soundtrack, evidence source or something else.
+`<media:Image>`, `<media:Audio>` and `<media:Font>` request bytes through the Host-owned source-asset
+capability. Image and Audio emit one content-addressed `BlobArtifact`; Font wraps the same immutable
+bytes with exact weight/style metadata as a `FontArtifactRef`. They do not open files themselves,
+inspect media, call a Provider or promote declared audio to speech. The consuming author package
+decides whether an audio artifact is a voice reference, soundtrack, evidence source or something
+else, and which visual component uses an exact Font.
diff --git a/packages/media/src/activation.ts b/packages/media/src/activation.ts
index 5688057e..01cb4bbd 100644
--- a/packages/media/src/activation.ts
+++ b/packages/media/src/activation.ts
@@ -1,7 +1,7 @@
import { createTextSurfaceHostFacet } from "@narratage/text";
import {
- decodeMediaAudioSurface, decodeMediaImageSurface, mediaComponent,
+ decodeMediaAudioSurface, decodeMediaFontSurface, decodeMediaImageSurface, mediaComponent,
mediaManifest,
mediaModuleRef,
mediaSurfaceImplementationDigests,
@@ -27,6 +27,13 @@ export const svmlPackage = {
implementationDigest: mediaSurfaceImplementationDigests.audio,
handler: decodeMediaAudioSurface,
}),
+ createTextSurfaceHostFacet({
+ module: mediaModuleRef,
+ surface: "font",
+ mode: "structured",
+ implementationDigest: mediaSurfaceImplementationDigests.font,
+ handler: decodeMediaFontSurface,
+ }),
],
};
diff --git a/packages/media/src/index.ts b/packages/media/src/index.ts
index 0bfd4038..fd3db7e4 100644
--- a/packages/media/src/index.ts
+++ b/packages/media/src/index.ts
@@ -1,5 +1,6 @@
export {
decodeMediaAudioSurface,
+ decodeMediaFontSurface,
decodeMediaImageSurface,
} from "./surface.js";
export { mediaComponent } from "./component.js";
diff --git a/packages/media/src/manifest.ts b/packages/media/src/manifest.ts
index 51a8813b..474ed7a4 100644
--- a/packages/media/src/manifest.ts
+++ b/packages/media/src/manifest.ts
@@ -15,7 +15,11 @@ export const mediaValidatorDigests = {
synchronized: digestOf("@narratage/media/validate-synchronized-media@1"), renderedVisual: digestOf("@narratage/media/validate-rendered-visual@1"),
timelineAudio: digestOf("@narratage/media/validate-timeline-audio@1"), muxed: digestOf("@narratage/media/validate-muxed-media@1"),
} as const;
-export const mediaSurfaceImplementationDigests = { image: digestOf("@narratage/media/image-surface@1"), audio: digestOf("@narratage/media/audio-surface@1") } as const;
+export const mediaSurfaceImplementationDigests = {
+ image: digestOf("@narratage/media/image-surface@1"),
+ audio: digestOf("@narratage/media/audio-surface@1"),
+ font: digestOf("@narratage/media/font-surface@1"),
+} as const;
const validator = (locator: string, digest: ReturnType<typeof digestOf>) => ({ abi: "svml.type-validator@1" as const, implementation: { kind: "registered" as const, locator, digest } });
export const mediaManifest: ModuleManifest = {
format: "svml.module@1", name: mediaModuleRef.name, version: mediaModuleRef.version, dependencies: [artifactDependency],
@@ -32,6 +36,7 @@ export const mediaManifest: ModuleManifest = {
surfaces: [
{ name: "image", tag: "Image", mode: "structured", outputs: [artifactTypes.blob], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/media/image-surface", digest: mediaSurfaceImplementationDigests.image } },
{ name: "audio", tag: "Audio", mode: "structured", outputs: [artifactTypes.blob], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/media/audio-surface", digest: mediaSurfaceImplementationDigests.audio } },
+ { name: "font", tag: "Font", mode: "structured", outputs: [mediaTypes.fontArtifact], implementation: { kind: "trusted-frontend-surface", locator: "@narratage/media/font-surface", digest: mediaSurfaceImplementationDigests.font } },
], producers: [],
};
export const mediaManifestDigest = digestOf(mediaManifest);
diff --git a/packages/media/src/surface.ts b/packages/media/src/surface.ts
index 9b21a21d..3b68c832 100644
--- a/packages/media/src/surface.ts
+++ b/packages/media/src/surface.ts
@@ -4,6 +4,9 @@ import type {
StructuredSurfaceHandler,
} from "@narratage/text";
+import { assertFontArtifactRef } from "./render.js";
+import { mediaTypes } from "./manifest.js";
+
const IMAGE_MEDIA_TYPES = new Map([
[".avif", "image/avif"],
[".gif", "image/gif"],
@@ -24,6 +27,13 @@ const AUDIO_MEDIA_TYPES = new Map([
[".wav", "audio/wav"],
]);
+const FONT_MEDIA_TYPES = new Map([
+ [".otf", "font/otf"],
+ [".ttf", "font/ttf"],
+ [".woff", "font/woff"],
+ [".woff2", "font/woff2"],
+]);
+
function stringAttribute(element: StructuredElement, name: string): string {
const value = element.attributes[name];
if (typeof value !== "string" || value.trim().length === 0) {
@@ -41,7 +51,7 @@ function assertChildrenEmpty(element: StructuredElement): void {
function mediaTypeFor(
element: StructuredElement,
source: string,
- kind: "image" | "audio",
+ kind: "image" | "audio" | "font",
known: ReadonlyMap<string, string>,
): string {
const explicit = element.attributes["media-type"];
@@ -96,3 +106,36 @@ export const decodeMediaImageSurface: StructuredSurfaceHandler = async ({ elemen
export const decodeMediaAudioSurface: StructuredSurfaceHandler = async ({ element, resolveAsset }) =>
await decodeMediaAssetSurface(element, resolveAsset, "audio", AUDIO_MEDIA_TYPES);
+
+export const decodeMediaFontSurface: StructuredSurfaceHandler = async ({ element, resolveAsset }) => {
+ const names = Object.keys(element.attributes).sort();
+ if (names.join(",") !== "id,src,style,weight" && names.join(",") !== "id,media-type,src,style,weight") {
+ throw new Error(`${element.name} requires id, src, weight and style, with optional media-type`);
+ }
+ assertChildrenEmpty(element);
+ const id = stringAttribute(element, "id");
+ const source = stringAttribute(element, "src");
+ const weight = Number(stringAttribute(element, "weight"));
+ if (!Number.isSafeInteger(weight) || weight < 1 || weight > 1_000) {
+ throw new Error(`${element.name}.weight must be an integer from 1 to 1000`);
+ }
+ const style = stringAttribute(element, "style");
+ if (style !== "normal" && style !== "italic" && style !== "oblique") {
+ throw new Error(`${element.name}.style must be normal, italic or oblique`);
+ }
+ const fontStyle = style as "normal" | "italic" | "oblique";
+ const mediaType = mediaTypeFor(element, source, "font", FONT_MEDIA_TYPES);
+ const resolved = await resolveAsset({ from: source, mediaType, range: element.range });
+ const font = {
+ contract: "svml.font-artifact@1" as const,
+ artifact: resolved.artifact,
+ weight,
+ style: fontStyle,
+ };
+ assertFontArtifactRef(font, `${element.name}.${id}`);
+ return {
+ records: [{ id, type: mediaTypes.fontArtifact, value: { kind: "inline" as const, value: font }, range: element.range }],
+ components: [],
+ fragments: [],
+ };
+};
diff --git a/packages/media/test/font-surface.test.ts b/packages/media/test/font-surface.test.ts
new file mode 100644
index 00000000..4699500c
--- /dev/null
+++ b/packages/media/test/font-surface.test.ts
@@ -0,0 +1,71 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+ decodeMediaFontSurface,
+ mediaSurfaceImplementationDigests,
+ mediaTypes,
+} from "@narratage/media";
+import { digestOf } from "@narratage/protocol";
+
+const range = { start: 0, end: 80 };
+
+test("Font Surface turns explicit author bytes and face metadata into one exact FontArtifactRef", async () => {
+ const requests: Array<{ readonly from: string; readonly mediaType: string }> = [];
+ const result = await decodeMediaFontSurface({
+ sourceName: "main.svml",
+ element: {
+ kind: "element",
+ name: "media:Font",
+ attributes: { id: "inter-bold", src: "./Inter-Bold.woff2", weight: "700", style: "normal" },
+ children: [],
+ range,
+ },
+ resolveReference: () => undefined,
+ resolveAsset: (request) => {
+ requests.push(request);
+ return {
+ artifact: {
+ kind: "blob",
+ digest: digestOf("font:inter-bold"),
+ size: 2_048,
+ mediaType: request.mediaType,
+ },
+ };
+ },
+ });
+
+ assert.deepEqual(requests, [{ from: "./Inter-Bold.woff2", mediaType: "font/woff2", range }]);
+ assert.equal(result.records.length, 1);
+ assert.deepEqual(result.records[0]!.type, mediaTypes.fontArtifact);
+ assert.deepEqual(result.records[0]!.value, {
+ kind: "inline",
+ value: {
+ contract: "svml.font-artifact@1",
+ artifact: {
+ kind: "blob",
+ digest: digestOf("font:inter-bold"),
+ size: 2_048,
+ mediaType: "font/woff2",
+ },
+ weight: 700,
+ style: "normal",
+ },
+ });
+ assert.ok(mediaSurfaceImplementationDigests.font.startsWith("sha256:"));
+});
+
+test("Font Surface rejects ambiguous files and invalid face metadata before accepting bytes", async () => {
+ const decode = (attributes: Readonly<Record<string, string>>) => decodeMediaFontSurface({
+ sourceName: "main.svml",
+ element: { kind: "element", name: "media:Font", attributes, children: [], range },
+ resolveReference: () => undefined,
+ resolveAsset: () => {
+ throw new Error("invalid Font declarations must fail before resolving bytes");
+ },
+ });
+
+ await assert.rejects(async () => await decode({ id: "font", src: "./font.bin", weight: "700", style: "normal" }), /known font extension/u);
+ await assert.rejects(async () => await decode({ id: "font", src: "./font.ttf", weight: "heavy", style: "normal" }), /integer/u);
+ await assert.rejects(async () => await decode({ id: "font", src: "./font.ttf", weight: "700", style: "slanted" }), /normal, italic or oblique/u);
+});
diff --git a/packages/video-cli/test/cli.test.ts b/packages/video-cli/test/cli.test.ts
index c8f5ceae..167f72cc 100644
--- a/packages/video-cli/test/cli.test.ts
+++ b/packages/video-cli/test/cli.test.ts
@@ -109,6 +109,41 @@ test("official video CLI checks a real Script source through the Node compiler h
]);
});
+test("author source binds exact Font bytes to a Fine Caption Style", async () => {
+ const root = await mkdtemp(join(tmpdir(), "svml-cli-caption-font-"));
+ const file = join(root, "main.svml");
+ const fontBytes = new Uint8Array([119, 79, 70, 50, 0, 1, 0, 0]);
+ await writeFile(join(root, "caption.woff2"), fontBytes);
+ await writeFile(join(root, "studio.svs"), `<?svml using="@narratage/svs@1"?>
+<sheet version="1">
+ caption.primary {
+ cue-min-words: 1; cue-max-words: 4;
+ stack-order: 20; x: 0.5; y: 0.9; width: 0.8;
+ align: center; font: Studio Sans; weight: 600; size: 48; line-height: 1.1;
+ fill: #ffffff; background: #00000000; padding: 0 0; radius: 0;
+ }
+</sheet>`, "utf8");
+ await writeFile(file, `<?svml using="@narratage/text@1"?>
+<svml>
+ <import as="media" from="@narratage/media@1"/>
+ <import as="caption-fine" from="@narratage/caption-fine@1"/>
+ <import as="studio" source="./studio.svs"/>
+
+ <media:Font id="caption-font" src="./caption.woff2" weight="600" style="normal"/>
+ <caption-fine:Style id="primary-caption" recipe={studio.caption.primary} font={caption-font}/>
+</svml>`, "utf8");
+
+ let output = "";
+ await runCli(["check", file], { write: (text) => { output += text; } });
+ const result = JSON.parse(output) as {
+ readonly ok: boolean;
+ readonly exports: readonly { readonly name: string; readonly kind: string }[];
+ };
+ assert.equal(result.ok, true);
+ assert.equal(result.exports.some((item) => item.name === "caption-font" && item.kind === "record"), true);
+ assert.equal(result.exports.some((item) => item.name === "primary-caption" && item.kind === "record"), true);
+});
+
test("Prompt Kit source and Speaker Surface finish prompt assembly before the Run Graph", async () => {
const root = await mkdtemp(join(tmpdir(), "svml-cli-prompt-kit-"));
const file = join(root, "main.svml");
diff --git a/packages/video-cli/test/packages.ts b/packages/video-cli/test/packages.ts
index 505f7eaa..f33cf427 100644
--- a/packages/video-cli/test/packages.ts
+++ b/packages/video-cli/test/packages.ts
@@ -1,6 +1,7 @@
import artifact from "../../artifact/src/activation.js";
import broll from "../../broll/src/activation.js";
import captionGemini from "../../caption-gemini/src/activation.js";
+import captionFine from "../../caption-fine/src/activation.js";
import caption from "../../caption/src/activation.js";
import composition from "../../composition/src/activation.js";
import estimate from "../../estimate/src/activation.js";
@@ -47,6 +48,7 @@ export const videoTestPackages = [
seedance,
seedanceSpeaker,
caption,
+ captionFine,
captionGemini,
speechAlignment,
speechBasis,
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a2f72246..43d68563 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -262,6 +262,9 @@ importers:
'@narratage/elaborator':
specifier: workspace:*
version: link:../elaborator
+ '@narratage/media':
+ specifier: workspace:*
+ version: link:../media
'@narratage/narrative':
specifier: workspace:*
version: link:../narrative
diff --git a/spec/caption-fine.md b/spec/caption-fine.md
index f61e27d4..af514180 100644
--- a/spec/caption-fine.md
+++ b/spec/caption-fine.md
@@ -53,15 +53,19 @@ maximum; it is never split to satisfy a number.
- absolute `stack-order`
The Cue naturally wraps only between Atoms. Words inside one Atom never wrap apart. A hard
-`max-lines` control is intentionally unavailable until exact font bytes and browser-measured layout
-can fail the build rather than silently clip or truncate authored text.
+`max-lines` control is intentionally unavailable until browser-measured layout can fail the build
+rather than silently clip or truncate authored text. Exact font bytes are now available; clipping
+is still forbidden.
### 3. Typography
-- `font`, `weight`, `size`, `font-style: normal | italic`
+- `font`, `weight`, `size`, `font-style: normal | italic | oblique`
-The current Recipe names an environment font. Exact `FontArtifactRef` input is a shared typography
-reproducibility gate and remains visible in the implementation table below.
+The Recipe's `font` property is a readable family label and an environment fallback. For a
+reproducible build the author declares exact bytes with `<media:Font>` and passes that value through
+the Style's optional `font=` input. The declared face weight/style must equal the Recipe. Fine puts
+that `FontArtifactRef` only on its terminal text elements; Caption, Core and unrelated graph values
+remain unchanged.
### 4. Base glyph Paint
@@ -147,9 +151,10 @@ This is one complete design, delivered progressively rather than three incompati
Cue box and strict validation.
2. **Timed lowering** — current/trail, step/wipe, Cue fades, Atom reveal and active scale using only
proven whole-Atom time.
-3. **Reproducibility freeze** — exact Font Artifact input, real browser/pixel fixtures for wrapping,
- outline/glow and all karaoke modes, then decide whether measured `max-lines` can be exposed
- without clipping.
+3. **Reproducibility freeze** — exact Font Artifact input, multiline wrapping and all four karaoke
+ modes have a real browser witness. Remaining work is broader CJK/emoji and outline/glow pixel
+ evidence, then deciding whether measured `max-lines` can be exposed without clipping.
-The first two gates require no common-contract change. The third may add an explicit Font input to
-the Fine Surface/fragment, but still does not belong in Core or common Caption.
+No gate changes Core or common Caption. Exact font selection is an explicit author-graph reference
+between the Media Font Surface and the Fine Style Surface, not metadata propagated through the
+Caption pipeline.