@cueframe/kernel 0.2.50 → 0.2.52

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

@@ -335,6 +335,11 @@ export declare const ClipFit: z.ZodEnum<{
     cover: "cover";
 }>;
 export type ClipFit = z.infer<typeof ClipFit>;
+export declare const CaptionVisibility: z.ZodEnum<{
+    visible: "visible";
+    hidden: "hidden";
+}>;
+export type CaptionVisibility = z.infer<typeof CaptionVisibility>;
 export declare const PerClipEffect: z.ZodObject<{
     primitiveId: z.ZodString;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -543,6 +548,10 @@ export declare const TimelineClip: z.ZodObject<{
         contain: "contain";
         cover: "cover";
     }>>;
+    captionVisibility: z.ZodOptional<z.ZodEnum<{
+        visible: "visible";
+        hidden: "hidden";
+    }>>;
     effects: z.ZodOptional<z.ZodArray<z.ZodObject<{
         primitiveId: z.ZodString;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -698,6 +707,7 @@ export declare const TrackContent: z.ZodPipe<z.ZodUnknown, z.ZodTransform<{
         h: number;
     } | undefined;
     fit?: "contain" | "cover" | undefined;
+    captionVisibility?: "visible" | "hidden" | undefined;
     effects?: {
         primitiveId: string;
         params?: Record<string, unknown> | undefined;
@@ -857,6 +867,7 @@ export declare const Track: z.ZodObject<{
             h: number;
         } | undefined;
         fit?: "contain" | "cover" | undefined;
+        captionVisibility?: "visible" | "hidden" | undefined;
         effects?: {
             primitiveId: string;
             params?: Record<string, unknown> | undefined;
@@ -1148,6 +1159,13 @@ export declare function captionsAreBehindSubject(captions: {
 } | null | undefined): boolean;
 export type CompositionCaptions = z.infer<typeof CompositionCaptions>;
 export declare function captionWords(c: CompositionCaptions): CaptionWord[];
+/** One shared invariant for schema parsing, pure ops, and hosted writes. */
+export declare function captionVisibilityIssues(composition: {
+    tracks: Track[];
+}): Array<{
+    trackIndex: number;
+    contentIndex: number;
+}>;
 export declare const Composition: z.ZodObject<{
     v: z.ZodLiteral<1>;
     format: z.ZodObject<{
@@ -1302,6 +1320,7 @@ export declare const Composition: z.ZodObject<{
                 h: number;
             } | undefined;
             fit?: "contain" | "cover" | undefined;
+            captionVisibility?: "visible" | "hidden" | undefined;
             effects?: {
                 primitiveId: string;
                 params?: Record<string, unknown> | undefined;
@@ -1698,6 +1717,7 @@ export declare const CompositionVersion: z.ZodObject<{
                     h: number;
                 } | undefined;
                 fit?: "contain" | "cover" | undefined;
+                captionVisibility?: "visible" | "hidden" | undefined;
                 effects?: {
                     primitiveId: string;
                     params?: Record<string, unknown> | undefined;

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

@@ -205,6 +205,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                     h: number;
                 } | undefined;
                 fit?: "contain" | "cover" | undefined;
+                captionVisibility?: "visible" | "hidden" | undefined;
                 effects?: {
                     primitiveId: string;
                     params?: Record<string, unknown> | undefined;
@@ -1049,6 +1050,7 @@ export declare const RenderJob: z.ZodObject<{
                         h: number;
                     } | undefined;
                     fit?: "contain" | "cover" | undefined;
+                    captionVisibility?: "visible" | "hidden" | undefined;
                     effects?: {
                         primitiveId: string;
                         params?: Record<string, unknown> | undefined;

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

@@ -170,6 +170,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>;
+        captionVisibility: z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -363,6 +367,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>>;
+        captionVisibility: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>>;
         effects: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -552,6 +560,10 @@ export declare const CompositionOp: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contain: "contain";
             cover: "cover";
         }>>;
+        captionVisibility: z.ZodOptional<z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+        }>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodObject<{
             primitiveId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

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

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

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

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

@@ -11,7 +11,7 @@ export type { EmphasisWord } from './emphasis.js';
 export type { DocNode, TranscriptUtterance } from './captions.js';
 export { buildEmphasisSet, isEmphasized } from './emphasis.js';
 export { extractCaptionWordsFromDoc, sliceTranscriptWords, splitIntoSentences } from './captions.js';
-export { compositionToRenderInput, referencedMediaIds, assembleRenderInput, assemblePreparedRenderInput, validateComposition, compositionFormatDimensions, playableSpans, projectMediaPlaybackSpans, assertBehindSubjectCaptionCoverage, visiblePackedHostWindows, } from './compositionRender.js';
+export { compositionToRenderInput, referencedMediaIds, assembleRenderInput, assemblePreparedRenderInput, validateComposition, compositionFormatDimensions, captionVisibilityWindowsForComposition, playableSpans, projectMediaPlaybackSpans, assertBehindSubjectCaptionCoverage, visiblePackedHostWindows, } from './compositionRender.js';
 export { bookendFrames, resolveBookendTimeline, CARD_BOOKEND_DEFAULT_MS, VIDEO_BOOKEND_DEFAULT_MS, } from './bookends.js';
 export type { BookendTimeline } from './bookends.js';
 export { DEFAULT_FPS, DEFAULT_WIDTH, DEFAULT_HEIGHT, DEFAULT_RENDER_SETTINGS, FORMAT_PRESETS, RESOLUTION_PRESETS, bppToCrf, ensureEven, qualityToCrf, resolutionToOutputSize, } from './exportSettings.js';

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

@@ -69,6 +69,7 @@ export interface CompositionClip extends ProjectedVisualIdentity {
         h: number;
     };
     fit?: 'cover' | 'contain';
+    captionVisibility?: 'visible' | 'hidden';
     mediaType?: 'video' | 'audio' | 'image';
     kenBurns?: 'in' | 'out' | 'pan-l' | 'pan-r' | 'none';
     reframe?: Reframe;

package/dist/authoring/build-tools.js

@@ -4,13 +4,13 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-IHWC75AN.js";
-import "../chunk-KY3QBG7O.js";
+} from "../chunk-QVBUYWW6.js";
+import "../chunk-KMDZDH5E.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-NLXQ7WTH.js";
-import "../chunk-LO3DH776.js";
-import "../chunk-LZEX2GAY.js";
+import "../chunk-5JCLZPMV.js";
+import "../chunk-MBSQKRDF.js";
+import "../chunk-CV3QQUMK.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-OVV35ZS2.js";
-import "../chunk-NLXQ7WTH.js";
-import "../chunk-LO3DH776.js";
-import "../chunk-LZEX2GAY.js";
+} from "../chunk-FSEB4LSU.js";
+import "../chunk-5JCLZPMV.js";
+import "../chunk-MBSQKRDF.js";
+import "../chunk-CV3QQUMK.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-KY3QBG7O.js";
+} from "../chunk-KMDZDH5E.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-NLXQ7WTH.js";
-import "../chunk-LO3DH776.js";
-import "../chunk-LZEX2GAY.js";
+import "../chunk-5JCLZPMV.js";
+import "../chunk-MBSQKRDF.js";
+import "../chunk-CV3QQUMK.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-IHWC75AN.js";
+} from "./chunk-QVBUYWW6.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-KY3QBG7O.js";
+} from "./chunk-KMDZDH5E.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-OVV35ZS2.js";
+} from "./chunk-FSEB4LSU.js";
 import {
   buildFastModel,
   buildModel,
@@ -48,22 +48,22 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-6WQHVYJD.js";
-import {
-  cssLayoutVars
-} from "./chunk-Z6NY6MCL.js";
-import "./chunk-ILO4NEZ3.js";
 import "./chunk-7AZLFN26.js";
-import "./chunk-VG2ND6PX.js";
-import "./chunk-NLXQ7WTH.js";
-import "./chunk-LO3DH776.js";
-import "./chunk-LZEX2GAY.js";
+import "./chunk-5JCLZPMV.js";
+import "./chunk-MBSQKRDF.js";
+import "./chunk-CV3QQUMK.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
+import "./chunk-6WQHVYJD.js";
+import {
+  cssLayoutVars
+} from "./chunk-Z6NY6MCL.js";
 import "./chunk-WREYUH2E.js";
+import "./chunk-ILO4NEZ3.js";
 import "./chunk-E63UEO5C.js";
 import "./chunk-7PA7FGLD.js";
+import "./chunk-VG2ND6PX.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip

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

@@ -1436,6 +1436,7 @@ var BriefCreateRequest = zod19.strictObject({
       "h": zod19.number().gt(briefCreateRequestSeededGraphicsItemRegionHExclusiveMin).max(briefCreateRequestSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod19.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod19.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod19.array(zod19.strictObject({
       "primitiveId": zod19.string().min(1),
       "params": zod19.record(zod19.string(), zod19.unknown()).optional()
@@ -1697,6 +1698,7 @@ var BriefResponse = zod21.strictObject({
       "h": zod21.number().gt(briefResponseSeededGraphicsItemRegionHExclusiveMin).max(briefResponseSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod21.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod21.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod21.array(zod21.strictObject({
       "primitiveId": zod21.string().min(1),
       "params": zod21.record(zod21.string(), zod21.unknown()).optional()
@@ -1947,6 +1949,7 @@ var BriefPatchRequest = zod23.strictObject({
       "h": zod23.number().gt(briefPatchRequestSeededGraphicsItemRegionHExclusiveMin).max(briefPatchRequestSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod23.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod23.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod23.array(zod23.strictObject({
       "primitiveId": zod23.string().min(1),
       "params": zod23.record(zod23.string(), zod23.unknown()).optional()
@@ -2584,6 +2587,14 @@ var compositionCaptionsOneSegmentsItemWordsItemEndMsMin = 0;
 var compositionCaptionsOneStyleFontSizeMax = 15;
 var compositionCaptionsOneStyleFontWeightMin = 100;
 var compositionCaptionsOneStyleFontWeightMax = 900;
+var compositionCaptionsOneStyleRegionXMin = 0;
+var compositionCaptionsOneStyleRegionXMax = 1;
+var compositionCaptionsOneStyleRegionYMin = 0;
+var compositionCaptionsOneStyleRegionYMax = 1;
+var compositionCaptionsOneStyleRegionWExclusiveMin = 0;
+var compositionCaptionsOneStyleRegionWMax = 1;
+var compositionCaptionsOneStyleRegionHExclusiveMin = 0;
+var compositionCaptionsOneStyleRegionHMax = 1;
 var compositionCaptionsOneStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsOneStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsOneStyleEmphasisFontWeightMax = 900;
@@ -2598,6 +2609,14 @@ var compositionCaptionsTwoSegmentsItemWordsItemEndMsMin = 0;
 var compositionCaptionsTwoStyleFontSizeMax = 15;
 var compositionCaptionsTwoStyleFontWeightMin = 100;
 var compositionCaptionsTwoStyleFontWeightMax = 900;
+var compositionCaptionsTwoStyleRegionXMin = 0;
+var compositionCaptionsTwoStyleRegionXMax = 1;
+var compositionCaptionsTwoStyleRegionYMin = 0;
+var compositionCaptionsTwoStyleRegionYMax = 1;
+var compositionCaptionsTwoStyleRegionWExclusiveMin = 0;
+var compositionCaptionsTwoStyleRegionWMax = 1;
+var compositionCaptionsTwoStyleRegionHExclusiveMin = 0;
+var compositionCaptionsTwoStyleRegionHMax = 1;
 var compositionCaptionsTwoStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsTwoStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsTwoStyleEmphasisFontWeightMax = 900;
@@ -2739,6 +2758,7 @@ var Composition = zod58.strictObject({
         "h": zod58.number().gt(compositionTracksItemContentsItemOneRegionHExclusiveMin).max(compositionTracksItemContentsItemOneRegionHMax)
       }).optional(),
       "fit": zod58.enum(["cover", "contain"]).optional(),
+      "captionVisibility": zod58.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
       "effects": zod58.array(zod58.strictObject({
         "primitiveId": zod58.string().min(1),
         "params": zod58.record(zod58.string(), zod58.unknown()).optional()
@@ -2797,6 +2817,12 @@ var Composition = zod58.strictObject({
       "backgroundColor": zod58.string().optional(),
       "plate": zod58.enum(["glass", "solid", "none"]).optional(),
       "position": zod58.enum(["top", "center", "bottom"]).optional(),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsOneStyleRegionXMin).max(compositionCaptionsOneStyleRegionXMax),
+        "y": zod58.number().min(compositionCaptionsOneStyleRegionYMin).max(compositionCaptionsOneStyleRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsOneStyleRegionWExclusiveMin).max(compositionCaptionsOneStyleRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsOneStyleRegionHExclusiveMin).max(compositionCaptionsOneStyleRegionHMax)
+      }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
@@ -2842,6 +2868,12 @@ var Composition = zod58.strictObject({
       "backgroundColor": zod58.string().optional(),
       "plate": zod58.enum(["glass", "solid", "none"]).optional(),
       "position": zod58.enum(["top", "center", "bottom"]).optional(),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsTwoStyleRegionXMin).max(compositionCaptionsTwoStyleRegionXMax),
+        "y": zod58.number().min(compositionCaptionsTwoStyleRegionYMin).max(compositionCaptionsTwoStyleRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsTwoStyleRegionWExclusiveMin).max(compositionCaptionsTwoStyleRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsTwoStyleRegionHExclusiveMin).max(compositionCaptionsTwoStyleRegionHMax)
+      }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
@@ -6072,6 +6104,14 @@ var compositionOpOneoneSegmentsOneItemBiasYMax = 0.3;
 var compositionOpOnethreeStyleFontSizeMax = 15;
 var compositionOpOnethreeStyleFontWeightMin = 100;
 var compositionOpOnethreeStyleFontWeightMax = 900;
+var compositionOpOnethreeStyleRegionXMin = 0;
+var compositionOpOnethreeStyleRegionXMax = 1;
+var compositionOpOnethreeStyleRegionYMin = 0;
+var compositionOpOnethreeStyleRegionYMax = 1;
+var compositionOpOnethreeStyleRegionWExclusiveMin = 0;
+var compositionOpOnethreeStyleRegionWMax = 1;
+var compositionOpOnethreeStyleRegionHExclusiveMin = 0;
+var compositionOpOnethreeStyleRegionHMax = 1;
 var compositionOpOnethreeStyleEmphasisScaleExclusiveMin = 0;
 var compositionOpOnethreeStyleEmphasisFontWeightMin = 100;
 var compositionOpOnethreeStyleEmphasisFontWeightMax = 900;
@@ -6086,6 +6126,14 @@ var compositionOpOnefiveSegmentsItemWordsItemEndMsMin = 0;
 var compositionOpOnefiveStyleFontSizeMax = 15;
 var compositionOpOnefiveStyleFontWeightMin = 100;
 var compositionOpOnefiveStyleFontWeightMax = 900;
+var compositionOpOnefiveStyleRegionXMin = 0;
+var compositionOpOnefiveStyleRegionXMax = 1;
+var compositionOpOnefiveStyleRegionYMin = 0;
+var compositionOpOnefiveStyleRegionYMax = 1;
+var compositionOpOnefiveStyleRegionWExclusiveMin = 0;
+var compositionOpOnefiveStyleRegionWMax = 1;
+var compositionOpOnefiveStyleRegionHExclusiveMin = 0;
+var compositionOpOnefiveStyleRegionHMax = 1;
 var compositionOpOnefiveStyleEmphasisScaleExclusiveMin = 0;
 var compositionOpOnefiveStyleEmphasisFontWeightMin = 100;
 var compositionOpOnefiveStyleEmphasisFontWeightMax = 900;
@@ -6238,6 +6286,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpThreeClipRegionHExclusiveMin).max(compositionOpThreeClipRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6387,6 +6436,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpFivePatchRegionHExclusiveMin).max(compositionOpFivePatchRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6532,6 +6582,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpSevenClipsItemRegionHExclusiveMin).max(compositionOpSevenClipsItemRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6628,6 +6679,12 @@ var CompositionOp = zod67.union([zod67.strictObject({
     "backgroundColor": zod67.string().optional(),
     "plate": zod67.enum(["glass", "solid", "none"]).optional(),
     "position": zod67.enum(["top", "center", "bottom"]).optional(),
+    "region": zod67.strictObject({
+      "x": zod67.number().min(compositionOpOnethreeStyleRegionXMin).max(compositionOpOnethreeStyleRegionXMax),
+      "y": zod67.number().min(compositionOpOnethreeStyleRegionYMin).max(compositionOpOnethreeStyleRegionYMax),
+      "w": zod67.number().gt(compositionOpOnethreeStyleRegionWExclusiveMin).max(compositionOpOnethreeStyleRegionWMax),
+      "h": zod67.number().gt(compositionOpOnethreeStyleRegionHExclusiveMin).max(compositionOpOnethreeStyleRegionHMax)
+    }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),
@@ -6675,6 +6732,12 @@ var CompositionOp = zod67.union([zod67.strictObject({
     "backgroundColor": zod67.string().optional(),
     "plate": zod67.enum(["glass", "solid", "none"]).optional(),
     "position": zod67.enum(["top", "center", "bottom"]).optional(),
+    "region": zod67.strictObject({
+      "x": zod67.number().min(compositionOpOnefiveStyleRegionXMin).max(compositionOpOnefiveStyleRegionXMax),
+      "y": zod67.number().min(compositionOpOnefiveStyleRegionYMin).max(compositionOpOnefiveStyleRegionYMax),
+      "w": zod67.number().gt(compositionOpOnefiveStyleRegionWExclusiveMin).max(compositionOpOnefiveStyleRegionWMax),
+      "h": zod67.number().gt(compositionOpOnefiveStyleRegionHExclusiveMin).max(compositionOpOnefiveStyleRegionHMax)
+    }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),