@cueframe/kernel 0.2.15 → 0.2.17

package/dist/_members/animate/index.d.ts

@@ -17,7 +17,7 @@ export { Arrow, makeArrowPath } from './mobjects/Arrow.js';
 export { BrandBox } from './mobjects/BrandBox.js';
 export { Graph } from './mobjects/Graph.js';
 export { DiGraph } from './mobjects/DiGraph.js';
-export { ThreeCanvas, StageCameraRig, useImageTexture, StudioRig, DeviceMesh, deviceDimensions, laptopLayout, lidRotationX, DEVICE_GLASS_OPACITY_ENCODED, DEVICE_GLASS_OPACITY_LINEAR, DEVICE_LIT_MATERIALS, DEVICE_PLANE_OFFSETS, SELF_TONE_MAPPED, UNLIT_COLOUR_MANAGED, makeDefaultScreenTexture, defaultScreenLayout, STUDIO_EDGE_LIGHTS, STUDIO_EDGE_INTENSITY, studioEdgeLightCount, DEFAULT_LIGHTING_PROFILE, LIGHTING_PROFILES, studioShadowFrustum, type StudioRigProps, type DeviceKind, type DeviceMeshProps, type DeviceDimensions, type LaptopLayout, type ScreenLayout, type SceneLightingProfile, } from './three/index.js';
+export { ThreeCanvas, FrameDepthOfField, type FrameDepthOfFieldProps, StageCameraRig, useImageTexture, StudioRig, DeviceMesh, deviceDimensions, laptopLayout, lidRotationX, DEVICE_GLASS_OPACITY_ENCODED, DEVICE_GLASS_OPACITY_LINEAR, DEVICE_LIT_MATERIALS, DEVICE_PLANE_OFFSETS, SELF_TONE_MAPPED, UNLIT_COLOUR_MANAGED, makeDefaultScreenTexture, defaultScreenLayout, STUDIO_EDGE_LIGHTS, STUDIO_EDGE_INTENSITY, studioEdgeLightCount, DEFAULT_LIGHTING_PROFILE, LIGHTING_PROFILES, studioShadowFrustum, type StudioRigProps, type DeviceKind, type DeviceMeshProps, type DeviceDimensions, type LaptopLayout, type ScreenLayout, type SceneLightingProfile, } from './three/index.js';
 export { solveFlex, flexReady, isFlexReady, leafIds, flexBoxToThree, fitBox, FlexLayout, useFlexReady, buildTree, unionTracks, weightsAt, type FlexCell, type FlexBox, type FlexSize, type FlexDir, type Fit, type FitMode, type FitResult, type FlexTrack, type FlexTrackSpec, type FlexLayoutProps, } from './layout/index.js';
 export * from './stage/index.js';
 export { MediaTileScene, mediaTileFramesReady, ImageTileScene, MEDIA_TILE_SCENE_LIMITS, assertMediaTileScene, mediaTileCropUvs, mediaTileFogDistances, type MediaTile, type MediaTileAsset, type MediaTileCamera, type MediaTileFog, type MediaTileSceneProps, type MediaTileStream, } from './media/MediaTileScene.js';

package/dist/_members/animate/three/FrameDepthOfField.d.ts

@@ -0,0 +1,8 @@
+import { type FrameDepthOfFieldProps } from './depthOfFieldPipeline.js';
+export type { FrameDepthOfFieldProps } from './depthOfFieldPipeline.js';
+/**
+ * Mount once inside ThreeCanvas, not inside SceneShotV2 (which owns another output pass).
+ * Evaluate all props from useCurrentFrame in the parent. This trusted render bridge only
+ * replaces R3F's draw on a Remotion advance; it never uses the R3F clock to animate anything.
+ */
+export declare function FrameDepthOfField(props: FrameDepthOfFieldProps): null;

package/dist/_members/animate/three/depthOfFieldPipeline.d.ts

