@cueframe/kernel 0.2.59-rc.1 → 0.2.59-rc.3

package/dist/{chunk-IUJABAG2.js → chunk-HOQ45246.js}

@@ -6,7 +6,7 @@ import {
 import {
   flattenCompoundClips,
   hasCompoundClips
-} from "./chunk-ZPJQ3TQL.js";
+} from "./chunk-WYMJ5RXC.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -24,11 +24,14 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-3HLDIIWA.js";
+} from "./chunk-F5UOF52Q.js";
 import {
   compositionHasVo,
   roleDefaultGainDb
 } from "./chunk-P3EFZDM5.js";
+import {
+  componentClipRenderInput
+} from "./chunk-WHYTCQYZ.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -39,7 +42,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 import {
   SCENE_CAPTURE_IDENTITY_FIELDS_V1,
   SCENE_PRESET_TRIANGLES,
@@ -54,7 +57,7 @@ import {
   sceneFullMipLevels,
   sceneTextureBytes,
   selectSceneBakeScale
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 import {
   SCENE_CONTEXT_GL_BUDGET_BYTES,
   SCENE_MAX_TRIANGLES,
@@ -1663,7 +1666,7 @@ function clipTransformChannel(c) {
     ...c.animate !== void 0 ? { animate: c.animate } : {}
   };
 }
-function projectOverlayTrack(track, trackIndex, trackCount, fps, alphaUrls = {}, isSceneClip = () => false) {
+function projectOverlayTrack(track, trackIndex, trackCount, fps, alphaUrls, componentClips, isSceneClip = () => false) {
   const overlays = [];
   for (let i = 0; i < track.contents.length; i++) {
     const c = track.contents[i];
@@ -1680,37 +1683,33 @@ function projectOverlayTrack(track, trackIndex, trackCount, fps, alphaUrls = {},
         { trackId: track.id, clipId: c.id, compositionPath: `composition.tracks[${track.id}].contents[${i}].effects` }
       );
     }
-    if (c.source.kind === "component") {
+    if (c.source.kind === "component" && componentClips === "baked") {
       const { startFrame: startFrame2, durationInFrames: durationInFrames2 } = timelineSpanFrames(
         c.startTime,
         c.startTime + c.duration,
         fps
       );
       if (durationInFrames2 === 0) continue;
-      const rawRef = c.source.props.componentRef;
-      const ref = rawRef && typeof rawRef === "object" && !Array.isArray(rawRef) ? rawRef : null;
-      if (ref?.version !== 1 || typeof ref.sourceVersionId !== "string" || !/^[a-f0-9]{64}$/.test(ref.sourceVersionId)) {
+      const src = alphaUrls[c.id];
+      if (!src) {
         throw renderInputError(
-          "invalid_composition",
-          `composition.tracks[${track.id}].contents[${i}].source: component clip ${c.id} has no immutable source version`,
-          { trackId: track.id, clipId: c.id, componentId: c.source.componentId }
+          "variant_not_baked",
+          `composition.tracks[${track.id}].contents[${i}]: component clip ${c.id} has no baked alpha (alphaUrls[${c.id}] missing), bake before render`,
+          {
+            trackId: track.id,
+            clipId: c.id,
+            componentId: c.source.componentId,
+            compositionPath: `composition.tracks[${track.id}].contents[${i}].source`
+          }
         );
       }
-      const { componentRef: _reserved, renderSeed, ...params } = c.source.props;
-      if (renderSeed !== void 0 && (typeof renderSeed !== "string" || renderSeed.length === 0)) {
-        throw renderInputError("invalid_composition", `composition.tracks[${track.id}].contents[${i}].source.props.renderSeed must be a non-empty string`, transitionLocator);
-      }
       overlays.push({
         ...visualIdentity(track, trackIndex, trackCount, i),
         id: c.id,
-        template: "component",
-        componentId: c.source.componentId,
-        sourceVersionId: ref.sourceVersionId,
-        ...renderSeed !== void 0 ? { renderSeed } : {},
-        componentAssets: c.source.assets ?? {},
+        template: "alpha-layer",
         startFrame: startFrame2,
         durationInFrames: durationInFrames2,
-        params,
+        params: { src },
         ...c.source.zPlane !== void 0 ? { zPlane: c.source.zPlane } : {},
         ...c.region !== void 0 ? { region: c.region } : {},
         ...c.fit !== void 0 ? { fit: c.fit } : {},
@@ -1719,33 +1718,33 @@ function projectOverlayTrack(track, trackIndex, trackCount, fps, alphaUrls = {},
       });
       continue;
     }
-    if (c.source.kind === "alpha-layer") {
+    if (c.source.kind === "component") {
       const { startFrame: startFrame2, durationInFrames: durationInFrames2 } = timelineSpanFrames(
         c.startTime,
         c.startTime + c.duration,
         fps
       );
       if (durationInFrames2 === 0) continue;
-      const src = alphaUrls[c.id];
-      if (!src) {
+      const built = componentClipRenderInput({ id: c.id, componentId: c.source.componentId, props: c.source.props });
+      if (!built.ok) {
         throw renderInputError(
-          "variant_not_baked",
-          `composition.tracks[${track.id}].contents[${i}]: alpha-layer clip ${c.id} has no baked alpha (alphaUrls[${c.id}] missing) \u2014 bake before render`,
-          {
-            trackId: track.id,
-            clipId: c.id,
-            componentId: c.source.componentId,
-            compositionPath: `composition.tracks[${track.id}].contents[${i}].source`
-          }
+          built.refusal.code,
+          `composition.tracks[${track.id}].contents[${i}].source: ${built.refusal.message}`,
+          { trackId: track.id, clipId: c.id, componentId: c.source.componentId }
         );
       }
+      const { sourceVersionId, params, seed } = built.input;
       overlays.push({
         ...visualIdentity(track, trackIndex, trackCount, i),
         id: c.id,
-        template: "alpha-layer",
+        template: "component",
+        componentId: c.source.componentId,
+        sourceVersionId,
+        renderSeed: seed,
+        componentAssets: c.source.assets ?? {},
         startFrame: startFrame2,
         durationInFrames: durationInFrames2,
-        params: { src },
+        params,
         ...c.source.zPlane !== void 0 ? { zPlane: c.source.zPlane } : {},
         ...c.region !== void 0 ? { region: c.region } : {},
         ...c.fit !== void 0 ? { fit: c.fit } : {},
@@ -1782,7 +1781,7 @@ function projectOverlayTrack(track, trackIndex, trackCount, fps, alphaUrls = {},
     if (c.source.kind !== "overlay") {
       throw renderInputError(
         "clip_source_track_mismatch",
-        `composition.tracks[${track.id}].contents[${i}]: kind=${c.source.kind} is invalid on an overlay track (expected 'overlay', 'alpha-layer', or 'card')`,
+        `composition.tracks[${track.id}].contents[${i}]: kind=${c.source.kind} is invalid on an overlay track (expected 'overlay', 'component', or 'card')`,
         { trackId: track.id, clipId: c.id, compositionPath: `composition.tracks[${track.id}].contents[${i}].source` }
       );
     }
@@ -2014,6 +2013,14 @@ function assertMergedCaptionFacesDrawable(composition) {
   );
 }
 function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUrls, alphaUrls, subCompositions, trajectories, options) {
+  const componentClips = options?.componentClips;
+  if (componentClips !== "live" && componentClips !== "baked") {
+    throw renderInputError(
+      "internal_error",
+      `render input must name its component lane ('live' or 'baked'), got ${String(componentClips)}`,
+      {}
+    );
+  }
   const flattened = hasCompoundClips(composition) ? flattenCompoundClips(composition, (id) => subCompositions?.[id]) : composition;
   composition = flattened;
   for (const track of composition.tracks) {
@@ -2047,7 +2054,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
         trajectoryUrls,
         coViewUrls,
         trajectories,
-        options?.sourceDimensions
+        options.sourceDimensions
       );
       clips.push(...c);
       audioTracks.push(...audio);
@@ -2069,7 +2076,8 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
         trackCount,
         fps,
         alphaUrls ?? {},
-        options?.isSceneClip
+        componentClips,
+        options.isSceneClip
       ));
     } else if (track.kind === "effect") {
       effects.push(...projectEffectTrack(track, trackIndex, trackCount, fps));
@@ -2093,7 +2101,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
   for (const e of effects) {
     consider(e.startFrame ?? 0, e.durationInFrames ?? 0);
   }
-  const SCENE_OVERLAY_TEMPLATES = /* @__PURE__ */ new Set(["alpha-layer", "custom", "card"]);
+  const SCENE_OVERLAY_TEMPLATES = /* @__PURE__ */ new Set(["alpha-layer", "component", "custom", "card"]);
   let maxBackgroundEndFrames = 0;
   for (const c of clips) {
     const end = c.timelineStartFrames + c.durationInFrames;
@@ -2176,6 +2184,13 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
   };
 }
 function assembleRenderInput(composition, resolved) {
+  if (resolved.componentClips === "baked" && Object.keys(resolved.componentSources ?? {}).length > 0) {
+    throw renderInputError(
+      "internal_error",
+      "render input on the baked lane must not carry componentSources: component code goes to the bake step, never to the render",
+      {}
+    );
+  }
   const resolveSource = resolved.componentSources ? sceneSourceResolverForPinnedRows(resolved.componentSources) : null;
   if (resolveSource) {
     assertSceneClipShapes(composition, {
@@ -2194,6 +2209,7 @@ function assembleRenderInput(composition, resolved) {
     // The same manifest-backed answer the shape rules used, so projection cannot floor a scene
     // clip's boundary into a length the rules above would have refused.
     {
+      componentClips: resolved.componentClips,
       ...resolveSource ? { isSceneClip: (clip) => isSceneShotClip(clip, resolveSource) } : {},
       sourceDimensions: resolved.sourceDimensions
     }

package/dist/{chunk-T56BK7NS.js → chunk-JRGALHBZ.js}

@@ -55,7 +55,7 @@ function isSourceKindCompatible(trackKind, sourceKind) {
     case "image":
       return sourceKind === "media" || sourceKind === "component";
     case "overlay":
-      return sourceKind === "overlay" || sourceKind === "component" || sourceKind === "alpha-layer" || sourceKind === "card";
+      return sourceKind === "overlay" || sourceKind === "component" || sourceKind === "card";
     case "effect":
       return sourceKind === "effect";
   }

package/dist/{chunk-FZB7UX44.js → chunk-KEQTT67U.js}

@@ -1392,7 +1392,7 @@ var BriefCreateRequest = zod19.strictObject({
       "kind": zod19.literal("component"),
       "componentId": zod19.string().min(1),
       "props": zod19.record(zod19.string(), zod19.unknown()),
-      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional(),
+      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod19.enum(["front", "behind-subject"]).optional()
     }), zod19.strictObject({
       "kind": zod19.literal("overlay"),
@@ -1409,12 +1409,6 @@ var BriefCreateRequest = zod19.strictObject({
       "kind": zod19.literal("effect"),
       "primitiveId": zod19.string().min(1),
       "params": zod19.record(zod19.string(), zod19.unknown()).optional()
-    }), zod19.strictObject({
-      "kind": zod19.literal("alpha-layer"),
-      "componentId": zod19.string().min(1),
-      "props": zod19.record(zod19.string(), zod19.unknown()),
-      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod19.enum(["front", "behind-subject"]).optional()
     }), zod19.strictObject({
       "kind": zod19.literal("card"),
       "html": zod19.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -1654,7 +1648,7 @@ var BriefResponse = zod21.strictObject({
       "kind": zod21.literal("component"),
       "componentId": zod21.string().min(1),
       "props": zod21.record(zod21.string(), zod21.unknown()),
-      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional(),
+      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod21.enum(["front", "behind-subject"]).optional()
     }), zod21.strictObject({
       "kind": zod21.literal("overlay"),
@@ -1671,12 +1665,6 @@ var BriefResponse = zod21.strictObject({
       "kind": zod21.literal("effect"),
       "primitiveId": zod21.string().min(1),
       "params": zod21.record(zod21.string(), zod21.unknown()).optional()
-    }), zod21.strictObject({
-      "kind": zod21.literal("alpha-layer"),
-      "componentId": zod21.string().min(1),
-      "props": zod21.record(zod21.string(), zod21.unknown()),
-      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod21.enum(["front", "behind-subject"]).optional()
     }), zod21.strictObject({
       "kind": zod21.literal("card"),
       "html": zod21.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -1905,7 +1893,7 @@ var BriefPatchRequest = zod23.strictObject({
       "kind": zod23.literal("component"),
       "componentId": zod23.string().min(1),
       "props": zod23.record(zod23.string(), zod23.unknown()),
-      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional(),
+      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod23.enum(["front", "behind-subject"]).optional()
     }), zod23.strictObject({
       "kind": zod23.literal("overlay"),
@@ -1922,12 +1910,6 @@ var BriefPatchRequest = zod23.strictObject({
       "kind": zod23.literal("effect"),
       "primitiveId": zod23.string().min(1),
       "params": zod23.record(zod23.string(), zod23.unknown()).optional()
-    }), zod23.strictObject({
-      "kind": zod23.literal("alpha-layer"),
-      "componentId": zod23.string().min(1),
-      "props": zod23.record(zod23.string(), zod23.unknown()),
-      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod23.enum(["front", "behind-subject"]).optional()
     }), zod23.strictObject({
       "kind": zod23.literal("card"),
       "html": zod23.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -2812,7 +2794,7 @@ var Composition = zod58.strictObject({
         "kind": zod58.literal("component"),
         "componentId": zod58.string().min(1),
         "props": zod58.record(zod58.string(), zod58.unknown()),
-        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional(),
+        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
         "zPlane": zod58.enum(["front", "behind-subject"]).optional()
       }), zod58.strictObject({
         "kind": zod58.literal("overlay"),
@@ -2829,12 +2811,6 @@ var Composition = zod58.strictObject({
         "kind": zod58.literal("effect"),
         "primitiveId": zod58.string().min(1),
         "params": zod58.record(zod58.string(), zod58.unknown()).optional()
-      }), zod58.strictObject({
-        "kind": zod58.literal("alpha-layer"),
-        "componentId": zod58.string().min(1),
-        "props": zod58.record(zod58.string(), zod58.unknown()),
-        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-        "zPlane": zod58.enum(["front", "behind-subject"]).optional()
       }), zod58.strictObject({
         "kind": zod58.literal("card"),
         "html": zod58.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6520,7 +6496,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6537,12 +6513,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6670,7 +6640,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6687,12 +6657,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6816,7 +6780,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6833,12 +6797,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),

package/dist/{chunk-4VBLQIM5.js → chunk-KRIEZVXX.js}

@@ -5,7 +5,7 @@ var DescribeCompositionOpsInput = z.object({
   type: z.string().optional().describe("Exact CompositionOp type, such as captions.fromComposition. Omit for the operation list.")
 });
 async function describeCompositionOps(type) {
-  const { CompositionOp } = await import("./src-XI5MULKD.js");
+  const { CompositionOp } = await import("./src-XYW7BEJ5.js");
   const variants = CompositionOp.options;
   const knownTypes = variants.map((variant2) => variant2.shape.type.value);
   if (type === void 0) {

package/dist/{chunk-PLWDYWK6.js → chunk-KWWWMU5S.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XHMKPTHV.js";
 import {
   checkTracks
-} from "./chunk-T56BK7NS.js";
+} from "./chunk-JRGALHBZ.js";
 
 // ../composition/src/invariants/etag.ts
 import { sha256 } from "@noble/hashes/sha256";

package/dist/{chunk-IVFMOHAC.js → chunk-L53YKOK4.js}

@@ -1,3 +1,6 @@
+import {
+  isBehindSubjectDepthSource
+} from "./chunk-DPMS7I65.js";
 import {
   activeFaceKeepOutSeries,
   boundingBox,
@@ -6,7 +9,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [
@@ -251,10 +254,7 @@ function behindWindowsOf(composition) {
   const out = [];
   for (const track of tracksOf(composition)) {
     for (const clip of clipsOf(track)) {
-      const src = clip.source;
-      const kind = src?.kind;
-      if (kind !== "overlay" && kind !== "alpha-layer") continue;
-      if (src?.zPlane !== "behind-subject") continue;
+      if (!isBehindSubjectDepthSource(clip.source)) continue;
       if (clip.duration <= 0) continue;
       out.push({
         startMs: clip.startTime * 1e3,

package/dist/{chunk-XOT2VWCO.js → chunk-LRS32NU7.js}

@@ -2,18 +2,18 @@ import {
   SCENE_SHOT_RESOURCE_DESCRIPTION,
   SCENE_SHOT_RESOURCE_URI,
   sceneShotContract
-} from "./chunk-I2HNC4PQ.js";
+} from "./chunk-FZCVNHML.js";
 import {
   WAIT_KINDS,
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-7II5OM7R.js";
+} from "./chunk-TBZEIN45.js";
 import {
   DESCRIBE_COMPOSITION_OPS_DESCRIPTION,
   DescribeCompositionOpsInput,
   describeCompositionOps
-} from "./chunk-4VBLQIM5.js";
+} from "./chunk-KRIEZVXX.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -31,10 +31,10 @@ import {
   text,
   textWithData,
   withMedia
-} from "./chunk-FZB7UX44.js";
+} from "./chunk-KEQTT67U.js";
 import {
   CURATED_TOOLS
-} from "./chunk-4WBSXHQA.js";
+} from "./chunk-EA3J5XUJ.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -117,7 +117,7 @@ Every long job is either polled or pushed \u2014 never guessed:
 - Webhooks (\`create_webhook\`): ONE terminal event per kind with status INSIDE the payload \u2014 \`render.completed\`, \`compose.completed\`, \`media.completed\`, \`suggest.completed\` \u2014 plus \`checkpoint.ready\` (a held compose paused for review). Read \`cueframe://webhook-events\` for the full contract before building a receiver.
 - Presigned URLs (stills, clips, render outputs) expire \u2014 render outputs last ~7 days (refresh via the render's refresh-url op); preview stills/clips ~1 hour. Re-read for a fresh link instead of caching one.
 
-CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource + contract-v2 manifest) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns the verified artifact from the same immutable bundle used by production; a compile/runtime/capability failure lands on the job's FAILED terminal carrying the sanitized author-fixable message) \u2192 fix via \`update_component\` \u2192 preview again. Place the verified component artifact via \`apply_composition\` as an \`alpha-layer\` clip \u2014 the shared compositor never executes authored source.
+CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource + contract-v2 manifest) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns the verified artifact from the same immutable bundle used by production; a compile/runtime/capability failure lands on the job's FAILED terminal carrying the sanitized author-fixable message) \u2192 fix via \`update_component\` \u2192 preview again. Place the verified component via \`apply_composition\` as a \`{kind:'component', componentId, props}\` clip.
 
 Cleanup: \`delete_project\` / \`delete_media\` / \`delete_webhook\` / \`delete_composition\`. \`list_projects\` re-orients you in an existing workspace; \`list_media\` (filter by \`source\`/\`tag\`) lists the library.
 

package/dist/{chunk-6KZCXAYL.js → chunk-MRLC4HLJ.js}

@@ -1,7 +1,7 @@
 import {
   GraphicRole,
   OpaqueId
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 import {
   CardHtml
 } from "./chunk-EQH37KNZ.js";

package/dist/{chunk-P6RVYHLT.js → chunk-NASGAME6.js}

@@ -3,13 +3,13 @@ import {
   assertSceneShotParamsAdmitted,
   materializeComponentSource,
   renderComponentAlpha
-} from "./chunk-AK6QPX7A.js";
+} from "./chunk-DBBKM74E.js";
 import {
   assertSourceReadsDeclaredAssets
-} from "./chunk-6HPEMDQW.js";
+} from "./chunk-ZUCLQVXD.js";
 import {
   resolvedComponentRenderer
-} from "./chunk-KC4LNZL5.js";
+} from "./chunk-VSHAP22Q.js";
 import {
   componentArtifactId,
   componentBundleId,
@@ -25,7 +25,7 @@ import {
   ComponentRuntimeError,
   assertGraphicsReceiptMatches,
   assertRendererReceiptMatches
-} from "./chunk-BZVOCVQV.js";
+} from "./chunk-BLVSFN6J.js";
 
 // ../execution/component-runtime/src/assetServer.ts
 import { createHash, randomBytes } from "crypto";

package/dist/{chunk-XQGQ5EFS.js → chunk-O3RHY4ZI.js}

@@ -66,6 +66,7 @@ var ERROR_CODES = {
   component_does_not_compile: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   component_runtime_error: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   component_source_unavailable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  component_source_unpinned: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   scene_materialization_failed: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   // ── CUE-28: codes that were thrown typed and arrived as internal_error 500 ──
   //
@@ -182,6 +183,7 @@ var ERROR_CODES = {
   wrong_status: { stage: "billing", category: "authoring", retryable: false, httpStatus: 409 },
   transcript_payload_empty: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
   render_job_no_snapshot: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  composition_unreadable: { stage: "validate", category: "internal", retryable: false, httpStatus: 500 },
   project_revision_invariant: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
   // ── INTERNAL: the message would describe our infrastructure, not the request.
   // Registered anyway, so the CODE and `retryable` are still honest even though

package/dist/{chunk-WPZKOVYF.js → chunk-OL3ULF5Q.js}

@@ -1,5 +1,5 @@
 // ../composition/src/validators/graphicKinds.ts
-var AUTHORED_GRAPHIC_KINDS = ["overlay", "component", "card", "alpha-layer"];
+var AUTHORED_GRAPHIC_KINDS = ["overlay", "component", "card"];
 var GRAPHIC_ROLE_CANONICAL_KIND = {
   "title-card": "overlay",
   stat: "overlay",

package/dist/{chunk-AFUITAH6.js → chunk-S6YSOEK5.js}

@@ -62,7 +62,9 @@ var ComponentClipSource = z2.object({
   kind: z2.literal("component"),
   componentId: z2.string().min(1),
   props: z2.record(z2.string(), z2.unknown()),
-  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional(),
+  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional().describe(
+    "Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."
+  ),
   zPlane: z2.enum(["front", "behind-subject"]).optional()
 });
 var OverlayClipSource = z2.object({
@@ -78,15 +80,6 @@ var EffectClipSource = z2.object({
   primitiveId: z2.string().min(1),
   params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var AlphaLayerClipSource = z2.object({
-  kind: z2.literal("alpha-layer"),
-  componentId: z2.string().min(1),
-  props: z2.record(z2.string(), z2.unknown()),
-  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional().describe(
-    "Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."
-  ),
-  zPlane: z2.enum(["front", "behind-subject"]).optional()
-});
 var CardClipSource = z2.object({
   kind: z2.literal("card"),
   html: CardHtml,
@@ -103,7 +96,6 @@ var ClipSource = z2.discriminatedUnion("kind", [
   ComponentClipSource,
   OverlayClipSource,
   EffectClipSource,
-  AlphaLayerClipSource,
   CardClipSource,
   CompositionClipSource
 ]);
@@ -636,7 +628,6 @@ export {
   ComponentClipSource,
   OverlayClipSource,
   EffectClipSource,
-  AlphaLayerClipSource,
   CardClipSource,
   CompositionClipSource,
   ClipSource,

package/dist/{chunk-U7KSOA2L.js → chunk-SBKCVRJB.js}

@@ -5,7 +5,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-MMJYII7Y.js → chunk-SBWXIK5K.js}

@@ -1,9 +1,9 @@
-import {
-  FitText
-} from "./chunk-XHGZ2E77.js";
 import {
   EASING_BY_INTENT
 } from "./chunk-MFHXCHRI.js";
+import {
+  FitText
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -26,7 +26,7 @@ import {
   perspectiveFor,
   resolveCamera,
   useStage
-} from "./chunk-RWJHZCOR.js";
+} from "./chunk-TG756AMB.js";
 
 // ../execution/primitives/src/effects/blur/index.tsx
 import React2 from "react";

package/dist/{chunk-7II5OM7R.js → chunk-TBZEIN45.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-FZB7UX44.js";
+} from "./chunk-KEQTT67U.js";
 
 // ../mcp/src/wait.ts
 var WAIT_KINDS = [