@cueframe/kernel 0.2.48 → 0.2.50

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,16 +48,16 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-FGJ7GKWZ.js";
+import "./chunk-6WQHVYJD.js";
 import {
   cssLayoutVars
-} from "./chunk-W5W3FDDI.js";
+} 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";

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-FGJ7GKWZ.js → chunk-6WQHVYJD.js}

@@ -2,7 +2,7 @@ import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
-} from "./chunk-W5W3FDDI.js";
+} from "./chunk-Z6NY6MCL.js";
 import {
   CueframeError,
   encodeError

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-VEQTURKN.js → chunk-NLXQ7WTH.js}

@@ -1,6 +1,6 @@
 import {
   Composition
-} from "./chunk-ID5QY7V6.js";
+} from "./chunk-LZEX2GAY.js";
 import {
   expandToLinkGroup
 } from "./chunk-KYRDKK2D.js";

package/dist/{chunk-SLUTOUWI.js → chunk-OVV35ZS2.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-VEQTURKN.js";
+} from "./chunk-NLXQ7WTH.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;

package/dist/{chunk-GI2NTS6B.js → chunk-WIPIYUY2.js}

@@ -9,7 +9,7 @@ import {
   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-TBZU7JYA.js → chunk-XVJU63TF.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-XSBVOXSB.js";
 import {
   CURATED_TOOLS
-} from "./chunk-CFIQY4OE.js";
+} from "./chunk-4WBSXHQA.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -31,7 +31,7 @@ import {
 } from "./chunk-AOIY7NGF.js";
 import {
   CompositionOp
-} from "./chunk-GI2NTS6B.js";
+} from "./chunk-WIPIYUY2.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;

package/dist/{chunk-W5W3FDDI.js → chunk-Z6NY6MCL.js}

@@ -84,11 +84,12 @@ function resolveBrandKit(kit, compositionWidth) {
   };
   const captionBaseFamily = effectiveCaptionFamily(kit).family;
   const cp = kit.captionProfile;
+  const captionInk = (color) => cp?.plate === "none" ? color : clampToFloor(color, safe.captionScrim, FLOORS.body);
   const caption = {
-    fg: cp?.emphasisColor ? clampToFloor(cp.emphasisColor, safe.captionScrim, FLOORS.body) : safe.captionFg,
+    fg: cp?.emphasisColor ? captionInk(cp.emphasisColor) : safe.captionFg,
     scrim: safe.captionScrim,
-    ...cp?.color ? { color: clampToFloor(cp.color, safe.captionScrim, FLOORS.body) } : {},
-    ...cp?.highlightColor ? { highlightColor: clampToFloor(cp.highlightColor, safe.captionScrim, FLOORS.body) } : {},
+    ...cp?.color ? { color: captionInk(cp.color) } : {},
+    ...cp?.highlightColor ? { highlightColor: captionInk(cp.highlightColor) } : {},
     ...cp?.plate ? { plate: cp.plate } : {},
     ...cp?.entrance ? { entrance: cp.entrance } : {},
     ...cp?.entranceMs != null ? { entranceMs: cp.entranceMs } : {},

package/dist/composition/graphics-plan.js

@@ -1,7 +1,7 @@
 import {
   placeInLegalArea,
   resolveBrandRefsDeep
-} from "../chunk-W5W3FDDI.js";
+} from "../chunk-Z6NY6MCL.js";
 import "../chunk-ILO4NEZ3.js";
 import "../chunk-VG2ND6PX.js";
 import {
@@ -26,7 +26,7 @@ import {
   PlanRect,
   StyleRole,
   ZPlane
-} from "../chunk-ID5QY7V6.js";
+} from "../chunk-LZEX2GAY.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-WREYUH2E.js";

package/dist/composition/ops.js

@@ -20,9 +20,9 @@ import {
   selectMediaClipAt,
   selectSceneMarkers,
   selectTracksByKind
-} from "../chunk-VEQTURKN.js";
-import "../chunk-AG7HKF2U.js";
-import "../chunk-ID5QY7V6.js";
+} from "../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/composition/projection.js

@@ -32,7 +32,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-FGJ7GKWZ.js";
+} from "../chunk-6WQHVYJD.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -69,7 +69,7 @@ import {
   resolveLayoutIntent,
   resolveOverlayRegion,
   unionFaceKeepOutSeries
-} from "../chunk-W5W3FDDI.js";
+} from "../chunk-Z6NY6MCL.js";
 import {
   contrastRatio
 } from "../chunk-ILO4NEZ3.js";

package/dist/composition/validators.js