@@ -0,0 +1,29 @@
+import { DepthOfFieldEffect, EffectComposer } from 'postprocessing';
+import { type PerspectiveCamera, type Scene, type WebGLRenderer } from 'three';
+export interface FrameDepthOfFieldProps {
+    /** Radial distance from the camera in scene units (not normalized depth or axial Z). */
+    focusDistance: number;
+    /** Distance falloff from perfect focus to maximum blur, in scene units. */
+    focusRange: number;
+    /** Nonnegative blur strength. Zero keeps the same color pipeline with no blur. */
+    bokehScale?: number;
+    /** Resolution of internal blur buffers; (0, 1]. Default 0.5. */
+    resolutionScale?: number;
+}
+export declare function validateFrameFocus(props: FrameDepthOfFieldProps): void;
+/** A single canvas-owned, non-temporal pipeline. Never shares GPU resources between roots. */
+export declare class FrameFocusPipeline {
+    private readonly gl;
+    private readonly camera;
+    readonly composer: EffectComposer;
+    readonly focus: DepthOfFieldEffect;
+    private readonly effectPass;
+    private readonly viewport;
+    private readonly scissor;
+    private disposed;
+    private readonly toneMapping;
+    constructor(gl: WebGLRenderer, scene: Scene, camera: PerspectiveCamera, resolutionScale: number);
+    resize(width: number, height: number): void;
+    draw(props: FrameDepthOfFieldProps): void;
+    dispose(): void;
+}

package/dist/_members/animate/three/index.d.ts

@@ -1,4 +1,5 @@
 export { ThreeCanvas } from './ThreeCanvas.js';
+export { FrameDepthOfField, type FrameDepthOfFieldProps } from './FrameDepthOfField.js';
 export { StageCameraRig } from './StageCameraRig.js';
 export { SceneCameraRig } from './SceneCameraRig.js';
 export { useImageTexture } from './useImageTexture.js';

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

@@ -1,3 +1,3 @@
 /** Public component imports shared by admission and desktop dependency staging. */
-export declare const COMPONENT_IMPORT_ALLOWLIST: readonly ["react", "react/jsx-runtime", "remotion", "@remotion/media", "@remotion/layout-utils", "@remotion/transitions", "@remotion/motion-blur", "@remotion/noise", "@remotion/paths", "@remotion/shapes", "@remotion/three", "three", "three/webgpu", "three/tsl", "@react-three/fiber", "@cueframe/animate", "gsap"];
+export declare const COMPONENT_IMPORT_ALLOWLIST: readonly ["react", "react/jsx-runtime", "remotion", "@remotion/media", "@remotion/layout-utils", "@remotion/transitions", "@remotion/motion-blur", "@remotion/noise", "@remotion/paths", "@remotion/shapes", "@remotion/three", "three", "three/webgpu", "three/tsl", "@react-three/fiber", "@cueframe/animate", "gsap", "postprocessing"];
 //# sourceMappingURL=allowedImports.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"allowedImports.d.ts","sourceRoot":"","sources":["../src/allowedImports.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,0TAkB5B,CAAC"}
