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
feat: bind exact fonts to fine captions
kashorin872fc521de92
diff --git a/docs/quickstart/styles.md b/docs/quickstart/styles.mdindex 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. Theyconfigure 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 areimmutable 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 exampleA complete `studio.svs` file for a four-take talking-head project:diff --git a/docs/quickstart/tracks.md b/docs/quickstart/tracks.mdindex 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 parameterswithout changing the common package.diff --git a/docs/zh/quickstart/styles.md b/docs/zh/quickstart/styles.mdindex 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.mdindex 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.lockindex 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.lockindex 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.lockindex 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.mdindex 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 activationno 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.jsonindex 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.tsindex 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.tsindex 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.tsindex 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): FineCaptionParametersfontFamily: 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): voidif (!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.tsindex 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: SurfaceResolvedreturn 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.tsindex 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.tsindex 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.tsindex 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.mdindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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 ({ elemenexport 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.yamlindex 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:../narrativediff --git a/spec/caption-fine.md b/spec/caption-fine.mdindex 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 incompatiCue box and strict validation.2. **Timed lowering** — current/trail, step/wipe, Cue fades, Atom reveal and active scale using onlyproven 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.