@cueframe/kernel 0.2.4 → 0.2.6

package/dist/_members/component-runtime/bake.d.ts

@@ -1,5 +1,7 @@
 import { type ComponentBakeRequestV2 as BakeRequest, type ComponentBakeJobV2 as BakeJob, type ComponentRenderReceiptV2 as RenderReceipt } from './contracts.js';
+import { startComponentAssetServer } from './assetServer.js';
 import { type ComponentRenderTiming } from './render.js';
+import { materializeComponentSource } from './sourceWorkspace.js';
 export declare function assertAssetBindingsMatch(request: Pick<BakeRequest, 'source' | 'assets'>): void;
 export declare function bakeComponentAlphaV2(options: {
     job: BakeJob;
@@ -9,6 +11,18 @@ export declare function bakeComponentAlphaV2(options: {
     ffprobeExecutable?: string;
     ffmpegExecutable?: string;
     concurrency?: number;
+    /** Host-owned scene preparation runs after verified assets and source staging.
+     * The runtime owns the lease until rendering finishes (including failures).
+     */
+    prepareScene?: (input: {
+        request: BakeRequest;
+        materialized: ReturnType<typeof materializeComponentSource>;
+        runtimeAssets: Awaited<ReturnType<typeof startComponentAssetServer>>['runtimeAssets'];
+        allowedAssetOrigins: Set<string>;
+    }) => Promise<{
+        params: Record<string, unknown>;
+        cleanup(): Promise<void>;
+    }>;
     onProgress?: (progress: {
         renderedFrames: number;
         encodedFrames: number;

package/dist/_members/component-runtime/bake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../src/bake.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,sBAAsB,IAAI,WAAW,EAC1C,KAAK,kBAAkB,IAAI,OAAO,EAClC,KAAK,wBAAwB,IAAI,aAAa,EAC/C,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAK/E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC9C,IAAI,CAkCN;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACpD,GAAG,OAAO,CAAC,aAAa,CAAC,CAoGzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAElE"}
+{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../src/bake.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,sBAAsB,IAAI,WAAW,EAC1C,KAAK,kBAAkB,IAAI,OAAO,EAClC,KAAK,wBAAwB,IAAI,aAAa,EAC/C,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAS7D,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGlE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC9C,IAAI,CAkCN;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QACrB,OAAO,EAAE,WAAW,CAAC;QACrB,YAAY,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;QAC5D,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACtF,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KAClC,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;IAC7E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACpD,GAAG,OAAO,CAAC,aAAa,CAAC,CAgHzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAElE"}

package/dist/_members/composition/scene/clipRules.d.ts

@@ -64,7 +64,7 @@ export interface SceneClipRuleContext {
     /** Composition frame rate; clip timing must sit on its frame lattice. */
     fps: number;
     resolveSource: SceneSourceResolver;
-    /** When supplied, bound media must exist here and be `image`. */
+    /** When supplied, bound media must exist here and match the surface kind. */
     mediaKindById?: Record<string, string>;
 }
 /** True when `seconds` is not a whole number of frames at `fps`. */

package/dist/_members/render-harness/prepareSceneBake.d.ts

@@ -0,0 +1,5 @@
+import { type bakeComponentAlphaV2 } from '../component-runtime/index.js';
+type PrepareScene = NonNullable<Parameters<typeof bakeComponentAlphaV2>[0]['prepareScene']>;
+export declare function createNodeSceneBakePreparation(renderEntryRoot?: string): PrepareScene;
+export {};
+//# sourceMappingURL=prepareSceneBake.d.ts.map

package/dist/_members/render-harness/prepareSceneBake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareSceneBake.d.ts","sourceRoot":"","sources":["../src/prepareSceneBake.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnG,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;AAE5F,wBAAgB,8BAA8B,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,YAAY,CAqDrF"}

package/dist/animate/preparation-facts.js

@@ -4,11 +4,11 @@ import {
   sceneGrainPreparationCpuAllocationV1,
   scenePresetBuilderDescriptorV1,
   sceneSlabPreparationFactsV1
-} from "../chunk-VKATKWWR.js";
+} from "../chunk-JDOO6GTW.js";
 import {
   photographicStudioPreparationFactsV1,
   sceneFocusPreparationAllocationsV1
-} from "../chunk-MH3UPKWR.js";
+} from "../chunk-M2CXETU3.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/animate.js

@@ -101,7 +101,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-5DJ3IEJR.js";
+} from "./chunk-M5QETDOL.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -160,7 +160,7 @@ import {
   studioShadowFrustum,
   verifyPhotographicStudioHdr,
   withNormalisedFaceUv
-} from "./chunk-VKATKWWR.js";
+} from "./chunk-JDOO6GTW.js";
 import "./chunk-TARKDVP6.js";
 import {
   ALLOWED_BAKE_SCALES,
@@ -183,7 +183,7 @@ import {
   projectedSlotEdges,
   sceneFocusPreparationAllocationsV1,
   selectSceneBakeScale
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-2ESYSVXG.js";
 export {

package/dist/authoring/scene.js

@@ -13,7 +13,7 @@ import {
   sceneTrackIdFor,
   validateSceneAdd,
   validateSceneUpdate
-} from "../chunk-QS36DMFG.js";
+} from "../chunk-SKQR5KAL.js";
 import {
   SCENE_TRANSITION_KINDS,
   collectSceneClipIssues,
@@ -22,7 +22,7 @@ import {
   offFrameLattice,
   readSceneSourceRef,
   sceneClipShapeIssues
-} from "../chunk-MH3UPKWR.js";
+} from "../chunk-M2CXETU3.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring.js

@@ -4,7 +4,7 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-QS36DMFG.js";
+} from "./chunk-SKQR5KAL.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
@@ -68,7 +68,7 @@ import "./chunk-TARKDVP6.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-2ESYSVXG.js";
 

package/dist/{chunk-E7GIZEPS.js → chunk-3V75A6UH.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-6BVVCRRD.js";
+} from "./chunk-TECEMBCI.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-EBIBLL7E.js → chunk-6FIJJ6GN.js}

@@ -2,7 +2,7 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-E7GIZEPS.js";
+} from "./chunk-3V75A6UH.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -19,10 +19,10 @@ import {
   sniffImageMediaType,
   text,
   withMedia
-} from "./chunk-6BVVCRRD.js";
+} from "./chunk-TECEMBCI.js";
 import {
   CURATED_TOOLS
-} from "./chunk-UN6NY2E6.js";
+} from "./chunk-SC55VDLC.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;

