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.

refactor: remove pre-release scaffolding

kashorinf31cd8f2d894
diff --git a/docs/guide/testing.md b/docs/guide/testing.md
index eeae7892..7c3bacd6 100644
--- a/docs/guide/testing.md
+++ b/docs/guide/testing.md
@@ -81,10 +81,9 @@ Package boundaries are expressed by package manifests, public entry points and s
Tests exercise observable behavior at those boundaries. The repository deliberately does not use
source-text regex tests as a substitute for dependency analysis or architectural review.
-Before publication, remove customer
-or brand fixtures, credential traces, paid output artifacts, absolute workstation paths and one-off
-acceptance harnesses. Generic live tests may remain only when they are explicitly opt-in, use no
-committed secret and fail before spending money unless their gate is set.
+Do not commit customer or brand fixtures, credential traces, paid output artifacts, absolute
+workstation paths or one-off delivery harnesses. Generic live tests may remain only when they are
+explicitly opt-in, use no committed secret and fail before spending money unless their gate is set.
## Environment-gated tests
@@ -102,4 +101,4 @@ ordinary `.svml`, `.svs` and `.svrun` files that exercise specific compilation p
The `examples/` directory also serves as integration-level fixtures:
- `examples/bootstrap/` — smallest source closure check
- `examples/talking-film-graph-check/` — complete graph compilation without Providers
-- `examples/talking-head-aroll/` — live acceptance with explicit historical-Candidate reuse
+- `examples/talking-head-aroll/` — live example with explicit prior-Build Candidate reuse
diff --git a/docs/zh/guide/testing.md b/docs/zh/guide/testing.md
index d3805c49..ca139e52 100644
--- a/docs/zh/guide/testing.md
+++ b/docs/zh/guide/testing.md
@@ -71,7 +71,7 @@ test("generates a video", async (t) => {
包边界由 package manifest、公开入口和共享合同表达;测试只验证边界上可观察的行为。
仓库不再把源码文本正则当作依赖分析或架构审查的替代品。
-发布前应删除客户或品牌 fixture、凭据痕迹、付费产物、工作站绝对路径与一次性验收脚本。
+不得提交客户或品牌 fixture、凭据痕迹、付费产物、工作站绝对路径与一次性交付脚本。
通用 live test 只有在显式 opt-in、不提交秘密,并且未设置开关时能在花钱前退出的情况下才保留。
## 受环境开关控制的测试
@@ -89,4 +89,4 @@ test("generates a video", async (t) => {
`examples/` 目录同时充当集成级别的夹具:
- `examples/bootstrap/` — 最小源闭包检查
- `examples/talking-film-graph-check/` — 不含 Provider 的完整图编译
-- `examples/talking-head-aroll/` — 显式复用历史 Candidate 的实时验收
+- `examples/talking-head-aroll/` — 显式复用历史 Candidate 的 live example
diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lock
index 55bcfcc9..f32952d4 100644
--- a/examples/talking-film-graph-check/svml.packages.lock
+++ b/examples/talking-film-graph-check/svml.packages.lock
@@ -607,7 +607,7 @@
{
"name": "@narratage/composition",
"version": "0.0.0-dev",
- "digest": "sha256:4086360c8398858848898502803bcd62260b927b7357b373ae3198565af29884"
+ "digest": "sha256:d3958a1bf840c3e7f9053c841498438bc2dc21d09c1ae4ed61732581b96bf927"
},
{
"name": "@narratage/core",
@@ -622,7 +622,7 @@
{
"name": "@narratage/film",
"version": "0.0.0-dev",
- "digest": "sha256:8da8106cc8e7ca6aa5f35aa7785e998e94b3bb56e4c23ade8d98d0aebfcaeaa8"
+ "digest": "sha256:e71640bf6fe456ec81fe6ebc147284ff6f05845f971e1efff3687e80a05ccf1c"
},
{
"name": "@narratage/fonts-open",
@@ -642,7 +642,7 @@
{
"name": "@narratage/hyperframes",
"version": "0.0.0-dev",
- "digest": "sha256:c4545dc5a8f122e61795e1858e0b5ea2027ada8850de55862e0522aaee23d50a"
+ "digest": "sha256:6dd071718ced12ff468aac8a8248d635b69f588d699cc03a308eda3f4b5ec93e"
},
{
"name": "@narratage/markup",
@@ -657,7 +657,7 @@
{
"name": "@narratage/media-track",
"version": "0.0.0-dev",
- "digest": "sha256:436dff3f99b8817bb82a9197cee6167e877694ab109c18e99cd449d4db31c1bd"
+ "digest": "sha256:18f2f8d4f8f0e2bc13b1d984195f33e00cd0295ed3e8aac6b3e85bbc64408c4c"
},
{
"name": "@narratage/media",
@@ -810,8 +810,8 @@
"name": "@narratage/caption-fine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:f0fe924f01329305b8fdd73e08dca94801db2cefe623886821d9a7f50c38ff7e",
- "closureDigest": "sha256:f88256a5294f48b8ef371ba69fed62036d616a535f3f46bdd7f3a2b8827444df"
+ "facetsDigest": "sha256:cb9fb74a5edc730f01772e4819f7d7a55ecf914984d48116f72f64a1837cf128",
+ "closureDigest": "sha256:dd4a2e82d69d4300ec26a3b246158df224dd70d077f909f3b857167608d48b98"
},
{
"specifier": "@narratage/caption-gemini",
@@ -828,8 +828,8 @@
"name": "@narratage/composition",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:d0c91a61caa7303210d898183ae355ab6c5e0eb1de8bd5a0c237cd4388693104",
- "closureDigest": "sha256:50d36d83264bdde006e2a246b02f410f9c8f8cbe37d607cf76e0fccad2ca757e"
+ "facetsDigest": "sha256:b86fe5e147a331d36843aecbe7c64a4e83ad98b755242d8d1a1ba6c62551f509",
+ "closureDigest": "sha256:c2e7aa92d3ec2e2534da777ae214a1e0cc96746976f3dde8c22f5b8af7f922dc"
},
{
"specifier": "@narratage/film",
@@ -837,8 +837,8 @@
"name": "@narratage/film",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:f6e47bdf84726556e6ee174da07b7dd435b6e7b9865065f7d7cb29ec0ed5b166",
- "closureDigest": "sha256:bf1e6b7af7bc5655c65dfeda8c0ffe6f9e259ee7af1d10053a498fe5c0c6c737"
+ "facetsDigest": "sha256:8e6a1a585e853ef9b621feb918c15a2925da4ea1f05467e652d41f9202f10025",
+ "closureDigest": "sha256:48bbdab3bff8538ef8597de8a1185fe00d86df471c854a9744b8b1357e008933"
},
{
"specifier": "@narratage/fonts-open",
@@ -864,8 +864,8 @@
"name": "@narratage/hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:520234d0b029d7229e6595483e2f0d0227d20cf662363163975691e2471a767e",
- "closureDigest": "sha256:f50d2496fa900dc147c03266c37936be2f9bd6d9bca490759cabdcbde73db8a6"
+ "facetsDigest": "sha256:4b2a86382c5d544fac8c194047f6e18ff554361d97d62e165533061b03b94ae9",
+ "closureDigest": "sha256:5f5cf6bc3d0e03d23b1731f76695fe54fab9f8c2582dec785cae7251681f0a1a"
},
{
"specifier": "@narratage/media",
@@ -882,8 +882,8 @@
"name": "@narratage/media-pipeline",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:7a1238a5925a32f26bfc34131a3765626bd4c115e0d78d52ff8f47309cb20488",
- "closureDigest": "sha256:311ef2e9622af3dc2dfee6414e9941d8aba86cd294528c682239f6bf9e7f4af3"
+ "facetsDigest": "sha256:6df6afa9661002801d95b5075309a7cf31484d7ad300a5ab3f90119d34042224",
+ "closureDigest": "sha256:11b4de2019f1b32d51877f26ad98e3685c93f6abd018d05dd45d2f2deff80dc1"
},
{
"specifier": "@narratage/media-track",
@@ -891,8 +891,8 @@
"name": "@narratage/media-track",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:9be110099b64d37e76949df2684fec8d320aba9c0ca4470facb89037209ab0e0",
- "closureDigest": "sha256:d88bee4b5bde47aba43c9fca49ca5c9d6b5a9902a8f659c1b6f45d476c625305"
+ "facetsDigest": "sha256:c7cea22dcf6e37c4359284d4c2bd2a146d752aa6bf65b944a9eaa13c895675be",
+ "closureDigest": "sha256:8f0c5681d4e74f5450b86a6caa8990f7c7b394084e319ac94f4cea86cc668338"
},
{
"specifier": "@narratage/narrative",
@@ -918,8 +918,8 @@
"name": "@narratage/render-hyperframes",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:7e39e44782f671e0f778428017af6e16aea7974d87201d75dbe2b12493029241",
- "closureDigest": "sha256:998a10db021197d6dc6d665d9c5141834756f1d6cd1ac7cc35514d882a3c7e7e"
+ "facetsDigest": "sha256:2b5edae659a7d3e92e19ed591ca7d5f784f4a3b6164d33c0e201c9b180ef0323",
+ "closureDigest": "sha256:bdd4ca3ead6f15317397daa8c408e9ac1e83496433bee94c7fb48e1d95bd5809"
},
{
"specifier": "@narratage/run-markup",
@@ -990,8 +990,8 @@
"name": "@narratage/speech-basis",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:9a632d439b48eddb8754536436e133f484c2763796b640bdb80c0426b66ab36b",
- "closureDigest": "sha256:dd8ef0b8c585e184dc78fab410b9f5e9a2ce1f783f531adc133f3c514c8de70c"
+ "facetsDigest": "sha256:97aaeabe85b3e4d6a8715ea9a41ac27ef71804ae99359b631546a4382bbac9df",
+ "closureDigest": "sha256:698d3c829d4f32456b599d56ddc2121ea1975a5d282afda994897ecbaa899371"
},
{
"specifier": "@narratage/speech-evidence",
@@ -1008,8 +1008,8 @@
"name": "@narratage/speech-spine",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:3d111c730361c6ecc9aa80bbba0d0aaecade3e0335cb59aabc66df003103fd9b",
- "closureDigest": "sha256:7290165519be85bdcba51ba0a5b4a230468e2a99e218cd137ebf9f9b497ad55f"
+ "facetsDigest": "sha256:81a038765324b7a48ceb44c638faf128df31573a122989116d649dca3b3cb6d3",
+ "closureDigest": "sha256:ed14892e0df794e6dc43ba3846cd0f6a2583e065ca13e2c31c24644b26be58a9"
},
{
"specifier": "@narratage/svs",
@@ -1044,8 +1044,8 @@
"name": "@narratage/typography-track",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:110ff72f48d80b4eee9a503811bfe5e0d4bb45e733b06a1d73c7bd205d40b81d",
- "closureDigest": "sha256:bb96f9fe01964329129142bc3d53501a9fa9f8412182b51f9926fd1c8037a3a7"
+ "facetsDigest": "sha256:feacd6f8891a8792935a81fd0251f6c42c470067cf68bd4532e202c0a387e72d",
+ "closureDigest": "sha256:79d253defe9ee672cf090d01de1746b6ced8216e440ffaffe39d96708999ec98"
},
{
"specifier": "@narratage/visual-ir",
@@ -1062,9 +1062,9 @@
"name": "@narratage/whisperx",
"version": "0.0.0-dev"
},
- "facetsDigest": "sha256:ad35d9300b271daca619fb532a6603dcc91803781dcac6d3a794ee08aff507f2",
- "closureDigest": "sha256:ff663ca601624088c17e6bcb97d2b728cb79fb0f35c712d50fdea2c22b1f7ff0"
+ "facetsDigest": "sha256:ed9ebd9eea0b92c20357ec67dc14c4aa211836dc815c3edcb48e4946972f94c5",
+ "closureDigest": "sha256:04634732e1babda9b40d2d8e669ce028ce0866c153806655445e8cdf44d9ffaa"
}
],
- "digest": "sha256:179883dcf3eef124657886dfa2a14c45734ddc71084f6c670242e650ee2bd56a"
+ "digest": "sha256:2cf00e81288de300e38e32dc655e99a549c7f5ade57af3ba1bf5f01e295dc70d"
}
diff --git a/package.json b/package.json
index 902a0286..e2aa128d 100644
--- a/package.json
+++ b/package.json
@@ -10,7 +10,7 @@
"docs:build": "vitepress build docs",
"docs:preview": "vitepress preview docs",
"test": "node --import tsx --test 'packages/*/test/**/*.test.ts' 'services/*/test/**/*.test.ts' 'test/**/*.test.ts'",
- "test:release": "node --import tsx --test tools/repository-hygiene.test.mjs tools/recipe-defaults.test.mjs",
+ "test:release": "node --import tsx --test tools/repository-hygiene.test.mjs",
"test:whisperx-service": "uv run --project services/whisperx --frozen python -m unittest discover -s services/whisperx/tests -p 'test_*.py'",
"test:image-opencv": "SVML_OPENCV_TESTS=1 SVML_OPENCV_PYTHON=services/image-opencv/.venv/bin/python node --import tsx --test packages/provider-image-opencv-local/test/provider.test.ts",
"smoke:kie": "node --import tsx packages/provider-kie/test/live-smoke.ts",
diff --git a/packages/composition/src/schema.ts b/packages/composition/src/schema.ts
index f7bd7735..47556d73 100644
--- a/packages/composition/src/schema.ts
+++ b/packages/composition/src/schema.ts
@@ -164,7 +164,7 @@ export const visualPathCommandSchema: ValueSchema = { kind: "oneOf", variants: [
object({ kind: { schema: { kind: "literal", value: "close" } } }),
] };
const pathTextElement = object({ ...base, kind: { schema: { kind: "literal", value: "path-text" } }, document: { schema: visualTextDocumentSchema }, typography: { schema: visualTextTypographySchema }, paints: { schema: { kind: "array", items: visualTextPaintSchema } }, path: { schema: { kind: "array", minItems: 2, items: visualPathCommandSchema } }, side: { schema: enumString(["left", "right"]) }, orientation: { schema: enumString(["follow", "upright"]) }, startMarginPx: { schema: number }, endMarginPx: { schema: number }, align: { schema: enumString(["start", "center", "end"]) }, reverse: { schema: boolean }, overflow: { schema: enumString(["visible", "clip"]) }, sequences: { schema: { kind: "array", items: visualTextSequenceSchema } }, marginAnimation: { schema: object({ keyframes: { schema: { kind: "array", minItems: 2, items: object({ atFrame: { schema: integer }, startMarginPx: { schema: number }, easing: { schema: enumString(["linear", "ease-in", "ease-out", "ease-in-out"]), optional: true } }) } } }), optional: true } });
-const media = (kind: "image" | "video") => object({ ...base, kind: { schema: { kind: "literal", value: kind } }, artifact: { schema: mediaBlobRef }, sampling: { schema: sampling, optional: true }, mediaStartSec: { schema: number, optional: true }, playbackRate: { schema: number, optional: true }, loop: { schema: { kind: "boolean" }, optional: true }, muted: { schema: { kind: "boolean" }, optional: true } });
+const media = (kind: "image" | "video") => object({ ...base, kind: { schema: { kind: "literal", value: kind } }, artifact: { schema: mediaBlobRef }, sampling: { schema: sampling, optional: true }, muted: { schema: { kind: "boolean" }, optional: true } });
const surface = object({ ...base, kind: { schema: { kind: "literal", value: "surface" } }, surface: { schema: compositableSurfaceSchema }, sampling: { schema: sampling, optional: true } });
const element: ValueSchema = { kind: "oneOf", variants: [box, mask, text, textFlowElement, pathTextElement, media("image"), media("video"), surface] };
const span = object({ startFrame: { schema: integer }, endFrameExclusive: { schema: integer } });
diff --git a/packages/composition/src/track.ts b/packages/composition/src/track.ts
index adc10e42..88096dd6 100644
--- a/packages/composition/src/track.ts
+++ b/packages/composition/src/track.ts
@@ -314,12 +314,8 @@ export type VisualTimedSampling = {
export type VisualMediaElement = VisualElementBase & {
readonly kind: "image" | "video";
readonly artifact: BlobRef;
- /** Exact frame-domain mapping superseding the candidate-era scalar playback fields. */
+ /** Exact frame-domain mapping for timed media. */
readonly sampling?: VisualTimedSampling;
- /** Candidate-era compatibility path; new timed lowerers use sampling. */
- readonly mediaStartSec?: number;
- readonly playbackRate?: number;
- readonly loop?: boolean;
readonly muted?: boolean;
};
@@ -935,19 +931,10 @@ function assertPresent(present: VisualPresent, programSpace: ProgramSpace | unde
if (!element.artifact.mediaType.startsWith(`${element.kind}/`)) {
throw new Error(`${trackId}.${present.id}.${element.id} media kind does not match its Artifact.`);
}
- if (element.mediaStartSec !== undefined && (!Number.isFinite(element.mediaStartSec) || element.mediaStartSec < 0)) {
- throw new Error(`${trackId}.${present.id}.${element.id} has invalid mediaStartSec.`);
- }
- if (element.playbackRate !== undefined && (!Number.isFinite(element.playbackRate) || element.playbackRate <= 0)) {
- throw new Error(`${trackId}.${present.id}.${element.id} has invalid playbackRate.`);
- }
if (element.kind === "image" && element.sampling !== undefined) {
throw new Error(`${trackId}.${present.id}.${element.id} cannot sample a durationless image.`);
}
if (element.sampling !== undefined) {
- if (element.mediaStartSec !== undefined || element.playbackRate !== undefined || element.loop !== undefined) {
- throw new Error(`${trackId}.${present.id}.${element.id} mixes exact sampling with scalar playback fields.`);
- }
if (element.animation !== undefined) {
throw new Error(`${trackId}.${present.id}.${element.id} sampling motion must live on an owned wrapper.`);
}
@@ -1176,9 +1163,6 @@ function normalizeElement(element: VisualElement): VisualElement {
...(segment.loop === undefined ? {} : { loop: { ...segment.loop } }),
})),
} }),
- ...(element.mediaStartSec === undefined ? {} : { mediaStartSec: element.mediaStartSec }),
- ...(element.playbackRate === undefined ? {} : { playbackRate: element.playbackRate }),
- ...(element.loop === undefined ? {} : { loop: element.loop }),
...(element.muted === undefined ? {} : { muted: element.muted }),
};
}
diff --git a/packages/film/src/index.ts b/packages/film/src/index.ts
index 361f22d8..7e6095a0 100644
--- a/packages/film/src/index.ts
+++ b/packages/film/src/index.ts
@@ -25,9 +25,7 @@ export {
} from "./program.js";
export {
assertFilmRecipe,
- defaultFilmRecipe,
filmAppearanceFromRecipe,
- filmRecipeKeys,
} from "./recipe.js";
export type { FilmAppearance } from "./recipe.js";
export { decodeFilmSurface } from "./surface.js";
diff --git a/packages/film/src/recipe.ts b/packages/film/src/recipe.ts
index be1eaea7..b9a336ab 100644
--- a/packages/film/src/recipe.ts
+++ b/packages/film/src/recipe.ts
@@ -7,17 +7,10 @@ import type { SvsRecipe } from "@narratage/svs";
export type FilmAppearance = { readonly clearColor: string };
-export const defaultFilmRecipe: Readonly<Record<string, string>> = {
- background: "#09090b",
-};
-
-export const filmRecipeKeys: readonly string[] = Object.keys(defaultFilmRecipe);
-
export function assertFilmRecipe(properties: SvsRecipe["properties"]): void {
const actual = Object.keys(properties).sort().join(" ");
- const expected = [...filmRecipeKeys].sort().join(" ");
- if (actual !== expected) {
- throw new Error(`Film Recipe requires exactly ${[...filmRecipeKeys].sort().join(", ")}`);
+ if (actual !== "background") {
+ throw new Error("Film Recipe requires exactly background");
}
}
diff --git a/packages/fonts-open/README.md b/packages/fonts-open/README.md
index 42c901cb..b3391fb7 100644
--- a/packages/fonts-open/README.md
+++ b/packages/fonts-open/README.md
@@ -1,6 +1,6 @@
# `@narratage/fonts-open`
-Private pre-release workspace package exposing 109 redistributable open font families as exact,
+Workspace package exposing 109 redistributable open font families as exact,
content-addressed `FontArtifactRef` values. The installed packages carry their font bytes and license
files. Author compilation and rendering never download fonts or inspect system font directories.
@@ -72,6 +72,6 @@ families preserve every Unicode-range shard from their installed CSS as one logi
faces referenced by the Author Graph enter a Build transfer bundle and ArtifactStore.
Every catalog entry is either SIL OFL 1.1 or Apache 2.0. Tests compare the declared license against
-the installed package's own metadata. The four private/local legacy fonts were intentionally not
-migrated: public redistribution requires an independently verified license, and brand fonts remain
+the installed package's own metadata. Private local fonts are not bundled: public redistribution
+requires an independently verified license, and brand fonts remain
explicit `<media:Font>` author assets.
diff --git a/packages/fonts-open/test/fonts-open.test.ts b/packages/fonts-open/test/fonts-open.test.ts
index ee9d793a..b53dd0af 100644
--- a/packages/fonts-open/test/fonts-open.test.ts
+++ b/packages/fonts-open/test/fonts-open.test.ts
@@ -66,21 +66,6 @@ test("the catalog exposes 109 publishable open families with frontend metadata",
}
});
-test("every redistributable legacy font is represented without private local fonts", () => {
- const migrated = [
- "caveat", "permanent-marker", "shadows-into-light", "shantell-sans", "playpen-sans",
- "short-stack", "kalam", "patrick-hand", "handlee", "coming-soon", "architects-daughter",
- "pinyon-script", "pacifico", "satisfy", "bebas-neue", "anton", "archivo-black", "oswald",
- "league-spartan", "fredoka", "lilita-one", "bungee", "black-ops-one", "bangers",
- "luckiest-guy", "righteous", "barlow-condensed", "roboto-condensed", "fira-sans-condensed",
- "dm-sans", "kanit", "rubik", "montserrat", "poppins", "inter", "lato", "nunito-sans",
- "manrope", "urbanist", "raleway", "work-sans", "playfair-display", "roboto-slab",
- "abril-fatface", "cormorant-garamond", "libre-baskerville", "noto-sans-sc", "noto-sans-jp",
- "noto-serif-sc", "ma-shan-zheng", "zcool-kuaile", "zcool-qingke-huangyou",
- ];
- assert.deepEqual(migrated.filter((name) => !openFontFamilyNames.includes(name as never)), []);
-});
-
test("catalog license metadata matches every installed Fontsource package", () => {
for (const [name, family] of Object.entries(openFontFamilies)) {
const packagePath = require.resolve(`${family.packageName}/package.json`);
diff --git a/packages/hyperframes/src/document.ts b/packages/hyperframes/src/document.ts
index 30f4fa6e..e91cd605 100644
--- a/packages/hyperframes/src/document.ts
+++ b/packages/hyperframes/src/document.ts
@@ -389,11 +389,8 @@ function renderElement(
`data-start="${context.presentStart}"`,
`data-duration="${context.presentDuration}"`,
`data-track-index="${context.stackIndex}"`,
- element.mediaStartSec === undefined ? "" : `data-media-start="${element.mediaStartSec}"`,
- element.playbackRate === undefined ? "" : `data-playback-rate="${element.playbackRate}"`,
element.kind === "video" && element.muted !== false ? "muted" : "",
element.kind === "video" ? "playsinline" : "",
- element.loop ? "loop" : "",
].filter(Boolean).join(" ");
const source = escapeHtml(hyperframesArtifactUri(element.artifact.digest));
if (element.kind === "image") return `<img ${common} ${media} src="${source}"/>`;
diff --git a/packages/hyperframes/test/track-expressiveness.test.ts b/packages/hyperframes/test/track-expressiveness.test.ts
index f93f1aab..5766bbb8 100644
--- a/packages/hyperframes/test/track-expressiveness.test.ts
+++ b/packages/hyperframes/test/track-expressiveness.test.ts
@@ -293,7 +293,15 @@ test("one content box lowers independent backdrop and foreground samples of one
order: 1,
kind: "video",
artifact: media,
- mediaStartSec: 0.5,
+ sampling: {
+ sourceFrameRate: { numerator: 30, denominator: 1 },
+ sourceFrameCount: 300,
+ segments: [{
+ target: { startFrame: 0, endFrameExclusive: 120 },
+ sourceFrame: { numerator: 15, denominator: 1 },
+ rate: { numerator: 1, denominator: 1 },
+ }],
+ },
muted: true,
style: [
{ name: "position", value: "absolute" },
@@ -311,7 +319,15 @@ test("one content box lowers independent backdrop and foreground samples of one
order: 2,
kind: "video",
artifact: media,
- mediaStartSec: 0.5,
+ sampling: {
+ sourceFrameRate: { numerator: 30, denominator: 1 },
+ sourceFrameCount: 300,
+ segments: [{
+ target: { startFrame: 0, endFrameExclusive: 120 },
+ sourceFrame: { numerator: 15, denominator: 1 },
+ rate: { numerator: 1, denominator: 1 },
+ }],
+ },
muted: true,
style: [
{ name: "position", value: "absolute" },
diff --git a/packages/image-transform/README.md b/packages/image-transform/README.md
index 04751d19..c6f09c0b 100644
--- a/packages/image-transform/README.md
+++ b/packages/image-transform/README.md
@@ -10,7 +10,7 @@ The result is the transformed image itself. It contains no source digest, Provid
post-processing report or copied upstream metadata. Core's Derivation records the input edges and
the Need/Receipt records the selected execution endpoint.
-`gptImageDenoiseV1` preserves the useful legacy GPT Image cleanup exactly: YCrCb NLM with luma 2,
+`gptImageDenoiseV1` applies the GPT Image cleanup profile: YCrCb NLM with luma 2,
chroma 10, 7/21 windows and 1.02 saturation recovery, followed by PNG encoding. It is now an
explicit reusable Program rather than hidden behavior inside GPT Image generation.
diff --git a/packages/image-transform/test/image-transform.test.ts b/packages/image-transform/test/image-transform.test.ts
index 7bbe3160..36160a99 100644
--- a/packages/image-transform/test/image-transform.test.ts
+++ b/packages/image-transform/test/image-transform.test.ts
@@ -15,7 +15,7 @@ import { rasterCapabilities } from "@narratage/raster";
import { digestOf } from "@narratage/protocol";
import type { CanonicalValue, TypedRecord } from "@narratage/protocol";
-test("the legacy GPT Image cleanup is one explicit reusable Program", () => {
+test("the GPT Image cleanup is one explicit reusable Program", () => {
assert.deepEqual(gptImageDenoiseV1.operations, [{
kind: "denoise",
method: "nlm-ycrcb",
diff --git a/packages/media-track/README.md b/packages/media-track/README.md
index 27f11dbe..0190de4d 100644
--- a/packages/media-track/README.md
+++ b/packages/media-track/README.md
@@ -21,4 +21,4 @@ The automatic lowering is Surface behavior, not a privileged Runtime route: it p
ordinary Media Pipeline Operations that an author can write explicitly through
`@narratage/media-pipeline`. The package does not add Media, B-roll or Provider meaning to Core,
Film, Composition or HyperFrames. “B-roll” is an editorial use of an ordinary Item or Sequence. The
-complete pre-release contract and acceptance matrix live in `spec/media-track.md`.
+authoring contract lives in `spec/media-track.md`.
diff --git a/packages/media-track/src/index.ts b/packages/media-track/src/index.ts
index 84b3bb3b..b8ff5fca 100644
--- a/packages/media-track/src/index.ts
+++ b/packages/media-track/src/index.ts
@@ -88,7 +88,6 @@ export {
mediaTrackValidatorDigests,
projectMediaAudioTrack,
projectMediaVisualTrack,
- renderMediaTrack,
sealMediaItemSpec,
sealMediaTrackHeader,
sealMediaTrackProgram,
diff --git a/packages/media-track/src/program.ts b/packages/media-track/src/program.ts
index 399fedab..f718a97d 100644
--- a/packages/media-track/src/program.ts
+++ b/packages/media-track/src/program.ts
@@ -724,6 +724,3 @@ export function projectMediaAudioTrack(space: ProgramSpace, program: MediaTrackP
assertAudioTrackIdentity(track, space);
return track;
}
-
-/** Candidate-era name retained only inside this pre-release migration. */
-export const renderMediaTrack = projectMediaVisualTrack;
diff --git a/packages/provider-google-vertex/README.md b/packages/provider-google-vertex/README.md
index 26b1948e..3da7b07b 100644
--- a/packages/provider-google-vertex/README.md
+++ b/packages/provider-google-vertex/README.md
@@ -21,6 +21,5 @@ The low-level TypeScript factory retains an environment-reference convenience fo
declarative Runtime activation has no implicit credential source. Credentials never enter author source, Runtime Closure, BuildState,
Operation state, Prompt or Receipt metadata.
-The legacy implementation used `GOOGLE_APPLICATION_CREDENTIALS` as an ADC file path. A host
-may preserve that deployment mechanism in a file-backed CredentialStore, but the Provider itself
-does not read arbitrary paths or ambient environment variables.
+A host may expose an ADC file through a file-backed CredentialStore, but the Provider itself does
+not read arbitrary paths or ambient environment variables.
diff --git a/packages/ranking/README.md b/packages/ranking/README.md
index fd7d0453..7a100b22 100644
--- a/packages/ranking/README.md
+++ b/packages/ranking/README.md
@@ -35,4 +35,4 @@ they define the board vocabulary rather than dynamic item copy.
</ranking:Column>
```
-See [`../../spec/ranking-track.md`](../../spec/ranking-track.md) for the normative pre-release model.
+See [`../../spec/ranking-track.md`](../../spec/ranking-track.md) for the authoring contract.
diff --git a/packages/typography-track/README.md b/packages/typography-track/README.md
index c21999c1..05d4e829 100644
--- a/packages/typography-track/README.md
+++ b/packages/typography-track/README.md
@@ -3,10 +3,9 @@
Official provider-free Text overlay package. It owns a typed `TypographyTrackProgram` and lowers every
item into an independently timed and stacked Present in the public VisualTrack contract.
-The current `TypographyTrackProgram@1` implements the complete pre-release Point/Area/Path author model:
+`TypographyTrackProgram@1` implements the complete Point/Area/Path author model:
bounded rich documents, exact font stacks, ordered Paint, frame/content/paragraph/line/run/word/
-grapheme boxes, deterministic overflow and Unicode-aware local motion. Its author Surface remains
-pre-release even though the repository-internal Track and Visual IR waist is now frozen.
+grapheme boxes, deterministic overflow and Unicode-aware local motion.
An item spanning the complete ProgramSpace is a persistent overlay; a shorter item is timed. They
are not different Track kinds. Timing is projected through `@narratage/temporal`, and placement is
diff --git a/spec/audio-track.md b/spec/audio-track.md
index d9e00658..4080a76f 100644
--- a/spec/audio-track.md
+++ b/spec/audio-track.md
@@ -1,9 +1,5 @@
# SVML Audio Track Authoring
-Status: implemented pre-release contract for the generic official Audio Track package, including
-its self-described author Surface, exact sample-domain lowering and local/remote execution witness.
-It is not yet a frozen public ABI.
-
## Purpose
`@narratage/audio-track` lets an author place already selected and normalized audio material into
@@ -92,7 +88,7 @@ An illustrative author Surface may remain compact:
</audio:Track>
```
-This spelling is illustrative rather than a frozen Surface. `during`, `at` and `for` must lower to
+This spelling is illustrative; `during`, `at` and `for` must lower to
the shared point-expression and window-projection algebra; they cannot create a second timing
engine.
@@ -159,11 +155,10 @@ The laws are:
| `loop/end` | choose phase so the source tail meets the window end | play the source tail |
| `stretch` | slow into the complete window | accelerate into the complete window |
-`once` replaces the old ambiguous `native` / `finish` behavior. End alignment is not reverse
+End alignment is not reverse
playback. `loop/end` changes loop phase; it does not reverse samples. `stretch` is pitch-preserving,
must stay inside the authored rate bounds and fails rather than silently applying a faster rate and
-then truncating. The old `fit_base` rule—speed up by at most 1.1x and silently cut the rest—is
-retired.
+then truncating.
Explicit silence is represented by the absence of a clip over that interval. Padding a file with
silence is a separate media transformation when the padded bytes themselves matter.
@@ -185,9 +180,8 @@ automatic music-bed behavior. Those are legitimate future audio-processing or mi
they must consume explicit inputs and make their behavior author-visible. A runtime or Provider may
not add them as an environment preference.
-The former terminal `bus: speech | music | sfx | source` label has been removed. It had no rendering
-effect and therefore carried no honest meaning. A future mix-routing contract must have an explicit
-consumer and graph behavior; merely naming a clip `music` cannot cause ducking.
+A future mix-routing contract must have an explicit consumer and graph behavior; merely naming a
+clip `music` cannot cause ducking.
## 7. Lowering and execution
@@ -207,45 +201,3 @@ The package emits one `AudioTrack` even when it owns many clips. That is an auth
not a privileged lane. A package that naturally owns one visual hit and one sound hit may emit peer
`VisualTrack` and `AudioTrack` outputs from one Fragment, while Film receives both through ordinary
edges.
-
-## 8. Legacy migration audit
-
-Retain:
-
-- arbitrary audio inputs;
-- Program-full, Selection, Moment and absolute placement;
-- overlapping music/SFX/voice contributions;
-- per-item gain and fades;
-- one-shot, loop and bounded pitch-preserving stretch;
-- explicit source trim and start/end alignment.
-
-Retire:
-
-- dynamic numbered ports as the saved author truth;
-- `z_index` on audio;
-- implicit full timing hidden in a node executor;
-- config-row priority clipping;
-- `fit_base` and its silent speed-then-truncate behavior;
-- `fill: freeze` for audio;
-- automatic extraction of whatever audio happens to be inside a video;
-- inert bus labels and hidden mastering.
-
-## 9. Implementation and acceptance
-
-The shared Temporal package and the pre-freeze terminal Audio candidate have now been completed
-without a Core branch, Provider-family branch or privileged Film lane:
-
-1. **Implemented:** add the `@narratage/audio-track` author package and self-described Surface;
-2. **Implemented:** consume explicit normalized `SynchronizedMedia` inputs;
-3. **Implemented:** sample-exact trim and every occupancy law;
-4. **Implemented:** lower to the peer terminal `AudioTrack`;
-5. **Implemented:** graph tests for arbitrary item counts and Selection/Moment `one` / `each`;
-6. **Implemented:** sample-level tests for shorter/equal/longer sources, both alignments, loops, stretch bounds
- and fades;
-7. **Implemented:** two overlapping items and two peer Audio Tracks produce the same planned mix facts;
-8. **Implemented:** local FFmpeg and remote Lambda Providers receive the identical
- content-addressed `AudioProgramPlan`; the real FFmpeg witness additionally checks exact loop
- phase sample by sample.
-
-The migration is incomplete if adding this package requires a Core branch, a Film audio family, a
-new queue, a Provider name in SVML or a hidden Base-audio rule.
diff --git a/spec/author-surface-binding.md b/spec/author-surface-binding.md
index cb27a623..5684b86f 100644
--- a/spec/author-surface-binding.md
+++ b/spec/author-surface-binding.md
@@ -1,8 +1,5 @@
# Author Surface Binding
-Status: implemented compiler contract for trusted package-owned Surfaces; third-party isolation is
-not yet implemented.
-
## 1. Purpose
The generic Markup Frontend owns element syntax. A package-owned Surface owns what one imported tag
@@ -133,17 +130,3 @@ Surface Binding is not:
The current Host executes only explicitly registered trusted Surface implementations. Locked code
bytes, permission enforcement and isolation are required before arbitrary community Surface code
can execute.
-
-## 8. Executable proof
-
-The non-video `example.recipe-card` fixture proves the boundary:
-
-1. SVS emits a generic Recipe;
-2. the Card Surface reads only its explicit public reference;
-3. Card validates `fill` and `padding` during author compilation;
-4. Card emits a nominal `CardAppearance` Record;
-5. the runtime Producer consumes `CardAppearance`, not `SVS Recipe`;
-6. an invalid color fails before a BuildPlan or external operation exists;
-7. changing only the source-import alias preserves the Program Record and Graph identities.
-
-Video packages must use this same mechanism rather than adding a video-specific compiler path.
diff --git a/spec/caption-fine.md b/spec/caption-fine.md
index f5df0748..d52fbd25 100644
--- a/spec/caption-fine.md
+++ b/spec/caption-fine.md
@@ -1,7 +1,5 @@
# Fine Caption Style Family
-Status: implemented pre-release Style family with complete browser evidence for the declared surface.
-
## Purpose and boundary
`@narratage/caption-fine` is the official field-free, fine-grained Caption Style family. "Fine"
@@ -139,7 +137,7 @@ Activation state and decoration geometry are deliberately separate. `current` ac
Atom whose measured window contains the frame. `trail` retains every activated Atom through the end
of the Cue. `step` swaps the whole active glyph layer; `wipe` reveals it across the Atom's measured
window. RTL reverses the wipe direction. Glyphs, boxes and underlines may choose different state
-policies, so the retained legacy behavior—trail text with a current-only pill—is directly expressible.
+policies, so trail text with a current-only pill is directly expressible.
An isolated box paints one box per activated Atom. A joined trail paints the one ordered activated
prefix as continuous inline fragments: atoms on the same rendered line share one background, while
@@ -195,7 +193,7 @@ browser line fragments. It does not create another text truth. Active overlays r
geometry. Every animation lowers to finite frame-addressed `VisualTrack` keyframes before
HyperFrames sees it.
-## Defaults and compatibility
+## Defaults
The original fifteen baseline properties remain required, so a minimal Recipe is explicit about
planning, geometry, typography and its visible box. New dimensions are optional and resolve to a
@@ -212,23 +210,3 @@ complete immutable parameter object:
Unknown properties are rejected. Defaults are package implementation policy and therefore covered
by its implementation digest; they are not hidden Runtime behavior.
-
-## Completed evidence gates
-
-The complete design was delivered progressively rather than as incompatible versions:
-
-1. **Resolved model and static lowering** — complete parameters, anchors, layout, base/active Paint,
- 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 evidence** — an ordered exact Font Artifact stack, CJK, emoji/symbol fallback,
- multiline wrapping, outline, shadow, glow and all four glyph karaoke modes have real browser/pixel
- witnesses. `max-lines` was deliberately rejected rather than deferred.
-4. **Expressive Paint and motion evidence** — current-only and trail boxes, isolated and joined
- geometry, gradient, underline, long shadow, text transform, layered one-shot motion, typewriter
- reveal and deterministic loops each have a terminal-IR witness; joined geometry additionally has
- a real wrapped browser/pixel witness.
-
-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.
diff --git a/spec/caption-program.md b/spec/caption-program.md
index 7f10ebe1..13ebb735 100644
--- a/spec/caption-program.md
+++ b/spec/caption-program.md
@@ -1,7 +1,5 @@
# Caption Program
-Status: pre-release executable contract.
-
## 1. Scope
Caption is an ordinary video component family. It turns immutable authored display text into one
diff --git a/spec/core-kernel.md b/spec/core-kernel.md
index fbde85e7..3c2dea98 100644
--- a/spec/core-kernel.md
+++ b/spec/core-kernel.md
@@ -1,8 +1,5 @@
# Narratage Core Kernel
-Status: current executable contract. Persisted Graph, BuildRequest, Plan and BuildState wire
-formats are `@1`.
-
Core is a domain-free graph-demand compiler and verified Build state machine. It does not parse
source, load packages, execute implementations, choose an Endpoint, access credentials, persist
artifacts or know video vocabulary.
diff --git a/spec/deck-track.md b/spec/deck-track.md
index 3b08a9d6..673e32c1 100644
--- a/spec/deck-track.md
+++ b/spec/deck-track.md
@@ -1,9 +1,5 @@
# SVML Depth-Stack Deck Track
-Status: implemented executable authority for the official depth-stack Deck migration. It records
-the behavior used by the old Deck implementation, but it is not a frozen public ABI and does not
-define a universal Deck protocol.
-
## 1. Conclusion
A Deck is not a Media Item mode and is not the third primitive of Media Track. It is a higher-order
@@ -103,7 +99,7 @@ Every Card source, label, trigger and sound dependency is an explicit graph refe
## 5. Illustrative author Surface
-The syntax is not frozen, but package ownership should be visible:
+Package ownership is explicit:
```xml
<deck:DepthStack
@@ -228,59 +224,3 @@ between them.
Relative depth determines only ordering among owned Cards. Temporary ordering during reflow exists
only inside that explicit relationship. It does not allocate a global z band.
-
-## 10. Migration from the legacy implementation
-
-Retain from the old Deck implementation:
-
-- explicit authored Card order;
-- semantic trigger-driven current state;
-- configurable previous/future visibility;
-- finite or explicit wrapping behavior;
-- depth offset, scale, alternating rotation, opacity and tone;
-- whole-group entry, sustain and exit motion;
-- full-group interpolated reflow;
-- frame Paint, padding, radius, border and shadow;
-- deterministic frame-local evaluation.
-
-Retire:
-
-- treating Deck as a B-roll or Media mode;
-- implicit `linkNext` topology;
-- placement semantics hidden behind “usually below the face”;
-- automatic labels from source metadata;
-- lower-composite transitions;
-- lane-global sound defaults;
-- any registry entry in Core, Film, Composition or HyperFrames.
-
-## 11. Implementation and acceptance order
-
-1. implement the shared Temporal and Spatial slices;
-2. expose `DepthStack` and explicit ordered Cards;
-3. resolve exact trigger state and finite visibility;
-4. reuse focused media-layer lowering for Card contents;
-5. add pure relative-depth pose resolution;
-6. add collection reflow and whole-group lifecycle motion;
-7. prove still and timed inactive-playback behavior;
-8. migrate one real old-system Deck and freeze only after the acceptance matrix passes.
-
-Steps 1–8 execute in `@narratage/deck-track`. Package tests cover every state, validation,
-playback, label and extension case below. The real HyperFrames witness renders a legacy-style
-three-Card depth stack twice—one worker and three partitioned workers—and compares every decoded
-frame byte-for-byte while also proving each authored current state paints. This completes the Deck
-package acceptance matrix, and the independent generic E1–E8 terminal VisualTrack/Visual IR gates
-now pass as well.
-
-Required evidence includes:
-
-- previous-only, next-only and mixed neighborhoods;
-- zero, one and many visible neighbors;
-- finite boundaries and explicit wrapping;
-- missing, equal and reversed trigger rejection;
-- depth pose, alternating rotation, opacity and tone;
-- cut and interpolated whole-collection reflow;
-- still and timed Card sampling laws;
-- optional exact-font labels;
-- whole-group entry/sustain/exit without overwriting Card poses;
-- byte-identical frames under sequential, partitioned and out-of-order rendering;
-- installation of another Deck package without changing Core or the first DepthStack package.
diff --git a/spec/media-track.md b/spec/media-track.md
index c068c564..a7e960c6 100644
--- a/spec/media-track.md
+++ b/spec/media-track.md
@@ -1,10 +1,5 @@
# SVML Media Track Authoring
-Status: executable pre-release authority for the unified official Media Track. Item/Sequence
-Surfaces, timed material, ordered layers, motion, handoffs, separate audio projection and the
-restricted Speech projection are implemented. The former `@narratage/broll` vertical slice has
-been retired rather than preserved as compatibility. The contract is not a frozen public ABI.
-
## 1. Conclusion
Full-canvas cutaways, lower evidence cards, corner images, transparent stickers, animated images,
@@ -41,7 +36,7 @@ because they have different topology, validation and ports. There is no `mode="b
overlay"` field and no step where choosing a mode causes a different hidden component to appear.
A depth-stack Deck is deliberately outside this package. It is a higher-order collection-state
-component, not a media primitive. The official migration model is specified independently in
+component, not a media primitive. Its model is specified independently in
[`deck-track.md`](./deck-track.md); future Carousel, Fan, Grid or other Deck packages need not adopt
that model.
@@ -335,7 +330,7 @@ guessing which layer is primary.
## 9. Media motion has four separate channels
-Old B-roll behavior becomes four explicitly separated package-owned channels:
+Media motion has four explicitly separated package-owned channels:
```ts
type MediaLifecycleMotion = {
@@ -452,7 +447,8 @@ ProgramSpace nor upstream Selection/Moment points.
Sequence handoffs may operate only inside their shared Placement Frame. This makes cut, crossfade,
push, wipe, cover and page turn honest local relationships. An outer handoff against
-`composite_below` is deliberately retired: it would read and mutate unrelated lower Tracks.
+A handoff against an accumulated lower composite is invalid because it would read and mutate
+unrelated lower Tracks.
The Sequence itself may use an ordinary entry/exit motion. A full-screen fade over a lower Track is
valid because only the Sequence opacity changes; pushing or page-turning the lower Track is not.
@@ -547,41 +543,7 @@ Ordinary Media Items may consume `during={story.segment.answer}` directly. This
Selection: Temporal resolves the Segment's already-existing structural start/end anchors. The same
Item can still consume authored Selection and Moment values when those are the actual intent.
-## 14. Legacy audit: retained and retired
-
-Retain:
-
-- full-frame cutaways, split-screen and corner overlays through one Item model;
-- still images, GIF-like animation and videos;
-- independent overlapping media presentations;
-- explicit contain/cover/focal sampling and foreground/self-blur backings;
-- source trim and once/hold/loop/stretch occupancy;
-- entry, exit, continuous outer motion and inner sampling motion;
-- explicit Sequence membership and shared-surface pair transitions;
-- cue-position ratio and continuous visual sampling across transition windows;
-- explicit source audio and transition/edge SFX;
-- stable author identities and deterministic authored order.
-
-Retire:
-
-- a separate B-roll terminal family;
-- a `mode` that changes valid ports or settings;
-- URL-extension guesses for image/video/GIF behavior;
-- track-level z-index and implicit item priority;
-- `auto` playback, `finish`, `freeze`, `phased` and renderer repair;
-- automatic sequencing or `linkNext` inference;
-- one `focalX/focalY` used for both source and destination points;
-- fixed foreground/background fields instead of ordered local layers;
-- one CSS transform slot that lets motion channels overwrite each other;
-- proportional shortening of overlapping entry/exit durations;
-- lane-global SFX and automatically selected audio;
-- outer `composite_below` transitions and every Base FX dependency;
-- one bundled B-roll Product that couples VisualTrack and AudioTrack satisfaction.
-
-The old Deck behavior migrates independently under [`deck-track.md`](./deck-track.md); removing it
-from Media Track does not remove that capability.
-
-## 15. Package and implementation shape
+## 14. Package shape
The intended package relationships are:
@@ -602,119 +564,6 @@ depends on
└─ @narratage/composition
```
-The package may use internal focused files or future implementation-only libraries. It must not
+The package may use internal focused files or implementation-only libraries. It must not
create one umbrella authoring library shared by Text, Caption, Ranking and Media, and it must not
require a release of Core when a new media Recipe, motion operator or component package is added.
-
-The former `@narratage/broll` package was used as a regression witness during migration and is now
-retired. Because the project is pre-release, no compatibility package remains. “B-roll” is still a
-useful editorial description for an Item or Sequence, not a terminal Type or author package.
-Source assets and generated files remain untouched.
-
-## 16. Implementation order
-
-Implement only after the shared Temporal and Spatial slices exist:
-
-1. **Implemented:** introduce `@narratage/media-track` with one still-image Item whose BlobArtifact,
- IntrinsicExtent, SpatialFrame, ContentFit and ProgramSpace are separate semantic inputs;
-2. **Implemented:** add timed source trim and every occupancy/alignment policy;
-3. **Implemented:** add ordered Paint/media layers, clipping and the two-frame fit model;
-4. **Implemented:** add lifecycle and sampling motion with the fixed transform stack;
-5. **Implemented:** add explicit Sequence scheduling and pair transitions;
-6. **Implemented:** add separate source-audio and SFX projection;
-7. **Implemented:** route Speech Spine visual projection through the restricted lowerer;
-8. **Implemented:** migrate the checked-in B-roll examples and retire the old package;
-9. **Implemented:** close the package-local acceptance matrix with structural, real-media and
- partitioned-browser evidence. The independent shared Track/Visual IR gates in
- [`track-expressiveness.md`](./track-expressiveness.md) also pass.
-10. **Implemented:** let `video=` lower to the shared Media Pipeline at the connected ProgramSpace
- rate while preserving explicit `media=` as the prepared-media escape hatch.
-
-No step requires a Core, Runtime, queue or Provider change. Surface materialization may use an
-existing explicitly registered Provider capability, but ordinary Item/Sequence lowering is
-deterministic local compilation.
-
-## 17. Acceptance matrix
-
-### Material
-
-- opaque and alpha still images;
-- portrait, landscape and square images;
-- generated/raw video automatically normalized with and without explicitly selected audio;
-- explicitly prepared normalized video connected without a second normalization;
-- animated GIF/WebP normalized to exact frame timing;
-- still and animated Compositable Surfaces;
-- repeated use of one Artifact without duplicated storage or duplicated source audio.
-
-### Item
-
-- Program/absolute windows under `one`, and Selection/Moment windows under `one` and `each`;
-- independent overlapping Items at unrelated absolute stacking keys;
-- every source trim and shorter/equal/longer occupancy case;
-- full Canvas, split, lower card, corner and off-canvas Frames;
-- transparent, solid, gradient, self-blur and alternate-source backing layers;
-- every Content Fit and unequal content/frame focal point;
-- entry, sustain, exit and sampling motion separately and in combination;
-- deterministic composition for overlapping entry/exit durations without hidden retiming.
-
-### Sequence
-
-- image-image, video-video, image-video and alpha-Surface handoffs;
-- strict authored activation order and stable member identity;
-- cut, crossfade, push, wipe, cover and page turn;
-- start/center/end boundary-position ratios;
-- continuous source sampling across handoff overlap;
-- transition duration below, equal to and above the adjacent logical-phase separation when the
- explicit Sequence envelope and no-three-source laws still hold; invalid envelope/overlap fails;
-- missing, repeated, reversed and same-frame activation failure;
-- no implicit three-member overlap and no lower-composite input;
-- group entry/exit operating only on owned pixels.
-
-### Audio and execution
-
-- visual-only source does not demand audio work;
-- exactly one explicitly selected source layer contributes audio;
-- hard and crossfaded Sequence audio handoffs;
-- simultaneous exit/entry SFX mix at one boundary;
-- independent BGM remains unchanged;
-- targeting/replacing visual and audio projections independently;
-- identical Visual Track/Audio Track plans under local and remote execution;
-- arbitrary frame partitioning renders byte-identical deterministic frames.
-
-### Architecture
-
-- installing another Media component changes no Core, Film, Composition or HyperFrames family
- registry;
-- all source, temporal, spatial, sound and label dependencies are graph edges;
-- no Track contains provider, path, Narrative digest or source-family metadata;
-- no operation samples the accumulated lower composite;
-- the Speech Spine restricted projection and ordinary Item use the same lowering laws.
-
-### Executable evidence
-
-The matrix above is closed by executable evidence rather than by package status prose:
-
-- `packages/media-track/test/media-track.test.ts` covers every Item binding, strict occurrence
- expansion, all documented Frames and Content Fits, ordered Paint/sample/backing layers, trim and
- occupancy, lifecycle/sustain/sampling motion, every Handoff operator and ratio, exact source
- audio/SFX projection, malformed Sequence rejection and explicit author-graph edges;
-- `packages/provider-media-local/test/provider.test.ts` runs real FFmpeg inspection and
- normalization for moving video with and without audio, attached pictures, source A/V offsets,
- animated GIF, animated WebP, exact audio rendering and final muxing;
-- `packages/media-execution/test/webp.test.ts` separately proves animated WebP straight-alpha
- blend and dispose behavior used by both local and Lambda execution;
-- `packages/provider-media-aws-lambda/test/provider.test.ts` proves that remote execution receives
- the same exact `AudioProgramPlan`; both local and Lambda media environments execute
- `@narratage/media-execution` rather than owning alternate media semantics;
-- `packages/speech-spine/test/surface.test.ts` and `packages/speech-basis/test/product.test.ts`
- prove the restricted Speech projection, one shared generated Product and independent visual/audio
- Candidate satisfaction;
-- `packages/hyperframes/test/browser-visual.test.ts` renders opaque images, a straight-alpha
- Surface, two-frame fitting, local motion and a Sequence handoff through real Chromium, then
- compares every decoded RGBA frame across different worker partitions;
-- package manifests contain no Media family registry, while the public value types contain no
- hidden lineage or Provider metadata.
-
-The local package is therefore complete as a pre-release Media implementation over the frozen
-repository-internal `svml.visual-track@1` / `svml.visual-ir@1` waist. This does not publish or
-separately freeze the Media author Surface.
diff --git a/spec/ranking-track.md b/spec/ranking-track.md
index af50845a..7bf6c1d0 100644
--- a/spec/ranking-track.md
+++ b/spec/ranking-track.md
@@ -1,17 +1,11 @@
-# SVML Ranking Track Migration
-
-Status: implemented executable authority for the official Ranking migration. All four author
-components, their shared triggered schedule, optional peer AudioTrack lowering, author Surfaces and
-real-browser evidence execute in `@narratage/ranking`. It is not a compatibility promise for the
-historical node format or a frozen public ABI.
+# SVML Ranking Track
## 1. What Ranking means
Ranking is a video-domain author component that presents one ordered collection as a progressive
visual state. It is not a Core concept, a generic Track mode, a Provider or a renderer feature.
-The old system placed four materially different behaviors behind one `ranking_track` node and a
-`rankingType` switch. The new system uses one physical package, `@narratage/ranking@1`, but exposes
+One physical package, `@narratage/ranking@1`, exposes
four independent author components:
- `ranking:TierBoard` — place revealed items into named tier rows;
@@ -27,36 +21,7 @@ A third party can publish another Ranking package without registering a type in
this package. Installing and importing that package contributes its own Surface, Types, validators
and fragment compiler through the ordinary module mechanism.
-## 2. Evidence from the old implementation
-
-The reviewed old-project inventory contains 21 migrated Ranking nodes:
-
-| Historical variant | Reviewed uses | Item counts seen |
-|---|---:|---|
-| Tier | 10 | 5–6 |
-| Typewriter | 5 | 5 |
-| Column | 3 | 4–5 |
-| Top Three | 3 | 3 |
-
-The inventory proves that all four meanings are real, but not that their old representation should
-survive. The old implementation had these structural problems:
-
-1. one UI/node identity changed meaning by switching a mode and disconnecting its dynamic ports;
-2. the same item `start/end` pair meant visibility, animation phase, successor handoff or nothing,
- depending on the renderer;
-3. Top Three ignored item end times, while Typewriter used their union only to decide whether the
- paper was mounted;
-4. renderers inspected all sibling segments, sorted or counted them, and manufactured group state
- after the generic Track Program had already lost that meaning;
-5. one global z-index prevented the board and individual icons from interleaving with peer Tracks;
-6. raw URLs, environment font names, Remotion component ids and three mirrored registries leaked
- environment/renderer details into the component;
-7. short windows could silently suppress motion sound instead of fitting visual and sound phases to
- one shared finite schedule.
-
-Migration preserves the useful visual capabilities, not these accidental semantics.
-
-## 3. Author-facing shape
+## 2. Author-facing shape
The executable author Surface is:
@@ -104,7 +69,7 @@ variant-specific `*Style` component owns the allowed keys and compiles the Recip
edges into a typed package-owned Style. Semantic item values such as tier row, label, icon and entry
behavior are not paint properties and do not belong in SVS.
-## 4. The group sees siblings; rendered Tracks do not
+## 3. The group sees siblings; rendered Tracks do not
A progressive ranking cannot be compiled by treating every child as an isolated Track item. Row
placement, successor handoff, active-item state and the settled prefix depend on the ordered group.
@@ -154,7 +119,7 @@ Every invalid or equal-frame sequence fails atomically. The visual and optional
consume the same schedule, so motion and sound cannot drift while remaining independently
demandable branches of the Run Graph.
-## 5. Common phase model
+## 4. Common phase model
For outer window `[B, O)`, triggers `p1 ... pN` and terminal `T`, entry `i` receives:
@@ -208,7 +173,7 @@ ranking, despite its heavy use of text layout. It may share low-level exact-font
with the future Text implementation, but it must not depend on or masquerade as a generic Text
Track Program.
-## 6. Spatial layout and stacking
+## 5. Spatial layout and stacking
Each component owns one outer placement box and its internal layout algorithm. A Tier cell, Column
row or Top Three slot is not a generic per-item spatial locator. Allowing arbitrary spatial inputs
@@ -240,7 +205,7 @@ All normalized geometry is relative to the explicit outer box. Required variant
Paint, geometry and motion parameters are validated by the owning `*Style` component. Unknown
Recipe properties fail. There is no arbitrary CSS escape hatch.
-## 7. Media, fonts and sound
+## 6. Media, fonts and sound
Images and sounds enter through explicit `BlobArtifact` edges. Fonts enter through explicit,
content-addressed font stack edges. Ranking never stores a URL, asks the Runtime to choose a font,
@@ -257,7 +222,7 @@ Optional sound effects are ordinary authored inputs:
Ranking itself is deterministic and has no Need, Provider, queue, credential or environment
adapter. If an input image is generated, that upstream generation remains another Graph component.
-## 8. Run-Graph behavior
+## 7. Run-Graph behavior
The author graph exports ordinary logical `visual` and, when authored, `audio` results. Targets,
Candidates and replacement are governed by the same Run Graph laws as every other component.
@@ -267,39 +232,3 @@ Replacing the visual result does not mutate the audio result. Replacing both out
multi-output Candidate is also possible through ordinary explicit output mapping. Once every
demanded original output is satisfied by selected Candidates, demand analysis prunes the original
Ranking branch and its temporal/media ancestors. No special Ranking execution rule is required.
-
-## 9. Migration order and acceptance
-
-Implemented in this order:
-
-1. **Implemented:** the shared temporal projection and triggered-schedule laws;
-2. **Implemented:** `@narratage/ranking@1` with four separate Programs/Styles and one private schedule utility;
-3. **Implemented:** TierBoard and Column, which together prove cumulative and exclusive stage
- semantics plus independent stacking;
-4. **Implemented:** TopThree;
-5. **Implemented:** TypewriterList using exact font/layout primitives;
-6. **Implemented:** optional AudioTrack lowering from the same schedule;
-7. **Implemented:** a real-browser progressive-state witness and one author-Surface graph check per component.
-
-Acceptance requires:
-
-- trigger/item cardinality, stable identities and all boundary failures are tested;
-- `T < O` visibly proves a final settled suffix;
-- short stages deterministically fit their local animation and sound phases without changing stage
- boundaries; a very short Typewriter stage may reveal several graphemes on the same frame;
-- board and per-item Presents interleave with a peer Track at unrelated absolute z positions;
-- visual and sound event frames agree exactly;
-- missing optional images work only for variants that declare them optional;
-- fonts and media are content-addressed dependencies;
-- each component can revise its own Program without changing Core, Runtime, Composition,
- Hyperframes or another Ranking component;
-- installing a fifth component package requires no central family registry change.
-
-The migration intentionally does not preserve historical node JSON, mode switching, old dynamic
-ports, renderer ids or Remotion components. Historical projects are evidence and visual references,
-not a compatibility obligation for an unreleased language.
-
-The package test matrix covers every acceptance item above. The opt-in Chromium witness evaluates
-all four components with one worker and partitioned workers, proves visible trigger progression and
-the final settled suffix, and bounds only microscopic cross-process edge-antialiasing noise. Logical
-frame state, geometry, stacking, event frames and authored graph edges remain exact.
diff --git a/spec/screen-overlay.md b/spec/screen-overlay.md
index 42eba046..3422e620 100644
--- a/spec/screen-overlay.md
+++ b/spec/screen-overlay.md
@@ -1,9 +1,5 @@
# SVML Screen Overlay Authoring
-Status: implemented pre-release contract for the optional official Screen Overlay package. Its
-self-described Surface, eleven typed components and sequential/parallel browser evidence execute;
-it is not yet a frozen public ABI.
-
## Purpose
`@narratage/screen-overlay` contributes self-contained, usually full-canvas pixels over an authored
@@ -47,8 +43,8 @@ It must not sample:
Normal source-over alpha compositing is allowed: that is how every alpha-bearing Track reaches the
canvas. Blend modes or filters whose result depends on unknown lower pixels are not self-contained.
-This law means the old source-free `backdrop-filter` implementations of Gaussian Blur, Color
-Adjust and Zoom Blur are not Screen Overlays. To preserve those effects honestly, a media-effect
+This law means source-free `backdrop-filter` implementations of Gaussian Blur, Color Adjust and
+Zoom Blur are not Screen Overlays. To preserve those effects honestly, a media-effect
component must receive the exact media or compositable Surface to transform through a graph edge,
then output its own transformed material or Track. If a future component explicitly rasterizes a
selected group of Tracks into a Surface, consuming that Surface is also explicit; Screen Overlay
@@ -120,14 +116,14 @@ presentation. For example, a Flash may define attack, peak and decay; a Directio
an edge from one side to another; Grain may remain steady. The old universal triangle that peaked
at 30% of every effect's duration is retired as hidden presentation policy.
-Recipe defaults may supply an envelope, but the resolved Program must contain the exact parameters.
+Recipes may supply an envelope, but the resolved Program must contain the exact parameters.
An effect cannot expand its projected window to fit an animation. A longer authored envelope is
simply clipped by that window; it is not rejected or secretly sped up. Invalid or zero-length
windows still fail through the common temporal validator.
## 5. Portable official component set
-The useful old effects divide into two honest lowering groups.
+The supported effects divide into two lowering groups.
### Direct Visual IR candidates
@@ -161,16 +157,16 @@ or renderer-dependent entropy is invalid.
## 6. Explicitly excluded effects
-The following old names are excluded from the source-free package:
+The following effects are excluded from the source-free package:
-| Old effect | Why excluded | Honest replacement |
+| Effect | Why excluded | Honest replacement |
|---|---|---|
| `gaussian_blur` | must read pixels being blurred | media/surface filter with explicit input |
| `color_adjust` | exposure/contrast/saturation/hue alter input pixels | media/surface color transform with explicit input |
| `zoom_blur` | a real radial blur requires the visual being sampled | media/surface effect with explicit input |
| screen/multiply/overlay blend wash | result depends on lower pixels | source-over alpha approximation, or explicit-input materialization |
-This does not delete the visual result. It rejects the old privilege by which a supposedly ordinary
+This does not forbid the visual result. It rejects the privilege by which a supposedly ordinary
Track could mutate everything beneath it.
Screen Overlay also cannot:
@@ -188,7 +184,7 @@ peer edges into Film.
## 7. Stacking
-The old fixed `z_index: 200` rule is retired. “Screen” describes full-canvas geometry, not a magical
+“Screen” describes full-canvas geometry, not a magical
render phase. Every Present receives an explicit absolute stacking intent and Composition flattens
it with all other Presents.
@@ -198,45 +194,3 @@ Composition never switch on the package family and never force it to the top.
If one overlay package emits multiple Presents at different stacking positions, peer Tracks may
interleave between them exactly as required by the flat Track law.
-
-## 8. Legacy migration audit
-
-Retain:
-
-- short Moment hits and long Program overlays;
-- Selection, Moment and absolute temporal placement;
-- full-canvas flash, veil, vignette, light leak, grain, scan lines, bokeh and static visuals;
-- deterministic effect-specific parameters and local envelopes;
-- several simultaneous effects;
-- optional explicit owned textures or materialized alpha Surfaces.
-
-Retire:
-
-- singleton slot semantics;
-- fixed topmost z-index and special post-caption render phase;
-- one central string operator registry as system truth;
-- the universal 30%-peak envelope;
-- hidden `backdrop-filter` access;
-- `mix-blend-mode` across Tracks;
-- pretending screen hits are scene transitions;
-- hidden lane-level enter/exit SFX;
-- any Base FX counterpart or placeholder.
-
-## 9. Lowering and acceptance
-
-Implementation follows the shared Temporal and existing Visual Track contracts:
-
-1. **Implemented:** the self-described `@narratage/screen-overlay` author package;
-2. **Implemented:** eleven separate typed author components rather than one unvalidated bag;
-3. **Implemented:** exact code-free `svml.visual-ir@1` lowering; the generic typed owned-Surface
- escape remains available when a future component cannot be represented exactly;
-4. **Implemented:** connected CanvasSpace and ProgramSpace, never Film globals;
-5. **Implemented:** ordinary absolute-stack Presents;
-6. **Implemented:** deterministic structural/frame tests for every component and envelope;
-7. **Implemented:** identical pixels across one-worker and three-worker real Chromium rendering;
-8. **Implemented:** multiple Overlay Tracks interleave with peer Tracks by stacking key;
-9. **Implemented:** negative tests rejecting any lower-composite, sibling-Track, backdrop-filter or hidden audio
- dependency.
-
-The design fails if installing a new overlay requires a Core branch, a Composition family, a
-HyperFrames component switch or an implicit snapshot of already composed pixels.
diff --git a/spec/script-surface.md b/spec/script-surface.md
index 602c86d5..46657ab0 100644
--- a/spec/script-surface.md
+++ b/spec/script-surface.md
@@ -1,12 +1,5 @@
# SVML Script Surface
-> **Draft; not frozen.**
->
-> SVML 尚未公开发布,不存在需要兼容的旧语言版本。本文直接定义首个公开目标
-> Script Surface v1;仓库中的早期原型不是规范合同。实现只有在通过本文的
-> parser、projection、source-map 和 temporal golden fixtures 后,才可声称
-> 支持 SVML v1。
-
SVML 是语义视频源语言,不是像素渲染格式。本文只定义它最高频、最需要保持
可读性的稿子区 `<script>`;画布、节点、样式、生成参数和其他 Program 区域的
外层文档结构另行设计。v1 发布后,新增语义应首先组合本文已有构造;确需改变
@@ -623,19 +616,3 @@ Style;修改一个局部区间不要求作者书写它的补集。完整规则
只要需求能落入这七项,就不得发明新的 inline delimiter。若七项都不能
无损表达,应先证明它属于稿子语义而不是 Program,再以新版本提案处理;
不得让现有解析器“顺便支持”。
-
-## 11. 实现验收
-
-一个实现只有同时满足以下证据,才能声明支持 Script Surface v1:
-
-1. 本文全部正例、反例、投影和 source-map golden fixtures;
-2. parser、formatter、Narrative IR 与三投影不依赖 provider 或渲染器;
-3. SelectionSet 支持闭合、交叉、非连通 occurrence 与左右 affinity;
-4. MomentSet 支持 `@id!` / `~@id!`、单/多 occurrence 与 `at` 类型闸;
-5. Dual Text 在 speech、caption 与时间映射上保持一个可审计 source map;
-6. Slot 采用 parse-first、literal-only binding,不能注入语法;
-7. 未知版本、未知保留语法、混合 temporal type 与 partial dual atom 全部
- fail closed。
-8. `2M + 2N` identity 的规范序列化、digest、完整 Map 与相邻 Segment 双单调
- 约束都有 golden fixtures;硬切、overlap、gap、空 Segment 和端点重合均被
- 覆盖。
diff --git a/spec/spatial-layout.md b/spec/spatial-layout.md
index cced73b1..5ee97bda 100644
--- a/spec/spatial-layout.md
+++ b/spec/spatial-layout.md
@@ -1,11 +1,5 @@
# Shared Spatial Layout
-Status: executable foundational authority for shared Spatial geometry. `@narratage/spatial`
-implements CanvasSpace, Frame/Point/Path, IntrinsicExtent, ContentFit and pure fitting; Film now
-consumes the same explicit CanvasSpace as Track layout. Text, Media and all four Ranking witnesses
-execute, and the repository-internal Visual IR compatibility audit passes. Public package ABI
-publication remains separate.
-
## 1. Conclusion
The shared spatial system owns coordinate geometry, not Text, Media or CSS. Its stable vocabulary is:
@@ -103,7 +97,7 @@ An intended source shape is:
</film:Film>
```
-The exact Surface spelling remains pre-freeze. The one-value dataflow is normative.
+The example Surface spelling is illustrative. The one-value dataflow is normative.
## 4. SpatialFrame construction
@@ -215,8 +209,7 @@ type ContentFit = {
Points are normalized in their own Frames. `framePoint` says where in the Placement Frame the
chosen content point wants to land. `contentPoint` says which intrinsic source point is important.
-This is more expressive than the old single `focalX/focalY`, which silently used the same coordinate
-on both sides. Both point coordinates must lie in `[0,1]`; deliberate displacement beyond those
+Both point coordinates must lie in `[0,1]`; deliberate displacement beyond those
bounds uses `offsetPx` and, when it must remain out of bounds, `constraint="free"`.
Given Placement Frame `(Vx, Vy, Vw, Vh)` and intrinsic extent `(Sw, Sh)`, the aspect-preserving
@@ -287,8 +280,7 @@ therefore applied after this base layout.
A fit calculation produces the base Content Frame. Zoom, pan, rotation, perspective and entrance
motion transform that result later. They do not mutate the `ContentFit` or source aspect.
-This prevents the old ambiguity where `zoom` was embedded inside `contain`/`cover` and could quietly
-invalidate the claimed fit. If a Ken Burns motion zooms a contained image until it crops, the base
+If a Ken Burns motion zooms a contained image until it crops, the base
fit remains `contain` and the later transform explicitly creates the crop.
Spatial sizing is also unrelated to intrinsic temporal occupancy. A video may be `contain` in space
@@ -408,60 +400,3 @@ Every dependency is a graph edge. `BlobArtifact` does not gain placement fields.
does not gain source, role, timing or Artifact digests. `VisualTrack` does not gain `focal`, B-roll
or Text fields. Affinity is validated by the multi-input fitting/lowering Operation rather than by
copying lineage metadata through every value.
-
-## 12. Legacy findings retained and retired
-
-Retained:
-
-- normalized author placement and source-aspect-aware anchored placement;
-- independent source fitting and temporal occupancy;
-- contain, cover, fit-width and fit-height equations;
-- independent foreground and backing sampling;
-- source focal alignment and explicit attachment points;
-- optional transparent, solid and self-blurred backings;
-- local motion over sampling/placement.
-
-Retired:
-
-- `SpaceLocator` as a union mixing regions, VLM inference, avoidance, path signals and fixed boxes;
-- nine-grid codes as separate algorithms;
-- one `focalX/focalY` reused as both source and target point;
-- `MediaBoxStyle` treating exactly one foreground and one special backing as the universal model;
-- embedding zoom into fit;
-- renderer-specific CSS and FFmpeg formulas as two sources of truth;
-- hidden `object-fit`, `object-position` or `backdrop-filter` defaults.
-
-## 13. Implementation and acceptance order
-
-1. **Implemented:** add the focused `@narratage/spatial` package with `CanvasSpace`, Frame/Point/Path,
- `IntrinsicExtent`, `ContentFit` and pure fit validation;
-2. **Implemented:** split Canvas declaration from Film assembly and connect the same Canvas value to Track layout and
- Composition;
-3. **Implemented:** migrate one simple Text Area and one simple Media still image through shared geometry;
-4. **Implemented:** add exact browser tests for every fit and alignment law;
-5. **Implemented:** prove ordered transparent/color/self-blur/alternate-source Media layers;
-6. **Implemented:** migrate all four Ranking components through explicit shared Frames; Comment
- Sticker remains deferred until it has its own design;
-7. only then freeze the Spatial Types and related Visual IR behavior.
-
-The test matrix must include:
-
-- portrait, landscape and square intrinsic extents against portrait, landscape and square Frames;
-- every sizing mode, including explicit distortion and scale-down;
-- all nine equal-point alignments plus unequal source/frame focal points;
-- bounded versus free alignment;
-- negative/partially/fully off-canvas Placement and Content Frames;
-- parent Frame percentages and pixel offsets;
-- source rotation/sample-aspect normalized before Spatial;
-- transparent, solid, same-source blur and alternate image/video layers;
-- independent backing and foreground Content Frames;
-- rounding/raster behavior locked by the selected renderer implementation;
-- no Core, Runtime, Film-family, Text-family or Media-family discriminator in the shared Types.
-
-The pure geometry matrix and real Chromium witness now cover every sizing mode, all nine equal-point
-alignments, unequal bounded/free focal points and partially/fully off-Canvas Frames. Media
-normalization additionally materializes container rotation and non-square sample aspect into a
-square-pixel visual before deriving `IntrinsicExtent`. Ranking now consumes the same explicit Frame
-geometry without adding a family discriminator. The final Visual IR compatibility audit now passes;
-Spatial's own author Surface remains pre-release, and no package-local percentage vocabulary should
-grow in the meantime.
diff --git a/spec/track-authoring.md b/spec/track-authoring.md
index a11ed8d4..3555b674 100644
--- a/spec/track-authoring.md
+++ b/spec/track-authoring.md
@@ -1,16 +1,13 @@
# SVML Video Track Authoring Model
-Status: executable temporal authority shared by the official Track packages. The focused
-`@narratage/temporal` package implements strict occurrence expansion, exact rational window
-projection and triggered sibling schedules. Shared Spatial, Text, Ranking, Media,
-Audio and Screen Overlay are now specified in [`spatial-layout.md`](./spatial-layout.md),
+The focused `@narratage/temporal` package implements strict occurrence expansion, exact rational
+window projection and triggered sibling schedules. Shared Spatial, Text, Ranking, Media, Audio and
+Screen Overlay are specified in [`spatial-layout.md`](./spatial-layout.md),
[`typography-track.md`](./typography-track.md), [`ranking-track.md`](./ranking-track.md),
[`media-track.md`](./media-track.md), [`deck-track.md`](./deck-track.md),
[`audio-track.md`](./audio-track.md) and
-[`screen-overlay.md`](./screen-overlay.md). The independently designed
-`@narratage/comment-sticker` package now uses the same Temporal and Spatial foundations and lowers
-to one peer VisualTrack. This is deliberately not a compatibility promise for a released public
-ABI.
+[`screen-overlay.md`](./screen-overlay.md). `@narratage/comment-sticker` uses the same Temporal and
+Spatial foundations and lowers to one peer VisualTrack.
## Purpose
@@ -136,10 +133,9 @@ type TemporalWindowProjection = {
};
```
-The serialized contract will use explicit units for durations. Seconds, milliseconds and integral
-frames are distinct author inputs; conversion to a rational ProgramSpace must have one deterministic
-boundary-quantization rule. `base_start` and `base_end` are retired names because the current
-architecture has no privileged Base Track.
+The serialized contract uses explicit units for durations. Seconds, milliseconds and integral
+frames are distinct author inputs; conversion to a rational ProgramSpace has one deterministic
+boundary-quantization rule. The vocabulary contains no privileged Base Track boundaries.
Common author meanings are ordinary expressions:
@@ -170,8 +166,7 @@ repeating an occurrence-invariant projection would otherwise manufacture identic
## 4. Occurrence expansion is strict and precedes projection
-The old shape `{ kind: "single", cardinality: "exactly_one" }` repeats one fact twice. The executable
-contract has two non-overlapping choices:
+The contract has two non-overlapping choices:
```ts
type OccurrenceExpansion =
@@ -364,7 +359,7 @@ type IntrinsicPlayback =
| { readonly mode: "stretch" };
```
-`once` replaces the ambiguous old word `finish`. End alignment never means reverse playback. It
+End alignment never means reverse playback. It
means the forward-playing source ends at the projected window's end. If the source is longer than
the window, start alignment selects the source head and end alignment selects the source tail.
@@ -389,7 +384,7 @@ occupancy and are unrelated.
## 7. Package ownership
-The former umbrella `contracts` package is intentionally absent. Nominal shared meanings are owned
+There is no umbrella `contracts` package. Nominal shared meanings are owned
by focused modules such as Narrative, ProgramSpace, Media and Composition; Core has no registry of
video-domain unions.
@@ -416,56 +411,15 @@ Speech Spine establishes ProgramSpace and contiguous speech takes. Other Tracks
whole Narrative Segment through its two structural anchors directly, without pretending it is an
authored Selection.
-## 8. Migration consequences
+## 8. Package consequences
The current `typography-track` Surface consumes the shared temporal package for Program, Selection
and Moment bindings, explicit point expressions and `one`/`each` expansion. It does not maintain a
second timing enum. Media Track consumes the same package for Item and Sequence timing.
-The executable acceptance coverage includes:
-
-- Selection and Moment `one` success and cardinality failure;
-- Selection and Moment `each`, stable occurrence identity and source-order preservation;
-- rejection of occurrence-invariant `each` projections with multiple occurrences;
-- all common point-expression combinations, including Program boundaries and absolute time;
-- crossed source anchors consumed and ignored by different projections;
-- negative offsets, ProgramSpace intersection, entirely out-of-range windows, reversed windows,
- zero windows and the one-frame minimum;
-- rational frame rates and deterministic half-open frame quantization;
-- atomic failure when one of several `each` occurrences is invalid;
-- package-owned disjoint, independent and sequence relations remaining separate from expansion;
-- cumulative and successor-handoff trigger sequences, including explicit terminal boundaries,
- equal-frame collisions, non-monotonic source order, stable identities and optional explicit
- initial state;
-- durationless products and shorter/equal/longer intrinsic products under every supported playback
- and alignment policy;
-- explicit audio behavior rather than reuse of visual `hold` semantics.
-
## 9. Ranking specialization
-The complete Ranking audit, component split, group schedule and executable migration are specified in
-[`ranking-track.md`](./ranking-track.md). Ranking now validates that the common temporal algebra can
+The Ranking component split and group schedule are specified in [`ranking-track.md`](./ranking-track.md).
+Ranking validates that the common temporal algebra can
support cumulative state, exclusive current stages and a final settled suffix without adding
Ranking or `Stage` meaning to Core or the public Track contract.
-
-## 10. Migration state
-
-Comment Sticker content, layout and presentation are implemented as an independent author package;
-it shares only the common Temporal, Spatial and terminal VisualTrack vocabulary. No currently
-specified Track family remains blocked on this common authoring model.
-
-For every currently specified official Track package, the implemented acceptance matrix proves
-Text, Caption, Media, Deck, Ranking and Screen Overlay lower to peer VisualTrack values, while
-generic Audio and optional Media/Ranking sound lower to peer AudioTrack values without changing
-Core or Composition.
-
-Generic Audio Track and self-contained Screen Overlay are now specified separately in
-[`audio-track.md`](./audio-track.md) and [`screen-overlay.md`](./screen-overlay.md). Audio reuses the
-same temporal algebra but has truthful sample occupancy rather than visual hold semantics. Screen
-Overlay is a full-canvas peer contribution, not a cross-Track adjustment layer.
-
-Unified Item/Sequence Media authoring, all motion channels, internal handoffs, explicit audio
-projection and Speech Spine's restricted reuse are now specified in
-[`media-track.md`](./media-track.md). The old depth-stack Deck is an independent higher-order Track
-component specified in [`deck-track.md`](./deck-track.md). B-roll is an editorial Recipe/usage
-rather than another public Track family.
diff --git a/spec/track-composition.md b/spec/track-composition.md
index b7c95c7c..2c2090e5 100644
--- a/spec/track-composition.md
+++ b/spec/track-composition.md
@@ -1,8 +1,5 @@
# SVML Track and Composition
-Status: executable repository-internal `@1` compatibility waist; all gates in
-[`track-expressiveness.md`](./track-expressiveness.md) pass, publication remains separate.
-
## Law
Except for the shared ProgramSpace and canvas geometry, every audiovisual contribution entering a
diff --git a/spec/track-expressiveness.md b/spec/track-expressiveness.md
deleted file mode 100644
index 608c7c6b..00000000
--- a/spec/track-expressiveness.md
+++ /dev/null
@@ -1,205 +0,0 @@
-# SVML Track Expressiveness Gate
-
-Status: all E1–E8 gates execute; repository-internal `svml.visual-track@1` waist frozen pre-publication.
-
-## Purpose
-
-One public Track contract must solve final audiovisual composition without pretending that every
-author package shares one authoring model. Text, Caption, Media, Ranking and future packages own
-their Programs and may revise those Programs independently. They may enter Composition only after
-lowering their package-specific meanings into self-contained, frame-exact contributions.
-
-This gate answers one question:
-
-> Can production-used text, media-box, caption, stacking and local-effect behavior lower into the
-> same Track waist without adding package-family fields to Track, Composition or Core?
-
-Passing this gate does not make one universal `TrackProgram`. The six Track Program axes—content,
-temporal source, window projection, spatial source, occupancy and presentation—remain a separation
-discipline for package authors, not six mandatory public fields. The shared authoring laws and the
-current temporal design are specified in [`track-authoring.md`](./track-authoring.md).
-
-## Three levels that must not collapse
-
-```text
-Package Program Resolved package facts Public Track
-─────────────────────── ──────────────────────────── ─────────────────────
-TextLayout / CaptionMode boxes, glyph runs, windows Presents
-Media sampling policy -> source-time and crop mapping -> exact frame spans
-effect recipe local animations absolute stacking
-semantic/spatial locator final placement self-contained elements
-```
-
-The Package Program is editable author truth. Resolved package facts are compiler evidence. The
-public Track is a terminal audiovisual contribution. Composition must never reconstruct the first
-two levels from the third.
-
-"Flat Track" means there is no Track nesting or implicit Track stacking context. A Present may
-still own an internal element tree. One authoring Track may emit several Presents at unrelated
-absolute stack positions so that peer Tracks can interleave between them.
-
-## Required witnesses
-
-### E1 — Text three-box lowering
-
-The official browser-oriented reference lowering must represent independently:
-
-1. an outer placement frame;
-2. an inner layout box controlling wrapping, alignment, direction and overflow;
-3. paint targets for the complete frame, shrink-wrapped content, each line or each word.
-
-Paint overflow such as glow or shadow must not become a line-measurement input merely because it is
-visible outside the content box. A package may lower a paint target by attaching paint to a
-different owned element; the public Track must not acquire a `textBackgroundTarget` field.
-
-### E2 — Caption range/cue/content lowering
-
-A Caption package must be able to lower a hard range boundary, a cue-level alignment/animation
-container, shrink-wrapped rows and independently styled or animated words. Dual-font and per-word
-paint are package facts. Composition sees only ordinary elements and Presents.
-
-### E3 — Media two-frame lowering
-
-A media package must be able to lower one resolved Placement Frame containing two independent
-samples of the same Artifact. Each sample derives its own Content Frame according to
-[`spatial-layout.md`](./spatial-layout.md):
-
-- a backdrop sample with its own cover/zoom/blur/tone treatment;
-- a foreground sample with its own contain/cover/fit-height and focal alignment.
-
-The public Track must not acquire B-roll, focal-preset or blurred-background fields. Artifact
-dependency collection must deduplicate the shared content digest.
-
-### E4 — Independent absolute stacking
-
-One package may emit a board at one absolute stack position and icons or labels at other positions.
-A Present from another Track must be able to appear between them. Track identity groups one
-self-contained render contribution; provenance lives in the Graph/Derivation and Track never forms
-a render stacking context.
-
-### E5 — Local motion and handoff
-
-Frame-exact opacity, transform, filter and clip animation may operate on elements owned by one
-Present. A package that owns both materials in a handoff may lower complementary Presents. No
-ordinary Track may sample the accumulated pixels below it or mutate a sibling Track.
-
-The Media package must additionally prove that entry, sustain, exit, per-layer sampling motion and
-Sequence pair handoffs remain separate channels with a fixed composition order. The independent
-Depth-Stack Deck package must prove that its collection-state reflow composes with Card-local motion
-without adding Deck meaning to the terminal Track. The complete models are specified in
-[`media-track.md`](./media-track.md) and [`deck-track.md`](./deck-track.md).
-
-### E6 — Materialized visual fallback
-
-A component whose deterministic visual result cannot be represented by the reference element tree
-must be able to materialize its owned result and contribute it as a typed Surface. For transparent
-interleaving, the final public contract must bind enough surface information to distinguish a
-compositable alpha-bearing visual from an opaque video. Merely naming a `.webm` Artifact does not
-prove this property.
-
-### E7 — Generic audio lowering
-
-The official Audio package must lower arbitrary explicit normalized sources, source trim, one-shot,
-loop, bounded pitch-preserving stretch, start/end alignment, gain and fades into the same peer
-`AudioTrack` waist. Overlapping clips mix without priority clipping or a privileged Base lane.
-Container stream selection, loudness processing and Provider placement remain explicit upstream or
-downstream graph work. The complete boundary is specified in
-[`audio-track.md`](./audio-track.md).
-
-### E8 — Self-contained screen overlay
-
-A full-canvas effect must lower to ordinary absolute-stack Presents made from owned Visual IR
-elements or an owned alpha-bearing Surface. It cannot read the accumulated lower composite, reserve
-the highest z-index or introduce a post-composition phase. Source-free blur, color-adjust and real
-zoom-blur therefore fail closed; their honest form consumes explicit media or Surface input outside
-the Screen Overlay package. See [`screen-overlay.md`](./screen-overlay.md).
-
-## Old-system attack matrix
-
-| Historical behavior | Package-owned truth | Required terminal witness |
-|---|---|---|
-| Text placement/layout/paint boxes | Text Program | nested owned elements |
-| frame/content/line/word background | Text Program | paint attached to the selected owned level |
-| caption range/cue/content boxes | Caption Program | nested owned elements and word-local animation |
-| dual fonts, CJK, emoji and writing direction | Text/Caption Program | text elements plus locked font/layout dependencies |
-| media content box plus foreground/backdrop sampling | media package | sibling media elements referencing one Artifact |
-| focal crop and fit-height | media package | deterministic sampling/placement result |
-| full-frame B-roll, corner GIF and lower media card | Media Item + Recipes | the same Item lowering against different Frames |
-| explicit media replacement group | Media Sequence | coordinated owned outgoing/incoming Presents |
-| visible card history and depth reflow | Depth-Stack Deck Track | package-owned collection state over ordinary Presents |
-| Ranking board and icons at unrelated z | Ranking Program | several absolute-stack Presents |
-| Media enter/exit and pair transition | Media Program | local frame-exact keyframes over owned Presents |
-| arbitrary self-contained visual | component/provider | materialized compositable Surface Artifact |
-| music/SFX/additional voice placement | Audio Program | ordinary frame-exact AudioTrack clips |
-| flash/vignette/grain/veil | Screen Overlay Program | owned full-canvas Presents or alpha Surface |
-| blur/color transform of a picture | explicit-input media effect | transformed owned material, never backdrop sampling |
-
-## Current executable evidence
-
-`packages/hyperframes/test/track-expressiveness.test.ts` constructs package-private lowering
-witnesses rather than adding Text, Caption, Media or Ranking fields to public contracts. Existing
-package tests separately prove ordinary Text, Caption and Media Programs lower through the same
-Track and Composition path.
-
-The current `VisualTrack / VisualPresent / VisualElement` candidate explicitly binds
-`svml.visual-ir@1` and can encode the structural three-box, two-box, word-local and
-absolute-stack cases. Two generic terminal facts are now
-executable rather than package-family patches:
-
-1. `FontArtifactRef` binds each exact fallback face, weight and style to one or more Blob sources.
- Unicode-range shards remain one logical face; exact text lowering emits content-addressed
- `@font-face` rules for every source and disables font synthesis;
-2. `CompositableSurfaceRef` binds dimensions, sRGB color space, opaque/straight alpha semantics and
- still/frame timing to Blob bytes. Animated Surfaces must exactly share the containing Present's
- frame count and ProgramSpace rate.
-
-`packages/hyperframes/test/browser-visual.test.ts` additionally drives real Hyperframes browser
-frames: installed content-addressed open fonts paint Latin, CJK and emoji/symbol glyphs through an ordered fallback
-stack; Text proves Point/Area/Path layout, all Box targets, rich runs, horizontal/vertical flow,
-clip/ellipsis/bounded shrink, ordered Paint, local Mask and forward/reverse selector clocks; Fine
-Caption proves multiline wrapping, full glyph Paint, every glyph karaoke mode and joined trail Pill
-line geometry; DepthStack Deck proves explicit old/new collection-state reflow, exact labels and
-byte-identical one-worker/partitioned frames; all eleven official Screen Overlay components preserve identical pixels under sequential and parallel frame rendering; and a
-50% straight-alpha PNG composites over a blue Track at the expected pixel values. This opt-in host
-test is run with `SVML_BROWSER_TESTS=1`; it proves the current local renderer path, not every future
-hosted Runtime.
-
-The IR style vocabulary is closed rather than arbitrary CSS: components cannot add an unknown
-property, environment-dependent value or alternate browser language without changing the protocol
-version. Every terminal text element now carries a non-empty exact Font Artifact stack; system-font
-fallback and a prototype family are invalid. The Runtime binds its locked implementation in the
-generic Receipt. HyperFrames additionally records the exact local browser digest or configured
-remote renderer-deployment digest in receipt-covered metadata. Shared ffprobe-based Surface-byte
-verification proves declared dimensions, timing, SDR/sRGB and alpha facts before local staging;
-Endpoints without this ability decline Surface-bearing documents.
-
-E1–E5, E7 and E8 now have their official package witnesses. `@narratage/typography-track` proves the
-complete three-box/Text terminal model without public Text fields; Caption and Media prove their
-independent package models. `@narratage/audio-track` proves the exact
-48 kHz source/target mapping, overlap law, bounded stretch and one shared local/remote
-`AudioProgramPlan`; `@narratage/screen-overlay` proves only self-contained owned pixels, explicit
-seeds, flat stacking and fail-closed rejection of lower-composite effects;
-`@narratage/deck-track` proves pure absolute-frame collection reflow over the union of old/new
-visible Cards while reusing Card-local Media lowering. `@narratage/ranking` supplies the real E4
-witness: board, stage and independently stacked Items interleave with an unrelated peer Track,
-while all four Ranking components retain frame-pure progressive state under partitioned browser
-rendering. E6 is complete through the typed path, independently installed non-native Text witness,
-byte verifier and fail-closed Endpoint support check.
-
-## Freeze criteria
-
-The repository-internal Track v1 waist satisfies all of the following:
-
-1. E1–E8 have executable structural, HTML-lowering and audio-plan witnesses;
-2. official Text/Caption lowerers either bind exact font Artifacts or explicitly materialize their
- glyph result, and the renderer implementation used for layout is receipt-bound;
-3. E6 has a typed compositable-Surface path whose Runtime validates the declared media facts and
- records the renderer implementation;
-4. installing a new Track package requires no Core, Film, Composition or family registry change;
-5. public Track data contains no Caption, Text, Media, Ranking or provider discriminator;
-6. a package can revise its Program schema while preserving or versioning only its own lowerer;
-7. unsupported cross-Track sampling fails closed.
-
-The implementation is therefore frozen for subsequent repository package work. Public npm
-publication, untrusted-code isolation and final release versioning remain separate release gates;
-they do not reopen the video meaning of this waist.
diff --git a/spec/typography-track.md b/spec/typography-track.md
index cae9ea42..60b0d557 100644
--- a/spec/typography-track.md
+++ b/spec/typography-track.md
@@ -1,8 +1,4 @@
-# Typography Track Authoring and Expressiveness
-
-Status: implemented pre-release authority for the official two-dimensional Text package. The
-complete declared model and browser evidence execute through the frozen repository-internal
-Track/Visual IR waist; the author Surface itself is not yet a published ABI.
+# Typography Track Authoring
## 1. Conclusion
@@ -35,91 +31,7 @@ The official Text package owns this author meaning. SVS only provides named immu
parameters. Visual IR remains the shared terminal video language. HyperFrames is one renderer of
that language, not the definition of Text.
-## 2. Audit evidence
-
-### 2.1 Current Narratage slice
-
-The current `packages/typography-track` implementation has one fixed rectangular box, one plain string
-and one `TextAppearance` containing color, size, family, weight, line height, horizontal/vertical
-alignment, one background, radius, padding and tracking. Its Surface accepts exactly `text`,
-`during` and `appearance`; its Recipe requires exactly eleven scalar properties.
-
-It currently cannot represent:
-
-- paragraphs, explicit line breaks or differently styled inline runs;
-- exact font Artifact inputs on the author Surface;
-- point text, intrinsic sizing or path text;
-- independent frame/content/paragraph/line/run/word/grapheme Paint targets;
-- gradients, repeated strokes, repeated shadows, glow or underline layers;
-- Unicode-aware word/grapheme behavior, bidirectional runs or vertical text policy;
-- item, line, word or grapheme animation;
-- text masks or materialized advanced text.
-
-This is a useful end-to-end witness only. Extending `TextAppearance` field by field would preserve
-the wrong model.
-
-### 2.2 Legacy evidence
-
-The legacy `TextLayoutV2` discovered several correct separations:
-
-- inline/block `hug | fixed` sizing;
-- independent padding and inline/block alignment;
-- no-wrap, word-wrap and character-wrap;
-- visible, clip, ellipsis and shrink overflow;
-- LTR/RTL and horizontal/vertical writing;
-- frame/content/line/word background targets;
-- line-box, cap-height and ink-bound metrics.
-
-Its renderer also implemented solid/gradient glyph fill, outside stroke, shadow, glow, callout
-tails, whole-item entry/loop motion, typewriter reveal and line/word backgrounds. Those are valuable
-behavioral witnesses.
-
-The implementation also exposes why it must not be copied as the new contract:
-
-- one `TextFields` bag mixes content, layout, Paint, motion and decoration;
-- gradient fill and background both compete for the CSS `background` property;
-- word backgrounds split on a whitespace regular expression and therefore do not define Unicode
- word behavior;
-- typewriter slices JavaScript code units rather than grapheme clusters;
-- outside stroke is an implicit duplicated-glyph renderer trick;
-- line fragments, shrink-to-fit and cap/ink trimming depend on browser behavior not represented in
- the authored value;
-- a pointer silently creates a background and several defaults are renderer inventions;
-- there is no rich-run, path-text or repeated Paint-layer model.
-
-An audited historical export contained 32 Text Tracks and 53 Text items. The most frequently used
-properties were alignment, font family/size, color, weight, background, radius and padding. Stroke,
-uppercase, no-wrap, full-width background, tracking and shadow were also used. The sample contained
-no Text animation usage. This proves the ordinary delivery baseline; it does not justify excluding
-the broader, well-established editor capabilities below.
-
-### 2.3 External editor attack matrix
-
-The design was checked against official product documentation rather than inferred from UI labels:
-
-| Capability family | Established examples | Required Narratage expression |
-|---|---|---|
-| advanced typography | tracking, kerning, leading, baseline shift, tabs, caps, super/subscript, underline and Tsume | typed typography and per-run overrides |
-| layered appearance | solid/gradient fill, inner/center/outer and repeated strokes, repeated shadows, glow | ordered, repeatable Paint layers |
-| geometric text boxes | point titles, area paragraphs, responsive alignment, rolls/crawls | separate Point and Area forms plus motion |
-| fragment styling | character/word/line styling and animation | deterministic units and selectors |
-| sequential animation | per-character delay, range/follower selectors, direction, spread and loops | selector plus property-animation stack |
-| path text | text following and animating along open/closed paths | explicit Path Text form |
-| text masks | text revealing explicitly owned media or graphics | sibling component with an explicit media input |
-| real 3D text | extrusion, bevel, materials, lighting and per-character 3D | materialized 3D component, not fake 2D fields |
-
-Reference documentation:
-
-- Adobe Premiere: [Text Styles](https://helpx.adobe.com/uk/premiere/desktop/add-text-images/stylize-text/create-text-styles.html)
- and [Text Style Parameters](https://helpx.adobe.com/ca/premiere/desktop/add-text-images/stylize-text/style-parameters-when-applying-from-style-browser.html)
-- Adobe After Effects: [Animating Text](https://helpx.adobe.com/uk/after-effects/desktop/animating-text/text-animation/animating-text.html)
-- Apple Final Cut Pro: [Adjust Titles](https://support.apple.com/en-qa/guide/final-cut-pro/ver4e32ca5/mac)
-- Apple Motion: [Sequence Text Behavior](https://support.apple.com/en-lamr/guide/motion/motn1607c46e/mac)
-- Blackmagic Design: [DaVinci Resolve 20 Visual Effects Guide](https://documents.blackmagicdesign.com/UserManuals/DaVinci-Resolve-20-Fusion-Visual-Effects.pdf?_v=1757574011000)
-
-This is an expressiveness attack set, not a request to reproduce every product's UI or preset list.
-
-## 3. Ownership and package boundary
+## 2. Ownership and package boundary
The ordinary two-dimensional package remains one package:
@@ -154,7 +66,7 @@ shape and one explicit still `CompositableSurface`. Rich runs, multiline/Path fl
animation and timed materials fail closed and use the same materialized-Surface escape route as 3D
Text. This boundary avoids pretending that browser `foreignObject` masking is portable or exact.
-## 4. Authored Text Document
+## 3. Authored Text Document
A Text item consumes a bounded rich document rather than an HTML fragment or arbitrary tree:
@@ -197,7 +109,7 @@ the smallest ordinary author-visible animation/decoration unit. A shaped glyph i
one-to-one correspondence with a Unicode character or grapheme, so the public author model must not
pretend otherwise.
-## 5. Three spatial forms
+## 4. Three spatial forms
Temporal source and window projection remain governed by
[`track-authoring.md`](./track-authoring.md). Text does not invent `full`, `from`, `until` or another
@@ -207,13 +119,13 @@ Spatial placement is independent from Text flow. The shared model in
[`spatial-layout.md`](./spatial-layout.md) provides resolved point/frame/path geometry; Text then
interprets that geometry through one of three forms.
-### 5.1 Point Text
+### 4.1 Point Text
Point Text is intrinsic text anchored at a resolved point. It normally hugs its content, does not
soft-wrap and uses an explicit inline/block anchor. Manual paragraph breaks remain valid. Ordinary
titles, labels and stickers are Point Text.
-### 5.2 Area Text
+### 4.2 Area Text
Area Text flows inside a resolved frame. It explicitly chooses:
@@ -234,7 +146,7 @@ explicit. `shrink` must declare a minimum scale and fail if the complete text st
must not silently cross that bound. This differs from Caption, which must never clip or discard the
author's display Atoms.
-### 5.3 Path Text
+### 4.3 Path Text
Path Text consumes an explicit owned vector path plus Text Document and Style. It owns path side,
orientation, start/end margins, alignment, reversal and overflow. Animating a margin moves text
@@ -244,7 +156,7 @@ another Track.
Path Text requires either a generic vector/path terminal primitive or an owned materialized
Surface. It cannot be claimed by serializing an untyped SVG/HTML string.
-## 6. Typography
+## 5. Typography
Typography is separate from Paint and layout but participates in layout measurement. It includes:
@@ -263,7 +175,7 @@ Exact font bytes remain explicit author graph inputs. They are not names hidden
not selected by the Runtime. Font shaping/layout implementation identity is bound by the accepting
derivation/render receipt; Core still knows nothing about fonts.
-## 7. Ordered Paint model
+## 6. Ordered Paint model
Paint is an ordered list, not one mutually exclusive set of CSS shortcuts. The Text Program owns
typed layers such as:
@@ -314,7 +226,7 @@ and its own Paint. It does not silently force a background. Frosted glass is not
Paint because it samples pixels behind the Track; it requires an explicitly owned media input or a
materialized self-contained component.
-## 8. Motion and sequence selectors
+## 7. Motion and sequence selectors
Motion is independent from Style so the same look can enter, loop and exit differently. One item
may have:
@@ -346,7 +258,7 @@ window; the Item window clips it without rewriting its timing. Sequence and Path
the same rule. This avoids rejecting a perfectly meaningful fast title animation merely because the
title remains visible, and avoids silently retiming a slow animation to fit a short window.
-## 9. Style declaration, SVS and readable authoring
+## 8. Style declaration, SVS and readable authoring
Declaration and use remain separate. SVS stays a generic scalar Recipe language; it must not learn
Text Paint arrays or become a second renderer. A Text Style Surface reads named Recipes, exact Font
@@ -406,7 +318,7 @@ properties are:
- exact fonts and timing/placement facts travel on explicit graph edges;
- the resulting Text Program contains no unresolved Recipe and no Runtime/provider choice.
-## 10. Compiled pipeline and data gates
+## 9. Compiled pipeline and data gates
```text
Markup Surface
@@ -439,10 +351,9 @@ It must bind the actual implementation and font bytes. Browser line boxes are no
generic graph metadata; they are either deterministic terminal layout owned by the renderer receipt
or package-owned resolved geometry used to materialize a Surface.
-## 11. Terminal Visual IR findings
+## 10. Terminal Visual IR
-The frozen repository-internal `svml.visual-ir@1` carries the smallest additions proven by this
-migration:
+`svml.visual-ir@1` carries the terminal Text forms:
- `text-flow` owns the bounded rich document, exact typography, ordered Paint and sequence values;
- `path-text` owns typed vector commands and exact path-flow facts;
@@ -451,72 +362,6 @@ migration:
- exact font Artifacts and typed `CompositableSurface` values cross the ordinary Artifact boundary.
The HyperFrames reference compiler implements those primitives without exposing HTML, CSS, SVG or
-renderer scripts to author packages. A separately installed non-native Text fixture proves that
-extrusion/material/light/camera semantics can remain outside the waist and contribute only a typed
-alpha Surface. Unsupported rich masks use the same path.
-
-These remain video-terminal facts, never Core facts. Renderer receipts, Surface-byte validation,
-Deck/Ranking witnesses and the final compatibility audit now pass without adding Text meaning to
-the shared waist.
-
-## 12. Feedback into Fine Caption
-
-Text and Caption share typography implementation problems, not author truth.
-
-The following may be shared through a focused video-domain implementation library, provisionally
-`@narratage/typography`, with no Author Surface and no graph Type unless a real cross-package edge
-later requires one:
-
-- Unicode grapheme/word/bidi segmentation;
-- exact font-stack loading and shaping;
-- gradient stops, ordered strokes/shadows/glows and box decoration geometry;
-- line-fragment and joined-Pill geometry;
-- grapheme-safe typewriter and deterministic selector evaluation;
-- terminal rich-text lowering helpers.
-
-This does not create a universal Text Program. Caption keeps `CaptionDisplaySequence`, Cue, Atom,
-speech correspondence and karaoke timing. Text keeps paragraphs, rich runs, point/area/path layout
-and arbitrary sequence selectors.
-
-Concrete Caption improvements discovered by this audit are:
-
-1. allow repeated ordered Stroke/Shadow/Glow layers instead of the current one-of-each ceiling;
-2. allow arbitrary gradient stops and radial as well as two-stop linear gradients;
-3. reuse explicit inner/center/outer Stroke semantics rather than renderer-dependent outline
- behavior;
-4. reuse grapheme-safe text transform/reveal and exact shaping;
-5. keep joined active-Pill geometry on the shared line-fragment implementation.
-
-Caption must **not** inherit Text ellipsis, clipping, shrink-to-fit, path flow, arbitrary rich-run
-timing or selector-generated speech timing. It always displays the author's complete immutable
-Atoms and activates only from proven Atom windows.
-
-## 13. Migration order and acceptance gates
-
-Implementation replaced the earlier slice rather than accreting compatibility fields:
-
-1. **Implemented:** Text Document, Point/Area tagged geometry, Text Style and ordered Paint values;
-2. **Implemented:** exact fonts, frame/content/paragraph/line/run/word/grapheme Box Paint and rich-run static lowering;
-3. **Implemented:** shared Temporal Window Projection and explicit Point/Frame/Path Spatial inputs;
-4. **Implemented:** deterministic overflow, direction/writing mode and browser pixel evidence;
-5. **Implemented:** item motion and Unicode-aware sequence selectors;
-6. **Implemented:** Path Text plus an exact bounded local Text Mask and fail-closed materialization boundary;
-7. **Implemented:** the `CompositableSurface` escape route with a separately installed non-native Text package witness;
-8. **Implemented:** freeze the repository-internal Visual IR after every repository-wide gate passes.
-
-Acceptance requires browser/render evidence for at least:
-
-- transparent Point Text and fixed Area Text;
-- content, frame, multiline line, isolated word, joined word and grapheme boxes;
-- nested run styles across wrapping boundaries;
-- Latin, CJK, RTL, combining marks and color Emoji with exact fonts;
-- repeated outside/inside strokes, multiple shadows, linear/radial gradients and glow;
-- visible/clip/ellipsis/bounded-shrink overflow;
-- item enter/exit/loop and forward/reverse grapheme/word/line sequencing;
-- Path Text;
-- explicit Text Mask ownership and one materialized advanced fallback;
-- no modification to Core, Runtime, Film or an unrelated Track package.
-
-The declared Text package gates now pass. This establishes a complete pre-release Text package on
-the frozen repository-internal Track/Visual IR waist; npm publication and the Text author Surface's
-own public-version promise remain separate.
+renderer scripts to author packages. Text extrusion, material, light or camera semantics remain in
+a separate component and enter Composition only through a typed alpha Surface. Unsupported rich
+masks use the same path. These are video-terminal facts, never Core facts.
diff --git a/spec/visual-ir.md b/spec/visual-ir.md
index 675ac121..66f3d084 100644
--- a/spec/visual-ir.md
+++ b/spec/visual-ir.md
@@ -1,7 +1,5 @@
# SVML Visual IR
-Status: implemented repository-internal `@1` compatibility waist; not yet published as an npm ABI.
-
## Position
`svml.visual-ir@1` is the one code-free terminal visual language shared by the official
@@ -101,29 +99,3 @@ Only a capability that is both broadly reusable and impossible to represent thro
paths may justify changing the `svml.visual-ir@1` contract. While Narratage is pre-release the
identifier remains `@1`, with exact implementation identity carried by digests and package locks.
Adding a Text style, Caption mode, Media recipe, transition or Provider never qualifies by itself.
-
-Old-system Text three-box, Caption range/cue/content and Media content-frame sampling models are
-therefore package-owned Programs and lowering evidence. They are expressiveness witnesses for this
-IR, not fields added to the IR.
-
-## Freeze evidence
-
-The identifier and closed vocabulary are executable. Exact Text fonts, multiline decoration,
-Path/Mask/overflow, Media focal sampling and alpha now have real browser evidence; a separately
-installed non-native Text package crosses the typed Surface waist without changing Core, Film or
-HyperFrames. The repository-internal `@1` waist is frozen because all four independent gates now
-execute:
-
-1. the generic Need Receipt binds the locked Endpoint implementation/configuration/Runtime closure,
- while HyperFrames' receipt-covered attestation binds the exact browser bytes locally or the
- explicitly configured immutable renderer deployment digest remotely;
-2. the shared media executor decodes Surface bytes and proves dimensions, frame timing, SDR/sRGB
- compatibility and opaque/straight-alpha facts before local rendering; a renderer Endpoint without
- that verifier must decline a Surface-bearing document;
-3. Deck and Ranking provide the remaining package-owned Track expressiveness witnesses;
-4. the repository-wide boundary audit proves that Composition contains no package-family/provider
- discriminator and the terminal compiler contains no hidden cross-Track sampling path.
-
-This freezes the protocol for subsequent package work in this repository. It is not a statement
-that npm packages have been published, that every author Surface is frozen, or that a future public
-release may skip its distribution and security review.
diff --git a/tools/recipe-defaults.test.mjs b/tools/recipe-defaults.test.mjs
deleted file mode 100644
index 6857c4f3..00000000
--- a/tools/recipe-defaults.test.mjs
+++ /dev/null
@@ -1,35 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-
-import {
- defaultFilmRecipe,
- filmAppearanceFromRecipe,
- filmRecipeKeys,
-} from "../packages/film/src/index.ts";
-
-/**
- * A module's default Recipe has to be a Recipe its own Surface would admit.
- *
- * The default and the required key set used to be stated twice — once as a
- * literal in the Surface handler and once wherever a consumer needed one — and
- * a copy that can drift silently is worse than no copy. Now the default is the
- * declaration and the key set is read off it, so the only thing left to check
- * is that the default actually survives the mapping it describes.
- */
-const MODULES = [
- { name: "film", keys: filmRecipeKeys, recipe: defaultFilmRecipe, read: filmAppearanceFromRecipe },
-];
-
-for (const module of MODULES) {
- test(`the ${module.name} default Recipe is one its own reader admits`, () => {
- assert.deepEqual([...module.keys].sort(), Object.keys(module.recipe).sort(),
- "the key set must be read off the default, not restated");
- assert.doesNotThrow(() => module.read(module.recipe));
- });
-
- test(`the ${module.name} reader refuses a Recipe with the wrong shape`, () => {
- const { [module.keys[0]]: _dropped, ...missing } = module.recipe;
- assert.throws(() => module.read(missing), /requires exactly/u);
- assert.throws(() => module.read({ ...module.recipe, unexpected: 1 }), /requires exactly/u);
- });
-}