@cueframe/kernel 0.2.21 → 0.2.22

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

@@ -347,7 +347,82 @@ export declare function sceneShotImageSlots(spec: Pick<SceneShotSpecV2, 'layers'
 /** Distinct video media ids in first-use order, recursively through groups. */
 export declare function sceneShotVideoSlots(spec: Pick<SceneShotSpecV2, 'layers'>): string[];
 export declare function sceneShotSurfaceCount(spec: Pick<SceneShotSpecV2, 'layers'>): number;
+/**
+ * What a scene shot IS, for a caller reading the published contract.
+ *
+ * It lives HERE, on the schema, because it is generated from here into
+ * `scene/schema.json` and on into `api/openapi.json`. It used to exist only
+ * inside the published `api/openapi.json`, kept alive by the public repo's
+ * `vendor-scene-schema.mjs` reading its own previous output and writing it
+ * back — a hand-authored value surviving inside a generated artifact, which
+ * meant regenerating the contract from source would silently delete the only
+ * description of the feature.
+ */
+export declare const SCENE_SHOT_SPEC_V2_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
 /** Agent-facing schema generated from the same Zod contract used by runtime parsing. */
-export declare const sceneShotJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodType<SceneShotSpecV2, unknown, z.core.$ZodTypeInternals<SceneShotSpecV2, unknown>>>;
+export declare const sceneShotJsonSchema: {
+    description: string;
+    "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodType<SceneShotSpecV2, unknown, z.core.$ZodTypeInternals<SceneShotSpecV2, unknown>>>;
+    $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
+    $id?: string;
+    $anchor?: string;
+    $ref?: string;
+    $dynamicRef?: string;
+    $dynamicAnchor?: string;
+    $vocabulary?: Record<string, boolean>;
+    $comment?: string;
+    $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+    type?: z.core.JSONSchema.SchemaType | z.core.JSONSchema.SchemaType[];
+    additionalItems?: z.core.JSONSchema._JSONSchema;
+    unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+    prefixItems?: z.core.JSONSchema._JSONSchema[];
+    items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+    contains?: z.core.JSONSchema._JSONSchema;
+    additionalProperties?: z.core.JSONSchema._JSONSchema;
+    unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+    properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+    patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+    dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+    propertyNames?: z.core.JSONSchema._JSONSchema;
+    if?: z.core.JSONSchema._JSONSchema;
+    then?: z.core.JSONSchema._JSONSchema;
+    else?: z.core.JSONSchema._JSONSchema;
+    allOf?: z.core.JSONSchema.JSONSchema[];
+    anyOf?: z.core.JSONSchema.JSONSchema[];
+    oneOf?: z.core.JSONSchema.JSONSchema[];
+    not?: z.core.JSONSchema._JSONSchema;
+    multipleOf?: number;
+    maximum?: number;
+    exclusiveMaximum?: number | boolean;
+    minimum?: number;
+    exclusiveMinimum?: number | boolean;
+    maxLength?: number;
+    minLength?: number;
+    pattern?: string;
+    maxItems?: number;
+    minItems?: number;
+    uniqueItems?: boolean;
+    maxContains?: number;
+    minContains?: number;
+    maxProperties?: number;
+    minProperties?: number;
+    required?: string[];
+    dependentRequired?: Record<string, string[]>;
+    enum?: Array<string | number | boolean | null>;
+    const?: string | number | boolean | null;
+    id?: string;
+    title?: string;
+    default?: unknown;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    nullable?: boolean;
+    examples?: unknown[];
+    format?: string;
+    contentMediaType?: string;
+    contentEncoding?: string;
+    contentSchema?: z.core.JSONSchema.JSONSchema;
+    _prefault?: unknown;
+};
 export declare function sceneShotJsonSchemaText(): string;
 export {};

package/dist/animate/preparation-facts.js

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

package/dist/animate.js

@@ -102,7 +102,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-XUU5PK6J.js";
+} from "./chunk-DEDZKZ6G.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -161,7 +161,7 @@ import {
   studioShadowFrustum,
   verifyPhotographicStudioHdr,
   withNormalisedFaceUv
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 import {
   ALLOWED_BAKE_SCALES,
   DEFAULT_BAKE_SCALE,
@@ -183,7 +183,7 @@ import {
   projectedSlotEdges,
   sceneFocusPreparationAllocationsV1,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";

package/dist/authoring/scene.js

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

package/dist/authoring.js

@@ -4,7 +4,7 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-EGR6QWLX.js";
+} from "./chunk-E54DK225.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
@@ -67,7 +67,7 @@ import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";

package/dist/{chunk-IRVRWQWD.js → chunk-7YL7NJJF.js}

@@ -1172,10 +1172,14 @@ function sceneShotSurfaceCount(spec2) {
   });
   return count;
 }