+{"version":3,"file":"allowedImports.d.ts","sourceRoot":"","sources":["../src/allowedImports.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,4UAmB5B,CAAC"}

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;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,CAmHzB;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;AAIlE,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,CAoHzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAElE"}

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

@@ -3,6 +3,7 @@ export * from './identity.js';
 export * from './importPolicy.js';
 export * from './sceneAdmission.js';
 export * from './sourceWorkspace.js';
+export * from './sourceAdmission.js';
 export * from './render.js';
 export * from './browserOptions.js';
 export * from './webglProbe.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

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

@@ -2,6 +2,16 @@ import { type Workspace } from '../primitives/workspace.js';
 export declare const LOCAL_ROOT_FILENAME = "Root.local.tsx";
 export declare const LOCAL_ENTRY_FILENAME = "entry.local.tsx";
 export declare const LOCAL_COMPOSITION_ID = "CueFrameLocalStill";
+/** Monitor the lifetime of each displayed GL surface, not the whole React root.
+ * R3F deliberately loses a removed canvas's context during delayed disposal. */
+export declare function createWebGlSurfaceMonitor(onLost: () => void): {
+    watch(canvas: {
+        isConnected: boolean;
+        addEventListener(type: string, listener: () => void): void;
+        removeEventListener(type: string, listener: () => void): void;
+    }): void;
+    dispose(): void;
+};
 type LiveTransport = {
     frame: number;
     playing: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"localRoot.d.ts","sourceRoot":"","sources":["../src/localRoot.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAC;AAOxC,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,KAAK,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnF;sFACsF;AACtF,wBAAgB,4BAA4B,CAAC,SAAS,EAAE;IACtD,cAAc,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;uBAiCsB,aAAa;qBACf,MAAM;yBACF,MAAM,SAAS,MAAM;;EAO7C;AAOD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,SAAS,EACb,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F,GACA,MAAM,CA8aR"}
+{"version":3,"file":"localRoot.d.ts","sourceRoot":"","sources":["../src/localRoot.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAC;AAOxC,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD;gFACgF;AAChF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,IAAI;;qBAE3C,OAAO;+BACG,MAAM,YAAY,MAAM,IAAI,GAAG,IAAI;kCAChC,MAAM,YAAY,MAAM,IAAI,GAAG,IAAI;;;EAiBhE;AAED,KAAK,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnF;sFACsF;AACtF,wBAAgB,4BAA4B,CAAC,SAAS,EAAE;IACtD,cAAc,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;uBAsCsB,aAAa;qBACf,MAAM;yBACF,MAAM,SAAS,MAAM;;EAO7C;AAOD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,SAAS,EACb,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F,GACA,MAAM,CAkbR"}

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

@@ -0,0 +1,12 @@
+import { type ComponentManifestV2, type ComponentSourceV2 } from './contracts.js';
+/**
+ * Return literal slots read through `assets.<slot>.handle` (dot or bracket
+ * spelling). The AST is the contract boundary: comments, strings, regexes and
+ * type annotations are not runtime reads. Dynamic and aliased access is
+ * intentionally not proof that every declared slot is consumed.
+ */
+export declare function sourceAssetHandleReads(tsxSource: string): ReadonlySet<string>;
+export declare function missingDeclaredAssetHandleReads(tsxSource: string, manifest: Pick<ComponentManifestV2, 'assets'>): string[];
+/** Refuse a component before bundling when its declared media cannot reach the mount. */
+export declare function assertSourceReadsDeclaredAssets(source: Pick<ComponentSourceV2, 'componentId' | 'tsxSource' | 'manifest'>): void;
+//# sourceMappingURL=sourceAdmission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceAdmission.d.ts","sourceRoot":"","sources":["../src/sourceAdmission.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAgBxB;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAuC7E;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAC5C,MAAM,EAAE,CAKV;AAED,yFAAyF;AACzF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC,GACxE,IAAI,CAoBN"}

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

@@ -148,3 +148,18 @@ export type StackFontFamily = {
     kind: "unknown";
 };
 export declare function bundledFamilyForStack(stack: string | undefined | null): StackFontFamily;
+/**
+ * The family name a font admission should be decided against, for any value an author can put in
+ * a `fontFamily` field.
+ *
+ * A stack that names a bundled family collapses to THAT family, because it is the file the render
+ * will draw with. Anything else — an unknown family, a generic-only stack, a `$brand:` ref — stays
+ * exactly as authored, so the refusal names what the author wrote and the sealed brand font
+ * manifest still gets its chance to admit it.
+ *
+ * Both admission paths need this and they must not answer differently: `assertCaptionFontsAdmitted`
+ * resolves the caption stack, and `Root.tsx`'s sweep of every other `fontFamily` in the render
+ * input did not — so `{ fontFamily: "Inter, sans-serif" }` was drawn as a caption and refused as an
+ * overlay param, with a message calling the whole stack "not a bundled family".
+ */
+export declare function admissibleFamilyForStack(stack: string): string;

package/dist/animate.js

@@ -9,6 +9,7 @@ import {
   DiGraph,
   FadeIn,
   FlexLayout,
+  FrameDepthOfField,
   Graph,
   GrowArrow,
   GrowFromCenter,
@@ -101,7 +102,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-6BZZWF5B.js";
+} from "./chunk-ZYGUHMX6.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -184,7 +185,7 @@ import {
   selectSceneBakeScale
 } from "./chunk-KKV5U5EA.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-TARKDVP6.js";
+import "./chunk-BAC7DKQZ.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ALLOWED_BAKE_SCALES,
@@ -205,6 +206,7 @@ export {
   DiGraph,
   FadeIn,
   FlexLayout,
+  FrameDepthOfField,
   Graph,
   GrowArrow,
   GrowFromCenter,

package/dist/authoring/build-tools.js

@@ -4,19 +4,19 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-5CNS7IXO.js";
-import "../chunk-X6U6XVU4.js";
+} from "../chunk-OXHF3O5T.js";
+import "../chunk-4GSIXJ3I.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-IGP2CA7C.js";
-import "../chunk-TAXZ4KBF.js";
-import "../chunk-QZR4JCFY.js";
+import "../chunk-KSGREMGC.js";
+import "../chunk-MQO5T32S.js";
+import "../chunk-URUOXC3Z.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
-import "../chunk-TARKDVP6.js";
+import "../chunk-BAC7DKQZ.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ZERO_USAGE,

package/dist/authoring/context.js

@@ -1,14 +1,14 @@
 import {
   buildDirectorContext
-} from "../chunk-S3PZFAF5.js";
-import "../chunk-IGP2CA7C.js";
-import "../chunk-TAXZ4KBF.js";
-import "../chunk-QZR4JCFY.js";
+} from "../chunk-3IUVVVFE.js";
+import "../chunk-KSGREMGC.js";
+import "../chunk-MQO5T32S.js";
+import "../chunk-URUOXC3Z.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-TARKDVP6.js";
+import "../chunk-BAC7DKQZ.js";
 import "../chunk-2ESYSVXG.js";
 export {
   buildDirectorContext

package/dist/authoring/tools.js

@@ -6,18 +6,18 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-X6U6XVU4.js";
+} from "../chunk-4GSIXJ3I.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-IGP2CA7C.js";
-import "../chunk-TAXZ4KBF.js";
-import "../chunk-QZR4JCFY.js";
+import "../chunk-KSGREMGC.js";
+import "../chunk-MQO5T32S.js";
+import "../chunk-URUOXC3Z.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
-import "../chunk-TARKDVP6.js";
+import "../chunk-BAC7DKQZ.js";
 import "../chunk-2ESYSVXG.js";
 export {
   COMPOSE_MOTION_TOOLS,

package/dist/authoring.js

@@ -11,7 +11,7 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-5CNS7IXO.js";
+} from "./chunk-OXHF3O5T.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-X6U6XVU4.js";
+} from "./chunk-4GSIXJ3I.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-S3PZFAF5.js";
+} from "./chunk-3IUVVVFE.js";
 import {
   buildFastModel,
   buildModel,
@@ -48,16 +48,16 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-C4P4NC66.js";
+import "./chunk-ENMY25I3.js";
 import {
   cssLayoutVars
-} from "./chunk-O7G2NXUJ.js";
+} from "./chunk-MAD6MSXA.js";
 import "./chunk-ILO4NEZ3.js";
 import "./chunk-7AZLFN26.js";
 import "./chunk-VG2ND6PX.js";
