Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: define the field-free fine caption boundary
kashorin6cc95ff89ee4
diff --git a/packages/caption-fine/README.md b/packages/caption-fine/README.mdindex 790f839b..5ac243ad 100644--- a/packages/caption-fine/README.md+++ b/packages/caption-fine/README.md@@ -1,8 +1,13 @@# `@narratage/caption-fine`The first official fine-grained Caption Style family. It turns an SVS Recipe into one complete-`CaptionStyle`: common Cue bounds, this family's `important` planning field, and the exact rendering-parameters that understand that field.+`CaptionStyle` and lowers timed Cues into one ordinary `VisualTrack`.++The accepted target is deliberately plain: semantic Cue bounds plus one deterministic static+appearance shared by every word in the Cue. Fine will declare no planning fields. `important`,+random word sizing, karaoke state and per-word motion are not part of this family. The current+executable baseline still contains the temporary optional `important` experiment; that is a known+implementation delta, not a compatibility promise.```xml<fine:Style id="primary" recipe={studio.caption.primary}/>@@ -17,4 +22,4 @@ parameters that understand that field.One `fine:Track` handles the default and all ordered overrides and emits one ordinary`VisualTrack`. The common `@narratage/caption` package does not know this package's fonts, boxes,-colors or the meaning of `important`.+colors or placement rules.diff --git a/spec/caption-fine.md b/spec/caption-fine.mdnew file mode 100644index 00000000..6f1afa43--- /dev/null+++ b/spec/caption-fine.md@@ -0,0 +1,73 @@+# Fine Caption Style Family++Status: accepted direction; parameter surface deliberately not frozen; current implementation has+the deltas listed below.++## Purpose++`@narratage/caption-fine` is one concrete Caption Style family. In this family, "fine-grained"+means that immutable Script display words are divided into short semantic Cues. It does not mean+that individual words receive ornamental semantic classes.++Every word in one Cue uses one uniform static appearance. This family declares:++```text+planning.fields = []+```++It has no `important`, emphasis, active-word, karaoke or random-size semantics. Another package may+declare fields or motion without changing this family or the common Caption contract.++## Package boundary++| Owner | Responsibility |+|---|---|+| `@narratage/caption` | generic Style envelope, Cue/field Plan law, total Style assignment and SemanticMap timing join |+| `@narratage/caption-fine` | Fine Recipe schema, deterministic layout/paint interpretation and VisualTrack lowering |+| `@narratage/media` | renderable byte identities such as the existing `FontArtifactRef`, never Caption typography policy |+| `@narratage/visual-ir` | closed terminal element/style/keyframe vocabulary |+| Core | graph demand, validation, derivation and execution only; no Caption meaning |++Using a Type owned by Caption or Media does not transfer implementation ownership. Removing a Fine+field, changing a Fine anchor or revising its box layout must not modify Caption, Media, Visual IR,+Composition or Core when the existing public Types can already carry the result.++## Accepted dimensions++The Style-family surface will be designed across four independent concerns:++1. Cue planning: only minimum/maximum display-word bounds and a fixed no-rewrite planning law.+2. Geometry: placement anchor, bounded range, alignment, line packing and absolute stack order.+3. Typography: deterministic font choice and ordinary size/spacing metrics.+4. Paint: restrained readability controls such as solid fill, outline, shadow and an optional+ content background.++The exact property names, defaults and bounds are not frozen by this document. Motion, gradients,+glow, long shadow, backdrop sampling, case rewriting, random variation and field-dependent paint+must not enter merely to reproduce the old engine's option count.++Cue timing is not a fifth Style dimension. It comes from the independent `TimedCaptionProjection`:+the first and last included display-word windows determine the Cue window. Fine adds no hidden hold,+lead, fade or provider-dependent timing.++## Font boundary++The current executable Fine baseline names an environment font in its Recipe. Exact font bytes are+a separate reproducibility problem shared by Text, Caption, Ranking and future typography+components. `@narratage/media` already defines `FontArtifactRef`; adding an author Surface for local+font files and connecting that value explicitly is separate work. It must not be smuggled into the+Fine redesign as a Caption-specific Media contract.++## Current implementation delta++Before this Style family can be treated as its accepted design, its package alone must:++- remove `important-min-per-cue`, `important-max-per-cue`, `important-fill` and `important-scale`;+- emit an empty field declaration list;+- remove field-dependent word color/scale and related attributes;+- replace the current left/top box with a deterministic bounded layout after its small parameter+ set is reviewed;+- add real browser/pixel evidence for placement, wrapping and basic paint.++Quickstarts continue to describe the executable baseline until this delta is implemented. They are+not a reason to preserve the temporary field.diff --git a/spec/caption-program.md b/spec/caption-program.mdindex acf0b855..d9f5c848 100644--- a/spec/caption-program.md+++ b/spec/caption-program.md@@ -73,9 +73,10 @@ A `CaptionStyle` is a complete author declaration with two inseparable payloads:parameters.Styles are declared separately from where they apply. The common Caption contract owns Cue-partitioning and field assignment shapes, but it does not own fonts, colors, three-box layout,-animation modes or the meaning of `important`. Those belong to a concrete Style family such as-`@narratage/caption-fine`.+partitioning and field assignment shapes, but it does not own fonts, colors, box layout, animation+modes or the meaning of any field id. Those belong to concrete Style families. A Style family may+declare no fields at all: the accepted `@narratage/caption-fine` direction uses only Cue partitioning+and one uniform static appearance for every word in a Cue.A field declaration has a stable id, value schema, natural-language instruction andminimum/maximum assignment count per Cue. Boolean, enum and bounded numeric values are supported.