-var sceneShotJsonSchema = z.toJSONSchema(SceneShotSpecV2Schema, {
-  target: "draft-2020-12",
-  io: "input"
-});
+var SCENE_SHOT_SPEC_V2_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
+var sceneShotJsonSchema = {
+  ...z.toJSONSchema(SceneShotSpecV2Schema, {
+    target: "draft-2020-12",
+    io: "input"
+  }),
+  description: SCENE_SHOT_SPEC_V2_DESCRIPTION
+};
 function sceneShotJsonSchemaText() {
   return `${JSON.stringify(sceneShotJsonSchema, null, 2)}
 `;
@@ -3437,6 +3441,7 @@ export {
   sceneShotImageSlots,
   sceneShotVideoSlots,
   sceneShotSurfaceCount,
+  SCENE_SHOT_SPEC_V2_DESCRIPTION,
   sceneShotJsonSchema,
   sceneShotJsonSchemaText,
   contentFrame,

package/dist/{chunk-7UVN36UK.js → chunk-BAVEHXVC.js}

@@ -2,7 +2,10 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-OTZDVUAM.js";
+} from "./chunk-NG7DP46H.js";
+import {
+  CURATED_TOOLS
+} from "./chunk-DJWCD3RF.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -19,10 +22,7 @@ import {
   sniffImageMediaType,
   text,
   withMedia
-} from "./chunk-STTZC7NN.js";
-import {
-  CURATED_TOOLS
-} from "./chunk-DFAESPHN.js";
+} from "./chunk-URQQTAHZ.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -2948,7 +2948,8 @@ var SCENE_SHOT_SCHEMA = deepFreeze({
         }
       ]
     }