-import "./chunk-IGP2CA7C.js";
-import "./chunk-TAXZ4KBF.js";
-import "./chunk-QZR4JCFY.js";
+import "./chunk-KSGREMGC.js";
+import "./chunk-MQO5T32S.js";
+import "./chunk-URUOXC3Z.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
@@ -69,7 +69,7 @@ import {
   isSceneShotClip
 } from "./chunk-KKV5U5EA.js";
 import "./chunk-2L7PYYJK.js";
-import "./chunk-TARKDVP6.js";
+import "./chunk-BAC7DKQZ.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts

package/dist/{chunk-RKDXNYLE.js → chunk-26MBA3WH.js}

@@ -43,7 +43,7 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-6BZZWF5B.js";
+} from "./chunk-ZYGUHMX6.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,

package/dist/{chunk-IUIG5N6M.js → chunk-2R35PKNK.js}

@@ -3,7 +3,7 @@ import {
   assertSceneShotParamsAdmitted,
   materializeComponentSource,
   renderComponentAlpha
-} from "./chunk-KBMKQGFR.js";
+} from "./chunk-D3GMN4WL.js";
 import {
   componentArtifactId,
   componentBundleId,
@@ -11,6 +11,9 @@ import {
   sha256Hex,
   sourceVersionId
 } from "./chunk-EXY4JJPH.js";
+import {
+  assertSourceReadsDeclaredAssets
+} from "./chunk-WXHD6OUT.js";
 import {
   resolvedComponentRenderer
 } from "./chunk-C5MPFJCD.js";
@@ -285,6 +288,7 @@ async function bakeComponentAlphaV2(options) {
       assets: assetServer.bindings
     });
     assertAssetBindingsMatch(request);
