@cueframe/kernel 0.1.0 → 0.1.1

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

@@ -550,6 +550,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 annotationColor?: string | undefined;
                 maxWidthPercent?: number | undefined;
             }>>;
+            zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
         }, "strip", z.ZodTypeAny, {
             segments: {
                 words: {
@@ -564,6 +565,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -611,6 +613,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -780,6 +783,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 annotationColor?: string | undefined;
                 maxWidthPercent?: number | undefined;
             }>>;
+            zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
         }, "strip", z.ZodTypeAny, {
             segments: {
                 words: {
@@ -791,6 +795,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -835,6 +840,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -1097,6 +1103,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -1141,6 +1148,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -1232,6 +1240,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -1276,6 +1285,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -2776,6 +2786,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -2820,6 +2831,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -3147,6 +3159,7 @@ export declare const RenderSnapshot: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -3191,6 +3204,7 @@ export declare const RenderSnapshot: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -4184,6 +4198,7 @@ export declare const RenderJob: z.ZodObject<{
                     annotationColor?: string | undefined;
                     maxWidthPercent?: number | undefined;
                 }>>;
+                zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
             }, "strip", z.ZodTypeAny, {
                 segments: {
                     words: {
@@ -4198,6 +4213,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4245,6 +4261,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4414,6 +4431,7 @@ export declare const RenderJob: z.ZodObject<{
                     annotationColor?: string | undefined;
                     maxWidthPercent?: number | undefined;
                 }>>;
+                zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
             }, "strip", z.ZodTypeAny, {
                 segments: {
                     words: {
@@ -4425,6 +4443,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4469,6 +4488,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4731,6 +4751,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4775,6 +4796,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4866,6 +4888,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -4910,6 +4933,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -6410,6 +6434,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -6454,6 +6479,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -6781,6 +6807,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -6825,6 +6852,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -7440,6 +7468,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -7484,6 +7513,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -7875,6 +7905,7 @@ export declare const RenderJob: z.ZodObject<{
                 from: {
                     clipId: string;
                 };
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;
@@ -7919,6 +7950,7 @@ export declare const RenderJob: z.ZodObject<{
                     }[];
                 }[];
                 source: "authored";
+                zPlane?: "front" | "behind-subject" | undefined;
                 style?: {
                     position?: "top" | "center" | "bottom" | undefined;
                     fontFamily?: string | undefined;

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

@@ -44,6 +44,7 @@
  */
 import type { Composition, Format } from "../../composition/validators/index.js";
 import type { RenderInput } from "./types.js";
+import type { TrajectoryData } from "../../composition/reframe/trajectory.js";
 /**
  * Resolve `Format` (`aspectRatio`, optional `fps` + `resolution`) to
  * concrete pixel dimensions. Mirrors the public-composition path's
@@ -164,7 +165,22 @@ jsSourceByClipId?: Record<string, string>,
  * (`compound_unresolved`) rather than rendering a deliverable that is
  * silently missing a sequence.
  */
-subCompositions?: Record<string, Composition>): RenderInput;
+subCompositions?: Record<string, Composition>, 
+/**
+ * Optional parallel map: `clipId → an ALREADY-DERIVED crop trajectory`, the
+ * in-memory peer of `trajectoryUrls`.
+ *
+ * The editor supplies this. `deriveTrajectory` is pure and the subject track
+ * it reads arrives presigned on the media row, so a preview surface can
+ * derive exactly what the render will derive — same function, same track,
+ * same authored reframe — with no round trip and nothing to store. That is
+ * what lets a follow-the-speaker clip move in the preview instead of only in
+ * an output someone has already paid for.
+ *
+ * Server renders keep using `trajectoryUrls`: their trajectory is written to
+ * R2 by an action, and inlining a per-frame series would bloat the snapshot.
+ */
+trajectories?: Record<string, TrajectoryData>): RenderInput;
 /**
  * Assemble a RenderInput from an ALREADY-validated (and brand-ref-resolved)
  * composition plus PRE-RESOLVED asset URL maps. This is the pure core shared by

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

@@ -1,6 +1,7 @@
 import type { Scene, GlobalEffects, EffectTarget } from '../../composition/ops/index.js';
 import type { ResolvedBrandKit } from '../../composition/projection/index.js';
 import type { Reframe } from '../../composition/reframe/index.js';
+import type { TrajectoryData } from '../../composition/reframe/trajectory.js';
 import type { CaptionWord as WireCaptionWord, CaptionStyle as WireCaptionStyle } from '../../composition/validators/index.js';
 export type OverlayTemplate = 'custom' | 'gif' | 'image' | 'lottie' | (string & {});
 export interface OverlayParams {
@@ -143,6 +144,25 @@ export interface CompositionClip {
      * consumer.
      */
     cropTrajectoryUrl?: string;
+    /**
+     * The same per-frame crop trajectory, IN MEMORY rather than behind a URL.
+     *
+     * The editor derives a clip's trajectory client-side — `deriveTrajectory` is
+     * pure, and the cached subject track it reads arrives presigned on the media
+     * row — so there is no object to fetch and nothing to presign. Handing the
+     * renderer a URL would mean minting a blob one per keystroke, into a
+     * module-level per-URL cache that never evicts.
+     *
+     * `CropFromTrajectory` has taken an in-memory trajectory since the still path
+     * needed one (`traj = trajectory ?? fetched`), so this is a channel to a prop
+     * that already exists, not a second rendering path. The server render keeps
+     * using `cropTrajectoryUrl`: its trajectory is written to R2 by an action, and
+     * inlining it would put a per-frame series in the render snapshot.
+     *
+     * Exactly one of the two is set. When both are, this wins — it is the fresher
+     * of the two by construction, since it was derived from the edit in hand.
+     */
+    cropTrajectory?: TrajectoryData;
     /**
      * Frame-packed CO-VIEW source for the captions-behind-speaker effect: ONE
      * opaque H.264 (BiRefNet-portrait) with the scene (top half) and the matte
@@ -271,6 +291,17 @@ export interface RenderInput {
     audioTracks?: CompositionAudioTrack[];
     effects?: CompositionEffect[];
     captionSegments?: CaptionWord[][];
+    /**
+     * The caption layer renders UNDER the speaker's silhouette
+     * (`composition.captions.zPlane === 'behind-subject'`). One choice for the
+     * whole layer, because it decides whether the SOURCE needs a matte — the
+     * $0.12/source-minute rung, not the $0.004 one, and a caption layer usually
+     * spans the whole video.
+     *
+     * Requested, not guaranteed: the renderer degrades to the front mount when no
+     * co-view is on the timeline (nothing to hide behind).
+     */
+    captionsBehind?: boolean;
     captionStyle?: Partial<CaptionStyle>;
     width: number;
     height: number;

package/dist/authoring/build-tools.js

@@ -4,15 +4,15 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-LM4WDUQJ.js";
-import "../chunk-VOO5FQSS.js";
+} from "../chunk-UHGSZZDI.js";
+import "../chunk-PDYO3DOJ.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-ZB3C3HM7.js";
-import "../chunk-XWKZB5U5.js";
+import "../chunk-7FO3ZJ43.js";
+import "../chunk-ZWMV6DD2.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
+import "../chunk-TOJEXFXL.js";
+import "../chunk-PODIYN2K.js";
 import "../chunk-W35ZMOXB.js";
 import "../chunk-EA6MYCYW.js";
 import "../chunk-WREYUH2E.js";

package/dist/authoring/context.js

@@ -1,10 +1,10 @@
 import {
   buildDirectorContext
-} from "../chunk-IBYQG46O.js";
-import "../chunk-XWKZB5U5.js";
+} from "../chunk-AQBREB5O.js";
+import "../chunk-ZWMV6DD2.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
+import "../chunk-TOJEXFXL.js";
+import "../chunk-PODIYN2K.js";
 import "../chunk-W35ZMOXB.js";
 import "../chunk-EA6MYCYW.js";
 import "../chunk-WREYUH2E.js";

package/dist/authoring/tools.js

@@ -6,14 +6,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-VOO5FQSS.js";
+} from "../chunk-PDYO3DOJ.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-ZB3C3HM7.js";
-import "../chunk-XWKZB5U5.js";
+import "../chunk-7FO3ZJ43.js";
+import "../chunk-ZWMV6DD2.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
+import "../chunk-TOJEXFXL.js";
+import "../chunk-PODIYN2K.js";
 import "../chunk-W35ZMOXB.js";
 import "../chunk-EA6MYCYW.js";
 import "../chunk-WREYUH2E.js";

package/dist/authoring.js

@@ -1,6 +1,6 @@
 import {
   buildDirectorContext
-} from "./chunk-IBYQG46O.js";
+} from "./chunk-AQBREB5O.js";
 import {
   buildFastModel,
   buildModel,
@@ -29,7 +29,7 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-LM4WDUQJ.js";
+} from "./chunk-UHGSZZDI.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -38,27 +38,27 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-VOO5FQSS.js";
+} from "./chunk-PDYO3DOJ.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
-import "./chunk-ZB3C3HM7.js";
-import "./chunk-XWKZB5U5.js";
+import "./chunk-7FO3ZJ43.js";
+import "./chunk-ZWMV6DD2.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-KYRDKK2D.js";
-import "./chunk-GEA7E2FL.js";
+import "./chunk-JJ6XD7NG.js";
 import {
   cssLayoutVars
 } from "./chunk-FYZVH3MC.js";
 import "./chunk-DSMLHYJ4.js";
 import "./chunk-JF4JJAFP.js";
-import "./chunk-NFEGPWGS.js";
-import "./chunk-MXFAADCQ.js";
+import "./chunk-TOJEXFXL.js";
+import "./chunk-PODIYN2K.js";
 import "./chunk-W35ZMOXB.js";
 import "./chunk-EA6MYCYW.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-37NJ27UU.js";
+import "./chunk-OCFDUCF4.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts
@@ -1159,6 +1159,8 @@ var MotionPresetError = class extends Error {
     this.opIndex = opIndex;
     this.name = "MotionPresetError";
   }
+  code;
+  opIndex;
 };
 function resolveMotionPresetCard(composition, input) {
   if (!MOTION_PRESETS.includes(input.preset)) {

package/dist/{chunk-ZB3C3HM7.js → chunk-7FO3ZJ43.js}

@@ -15484,6 +15484,9 @@ var CatalogFilterError = class extends Error {
     this.allowed = allowed;
     this.name = "CatalogFilterError";
   }
+  field;
+  value;
+  allowed;
 };
 var CatalogCursorError = class extends Error {
   constructor(message = "The supplied cursor is invalid or expired.") {

package/dist/{chunk-ODL7GQJG.js → chunk-AP6ZIVAV.js}

@@ -28,14 +28,14 @@ import {
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-ZB3C3HM7.js";
+} from "./chunk-7FO3ZJ43.js";
 import {
   NEUTRAL_RAMP
 } from "./chunk-JF4JJAFP.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-OCFDUCF4.js";
 
 // ../execution/compose/src/primitiveRegistry.ts
 var allCatalogs = [

package/dist/{chunk-IBYQG46O.js → chunk-AQBREB5O.js}

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

package/dist/{chunk-YIOY2XEO.js → chunk-DK2ODBNT.js}

@@ -20,7 +20,7 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-JRQVPFLF.js";
+} from "./chunk-HY3RIEZW.js";
 import {
   flattenCompoundClips,
   hasCompoundClips
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-OCFDUCF4.js";
 
 // ../execution/core/src/render/emphasis.ts
 function buildEmphasisSet(emphasisWords) {
@@ -323,7 +323,7 @@ function playableSpans(trimStart, trimEnd, excluded) {
   if (cursor < trimEnd) out.push({ start: cursor, end: trimEnd });
   return out;
 }
-function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
+function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, trajectories) {
   const clips = [];
   const audio = [];
   const effects = [];
@@ -434,6 +434,11 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
         // mediaItems.variants[intentHash][aspect].trajectoryR2Key per clip
         // and presigns it.
         ...trajectoryUrls?.[c.id] !== void 0 ? { cropTrajectoryUrl: trajectoryUrls[c.id] } : {},
+        // The same trajectory IN MEMORY — the editor's path. It derives the
+        // trajectory client-side from the presigned subject track on the media
+        // row, so there is no object to fetch. Keyed by the PARENT wire-clip id
+        // for the same reason the URL map is. See `CompositionClip.cropTrajectory`.
+        ...trajectories?.[c.id] !== void 0 ? { cropTrajectory: trajectories[c.id] } : {},
         // Captions-behind CO-VIEW. Content-driven (Phase 6): the matte gate baked
         // a crop-independent frame-packed co-view (scene over matte, one opaque
         // H.264) for any clip whose timeline range overlaps a behind-subject
@@ -457,6 +462,7 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
     if (JSON.stringify(prev.region) !== JSON.stringify(cur.region)) continue;
     if ((prev.fit ?? "cover") !== (cur.fit ?? "cover")) continue;
     if (prev.cropTrajectoryUrl !== cur.cropTrajectoryUrl) continue;
+    if (prev.cropTrajectory !== cur.cropTrajectory) continue;
     if ((prev.trimStartFrames ?? 0) !== (cur.trimStartFrames ?? 0)) continue;
     const prevEnd = prev.timelineStartFrames + prev.durationInFrames;
     if (Math.abs(prevEnd - cur.timelineStartFrames) > 1) continue;
@@ -759,7 +765,7 @@ function componentRefsByClipId(composition) {
   }
   return refs;
 }
-function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUrls, alphaUrls, jsSourceByClipId, subCompositions) {
+function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUrls, alphaUrls, jsSourceByClipId, subCompositions, trajectories) {
   const flattened = hasCompoundClips(composition) ? flattenCompoundClips(composition, (id) => subCompositions?.[id]) : composition;
   composition = flattened;
   const { width, height, fps } = compositionFormatDimensions(composition.format);
@@ -770,7 +776,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
   for (const track of composition.tracks) {
     if (track.enabled === false) continue;
     if (track.kind === "video" || track.kind === "audio") {
-      const { clips: c, audio, effects: clipEffects } = projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls);
+      const { clips: c, audio, effects: clipEffects } = projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, trajectories);
       clips.push(...c);
       audioTracks.push(...audio);
       effects.push(...clipEffects);
@@ -878,6 +884,10 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...audioTracks.length > 0 ? { audioTracks } : {},
     ...effects.length > 0 ? { effects } : {},
     ...hasCaptions ? { captionSegments } : {},
+    // Depth for the caption layer. Only meaningful alongside captions, so it is
+    // emitted with them — a `captionsBehind` on a composition with no caption
+    // words would be a flag describing nothing.
+    ...hasCaptions && composition.captions?.zPlane === "behind-subject" ? { captionsBehind: true } : {},
     ...captionStyle ? { captionStyle } : {},
     ...brandKit ? { brandKit } : {}
     // (fitMode deleted 2026-05-25 — baked variants replace render-time fit

package/dist/{chunk-JRQVPFLF.js → chunk-HY3RIEZW.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-OCFDUCF4.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;