@cueframe/kernel 0.2.52 → 0.2.53

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-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-MBSQKRDF.js → chunk-CJMUTCJW.js}

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

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-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-LPUQTBKU.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 };
@@ -1976,6 +1987,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 +2094,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 +2118,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 +2143,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 +2158,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-WZ22ZYXD.js → chunk-P3DYA5NA.js}

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

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-5JCLZPMV.js → chunk-TPKPU4PE.js}

@@ -1,6 +1,6 @@
 import {
   Composition
-} from "./chunk-CV3QQUMK.js";
+} from "./chunk-UFNIB3JL.js";
 import {
   expandToLinkGroup
 } from "./chunk-KYRDKK2D.js";
@@ -132,6 +132,56 @@ function pruneSelectionInDraft(draft, removedClipIds) {
   draft.selectedOverlayId = patch.selectedOverlayId;
 }
 
+// ../composition/src/ops/captionOps.ts
+function createCaptionOps(set) {
+  return {
+    setCaptionStyle: (style) => {
+      set((draft) => {
+        const clean = Object.fromEntries(
+          Object.entries(style).filter(([, v]) => v !== void 0)
+        );
+        if (Object.keys(clean).length === 0) return;
+        const existing = draft.composition.captions;
+        if (existing) {
+          existing.style = { ...existing.style ?? {}, ...clean };
+        } else {
+          draft.composition.captions = { source: "authored", segments: [], style: clean };
+        }
+      });
+    },
+    setCaptionLayouts: (layouts) => {
+      set((draft) => {
+        if (!draft.composition.captions) throw new Error("setCaptionLayouts requires saved transcript captions");
+        if (layouts.length === 0) delete draft.composition.captions.layouts;
+        else draft.composition.captions.layouts = layouts;
+      });
+    },
+    setCaptionDepth: (zPlane) => {
+      set((draft) => {
+        const existing = draft.composition.captions;
+        if (!existing) return;
+        if (zPlane === "front") {
+          delete existing.zPlane;
+        } else {
+          existing.zPlane = zPlane;
+        }
+      });
+    },
+    setCaptions: (segments, style, derivedFrom) => {
+      set((draft) => {
+        const existing = draft.composition.captions;
+        const mergedStyle = style ? {
+          ...existing?.style ?? {},
+          ...Object.fromEntries(Object.entries(style).filter(([, v]) => v !== void 0))
+        } : existing?.style;
+        const styleField = mergedStyle && Object.keys(mergedStyle).length > 0 ? { style: mergedStyle } : {};
+        const depthField = existing?.zPlane ? { zPlane: existing.zPlane } : {};
+        draft.composition.captions = derivedFrom ? { source: "derived", from: derivedFrom, segments, ...styleField, ...depthField } : { source: "authored", segments, ...styleField, ...depthField };
+      });
+    }
+  };
+}
+
 // ../composition/src/ops/compositionOps.ts
 function createCompositionOps(get, set) {
   return {
@@ -447,6 +497,7 @@ function createCompositionOps(get, set) {
       if (!Number.isFinite(start) || !Number.isFinite(end) || start >= end) return;
       const span = end - start;
       set((draft) => {
+        if (draft.composition.captions) delete draft.composition.captions.layouts;
         for (const track of draft.composition.tracks) {
           const next = [];
           for (const item of track.contents) {
@@ -581,6 +632,7 @@ function createCompositionOps(get, set) {
           });
         }
         if (draft.composition.captions) {
+          delete draft.composition.captions.layouts;
           for (const seg of draft.composition.captions.segments) {
             seg.words = seg.words.flatMap((w) => {
               const r = cutTimedRange(w.startMs, w.endMs, tStart * 1e3, tEnd * 1e3);
@@ -631,6 +683,7 @@ function createCompositionOps(get, set) {
           }
         }
         if (draft.composition.captions) {
+          delete draft.composition.captions.layouts;
           for (const segment of draft.composition.captions.segments) {
             for (const word of segment.words) {
               const shifted = shiftTimedRange(word.startMs, word.endMs, insertAt * 1e3, restored * 1e3);
@@ -667,45 +720,10 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    setCaptionStyle: (style) => {
-      set((draft) => {
-        const clean = Object.fromEntries(
-          Object.entries(style).filter(([, v]) => v !== void 0)
-        );
-        if (Object.keys(clean).length === 0) return;
-        const existing = draft.composition.captions;
-        if (existing) {
-          existing.style = { ...existing.style ?? {}, ...clean };
-        } else {
-          draft.composition.captions = { source: "authored", segments: [], style: clean };
-        }
-      });
-    },
-    setCaptionDepth: (zPlane) => {
-      set((draft) => {
-        const existing = draft.composition.captions;
-        if (!existing) return;
-        if (zPlane === "front") {
-          delete existing.zPlane;
-        } else {
-          existing.zPlane = zPlane;
-        }
-      });
-    },
-    setCaptions: (segments, style, derivedFrom) => {
-      set((draft) => {
-        const existing = draft.composition.captions;
-        const mergedStyle = style ? {
-          ...existing?.style ?? {},
-          ...Object.fromEntries(Object.entries(style).filter(([, v]) => v !== void 0))
-        } : existing?.style;
-        const styleField = mergedStyle && Object.keys(mergedStyle).length > 0 ? { style: mergedStyle } : {};
-        const depthField = existing?.zPlane ? { zPlane: existing.zPlane } : {};
-        draft.composition.captions = derivedFrom ? { source: "derived", from: derivedFrom, segments, ...styleField, ...depthField } : { source: "authored", segments, ...styleField, ...depthField };
-      });
-    },
+    ...createCaptionOps(set),
     ripple: (time, amount) => {
       set((draft) => {
+        if (draft.composition.captions) delete draft.composition.captions.layouts;
         for (const track of draft.composition.tracks) {
           for (const item of track.contents) {
             if (!("source" in item)) continue;

package/dist/{chunk-CV3QQUMK.js → chunk-UFNIB3JL.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-B7J5UUUV.js";
 import {
   captionFaceIssues
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../composition/src/validators/opaqueId.ts
 import { z } from "zod";
@@ -11,6 +11,8 @@ var OpaqueId = z.string();
 
 // ../composition/src/validators/composition.ts
 import { z as z2 } from "zod";
+import { sha256 } from "@noble/hashes/sha256";
+import { bytesToHex } from "@noble/hashes/utils";
 var Format = z2.object({
   aspectRatio: z2.enum(["16:9", "9:16", "1:1", "4:5"]),
   fps: z2.union([z2.literal(24), z2.literal(25), z2.literal(30), z2.literal(60)]).optional(),
@@ -288,6 +290,101 @@ var CaptionStyle = z2.object({
   annotationColor: z2.string().optional(),
   maxWidthPercent: z2.number().positive().max(100, "captions style.maxWidthPercent is % of composition width (max 100)").optional()
 });
+var CaptionLayoutStyle = CaptionStyle.pick({
+  fontFamily: true,
+  fontSize: true,
+  fontWeight: true,
+  color: true,
+  highlightColor: true,
+  backgroundColor: true,
+  plate: true,
+  textTransform: true,
+  emphasisColor: true,
+  emphasisScale: true,
+  emphasisFontFamily: true,
+  emphasisFontWeight: true,
+  emphasisTextTransform: true,
+  emphasisLetterSpacing: true,
+  emphasisFontStyle: true,
+  emphasisPlate: true,
+  emphasisPlateColor: true,
+  emphasisPlateTextColor: true,
+  emphasisPlateAltColor: true,
+  emphasisPlateAltTextColor: true,
+  emphasisPlateRadius: true,
+  emphasisPlatePadX: true,
+  emphasisPlatePadY: true,
+  annotationColor: true,
+  entrance: true,
+  entranceMs: true,
+  entranceStaggerMs: true,
+  exitMs: true
+}).strict();
+var CaptionLayoutInput = z2.object({
+  segmentIndex: z2.number().int().nonnegative(),
+  wordStartIndex: z2.number().int().nonnegative(),
+  wordEndIndex: z2.number().int().positive().describe("Exclusive word index in the saved caption segment."),
+  region: CaptionRegion,
+  scale: z2.number().min(0.25).max(4).optional(),
+  rotation: z2.number().min(-45).max(45).optional(),
+  style: CaptionLayoutStyle.optional(),
+  holdThroughWordIndex: z2.number().int().nonnegative().optional().describe(
+    "Inclusive saved-word index in this segment. The layout stays visible until that word ends."
+  ),
+  wordMarks: z2.array(z2.object({
+    wordIndex: z2.number().int().nonnegative(),
+    emphasis: z2.boolean().optional(),
+    annotate: z2.enum(["circle", "underline"]).nullable().optional()
+  }).strict()).optional()
+}).strict();
+var CaptionLayout = CaptionLayoutInput.extend({
+  wordSignature: z2.string().regex(/^[a-f0-9]{64}$/)
+});
+function captionSegmentSignature(words) {
+  const encoded = JSON.stringify(words.map((word) => ({
+    text: word.text,
+    startMs: word.startMs,
+    endMs: word.endMs,
+    emphasis: word.emphasis ?? null,
+    annotate: word.annotate ?? null
+  })));
+  return bytesToHex(sha256(new TextEncoder().encode(encoded)));
+}
+function captionLayoutIssues(segments, layouts, checkSignature = false) {
+  const issues = [];
+  const occupied = /* @__PURE__ */ new Set();
+  layouts.forEach((layout, index) => {
+    const words = segments[layout.segmentIndex]?.words;
+    if (!words) {
+      issues.push({ index, field: "segmentIndex", message: "caption layout segment does not exist" });
+      return;
+    }
+    if (layout.wordStartIndex >= layout.wordEndIndex || layout.wordEndIndex > words.length) {
+      issues.push({ index, field: "wordEndIndex", message: "caption layout word range is outside its segment" });
+      return;
+    }
+    const hold = layout.holdThroughWordIndex ?? layout.wordEndIndex - 1;
+    if (hold < layout.wordEndIndex - 1 || hold >= words.length) {
+      issues.push({ index, field: "holdThroughWordIndex", message: "caption layout hold must reference this or a later word in the same segment" });
+    }
+    const marked = /* @__PURE__ */ new Set();
+    for (const mark of layout.wordMarks ?? []) {
+      if (mark.wordIndex < layout.wordStartIndex || mark.wordIndex >= layout.wordEndIndex || marked.has(mark.wordIndex)) {
+        issues.push({ index, field: "wordMarks", message: "caption layout word marks must be unique words inside the layout range" });
+      }
+      marked.add(mark.wordIndex);
+    }
+    for (let word = layout.wordStartIndex; word < layout.wordEndIndex; word++) {
+      const key = `${layout.segmentIndex}:${word}`;
+      if (occupied.has(key)) issues.push({ index, field: "wordStartIndex", message: "caption layout word ranges must not overlap" });
+      occupied.add(key);
+    }
+    if (checkSignature && "wordSignature" in layout && layout.wordSignature !== captionSegmentSignature(words)) {
+      issues.push({ index, field: "wordSignature", message: "caption layout is stale for these saved transcript words; reapply setCaptionLayouts" });
+    }
+  });
+  return issues;
+}
 var CaptionSegment = z2.object({
   words: z2.array(CaptionWord)
 });
@@ -298,18 +395,29 @@ var CompositionCaptions = z2.discriminatedUnion("source", [
     from: z2.object({ clipId: z2.string() }),
     segments: z2.array(CaptionSegment),
     style: CaptionStyle.optional(),
+    layouts: z2.array(CaptionLayout).optional(),
     zPlane: CaptionDepth
   }),
   z2.object({
     source: z2.literal("authored"),
     segments: z2.array(CaptionSegment),
     style: CaptionStyle.optional(),
+    layouts: z2.array(CaptionLayout).optional(),
     zPlane: CaptionDepth
   })
 ]).superRefine((captions, ctx) => {
-  if (!captions.style) return;
-  for (const issue of captionFaceIssues(captions.style)) {
-    ctx.addIssue({ code: "custom", path: ["style", issue.field], message: issue.message });
+  if (captions.style) {
+    for (const issue of captionFaceIssues(captions.style)) {
+      ctx.addIssue({ code: "custom", path: ["style", issue.field], message: issue.message });
+    }
+  }
+  for (const issue of captionLayoutIssues(captions.segments, captions.layouts ?? [], true)) {
+    ctx.addIssue({ code: "custom", path: ["layouts", issue.index, issue.field], message: issue.message });
+  }
+  for (const [index, layout] of (captions.layouts ?? []).entries()) {
+    for (const issue of captionFaceIssues({ ...captions.style, ...layout.style })) {
+      ctx.addIssue({ code: "custom", path: ["layouts", index, "style", issue.field], message: issue.message });
+    }
   }
 });
 function captionsAreBehindSubject(captions) {
@@ -540,6 +648,11 @@ export {
   Marker,
   CaptionWord,
   CaptionStyle,
+  CaptionLayoutStyle,
+  CaptionLayoutInput,
+  CaptionLayout,
+  captionSegmentSignature,
+  captionLayoutIssues,
   CaptionSegment,
   CompositionCaptions,
   captionsAreBehindSubject,

package/dist/{chunk-ACURZCPN.js → chunk-UKKY7HWN.js}

@@ -5,7 +5,7 @@ import {
   bundledFontFamilyFaces,
   isGenericOnlyStack,
   parseFontStack
-} from "./chunk-AVTEPAWI.js";
+} from "./chunk-7RGDRDAR.js";
 
 // ../execution/render-harness/src/cardFonts.ts
 import parseCss from "css-tree/parser";