+    assertSourceReadsDeclaredAssets(request.source);
     const materialized = materializeComponentSource(options.workspaceRoot, request.source);
     const allowedAssetOrigins = /* @__PURE__ */ new Set([assetServer.origin]);
     if (scene) {

package/dist/{chunk-MDFKDTPF.js → chunk-3BCGHUJS.js}

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

package/dist/{chunk-S3PZFAF5.js → chunk-3IUVVVFE.js}

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

package/dist/{chunk-X6U6XVU4.js → chunk-4GSIXJ3I.js}

@@ -7,13 +7,13 @@ import {
 } from "./chunk-7AZLFN26.js";
 import {
   selectAllOverlays
-} from "./chunk-IGP2CA7C.js";
+} from "./chunk-KSGREMGC.js";
 import {
   ComposePlan
-} from "./chunk-TAXZ4KBF.js";
+} from "./chunk-MQO5T32S.js";
 import {
   OverlayClipSource
-} from "./chunk-QZR4JCFY.js";
+} from "./chunk-URUOXC3Z.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -63,7 +63,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-VHBMKP65.js");
+      const { buildDirectorContext } = await import("./context-UE255PMJ.js");
       return buildDirectorContext(capabilities);
     }
   },

package/dist/{chunk-A74FZCPY.js → chunk-5NGYBI5Z.js}

@@ -20,7 +20,8 @@ var COMPONENT_IMPORT_ALLOWLIST = Object.freeze([
   "three/tsl",
   "@react-three/fiber",
   "@cueframe/animate",
-  "gsap"
+  "gsap",
+  "postprocessing"
 ]);
 
 // ../execution/component-runtime/src/importPolicy.ts

package/dist/{chunk-TARKDVP6.js → chunk-BAC7DKQZ.js}

@@ -160,6 +160,10 @@ function bundledFamilyForStack(stack) {
   }
   return bundled ? { kind: "bundled", family: bundled } : { kind: "default" };
 }
