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

package/dist/authoring/scene.js

@@ -13,7 +13,7 @@ import {
   sceneTrackIdFor,
   validateSceneAdd,
   validateSceneUpdate
-} from "../chunk-6HA55CRU.js";
+} from "../chunk-X7DGPNSV.js";
 import "../chunk-XHMKPTHV.js";
 import {
   SCENE_TRANSITION_KINDS,
@@ -23,7 +23,7 @@ import {
   offFrameLattice,
   readSceneSourceRef,
   sceneClipShapeIssues
-} from "../chunk-CL5Y6V6K.js";
+} from "../chunk-UB6Z7RY4.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-U67V476Y.js";
 export {

package/dist/authoring.js

@@ -4,10 +4,10 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-6HA55CRU.js";
+} from "./chunk-X7DGPNSV.js";
 import {
   buildDirectorContext
-} from "./chunk-LVMWPFV4.js";
+} from "./chunk-VW22APZC.js";
 import {
   buildFastModel,
   buildModel,
@@ -39,29 +39,30 @@ import {
 } from "./chunk-EISHFHU5.js";
 import {
   selectAllOverlays
-} from "./chunk-2K2GBFLU.js";
+} from "./chunk-Y2NR3Y6J.js";
 import {
   ComposePlan
-} from "./chunk-ZCEYEIRB.js";
-import "./chunk-6KZCXAYL.js";
+} from "./chunk-3KFQM7DG.js";
+import "./chunk-MRLC4HLJ.js";
 import {
   OverlayClipSource
-} from "./chunk-AFUITAH6.js";
-import "./chunk-WPZKOVYF.js";
+} from "./chunk-S6YSOEK5.js";
+import "./chunk-OL3ULF5Q.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-EQH37KNZ.js";
 import "./chunk-Q6CJ6HCU.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-IVFMOHAC.js";
+import "./chunk-L53YKOK4.js";
+import "./chunk-DPMS7I65.js";
 import "./chunk-DKBFAQCW.js";
 import "./chunk-ILO4NEZ3.js";
-import "./chunk-XQGQ5EFS.js";
+import "./chunk-O3RHY4ZI.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-VG2ND6PX.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-OOL7ZUG7.js";
 import "./chunk-U67V476Y.js";
@@ -142,7 +143,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext: buildDirectorContext2 } = await import("./context-7SWSVJ6Z.js");
+      const { buildDirectorContext: buildDirectorContext2 } = await import("./context-WOYP7QBB.js");
       return buildDirectorContext2(capabilities);
     }
   },

package/dist/{chunk-ZCEYEIRB.js → chunk-3KFQM7DG.js}

@@ -3,7 +3,7 @@ import {
   Format,
   GraphicRole,
   OpaqueId
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 
 // ../composition/src/validators/composePlan.ts
 import { z } from "zod";

package/dist/{chunk-JNBNDHEF.js → chunk-3SMYBRYD.js}

@@ -43,14 +43,14 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-RWJHZCOR.js";
+} from "./chunk-TG756AMB.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,
   StudioRig,
   deviceDimensions,
   laptopLayout
