@cueframe/kernel 0.2.51 → 0.2.53

package/dist/_members/composition/validators/registry.d.ts

@@ -38,8 +38,8 @@ export declare const PrimitiveRegistryEntry: z.ZodObject<{
         overlay: "overlay";
         effect: "effect";
         text: "text";
-        transition: "transition";
         layout: "layout";
+        transition: "transition";
     }>;
     version: z.ZodString;
     origin: z.ZodEnum<{

package/dist/_members/composition/validators/render.d.ts

@@ -205,6 +205,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                     h: number;
                 } | undefined;
                 fit?: "contain" | "cover" | undefined;
+                captionVisibility?: "visible" | "hidden" | undefined;
                 effects?: {
                     primitiveId: string;
                     params?: Record<string, unknown> | undefined;
@@ -315,6 +316,79 @@ export declare const RenderSnapshot: z.ZodObject<{
                 annotationColor: z.ZodOptional<z.ZodString>;
                 maxWidthPercent: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            layouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                segmentIndex: z.ZodNumber;
+                wordStartIndex: z.ZodNumber;
+                wordEndIndex: z.ZodNumber;
+                region: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                scale: z.ZodOptional<z.ZodNumber>;
+                rotation: z.ZodOptional<z.ZodNumber>;
+                style: z.ZodOptional<z.ZodObject<{
+                    fontFamily: z.ZodOptional<z.ZodString>;
+                    fontWeight: z.ZodOptional<z.ZodNumber>;
+                    emphasisFontWeight: z.ZodOptional<z.ZodNumber>;
+                    emphasisFontStyle: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        italic: "italic";
+                    }>>;
+                    emphasisFontFamily: z.ZodOptional<z.ZodString>;
+                    fontSize: z.ZodOptional<z.ZodNumber>;
+                    color: z.ZodOptional<z.ZodString>;
+                    highlightColor: z.ZodOptional<z.ZodString>;
+                    backgroundColor: z.ZodOptional<z.ZodString>;
+                    plate: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        glass: "glass";
+                        solid: "solid";
+                    }>>;
+                    textTransform: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        uppercase: "uppercase";
+                        capitalize: "capitalize";
+                    }>>;
+                    emphasisColor: z.ZodOptional<z.ZodString>;
+                    emphasisScale: z.ZodOptional<z.ZodNumber>;
+                    emphasisTextTransform: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        uppercase: "uppercase";
+                        capitalize: "capitalize";
+                    }>>;
+                    emphasisLetterSpacing: z.ZodOptional<z.ZodNumber>;
+                    entrance: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        fade: "fade";
+                        "word-pop": "word-pop";
+                        "stagger-up": "stagger-up";
+                    }>>;
+                    entranceMs: z.ZodOptional<z.ZodNumber>;
+                    entranceStaggerMs: z.ZodOptional<z.ZodNumber>;
+                    exitMs: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlate: z.ZodOptional<z.ZodBoolean>;
+                    emphasisPlateColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateTextColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateAltColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateAltTextColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateRadius: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlatePadX: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlatePadY: z.ZodOptional<z.ZodNumber>;
+                    annotationColor: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                holdThroughWordIndex: z.ZodOptional<z.ZodNumber>;
+                wordMarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    wordIndex: z.ZodNumber;
+                    emphasis: z.ZodOptional<z.ZodBoolean>;
+                    annotate: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        circle: "circle";
+                        underline: "underline";
+                    }>>>;
+                }, z.core.$strict>>>;
+                wordSignature: z.ZodString;
+            }, z.core.$strict>>>;
             zPlane: z.ZodOptional<z.ZodEnum<{
                 front: "front";
                 "behind-subject": "behind-subject";
@@ -396,6 +470,79 @@ export declare const RenderSnapshot: z.ZodObject<{
                 annotationColor: z.ZodOptional<z.ZodString>;
                 maxWidthPercent: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            layouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                segmentIndex: z.ZodNumber;
+                wordStartIndex: z.ZodNumber;
+                wordEndIndex: z.ZodNumber;
+                region: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                scale: z.ZodOptional<z.ZodNumber>;
+                rotation: z.ZodOptional<z.ZodNumber>;
+                style: z.ZodOptional<z.ZodObject<{
+                    fontFamily: z.ZodOptional<z.ZodString>;
+                    fontWeight: z.ZodOptional<z.ZodNumber>;
+                    emphasisFontWeight: z.ZodOptional<z.ZodNumber>;
+                    emphasisFontStyle: z.ZodOptional<z.ZodEnum<{
+                        normal: "normal";
+                        italic: "italic";
+                    }>>;
+                    emphasisFontFamily: z.ZodOptional<z.ZodString>;
+                    fontSize: z.ZodOptional<z.ZodNumber>;
+                    color: z.ZodOptional<z.ZodString>;
+                    highlightColor: z.ZodOptional<z.ZodString>;
+                    backgroundColor: z.ZodOptional<z.ZodString>;
+                    plate: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        glass: "glass";
+                        solid: "solid";
+                    }>>;
+                    textTransform: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        uppercase: "uppercase";
+                        capitalize: "capitalize";
+                    }>>;
+                    emphasisColor: z.ZodOptional<z.ZodString>;
+                    emphasisScale: z.ZodOptional<z.ZodNumber>;
+                    emphasisTextTransform: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        uppercase: "uppercase";
+                        capitalize: "capitalize";
+                    }>>;
+                    emphasisLetterSpacing: z.ZodOptional<z.ZodNumber>;
+                    entrance: z.ZodOptional<z.ZodEnum<{
+                        none: "none";
+                        fade: "fade";
+                        "word-pop": "word-pop";
+                        "stagger-up": "stagger-up";
+                    }>>;
+                    entranceMs: z.ZodOptional<z.ZodNumber>;
+                    entranceStaggerMs: z.ZodOptional<z.ZodNumber>;
+                    exitMs: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlate: z.ZodOptional<z.ZodBoolean>;
+                    emphasisPlateColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateTextColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateAltColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateAltTextColor: z.ZodOptional<z.ZodString>;
+                    emphasisPlateRadius: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlatePadX: z.ZodOptional<z.ZodNumber>;
+                    emphasisPlatePadY: z.ZodOptional<z.ZodNumber>;
+                    annotationColor: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                holdThroughWordIndex: z.ZodOptional<z.ZodNumber>;
+                wordMarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    wordIndex: z.ZodNumber;
+                    emphasis: z.ZodOptional<z.ZodBoolean>;
+                    annotate: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        circle: "circle";
+                        underline: "underline";
+                    }>>>;
+                }, z.core.$strict>>>;
+                wordSignature: z.ZodString;
+            }, z.core.$strict>>>;
             zPlane: z.ZodOptional<z.ZodEnum<{
                 front: "front";
                 "behind-subject": "behind-subject";
@@ -1049,6 +1196,7 @@ export declare const RenderJob: z.ZodObject<{
                         h: number;
                     } | undefined;
                     fit?: "contain" | "cover" | undefined;
+                    captionVisibility?: "visible" | "hidden" | undefined;
                     effects?: {
                         primitiveId: string;
                         params?: Record<string, unknown> | undefined;
@@ -1159,6 +1307,79 @@ export declare const RenderJob: z.ZodObject<{
                     annotationColor: z.ZodOptional<z.ZodString>;
                     maxWidthPercent: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
+                layouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    segmentIndex: z.ZodNumber;
+                    wordStartIndex: z.ZodNumber;
+                    wordEndIndex: z.ZodNumber;
+                    region: z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>;
+                    scale: z.ZodOptional<z.ZodNumber>;
+                    rotation: z.ZodOptional<z.ZodNumber>;
+                    style: z.ZodOptional<z.ZodObject<{
+                        fontFamily: z.ZodOptional<z.ZodString>;
+                        fontWeight: z.ZodOptional<z.ZodNumber>;
+                        emphasisFontWeight: z.ZodOptional<z.ZodNumber>;
+                        emphasisFontStyle: z.ZodOptional<z.ZodEnum<{
+                            normal: "normal";
+                            italic: "italic";
+                        }>>;
+                        emphasisFontFamily: z.ZodOptional<z.ZodString>;
+                        fontSize: z.ZodOptional<z.ZodNumber>;
+                        color: z.ZodOptional<z.ZodString>;
+                        highlightColor: z.ZodOptional<z.ZodString>;
+                        backgroundColor: z.ZodOptional<z.ZodString>;
+                        plate: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            glass: "glass";
+                            solid: "solid";
+                        }>>;
+                        textTransform: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            uppercase: "uppercase";
+                            capitalize: "capitalize";
+                        }>>;
+                        emphasisColor: z.ZodOptional<z.ZodString>;
+                        emphasisScale: z.ZodOptional<z.ZodNumber>;
+                        emphasisTextTransform: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            uppercase: "uppercase";
+                            capitalize: "capitalize";
+                        }>>;
+                        emphasisLetterSpacing: z.ZodOptional<z.ZodNumber>;
+                        entrance: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            fade: "fade";
+                            "word-pop": "word-pop";
+                            "stagger-up": "stagger-up";
+                        }>>;
+                        entranceMs: z.ZodOptional<z.ZodNumber>;
+                        entranceStaggerMs: z.ZodOptional<z.ZodNumber>;
+                        exitMs: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlate: z.ZodOptional<z.ZodBoolean>;
+                        emphasisPlateColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateTextColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateAltColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateAltTextColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateRadius: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlatePadX: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlatePadY: z.ZodOptional<z.ZodNumber>;
+                        annotationColor: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    holdThroughWordIndex: z.ZodOptional<z.ZodNumber>;
+                    wordMarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        wordIndex: z.ZodNumber;
+                        emphasis: z.ZodOptional<z.ZodBoolean>;
+                        annotate: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                            circle: "circle";
+                            underline: "underline";
+                        }>>>;
+                    }, z.core.$strict>>>;
+                    wordSignature: z.ZodString;
+                }, z.core.$strict>>>;
                 zPlane: z.ZodOptional<z.ZodEnum<{
                     front: "front";
                     "behind-subject": "behind-subject";
@@ -1240,6 +1461,79 @@ export declare const RenderJob: z.ZodObject<{
                     annotationColor: z.ZodOptional<z.ZodString>;
                     maxWidthPercent: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
+                layouts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    segmentIndex: z.ZodNumber;
+                    wordStartIndex: z.ZodNumber;
+                    wordEndIndex: z.ZodNumber;
+                    region: z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>;
+                    scale: z.ZodOptional<z.ZodNumber>;
+                    rotation: z.ZodOptional<z.ZodNumber>;
+                    style: z.ZodOptional<z.ZodObject<{
+                        fontFamily: z.ZodOptional<z.ZodString>;
+                        fontWeight: z.ZodOptional<z.ZodNumber>;
+                        emphasisFontWeight: z.ZodOptional<z.ZodNumber>;
+                        emphasisFontStyle: z.ZodOptional<z.ZodEnum<{
+                            normal: "normal";
+                            italic: "italic";
+                        }>>;
+                        emphasisFontFamily: z.ZodOptional<z.ZodString>;
+                        fontSize: z.ZodOptional<z.ZodNumber>;
+                        color: z.ZodOptional<z.ZodString>;
+                        highlightColor: z.ZodOptional<z.ZodString>;
+                        backgroundColor: z.ZodOptional<z.ZodString>;
+                        plate: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            glass: "glass";
+                            solid: "solid";
+                        }>>;
+                        textTransform: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            uppercase: "uppercase";
+                            capitalize: "capitalize";
+                        }>>;
+                        emphasisColor: z.ZodOptional<z.ZodString>;
+                        emphasisScale: z.ZodOptional<z.ZodNumber>;
+                        emphasisTextTransform: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            uppercase: "uppercase";
+                            capitalize: "capitalize";
+                        }>>;
+                        emphasisLetterSpacing: z.ZodOptional<z.ZodNumber>;
+                        entrance: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
+                            fade: "fade";
+                            "word-pop": "word-pop";
+                            "stagger-up": "stagger-up";
+                        }>>;
+                        entranceMs: z.ZodOptional<z.ZodNumber>;
+                        entranceStaggerMs: z.ZodOptional<z.ZodNumber>;
+                        exitMs: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlate: z.ZodOptional<z.ZodBoolean>;
+                        emphasisPlateColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateTextColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateAltColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateAltTextColor: z.ZodOptional<z.ZodString>;
+                        emphasisPlateRadius: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlatePadX: z.ZodOptional<z.ZodNumber>;
+                        emphasisPlatePadY: z.ZodOptional<z.ZodNumber>;
+                        annotationColor: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    holdThroughWordIndex: z.ZodOptional<z.ZodNumber>;
+                    wordMarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        wordIndex: z.ZodNumber;
+                        emphasis: z.ZodOptional<z.ZodBoolean>;
+                        annotate: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                            circle: "circle";
+                            underline: "underline";
+                        }>>>;
+                    }, z.core.$strict>>>;
+                    wordSignature: z.ZodString;
+                }, z.core.$strict>>>;
                 zPlane: z.ZodOptional<z.ZodEnum<{
                     front: "front";
                     "behind-subject": "behind-subject";

package/dist/_members/composition-ops/index.d.ts

@@ -170,6 +170,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>;
+        captionVisibility: z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -363,6 +367,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>>;
+        captionVisibility: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>>;
         effects: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -552,6 +560,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>;
+        captionVisibility: z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -790,6 +802,80 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
         annotationColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         maxWidthPercent: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"setCaptionLayouts">;
+    layouts: z.ZodArray<z.ZodObject<{
+        segmentIndex: z.ZodNumber;
+        wordStartIndex: z.ZodNumber;
+        wordEndIndex: z.ZodNumber;
+        region: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        scale: z.ZodOptional<z.ZodNumber>;
+        rotation: z.ZodOptional<z.ZodNumber>;
+        style: z.ZodOptional<z.ZodObject<{
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodNumber>;
+            emphasisFontWeight: z.ZodOptional<z.ZodNumber>;
+            emphasisFontStyle: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+            }>>;
+            emphasisFontFamily: z.ZodOptional<z.ZodString>;
+            fontSize: z.ZodOptional<z.ZodNumber>;
+            color: z.ZodOptional<z.ZodString>;
+            highlightColor: z.ZodOptional<z.ZodString>;
+            backgroundColor: z.ZodOptional<z.ZodString>;
+            plate: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                glass: "glass";
+                solid: "solid";
+            }>>;
+            textTransform: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                uppercase: "uppercase";
+                capitalize: "capitalize";
+            }>>;
+            emphasisColor: z.ZodOptional<z.ZodString>;
+            emphasisScale: z.ZodOptional<z.ZodNumber>;
+            emphasisTextTransform: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                uppercase: "uppercase";
+                capitalize: "capitalize";
+            }>>;
+            emphasisLetterSpacing: z.ZodOptional<z.ZodNumber>;
+            entrance: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                fade: "fade";
+                "word-pop": "word-pop";
+                "stagger-up": "stagger-up";
+            }>>;
+            entranceMs: z.ZodOptional<z.ZodNumber>;
+            entranceStaggerMs: z.ZodOptional<z.ZodNumber>;
+            exitMs: z.ZodOptional<z.ZodNumber>;
+            emphasisPlate: z.ZodOptional<z.ZodBoolean>;
+            emphasisPlateColor: z.ZodOptional<z.ZodString>;
+            emphasisPlateTextColor: z.ZodOptional<z.ZodString>;
+            emphasisPlateAltColor: z.ZodOptional<z.ZodString>;
+            emphasisPlateAltTextColor: z.ZodOptional<z.ZodString>;
+            emphasisPlateRadius: z.ZodOptional<z.ZodNumber>;
+            emphasisPlatePadX: z.ZodOptional<z.ZodNumber>;
+            emphasisPlatePadY: z.ZodOptional<z.ZodNumber>;
+            annotationColor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        holdThroughWordIndex: z.ZodOptional<z.ZodNumber>;
+        wordMarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            wordIndex: z.ZodNumber;
+            emphasis: z.ZodOptional<z.ZodBoolean>;
+            annotate: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                circle: "circle";
+                underline: "underline";
+            }>>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"applyMotionPreset">;
     clipId: z.ZodString;

