@cueframe/kernel 0.2.52 → 0.2.54

package/dist/authoring/build-tools.js

@@ -4,19 +4,19 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-QVBUYWW6.js";
-import "../chunk-KMDZDH5E.js";
+} from "../chunk-Q2FWFTDZ.js";
+import "../chunk-QCJUGKRC.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-5JCLZPMV.js";
-import "../chunk-MBSQKRDF.js";
-import "../chunk-CV3QQUMK.js";
+import "../chunk-T7WKIMTB.js";
+import "../chunk-QCGT3M7M.js";
+import "../chunk-VKZTGD5Z.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,

package/dist/authoring/context.js

@@ -1,14 +1,14 @@
 import {
   buildDirectorContext
-} from "../chunk-FSEB4LSU.js";
-import "../chunk-5JCLZPMV.js";
-import "../chunk-MBSQKRDF.js";
-import "../chunk-CV3QQUMK.js";
+} from "../chunk-FYMXVYWS.js";
+import "../chunk-T7WKIMTB.js";
+import "../chunk-QCGT3M7M.js";
+import "../chunk-VKZTGD5Z.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-AVTEPAWI.js";
+import "../chunk-7RGDRDAR.js";
 import "../chunk-2ESYSVXG.js";
 export {
   buildDirectorContext

package/dist/authoring/tools.js

@@ -6,18 +6,18 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-KMDZDH5E.js";
+} from "../chunk-QCJUGKRC.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-5JCLZPMV.js";
-import "../chunk-MBSQKRDF.js";
-import "../chunk-CV3QQUMK.js";
+import "../chunk-T7WKIMTB.js";
+import "../chunk-QCGT3M7M.js";
+import "../chunk-VKZTGD5Z.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 {
   COMPOSE_MOTION_TOOLS,

package/dist/authoring.js