-} from "./chunk-XV2K3AQT.js";
+} from "./chunk-WONOHP4G.js";
 
 // ../execution/primitives/src/scenes/changelog-bite/index.tsx
 import {

package/dist/{chunk-H2ZZXISB.js → chunk-6D3KCUWA.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-EQH37KNZ.js";
 import {
   CueframeError
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 function assertCardHtmlAssetFree(input) {

package/dist/{chunk-BZVOCVQV.js → chunk-BLVSFN6J.js}

@@ -107,19 +107,6 @@ var ComponentSourceV2 = z.object({
   tsxSource: z.string().min(1),
   manifest: ComponentManifestV2
 }).strict();
-var ComponentSourceRefV1 = z.object({
-  version: z.literal(1),
-  sourceVersionId: z.string().regex(/^[a-f0-9]{64}$/)
-}).strict();
-var COMPONENT_SOURCE_REF_PROP = "componentRef";
-function readComponentSourceRef(props) {
-  const parsed = ComponentSourceRefV1.safeParse(props[COMPONENT_SOURCE_REF_PROP]);
-  return parsed.success ? parsed.data : null;
-}
-function authoredComponentProps(props) {
-  const { [COMPONENT_SOURCE_REF_PROP]: _reserved, ...authored } = props;
-  return authored;
-}
 var ComponentAssetBindingV2 = z.object({
   handle: z.string().min(1).max(256),
   kind: ComponentAssetKind,
@@ -306,10 +293,6 @@ export {
   ComponentManifestV2,
   CANVAS2D_COMPONENT_MANIFEST_V2,
   ComponentSourceV2,
-  ComponentSourceRefV1,
-  COMPONENT_SOURCE_REF_PROP,
-  readComponentSourceRef,
-  authoredComponentProps,
   ComponentAssetBindingV2,
   ComponentAssetInputV2,
   ComponentAssetFileV2,

package/dist/{chunk-NECN7TT4.js → chunk-BR6QZZEI.js}

@@ -1,17 +1,17 @@
 import {
   BrandKitBodySchema
-} from "./chunk-CEO47DIE.js";
+} from "./chunk-D5QWWPDL.js";
 import {
   ComponentSourceV2
-} from "./chunk-BZVOCVQV.js";
+} from "./chunk-BLVSFN6J.js";
 import {
   Composition
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 import {
   SceneShotSpecV2,
   sceneShotImageSlots,
   sceneShotVideoSlots
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 
 // ../execution/component-runtime/src/template/schema.ts
 import { z } from "zod";

package/dist/{chunk-3JEUNKDK.js → chunk-CMPRHO6D.js}

@@ -24,7 +24,7 @@ import {
 } from "./chunk-WTQRLFR2.js";
 import {
   FlexLayout
-} from "./chunk-RWJHZCOR.js";
+} from "./chunk-TG756AMB.js";
 
 // ../execution/primitives/src/layouts/chat-to-preview-layout/index.tsx
 import { Easing, interpolate, useCurrentFrame, useVideoConfig } from "remotion";

package/dist/{chunk-CEO47DIE.js → chunk-D5QWWPDL.js}

@@ -1,9 +1,9 @@
 import {
   MotifMotionPreset
-} from "./chunk-6KZCXAYL.js";
+} from "./chunk-MRLC4HLJ.js";
 import {
   GraphicRole
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 import {
   CardHtml
 } from "./chunk-EQH37KNZ.js";

package/dist/{chunk-AK6QPX7A.js → chunk-DBBKM74E.js}

@@ -8,14 +8,14 @@ import {
   componentBrowserBackend,
   componentBrowserOptions,
   readGpuAttestation
-} from "./chunk-KC4LNZL5.js";
+} from "./chunk-VSHAP22Q.js";
 import {
   sha256Hex,
   sourceVersionId
 } from "./chunk-F6PLDBAK.js";
 import {
   assertComponentImportsAllowed
-} from "./chunk-UGWJC4GA.js";
+} from "./chunk-ZTJYOHS3.js";
 import {
   ComponentCapturePageRasterAttestationV1,
   ComponentGraphicsApiV2,
@@ -25,10 +25,10 @@ import {
   ComponentStillPngContainerFactsV1,
   ComponentStillSessionAttestationV1,
   ComponentStillSessionHostAttestationV1
-} from "./chunk-BZVOCVQV.js";
+} from "./chunk-BLVSFN6J.js";
 import {
   parseSceneShotSpecV2
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 import {
   BUNDLED_FONT_FACES
 } from "./chunk-OOL7ZUG7.js";
@@ -1000,48 +1000,26 @@ function contentSecurityPolicy(assetOrigins, scriptNonce, resourceOrigin) {
     "frame-ancestors tauri: http://tauri.localhost"
   ].join("; ");
 }
-async function startComponentBundleServer(upstream, assetOrigins) {
-  const upstreamUrl = URL.canParse(upstream) ? new URL(upstream) : null;
-  if (upstreamUrl && (upstreamUrl.protocol !== "http:" || !["127.0.0.1", "localhost"].includes(upstreamUrl.hostname))) {
-    throw new Error("Live component preview requires a loopback bundle origin.");
-  }
-  const bundleRoot = upstreamUrl ? null : await realpath(upstream);
+async function startComponentBundleServer(bundleDir, assetOrigins) {
+  const bundleRoot = await realpath(bundleDir);
   const scriptNonce = randomBytes(18).toString("base64");
   const server = createServer(async (request, response) => {
     try {
-      let body;
-      let contentType = null;
-      if (upstreamUrl) {
-        const target = new URL(request.url ?? "/", upstreamUrl.origin);
-        const fetched = await fetch(target, { method: request.method });
-        response.statusCode = fetched.status;
-        contentType = fetched.headers.get("content-type");
-        for (const [name, value] of fetched.headers) {
-          if (!["content-security-policy", "content-length", "transfer-encoding"].includes(name.toLowerCase())) {
-            response.setHeader(name, value);
-          }
-        }
-        body = new Uint8Array(await fetched.arrayBuffer());
-      } else {
-        const pathname = decodeURIComponent(new URL(request.url ?? "/", "http://localhost").pathname);
-        const requested = pathname === "/" ? "index.html" : pathname.replace(/^\/+/, "");
-        const resolved = await realpath(join3(bundleRoot, requested));
-        if (resolved !== bundleRoot && !resolved.startsWith(bundleRoot + sep)) throw new Error("Invalid bundle path.");
-        body = await readFile(resolved);
-        const mime = (/* @__PURE__ */ new Map([
-          [".html", "text/html; charset=utf-8"],
-          [".js", "text/javascript; charset=utf-8"],
-          [".css", "text/css; charset=utf-8"],
-          [".json", "application/json"],
-          [".png", "image/png"],
-          [".svg", "image/svg+xml"],
-          [".woff2", "font/woff2"]
-        ])).get(extname(resolved));
-        if (mime) {
-          contentType = mime;
-          response.setHeader("Content-Type", mime);
-        }
-      }
+      const pathname = decodeURIComponent(new URL(request.url ?? "/", "http://localhost").pathname);
+      const requested = pathname === "/" ? "index.html" : pathname.replace(/^\/+/, "");
+      const resolved = await realpath(join3(bundleRoot, requested));
+      if (resolved !== bundleRoot && !resolved.startsWith(bundleRoot + sep)) throw new Error("Invalid bundle path.");
+      let body = await readFile(resolved);
+      const contentType = (/* @__PURE__ */ new Map([
+        [".html", "text/html; charset=utf-8"],
+        [".js", "text/javascript; charset=utf-8"],
+        [".css", "text/css; charset=utf-8"],
+        [".json", "application/json"],
+        [".png", "image/png"],
+        [".svg", "image/svg+xml"],
+        [".woff2", "font/woff2"]
+      ])).get(extname(resolved));
+      if (contentType) response.setHeader("Content-Type", contentType);
       if (contentType?.toLowerCase().startsWith("text/html")) {
         body = Buffer.from(Buffer.from(body).toString("utf8").replaceAll("<script>", `<script nonce="${scriptNonce}">`));
       }
@@ -1068,8 +1046,7 @@ async function startComponentBundleServer(upstream, assetOrigins) {
     server.close();
     throw new Error("Live component preview did not bind a loopback port.");
   }
-  const liveUrl = new URL(upstreamUrl ? upstreamUrl.pathname + upstreamUrl.search : "/", `http://localhost:${address.port}`);
-  liveUrl.searchParams.delete("__cueframe_live");
+  const liveUrl = new URL("/", `http://localhost:${address.port}`);
   const renderUrl = liveUrl.href;
   liveUrl.searchParams.set("__cueframe_live", "1");
   let closePromise;

package/dist/chunk-DPMS7I65.js

@@ -0,0 +1,11 @@
+// ../composition/src/depth.ts
+function isBehindSubjectDepthSource(source) {
+  if (!source || typeof source !== "object") return false;
+  const kind = source.kind;
+  if (kind !== "overlay" && kind !== "component") return false;
+  return source.zPlane === "behind-subject";
+}
+
+export {
+  isBehindSubjectDepthSource
+};

package/dist/{chunk-ONSGT6UJ.js → chunk-E2DVOSUE.js}

@@ -3,13 +3,18 @@ import {
   projectMediaPlaybackSpans,
   sliceTranscriptWords,
   splitIntoSentences
-} from "./chunk-IUJABAG2.js";
+} from "./chunk-HOQ45246.js";
+import {
+  ComponentSourceRefV1,
+  componentPinCount,
+  repinnedComponentProps
+} from "./chunk-WHYTCQYZ.js";
 import {
   createHeadlessStore,
   findClipById,
   findMarkerById,
   findTrackContainingClipId
-} from "./chunk-2K2GBFLU.js";
+} from "./chunk-Y2NR3Y6J.js";
 import {
   CaptionLayoutInput,
   CaptionSegment,
@@ -25,14 +30,14 @@ import {
   captionLayoutIssues,
   captionSegmentSignature,
   captionVisibilityIssues
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 import {
   ReframeSegment
 } from "./chunk-B7J5UUUV.js";
 import {
   SCENE_SLOT_MEDIA_FORMATS,
   SceneShotSpecV2
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 import {
   introducedCaptionFaceIssues
 } from "./chunk-OOL7ZUG7.js";
@@ -579,8 +584,8 @@ function stableSuffix(spans) {
   return spans.map((s) => `${s.candidateId}@${s.startSec.toFixed(2)}`).join("_").slice(0, 48).replace(/[^a-zA-Z0-9_@.-]/g, "");
 }
 
-// ../composition-ops/src/alphaLayers.ts
-function collectAlphaLayerClips(composition) {
+// ../composition-ops/src/componentClips.ts
+function collectComponentClips(composition) {
   const tracks = composition?.tracks;
   if (!Array.isArray(tracks)) return [];
   const out = [];
@@ -590,7 +595,7 @@ function collectAlphaLayerClips(composition) {
     for (const c of contents) {
       const src = c?.source;
       if (!src || typeof src !== "object") continue;
-      if (src.kind !== "alpha-layer") continue;
+      if (src.kind !== "component") continue;
       const componentId = src.componentId;
       const clipId = c.id;
       const startTime = c.startTime;
@@ -648,8 +653,6 @@ function deriveFromSource(sourceKind) {
       return "effect";
     case "component":
       return "overlay";
-    case "alpha-layer":
-      return "overlay";
     case "card":
       return "overlay";
     case "media":
@@ -794,6 +797,14 @@ var CompositionOp = z.discriminatedUnion("type", [
   ),
   z.object({ type: z.literal("removeExcludedRange"), clipId: z.string(), rangeIdx: z.number() }).strict().describe(
     "Server-authoritative: remove a clip's previously-added excluded range by index (re-includes that span, ripples downstream)."
+  ),
+  z.object({
+    type: z.literal("component.repin"),
+    componentId: z.string().min(1),
+    from: ComponentSourceRefV1.shape.sourceVersionId,
+    to: ComponentSourceRefV1.shape.sourceVersionId
+  }).strict().describe(
+    "Move every pin of a component at version `from` to version `to`: the clips that place it and the scene surfaces that nest it. A clip's version changes only through a composition write; a component edit issues this op over the composition it names."
   )
 ]).describe(
   "One scoped composition operation. Discriminated by `type` \u2014 `clip.add` / `clip.remove` / `clip.update` patch clips across any family; the rest cover markers, reframe, effects, captions, format, tracks, and the server-authoritative ripple recomputes. Every variant is `.strict()`: an unknown field is refused, not ignored."
@@ -975,6 +986,16 @@ function applyOpToStore(store, op) {
     case "removeExcludedRange":
       store.removeExcludedRange(op.clipId, op.rangeIdx);
       break;
+    case "component.repin": {
+      for (const track of composition.tracks) {
+        for (const clip of track.contents) {
+          if (!("source" in clip) || clip.source.kind !== "component") continue;
+          const { props, moved } = repinnedComponentProps(clip.source.componentId, clip.source.props, op);
+          if (moved > 0) store.updateClip(clip.id, { source: { ...clip.source, props } });
+        }
+      }
+      break;
+    }
     default: {
       const _exhaustive = op;
       throw new Error(`applyOp: unknown op ${_exhaustive.type}`);
@@ -1098,6 +1119,12 @@ function invertOp(before, op) {
         );
       }
       return { type: "clip.remove", clipId: op.newClipId };
+    case "component.repin": {
+      if (componentPinCount(before, op.componentId, op.to) > 0) {
+        throw new Error(`invertOp(component.repin): '${op.componentId}' was already pinned at ${op.to} in the pre-image`);
+      }
+      return { type: "component.repin", componentId: op.componentId, from: op.to, to: op.from };
+    }
     case "cutAndRipple":
     case "ripple":
     case "addExcludedRange":
@@ -1136,7 +1163,7 @@ export {
   GRID_HARD_MAX_MARKERS,
   materializeGridMarkers,
   replaceRegion,
-  collectAlphaLayerClips,
+  collectComponentClips,
   collectRawComponentClips,
   mediaFamily,
   resolveClipKind,

package/dist/{chunk-4WBSXHQA.js → chunk-EA3J5XUJ.js}

@@ -247,7 +247,7 @@ function describeClip(c) {
   } else if (s.kind === "card") {
     const tokens = Object.keys(s.tokens ?? {});
     what = `card html:${s.html?.length ?? 0}ch${tokens.length ? ` tokens:{${tokens.join(",")}}` : ""}`;
-  } else if (s.kind === "component" || s.kind === "alpha-layer") {
+  } else if (s.kind === "component") {
     what = `${s.kind} ${s.componentId ?? "?"}`;
   } else if (s.kind === "overlay") {
     what = `overlay ${s.primitiveId ?? s.overlayId ?? "?"}`;
@@ -341,7 +341,7 @@ ${JSON.stringify(r.errors ?? [], null, 2)}${warns}`;
   {
     name: "validate_composition",
     operationId: "validateComposition",
-    description: "Dry-run a full Composition object against the SAME pure, DB-free authoring guards saveComposition enforces, WITHOUT persisting it (no project needed). Checks: wire shape (Zod), primitive membership (unknown_primitive / custom_missing_sourcecode), required-param shape (invalid_primitive_params), clip\u2194track family (clip_source_track_mismatch), and reframe coverage (reframe_coverage_gap). Always returns ONE shape \u2014 200 { valid, errors, quote } \u2014 for BOTH malformed wire shapes and deep-invariant failures (so branch on `valid`, not on HTTP status); errors[] lists every problem at once as a sanitized envelope { code, stage, category, retryable, message, fix } you can fix before composing/rendering. The `quote` triple states the render price to finish from a valid composition \u2014 relay it to your human BEFORE create_render. `valid:true` means save-safe EXCEPT for the three genuinely DB-bound checks that can only run at save/render, because this tool takes no project: trim-bounds (needs the media duration), image/asset-on-a-video-track (needs the media kind), and componentId resolution (needs the installed components of YOUR org \u2014 an `alpha-layer`/`component` clip naming a component you have not created, or naming a CATALOG PRIMITIVE, passes here and is refused at save with `component_source_unavailable`). Pass the Composition as `body`.",
+    description: "Dry-run a full Composition object against the SAME pure, DB-free authoring guards saveComposition enforces, WITHOUT persisting it (no project needed). Checks: wire shape (Zod), primitive membership (unknown_primitive / custom_missing_sourcecode), required-param shape (invalid_primitive_params), clip\u2194track family (clip_source_track_mismatch), and reframe coverage (reframe_coverage_gap). Always returns ONE shape \u2014 200 { valid, errors, quote } \u2014 for BOTH malformed wire shapes and deep-invariant failures (so branch on `valid`, not on HTTP status); errors[] lists every problem at once as a sanitized envelope { code, stage, category, retryable, message, fix } you can fix before composing/rendering. The `quote` triple states the render price to finish from a valid composition \u2014 relay it to your human BEFORE create_render. `valid:true` means save-safe EXCEPT for the three genuinely DB-bound checks that can only run at save/render, because this tool takes no project: trim-bounds (needs the media duration), image/asset-on-a-video-track (needs the media kind), and componentId resolution (needs the installed components of YOUR org \u2014 a `{kind:'component', componentId, props}` clip naming a component you have not created, or naming a CATALOG PRIMITIVE, passes here and is refused at save with `component_source_unavailable`). Pass the Composition as `body`.",
     annotations: { readOnlyHint: true }
   },
   {

package/dist/{chunk-3HLDIIWA.js → chunk-F5UOF52Q.js}

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

package/dist/{chunk-I2HNC4PQ.js → chunk-FZCVNHML.js}

@@ -1,7 +1,7 @@
 import {
   bodySchemaFor,
   opById
-} from "./chunk-FZB7UX44.js";
+} from "./chunk-KEQTT67U.js";
 
 // ../mcp/src/generated/sceneContract.ts
 function deepFreeze(value) {

package/dist/{chunk-DCKADD5B.js → chunk-HEMRBFLN.js}

@@ -1,6 +1,6 @@
 import {
   CueframeError
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 import {
   bundledFontFamilyFaces,
   isGenericOnlyStack,