package/dist/{chunk-6EWRIAZA.js → chunk-ARCGJUCQ.js}

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

package/dist/{chunk-WIHXXF3X.js → chunk-DHL55ZBJ.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-ZVG446DJ.js";
 import {
   STUDIO_SHADOW_MAP_BUDGET
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 
 // ../execution/component-runtime/src/webglProbe.ts
 var FEATURE_OFF = /(^|_)off(?:_ok)?$|^(?:unavailable|disabled)$/;

package/dist/{chunk-DQLYWNLC.js → chunk-GP2SCGCH.js}

@@ -15,7 +15,7 @@ import {
   componentBrowserBackend,
   componentBrowserOptions,
   readGpuAttestation
-} from "./chunk-WIHXXF3X.js";
+} from "./chunk-DHL55ZBJ.js";
 import {
   ComponentCapturePageRasterAttestationV1,
   ComponentGraphicsApiV2,
@@ -28,7 +28,7 @@ import {
 } from "./chunk-ZVG446DJ.js";
 import {
   parseSceneShotSpecV2
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 
 // ../execution/component-runtime/src/sceneAdmission.ts
 import { ZodError } from "zod";

package/dist/{chunk-VKATKWWR.js → chunk-JDOO6GTW.js}

@@ -18,7 +18,7 @@ import {
   sceneW5GeneratedRigAllocationsV1,
   sceneW5PresetAllocationsV1,
   sceneW5WorldTextAllocationsV1
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 
 // ../execution/animate/src/three/toneMapping.ts
 import {

package/dist/{chunk-7W6ZIKWV.js → chunk-LNGDWWYU.js}

@@ -26,7 +26,7 @@ import {
   perspectiveFor,
   resolveCamera,
   useStage
-} from "./chunk-5DJ3IEJR.js";
+} from "./chunk-M5QETDOL.js";
 
 // ../execution/primitives/src/effects/blur/index.tsx
 import React2 from "react";

package/dist/{chunk-I5QWBM3M.js → chunk-LO6X2NMI.js}

@@ -43,14 +43,14 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-5DJ3IEJR.js";
+} from "./chunk-M5QETDOL.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,
   StudioRig,
   deviceDimensions,
   laptopLayout
-} from "./chunk-VKATKWWR.js";
+} from "./chunk-JDOO6GTW.js";
 
 // ../execution/primitives/src/scenes/changelog-bite/index.tsx
 import {

package/dist/{chunk-MH3UPKWR.js → chunk-M2CXETU3.js}

@@ -1296,7 +1296,7 @@ function slotOwner(spec2, slot) {
     for (const layer of layers) {
       if ("surfaces" in layer && layer.surfaces !== void 0) {
         for (const binding of Object.values(layer.surfaces)) {
-          if (binding.source === "image" && binding.assetSlot === slot) return layer.id;
+          if (binding.source === "image" && binding.assetSlot === slot || binding.source === "video" && binding.mediaId === slot) return layer.id;
         }
       }
       if (layer.kind === "group") {
@@ -1377,12 +1377,24 @@ function sceneSpecIssues(value, path) {
 }
 function bindingIssues(spec2, assets, path, mediaKindById) {
   const issues = [];
-  const slots = sceneShotImageSlots(spec2);
-  for (const slot of slots) {
+  const images = sceneShotImageSlots(spec2);
+  const videos = sceneShotVideoSlots(spec2);
+  const slots = new Map([
+    ...images.map((slot) => [slot, "image"]),
+    ...videos.map((slot) => [slot, "video"])
+  ]);
+  for (const slot of images.filter((slot2) => videos.includes(slot2))) {
+    issues.push({
+      path: `${path}.${slot}`,
+      code: "validation_error",
+      detail: `slot '${slot}' is used by both image and video surfaces; use distinct slot names.`
+    });
+  }
+  for (const [slot, kind] of slots) {
     if (typeof assets[slot] === "string" && assets[slot].length > 0) continue;
     issues.push({
       path: `${path}.${slot}`,
-      detail: `slot '${slot}' is referenced by layer '${slotOwner(spec2, slot)}' but not bound; bind it to an image media id.`,
+      detail: `slot '${slot}' is referenced by layer '${slotOwner(spec2, slot)}' but not bound; bind it to ${kind === "image" ? "an image" : "a video"} media id.`,
       code: "validation_error"
     });
   }
@@ -1391,7 +1403,7 @@ function bindingIssues(spec2, assets, path, mediaKindById) {
       issues.push({ path: `${path}.${name}`, detail: `'${name}' is not a valid slot name.`, code: "validation_error" });
       continue;
     }
-    if (!slots.includes(name)) {
+    if (!slots.has(name)) {
       issues.push({
         path: `${path}.${name}`,
         detail: `no layer references slot '${name}'; remove the binding or reference the slot from a layer.`,
@@ -1403,10 +1415,10 @@ function bindingIssues(spec2, assets, path, mediaKindById) {
     const kind = mediaKindById[mediaId];
     if (kind === void 0) {
       issues.push({ path: `${path}.${name}`, detail: `media '${mediaId}' is not in this project.`, code: "validation_error" });
-    } else if (kind !== "image") {
+    } else if (kind !== slots.get(name)) {
       issues.push({
         path: `${path}.${name}`,
-        detail: `slot '${name}' needs image media (PNG, JPEG or WebP); '${mediaId}' is ${kind}.`,
+        detail: `slot '${name}' needs ${slots.get(name)} media (${slots.get(name) === "image" ? "PNG, JPEG or WebP" : "MP4 or WebM"}); '${mediaId}' is ${kind}.`,
         code: "validation_error"
       });
     }

package/dist/{chunk-5DJ3IEJR.js → chunk-M5QETDOL.js}

@@ -19,7 +19,7 @@ import {
   slabTriangleCount,
   takeSceneEnvironment,
   useSceneActualResourceRegistrarV1
-} from "./chunk-VKATKWWR.js";
+} from "./chunk-JDOO6GTW.js";
 import {
   resolveCaptionFaces
 } from "./chunk-TARKDVP6.js";
@@ -34,7 +34,7 @@ import {
   sceneTextureBytes,
   sceneVideoMidpointAddressV1,
   selectSceneBakeScale
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 
 // ../execution/animate/src/easing/smooth.ts
 var sigmoid = (x) => 1 / (1 + Math.exp(-x));

package/dist/{chunk-UN6NY2E6.js → chunk-SC55VDLC.js}

@@ -310,7 +310,7 @@ Call wait_job(kind="compose", id="${j.composeJobId}", projectId="${a.projectId}"
     name: "apply_composition",
     operationId: "applyComposition",
     pathArgs: { projectId: "id" },
-    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / PATCH /projects/:id with brandKitId). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, a copyable two-shot example with its asset-binding map, the admitted image formats (PNG/JPEG/WebP), the reference-aspect rule, screen-vs-world text, the v1 limits and the global-effect scope gap.',
+    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / PATCH /projects/:id with brandKitId). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {

package/dist/{chunk-QS36DMFG.js → chunk-SKQR5KAL.js}

@@ -8,7 +8,7 @@ import {
   sceneShotImageSlots,
   sceneShotVideoSlots,
   sceneSpecIssues
-} from "./chunk-MH3UPKWR.js";
+} from "./chunk-M2CXETU3.js";
 
 // ../authoring/src/scene/validate.ts
 var SceneAuthoringError = class extends Error {