-  }
+  },
+  "description": "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path."
 });
 var SCENE_SHOT_SCHEMA_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
 var SCENE_SHOT_EXAMPLE_SHOTS = deepFreeze([

package/dist/{chunk-PSMIDGQA.js → chunk-CDZBSLVA.js}

@@ -15,7 +15,7 @@ import {
   componentBrowserBackend,
   componentBrowserOptions,
   readGpuAttestation
-} from "./chunk-BWLYZQ7I.js";
+} from "./chunk-VDSO2KZY.js";
 import {
   ComponentCapturePageRasterAttestationV1,
   ComponentGraphicsApiV2,
@@ -28,7 +28,7 @@ import {
 } from "./chunk-ZVG446DJ.js";
 import {
   parseSceneShotSpecV2
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   BUNDLED_FONT_FACES
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-XUU5PK6J.js → chunk-DEDZKZ6G.js}

@@ -19,7 +19,7 @@ import {
   slabTriangleCount,
   takeSceneEnvironment,
   useSceneActualResourceRegistrarV1
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 import {
   PHOTOGRAPHIC_STUDIO_RIG_ID,
   SCENE_SLAB_CONTENT_OFFSET,
@@ -31,7 +31,7 @@ import {
   sceneTextureBytes,
   sceneVideoMidpointAddressV1,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   resolveCaptionFaces
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-DFAESPHN.js → chunk-DJWCD3RF.js}

@@ -639,10 +639,16 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
     },
     annotations: { readOnlyHint: true }
   },
+  {
+    name: "list_render_fonts",
+    operationId: "listRenderFonts",
+    description: "The fonts the RENDERER can actually draw \u2014 read this BEFORE authoring type, not after a refusal. Per family: the exact family name authoring accepts, the weight RANGES a shipped file declares (a static face has min===max; a variable face gives its axis range), the caption default weights, and whether the bytes are bundled or an aliased metric-compatible stand-in. Anything listed here passes validation by construction: it is derived from the same table the font gate refuses by. Two facts worth reading off it \u2014 every family's `styles` is [\"normal\"], because NO bundled family ships an italic FILE (a real italic comes only from a brand-kit font asset), and a weight outside every range is REFUSED, never synthesised. Contrast search_fonts, which searches the GOOGLE catalog and will happily return families the renderer cannot draw. `manifestVersion` identifies this exact face table; record it beside a composition to state what a font choice was validated against. Covers the bundled set only \u2014 a brand kit's sealed faces are per-org and per-render. No args, read-only, free.",
+    annotations: { readOnlyHint: true }
+  },
   {
     name: "search_fonts",
     operationId: "searchFonts",
-    description: "Search web font families by name/style \u2014 returns family names to use in composition/component params. Pass query (+ optional perPage \u226450). Read-only + free; surfaces the Google Fonts catalog (family + category + variants + css2 stylesheet URL). IMPORTANT: this searches the GOOGLE catalog, not what the render can actually draw. Only the faces vendored into the render page are guaranteed to rasterize; naming any other family gets you the generic fallback (Liberation Sans) with no error. create_render returns a `font_not_available` warning naming the guaranteed set \u2014 treat that set, not this catalog, as the list you may choose from. An empty result set here means no match, or the upstream catalog was unavailable.",
+    description: "Search web font families by name/style \u2014 returns family names to use in composition/component params. Pass query (+ optional perPage \u226450). Read-only + free; surfaces the Google Fonts catalog (family + category + variants + css2 stylesheet URL). IMPORTANT: this searches the GOOGLE catalog, not what the render can actually draw. Only the faces vendored into the render page are guaranteed to rasterize; naming any other family gets you the generic fallback (Liberation Sans) with no error. Call list_render_fonts for the set you may actually choose from, WITH the admitted weights per family \u2014 treat that, not this catalog, as the list. An empty result set here means no match, or the upstream catalog was unavailable.",
     okFormat: (j) => `${(j.results || []).length} fonts: ${(j.results || []).map((r) => r.family).slice(0, 10).join(", ")}`,
     annotations: { readOnlyHint: true }
   },

package/dist/{chunk-EGR6QWLX.js → chunk-E54DK225.js}

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

package/dist/{chunk-TWI22U3C.js → chunk-LD4XQQRL.js}

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

package/dist/{chunk-OTZDVUAM.js → chunk-NG7DP46H.js}

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

package/dist/{chunk-WDJGMAZK.js → chunk-PQDALM2G.js}

@@ -7,10 +7,6 @@ import {
   flattenCompoundClips,
   hasCompoundClips
 } from "./chunk-QISFYLBB.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -29,6 +25,10 @@ import {
   segmentShots,
   stabilizeSelectionHysteresis
 } from "./chunk-K4VE64CR.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -51,7 +51,7 @@ import {
   sceneFullMipLevels,
   sceneTextureBytes,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   SCENE_CONTEXT_GL_BUDGET_BYTES,
   SCENE_MAX_TRIANGLES,

package/dist/{chunk-VHCP4OLA.js → chunk-PRSRV7AT.js}

@@ -1,3 +1,7 @@
+import {
+  frostedGlassWipe,
+  spatialPush
+} from "./chunk-QGAWDLYX.js";
 import {
   DashboardPopulate
 } from "./chunk-S5H6GH6M.js";
@@ -7,10 +11,6 @@ import {
 import {
   EASING_BY_INTENT
 } from "./chunk-MFHXCHRI.js";
-import {
-  frostedGlassWipe,
-  spatialPush
-} from "./chunk-QGAWDLYX.js";
 import {
   ACCENT,
   ACCENT_SOFT,
@@ -43,14 +43,14 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-XUU5PK6J.js";
+} from "./chunk-DEDZKZ6G.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,
   StudioRig,
   deviceDimensions,
   laptopLayout
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 
 // ../execution/primitives/src/scenes/changelog-bite/index.tsx
 import {

package/dist/{chunk-OAVJUZIC.js → chunk-TZ7DKL2G.js}

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