@@ -48,11 +48,12 @@ import {
   WebhookDeliveryStatus,
   WebhookDestination,
   YoutubeDestination
-} from "../chunk-AG7HKF2U.js";
+} from "../chunk-LO3DH776.js";
 import {
   ANIMATABLE_PARAMS,
   ANIMATABLE_VALUE,
   AlphaLayerClipSource,
+  CaptionRegion,
   CaptionSegment,
   CaptionStyle,
   CaptionWord,
@@ -85,7 +86,7 @@ import {
   Transition,
   captionWords,
   captionsAreBehindSubject
-} from "../chunk-ID5QY7V6.js";
+} from "../chunk-LZEX2GAY.js";
 import {
   AUTHORED_GRAPHIC_KINDS
 } from "../chunk-WPZKOVYF.js";
@@ -105,6 +106,7 @@ export {
   AlphaLayerClipSource,
   AudioPaletteRef,
   BrandKit,
+  CaptionRegion,
   CaptionSegment,
   CaptionStyle,
   CaptionWord,

package/dist/composition-ops.js

@@ -20,16 +20,16 @@ import {
   replaceRegion,
   resolveClipKind,
   wrapWithOpRecorder
-} from "./chunk-GI2NTS6B.js";
+} from "./chunk-WIPIYUY2.js";
 import "./chunk-INYP56TC.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-JPMVNMF3.js";
 import "./chunk-IMIUHG2E.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-T56BK7NS.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/composition.js

@@ -46,7 +46,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "./chunk-FGJ7GKWZ.js";
+} from "./chunk-6WQHVYJD.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -83,7 +83,7 @@ import {
   resolveLayoutIntent,
   resolveOverlayRegion,
   unionFaceKeepOutSeries
-} from "./chunk-W5W3FDDI.js";
+} from "./chunk-Z6NY6MCL.js";
 import {
   contrastRatio
 } from "./chunk-ILO4NEZ3.js";
@@ -149,11 +149,12 @@ import {
   WebhookDeliveryStatus,
   WebhookDestination,
   YoutubeDestination
-} from "./chunk-AG7HKF2U.js";
+} from "./chunk-LO3DH776.js";
 import {
   ANIMATABLE_PARAMS,
   ANIMATABLE_VALUE,
   AlphaLayerClipSource,
+  CaptionRegion,
   CaptionSegment,
   CaptionStyle,
   CaptionWord,
@@ -186,7 +187,7 @@ import {
   Transition,
   captionWords,
   captionsAreBehindSubject
-} from "./chunk-ID5QY7V6.js";
+} from "./chunk-LZEX2GAY.js";
 import {
   AUTHORED_GRAPHIC_KINDS
 } from "./chunk-WPZKOVYF.js";
@@ -306,6 +307,7 @@ export {
   COVIEW_MAX_SILHOUETTE_W,
   COVIEW_MIN_BAND_COVERAGE,
   CURRENT_MATTE_BAKE_VERSION,
+  CaptionRegion,
   CaptionSegment,
   CaptionStyle,
   CaptionWord,

package/dist/{context-YNR73FNI.js → context-AIUJG7R4.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/mcp/adapter.js

@@ -5,7 +5,7 @@ import {
 } from "../chunk-XSBVOXSB.js";
 import {
   CURATED_TOOLS
-} from "../chunk-CFIQY4OE.js";
+} from "../chunk-4WBSXHQA.js";
 import {
   apiErrorFrom,
   bodySchemaFor,

package/dist/mcp/curation.js

@@ -10,7 +10,7 @@ import {
   formatResourceCandidates,
   formatTranscriptPage,
   formatWarnings
-} from "../chunk-CFIQY4OE.js";
+} from "../chunk-4WBSXHQA.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CRUD_COVERAGE,

package/dist/mcp/server.js

@@ -8,21 +8,21 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-TBZU7JYA.js";
+} from "../chunk-XVJU63TF.js";
 import "../chunk-FYS2XUKJ.js";
 import "../chunk-XSBVOXSB.js";
-import "../chunk-CFIQY4OE.js";
+import "../chunk-4WBSXHQA.js";
 import "../chunk-AOIY7NGF.js";
-import "../chunk-GI2NTS6B.js";
+import "../chunk-WIPIYUY2.js";
 import "../chunk-INYP56TC.js";
 import "../chunk-QH3YI3ND.js";
 import "../chunk-JPMVNMF3.js";
 import "../chunk-IMIUHG2E.js";
 import "../chunk-VZ7TYX6Z.js";
 import "../chunk-T56BK7NS.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/mcp.js

