@hypit/caption-fine 0.0.0-stage → 0.1.0

package/dist/manifest.d.ts

@@ -0,0 +1,854 @@
+import type { ModuleManifest } from "@hypit/hypit/protocol";
+export declare const captionFineModuleRef: {
+    readonly name: "@hypit/caption-fine";
+    readonly version: "1";
+};
+export declare const captionFineTypes: {
+    readonly schedule: {
+        readonly module: {
+            readonly name: "@hypit/caption-fine";
+            readonly version: "1";
+        };
+        readonly name: "FineCaptionSchedule";
+    };
+};
+export declare const captionFineProducers: {
+    schedule: {
+        module: {
+            readonly name: "@hypit/caption-fine";
+            readonly version: "1";
+        };
+        name: string;
+    };
+    render: {
+        module: {
+            readonly name: "@hypit/caption-fine";
+            readonly version: "1";
+        };
+        name: string;
+    };
+    renderWithRegions: {
+        module: {
+            readonly name: "@hypit/caption-fine";
+            readonly version: "1";
+        };
+        name: string;
+    };
+};
+export declare const captionFineMarkupSurfaces: readonly [{
+    readonly name: "style";
+    readonly tag: "Style";
+    readonly mode: "structured";
+    readonly outputs: readonly [{
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    }];
+    readonly vocabulary: {
+        readonly summary: "Resolves one SVS Recipe and one exact font stack into a complete fine-grained Caption Style.";
+        readonly attributes: readonly [{
+            readonly name: "id";
+            readonly kind: "identifier";
+            readonly required: true;
+            readonly summary: "Names this Style so a Use can select it.";
+        }, {
+            readonly name: "recipe";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/recipe";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Chooses the Recipe that carries Cue geometry, Paint and local motion.";
+            readonly recipe: readonly [{
+                readonly name: "stack-order";
+                readonly required: true;
+                readonly summary: "Places this Style's Cues in the composition drawing order, low behind high.";
+            }, {
+                readonly name: "x";
+                readonly required: true;
+                readonly summary: "Places the Cue box horizontally as a fraction of the selected Frame's width.";
+            }, {
+                readonly name: "y";
+                readonly required: true;
+                readonly summary: "Places the Cue box vertically as a fraction of the selected Frame's height.";
+            }, {
+                readonly name: "width";
+                readonly required: true;
+                readonly summary: "Sets the Cue box width as a fraction of the selected Frame's width.";
+            }, {
+                readonly name: "height";
+                readonly required: false;
+                readonly summary: "Optionally gives the Caption Region a fixed fraction of the selected Frame's height; without it the Region hugs its Cue.";
+            }, {
+                readonly name: "anchor-x";
+                readonly required: false;
+                readonly values: readonly ["left", "center", "right"];
+                readonly fallback: "left";
+                readonly summary: "Decides which horizontal edge of the Cue box sits on the placement point.";
+            }, {
+                readonly name: "anchor-y";
+                readonly required: false;
+                readonly values: readonly ["top", "center", "bottom"];
+                readonly fallback: "top";
+                readonly summary: "Decides which vertical edge of the Cue box sits on the placement point.";
+            }, {
+                readonly name: "align";
+                readonly required: true;
+                readonly values: readonly ["left", "center", "right"];
+                readonly summary: "Aligns the Words within each line of the Cue.";
+            }, {
+                readonly name: "block-align";
+                readonly required: false;
+                readonly values: readonly ["start", "center", "end"];
+                readonly fallback: "center";
+                readonly summary: "Aligns the Cue vertically inside a fixed-height Caption Region.";
+            }, {
+                readonly name: "inline-size";
+                readonly required: false;
+                readonly values: readonly ["hug", "fixed"];
+                readonly fallback: "hug";
+                readonly summary: "Chooses whether the Cue hugs its text up to the Region width or fills the Region width.";
+            }, {
+                readonly name: "wrap";
+                readonly required: false;
+                readonly values: readonly ["word", "grapheme"];
+                readonly fallback: "word";
+                readonly summary: "Wraps at Word boundaries, falling back for an over-wide Word, or permits a break at any grapheme.";
+            }, {
+                readonly name: "max-lines";
+                readonly required: false;
+                readonly summary: "Rejects too many counted rows; requires max-words-per-line. Does not measure browser wrapping or guarantee a single physical line.";
+            }, {
+                readonly name: "max-words-per-line";
+                readonly required: false;
+                readonly summary: "Optional counted row breaks between complete alignment units. Counts display Words, normally individual characters in Chinese; preserves Cues. Omit for width-based flow.";
+            }, {
+                readonly name: "direction";
+                readonly required: false;
+                readonly values: readonly ["ltr", "rtl"];
+                readonly fallback: "ltr";
+                readonly summary: "Sets the writing direction the Words are laid out in.";
+            }, {
+                readonly name: "line-height";
+                readonly required: true;
+                readonly summary: "Sets the line box height as a multiple of the type size.";
+            }, {
+                readonly name: "letter-spacing";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Adds pixels of tracking between glyphs.";
+            }, {
+                readonly name: "word-gap";
+                readonly required: false;
+                readonly fallback: "a quarter of size";
+                readonly summary: "Sets the pixel width of authored display separators. Writing-system and numeric boundaries do not create spaces; use letter-spacing for glyph tracking.";
+            }, {
+                readonly name: "size";
+                readonly required: true;
+                readonly summary: "Sets the type size in pixels.";
+            }, {
+                readonly name: "kerning";
+                readonly required: false;
+                readonly values: readonly ["auto", "normal", "none"];
+                readonly fallback: "auto";
+                readonly summary: "Controls font kerning for the complete uniform Cue flow.";
+            }, {
+                readonly name: "caps";
+                readonly required: false;
+                readonly values: readonly ["normal", "small-caps", "all-small-caps"];
+                readonly fallback: "normal";
+                readonly summary: "Chooses the OpenType caps presentation for every Word.";
+            }, {
+                readonly name: "text-transform";
+                readonly required: false;
+                readonly values: readonly ["none", "uppercase", "lowercase", "capitalize"];
+                readonly fallback: "none";
+                readonly summary: "Recases every display Word before it is drawn.";
+            }, {
+                readonly name: "fill";
+                readonly required: true;
+                readonly summary: "Paints the glyph body of an ordinary Word, as an RGB or RGBA hex color.";
+            }, {
+                readonly name: "opacity";
+                readonly required: false;
+                readonly fallback: "1";
+                readonly summary: "Fades the whole glyph Paint of an ordinary Word.";
+            }, {
+                readonly name: "gradient-from";
+                readonly required: false;
+                readonly summary: "Starts a glyph gradient that replaces the flat fill, and must be written together with gradient-to.";
+            }, {
+                readonly name: "gradient-to";
+                readonly required: false;
+                readonly summary: "Ends the glyph gradient, and must be written together with gradient-from.";
+            }, {
+                readonly name: "gradient-angle";
+                readonly required: false;
+                readonly fallback: "90";
+                readonly summary: "Turns the glyph gradient by this many degrees.";
+            }, {
+                readonly name: "stroke-color";
+                readonly required: false;
+                readonly fallback: "#000000";
+                readonly summary: "Paints the outline drawn around each glyph.";
+            }, {
+                readonly name: "stroke-width";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets the glyph outline thickness in pixels, and the number that matters is its share of `size`: about a twentieth. At a `size` of 46 that is 2px, at 54 it is 3px. Write it from `size` every time rather than picking a pixel count, because the whole width shows — the outline is placed outside the letter, so it keeps the letterform but grows into the space around it twice as fast as a centred one would. Past about a tenth of `size` neighbouring letters meet, the counters fill in, and the caption reads as a slab rather than as words.";
+            }, {
+                readonly name: "shadow-color";
+                readonly required: false;
+                readonly fallback: "#000000";
+                readonly summary: "Paints the soft drop shadow behind each glyph.";
+            }, {
+                readonly name: "shadow-opacity";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how strongly the glyph drop shadow reads.";
+            }, {
+                readonly name: "shadow-x";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Slides the whole shadow sideways, so its ink lands at this plus `shadow-spread` plus about one and a half times `shadow-blur` from the letter. A shadow that reads as depth rather than as a second copy of the word stays under its own blur: around a fortieth of `size`, 1px at 46.";
+            }, {
+                readonly name: "shadow-y";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Drops the whole shadow, positive downward, reaching this plus `shadow-spread` plus about one and a half times `shadow-blur`. Down is the direction that runs out of room: the gap between line boxes is `line-height` minus one, times `size`, and past it the shadow lands on the line below. Around a fortieth of `size`, 1px at 46.";
+            }, {
+                readonly name: "shadow-blur";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Softens the glyph drop shadow by this many pixels. A shadow that only has to lift the caption off the picture is soft and short — a blur near a tenth of `size` with an offset a fraction of that. Much more and the shadow stops being an edge and becomes a grey cloud the letters sit in, which costs the contrast the shadow was there to protect.";
+            }, {
+                readonly name: "shadow-spread";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Grows the shadow's silhouette before it is blurred, on every side. The shadow then reaches this plus the offset plus about one and a half times `shadow-blur`, so it is the smallest of the three: around a fiftieth of `size`, 1px at 46. Zero and below dilate nothing; the filter grows the shape and has no way to shrink it.";
+            }, {
+                readonly name: "long-shadow-color";
+                readonly required: false;
+                readonly fallback: "#000000";
+                readonly summary: "Paints the solid extruded shadow trailing each glyph.";
+            }, {
+                readonly name: "long-shadow-opacity";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how strongly the extruded glyph shadow reads.";
+            }, {
+                readonly name: "long-shadow-distance";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how far the extruded glyph shadow travels in pixels. It is a deliberate graphic effect rather than separation from the picture, so it is chosen on purpose or left at zero. When used, a travel of a tenth to a fifth of `size` reads as depth; beyond that the extrusion reaches the line below and the block stops being readable as lines of text.";
+            }, {
+                readonly name: "long-shadow-angle";
+                readonly required: false;
+                readonly fallback: "45";
+                readonly summary: "Sets the direction the extruded glyph shadow travels in degrees.";
+            }, {
+                readonly name: "glow-color";
+                readonly required: false;
+                readonly fallback: "#FFFFFF";
+                readonly summary: "Paints the halo bloomed around each glyph.";
+            }, {
+                readonly name: "glow-opacity";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how strongly the glyph halo reads.";
+            }, {
+                readonly name: "glow-blur";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Spreads the glyph halo by this many pixels. A halo reads as a halo while it stays close to the glyph — near a tenth of `size`. Spread wide it stops tracing the letters, fills the space between them and washes the caption into a bright smear; the gaps between letters go first, exactly as they do under a heavy outline.";
+            }, {
+                readonly name: "glow-spread";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Grows the letterform before the halo is blurred, hard-edged, on every side. It adds to the blur rather than replacing it — the halo reaches this plus about one and a half times `glow-blur` — so it is the smaller number of the two: around a fiftieth of `size`, 1px at 46. At a fifth of `size` the dilated letters touch before any softening and the counters close.";
+            }, {
+                readonly name: "active-fill";
+                readonly required: false;
+                readonly fallback: "#FFD54A";
+                readonly summary: "Paints the glyph body of the Word being spoken.";
+            }, {
+                readonly name: "active-opacity";
+                readonly required: false;
+                readonly fallback: "opacity";
+                readonly summary: "Fades the whole glyph Paint of the Word being spoken.";
+            }, {
+                readonly name: "active-gradient-from";
+                readonly required: false;
+                readonly summary: "Starts the active glyph gradient, and must be written together with active-gradient-to.";
+            }, {
+                readonly name: "active-gradient-to";
+                readonly required: false;
+                readonly summary: "Ends the active glyph gradient, and must be written together with active-gradient-from.";
+            }, {
+                readonly name: "active-gradient-angle";
+                readonly required: false;
+                readonly fallback: "gradient-angle";
+                readonly summary: "Turns the active glyph gradient by this many degrees.";
+            }, {
+                readonly name: "active-stroke-color";
+                readonly required: false;
+                readonly fallback: "stroke-color";
+                readonly summary: "Paints the outline around the Word being spoken.";
+            }, {
+                readonly name: "active-stroke-width";
+                readonly required: false;
+                readonly fallback: "stroke-width";
+                readonly summary: "Sets the active glyph outline thickness in pixels. It inherits `stroke-width`, and the same share of `size` holds: emphasis on the spoken Word is carried by its Paint, so thickening its outline past the rest buys little and closes the gaps between its letters first.";
+            }, {
+                readonly name: "active-shadow-color";
+                readonly required: false;
+                readonly fallback: "shadow-color";
+                readonly summary: "Paints the drop shadow behind the Word being spoken.";
+            }, {
+                readonly name: "active-shadow-opacity";
+                readonly required: false;
+                readonly fallback: "shadow-opacity";
+                readonly summary: "Sets how strongly the active drop shadow reads.";
+            }, {
+                readonly name: "active-shadow-x";
+                readonly required: false;
+                readonly fallback: "shadow-x";
+                readonly summary: "Slides the spoken Word's shadow sideways. It inherits `shadow-x`, and the visible quantity is the difference: the shadow jumps by it as the Word becomes active and jumps back as it stops, which reads as the light moving mid-line.";
+            }, {
+                readonly name: "active-shadow-y";
+                readonly required: false;
+                readonly fallback: "shadow-y";
+                readonly summary: "Drops the spoken Word's shadow, positive downward. It inherits `shadow-y`, and the visible quantity is the difference: the shadow steps down as the Word becomes active and back up as it stops, which reads as the Word lifting off the line.";
+            }, {
+                readonly name: "active-shadow-blur";
+                readonly required: false;
+                readonly fallback: "shadow-blur";
+                readonly summary: "Softens the spoken Word's drop shadow, reaching about one and a half times this number. It inherits `shadow-blur`, and the visible quantity is the difference: any gap between the two reads as the Word sitting at a different depth from the words beside it.";
+            }, {
+                readonly name: "active-shadow-spread";
+                readonly required: false;
+                readonly fallback: "shadow-spread";
+                readonly summary: "Grows the spoken Word's shadow silhouette before blur. It inherits `shadow-spread`, and the visible quantity is the difference. Zero and below dilate nothing; the filter grows the shape and has no way to shrink it.";
+            }, {
+                readonly name: "active-long-shadow-color";
+                readonly required: false;
+                readonly fallback: "long-shadow-color";
+                readonly summary: "Paints the extruded shadow trailing the Word being spoken.";
+            }, {
+                readonly name: "active-long-shadow-opacity";
+                readonly required: false;
+                readonly fallback: "long-shadow-opacity";
+                readonly summary: "Sets how strongly the active extruded shadow reads.";
+            }, {
+                readonly name: "active-long-shadow-distance";
+                readonly required: false;
+                readonly fallback: "long-shadow-distance";
+                readonly summary: "Sets how far the active extruded shadow travels in pixels.";
+            }, {
+                readonly name: "active-long-shadow-angle";
+                readonly required: false;
+                readonly fallback: "long-shadow-angle";
+                readonly summary: "Sets the direction the active extruded shadow travels in degrees.";
+            }, {
+                readonly name: "active-glow-color";
+                readonly required: false;
+                readonly fallback: "glow-color";
+                readonly summary: "Paints the halo bloomed around the Word being spoken.";
+            }, {
+                readonly name: "active-glow-opacity";
+                readonly required: false;
+                readonly fallback: "glow-opacity";
+                readonly summary: "Sets how strongly the active halo reads.";
+            }, {
+                readonly name: "active-glow-blur";
+                readonly required: false;
+                readonly fallback: "glow-blur";
+                readonly summary: "Spreads the active halo by this many pixels. Widening it is the usual way of trying to make the spoken Word stand out, and the usual way of losing it: the halo leaves the glyph, fills the gaps to its neighbours and blurs the very Word it was meant to pick out. The Word is already picked out by its own Paint — leave this near `glow-blur`.";
+            }, {
+                readonly name: "active-glow-spread";
+                readonly required: false;
+                readonly fallback: "glow-spread";
+                readonly summary: "Grows the spoken Word's letterform before its halo is blurred. It inherits `glow-spread`, and the visible quantity is the difference: the Word's halo is thicker than its neighbours' by exactly that, and the gap it closes first is `word-gap`.";
+            }, {
+                readonly name: "background";
+                readonly required: true;
+                readonly summary: "Paints the Cue box behind the Words, as an RGB or RGBA hex color.";
+            }, {
+                readonly name: "border-color";
+                readonly required: false;
+                readonly fallback: "#00000000";
+                readonly summary: "Paints the Cue box border.";
+            }, {
+                readonly name: "border-width";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets the Cue box border thickness in pixels.";
+            }, {
+                readonly name: "padding";
+                readonly required: true;
+                readonly summary: "Insets the Words from the Cue box edge, as one pixel number or a vertical and horizontal pair.";
+            }, {
+                readonly name: "radius";
+                readonly required: true;
+                readonly summary: "Rounds the Cue box corners by this many pixels.";
+            }, {
+                readonly name: "cue-shadow-color";
+                readonly required: false;
+                readonly fallback: "#000000";
+                readonly summary: "Paints the shadow cast by the Cue box rather than by its glyphs.";
+            }, {
+                readonly name: "cue-shadow-opacity";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets the Cue box shadow opacity.";
+            }, {
+                readonly name: "cue-shadow-x";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Slides the whole Cue box shadow sideways, so it clears the box on one side by this plus spread plus blur and is hidden behind it on the other. Kept under the blur it reads as depth; past it the shadow becomes a band beside the box.";
+            }, {
+                readonly name: "cue-shadow-y";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Drops the whole Cue box shadow, positive downward. Kept under `cue-shadow-blur` it reads as the box lifting off the picture; past it the shadow's top edge clears the box and shows as a bare band under it.";
+            }, {
+                readonly name: "cue-shadow-blur";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Softens the Cue box shadow, reaching about this far past the box and no further. This is the one place the two shadow families differ: a glyph `shadow-blur` is halved into a deviation and reaches half again as far, while this number is the reach. Around a tenth of `size`, 5px at 46.";
+            }, {
+                readonly name: "cue-shadow-spread";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Grows the shadow rectangle before it is blurred, and unlike the glyph shadow it does contract: a negative spread equal to the blur pulls the shadow entirely behind the box. The edge sits at this plus `cue-shadow-blur` past every side, before any offset.";
+            }, {
+                readonly name: "underline";
+                readonly required: false;
+                readonly values: readonly ["off", "always"];
+                readonly fallback: "off";
+                readonly summary: "Decides whether every Word carries a rule beneath it.";
+            }, {
+                readonly name: "underline-color";
+                readonly required: false;
+                readonly fallback: "fill";
+                readonly summary: "Paints the ordinary Word underline.";
+            }, {
+                readonly name: "underline-thickness";
+                readonly required: false;
+                readonly fallback: "2";
+                readonly summary: "Sets the ordinary Word underline thickness in pixels.";
+            }, {
+                readonly name: "underline-offset";
+                readonly required: false;
+                readonly fallback: "4";
+                readonly summary: "Drops the ordinary Word underline this many pixels below the baseline.";
+            }, {
+                readonly name: "active-underline";
+                readonly required: false;
+                readonly values: readonly ["off", "current", "trail"];
+                readonly fallback: "off";
+                readonly summary: "Decides whether the Word being spoken, or every Word up to it, carries a rule beneath it.";
+            }, {
+                readonly name: "active-underline-color";
+                readonly required: false;
+                readonly fallback: "#FFD54A";
+                readonly summary: "Paints the active Word underline.";
+            }, {
+                readonly name: "active-underline-thickness";
+                readonly required: false;
+                readonly fallback: "3";
+                readonly summary: "Sets the active Word underline thickness in pixels.";
+            }, {
+                readonly name: "active-underline-offset";
+                readonly required: false;
+                readonly fallback: "4";
+                readonly summary: "Drops the active Word underline this many pixels below the baseline.";
+            }, {
+                readonly name: "karaoke";
+                readonly required: false;
+                readonly values: readonly ["off", "current", "trail"];
+                readonly fallback: "off";
+                readonly summary: "Decides whether the active Paint marks only the Word being spoken or every Word up to it.";
+            }, {
+                readonly name: "karaoke-transition";
+                readonly required: false;
+                readonly values: readonly ["step", "wipe"];
+                readonly fallback: "step";
+                readonly summary: "step activates each whole timed unit at its start (normally one Han character in Chinese); wipe sweeps inside that unit's glyphs during its own interval.";
+            }, {
+                readonly name: "active-box";
+                readonly required: false;
+                readonly values: readonly ["off", "current", "trail"];
+                readonly fallback: "off";
+                readonly summary: "Decides whether a highlight box sits behind the Word being spoken or behind every Word up to it.";
+            }, {
+                readonly name: "active-box-continuity";
+                readonly required: false;
+                readonly values: readonly ["isolated", "joined"];
+                readonly fallback: "isolated";
+                readonly summary: "Decides whether trailing highlight boxes stand apart or merge into one run.";
+            }, {
+                readonly name: "active-box-background";
+                readonly required: false;
+                readonly fallback: "#FFD54A";
+                readonly summary: "Paints the highlight box behind the active Word.";
+            }, {
+                readonly name: "active-box-border-color";
+                readonly required: false;
+                readonly fallback: "#00000000";
+                readonly summary: "Paints the highlight box border.";
+            }, {
+                readonly name: "active-box-border-width";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets the highlight box border thickness in pixels.";
+            }, {
+                readonly name: "active-box-padding";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Insets the Word from the highlight box edge, as one pixel number or a vertical and horizontal pair.";
+            }, {
+                readonly name: "active-box-radius";
+                readonly required: false;
+                readonly fallback: "8";
+                readonly summary: "Rounds the highlight box corners by this many pixels.";
+            }, {
+                readonly name: "active-box-enter";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as the highlight box arrives on a Word.";
+            }, {
+                readonly name: "active-box-exit";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as the highlight box leaves a Word.";
+            }, {
+                readonly name: "active-box-transition-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how many Frames the highlight box entrance and exit each run for.";
+            }, {
+                readonly name: "cue-enter";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as a Cue arrives.";
+            }, {
+                readonly name: "cue-enter-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how many Frames the Cue entrance runs for.";
+            }, {
+                readonly name: "cue-enter-start-scale";
+                readonly required: false;
+                readonly summary: "Overrides the Cue entrance motion's initial uniform scale while preserving that motion's own curve; 0.55 begins at fifty-five percent size and settles at one.";
+            }, {
+                readonly name: "cue-exit";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as a Cue leaves.";
+            }, {
+                readonly name: "cue-exit-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how many Frames the Cue exit runs for.";
+            }, {
+                readonly name: "atom-enter";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as an Atom arrives within its Cue.";
+            }, {
+                readonly name: "atom-enter-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how many Frames the Atom entrance runs for.";
+            }, {
+                readonly name: "atom-exit";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion as an Atom leaves within its Cue.";
+            }, {
+                readonly name: "atom-exit-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Sets how many Frames the Atom exit runs for.";
+            }, {
+                readonly name: "atom-reveal";
+                readonly required: false;
+                readonly values: readonly ["all", "on-start", "typewriter"];
+                readonly fallback: "all";
+                readonly summary: "Decides whether a Cue shows all of its Atoms at once or uncovers them as they are spoken.";
+            }, {
+                readonly name: "active-response";
+                readonly required: false;
+                readonly values: readonly ["none", "fade", "pop", "scale", "spring", "bounce", "elastic", "stamp", "tilt", "zoom-blur", "flip-x", "flip-y", "spin", "squash", "stretch", "slide-left", "slide-right", "slide-up", "slide-down", "blur-in", "wipe-left", "wipe-right", "wipe-up", "wipe-down"];
+                readonly fallback: "none";
+                readonly summary: "Plays this motion on a Word at the moment it becomes the spoken one.";
+            }, {
+                readonly name: "active-response-frames";
+                readonly required: false;
+                readonly fallback: "6";
+                readonly summary: "Sets how many Frames the active response runs for.";
+            }, {
+                readonly name: "active-scale";
+                readonly required: false;
+                readonly fallback: "1.08";
+                readonly summary: "Sets how far the active response grows the Word.";
+            }, {
+                readonly name: "slide-distance";
+                readonly required: false;
+                readonly fallback: "24";
+                readonly summary: "Sets how far the sliding and wiping motions travel in pixels.";
+            }, {
+                readonly name: "loop";
+                readonly required: false;
+                readonly fallback: "none";
+                readonly values: readonly ["none", "shake", "wobble", "glow-pulse", "breathe", "float", "pulse", "flicker"];
+                readonly summary: "Plays this motion continuously for as long as its target is on screen.";
+            }, {
+                readonly name: "loop-target";
+                readonly required: false;
+                readonly values: readonly ["cue", "active-atom"];
+                readonly fallback: "cue";
+                readonly summary: "Decides whether the looping motion moves the whole Cue or only the Atom being spoken.";
+            }, {
+                readonly name: "loop-period-frames";
+                readonly required: false;
+                readonly fallback: "12";
+                readonly summary: "Sets how many Frames one cycle of the looping motion takes.";
+            }, {
+                readonly name: "loop-intensity";
+                readonly required: false;
+                readonly fallback: "1";
+                readonly summary: "Scales how far the looping motion carries.";
+            }, {
+                readonly name: "lead-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Makes the Cue visible this many Frames before its first timed unit without moving any unit timing.";
+            }, {
+                readonly name: "tail-frames";
+                readonly required: false;
+                readonly fallback: "0";
+                readonly summary: "Keeps the Cue visible this many Frames after its last timed unit without extending any unit timing.";
+            }, {
+                readonly name: "handoff";
+                readonly required: false;
+                readonly values: readonly ["cut", "overlap"];
+                readonly fallback: "cut";
+                readonly summary: "Chooses whether adjacent Cue visibility envelopes meet without overlap or may coexist.";
+            }];
+        }, {
+            readonly name: "font";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/media";
+                    readonly version: "1";
+                };
+                name: string;
+            }, {
+                module: {
+                    readonly name: "@hypit/media";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Chooses the primary face, or a whole reusable stack that already carries its own fallbacks.";
+        }];
+        readonly children: readonly [{
+            readonly tag: "Fallback";
+            readonly cardinality: "many";
+            readonly summary: "Appends one more exact face after the primary one, in the order written, and accepts no children of its own.";
+            readonly attributes: readonly [{
+                readonly name: "font";
+                readonly kind: "reference";
+                readonly required: true;
+                readonly accepts: readonly [{
+                    module: {
+                        readonly name: "@hypit/media";
+                        readonly version: "1";
+                    };
+                    name: string;
+                }];
+                readonly summary: "Chooses the single face this fallback contributes.";
+            }];
+        }];
+        readonly example: "<fontsource:Face id=\"caption-font\" package=\"@fontsource-variable/inter\" weight=\"800\" style=\"normal\"/>\n<caption-fine:Style id=\"primary-caption\" recipe={recipes.caption.primary} font={caption-font}/>";
+        readonly notes: readonly ["Referencing a font stack in `font` and writing `<Fallback>` children are both allowed; the stack's faces come first.", "The Style is addressed by its own id, and the element accepts no text.", "The Recipe accepts only the properties declared here; any other property is rejected.", "A gradient needs both of its colors: writing any one of `gradient-from`, `gradient-to` or `gradient-angle` without both colors is rejected, and the same holds for the `active-` gradient.", "The active glyph Paint inherits every base property it does not override, except the gradient, which the active Paint drops unless it writes its own."];
+    };
+}, {
+    readonly name: "caption";
+    readonly tag: "Caption";
+    readonly mode: "structured";
+    readonly outputs: readonly [{
+        readonly module: {
+            readonly name: "@hypit/caption-fine";
+            readonly version: "1";
+        };
+        readonly name: "FineCaptionSchedule";
+    }, {
+        module: {
+            readonly name: "@hypit/composition";
+            readonly version: "1";
+        };
+        name: string;
+    }, {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    }, {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    }, {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    }];
+    readonly vocabulary: {
+        readonly summary: "Renders an authored CaptionDocument at its already resolved CaptionTiming as one ordinary peer VisualTrack.";
+        readonly appearance: "One block of caption text wrapped into lines inside a rounded Cue box, placed at a Recipe-chosen point in the selected Frame and spanning a fraction of its width. Cues follow the speech one after another, each arriving and leaving with its own motion, and the Words of a Cue either stand there together from its first Frame or uncover as they are spoken. As the speech advances, the Word being spoken, or every Word up to it, is repainted in the active Paint, snapping at the Word boundary or sweeping across the glyphs, and it may take a rule beneath it, a rounded highlight capsule behind it and a brief pop at the moment it becomes the spoken one. That capsule either stands alone on each Atom or grows as one continuous run over everything already read, following the Words across line breaks.\n\nEvery Cue uses the ordered exact font stack its Style names, with fallback faces supplying glyphs for other scripts. Emphasis varies by timed unit through the active Paint. Lines follow the common flow, so a line cannot be given a separate face, colour or weight of its own. A caption whose lines are set in different typefaces is outside what this Caption can draw.";
+        readonly preview: {
+            mediaType: string;
+            path: string;
+            open: () => Promise<Uint8Array<ArrayBuffer>>;
+        };
+        readonly attributes: readonly [{
+            readonly name: "id";
+            readonly kind: "identifier";
+            readonly required: true;
+            readonly summary: "Names this Caption so its rendered visual contribution can be placed in a Film.";
+        }, {
+            readonly name: "document";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/caption";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Chooses the source-neutral CaptionDocument.";
+        }, {
+            readonly name: "timing";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/caption";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Chooses resolved absolute timing for this CaptionDocument.";
+        }, {
+            readonly name: "timeline";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/timeline";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "The complete absolute film Timeline.";
+        }, {
+            readonly name: "within";
+            readonly kind: "reference";
+            readonly required: true;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/spatial";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Chooses the resolved picture-plane Frame used by Recipe x, y, width and height.";
+        }, {
+            readonly name: "regions";
+            readonly kind: "reference";
+            readonly required: false;
+            readonly accepts: readonly [{
+                module: {
+                    readonly name: "@hypit/region-evidence";
+                    readonly version: "1";
+                };
+                name: string;
+            }];
+            readonly summary: "Optionally follows external, frame-exact regions whose ids equal Script Roles, placing a Cue at its measured speaker region's top center and hiding it on null Frames.";
+        }];
+        readonly children: readonly [{
+            readonly tag: "Use";
+            readonly cardinality: "many";
+            readonly summary: "Presents matching complete Cues. A Window can narrow its scope; later matching Uses replace earlier ones.";
+            readonly attributes: readonly [{
+                readonly name: "id";
+                readonly kind: "identifier";
+                readonly required: false;
+                readonly summary: "Optional occurrence identity.";
+            }, {
+                readonly name: "style";
+                readonly kind: "reference";
+                readonly required: true;
+                readonly accepts: readonly [{
+                    module: {
+                        readonly name: "@hypit/caption";
+                        readonly version: "1";
+                    };
+                    name: string;
+                }];
+                readonly summary: "Complete Caption Style, including Hidden.";
+            }, {
+                readonly name: "role";
+                readonly kind: "literal";
+                readonly required: false;
+                readonly summary: "Optional speaker filter, independent of the time window.";
+            }, ...import("@hypit/hypit/markup").SurfaceAttributeVocabulary[]];
+        }];
+        readonly ports: readonly [{
+            readonly name: "schedule";
+            readonly type: {
+                readonly module: {
+                    readonly name: "@hypit/caption-fine";
+                    readonly version: "1";
+                };
+                readonly name: "FineCaptionSchedule";
+            };
+            readonly summary: "The visible Cue schedule consumed by the renderer and other declared tools.";
+        }, {
+            readonly name: "visual";
+            readonly type: {
+                module: {
+                    readonly name: "@hypit/composition";
+                    readonly version: "1";
+                };
+                name: string;
+            };
+            readonly summary: "The rendered Caption as one self-contained VisualTrack.";
+        }];
+        readonly example: "<caption-fine:Caption id=\"captions\" document={story.caption} timing={story-captions} timeline={film.timeline} within={vertical.bounds}>\n  <caption-fine:Use style={primary-caption}/>\n  <caption-fine:Use during={answer} style={answer-caption}/>\n</caption-fine:Caption>";
+        readonly notes: readonly ["Use without time attributes applies to every matching Cue in the CaptionDocument. Role filters content without changing a Window.", "Script authors complete Cues; Use windows change presentation without cutting those Cues or restarting Unit timing. A hidden Use still replaces earlier presentation.", "Without regions, Recipe x/y placement is unchanged. With regions, a measured region overrides x/y for that Frame; a null Frame in that Role series hides the Cue, while a missing Role series retains authored x/y.", "The tracked point replaces Recipe x/y while width and the Recipe anchor still decide the Caption box geometry; anchor-x=center and anchor-y=bottom place the box immediately above the measured region."];
+    };
+}];
+export declare const captionFineManifest: ModuleManifest;