@cueframe/kernel 0.2.2 → 0.2.3

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

@@ -0,0 +1,37 @@
+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";
+type LiveTransport = {
+    frame: number;
+    playing: boolean;
+} & Record<string, unknown>;
+/** Frame-presentation state used by the generated live iframe. Kept pure so
+ * seek transitions can be exercised without a browser or source-string assertions. */
+export declare function createLivePresentationRouter(callbacks: {
+    mediaTileScene: () => string | null;
+    requestFrame: (callback: () => void) => void;
+    acknowledge: (transport: LiveTransport, presentedFrame: number) => void;
+}): {
+    request(transport: LiveTransport): void;
+    committed(frame: number): void;
+    tilePresented(frame: number, scene: string): void;
+    dispose(): void;
+};
+export declare function generateLocalRoot(ws: Workspace, opts: {
+    id: string;
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    revision?: string;
+    liveInputProps?: Record<string, unknown>;
+    fontFaces?: ReadonlyArray<{
+        family: string;
+        weight: number;
+        style?: string;
+        url: string;
+    }>;
+}): string;
+export {};
+//# sourceMappingURL=localRoot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localRoot.d.ts","sourceRoot":"","sources":["../src/localRoot.ts"],"names":[],"mappings":"AAEA,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,CAqaR"}

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

@@ -0,0 +1,25 @@
+import type { ComponentMediaDemandV1, ComponentMediaTierV1 } from './contracts.js';
+export declare const COMPONENT_MEDIA_TIERS: readonly [256, 512, 1024, 2048];
+export declare const COMPONENT_MEDIA_HEADROOM = 1.25;
+export interface ComponentMediaSourceDimensions {
+    width: number;
+    height: number;
+}
+export interface ComponentMediaOutputDimensions {
+    width: number;
+    height: number;
+}
+export type ComponentMediaRepresentationPlan = {
+    kind: 'original' | 'proxy';
+    width: number;
+    height: number;
+    tier: ComponentMediaTierV1 | null;
+    requiredWidth: number;
+    requiredHeight: number;
+};
+export declare function planComponentMediaRepresentation(input: {
+    source: ComponentMediaSourceDimensions;
+    output: ComponentMediaOutputDimensions;
+    demand: ComponentMediaDemandV1;
+}): ComponentMediaRepresentationPlan;
+//# sourceMappingURL=mediaResolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mediaResolution.d.ts","sourceRoot":"","sources":["../src/mediaResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEnF,eAAO,MAAM,qBAAqB,iCAA4E,CAAC;AAC/G,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAgBF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,MAAM,EAAE,8BAA8B,CAAC;IACvC,MAAM,EAAE,8BAA8B,CAAC;IACvC,MAAM,EAAE,sBAAsB,CAAC;CAChC,GAAG,gCAAgC,CA6CnC"}

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

@@ -1,17 +1,12 @@
 import { type Workspace } from '../primitives/workspace.js';