@@ -8,21 +8,21 @@ import {
   buildServer,
   registerCuratedTools,
   registerRawTools
-} from "./chunk-TBZU7JYA.js";
+} from "./chunk-XVJU63TF.js";
 import "./chunk-FYS2XUKJ.js";
 import "./chunk-XSBVOXSB.js";
-import "./chunk-CFIQY4OE.js";
+import "./chunk-4WBSXHQA.js";
 import "./chunk-AOIY7NGF.js";
-import "./chunk-GI2NTS6B.js";
+import "./chunk-WIPIYUY2.js";
 import "./chunk-INYP56TC.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-JPMVNMF3.js";
 import "./chunk-IMIUHG2E.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-T56BK7NS.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/primitives/captions.js

@@ -93,8 +93,21 @@ function assignTimeline(raw, lingerMs) {
 }
 
 // ../execution/primitives/src/captions/placement.ts
-function resolveCaptionPlacement(position, region) {
-  const vertical = region ? { bottom: `${Math.max(0, (1 - (region.y + region.h)) * 100)}%` } : position === "top" ? { top: "8%" } : position === "center" ? { top: "50%", transform: "translateY(-50%)" } : { bottom: "10%" };
+var percent = (fraction) => `${Number((fraction * 100).toFixed(4))}%`;
+function resolveCaptionPlacement(position, region, authoredRegion) {
+  if (authoredRegion) {
+    return {
+      position: "absolute",
+      left: percent(authoredRegion.x),
+      top: percent(authoredRegion.y),
+      width: percent(authoredRegion.w),
+      height: percent(authoredRegion.h),
+      display: "flex",
+      justifyContent: "flex-start",
+      alignItems: "flex-start"
+    };
+  }
+  const vertical = position === "top" ? { top: "8%" } : position === "center" ? { top: "50%", transform: "translateY(-50%)" } : position === "bottom" ? { bottom: "10%" } : region ? { bottom: `${Math.max(0, (1 - (region.y + region.h)) * 100)}%` } : { bottom: "10%" };
   return {
     position: "absolute",
     left: 0,
@@ -153,16 +166,16 @@ function addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis) {
     fontWeight: String(tokenWeight)
   });
 }
-function makeBoxFactory(maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
+function makeBoxFactory(maxWidth, maxLines, fontFamily, fontSize, fontWeight, emphasis) {
   return () => {
-    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines });
     return {
       add: (token) => !addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis).exceedsBox
     };
   };
 }
-function layoutTokensIntoLines(tokens, maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
-  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+function layoutTokensIntoLines(tokens, maxWidth, maxLines, fontFamily, fontSize, fontWeight, emphasis) {
+  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines });
   const lines = [[]];
   for (const token of tokens) {
     const result = addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis);
