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.

docs: define the field-free fine caption boundary

kashorin6cc95ff89ee4
diff --git a/packages/caption-fine/README.md b/packages/caption-fine/README.md
index 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.md
new file mode 100644
index 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.md
index 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 and
minimum/maximum assignment count per Cue. Boolean, enum and bounded numeric values are supported.