package/dist/_members/core/render/compositionAudioAndDepth.d.ts

@@ -6,14 +6,20 @@ export declare function bindBehindSubjectHosts(overlays: CompositionOverlay[], c
 export declare function assertBehindSubjectCaptionCoverage(captionSegments: RenderInput['captionSegments'], clips: readonly CompositionClip[], fps: number, output: {
     width: number;
     height: number;
-}, effects?: readonly CompositionEffect[]): void;
+}, effects?: readonly CompositionEffect[], captionLayouts?: RenderInput['captionLayouts']): void;
+/** The geometry needed to decide which video picture is visible, without an asset URL. */
+export type VisiblePictureClip = Pick<CompositionClip, 'id' | 'trackId' | 'contentIndex' | 'layerIndex' | 'timelineStartFrames' | 'durationInFrames'> & Partial<Pick<CompositionClip, 'region' | 'fit' | 'sourceWidth' | 'sourceHeight' | 'cropTrajectory' | 'cropTrajectoryUrl' | 'captionVisibility' | 'packedUrl' | 'mediaType'>> & {
+    hasClipEffects?: boolean;
+    hasCropIntent?: boolean;
+};
 /** The visible full-frame picture at each interval, following the renderer's zIndex/layer order. */
-export declare function visiblePackedHostWindows(clips: readonly CompositionClip[], startFrame: number, endFrame: number, output: {
+export declare function visiblePackedHostWindows(clips: readonly VisiblePictureClip[], startFrame: number, endFrame: number, output: {
     width: number;
     height: number;
-}, effects?: readonly CompositionEffect[]): Array<{
+}, effects?: readonly CompositionEffect[], hostMode?: 'packed-only' | 'all-video-candidates'): Array<{
     startFrame: number;
     endFrame: number;
     hostClipId?: string;
     candidateClipIds: string[];
+    captionVisible: boolean;
 }>;

package/dist/_members/core/render/compositionRender.d.ts

@@ -2,10 +2,24 @@ import type { Composition, Format, TimelineClip as WireClip } from "../../compos
 import type { RenderInput } from "./types.js";
 import type { TrajectoryData } from "../../composition/reframe/trajectory.js";
 import { type PreparedRenderInputLeaseV1, type SceneShotPreparationDependenciesV1 } from "./sceneShotPreparation.js";
+import { visiblePackedHostWindows } from "./compositionAudioAndDepth.js";
 export { validateComposition } from "./compositionValidation.js";
 export { assertBehindSubjectCaptionCoverage, visiblePackedHostWindows } from "./compositionAudioAndDepth.js";
 /** Re-exported from `trackProjection`, where the frame-lattice helpers it belongs with now live. */
 export { playableSpans, projectMediaPlaybackSpans } from "./trackProjection.js";
+/**
+ * Project the saved video timeline into candidate visible-picture windows for fact planning.
+ * No source URL or matte binding is created here. A hostClipId names the uniquely visible
+ * video candidate; callers must still check that its exact matte exists and is ready.
+ */
+export declare function captionVisibilityWindowsForComposition(composition: Composition, sourceDimensions: Record<string, {
+    width: number;
+    height: number;
+}>): {
+    fps: number;
+    windows: ReturnType<typeof visiblePackedHostWindows>;
+    mediaIdByProjectedClipId: Record<string, string>;
+};
 export declare function compositionFormatDimensions(format: Format): {
     width: number;
     height: number;

package/dist/_members/core/render/index.d.ts

@@ -1,4 +1,4 @@
-export type { RenderInput, ProjectedVisualIdentity, CompositionClip, CompositionOverlay, CompositionAudioTrack, CompositionEffect, CaptionWord, CaptionStyle, OverlayTemplate, OverlayParams, SceneShotOverlayMarkerV1, SceneShotSealedFontFace, SceneShotSlotBindingV1 } from './types.js';
+export type { RenderInput, ProjectedVisualIdentity, CompositionClip, CompositionOverlay, CompositionAudioTrack, CompositionEffect, CaptionWord, CaptionStyle, CaptionLayout, OverlayTemplate, OverlayParams, SceneShotOverlayMarkerV1, SceneShotSealedFontFace, SceneShotSlotBindingV1 } from './types.js';
 export { SCENE_SHOT_IMAGE_MIME_TYPES, SCENE_SHOT_PARAM, SCENE_SHOT_PREPARATION_STAGE, assertSceneClipShapes, prepareSceneShotRenderInput, readSceneShotManifest, resolvePinnedSceneFactsV1, sceneSourceResolverForPinnedRows, } from './sceneShotPreparation.js';
 export type { PreparedRenderInputLeaseV1, ResolvedScenePreparationFactsV1, SceneShotPreparationDependenciesV1, SceneShotPreparationLocator, } from './sceneShotPreparation.js';
 export type { ResolvedBrandKit } from '../../composition/projection/index.js';
@@ -11,7 +11,7 @@ export type { EmphasisWord } from './emphasis.js';
 export type { DocNode, TranscriptUtterance } from './captions.js';
 export { buildEmphasisSet, isEmphasized } from './emphasis.js';
 export { extractCaptionWordsFromDoc, sliceTranscriptWords, splitIntoSentences } from './captions.js';
-export { compositionToRenderInput, referencedMediaIds, assembleRenderInput, assemblePreparedRenderInput, validateComposition, compositionFormatDimensions, playableSpans, projectMediaPlaybackSpans, assertBehindSubjectCaptionCoverage, visiblePackedHostWindows, } from './compositionRender.js';
+export { compositionToRenderInput, referencedMediaIds, assembleRenderInput, assemblePreparedRenderInput, validateComposition, compositionFormatDimensions, captionVisibilityWindowsForComposition, playableSpans, projectMediaPlaybackSpans, assertBehindSubjectCaptionCoverage, visiblePackedHostWindows, } from './compositionRender.js';
 export { bookendFrames, resolveBookendTimeline, CARD_BOOKEND_DEFAULT_MS, VIDEO_BOOKEND_DEFAULT_MS, } from './bookends.js';
 export type { BookendTimeline } from './bookends.js';
 export { DEFAULT_FPS, DEFAULT_WIDTH, DEFAULT_HEIGHT, DEFAULT_RENDER_SETTINGS, FORMAT_PRESETS, RESOLUTION_PRESETS, bppToCrf, ensureEven, qualityToCrf, resolutionToOutputSize, } from './exportSettings.js';

package/dist/_members/core/render/types.d.ts

@@ -4,7 +4,7 @@ import type { Reframe } from '../../composition/reframe/index.js';
 import type { SceneBuilderDescriptorV1, SceneExactRateV1, SceneObjectV2, ScenePreparedJson, SealedSceneShotPlanV1 } from '../../composition/scene/index.js';
 export type { SceneBuilderAllocationDescriptorV1, SceneBuilderDescriptorV1, SceneBuilderPartDescriptorV1, SceneBuilderSlotDescriptorV1, SceneExactRateV1, } from '../../composition/scene/index.js';
 import type { TrajectoryData } from '../../composition/reframe/trajectory.js';
-import type { CaptionWord as WireCaptionWord, CaptionStyle as WireCaptionStyle } from '../../composition/validators/index.js';
+import type { CaptionWord as WireCaptionWord, CaptionStyle as WireCaptionStyle, CaptionLayout as WireCaptionLayout } from '../../composition/validators/index.js';
 export type OverlayTemplate = 'custom' | 'gif' | 'image' | 'lottie' | (string & {});
 /**
  * Stable visual ordering projected from Composition.tracks.
@@ -69,6 +69,7 @@ export interface CompositionClip extends ProjectedVisualIdentity {
         h: number;
     };
     fit?: 'cover' | 'contain';
+    captionVisibility?: 'visible' | 'hidden';
     mediaType?: 'video' | 'audio' | 'image';
     kenBurns?: 'in' | 'out' | 'pan-l' | 'pan-r' | 'none';
     reframe?: Reframe;
@@ -156,6 +157,7 @@ export interface CompositionOverlay extends ProjectedVisualIdentity {
     animate?: CompositionClip['animate'];
 }
 export type CaptionWord = WireCaptionWord;
+export type CaptionLayout = WireCaptionLayout;
 export type CaptionStyle = WireCaptionStyle & Required<Pick<WireCaptionStyle, 'fontFamily' | 'fontSize' | 'fontWeight' | 'color' | 'highlightColor' | 'backgroundColor' | 'position' | 'textTransform'>>;
 export interface CompositionEffect extends ProjectedVisualIdentity {
     id: string;
@@ -191,6 +193,7 @@ export interface RenderInput {
     audioTracks?: CompositionAudioTrack[];
     effects?: CompositionEffect[];
     captionSegments?: CaptionWord[][];
+    captionLayouts?: CaptionLayout[];
     captionsBehind?: boolean;
     captionStyle?: Partial<CaptionStyle>;
     width: number;

package/dist/_members/plane/contract.d.ts

@@ -76,12 +76,12 @@ export declare const PreviewFrameRequest: z.ZodObject<{
 }, z.core.$strict>;
 /** Synchronous desktop variant: the mounted persisted document is the only target. */
 export declare const DesktopPreviewFrameRequest: z.ZodObject<{
+    scale: z.ZodOptional<z.ZodNumber>;
     timestamps: z.ZodArray<z.ZodNumber>;
     imageFormat: z.ZodOptional<z.ZodEnum<{
         png: "png";
         jpeg: "jpeg";
     }>>;
-    scale: z.ZodOptional<z.ZodNumber>;
     jpegQuality: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 /**

package/dist/_members/primitives/captions/Captions.d.ts

@@ -1,9 +1,26 @@
 import type { CaptionWord, CaptionStyle } from '../../core/render/index.js';
-export declare function Captions({ segments, style: userStyle, region, }: {
+import type { CaptionLayout } from '../../composition/validators/index.js';
+export declare function Captions({ segments, style: userStyle, region, holdUntilMs, scale, rotation, syncWordVisibility, singlePageRequired, layoutLabel, }: {
     segments: CaptionWord[][];
     style?: Partial<CaptionStyle>;
     region?: {
         y: number;
         h: number;
     };
+    holdUntilMs?: number;
+    scale?: number;
+    rotation?: number;
+    syncWordVisibility?: boolean;
+    singlePageRequired?: boolean;
+    layoutLabel?: string;
 }): import("react").JSX.Element | null;
+/** Draw default transcript words and independently placed native word ranges on the same frame. */
+export declare function CaptionLayoutLayer({ segments, layouts, style, region, }: {
+    segments: CaptionWord[][];
+    layouts?: CaptionLayout[];
+    style?: Partial<CaptionStyle>;
+    region?: {
+        y: number;
+        h: number;
+    };
+}): import("react").JSX.Element;

package/dist/_members/primitives/captions/index.d.ts

@@ -1,2 +1,2 @@
-export { Captions } from './Captions.js';
+export { Captions, CaptionLayoutLayer } from './Captions.js';
 export type { CaptionWord, CaptionStyle, EmphasisWord } from '../../core/render/index.js';

package/dist/animate.js

@@ -102,7 +102,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-2PU2TSUG.js";
+} from "./chunk-D5E5XFHK.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -185,7 +185,7 @@ import {
   selectSceneBakeScale
 } from "./chunk-CL5Y6V6K.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-AVTEPAWI.js";
+import "./chunk-7RGDRDAR.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ALLOWED_BAKE_SCALES,

package/dist/authoring/build-tools.js

@@ -4,19 +4,19 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-IHWC75AN.js";
-import "../chunk-KY3QBG7O.js";
+} from "../chunk-5E4YP44R.js";
+import "../chunk-4DM63RTI.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-NLXQ7WTH.js";
-import "../chunk-LO3DH776.js";
-import "../chunk-LZEX2GAY.js";
+import "../chunk-TPKPU4PE.js";
+import "../chunk-CJMUTCJW.js";
+import "../chunk-UFNIB3JL.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
-import "../chunk-AVTEPAWI.js";
+import "../chunk-7RGDRDAR.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ZERO_USAGE,