@@ -211,7 +224,15 @@ function Captions({
   const maxWidthPercent = style.maxWidthPercent ?? 80;
   const plateStyle = plateStyleFor(style.plate ?? "glass", style.backgroundColor);
   const fontSize = Math.round(height * (style.fontSize / 100));
-  const maxTextWidth = width * (maxWidthPercent / 100);
+  const authoredRegion = userStyle?.region;
+  const regionWidth = authoredRegion ? width * authoredRegion.w : width;
+  const maxTextWidth = authoredRegion ? Math.min(width * (maxWidthPercent / 100), regionWidth - fontSize * 1.6) : width * (maxWidthPercent / 100);
+  const availableHeight = authoredRegion ? height * authoredRegion.h - fontSize * 0.8 : Infinity;
+  const lineHeight = fontSize * Math.max(1, emphasisScale) * 1.2;
+  const maxLines = authoredRegion ? Math.min(3, Math.floor((availableHeight + fontSize * 0.25) / (lineHeight + fontSize * 0.25))) : 3;
+  if (authoredRegion && (maxTextWidth <= 0 || maxLines < 1)) {
+    throw new Error("Caption style.region is too small for one caption line at the authored font size");
+  }
   const { emphasisStartMs, annotateKind } = useMemo(() => {
     const emph = /* @__PURE__ */ new Set();
     const ann = /* @__PURE__ */ new Map();
@@ -228,10 +249,10 @@ function Captions({
   const pages = useMemo(
     () => paginateCaptionSegments(segments, {
       combineMs: COMBINE_TOKENS_MS,
-      makeBox: makeBoxFactory(maxTextWidth, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),
+      makeBox: makeBoxFactory(maxTextWidth, maxLines, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),
       lingerMs: CAPTION_LINGER_MS
     }),
-    [segments, maxTextWidth, fontSize, style.fontFamily, style.fontWeight, emphasisLayout]
+    [segments, maxTextWidth, maxLines, fontSize, style.fontFamily, style.fontWeight, emphasisLayout]
   );
   if (pages.length === 0) return null;
   const currentTimeMs = frame / fps * 1e3;
@@ -259,12 +280,13 @@ function Captions({
   const lines = layoutTokensIntoLines(
     currentPage.tokens,
     maxTextWidth,
+    maxLines,
     style.fontFamily,
     fontSize,
     style.fontWeight,
     emphasisLayout
   );
-  const wrapperStyle = resolveCaptionPlacement(style.position, region);
+  const wrapperStyle = resolveCaptionPlacement(userStyle?.position, region, authoredRegion);
   return /* @__PURE__ */ React.createElement(AbsoluteFill, { style: { pointerEvents: "none" } }, /* @__PURE__ */ React.createElement("div", { style: wrapperStyle }, /* @__PURE__ */ React.createElement(
     "div",
     {
@@ -272,12 +294,12 @@ function Captions({
         opacity: groupOpacity,
         display: "flex",
         flexDirection: "column",
-        alignItems: "center",
+        alignItems: authoredRegion ? "flex-start" : "center",
         gap: `${fontSize * 0.25}px`,
         padding: `${fontSize * 0.4}px ${fontSize * 0.8}px`,
         borderRadius: fontSize * 0.5,
         ...plateStyle,
-        maxWidth: `${maxWidthPercent}%`,
+        maxWidth: authoredRegion ? "100%" : `${maxWidthPercent}%`,
         boxSizing: "border-box"
       }
     },
@@ -317,7 +339,7 @@ function Captions({
           if (emphasisPlate && e && last && last.emph) last.tokens.push(t);
           else segs.push({ tokens: [t], emph: e });
         }
-        return /* @__PURE__ */ React.createElement("div", { key: lineIdx, style: { display: "flex", justifyContent: "center", alignItems: "baseline", gap: `${fontSize * 0.35}px` } }, segs.map((seg, si) => {
+        return /* @__PURE__ */ React.createElement("div", { key: lineIdx, style: { display: "flex", justifyContent: authoredRegion ? "flex-start" : "center", alignItems: "baseline", gap: `${fontSize * 0.35}px` } }, segs.map((seg, si) => {
           const first = seg.tokens[0];
           const { opacity, scale, y } = entranceOf(first, seg.emph);
           const entranceTransform = `translateY(${y}px) scale(${scale})`;

package/dist/render-harness.js

@@ -1,3 +1,9 @@
+import {
+  assertCardHtmlAssetFree
+} from "./chunk-DV7ZFVL4.js";
+import {
+  assertCardFontsAdmitted
+} from "./chunk-ACURZCPN.js";
 import {
   assertNoRemoteRefs,
   assetSlots,
@@ -5,13 +11,7 @@ import {
   isRemoteUrl,
   renderInputAssets
 } from "./chunk-KSRFYFUZ.js";
-import {
-  assertCardHtmlAssetFree
-} from "./chunk-DV7ZFVL4.js";
 import "./chunk-OSMXQV5V.js";
-import {
-  assertCardFontsAdmitted
-} from "./chunk-ACURZCPN.js";
 import "./chunk-MYBK6DKF.js";
 import "./chunk-BVA3537Z.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.48",
+  "version": "0.2.50",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -16,26 +16,26 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
-    "@cueframe/authoring": "0.1.0",
     "@cueframe/account-model": "0.1.0",
+    "@cueframe/animate": "0.1.0",
+    "@cueframe/authoring": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/compose": "0.1.0",
+    "@cueframe/brand-derivation": "0.1.0",
+    "@cueframe/component-runtime": "0.1.0",
+    "@cueframe/core": "0.1.0",
     "@cueframe/composition": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
+    "@cueframe/errors": "0.1.0",
     "@cueframe/director": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/animate": "0.1.0",
-    "@cueframe/brand-derivation": "0.1.0",
+    "@cueframe/nle-export": "0.1.0",
+    "@cueframe/media-model": "0.1.0",
+    "@cueframe/mcp": "0.1.0",
     "@cueframe/foundation": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
-    "@cueframe/errors": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/media-model": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
-    "@cueframe/nle-export": "0.1.0",
-    "@cueframe/core": "0.1.0",
+    "@cueframe/plane": "0.1.0",
     "@cueframe/render-harness": "0.1.0",
-    "@cueframe/plane": "0.1.0"
+    "@cueframe/primitives": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",