+function admissibleFamilyForStack(stack) {
+  const resolved = bundledFamilyForStack(stack);
+  return resolved.kind === "bundled" ? resolved.family : stack;
+}
 
 // ../composition/src/fonts/captionFaces.ts
 var CAPTION_FACE_DEFAULTS = Object.freeze({
@@ -406,6 +410,7 @@ export {
   parseFontStack,
   isGenericOnlyStack,
   bundledFamilyForStack,
+  admissibleFamilyForStack,
   CAPTION_FACE_DEFAULTS,
   CAPTION_DEFAULT_FAMILY,
   captionStackFamily,

package/dist/{chunk-QLHATEZI.js → chunk-CG2E43AN.js}

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

package/dist/{chunk-KBMKQGFR.js → chunk-D3GMN4WL.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-EXY4JJPH.js";
 import {
   assertComponentImportsAllowed
-} from "./chunk-A74FZCPY.js";
+} from "./chunk-5NGYBI5Z.js";
 import {
   assertComponentBrowserHardware,
   componentBrowserBackend,
@@ -31,7 +31,7 @@ import {
 } from "./chunk-KKV5U5EA.js";
 import {
   BUNDLED_FONT_FACES
-} from "./chunk-TARKDVP6.js";
+} from "./chunk-BAC7DKQZ.js";
 
 // ../execution/component-runtime/src/sceneAdmission.ts
 import { ZodError } from "zod";
@@ -335,13 +335,35 @@ import { join as join2, relative } from "path";
 var LOCAL_ROOT_FILENAME = "Root.local.tsx";
 var LOCAL_ENTRY_FILENAME = "entry.local.tsx";
 var LOCAL_COMPOSITION_ID = "CueFrameLocalStill";
+function createWebGlSurfaceMonitor(onLost) {
+  const listeners = /* @__PURE__ */ new Map();
+  return {
+    watch(canvas) {
+      if (listeners.has(canvas)) return;
+      const lost = () => {
+        if (canvas.isConnected) onLost();
+      };
+      listeners.set(canvas, lost);
+      canvas.addEventListener("webglcontextlost", lost);
+    },
+    dispose() {
+      for (const [canvas, lost] of listeners) canvas.removeEventListener("webglcontextlost", lost);
+      listeners.clear();
+    }
+  };
+}
 function createLivePresentationRouter(callbacks) {
   let pending = null;
   let committedFrame = null;
   let presentedFrame = null;
   let presentedScene = null;
-  const matches = (transport, actual) => transport.playing ? actual >= transport.frame : actual === transport.frame;
+  let acknowledgedFrame = null;
+  const matches = (transport, actual) => transport.playing ? actual !== acknowledgedFrame : actual === transport.frame;
   const sameRequest = (left, right) => left.sequence === right.sequence && left.frame === right.frame && left.playing === right.playing;
+  const acknowledge = (transport, actual) => {
+    acknowledgedFrame = actual;
+    callbacks.acknowledge(transport, actual);
+  };
   const route = () => {
     const transport = pending;
     if (transport === null || committedFrame === null || !matches(transport, committedFrame)) return;
@@ -350,7 +372,7 @@ function createLivePresentationRouter(callbacks) {
     if (scene !== null) {
       if (presentedScene === scene && presentedFrame !== null && matches(transport, presentedFrame)) {
         pending = null;
-        callbacks.acknowledge(transport, presentedFrame);
+        acknowledge(transport, presentedFrame);
       }
       return;
     }
@@ -358,7 +380,7 @@ function createLivePresentationRouter(callbacks) {
       if (pending === null || !sameRequest(pending, transport) || callbacks.mediaTileScene() !== null || committedFrame === null || !matches(transport, committedFrame)) return;
       const acknowledged = pending;
       pending = null;
-      callbacks.acknowledge(acknowledged, committed);
+      acknowledge(acknowledged, committed);
     });
   };
   return {
@@ -408,6 +430,7 @@ const importAuthoredComponent = async () => {
 };
 
 const hostFontFaces = ${JSON.stringify(fontFaces)};
+const createWebGlSurfaceMonitor = ${createWebGlSurfaceMonitor.toString()};
 const hostFontCss = hostFontFaces.map((face) => {
   const url = face.url.startsWith('/') ? staticFile(face.url) : face.url;
   return '@font-face{font-family:' + JSON.stringify(face.family) + ';font-weight:' + face.weight +
@@ -475,6 +498,9 @@ export const CueFrameLocalComponent: React.FC<CueFrameComponentInput> = (input)
       getContext: (kind: string, ...args: unknown[]) => unknown;
     };
     const originalGetContext = canvasPrototype.getContext;
+    const glSurfaces = createWebGlSurfaceMonitor(() => {
+      if (!disposed) cancelRender(new Error(${JSON.stringify(BROWSER_RUNTIME_ERROR_PREFIX)} + 'component_device_lost:' + input.graphics.api + ' context was lost during component rendering.'));
+    });
 
     void (async () => {
       try {
@@ -500,7 +526,9 @@ export const CueFrameLocalComponent: React.FC<CueFrameComponentInput> = (input)
               throw new Error('A ' + requiredApi + '-required component may only create a ' + acceptedKinds.join('/') + ' canvas context.');
             }
             const context = originalGetContext.call(this, kind, ...args) as WebGLRenderingContext | WebGL2RenderingContext | null;
-            if (!context || admitted) return context;
+            if (!context) return context;
+            glSurfaces.watch(this as HTMLCanvasElement);
+            if (admitted) return context;
             admitted = true;
             const rendererInfo = context.getExtension('WEBGL_debug_renderer_info');
             const adapterName = rendererInfo
@@ -512,9 +540,6 @@ export const CueFrameLocalComponent: React.FC<CueFrameComponentInput> = (input)
             console.info(${JSON.stringify(GRAPHICS_ATTESTATION_PREFIX)} + JSON.stringify({
               api: requiredApi, acceleration, adapterName: adapterName || undefined, deviceLost: false,
             }));
-            this.addEventListener('webglcontextlost', () => {
-              if (!disposed) cancelRender(new Error(${JSON.stringify(BROWSER_RUNTIME_ERROR_PREFIX)} + 'component_device_lost:' + requiredApi + ' context was lost during component rendering.'));
-            }, {once: true});
             if (admissionTimer) clearTimeout(admissionTimer);
             continueRender(waitHandle as number);
             return context;
@@ -590,6 +615,7 @@ export const CueFrameLocalComponent: React.FC<CueFrameComponentInput> = (input)
     })();
     return () => {
       disposed = true;
+      glSurfaces.dispose();
       if (admissionTimer) clearTimeout(admissionTimer);
       canvasPrototype.getContext = originalGetContext;
       if (gpuPrototype && originalRequestAdapter) gpuPrototype.requestAdapter = originalRequestAdapter;

package/dist/{chunk-5DSHDRPQ.js → chunk-DEOP3TWR.js}

@@ -3,6 +3,14 @@ import {
   buildEasedZooms,
   buildPannedCenters
 } from "./chunk-QH3YI3ND.js";
+import {
+  flattenCompoundClips,
+  hasCompoundClips
+} from "./chunk-QISFYLBB.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -21,14 +29,6 @@ import {
   segmentShots,
   stabilizeSelectionHysteresis
 } from "./chunk-L2AHS3AW.js";
-import {
-  flattenCompoundClips,
-  hasCompoundClips
-} from "./chunk-QISFYLBB.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -61,7 +61,7 @@ import {
   bundledFontFaceExists,
   mergedCaptionFaceIssues,
   unrenderableFaceField
-} from "./chunk-TARKDVP6.js";
+} from "./chunk-BAC7DKQZ.js";
 
 // ../execution/core/src/render/sceneCaptureIdentity.ts
 var INTENT_FIELDS = [

package/dist/{chunk-C4P4NC66.js → chunk-ENMY25I3.js}

@@ -2,7 +2,7 @@ import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
-} from "./chunk-O7G2NXUJ.js";
+} from "./chunk-MAD6MSXA.js";
 import {
   CueframeError,
   encodeError

package/dist/{chunk-IGP2CA7C.js → chunk-KSGREMGC.js}

@@ -1,6 +1,6 @@
 import {
   Composition
-} from "./chunk-QZR4JCFY.js";
+} from "./chunk-URUOXC3Z.js";
 import {
   expandToLinkGroup
 } from "./chunk-KYRDKK2D.js";

package/dist/{chunk-O7G2NXUJ.js → chunk-MAD6MSXA.js}

@@ -10,7 +10,7 @@ import {
 import {
   captionFontSource,
   effectiveCaptionFamily
-} from "./chunk-TARKDVP6.js";
+} from "./chunk-BAC7DKQZ.js";
 
 // ../composition/src/projection/brandKit.ts
 var LOGO_DEFAULT_PLACEMENT = "br";