@cueframe/kernel 0.2.49 → 0.2.51

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

@@ -323,6 +323,13 @@ export declare const Region: z.ZodObject<{
     h: z.ZodNumber;
 }, z.core.$strip>;
 export type Region = z.infer<typeof Region>;
+/** A caption layout box must stay wholly within the output frame. */
+export declare const CaptionRegion: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strip>;
 export declare const ClipFit: z.ZodEnum<{
     contain: "contain";
     cover: "cover";
@@ -910,6 +917,12 @@ export declare const CaptionStyle: z.ZodObject<{
         center: "center";
         bottom: "bottom";
     }>>;
+    region: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
     textTransform: z.ZodOptional<z.ZodEnum<{
         none: "none";
         uppercase: "uppercase";
@@ -998,6 +1011,12 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<[z.ZodObject<{
             center: "center";
             bottom: "bottom";
         }>>;
+        region: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>>;
         textTransform: z.ZodOptional<z.ZodEnum<{
             none: "none";
             uppercase: "uppercase";
@@ -1073,6 +1092,12 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<[z.ZodObject<{
             center: "center";
             bottom: "bottom";
         }>>;
+        region: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>>;
         textTransform: z.ZodOptional<z.ZodEnum<{
             none: "none";
             uppercase: "uppercase";
@@ -1341,6 +1366,12 @@ export declare const Composition: z.ZodObject<{
                 center: "center";
                 bottom: "bottom";
             }>>;
+            region: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
             textTransform: z.ZodOptional<z.ZodEnum<{
                 none: "none";
                 uppercase: "uppercase";
@@ -1416,6 +1447,12 @@ export declare const Composition: z.ZodObject<{
                 center: "center";
                 bottom: "bottom";
             }>>;
+            region: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
             textTransform: z.ZodOptional<z.ZodEnum<{
                 none: "none";
                 uppercase: "uppercase";
@@ -1725,6 +1762,12 @@ export declare const CompositionVersion: z.ZodObject<{
                     center: "center";
                     bottom: "bottom";
                 }>>;
+                region: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>>;
                 textTransform: z.ZodOptional<z.ZodEnum<{
                     none: "none";
                     uppercase: "uppercase";
@@ -1800,6 +1843,12 @@ export declare const CompositionVersion: z.ZodObject<{
                     center: "center";
                     bottom: "bottom";
                 }>>;
+                region: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>>;
                 textTransform: z.ZodOptional<z.ZodEnum<{
                     none: "none";
                     uppercase: "uppercase";

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

@@ -269,6 +269,12 @@ export declare const RenderSnapshot: z.ZodObject<{
                     center: "center";
                     bottom: "bottom";
                 }>>;
+                region: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>>;
                 textTransform: z.ZodOptional<z.ZodEnum<{
                     none: "none";
                     uppercase: "uppercase";
@@ -344,6 +350,12 @@ export declare const RenderSnapshot: z.ZodObject<{
                     center: "center";
                     bottom: "bottom";
                 }>>;
+                region: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>>;
                 textTransform: z.ZodOptional<z.ZodEnum<{
                     none: "none";
                     uppercase: "uppercase";
@@ -1101,6 +1113,12 @@ export declare const RenderJob: z.ZodObject<{
                         center: "center";
                         bottom: "bottom";
                     }>>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>>;
                     textTransform: z.ZodOptional<z.ZodEnum<{
                         none: "none";
                         uppercase: "uppercase";
@@ -1176,6 +1194,12 @@ export declare const RenderJob: z.ZodObject<{
                         center: "center";
                         bottom: "bottom";
                     }>>;
+                    region: z.ZodOptional<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>>;
                     textTransform: z.ZodOptional<z.ZodEnum<{
                         none: "none";
                         uppercase: "uppercase";

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

@@ -661,6 +661,12 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             center: "center";
             bottom: "bottom";
         }>>>;
+        region: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>>>;
         textTransform: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
             none: "none";
             uppercase: "uppercase";
@@ -738,6 +744,12 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             center: "center";
             bottom: "bottom";
         }>>>;
+        region: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>>>;
         textTransform: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
             none: "none";
             uppercase: "uppercase";

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

@@ -2,4 +2,9 @@ import type { CSSProperties } from 'react';
 export declare function resolveCaptionPlacement(position: 'top' | 'center' | 'bottom' | undefined, region: {
     y: number;
     h: number;
-} | undefined): CSSProperties;
+} | undefined, authoredRegion?: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}): CSSProperties;

package/dist/authoring/build-tools.js

@@ -4,13 +4,13 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-4FKNPTLX.js";
-import "../chunk-BBNF4QLD.js";
+} from "../chunk-IHWC75AN.js";
+import "../chunk-KY3QBG7O.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-VEQTURKN.js";
-import "../chunk-AG7HKF2U.js";
-import "../chunk-ID5QY7V6.js";
+import "../chunk-NLXQ7WTH.js";
+import "../chunk-LO3DH776.js";
+import "../chunk-LZEX2GAY.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring/context.js

@@ -1,9 +1,9 @@
 import {
   buildDirectorContext
-} from "../chunk-SLUTOUWI.js";
-import "../chunk-VEQTURKN.js";
-import "../chunk-AG7HKF2U.js";
-import "../chunk-ID5QY7V6.js";
+} from "../chunk-OVV35ZS2.js";
+import "../chunk-NLXQ7WTH.js";
+import "../chunk-LO3DH776.js";
+import "../chunk-LZEX2GAY.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring/tools.js

@@ -6,12 +6,12 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-BBNF4QLD.js";
+} from "../chunk-KY3QBG7O.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-VEQTURKN.js";
-import "../chunk-AG7HKF2U.js";
-import "../chunk-ID5QY7V6.js";
+import "../chunk-NLXQ7WTH.js";
+import "../chunk-LO3DH776.js";
+import "../chunk-LZEX2GAY.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring.js

@@ -11,7 +11,7 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-4FKNPTLX.js";
+} from "./chunk-IHWC75AN.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-BBNF4QLD.js";
+} from "./chunk-KY3QBG7O.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-SLUTOUWI.js";
+} from "./chunk-OVV35ZS2.js";
 import {
   buildFastModel,
   buildModel,
@@ -48,22 +48,22 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-6WQHVYJD.js";
-import {
-  cssLayoutVars
-} from "./chunk-Z6NY6MCL.js";
-import "./chunk-ILO4NEZ3.js";
 import "./chunk-7AZLFN26.js";
-import "./chunk-VG2ND6PX.js";
-import "./chunk-VEQTURKN.js";
-import "./chunk-AG7HKF2U.js";
-import "./chunk-ID5QY7V6.js";
+import "./chunk-NLXQ7WTH.js";
+import "./chunk-LO3DH776.js";
+import "./chunk-LZEX2GAY.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
+import "./chunk-6WQHVYJD.js";
+import {
+  cssLayoutVars
+} from "./chunk-Z6NY6MCL.js";
 import "./chunk-WREYUH2E.js";
+import "./chunk-ILO4NEZ3.js";
 import "./chunk-E63UEO5C.js";
 import "./chunk-7PA7FGLD.js";
+import "./chunk-VG2ND6PX.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip

package/dist/{chunk-AOIY7NGF.js → chunk-2LUAUF46.js}

@@ -2584,6 +2584,14 @@ var compositionCaptionsOneSegmentsItemWordsItemEndMsMin = 0;
 var compositionCaptionsOneStyleFontSizeMax = 15;
 var compositionCaptionsOneStyleFontWeightMin = 100;
 var compositionCaptionsOneStyleFontWeightMax = 900;
+var compositionCaptionsOneStyleRegionXMin = 0;
+var compositionCaptionsOneStyleRegionXMax = 1;
+var compositionCaptionsOneStyleRegionYMin = 0;
+var compositionCaptionsOneStyleRegionYMax = 1;
+var compositionCaptionsOneStyleRegionWExclusiveMin = 0;
+var compositionCaptionsOneStyleRegionWMax = 1;
+var compositionCaptionsOneStyleRegionHExclusiveMin = 0;
+var compositionCaptionsOneStyleRegionHMax = 1;
 var compositionCaptionsOneStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsOneStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsOneStyleEmphasisFontWeightMax = 900;
@@ -2598,6 +2606,14 @@ var compositionCaptionsTwoSegmentsItemWordsItemEndMsMin = 0;
 var compositionCaptionsTwoStyleFontSizeMax = 15;
 var compositionCaptionsTwoStyleFontWeightMin = 100;
 var compositionCaptionsTwoStyleFontWeightMax = 900;
+var compositionCaptionsTwoStyleRegionXMin = 0;
+var compositionCaptionsTwoStyleRegionXMax = 1;
+var compositionCaptionsTwoStyleRegionYMin = 0;
+var compositionCaptionsTwoStyleRegionYMax = 1;
+var compositionCaptionsTwoStyleRegionWExclusiveMin = 0;
+var compositionCaptionsTwoStyleRegionWMax = 1;
+var compositionCaptionsTwoStyleRegionHExclusiveMin = 0;
+var compositionCaptionsTwoStyleRegionHMax = 1;
 var compositionCaptionsTwoStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsTwoStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsTwoStyleEmphasisFontWeightMax = 900;
@@ -2797,6 +2813,12 @@ var Composition = zod58.strictObject({
       "backgroundColor": zod58.string().optional(),
       "plate": zod58.enum(["glass", "solid", "none"]).optional(),
       "position": zod58.enum(["top", "center", "bottom"]).optional(),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsOneStyleRegionXMin).max(compositionCaptionsOneStyleRegionXMax),
+        "y": zod58.number().min(compositionCaptionsOneStyleRegionYMin).max(compositionCaptionsOneStyleRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsOneStyleRegionWExclusiveMin).max(compositionCaptionsOneStyleRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsOneStyleRegionHExclusiveMin).max(compositionCaptionsOneStyleRegionHMax)
+      }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
@@ -2842,6 +2864,12 @@ var Composition = zod58.strictObject({
       "backgroundColor": zod58.string().optional(),
       "plate": zod58.enum(["glass", "solid", "none"]).optional(),
       "position": zod58.enum(["top", "center", "bottom"]).optional(),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsTwoStyleRegionXMin).max(compositionCaptionsTwoStyleRegionXMax),
+        "y": zod58.number().min(compositionCaptionsTwoStyleRegionYMin).max(compositionCaptionsTwoStyleRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsTwoStyleRegionWExclusiveMin).max(compositionCaptionsTwoStyleRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsTwoStyleRegionHExclusiveMin).max(compositionCaptionsTwoStyleRegionHMax)
+      }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
@@ -6072,6 +6100,14 @@ var compositionOpOneoneSegmentsOneItemBiasYMax = 0.3;
 var compositionOpOnethreeStyleFontSizeMax = 15;
 var compositionOpOnethreeStyleFontWeightMin = 100;
 var compositionOpOnethreeStyleFontWeightMax = 900;
+var compositionOpOnethreeStyleRegionXMin = 0;
+var compositionOpOnethreeStyleRegionXMax = 1;
+var compositionOpOnethreeStyleRegionYMin = 0;
+var compositionOpOnethreeStyleRegionYMax = 1;
+var compositionOpOnethreeStyleRegionWExclusiveMin = 0;
+var compositionOpOnethreeStyleRegionWMax = 1;
+var compositionOpOnethreeStyleRegionHExclusiveMin = 0;
+var compositionOpOnethreeStyleRegionHMax = 1;
 var compositionOpOnethreeStyleEmphasisScaleExclusiveMin = 0;
 var compositionOpOnethreeStyleEmphasisFontWeightMin = 100;
 var compositionOpOnethreeStyleEmphasisFontWeightMax = 900;
@@ -6086,6 +6122,14 @@ var compositionOpOnefiveSegmentsItemWordsItemEndMsMin = 0;
 var compositionOpOnefiveStyleFontSizeMax = 15;
 var compositionOpOnefiveStyleFontWeightMin = 100;
 var compositionOpOnefiveStyleFontWeightMax = 900;
+var compositionOpOnefiveStyleRegionXMin = 0;
+var compositionOpOnefiveStyleRegionXMax = 1;
+var compositionOpOnefiveStyleRegionYMin = 0;
+var compositionOpOnefiveStyleRegionYMax = 1;
+var compositionOpOnefiveStyleRegionWExclusiveMin = 0;
+var compositionOpOnefiveStyleRegionWMax = 1;
+var compositionOpOnefiveStyleRegionHExclusiveMin = 0;
+var compositionOpOnefiveStyleRegionHMax = 1;
 var compositionOpOnefiveStyleEmphasisScaleExclusiveMin = 0;
 var compositionOpOnefiveStyleEmphasisFontWeightMin = 100;
 var compositionOpOnefiveStyleEmphasisFontWeightMax = 900;
@@ -6628,6 +6672,12 @@ var CompositionOp = zod67.union([zod67.strictObject({
     "backgroundColor": zod67.string().optional(),
     "plate": zod67.enum(["glass", "solid", "none"]).optional(),
     "position": zod67.enum(["top", "center", "bottom"]).optional(),
+    "region": zod67.strictObject({
+      "x": zod67.number().min(compositionOpOnethreeStyleRegionXMin).max(compositionOpOnethreeStyleRegionXMax),
+      "y": zod67.number().min(compositionOpOnethreeStyleRegionYMin).max(compositionOpOnethreeStyleRegionYMax),
+      "w": zod67.number().gt(compositionOpOnethreeStyleRegionWExclusiveMin).max(compositionOpOnethreeStyleRegionWMax),
+      "h": zod67.number().gt(compositionOpOnethreeStyleRegionHExclusiveMin).max(compositionOpOnethreeStyleRegionHMax)
+    }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),
@@ -6675,6 +6725,12 @@ var CompositionOp = zod67.union([zod67.strictObject({
     "backgroundColor": zod67.string().optional(),
     "plate": zod67.enum(["glass", "solid", "none"]).optional(),
     "position": zod67.enum(["top", "center", "bottom"]).optional(),
+    "region": zod67.strictObject({
+      "x": zod67.number().min(compositionOpOnefiveStyleRegionXMin).max(compositionOpOnefiveStyleRegionXMax),
+      "y": zod67.number().min(compositionOpOnefiveStyleRegionYMin).max(compositionOpOnefiveStyleRegionYMax),
+      "w": zod67.number().gt(compositionOpOnefiveStyleRegionWExclusiveMin).max(compositionOpOnefiveStyleRegionWMax),
+      "h": zod67.number().gt(compositionOpOnefiveStyleRegionHExclusiveMin).max(compositionOpOnefiveStyleRegionHMax)
+    }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),

package/dist/{chunk-4QMRY7KU.js → chunk-4CNJGY7P.js}

@@ -3,14 +3,6 @@ import {
   buildEasedZooms,
   buildPannedCenters
 } from "./chunk-QH3YI3ND.js";
-import {
-  flattenCompoundClips,
-  hasCompoundClips
-} from "./chunk-IMIUHG2E.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -29,6 +21,17 @@ import {
   segmentShots,
   stabilizeSelectionHysteresis
 } from "./chunk-JPMVNMF3.js";
+import {
+  flattenCompoundClips,
+  hasCompoundClips
+} from "./chunk-IMIUHG2E.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
+import {
+  resolveBrandRef
+} from "./chunk-Z6NY6MCL.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -1810,6 +1813,39 @@ function projectEffectTrack(track, trackIndex, trackCount, fps) {
 }
 
 // ../execution/core/src/render/compositionRender.ts
+var CAPTION_COLOR_FIELDS = [
+  "color",
+  "highlightColor",
+  "backgroundColor",
+  "emphasisColor",
+  "emphasisPlateColor",
+  "emphasisPlateTextColor",
+  "emphasisPlateAltColor",
+  "emphasisPlateAltTextColor",
+  "annotationColor"
+];
+function resolveCaptionColorRefs(style, brandKit) {
+  const resolvedStyle = { ...style };
+  for (const field of CAPTION_COLOR_FIELDS) {
+    const authored = resolvedStyle[field];
+    if (typeof authored !== "string") continue;
+    if (authored.startsWith("\\$brand:")) {
+      resolvedStyle[field] = authored.slice(1);
+      continue;
+    }
+    if (!authored.startsWith("$brand:")) continue;
+    const resolved = authored.startsWith("$brand:colors.") && brandKit ? resolveBrandRef(authored, brandKit) : null;
+    if (typeof resolved !== "string" || !resolved) {
+      throw renderInputError(
+        "brand_kit_unresolved",
+        `Caption color ${field} references ${authored}, but the bound brand kit has no matching color. Use $brand:colors.<name> or a literal color.`,
+        { compositionPath: `captions.style.${field}`, brandRef: authored }
+      );
+    }
+    resolvedStyle[field] = resolved;
+  }
+  return resolvedStyle;
+}
 function compositionFormatDimensions(format) {
   const fps = format.fps ?? 30;
   const resolution = format.resolution ?? "fhd";
@@ -1992,6 +2028,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...cap?.entranceStaggerMs != null ? { entranceStaggerMs: cap.entranceStaggerMs } : {},
     ...cap?.exitMs != null ? { exitMs: cap.exitMs } : {}
   } : void 0;
+  const resolvedCaptionStyle = captionStyle ? resolveCaptionColorRefs(captionStyle, brandKit) : void 0;
   return {
     clips,
     overlays,
@@ -2004,7 +2041,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...effects.length > 0 ? { effects } : {},
     ...hasCaptions ? { captionSegments } : {},
     ...hasCaptions && composition.captions?.zPlane === "behind-subject" ? { captionsBehind: true } : {},
-    ...captionStyle ? { captionStyle } : {},
+    ...resolvedCaptionStyle ? { captionStyle: resolvedCaptionStyle } : {},
     ...brandKit ? { brandKit } : {}
   };
 }

package/dist/{chunk-CFIQY4OE.js → chunk-4WBSXHQA.js}

@@ -525,21 +525,25 @@ ${j.tsxSource}`,
     name: "prepare_media",
     operationId: "purchaseMediaFact",
     pathArgs: { mediaItemId: "id" },
-    description: 'Prepare the perception artifact an authored edit needs BEFORE sighted review. Pass body.kind="subjectTrack" for face/active-speaker reframing, or body.kind="matte" for a true zPlane:"behind-subject" graphic. Pass body.intent {startSec,endSec} using SOURCE time (the media trim, not timeline time); it is required for mattes and strongly recommended for subject tracks so the prepared fact exactly matches the clip and quote. This is the supported product path \u2014 never accept a preview that silently flattens depth or ignores speaker tracking. Returns a fact receipt; poll get_media_facts with the same kind/window until exact.state is ready (failed is terminal). Existing pending/ready facts are reused without another charge.',
-    okFormat: (j, a) => `Media preparation ${j.alreadyExisted ? "reused" : "started"}.
+    description: 'Prepare the perception artifact an authored edit needs BEFORE sighted review. Pass body.kind="subjectTrack" for face/active-speaker reframing, or body.kind="matte" for a true zPlane:"behind-subject" graphic. Pass body.intent {startSec,endSec} using SOURCE time (the media trim, not timeline time); it is required for mattes and strongly recommended for subject tracks so the prepared fact exactly matches the clip and quote. This is the supported product path \u2014 never accept a preview that silently flattens depth or ignores speaker tracking. Returns a fact receipt; with intent, poll get_media_facts using the same kind/window until exact.state is ready; without intent, omit all three filters and find the whole-source subjectTrack in facts until status is ready (failed is terminal). Existing pending/ready facts are reused without another charge.',
+    okFormat: (j, a) => {
+      const intent = a.body?.intent;
+      const poll = intent ? `Poll get_media_facts(mediaItemId="${a.mediaItemId}", kind="${a.body.kind}", startSec=${intent.startSec}, endSec=${intent.endSec}) until exact.state is ready before preview_frame or score_composition.` : `Poll get_media_facts(mediaItemId="${a.mediaItemId}") without filters; find the subjectTrack fact in facts whose source window runs from 0 to the media duration (get_media_context.durationSec) and wait until its status is ready before preview_frame or score_composition.`;
+      return `Media preparation ${j.alreadyExisted ? "reused" : "started"}.
 
 factId: ${j.factId}
 status: ${j.status}
 quotedUsd: ${j.quotedUsd}
 
-Poll get_media_facts(mediaItemId="${a.mediaItemId}", kind="${a.body?.kind}", startSec="${a.body?.intent?.startSec}", endSec="${a.body?.intent?.endSec}") until exact.state is ready before preview_frame or score_composition.`,
+${poll}`;
+    },
     annotations: { idempotentHint: true }
   },
   {
     name: "get_media_facts",
     operationId: "listMediaFacts",
     pathArgs: { mediaItemId: "id" },
-    description: "Read prepared subject tracks and behind-subject mattes for one media item. For an exact readiness check, pass kind + startSec + endSec together using the same SOURCE window sent to prepare_media; exact.state is pending | ready | failed | available | unavailable. Use this after prepare_media and do not call preview_frame / score_composition until the required exact fact is ready.",
+    description: "Read prepared subject tracks and behind-subject mattes for one media item. For an exact readiness check, pass kind + startSec + endSec together using the same SOURCE window sent to prepare_media; exact.state is pending | ready | failed | available | unavailable. If subjectTrack was prepared without intent, omit all three filters and check the whole-source subjectTrack in facts instead. Wait for the required fact to be ready before preview_frame / score_composition.",
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
   {

package/dist/{chunk-XSBVOXSB.js → chunk-FSA3UBVR.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-AOIY7NGF.js";
+} from "./chunk-2LUAUF46.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-4FKNPTLX.js → chunk-IHWC75AN.js}

@@ -2,7 +2,7 @@ import {
   COMPOSE_PLANNER_TOOLS,
   COMPOSE_ROLE_TOOLS,
   dispatchComposeRoleTool
-} from "./chunk-BBNF4QLD.js";
+} from "./chunk-KY3QBG7O.js";
 
 // ../authoring/src/agent/buildTools.ts
 import { tool } from "ai";

package/dist/{chunk-BBNF4QLD.js → chunk-KY3QBG7O.js}

@@ -7,13 +7,13 @@ import {
 } from "./chunk-7AZLFN26.js";
 import {
   selectAllOverlays
-} from "./chunk-VEQTURKN.js";
+} from "./chunk-NLXQ7WTH.js";
 import {
   ComposePlan
-} from "./chunk-AG7HKF2U.js";
+} from "./chunk-LO3DH776.js";
 import {
   OverlayClipSource
-} from "./chunk-ID5QY7V6.js";
+} from "./chunk-LZEX2GAY.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -63,7 +63,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-YNR73FNI.js");
+      const { buildDirectorContext } = await import("./context-AIUJG7R4.js");
       return buildDirectorContext(capabilities);
     }
   },

package/dist/{chunk-AG7HKF2U.js → chunk-LO3DH776.js}

@@ -4,7 +4,7 @@ import {
   Format,
   GraphicRole,
   OpaqueId
-} from "./chunk-ID5QY7V6.js";
+} from "./chunk-LZEX2GAY.js";
 import {
   brandKitCaptionFaceIssues
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-ID5QY7V6.js → chunk-LZEX2GAY.js}

@@ -119,6 +119,10 @@ var Region = z2.object({
   w: z2.number().positive().max(1),
   h: z2.number().positive().max(1)
 });
+var CaptionRegion = Region.refine(
+  (r) => r.x + r.w <= 1 && r.y + r.h <= 1,
+  "captions style.region must fit within the normalized frame"
+);
 var ClipFit = z2.enum(["cover", "contain"]);
 var PerClipEffect = z2.object({
   primitiveId: z2.string().min(1),
@@ -253,6 +257,9 @@ var CaptionStyle = z2.object({
   backgroundColor: z2.string().optional(),
   plate: z2.enum(["glass", "solid", "none"]).optional(),
   position: z2.enum(["top", "center", "bottom"]).optional(),
+  region: CaptionRegion.optional().describe(
+    "Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."
+  ),
   textTransform: z2.enum(["none", "uppercase", "capitalize"]).optional(),
   emphasisColor: z2.string().optional(),
   emphasisGradient: z2.string().optional(),
@@ -493,6 +500,7 @@ export {
   POSITION_MIN,
   POSITION_MAX,
   Region,
+  CaptionRegion,
   ClipFit,
   PerClipEffect,
   KeyframeEasing,

package/dist/{chunk-DJRKEUK3.js → chunk-M665ZQYB.js}

@@ -3,13 +3,13 @@ import {
   projectMediaPlaybackSpans,
   sliceTranscriptWords,
   splitIntoSentences
-} from "./chunk-4QMRY7KU.js";
+} from "./chunk-4CNJGY7P.js";
 import {
   createHeadlessStore,
   findClipById,
   findMarkerById,
   findTrackContainingClipId
-} from "./chunk-VEQTURKN.js";
+} from "./chunk-NLXQ7WTH.js";
 import {
   CaptionSegment,
   CaptionStyle,
@@ -20,7 +20,7 @@ import {
   TimelineClip,
   Track,
   Transition
-} from "./chunk-ID5QY7V6.js";
+} from "./chunk-LZEX2GAY.js";
 import {
   ReframeSegment
 } from "./chunk-B7J5UUUV.js";

package/dist/{chunk-FYS2XUKJ.js → chunk-MOUWO53S.js}

@@ -1,7 +1,7 @@
 import {
   bodySchemaFor,
   opById
-} from "./chunk-AOIY7NGF.js";
+} from "./chunk-2LUAUF46.js";
 
 // ../mcp/src/generated/sceneContract.ts
 function deepFreeze(value) {