@cueframe/kernel 0.2.19 → 0.2.21

package/dist/_members/composition/fonts/bundledFaces.d.ts

@@ -163,3 +163,52 @@ export declare function bundledFamilyForStack(stack: string | undefined | null):
  * overlay param, with a message calling the whole stack "not a bundled family".
  */
 export declare function admissibleFamilyForStack(stack: string): string;
+/** One family in the read-only renderer font catalogue. */
+export interface VendoredFontCatalogEntry {
+    /** The family name authoring accepts VERBATIM — card, caption and scene text alike. */
+    readonly family: string;
+    /**
+     * The weights a file actually declares, as `{ min, max }` per file. A static face is
+     * `min === max`; a variable face is its declared `wght` axis range. Any weight inside a
+     * range is drawable; anything outside every range is refused, never synthesised.
+     */
+    readonly weights: ReadonlyArray<{
+        readonly min: number;
+        readonly max: number;
+    }>;
+    /**
+     * The styles bytes exist for. Always `["normal"]`: no bundled or aliased family ships an
+     * italic file, so `fontStyle: "italic"` over one is refused rather than slanted.
+     */
+    readonly styles: readonly ["normal"];
+    /** The weights a caption is drawn at when the style names none. */
+    readonly captionDefaults: CaptionFaceDefaults;
+    /**
+     * `bundled` = bytes ship inside the render bundle. `aliased` = a metric-compatible binary
+     * stands in for the named family (Georgia is served by Gelasio).
+     */
+    readonly origin: "bundled" | "aliased";
+}
+/** The read-only renderer font catalogue. */
+export interface VendoredFontCatalog {
+    /**
+     * Identifies this exact face table. Derived from the table's own content, so it moves when and
+     * only when the admitted set moves — there is no version to forget to bump. Pin it beside a
+     * composition to record which face table a choice was validated against.
+     */
+    readonly manifestVersion: string;
+    readonly families: readonly VendoredFontCatalogEntry[];
+}
+/**
+ * The renderer's admitted font set, as data.
+ *
+ * A PROJECTION of `BUNDLED_FONT_FACES` — the same table `bundledFontFaceExists` refuses by — so
+ * every family/weight this returns passes authoring by construction rather than because two lists
+ * were kept in sync. Without it the admitted set was discoverable only by being refused, which
+ * made an unavailable family visible for the first time at the paid render boundary (CUE-20).
+ *
+ * Covers the BUNDLED set only. A brand kit's sealed faces are per-org and per-render and are not
+ * knowable from a static table; `origin` says which case each entry is so a caller never has to
+ * guess whether a family is universal or came from its own kit.
+ */
+export declare function vendoredFontCatalog(): VendoredFontCatalog;

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

@@ -264,13 +264,11 @@ export type SceneChannelTargetV2 = {
 };
 export interface SceneChannelV2 {
     target: SceneChannelTargetV2;
-    property: string;
+    property: SceneChannelProperty;
     keyframes: SceneKeyframeV2[];
 }
 export declare const SceneEasingV2: z.ZodType<SceneEasingV2>;
 export declare const SceneKeyframeV2: z.ZodType<SceneKeyframeV2>;
-export declare const SceneChannelTargetV2: z.ZodType<SceneChannelTargetV2>;
-export declare const SceneChannelV2: z.ZodType<SceneChannelV2>;
 export declare const SCENE_CAMERA_PROPERTIES: readonly ["positionX", "positionY", "positionZ", "rotationX", "rotationY", "rotationZ", "fov"];
 export declare const SCENE_WORLD_OBJECT_PROPERTIES: readonly ["positionX", "positionY", "positionZ", "rotationX", "rotationY", "rotationZ", "scale", "opacity"];
 export declare const SCENE_LAPTOP_PROPERTIES: readonly ["positionX", "positionY", "positionZ", "rotationX", "rotationY", "rotationZ", "scale", "opacity", "openAngle"];