-import { type ComponentGraphicsActualV2, type ComponentGraphicsRequirementV2 } from './contracts.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";
-export declare const GRAPHICS_ATTESTATION_PREFIX = "__cueframe_graphics_v2__:";
-export declare function parseGraphicsAttestationLog(text: string): ComponentGraphicsActualV2 | null;
-export declare function generateLocalRoot(ws: Workspace, opts: {
-    id: string;
-    width: number;
-    height: number;
-    fps: number;
-    durationInFrames: number;
-}): string;
+import { type ComponentGraphicsActualV2, type ComponentGraphicsRequirementV2, type ComponentHostAttestationV2, type ComponentCapturePageRasterAttestationV1, type ComponentStillPngContainerFactsV1 as ComponentStillPngFactsV1, type ComponentStillSessionAttestationV1 as ComponentStillSessionAttestationFactsV1, type ComponentStillSessionHostAttestationV1 as ComponentStillSessionHostAttestationFactsV1 } from './contracts.js';
+import type { FfmpegOverrideFn } from '@remotion/renderer';
+export { generateLocalRoot, LOCAL_COMPOSITION_ID, LOCAL_ENTRY_FILENAME, LOCAL_ROOT_FILENAME, } from './localRoot.js';
+export { GRAPHICS_ATTESTATION_PREFIX, parseGraphicsAttestationLog } from './renderDiagnostics.js';
+export declare function shouldIsolateWebGpuStillBrowser(platform: NodeJS.Platform, graphicsApi: ComponentGraphicsRequirementV2['api']): boolean;
+export declare const COMPONENT_BROWSER_FIREWALL_TIMEOUT_MS = 10000;
+export declare const COMPONENT_BROWSER_CLEANUP_TIMEOUT_MS = 5000;
+export declare const COMPONENT_BROWSER_FIREWALL_ATTEMPTS = 2;
 export declare function buildLocalWebpackOverride(renderEntryRoot: string, authoredComponentRoot: string): (config: any) => any;
 export interface RenderComponentStillOpts {
     ws: Workspace;
@@ -25,22 +20,138 @@ export interface RenderComponentStillOpts {
     height?: number;
     fps?: number;
     durationInFrames?: number;
+    /** Remotion output scale. The composition keeps its authored layout dimensions. */
+    scale?: number;
     renderEntryRoot?: string;
     allowedAssetOrigins?: ReadonlySet<string>;
+    /** Trusted host font faces served from the verified render-entry public tree. */
+    fontFaces?: ReadonlyArray<{
+        family: string;
+        weight: number;
+        style?: string;
+        url: string;
+    }>;
+}
+export interface ComponentStillFrameOpts {
+    frame?: number;
+    params?: Record<string, unknown>;
+    assets?: Record<string, unknown>;
+    seed?: string;
+    /** Refuse a request queued against a different compiled source revision. */
+    expectedRevision?: string;
+    outputPath?: string;
+}
+export interface ComponentStillSession {
+    readonly revision: string;
+    readonly liveUrl: string;
+    /** Same-session host facts, present only when capture attestation was requested. */
+    readonly hostAttestation: ComponentStillSessionHostAttestationFactsV1 | null;
+    renderFrame(opts?: ComponentStillFrameOpts): Promise<{
+        pngPath: string;
+        revision: string;
+        actualGraphics: ComponentGraphicsActualV2;
+        capturePageRaster: ComponentCapturePageRasterAttestationV1 | null;
+        outputOwnedBySession: boolean;
+    }>;
+    renderVerifiedFrame(opts?: ComponentStillFrameOpts): Promise<{
+        png: ComponentStillPngFactsV1;
+        revision: string;
+        actualGraphics: ComponentGraphicsActualV2;
+        attestation: ComponentStillSessionAttestationFactsV1;
+    }>;
+    close(): Promise<void>;
+    /** Immediately closes the owned browser, then waits for active work to settle. */
+    cancel(): Promise<void>;
+}
+export interface CreateComponentStillSessionOpts extends Omit<RenderComponentStillOpts, 'frame'> {
+    /** Stable identity supplied by an immutable source owner. Defaults to the
+     * authored entrypoint digest captured before compilation. */
+    revision?: string;
+    /** Collect identity facts from this exact browser before it captures a frame. */
+    captureAttestation?: boolean;
+    /** Optional host diagnostic sink for browser console output during startup/render. */
+    onBrowserLog?: (entry: unknown) => void;
+    /** Reports bounded startup phases without exposing component source or props. */
+    onStartupPhase?: (phase: 'prepare' | 'prepared' | 'open-browser' | 'browser-open' | 'firewall' | 'select-composition' | 'composition-ready' | 'start-proxy' | 'ready') => void;
 }
 export declare function importFromRenderEntry<T>(renderEntryRoot: string, spec: string): Promise<T>;
+/** What the shared verifier hands back: the browser this process will actually run. */
+export type StagedBrowserIdentity = {
+    path: string;
+    sha256: string;
+    version: string;
+    product: string;
+    chromeMode: 'headless-shell' | 'chrome-for-testing';
+    manifestPath: string;
+};
+/**
+ * How long this lane gives the staged executable to answer `--version`.
+ *
+ * The composition lane derives its probe budget from the render deadline it was given
+ * (`resolveBrowserVersionProbeBudgetMs`); a preview session has no deadline of its own, so it takes
+ * that derivation's own ceiling. A probe that outlives it has not been slow, it has hung.
+ */
+export declare const LOCAL_BROWSER_VERSION_PROBE_MS = 30000;
+export declare function verifyLocalStagedBrowser(renderEntryRoot: string): Promise<StagedBrowserIdentity>;
+/**
+ * Install the sizer on `browser` and answer a `size(width, height)` that refuses by name.
+ *
+ * Installed ONCE per browser and before the request firewall, because the sizer's measuring page
+ * must exist before anything installs `Target.setAutoAttach` over the same browser — a page created
+ * and closed after that is auto-attached while it is already going away, and the firewall's first
+ * command to it fails. The returned `size` may then be called per composition.
+ *
+ * A refusal raised asynchronously by a later page — the sizer verifies every page target against
+ * the window it verified — is surfaced on the NEXT `size` call and, for the lanes that call `size`
+ * once, by the browser teardown the sizer performs, which ends the render in flight.
+ */
+export declare function installLocalLaneWindowSizer(renderEntryRoot: string, browser: unknown): Promise<(width: number, height: number) => Promise<void>>;
+/** Install and size once, for a lane that knows its frame size before it opens a page. */
+export declare function sizeLocalLaneWindows(renderEntryRoot: string, browser: unknown, width: number, height: number): Promise<void>;
+/** The five typed fields a staged-browser refusal puts on the wire, or null for anything else. */
+export type StagedBrowserWireLocator = {
+    code: string;
+    path: string | null;
+    expected: string | null;
+    observed: string | null;
+    repair: string | null;
+};
+/**
+ * The wire locator for a caught error, DELEGATED to the shared verifier module rather than
+ * reimplemented here.
+ *
+ * A second copy of "is this a staged-browser refusal, and what are its fields" is how the two lanes
+ * came to disagree about the same broken bundle, so there is not one. `null` before the module has
+ * ever loaded is correct and not a fallback: no staged-browser refusal can exist before the module
+ * that throws it has been loaded, and by the time a refusal is being reported it has been.
+ */
+export declare function stagedBrowserLocator(error: unknown): StagedBrowserWireLocator | null;
 export declare function resolveRenderEntryRoot(override?: string): string;
+export declare const COMPONENT_STILL_RUNTIME_IDENTITY = "@cueframe/component-runtime/still-session-v1";
+/** Raster-affecting Remotion launch arguments pinned before a browser is opened. */
+export declare function componentStillRasterAffectingFlags(graphics: ComponentGraphicsRequirementV2): {
+    browserArguments: string[];
+};
+export declare function componentStillDependencyIdentity(renderEntryRoot: string): Promise<string>;
+export declare function createComponentStillSession(opts: CreateComponentStillSessionOpts): Promise<ComponentStillSession>;
 export declare function renderComponentStill(opts: RenderComponentStillOpts): Promise<{
     pngPath: string;
     actualGraphics: ComponentGraphicsActualV2;
 }>;
 export type AlphaCodec = 'prores' | 'vp9';
+/** Bounded VP9 row parallelism through Remotion's supported encoder hook.
+ * Keep alpha, frame timing and container arguments supplied by Remotion.
+ * The renderer bundle digest seals this fixed profile into bake cache identity.
+ */
+export declare const vp9AlphaFfmpegOverride: FfmpegOverrideFn;
 export declare function alphaRenderConfig(codec: AlphaCodec): {
     codec: AlphaCodec;
     pixelFormat: 'yuva444p10le' | 'yuva420p';
     imageFormat: 'png';
     muted: true;
     proResProfile?: '4444';
+    crf?: number;
+    ffmpegOverride?: FfmpegOverrideFn;
 };
 export declare function alphaExt(codec: AlphaCodec): 'mov' | 'webm';
 export interface RenderComponentAlphaOpts {
@@ -60,9 +171,36 @@ export interface RenderComponentAlphaOpts {
     frameRange?: [number, number];
     renderEntryRoot?: string;
     allowedAssetOrigins?: ReadonlySet<string>;
+    concurrency?: number;
+    onProgress?: (progress: {
+        renderedFrames: number;
+        encodedFrames: number;
+        totalFrames: number;
+    }) => void;
+    onTiming?: (timing: ComponentRenderTiming) => void;
+}
+export interface ComponentRenderTiming {
+    stage: 'bundle' | 'browser' | 'composition' | 'first-frame' | 'frames' | 'encoding' | 'render';
+    durationMs: number;
+    slowestFrames?: Array<{
+        frame: number;
+        time: number;
+    }>;
+    /** Native Remotion process-level counters. Concurrent capture durations
+     * overlap; these averages are not additional pipeline wall time. */
+    rendererPerformance?: string[];
 }
+/**
+ * `host` is what browser admission attested about the machine that drew the frames — the WebGL
+ * feature status, the renderer string, the measured `MAX_TEXTURE_SIZE` and the backend — or null
+ * when this render probed no host. It is carried out of here so the bake can record it on the
+ * receipt (`ComponentRenderReceiptV2.host`), which is the only place the measurement survives the
+ * render: it is taken once, before the first frame, and cannot be recovered from the artifact.
+ * It is not part of any identity; see `ComponentHostAttestationV2`.
+ */
 export declare function renderComponentAlpha(opts: RenderComponentAlphaOpts): Promise<{
     videoPath: string;
     actualGraphics: ComponentGraphicsActualV2;
+    host: ComponentHostAttestationV2 | null;
 }>;
 //# sourceMappingURL=render.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+import { ComponentRuntimeError, type ComponentCapturePageRasterAttestationV1 as CapturePageRasterAttestation, type ComponentGraphicsActualV2, type ComponentGraphicsRequirementV2, type ComponentRuntimeErrorCode as RuntimeErrorCode } from './contracts.js';
+export declare const GRAPHICS_ATTESTATION_PREFIX = "__cueframe_graphics_v2__:";
+export declare const CAPTURE_PAGE_RASTER_ATTESTATION_PREFIX = "__cueframe_capture_raster_v1__:";
+export declare const BROWSER_RUNTIME_ERROR_PREFIX = "__cueframe_component_error_v2__:";
+export declare function componentRuntimeError(error: unknown, fallbackCode: RuntimeErrorCode, retryable?: boolean): ComponentRuntimeError;
+export declare function parseGraphicsAttestationLog(text: string): ComponentGraphicsActualV2 | null;
+export declare function parseCapturePageRasterAttestationLog(text: string): CapturePageRasterAttestation | null;
+export declare function graphicsCollector(required: ComponentGraphicsRequirementV2): {
+    onBrowserLog(log: {
+        text: string;
+    }): void;
+    receipt(): ComponentGraphicsActualV2;
+};
+//# sourceMappingURL=renderDiagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderDiagnostics.d.ts","sourceRoot":"","sources":["../src/renderDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmE,qBAAqB,EAA6B,KAAK,uCAAuC,IAAI,4BAA4B,EAAE,KAAK,yBAAyB,EAAE,KAAK,8BAA8B,EAAE,KAAK,yBAAyB,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1V,eAAO,MAAM,2BAA2B,8BAA8B,CAAC;AACvE,eAAO,MAAM,sCAAsC,oCAAoC,CAAC;AACxF,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAE/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,gBAAgB,EAC9B,SAAS,UAAQ,GAChB,qBAAqB,CAiBvB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAa1F;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,4BAA4B,GAAG,IAAI,CAStG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,8BAA8B;sBAGpD;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;eAiB9B,yBAAyB;EAUvC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Scene-shot capability admission. A source that declares `manifest.sceneShot`
+ * opts its `params.scene` into the typed contract from `@cueframe/composition/scene`.
+ * Everything here runs before a workspace is written, a bundle is built, or a
+ * browser is opened, and every refusal names the stage, the clip and component,
+ * the exact field path, and the corrective action.
+ */
+import { type SceneShotSpecV2 } from '../composition/scene/index.js';
+import { type ComponentManifestV2, type SceneShotCapabilityV2 } from './contracts.js';
+/** Authored scene contract versions accepted by admission. */
+export declare const SUPPORTED_SCENE_SHOT_VERSIONS: readonly number[];
+/** The authored prop that carries the shot for a scene-shot source. */
+export declare const SCENE_SHOT_PARAM: "scene";
+export declare const SCENE_ADMISSION_STAGE: "admission";
+export interface SceneAdmissionContext {
+    componentId?: string;
+    clipId?: string;
+}
+/** `['layers', 0, 'width']` → `scene.layers.0.width`; the root issue is `scene`. */
+export declare function sceneShotIssuePath(path: ReadonlyArray<PropertyKey>): string;
+/**
+ * Inspects the raw (pre-parse) manifest so an unsupported version or a
+ * mismatched graphics api is refused with a typed error rather than a bare
+ * schema failure. Returns the capability when declared and supported and null
+ * for an ordinary source, and leaves other manifest defects to the strict parse.
+ *
+ * A `sceneShot` key that is present but unreadable — `{}`, `{ version: '2' }`,
+ * `null` — is a declaration this runtime cannot honour, never "not a scene": it
+ * is refused here so a malformed declaration can never slip past scene
+ * validation and be captured as an ordinary component.
+ */
+export declare function assertSceneShotCapabilitySupported(manifest: unknown, context?: SceneAdmissionContext): SceneShotCapabilityV2 | null;
+/**
+ * Validates `params.scene` for a source that declared `sceneShot`. Ordinary
+ * sources keep their semantics: the param is not inspected. The error carries
+ * the exact zod path under `scene`.
+ *
+ * "Declared a scene shot" is decided by `assertSceneShotCapabilitySupported`,
+ * not by the truthiness of `manifest.sceneShot`, so the two halves of admission
+ * cannot disagree: a present-but-unreadable declaration (`{}`, `null`,
+ * `{ version: '2' }`, or one on a non-WebGL source) is refused here with the
+ * same typed error the capability check raises, instead of one half calling it
+ * a scene and the other calling it an ordinary component. The call is pure and
+ * idempotent, so lanes that already ran the capability check pay nothing.
+ */
+export declare function assertSceneShotParamsAdmitted(manifest: Pick<ComponentManifestV2, 'graphics' | 'sceneShot'>, params: Record<string, unknown>, context?: SceneAdmissionContext): SceneShotSpecV2 | null;
+//# sourceMappingURL=sceneAdmission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sceneAdmission.d.ts","sourceRoot":"","sources":["../src/sceneAdmission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEzF,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,8DAA8D;AAC9D,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAAuB,CAAC;AAEnF,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAEjD,eAAO,MAAM,qBAAqB,EAAG,WAAoB,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAE3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,qBAA0B,GAClC,qBAAqB,GAAG,IAAI,CA+B9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,WAAW,CAAC,EAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAA0B,GAClC,eAAe,GAAG,IAAI,CAgBxB"}

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

@@ -7,4 +7,12 @@ export interface MaterializedComponentSource {
     componentDir: string;
 }
 export declare function materializeComponentSource(workspaceRoot: string, input: ComponentSource): MaterializedComponentSource;
+/**
+ * The immutable source a workspace component was materialized from, or null for
+ * a plain workspace component (one authored on disk without a pinned manifest).
+ * The render path reads it so every lane that renders a materialized source,
+ * including hosts that only hand the workspace over, admits `params.scene`
+ * against the manifest the bundle is built from.
+ */
+export declare function readMaterializedComponentSource(ws: Workspace, id: string): ComponentSource | null;
 //# sourceMappingURL=sourceWorkspace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sourceWorkspace.d.ts","sourceRoot":"","sources":["../src/sourceWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAqB,KAAK,iBAAiB,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI9F,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,eAAe,GACrB,2BAA2B,CAqB7B"}
+{"version":3,"file":"sourceWorkspace.d.ts","sourceRoot":"","sources":["../src/sourceWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,EAAqB,KAAK,iBAAiB,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAO9F,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,eAAe,GACrB,2BAA2B,CAwB7B;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAIjG"}

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

@@ -0,0 +1,191 @@
+/** Chrome's own account of the GPU and backend it selected, over CDP alone: one round trip,
+ * no page. This is everything `SystemInfo.getInfo` carries that either lane reads. */
+export interface GpuAttestation {
+    /** `gpu.auxAttributes.glRenderer`, or '' when the browser did not report one. */
+    renderer: string;
+    /** `gpu.featureStatus`, keyed by Chrome's feature names (`webgl`, `gpu_compositing`, ...). */
+    featureStatus: Record<string, string>;
+    /** Canonical exposed GPU/device/driver facts, or null when Chrome exposes none. */
+    gpuIdentity: string | null;
+}
+/**
+ * Chrome's attestation plus what a page in this browser can actually allocate.
+ *
+ * A separate type from `GpuAttestation`, and read by a separate function, because measuring the
+ * limit costs a page: `MAX_TEXTURE_SIZE` exists only inside a GL context, so it cannot be had
+ * without opening one. A lane that does not need WebGL must not pay for it, and — more to the
+ * point — must not be able to hold a half-measured attestation that a `null` limit would make
+ * indistinguishable from a host with no WebGL2 at all.
+ */
+export interface WebGlAttestation extends GpuAttestation {
+    /**
+     * The host's WebGL2 `MAX_TEXTURE_SIZE`, or null when a page in this browser could not create a
+     * WebGL2 context at all. Null is a refusal for a scene shot, never a "carry on": the scene
+     * renderer is a WebGL2 renderer, so a browser whose pages have no WebGL2 context cannot draw
+     * one whatever `featureStatus.webgl` says.
+     */
+    maxTextureSize: number | null;
+    /**
+     * The half-float colour extension a page in this browser reports, or null when it reports
+     * neither of `HALF_FLOAT_COLOR_TARGET_EXTENSIONS` — and null too when there was no WebGL2
+     * context to ask, which `maxTextureSize: null` says on its own.
+     *
+     * Measured on the same context as the limit above, in the same page, because that is the
+     * context whose capabilities the render's own will share.
+     */
+    halfFloatColorTarget: string | null;
+}
+/**
+ * The two extensions that make a half-float colour attachment renderable, either of which is
+ * enough. This is the pair three itself tests before choosing `HalfFloatType` for its own
+ * intermediates, and the pair the renderer-side gate asks for by name
+ * (`@cueframe/animate`'s `scene/focusResources.ts`, `HALF_FLOAT_TARGET_EXTENSIONS`): asking the
+ * question the way the renderer asks it is what keeps the answer true of the target it will
+ * actually allocate.
+ *
+ * The list is stated twice, here and there, because the two packages cannot import from each
+ * other — this one is bundled for the plain-Node script lane and must stay cheap, and animate
+ * does not depend on it. Neither copy may change alone; the renderer-side refusal
+ * (`scene_render_target_unsupported`) is the second gate for exactly the case where they have.
+ */
+export declare const HALF_FLOAT_COLOR_TARGET_EXTENSIONS: readonly ["EXT_color_buffer_half_float", "EXT_color_buffer_float"];
+/** What one page in the staged browser can allocate: the measurements admission is decided on. */
+export interface WebGlPageLimits {
+    maxTextureSize: number;
+    /** The first of `HALF_FLOAT_COLOR_TARGET_EXTENSIONS` the context grants, or null for neither. */
+    halfFloatColorTarget: string | null;
+}
+/** The part of a Remotion page this probe uses: it evaluates exactly one function, below. */
+export interface ProbePage {
+    evaluate(pageFunction: () => WebGlPageLimits | null): Promise<WebGlPageLimits | null>;
+    close(): Promise<void>;
+}
+export interface WebGlPolicy {
+    /** The GL backend this lane launched the browser with; named in the refusal. */
+    backend?: string | null;
+    /** True under `CUEFRAME_RENDER_ACCELERATION=hardware`, which forbids software WebGL. */
+    hardware?: boolean;
+}
+/**
+ * Opening the one page the limits are measured in, in the shape Remotion's browser handle offers
+ * it. Typed on its own because it is the capability only the WebGL half of this probe needs, and
+ * the capability sets are what the two halves are split along.
+ */
+export type ProbePageOpener = (options: {
+    context: () => null;
+    logLevel: 'error';
+    indent: false;
+    pageIndex: number;
+    onBrowserLog: null;
+    onLog: () => void;
+}) => Promise<ProbePage>;
+/**
+ * The part of a Remotion browser handle this probe uses: the CDP connection Chrome answers
+ * `SystemInfo.getInfo` on, and — for the WebGL half alone — one page for the limits it does not
+ * report there.
+ *
+ * The page opener is optional *here* and required by `WebGlProbeBrowser` below, which is what
+ * `readWebGlAttestation` narrows to before it opens anything. The split is the capability set each
+ * reader actually uses. `readGpuAttestation` makes one CDP round trip and opens nothing, and so
+ * does the hardware-compositor path of admission that calls it, so the connection alone is
+ * everything that path can be asked to prove. Stating the opener as required on the shared handle
+ * type would charge every caller of the shared entry point — `assertComponentBrowserHardware`,
+ * which a canvas2d component goes through too — for a capability that path never uses, and the
+ * handles callers hold do not all declare it: `render.ts` passes Remotion's browser, whose
+ * declaration in the render-harness project is the connection and `close` and no more.
+ */
+export interface CdpBrowserConnection {
+    connection: {
+        send(method: string, params?: unknown): Promise<unknown>;
+    };
+    newPage?: ProbePageOpener;
+}
+/** A handle carrying both halves: what the WebGL measurement needs, and nothing wider. */
+export interface WebGlProbeBrowser extends CdpBrowserConnection {
+    newPage: ProbePageOpener;
+}
+/**
+ * Runs inside the probe page. `null` means this browser has no WebGL2 context to measure.
+ *
+ * The extension names are written out rather than read from
+ * `HALF_FLOAT_COLOR_TARGET_EXTENSIONS`, and they have to be: this function is serialized and
+ * evaluated in the browser, where nothing in this module exists, so a closure over the constant
+ * would arrive as a reference error and the probe would refuse every host. `webglProbe.test.ts`
+ * reads this function's own source and checks it asks for exactly the names the refusal names.
+ */
+export declare function readWebGlLimitsInPage(): WebGlPageLimits | null;
+/**
+ * Chrome's GPU attestation over CDP: the renderer string and the feature status, one round trip.
+ *
+ * Remotion's transport wraps protocol results in `{value, size}`.
+ */
+export declare function readGpuAttestation(browser: CdpBrowserConnection): Promise<GpuAttestation>;
+/**
+ * The attestation above, plus what one page in this browser can allocate: `MAX_TEXTURE_SIZE` and
+ * half-float colour targets.
+ *
+ * Two round trips, because Chrome's `SystemInfo.getInfo` carries neither: its `gpu.auxAttributes`
+ * reports `glRenderer`, `glVersion`, `maxMsaaSamples` and the rest, and no size limit and no
+ * extension registry at all (`apps/studio/scripts/probe-gpu-limits.mjs` prints the key list). Both
+ * exist only inside a GL context, so this opens one `about:blank` page — it navigates nowhere and
+ * issues no request — asks it once for both, and closes it again. One page, because they are
+ * properties of one context: an answer taken from a different context would not be about the
+ * context the render draws through.
+ *
+ * Only a lane that needs WebGL calls this. A canvas2d or hardware-compositor check reads
+ * `readGpuAttestation` alone and opens no page.
+ */
+export declare function readWebGlAttestation(browser: CdpBrowserConnection): Promise<WebGlAttestation>;
+/**
+ * The WebGL admission decision: null when the browser can capture a WebGL scene
+ * under this policy, otherwise the refusal message. Naming the missing feature
+ * and the selected backend is the point — a lane must never quietly capture a
+ * black frame or substitute another api.
+ *
+ * Four ways to fail, all closed:
+ *   - the browser does not attest `webgl`, or attests it off;
+ *   - it runs WebGL in software under an acceleration policy that forbids that;
+ *   - a page in it has no WebGL2 context, or reports a `MAX_TEXTURE_SIZE` below the shadow map
+ *     the scene renderer may allocate (`STUDIO_SHADOW_MAP_BUDGET`). The renderer does not clamp:
+ *     a map spread over fewer texels than it was tuned for is a different picture, and a request
+ *     over the host's limit is a GL error mid-render rather than a refusal before one. So the
+ *     refusal happens here, at admission, with both numbers named;
+ *   - a page in it grants neither half-float colour extension. Every scene shot's world — in
+ *     focus or not — is rasterized into a half-float colour target and composited out of it, so
+ *     this is a capability of the shot rather than of an optional effect, and eight-bit linear is
+ *     not a near-enough substitute (stored as `round(L * 255)` it collapses sRGB codes 16-24 onto
+ *     one or two levels, which is where a dark product-UI gradient lives). The renderer refuses
+ *     too, typed `scene_render_target_unsupported`, and that gate stays: it is what catches a host
+ *     whose page-level answer and whose render-time answer disagree. But it fires in the browser
+ *     at the first drawn frame, after a capture has been staged and paid for, so the decision
+ *     belongs here as well — before capture, naming the extensions.
+ */
+export declare function webGlRefusal(attestation: WebGlAttestation, policy?: WebGlPolicy): string | null;
+/**
+ * What a host that passed `webGlRefusal` attested about itself, in the shape a receipt records.
+ *
+ * This exists so a lane can state the host it was admitted on instead of leaving the measurement
+ * inside a decision nobody can cite afterwards: `maxTextureSize` in particular is measured once,
+ * before the first frame, and is otherwise unrecoverable from the artifact.
+ *
+ * It is NOT part of any render identity or cache key, on either lane, and the reason is the same
+ * one that keeps the limit off `ComponentRendererConfigV2` (contracts.ts): every host that clears
+ * `STUDIO_SHADOW_MAP_BUDGET` draws the identical frame, so a host reporting 16384 and one
+ * reporting 8192 would key differently while producing the same bytes — splitting the identity,
+ * and evicting correct artifacts, on a difference the render cannot see. What the limit governs is
+ * admission, and below it there is no render to key.
+ *
+ * Only call it on an admitted host: `maxTextureSize` and `halfFloatColorTarget` are `null`
+ * exactly when `webGlRefusal` refused, so a null in either would mean a receipt was being written
+ * for a shot that never should have been captured. The callers narrow them (component-runtime
+ * parses this through `ComponentHostAttestationV2`, which rejects both) rather than papering over
+ * it.
+ */
+export declare function admittedHost(attestation: WebGlAttestation, policy?: WebGlPolicy): {
+    webgl: string;
+    renderer: string;
+    maxTextureSize: number | null;
+    halfFloatColorTarget: string | null;
+    glBackend: string;
+};
+//# sourceMappingURL=webglProbe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webglProbe.d.ts","sourceRoot":"","sources":["../src/webglProbe.ts"],"names":[],"mappings":"AAqBA;sFACsF;AACtF,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mFAAmF;IACnF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD;;;;;OAKG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kCAAkC,oEAAqE,CAAC;AAErH,kGAAkG;AAClG,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,6FAA6F;AAC7F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAEzB;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE;QAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IACzE,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,0FAA0F;AAC1F,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,OAAO,EAAE,eAAe,CAAC;CAC1B;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,GAAG,IAAI,CAS9D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAkC/F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoDnG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAE,WAAgB,GAAG,MAAM,GAAG,IAAI,CAoBnG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAE,WAAgB,GAAG;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAQA"}