@cueframe/kernel 0.0.1 → 0.1.1

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

@@ -2320,7 +2320,7 @@ export declare const TimelineClip: z.ZodObject<{
      * does not select its audio, so every ripple, move and trim silently desyncs
      * sound from picture and the user finds out at playback. Every editor this
      * repo has been measured against carries the same field; ours had none
-     * (`grep linkGroup` returned nothing across `cueframe/src` and
+     * (`grep linkGroup` returned nothing across `apps/studio/src` and
      * `packages/composition/src` on 2026-08-23).
      *
      * Membership is the ONLY thing stored. What a link implies — expand the
@@ -3303,9 +3303,12 @@ export type CaptionStyle = z.infer<typeof CaptionStyle>;
 /** One caption SEGMENT (a phrase / sentence) — the content unit the agent
  *  authors AND a hard caption-page boundary at render: the renderer paginates
  *  within a segment and never pools words across two, so sentence-bounded
- *  segments (see `splitIntoSentences`) cut captions at sentence ends. Captions
- *  are FRONT-ONLY; depth ("behind subject") lives on overlays
- *  (`OverlayClipSource.zPlane`), never on captions. */
+ *  segments (see `splitIntoSentences`) cut captions at sentence ends.
+ *
+ *  Depth is NOT per-segment: it is one choice for the whole caption layer
+ *  (`CompositionCaptions.zPlane`), because it decides whether the source needs
+ *  a matte at all. (This comment said captions were FRONT-ONLY until
+ *  2026-08-28 — see `CaptionDepth` for why that rule existed and why it went.) */
 export declare const CaptionSegment: z.ZodObject<{
     words: z.ZodArray<z.ZodObject<{
         text: z.ZodString;
@@ -3344,28 +3347,6 @@ export declare const CaptionSegment: z.ZodObject<{
     }[];
 }>;
 export type CaptionSegment = z.infer<typeof CaptionSegment>;
-/**
- * PROVENANCE IS REQUIRED. `segments` is a materialized projection, and until
- * 2026-08-14 it carried no record of where it came from — which is the whole
- * bug. `useCaptionMaterialization` said so itself: "once segments exist there is
- * no reliable way to distinguish 'materialized from this doc' from
- * 'API-authored', and guessing risks destroying" the authored ones. So nothing
- * dared re-derive, and captions silently outlived the edits that invalidated
- * them — a real project carried words timed 1940–4400ms inside a 2.4s
- * composition, with the render reading those stale times.
- *
- * `derived` — a projection of a clip's transcript. Anything that changes that
- * clip (trim, cut, an excluded range, playback rate) MUST re-derive it, and may,
- * because `from` says exactly what to recompute from.
- *
- * `authored` — a human or agent wrote these words. Never rewritten
- * automatically; the segmentation is a deliberate choice.
- *
- * Segments stay MATERIALIZED rather than resolved at read time on purpose:
- * `compositionToRenderInput(composition, srcUrls)` takes no transcripts, and a
- * renderer that had to fetch them would stop being self-contained and
- * deterministic — which the render cache key depends on.
- */
 export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
     source: z.ZodLiteral<"derived">;
     /** The clip these words are a projection OF. Re-derive from this. */
@@ -3510,6 +3491,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
         annotationColor?: string | undefined;
         maxWidthPercent?: number | undefined;
     }>>;
+    zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
 }, "strip", z.ZodTypeAny, {
     segments: {
         words: {
@@ -3524,6 +3506,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
     from: {
         clipId: string;
     };
+    zPlane?: "front" | "behind-subject" | undefined;
     style?: {
         position?: "top" | "center" | "bottom" | undefined;
         fontFamily?: string | undefined;
@@ -3571,6 +3554,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
     from: {
         clipId: string;
     };
+    zPlane?: "front" | "behind-subject" | undefined;
     style?: {
         position?: "top" | "center" | "bottom" | undefined;
         fontFamily?: string | undefined;
@@ -3740,6 +3724,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
         annotationColor?: string | undefined;
         maxWidthPercent?: number | undefined;
     }>>;
+    zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
 }, "strip", z.ZodTypeAny, {
     segments: {
         words: {
@@ -3751,6 +3736,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
         }[];
     }[];
     source: "authored";
+    zPlane?: "front" | "behind-subject" | undefined;
     style?: {
         position?: "top" | "center" | "bottom" | undefined;
         fontFamily?: string | undefined;
@@ -3795,6 +3781,7 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
         }[];
     }[];
     source: "authored";
+    zPlane?: "front" | "behind-subject" | undefined;
     style?: {
         position?: "top" | "center" | "bottom" | undefined;
         fontFamily?: string | undefined;
@@ -3829,6 +3816,12 @@ export declare const CompositionCaptions: z.ZodDiscriminatedUnion<"source", [z.Z
         maxWidthPercent?: number | undefined;
     } | undefined;
 }>]>;
+/** Do these captions render UNDER the speaker's silhouette? The one predicate
+ *  every gate asks, so the trigger, the renderer and the editor cannot drift
+ *  the way the overlay gates did before `isBehindSubjectDepthSource`. */
+export declare function captionsAreBehindSubject(captions: {
+    zPlane?: unknown;
+} | null | undefined): boolean;
 export type CompositionCaptions = z.infer<typeof CompositionCaptions>;
 /** All caption words across the layer's segments, in order — the flattened view
  *  consumers that don't care about behind use. */
@@ -4337,6 +4330,7 @@ export declare const Composition: z.ZodObject<{
             annotationColor?: string | undefined;
             maxWidthPercent?: number | undefined;
         }>>;
+        zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
     }, "strip", z.ZodTypeAny, {
         segments: {
             words: {
@@ -4351,6 +4345,7 @@ export declare const Composition: z.ZodObject<{
         from: {
             clipId: string;
         };
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -4398,6 +4393,7 @@ export declare const Composition: z.ZodObject<{
         from: {
             clipId: string;
         };
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -4567,6 +4563,7 @@ export declare const Composition: z.ZodObject<{
             annotationColor?: string | undefined;
             maxWidthPercent?: number | undefined;
         }>>;
+        zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
     }, "strip", z.ZodTypeAny, {
         segments: {
             words: {
@@ -4578,6 +4575,7 @@ export declare const Composition: z.ZodObject<{
             }[];
         }[];
         source: "authored";
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -4622,6 +4620,7 @@ export declare const Composition: z.ZodObject<{
             }[];
         }[];
         source: "authored";
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -4884,6 +4883,7 @@ export declare const Composition: z.ZodObject<{
         from: {
             clipId: string;
         };
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -4928,6 +4928,7 @@ export declare const Composition: z.ZodObject<{
             }[];
         }[];
         source: "authored";
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -5019,6 +5020,7 @@ export declare const Composition: z.ZodObject<{
         from: {
             clipId: string;
         };
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -5063,6 +5065,7 @@ export declare const Composition: z.ZodObject<{
             }[];
         }[];
         source: "authored";
+        zPlane?: "front" | "behind-subject" | undefined;
         style?: {
             position?: "top" | "center" | "bottom" | undefined;
             fontFamily?: string | undefined;
@@ -5660,6 +5663,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 annotationColor?: string | undefined;
                 maxWidthPercent?: number | undefined;
             }>>;
+            zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
         }, "strip", z.ZodTypeAny, {
             segments: {
                 words: {
@@ -5674,6 +5678,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -5721,6 +5726,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -5890,6 +5896,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 annotationColor?: string | undefined;
                 maxWidthPercent?: number | undefined;
             }>>;
+            zPlane: z.ZodOptional<z.ZodEnum<["front", "behind-subject"]>>;
         }, "strip", z.ZodTypeAny, {
             segments: {
                 words: {
@@ -5901,6 +5908,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -5945,6 +5953,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6207,6 +6216,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6251,6 +6261,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6342,6 +6353,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6386,6 +6398,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6625,6 +6638,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6669,6 +6683,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6771,6 +6786,7 @@ export declare const CompositionVersion: z.ZodObject<{
             from: {
                 clipId: string;
             };
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;
@@ -6815,6 +6831,7 @@ export declare const CompositionVersion: z.ZodObject<{
                 }[];
             }[];
             source: "authored";
+            zPlane?: "front" | "behind-subject" | undefined;
             style?: {
                 position?: "top" | "center" | "bottom" | undefined;
                 fontFamily?: string | undefined;

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/composition-ops/index.d.ts

@@ -4888,7 +4888,7 @@ export declare function applyOp(composition: Composition, op: CompositionOp): Co
  *
  * So: `HeadlessStore` here is a STRUCTURAL contract (`CompositionOps` + a
  * `getState`), not a concrete class — `@cueframe/authoring`'s `CompositionStore`
- * and the desktop store satisfy it, and `LocalExecutor` (cueframe/src/llm) folds
+ * and the desktop store satisfy it, and `LocalExecutor` (apps/studio/src/llm) folds
  * a validated batch through it op-by-op. Writing a second switch for that lane
  * is what "one vocabulary" exists to prevent: it would drift silently the first
  * time an op is added here and forgotten there.

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

@@ -3,7 +3,7 @@
  * recordingStore so it has exactly one home and two consumers:
  *
  *   - `createRecordingStore` (compose bench/eval): wraps the headless store.
- *   - the EDITOR's compositionOps delegate (cueframe/src/store): wraps the
+ *   - the EDITOR's compositionOps delegate (apps/studio/src/store): wraps the
  *     zustand-backed op surface, so every user gesture records the same wire
  *     op an agent would send — the P0.5 "editor writes are ops" seam.
  *

package/dist/_members/convex-api/api.d.ts

@@ -0,0 +1,5 @@
+import type { api as GeneratedApi } from "./api.generated.js";
+/** The client-facing function-reference proxy. Runtime-identical to the
+ *  backend's generated `api` (which IS `anyApi`); typed by the vendored
+ *  declarations with the internal.* surface stripped. */
+export declare const api: typeof GeneratedApi;

package/dist/_members/convex-api/dataModel.d.ts

@@ -0,0 +1,6 @@
+import type { GenericId } from "convex/values";
+import type { SystemTableNames } from "convex/server";
+/** Table NAMES only — the vendored surface deliberately omits document
+ *  shapes (Doc/DataModel). Public consumers use exclusively `Id<...>`. */
+export type TableNames = "agentMessages" | "agentThreads" | "apiAuditLog" | "billingPlanState" | "brandKits" | "briefs" | "checkpoints" | "clips" | "clipSuggestionRuns" | "componentVersions" | "composeJobs" | "compositionEvents" | "compositionRuns" | "compositions" | "compositionVersions" | "contextFiles" | "conversations" | "corrections" | "critics" | "dashboardInsights" | "directorProfiles" | "directorWorkflows" | "enrichmentCandidates" | "exports" | "idempotencyKeys" | "installedComponents" | "jobs" | "markers" | "mediaItems" | "mediaUnderstanding" | "overlays" | "pricingPolicy" | "processingEvents" | "projects" | "providerStates" | "renderJobs" | "resourceQueryCache" | "resourceRateBuckets" | "restorePoints" | "runs" | "searchQueries" | "sessions" | "sessionTokens" | "settings" | "socialAccounts" | "socialInsights" | "socialMediaItems" | "templateEmbeddings" | "templates" | "timelineClips" | "tracks" | "transcripts" | "uploadTokens" | "usageEvents" | "userSettings" | "videoChunkEmbeddings" | "webhookDeliveries" | "webhookProjectUpdateDebounce" | "webhooks" | "x402Payments";
+export type Id<TableName extends TableNames | SystemTableNames> = GenericId<TableName>;

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/exportSettings.d.ts

@@ -1,6 +1,6 @@
 /**
  * Export settings types and constants shared between desktop and cloud render paths.
- * Extracted from cueframe/src/store/exportStore.ts — pure functions, no store deps.
+ * Extracted from apps/studio/src/store/exportStore.ts — pure functions, no store deps.
  */
 import type { CaptionStyle } from './types.js';
 export type ExportQuality = 'maximum' | 'social' | 'web' | 'potato' | 'source';