@@ -11,7 +11,7 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-QVBUYWW6.js";
+} from "./chunk-Q2FWFTDZ.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-KMDZDH5E.js";
+} from "./chunk-QCJUGKRC.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-FSEB4LSU.js";
+} from "./chunk-FYMXVYWS.js";
 import {
   buildFastModel,
   buildModel,
@@ -49,16 +49,16 @@ import {
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
 import "./chunk-7AZLFN26.js";
-import "./chunk-5JCLZPMV.js";
-import "./chunk-MBSQKRDF.js";
-import "./chunk-CV3QQUMK.js";
+import "./chunk-T7WKIMTB.js";
+import "./chunk-QCGT3M7M.js";
+import "./chunk-VKZTGD5Z.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
-import "./chunk-6WQHVYJD.js";
+import "./chunk-G7ZSFSQG.js";
 import {
   cssLayoutVars
-} from "./chunk-Z6NY6MCL.js";
+} from "./chunk-RMLGMYEJ.js";
 import "./chunk-WREYUH2E.js";
 import "./chunk-ILO4NEZ3.js";
 import "./chunk-E63UEO5C.js";
@@ -69,7 +69,7 @@ import {
   isSceneShotClip
 } from "./chunk-CL5Y6V6K.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-AVTEPAWI.js";
+import "./chunk-7RGDRDAR.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts

package/dist/{chunk-MYBK6DKF.js → chunk-2BVKNYRB.js}

@@ -3,7 +3,7 @@ import {
   assertSceneShotParamsAdmitted,
   materializeComponentSource,
   renderComponentAlpha
-} from "./chunk-7XZW26U2.js";
+} from "./chunk-AONWKKXK.js";
 import {
   componentArtifactId,
   componentBundleId,

package/dist/{chunk-AVTEPAWI.js → chunk-7RGDRDAR.js}

@@ -75,7 +75,7 @@ var BUNDLED_FONT_FACES = Object.freeze({
   },
   "Instrument Serif": {
     slug: "instrument-serif",
-    faces: [{ weight: "400", file: "400" }],
+    faces: [{ weight: "400", file: "400" }, { weight: "400", file: "400-italic", style: "italic" }],
     captionDefaults: { base: 400, emphasis: 400 }
   },
   "National Park": {
@@ -102,19 +102,19 @@ function bundledFaceCoversWeight(face, weight) {
   return weight >= lo && weight <= hi;
 }
 function bundledFontFaceExists(family, weight, style) {
-  if (style !== BUNDLED_FONT_STYLE) return false;
   const bundled = bundledFontFamilyFaces(family);
   if (!bundled) return false;
-  return bundled.faces.some((face) => bundledFaceCoversWeight(face, weight));
+  return bundled.faces.some((face) => (face.style ?? BUNDLED_FONT_STYLE) === style && bundledFaceCoversWeight(face, weight));
 }
 function describeBundledFontWeights(family) {
   const bundled = bundledFontFamilyFaces(family);
   if (!bundled) return "";
-  return bundled.faces.map((face) => face.weight.split(/\s+/).join("-")).join(", ");
+  return [...new Set(bundled.faces.map((face) => face.weight.split(/\s+/).join("-")))].join(", ");
 }
 function unrenderableFaceField(family, weight, style, sealed) {
-  if (bundledFontFamilyFaces(family)) {
-    return style === BUNDLED_FONT_STYLE ? "fontWeight" : "fontStyle";
+  const bundled = bundledFontFamilyFaces(family);
+  if (bundled) {
+    return bundled.faces.some((face) => (face.style ?? BUNDLED_FONT_STYLE) === style) ? "fontWeight" : "fontStyle";
   }
   if (sealed.hasFamily(family)) {
     return sealed.hasWeight(family, weight) ? "fontStyle" : "fontWeight";
@@ -165,7 +165,7 @@ function admissibleFamilyForStack(stack) {
   return resolved.kind === "bundled" ? resolved.family : stack;
 }
 function weightRanges(faces) {
-  return faces.map((face) => {
+  return [...new Map(faces.map((face) => [face.weight, face])).values()].map((face) => {
     const parts = face.weight.split(/\s+/).map(Number);
     const min = parts[0];
     const max = parts.length > 1 ? parts[1] : min;
@@ -188,7 +188,7 @@ function vendoredFontCatalog() {
     return {
       family,
       weights: weightRanges(entry.faces),
-      styles: [BUNDLED_FONT_STYLE],
+      styles: [...new Set(entry.faces.map((face) => face.style ?? BUNDLED_FONT_STYLE))],
       captionDefaults: entry.captionDefaults,
       origin: aliased.has(family) ? "aliased" : "bundled"
     };
@@ -261,12 +261,12 @@ function faceIssue(use) {
     return {
       field: use.field,
       face: { family: use.stack, weight: use.weight, style: use.style },
-      message: `font_not_reproducible \u2014 ${because(use)}: "${use.stack}" names no font file the render bundle carries, and it ships no italic binary at all, so the browser would slant whatever upright face it matched and the render refuses it before capture. Emphasise with emphasisFontWeight, emphasisColor or emphasisScale, or name an uploaded brand font that is sealed in italic.`
+      message: `font_not_reproducible \u2014 ${because(use)}: "${use.stack}" names no font file the render bundle carries, so this stack ships no italic binary to select and the browser would slant whatever upright face it matched and the render refuses it before capture. Emphasise with emphasisFontWeight, emphasisColor or emphasisScale, or name an uploaded brand font that is sealed in italic.`
     };
   }
   if (use.resolved.kind !== "bundled") return null;
   const face = { family: use.resolved.family, weight: use.weight, style: use.style };
-  if (use.style === "italic") {
+  if (use.style === "italic" && !bundledFontFamilyFaces(use.resolved.family).faces.some((face2) => face2.style === "italic")) {
     return {
       field: use.field,
       face,
@@ -274,10 +274,11 @@ function faceIssue(use) {
     };
   }
   if (bundledFontFaceExists(use.resolved.family, use.weight, use.style)) return null;
+  const weightField = use.role === "emphasis" ? "emphasisFontWeight" : "fontWeight";
   return {
-    field: use.field,
+    field: weightField,
     face,
-    message: `font_not_reproducible \u2014 ${because(use)}: ${use.resolved.family} ships ${describeBundledFontWeights(use.resolved.family)}. The render refuses a weight outside that range before capture rather than let the browser substitute a nearby file, so set ${use.field} to a weight the family covers, or pick a family whose files do.`
+    message: `font_not_reproducible \u2014 ${weightField} ${use.weight} (${use.style}) has no file behind it: ${use.resolved.family} ships ${describeBundledFontWeights(use.resolved.family)}. The render refuses a weight outside that range before capture rather than let the browser substitute a nearby file, so set ${weightField} to a weight the family covers, or pick a family whose files do.`
   };
 }
 function captionFaceIssues(style) {
@@ -377,7 +378,10 @@ function captionWeightChoices(stack) {
   );
 }
 function captionStyleChoices(stack) {
-  return captionStackFamily(stack).kind === "unknown" ? ["normal", "italic"] : ["normal"];
+  const resolved = captionStackFamily(stack);
+  if (resolved.kind === "unknown") return ["normal", "italic"];
+  if (resolved.kind !== "bundled") return ["normal"];
+  return [...new Set(bundledFontFamilyFaces(resolved.family).faces.map((face) => face.style ?? BUNDLED_FONT_STYLE))];
 }
 
 // ../composition/src/fonts.ts

package/dist/{chunk-7XZW26U2.js → chunk-AONWKKXK.js}

@@ -31,7 +31,7 @@ import {
 } from "./chunk-CL5Y6V6K.js";
 import {
   BUNDLED_FONT_FACES
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../execution/component-runtime/src/sceneAdmission.ts
 import { ZodError } from "zod";

package/dist/{chunk-WZ22ZYXD.js → chunk-C3ARYFN6.js}

@@ -2,12 +2,12 @@ import {
   SCENE_SHOT_RESOURCE_DESCRIPTION,
   SCENE_SHOT_RESOURCE_URI,
   sceneShotContract
-} from "./chunk-3OG2674K.js";
+} from "./chunk-ZDE5S3DE.js";
 import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-JWW54N24.js";
+} from "./chunk-VYSBZUXZ.js";
 import {
   CURATED_TOOLS
 } from "./chunk-4WBSXHQA.js";
@@ -28,10 +28,10 @@ import {
   text,
   textWithData,
   withMedia
-} from "./chunk-2M65KQNG.js";
+} from "./chunk-V6GL37RZ.js";
 import {
   CompositionOp
-} from "./chunk-IHXMBXXL.js";
+} from "./chunk-SIGKJOSF.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;

package/dist/{chunk-4B4V3HYW.js → chunk-C6ONUJIO.js}

@@ -43,7 +43,7 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-2PU2TSUG.js";
+} from "./chunk-D5E5XFHK.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,

package/dist/{chunk-CZOVEX2D.js → chunk-CR3G2JQP.js}

@@ -24,7 +24,7 @@ import {
 } from "./chunk-W2245F6G.js";
 import {
   FlexLayout
-} from "./chunk-2PU2TSUG.js";
+} from "./chunk-D5E5XFHK.js";
 
 // ../execution/primitives/src/layouts/chat-to-preview-layout/index.tsx
 import { Easing, interpolate, useCurrentFrame, useVideoConfig } from "remotion";

package/dist/{chunk-2PU2TSUG.js → chunk-D5E5XFHK.js}

@@ -34,7 +34,7 @@ import {
 } from "./chunk-CL5Y6V6K.js";
 import {
   resolveCaptionFaces
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../execution/animate/src/easing/smooth.ts
 var sigmoid = (x) => 1 / (1 + Math.exp(-x));

package/dist/{chunk-D2EG7J7X.js → chunk-DFB7UFZD.js}

@@ -15,7 +15,7 @@ function Marker({ spec, progress }) {
         d: path,
         fill: "none",
         stroke: spec.color,
-        strokeWidth: 4,
+        strokeWidth: spec.strokeWidth ?? 4,
         strokeLinecap: "round",
         strokeLinejoin: "round",
         pathLength: 1,

package/dist/{chunk-FSEB4LSU.js → chunk-FYMXVYWS.js}

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

package/dist/{chunk-6WQHVYJD.js → chunk-G7ZSFSQG.js}

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

package/dist/{chunk-5ZQLMPDY.js → chunk-GAACUQAB.js}

@@ -26,7 +26,7 @@ import {
   perspectiveFor,
   resolveCamera,
   useStage
-} from "./chunk-2PU2TSUG.js";
+} from "./chunk-D5E5XFHK.js";
 
 // ../execution/primitives/src/effects/blur/index.tsx
 import React2 from "react";

package/dist/{chunk-3I43W7DP.js → chunk-GZMKTLO3.js}

@@ -31,7 +31,7 @@ import {
 } from "./chunk-VZ7TYX6Z.js";
 import {
   resolveBrandRef
-} from "./chunk-Z6NY6MCL.js";
+} from "./chunk-RMLGMYEJ.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -64,7 +64,7 @@ import {
   bundledFontFaceExists,
   mergedCaptionFaceIssues,
   unrenderableFaceField
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../execution/core/src/render/sceneCaptureIdentity.ts
 var INTENT_FIELDS = [
@@ -1226,22 +1226,33 @@ function bindBehindSubjectHosts(overlays, clips) {
     );
   }
 }
-function assertBehindSubjectCaptionCoverage(captionSegments, clips, fps, output, effects = []) {
-  for (const segment of captionSegments ?? []) {
-    for (const word of segment) {
-      const startFrame = Math.round(word.startMs / 1e3 * fps);
-      const endFrame = Math.max(startFrame + 1, Math.round(word.endMs / 1e3 * fps));
-      for (const window of visiblePackedHostWindows(clips, startFrame, endFrame, output, effects)) {
-        if (!window.captionVisible) continue;
-        if (window.hostClipId) continue;
-        const code = window.candidateClipIds.length > 1 ? "behind_subject_caption_host_ambiguous" : "behind_subject_caption_host_missing";
-        throw renderInputError(
-          code,
-          `Behind-subject caption word '${word.text}' is not fully covered by a unique visible packed host during frames [${window.startFrame}, ${window.endFrame}); an exact matte is required for the visible picture.`,
-          { candidateClipIds: window.candidateClipIds, startFrame: window.startFrame, endFrame: window.endFrame }
-        );
-      }
+function assertBehindSubjectCaptionCoverage(captionSegments, clips, fps, output, effects = [], captionLayouts = []) {
+  const requireCoverage = (label, startMs, endMs) => {
+    const startFrame = Math.round(startMs / 1e3 * fps);
+    const endFrame = Math.max(startFrame + 1, Math.round(endMs / 1e3 * fps));
+    for (const window of visiblePackedHostWindows(clips, startFrame, endFrame, output, effects)) {
+      if (!window.captionVisible || window.hostClipId) continue;
+      const code = window.candidateClipIds.length > 1 ? "behind_subject_caption_host_ambiguous" : "behind_subject_caption_host_missing";
+      throw renderInputError(
+        code,
+        `Behind-subject caption ${label} is not fully covered by a unique visible packed host during frames [${window.startFrame}, ${window.endFrame}); an exact matte is required for the visible picture.`,
+        { candidateClipIds: window.candidateClipIds, startFrame: window.startFrame, endFrame: window.endFrame }
+      );
     }
+  };
+  for (const segment of captionSegments ?? []) {
+    for (const word of segment) requireCoverage(`word '${word.text}'`, word.startMs, word.endMs);
+  }
+  for (const layout of captionLayouts ?? []) {
+    const segment = captionSegments?.[layout.segmentIndex];
+    const first = segment?.[layout.wordStartIndex];
+    const last = segment?.[layout.holdThroughWordIndex ?? layout.wordEndIndex - 1];
+    if (!first || !last) throw new Error("Behind-subject caption layout references missing saved transcript words");
+    requireCoverage(
+      `layout segment ${layout.segmentIndex} words ${layout.wordStartIndex}..${layout.wordEndIndex - 1}`,
+      first.startMs,
+      last.endMs
+    );
   }
 }
 var FULL_RECT = { left: 0, top: 0, right: 1, bottom: 1 };
@@ -1272,6 +1283,11 @@ function coversLowerPictures(upper, lower, output, effects) {
     return upperRect.left <= rect.left + epsilon && upperRect.top <= rect.top + epsilon && upperRect.right + epsilon >= rect.right && upperRect.bottom + epsilon >= rect.bottom;
   });
 }
+function explicitlyHidesCaptions(clip, effects) {
+  if (!clip || clip.captionVisibility !== "hidden" || clip.mediaType === "image") return false;
+  const region = clip.region;
+  return !!region && region.x === 0 && region.y === 0 && region.w === 1 && region.h === 1 && (clip.opacity ?? 1) === 1 && (clip.scale ?? 1) === 1 && (clip.rotation ?? 0) === 0 && !clip.animate && !clip.cropTrajectory && !clip.cropTrajectoryUrl && !clip.hasCropIntent && !hasClipEffect(clip, effects) && !clip.hasTransition && (!clip.transitionIn || clip.transitionIn === "none");
+}
 function visiblePackedHostWindows(clips, startFrame, endFrame, output, effects = [], hostMode = "packed-only") {
   if (endFrame <= startFrame) return [];
   const boundaries = /* @__PURE__ */ new Set([startFrame, endFrame]);
@@ -1307,7 +1323,7 @@ function visiblePackedHostWindows(clips, startFrame, endFrame, output, effects =
       effects
     ));
     const suppressesCaption = provesOcclusion && !globalEffectActive && pictureRect(top[0], output, effects) !== void 0;
-    const captionVisible = !(suppressesCaption && top[0].captionVisibility === "hidden");
+    const captionVisible = !(top.length === 1 && !globalEffectActive && (suppressesCaption && top[0].captionVisibility === "hidden" || explicitlyHidesCaptions(top[0], effects)));
     const candidateHost = (clip) => hostMode === "all-video-candidates" ? clip.mediaType !== "image" : !!clip.packedUrl;
     const host = provesOcclusion && candidateHost(top[0]) ? top[0] : void 0;
     const unresolvedOverlap = top.length > 1 || top.length === 1 && active.length > 1 && !provesOcclusion;
@@ -1879,6 +1895,11 @@ function captionVisibilityWindowsForComposition(composition, sourceDimensions) {
           ...item.region ? { region: item.region } : {},
           ...item.fit ? { fit: item.fit } : {},
           ...track.kind === "video" && item.captionVisibility ? { captionVisibility: item.captionVisibility } : {},
+          ...item.opacity !== void 0 ? { opacity: item.opacity } : {},
+          ...item.scale !== void 0 ? { scale: item.scale } : {},
+          ...item.rotation !== void 0 ? { rotation: item.rotation } : {},
+          ...item.animate !== void 0 ? { animate: item.animate } : {},
+          ...spanIndex === 0 && item.transitionIn?.type !== void 0 && item.transitionIn.type !== "cut" && item.transitionIn.type !== "none" ? { hasTransition: true } : {},
           ...item.source.reframe?.segments.length ? { hasCropIntent: true } : {},
           ...item.effects?.length ? { hasClipEffects: true } : {}
         });
@@ -1976,6 +1997,11 @@ function assertMergedCaptionFacesDrawable(composition) {
   if (!captions?.segments.some((segment) => segment.words.length > 0)) return;
   const brandCaption = composition.brandKit?.caption;
   const issues = mergedCaptionFaceIssues(captions.style, brandCaption);
+  for (const [index, layout] of (captions.layouts ?? []).entries()) {
+    for (const issue of mergedCaptionFaceIssues({ ...captions.style, ...layout.style }, brandCaption)) {
+      issues.push({ ...issue, path: `captions.layouts[${index}].style.${issue.path.split(".").at(-1)}` });
+    }
+  }
   if (issues.length === 0) return;
   throw renderInputError(
     "font_not_reproducible",
@@ -2078,9 +2104,9 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     if (end > maxBackgroundEndFrames) maxBackgroundEndFrames = end;
   }
   const bodyDurationInFrames = maxBackgroundEndFrames > 0 ? Math.min(maxEndFrames, maxBackgroundEndFrames) : maxEndFrames;
-  const captionSegments = composition.captions?.segments.map((seg) => seg.words).filter((words) => words.length > 0);
+  const captionSegments = composition.captions?.segments.map((seg) => seg.words);
   if (composition.captions?.zPlane === "behind-subject") {
-    assertBehindSubjectCaptionCoverage(captionSegments, clips, fps, { width, height }, effects);
+    assertBehindSubjectCaptionCoverage(captionSegments, clips, fps, { width, height }, effects, composition.captions.layouts);
   }
   const brandKit = composition.brandKit;
   const { totalFrames: durationInFrames } = resolveBookendTimeline(
@@ -2102,7 +2128,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...mot.exitMs != null ? { exitMs: mot.exitMs } : {}
   } : void 0;
   const baseStyle = composition.captions?.style;
-  const hasCaptions = captionSegments != null && captionSegments.length > 0;
+  const hasCaptions = captionSegments?.some((words) => words.length > 0) ?? false;
   const captionStyle = hasCaptions && (cap || baseStyle || captionMotion) ? {
     ...baseStyle ?? {},
     ...cap?.fontFamily ? { fontFamily: cap.fontFamily } : {},
@@ -2127,6 +2153,10 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...cap?.exitMs != null ? { exitMs: cap.exitMs } : {}
   } : void 0;
   const resolvedCaptionStyle = captionStyle ? resolveCaptionColorRefs(captionStyle, brandKit) : void 0;
+  const captionLayouts = composition.captions?.layouts?.map((layout) => ({
+    ...layout,
+    ...layout.style ? { style: resolveCaptionColorRefs(layout.style, brandKit) } : {}
+  }));
   return {
     clips,
     overlays,
@@ -2138,6 +2168,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...audioTracks.length > 0 ? { audioTracks } : {},
     ...effects.length > 0 ? { effects } : {},
     ...hasCaptions ? { captionSegments } : {},
+    ...hasCaptions && captionLayouts?.length ? { captionLayouts } : {},
     ...hasCaptions && composition.captions?.zPlane === "behind-subject" ? { captionsBehind: true } : {},
     ...resolvedCaptionStyle ? { captionStyle: resolvedCaptionStyle } : {},
     ...brandKit ? { brandKit } : {}

package/dist/{chunk-QVBUYWW6.js → chunk-Q2FWFTDZ.js}

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

package/dist/{chunk-MBSQKRDF.js → chunk-QCGT3M7M.js}

@@ -4,10 +4,10 @@ import {
   Format,
   GraphicRole,
   OpaqueId
-} from "./chunk-CV3QQUMK.js";
+} from "./chunk-VKZTGD5Z.js";
 import {
   brandKitCaptionFaceIssues
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../composition/src/validators/composePlan.ts
 import { z } from "zod";

package/dist/{chunk-KMDZDH5E.js → chunk-QCJUGKRC.js}

@@ -7,13 +7,13 @@ import {
 } from "./chunk-7AZLFN26.js";
 import {
   selectAllOverlays
-} from "./chunk-5JCLZPMV.js";
+} from "./chunk-T7WKIMTB.js";
 import {
   ComposePlan
-} from "./chunk-MBSQKRDF.js";
+} from "./chunk-QCGT3M7M.js";
 import {
   OverlayClipSource
-} from "./chunk-CV3QQUMK.js";
+} from "./chunk-VKZTGD5Z.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-2MBCDTCZ.js");
+      const { buildDirectorContext } = await import("./context-I7SPXR2Z.js");
       return buildDirectorContext(capabilities);
     }
   },

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

@@ -10,7 +10,7 @@ import {
 import {
   captionFontSource,
   effectiveCaptionFamily
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../composition/src/projection/brandKit.ts
 var LOGO_DEFAULT_PLACEMENT = "br";

package/dist/{chunk-IHXMBXXL.js → chunk-SIGKJOSF.js}

@@ -3,25 +3,29 @@ import {
   projectMediaPlaybackSpans,
   sliceTranscriptWords,
   splitIntoSentences
-} from "./chunk-3I43W7DP.js";
+} from "./chunk-GZMKTLO3.js";
 import {
   createHeadlessStore,
   findClipById,
   findMarkerById,
   findTrackContainingClipId
-} from "./chunk-5JCLZPMV.js";
+} from "./chunk-T7WKIMTB.js";
 import {
+  CaptionLayoutInput,
   CaptionSegment,
   CaptionStyle,
   Composition,
+  CompositionCaptions,
   Format,
   Marker,
   PerClipEffect,
   TimelineClip,
   Track,
   Transition,
+  captionLayoutIssues,
+  captionSegmentSignature,
   captionVisibilityIssues
-} from "./chunk-CV3QQUMK.js";
+} from "./chunk-VKZTGD5Z.js";
 import {
   ReframeSegment
 } from "./chunk-B7J5UUUV.js";
@@ -31,7 +35,7 @@ import {
 } from "./chunk-CL5Y6V6K.js";
 import {
   introducedCaptionFaceIssues
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../composition-ops/src/index.ts
 import { z } from "zod";
@@ -480,6 +484,9 @@ var CompositionOp = z.discriminatedUnion("type", [
   z.object({ type: z.literal("setCaptions"), segments: z.array(CaptionSegment), style: CaptionStyle.partial().optional() }).strict().describe(
     "Replace the caption SEGMENTS wholesale \u2014 author the word-timed caption layer directly (each segment = one sentence/page of `words` with timeline-ms `startMs`/`endMs`, optional `emphasis`). This is how a client with its OWN word timings (e.g. a generated VO take) gets word-synced captions without a source transcript; the compose lane's transcript slice writes the same layer. `style`, when given, merges with setCaptionStyle semantics; an omitted style keeps the existing one. Renderer paginates within a segment and never pools words across two \u2014 keep segments sentence-bounded."
   ),
+  z.object({ type: z.literal("setCaptionLayouts"), layouts: z.array(CaptionLayoutInput) }).strict().describe(
+    "Replace native caption placements without changing transcript words or timings. Each layout references a half-open word-index range in one saved segment; a one-word range is valid. region places that group independently, optional bounded scale/rotation/style changes its look, and holdThroughWordIndex keeps it visible through a later saved word in the same segment. All words in a placed range occupy one page; rendering refuses a range that cannot fit its box, so enlarge region or split the range. The box reserves horizontal space of 1.6 font sizes and vertical space of 0.8 font sizes for padding, with at most three lines. Unreferenced words keep the default caption layout. Word ranges must not overlap. Reapply after caption regeneration or timeline cuts."
+  ),
   z.object({ type: z.literal("applyMotionPreset"), clipId: z.string(), preset: z.string(), params: z.object({ enterMs: z.number().optional(), exitMs: z.number().optional(), staggerMs: z.number().optional() }).strict().optional() }).strict().describe(
     "Shell a STATIC `card` clip with a frame-driven MOTION preset \u2014 the public card-shelling op (the layout renders VERBATIM; only the container animates in/out). The server wraps the card in the chosen `preset` (fade-up / slide-in-left / slide-in-right / scale-pop / stagger-reveal), transpiles it, mints it as a LIVE component, and swaps the clip source to that component (the bakeless live lane \u2014 no box). `params` tunes timing (`enterMs`/`exitMs`, `staggerMs` for stagger-reveal). The target must be a static card (components already carry motion; library overlays already move); re-run overwrites idempotently ONLY while the target is still a card (an uncompilable shell); once shelled, the clip is a COMPONENT \u2014 to change its motion, remove and re-add the card, then re-shell. Honored under `dry_run` (validates preset + target without transpiling or persisting). ORDERING: the preset resolves its target against the PERSISTED composition \u2014 a card added in the SAME batch is not yet visible to it. Persist the clip.add batch first, then shell in a following call."
   ),
@@ -665,6 +672,20 @@ function applyOpToStore(store, op) {
     case "setCaptions":
       applyCaptionOpToStore(store, op);
       break;
+    case "setCaptionLayouts": {
+      const captions = composition.captions;
+      if (!captions) throw new Error("setCaptionLayouts requires saved transcript captions");
+      const issue = captionLayoutIssues(captions.segments, op.layouts)[0];
+      if (issue) throw new Error(`setCaptionLayouts.layouts[${issue.index}].${issue.field}: ${issue.message}`);
+      const layouts = op.layouts.map((layout) => ({
+        ...layout,
+        wordSignature: captionSegmentSignature(captions.segments[layout.segmentIndex].words)
+      }));
+      const parsed = CompositionCaptions.safeParse({ ...captions, layouts });
+      if (!parsed.success) throw new Error(`setCaptionLayouts: ${parsed.error.issues[0]?.message}`);
+      store.setCaptionLayouts(layouts);
+      break;
+    }
     case "applyMotionPreset":
       throw new Error(
         `applyOp: 'applyMotionPreset' is route-materialized \u2014 it needs a director transpile of the generated motion shell and is rewritten to a clip.update at /composition/apply before reaching the pure engine.`
@@ -801,6 +822,11 @@ function invertOp(before, op) {
     }
     case "setCaptionDepth":
       return { type: "setCaptionDepth", zPlane: before.captions?.zPlane ?? "front" };
+    case "setCaptionLayouts":
+      return {
+        type: "setCaptionLayouts",
+        layouts: (before.captions?.layouts ?? []).map(({ wordSignature: _signature, ...layout }) => layout)
+      };
     case "addTrack":
       if (op.id === void 0) {
         throw new Error("invertOp(addTrack): no pinned `id` \u2014 cannot target the minted track");