@@ -278,6 +276,10 @@ export declare const SCENE_SCREEN_TEXT_PROPERTIES: readonly ["x", "y", "rotation
 export declare const SCENE_ENVIRONMENT_PROPERTIES: readonly ["intensity"];
 export declare const SCENE_FOCUS_PROPERTIES: readonly ["distance", "range", "maxBlur"];
 export declare const SCENE_CHANNEL_PROPERTIES: readonly ("x" | "y" | "opacity" | "scale" | "rotation" | "intensity" | "fov" | "range" | "maxBlur" | "openAngle" | "distance" | "positionX" | "positionY" | "positionZ" | "rotationX" | "rotationY" | "rotationZ")[];
+/** Every channel name any target can animate — the union the wire schema publishes. */
+export type SceneChannelProperty = (typeof SCENE_CHANNEL_PROPERTIES)[number];
+export declare const SceneChannelTargetV2: z.ZodType<SceneChannelTargetV2>;
+export declare const SceneChannelV2: z.ZodType<SceneChannelV2>;
 export interface SceneFocusV2 {
     distance: number;
     range: number;

package/dist/_members/errors/registry.d.ts

@@ -349,6 +349,12 @@ export declare const ERROR_CODES: {
         readonly retryable: false;
         readonly httpStatus: 422;
     };
+    readonly composition_too_large: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 413;
+    };
     readonly overlapping_hero_overlays: {
         readonly stage: "validate";
         readonly category: "authoring";

package/dist/_members/mcp/generated/sceneContract.d.ts

@@ -24,6 +24,12 @@ export declare const SCENE_SHOT_EXAMPLE_SHOTS: readonly [{
     readonly title: "World objects";
     readonly summary: "Nested satin card and fitted page.";
     readonly slots: readonly ["page"];
+}, {
+    readonly clipId: "shot-camera-tunnel";
+    readonly exampleId: "camera-tunnel";
+    readonly title: "Camera travel through depth bands";
+    readonly summary: "Camera positionZ forward travel plus lateral positionX, over three image planes each animating positionZ at its own rate.";
+    readonly slots: readonly ["near", "mid", "far"];
 }];
 /**
  * A complete `apply_composition` body: one slab-heavy nested world-object shot on a dedicated
@@ -151,5 +157,188 @@ export declare const SCENE_SHOT_WORLD_OBJECT_BODY: {
         readonly assets: {
             readonly page: "<updatedLandingPageScreenshotMediaId>";
         };
+    }, {
+        readonly type: "scene.add";
+        readonly clipId: "shot-camera-tunnel";
+        readonly newTrack: true;
+        readonly startTime: 0;
+        readonly duration: 5;
+        readonly scene: {
+            readonly version: 2;
+            readonly referenceSize: {
+                readonly width: 1920;
+                readonly height: 1080;
+            };
+            readonly environment: {
+                readonly kind: "photographic-studio-v1";
+            };
+            readonly backdrop: {
+                readonly kind: "solid";
+                readonly color: "$brand:colors.background";
+            };
+            readonly layers: readonly [{
+                readonly kind: "page";
+                readonly id: "near";
+                readonly transform: {
+                    readonly position: readonly [-320, 0, 600];
+                    readonly rotation: readonly [0, 0, 0];
+                    readonly scale: 1;
+                };
+                readonly opacity: 1;
+                readonly width: 720;
+                readonly height: 900;
+                readonly fit: "contain";
+                readonly transparency: "straight";
+                readonly depthWrite: true;
+                readonly backface: "hidden";
+                readonly surfaces: {
+                    readonly content: {
+                        readonly source: "image";
+                        readonly assetSlot: "near";
+                    };
+                };
+            }, {
+                readonly kind: "page";
+                readonly id: "mid";
+                readonly transform: {
+                    readonly position: readonly [280, 0, -200];
+                    readonly rotation: readonly [0, 0, 0];
+                    readonly scale: 1;
+                };
+                readonly opacity: 1;
+                readonly width: 720;
+                readonly height: 900;
+                readonly fit: "contain";
+                readonly transparency: "straight";
+                readonly depthWrite: true;
+                readonly backface: "hidden";
+                readonly surfaces: {
+                    readonly content: {
+                        readonly source: "image";
+                        readonly assetSlot: "mid";
+                    };
+                };
+            }, {
+                readonly kind: "page";
+                readonly id: "far";
+                readonly transform: {
+                    readonly position: readonly [-160, 0, -1200];
+                    readonly rotation: readonly [0, 0, 0];
+                    readonly scale: 1;
+                };
+                readonly opacity: 1;
+                readonly width: 720;
+                readonly height: 900;
+                readonly fit: "contain";
+                readonly transparency: "straight";
+                readonly depthWrite: true;
+                readonly backface: "hidden";
+                readonly surfaces: {
+                    readonly content: {
+                        readonly source: "image";
+                        readonly assetSlot: "far";
+                    };
+                };
+            }];
+            readonly animation: readonly [{
+                readonly target: {
+                    readonly kind: "camera";
+                };
+                readonly property: "positionZ";
+                readonly keyframes: readonly [{
+                    readonly at: 0;
+                    readonly value: 1800;
+                }, {
+                    readonly at: 1;
+                    readonly value: -900;
+                    readonly easing: {
+                        readonly kind: "bezier";
+                        readonly x1: 0.4;
+                        readonly y1: 0;
+                        readonly x2: 0.2;
+                        readonly y2: 1;
+                    };
+                }];
+            }, {
+                readonly target: {
+                    readonly kind: "camera";
+                };
+                readonly property: "positionX";
+                readonly keyframes: readonly [{
+                    readonly at: 0;
+                    readonly value: -240;
+                }, {
+                    readonly at: 1;
+                    readonly value: 240;
+                    readonly easing: {
+                        readonly kind: "linear";
+                    };
+                }];
+            }, {
+                readonly target: {
+                    readonly kind: "layer";
+                    readonly layerId: "near";
+                };
+                readonly property: "positionZ";
+                readonly keyframes: readonly [{
+                    readonly at: 0;
+                    readonly value: 600;
+                }, {
+                    readonly at: 1;
+                    readonly value: 1500;
+                    readonly easing: {
+                        readonly kind: "linear";
+                    };
+                }];
+            }, {
+                readonly target: {
+                    readonly kind: "layer";
+                    readonly layerId: "mid";
+                };
+                readonly property: "positionZ";
+                readonly keyframes: readonly [{
+                    readonly at: 0;
+                    readonly value: -200;
+                }, {
+                    readonly at: 1;
+                    readonly value: 260;
+                    readonly easing: {
+                        readonly kind: "linear";
+                    };
+                }];
+            }, {
+                readonly target: {
+                    readonly kind: "layer";
+                    readonly layerId: "far";
+                };
+                readonly property: "positionZ";
+                readonly keyframes: readonly [{
+                    readonly at: 0;
+                    readonly value: -1200;
+                }, {
+                    readonly at: 1;
+                    readonly value: -1020;
+                    readonly easing: {
+                        readonly kind: "linear";
+                    };
+                }];
+            }];
+            readonly post: {
+                readonly grain: 0;
+                readonly vignette: 0;
+                readonly focus: null;
+            };
+            readonly constraints: readonly [];
+            readonly camera: {
+                readonly position: readonly [0, 0, 1483.6378065054962];
+                readonly rotation: readonly [0, 0, 0];
+                readonly fov: 0.6981317007977318;
+            };
+        };
+        readonly assets: {
+            readonly near: "<nearPlaneScreenshotMediaId>";
+            readonly mid: "<midPlaneScreenshotMediaId>";
+            readonly far: "<farPlaneScreenshotMediaId>";
+        };
     }];
 };

package/dist/animate/preparation-facts.js

@@ -4,11 +4,11 @@ import {
   sceneGrainPreparationCpuAllocationV1,
   scenePresetBuilderDescriptorV1,
   sceneSlabPreparationFactsV1
-} from "../chunk-77TLECRC.js";
+} from "../chunk-OAVJUZIC.js";
 import {
   photographicStudioPreparationFactsV1,
   sceneFocusPreparationAllocationsV1
-} from "../chunk-KKV5U5EA.js";
+} from "../chunk-IRVRWQWD.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/animate.js

@@ -102,7 +102,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-ZYGUHMX6.js";
+} from "./chunk-XUU5PK6J.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -161,7 +161,7 @@ import {
   studioShadowFrustum,
   verifyPhotographicStudioHdr,
   withNormalisedFaceUv
-} from "./chunk-77TLECRC.js";
+} from "./chunk-OAVJUZIC.js";
 import {
   ALLOWED_BAKE_SCALES,
   DEFAULT_BAKE_SCALE,
@@ -183,9 +183,9 @@ import {
   projectedSlotEdges,
   sceneFocusPreparationAllocationsV1,
   selectSceneBakeScale
-} from "./chunk-KKV5U5EA.js";
+} from "./chunk-IRVRWQWD.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-BAC7DKQZ.js";
+import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ALLOWED_BAKE_SCALES,

package/dist/authoring/build-tools.js

@@ -4,19 +4,19 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-KBLQKH3T.js";
-import "../chunk-KYOVOZQC.js";
+} from "../chunk-6A6AYPWO.js";
+import "../chunk-HLW3P5ZP.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-HGBHJL7X.js";
-import "../chunk-7S73F5E6.js";
-import "../chunk-IQ7DKM5C.js";
+import "../chunk-CMC6MLR3.js";
+import "../chunk-EGNTUGAM.js";
+import "../chunk-AYZPTH7L.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
-import "../chunk-BAC7DKQZ.js";
+import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ZERO_USAGE,

package/dist/authoring/context.js

@@ -1,14 +1,14 @@
 import {
   buildDirectorContext
-} from "../chunk-7NQRYZCT.js";
-import "../chunk-HGBHJL7X.js";
-import "../chunk-7S73F5E6.js";
-import "../chunk-IQ7DKM5C.js";
+} from "../chunk-6VTNIYSR.js";
+import "../chunk-CMC6MLR3.js";
+import "../chunk-EGNTUGAM.js";
+import "../chunk-AYZPTH7L.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-BAC7DKQZ.js";
+import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   buildDirectorContext

package/dist/authoring/scene.js

@@ -13,7 +13,7 @@ import {
   sceneTrackIdFor,
   validateSceneAdd,
   validateSceneUpdate
-} from "../chunk-IAZYJB3I.js";
+} from "../chunk-EGR6QWLX.js";
 import {
   SCENE_TRANSITION_KINDS,
   collectSceneClipIssues,
@@ -22,7 +22,7 @@ import {
   offFrameLattice,
   readSceneSourceRef,
   sceneClipShapeIssues
-} from "../chunk-KKV5U5EA.js";
+} from "../chunk-IRVRWQWD.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring/tools.js

@@ -6,18 +6,18 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-KYOVOZQC.js";
+} from "../chunk-HLW3P5ZP.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-HGBHJL7X.js";
-import "../chunk-7S73F5E6.js";
-import "../chunk-IQ7DKM5C.js";
+import "../chunk-CMC6MLR3.js";
+import "../chunk-EGNTUGAM.js";
+import "../chunk-AYZPTH7L.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
-import "../chunk-BAC7DKQZ.js";
+import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   COMPOSE_MOTION_TOOLS,

package/dist/authoring.js

@@ -4,14 +4,14 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-IAZYJB3I.js";
+} from "./chunk-EGR6QWLX.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-KBLQKH3T.js";
+} from "./chunk-6A6AYPWO.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-KYOVOZQC.js";
+} from "./chunk-HLW3P5ZP.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-7NQRYZCT.js";
+} from "./chunk-6VTNIYSR.js";
 import {
   buildFastModel,
   buildModel,
@@ -48,28 +48,28 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-TDJNQVTL.js";
+import "./chunk-MNPKGS7X.js";
 import {
   cssLayoutVars
-} from "./chunk-MAD6MSXA.js";
+} from "./chunk-W5W3FDDI.js";
 import "./chunk-ILO4NEZ3.js";
 import "./chunk-7AZLFN26.js";
 import "./chunk-VG2ND6PX.js";
-import "./chunk-HGBHJL7X.js";
-import "./chunk-7S73F5E6.js";
-import "./chunk-IQ7DKM5C.js";
+import "./chunk-CMC6MLR3.js";
+import "./chunk-EGNTUGAM.js";
+import "./chunk-AYZPTH7L.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-CHWA3TQM.js";
+import "./chunk-QWXUYVHX.js";
 import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip
-} from "./chunk-KKV5U5EA.js";
+} from "./chunk-IRVRWQWD.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-BAC7DKQZ.js";
+import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts

package/dist/{chunk-KBLQKH3T.js → chunk-6A6AYPWO.js}

@@ -2,7 +2,7 @@ import {
   COMPOSE_PLANNER_TOOLS,
   COMPOSE_ROLE_TOOLS,
   dispatchComposeRoleTool
-} from "./chunk-KYOVOZQC.js";
+} from "./chunk-HLW3P5ZP.js";
 
 // ../authoring/src/agent/buildTools.ts
 import { tool } from "ai";

package/dist/{chunk-7NQRYZCT.js → chunk-6VTNIYSR.js}

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