@aura3d/rendering 3.0.1 → 4.0.2

package/dist/contracts/quality.js

@@ -0,0 +1,149 @@
+/**
+ * C-27 — QualityTier settings (CONTRACTS.md). Provider: PRD 11. Flag: A3D_QR_TIERS.
+ * Engine re-export lives in packages/engine/src/contracts/quality re-exports? —
+ * consumers import from @aura3d/rendering/contracts.
+ */
+const MiB = 1024 * 1024;
+/**
+ * Frozen QUALITY_TIERS: PRD 11 §6.3 table values with the R9, R10 and R11
+ * corrections. `targetFrameMs` uses the desktop value; the governor applies
+ * 33.3 on mobile.
+ */
+export const QUALITY_TIERS = {
+    low: {
+        maxPixelRatio: 1, minRenderScale: 0.5, targetFrameMs: 16.7,
+        msaaSamples: 0, postAntiAlias: "fxaa",
+        shadow: { mapSize: 1024, cascades: 1, filter: "pcf2", localShadowLights: 0, contact: false },
+        maxLightsPerPixel: 4,
+        ambientOcclusion: "off", ssr: "off", bloomMipLevels: 3,
+        volumetricFog: "analytic", froxelGrid: null,
+        particleBudget: 2000, softParticles: false, lodBias: 2.0,
+        primitiveSegments: "half", maxTextureSize: 1024, textureBudgetBytes: 128 * MiB,
+        anisotropy: 4, environmentSize: 128, drawBudget: 150
+    },
+    medium: {
+        maxPixelRatio: 1.5, minRenderScale: 0.6, targetFrameMs: 16.7,
+        msaaSamples: 4, postAntiAlias: "none",
+        shadow: { mapSize: 2048, cascades: 2, filter: "pcf3", localShadowLights: 1, contact: false },
+        maxLightsPerPixel: 8,
+        ambientOcclusion: "low", ssr: "off", bloomMipLevels: 5,
+        volumetricFog: "analytic", froxelGrid: null,
+        particleBudget: 10000, softParticles: true, lodBias: 1.5,
+        primitiveSegments: "full", maxTextureSize: 2048, textureBudgetBytes: 256 * MiB,
+        anisotropy: 8, environmentSize: 256, drawBudget: 300
+    },
+    high: {
+        maxPixelRatio: 2, minRenderScale: 0.7, targetFrameMs: 16.7,
+        msaaSamples: 4, postAntiAlias: "none",
+        shadow: { mapSize: 2048, cascades: 3, filter: "pcf5", localShadowLights: 2, contact: false },
+        maxLightsPerPixel: 16,
+        ambientOcclusion: "medium", ssr: "medium", bloomMipLevels: 6,
+        volumetricFog: "froxel-medium", froxelGrid: [160, 90, 64],
+        particleBudget: 50000, softParticles: true, lodBias: 1.0,
+        primitiveSegments: "full", maxTextureSize: 4096, textureBudgetBytes: 512 * MiB,
+        anisotropy: 16, environmentSize: 512, drawBudget: 600
+    },
+    ultra: {
+        maxPixelRatio: 3, minRenderScale: 0.75, targetFrameMs: 16.7,
+        msaaSamples: 4, postAntiAlias: "taa",
+        shadow: { mapSize: 4096, cascades: 4, filter: "pcf5", localShadowLights: 4, contact: true },
+        maxLightsPerPixel: 32,
+        ambientOcclusion: "high", ssr: "high", bloomMipLevels: 6,
+        volumetricFog: "froxel-high", froxelGrid: [240, 135, 128],
+        particleBudget: 100000, softParticles: true, lodBias: 0.75,
+        primitiveSegments: "full", maxTextureSize: 4096, textureBudgetBytes: 1024 * MiB,
+        anisotropy: 16, environmentSize: 1024, drawBudget: 1500
+    }
+};
+const VALIDATORS = {
+    maxPixelRatio: (v) => typeof v === "number" && v > 0 && v <= 8,
+    minRenderScale: (v) => typeof v === "number" && v > 0 && v <= 1,
+    targetFrameMs: (v) => typeof v === "number" && v > 0 && v < 1000,
+    msaaSamples: (v) => v === 0 || v === 4,
+    postAntiAlias: (v) => v === "fxaa" || v === "none" || v === "taa",
+    shadow: (v) => typeof v === "object" && v !== null &&
+        [1024, 2048, 4096].includes(v.mapSize) &&
+        [1, 2, 3, 4].includes(v.cascades) &&
+        ["pcf2", "pcf3", "pcf5"].includes(v.filter) &&
+        typeof v.localShadowLights === "number" &&
+        typeof v.contact === "boolean",
+    maxLightsPerPixel: (v) => v === 4 || v === 8 || v === 16 || v === 32,
+    ambientOcclusion: (v) => v === "off" || v === "low" || v === "medium" || v === "high",
+    ssr: (v) => v === "off" || v === "low" || v === "medium" || v === "high",
+    bloomMipLevels: (v) => v === 3 || v === 5 || v === 6,
+    volumetricFog: (v) => v === "analytic" || v === "froxel-medium" || v === "froxel-high",
+    froxelGrid: (v) => v === null || (Array.isArray(v) && v.length === 3 && v.every((n) => typeof n === "number" && n > 0)),
+    particleBudget: (v) => typeof v === "number" && v >= 0,
+    softParticles: (v) => typeof v === "boolean",
+    lodBias: (v) => typeof v === "number" && v >= 0 && v <= 4,
+    primitiveSegments: (v) => v === "half" || v === "full",
+    maxTextureSize: (v) => v === 1024 || v === 2048 || v === 4096,
+    textureBudgetBytes: (v) => typeof v === "number" && v > 0,
+    anisotropy: (v) => v === 2 || v === 4 || v === 8 || v === 16,
+    environmentSize: (v) => v === 128 || v === 256 || v === 512 || v === 1024,
+    drawBudget: (v) => typeof v === "number" && v > 0
+};
+/** Validates every override key; any invalid value throws QUALITY_OVERRIDE_INVALID:<field>. */
+export function resolveTierSettings(tier, overrides) {
+    const base = QUALITY_TIERS[tier];
+    if (!overrides)
+        return base;
+    const out = { ...base };
+    for (const key of Object.keys(overrides)) {
+        const value = overrides[key];
+        if (value === undefined)
+            continue;
+        if (!VALIDATORS[key](value))
+            throw new Error(`QUALITY_OVERRIDE_INVALID:${key}`);
+        out[key] = value;
+    }
+    return out;
+}
+export function nextLowerTier(tier) {
+    return tier === "ultra" ? "high" : tier === "high" ? "medium" : tier === "medium" ? "low" : null;
+}
+/**
+ * PR 0a stub controller: "auto" resolves to "high" on desktop and "medium" when
+ * matchMedia("(pointer: coarse)"), decision.source "default". set() updates
+ * settings and emits onChange; consumers re-read settings at their next
+ * resolve. forceRenderScale records the request (the engine seam applies it
+ * through the existing canvas sizing in PR 0b).
+ */
+export class StubQualityController {
+    current;
+    overrides;
+    locked = false;
+    scale = null;
+    listeners = new Set();
+    decision;
+    constructor(requested = "auto", overrides, coarsePointer = false) {
+        this.current = requested === "auto" ? (coarsePointer ? "medium" : "high") : requested;
+        this.overrides = overrides;
+        this.decision = { tier: this.current, source: "default", reason: requested === "auto" ? "auto" : "explicit" };
+    }
+    get tier() { return this.current; }
+    get settings() { return resolveTierSettings(this.current, this.overrides); }
+    async set(tier, overrides) {
+        if (this.locked)
+            return;
+        if (this.tier === tier && overrides === this.overrides)
+            return;
+        const from = this.current;
+        if (overrides)
+            resolveTierSettings(tier, overrides);
+        this.current = tier;
+        if (overrides !== undefined)
+            this.overrides = overrides;
+        for (const listener of this.listeners)
+            listener({ from, to: tier, reason: "set" });
+    }
+    lock() { this.locked = true; }
+    unlock() { this.locked = false; }
+    forceRenderScale(scale) { this.scale = scale; }
+    get renderScale() { return this.scale; }
+    onChange(l) {
+        this.listeners.add(l);
+        return () => { this.listeners.delete(l); };
+    }
+}
+//# sourceMappingURL=quality.js.map

package/dist/contracts/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/quality.ts"],"names":[],"mappings":"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"}

package/dist/contracts/renderItem.d.ts

@@ -0,0 +1,58 @@
+/**
+ * RenderItem — moved verbatim from ForwardPass.ts:24-48 per §3.3, re-exported
+ * from ForwardPass.ts. PR 0a additions (declaration-only):
+ *   receiveShadow? (PRD 02), the C-14 previous-frame fields (PRD 03),
+ *   lodFade? (PRD 05), cameraFade? (PRD 08), instanceEmissive? (PRD 11).
+ */
+import type { Geometry } from "../Geometry.js";
+import type { RenderMaterial, SkinningPaletteBinding } from "../ForwardPass.js";
+import type { MorphTargetDelta } from "../MorphTarget.js";
+import type { RenderItemDrawRange, RenderItemInstanceAttribute } from "../ForwardPass.js";
+import type { Texture } from "../Texture.js";
+import type { TextureBinding } from "../TextureBinding.js";
+export interface RenderItem {
+    readonly geometry: Geometry;
+    readonly material?: RenderMaterial;
+    readonly label?: string;
+    readonly drawRange?: RenderItemDrawRange;
+    readonly includeInAutoFrame?: boolean;
+    readonly modelMatrix?: Float32Array | readonly number[];
+    /** C-08 (PRD 01 §8.5): innermost `size ⊙ fit` transform; identity when unset. */
+    readonly geometryMatrix?: Float32Array | readonly number[];
+    readonly normalMatrix?: Float32Array | readonly number[];
+    readonly modelViewProjectionMatrix?: Float32Array | readonly number[];
+    readonly skinning?: SkinningPaletteBinding;
+    readonly morphTargets?: readonly MorphTargetDelta[];
+    readonly morphWeights?: readonly number[];
+    /**
+     * Wrinkle-detail intensity resolved engine-side from live morph weights
+     * (`resolveWrinkleMapStrength`). Shaders that declare `u_wrinkleStrength` modulate
+     * procedural normal detail by it; absent (or zero) leaves rendering bit-identical.
+     */
+    readonly wrinkleStrength?: number;
+    /**
+     * PRD-02 S12 (lane-01 half): per-item environment cube override. When set, the
+     * legacy forward path binds this cube (a captured reflection probe) as
+     * `u_environmentCubeMapTexture` instead of the scene environment's cube, and
+     * `environmentCubeMip` overrides the mip count. Absent → bit-identical.
+     */
+    readonly environmentCube?: TextureBinding;
+    readonly environmentCubeMip?: number;
+    readonly instanceTransforms?: Float32Array | readonly number[];
+    readonly instanceColors?: Float32Array | readonly number[];
+    readonly instanceAttributes?: readonly RenderItemInstanceAttribute[];
+    readonly boundingBoxCenter?: readonly [number, number, number];
+    /** Exclude supporting/decorative geometry from renderer-owned shadow depth passes. */
+    readonly castShadow?: boolean;
+    readonly receiveShadow?: boolean;
+    readonly previousModelMatrix?: Float32Array;
+    readonly previousInstanceTransforms?: Float32Array;
+    readonly previousJointTexture?: Texture;
+    readonly previousMorphWeights?: Float32Array;
+    readonly writesReactive?: boolean;
+    readonly lodFade?: number;
+    readonly lodLevel?: number;
+    readonly cameraFade?: number;
+    readonly instanceEmissive?: Float32Array | readonly number[];
+}
+//# sourceMappingURL=renderItem.d.ts.map

package/dist/contracts/renderItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderItem.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/renderItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IACxD,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IACzD,QAAQ,CAAC,yBAAyB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACrE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,YAAY,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,YAAY,CAAC;IACnD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,YAAY,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;CAC9D"}

package/dist/contracts/renderItem.js

@@ -0,0 +1,8 @@
+/**
+ * RenderItem — moved verbatim from ForwardPass.ts:24-48 per §3.3, re-exported
+ * from ForwardPass.ts. PR 0a additions (declaration-only):
+ *   receiveShadow? (PRD 02), the C-14 previous-frame fields (PRD 03),
+ *   lodFade? (PRD 05), cameraFade? (PRD 08), instanceEmissive? (PRD 11).
+ */
+export {};
+//# sourceMappingURL=renderItem.js.map

package/dist/contracts/renderItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderItem.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/renderItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/contracts/renderSource.d.ts

@@ -0,0 +1,63 @@
+/**
+ * RenderSource — moved verbatim from Renderer.ts:246-292 per §3.3, re-exported
+ * from Renderer.ts. PR 0a adds the flag-off sentinel/fog/environment carry-overs
+ * the post split needs (declaration-only optional fields).
+ */
+import type { Scene, Bounds3 as SceneBounds3 } from "@aura3d/scene";
+import type { RenderTarget } from "../RenderDevice.js";
+import type { Geometry } from "../Geometry.js";
+import type { RenderMaterial, EnvironmentLightingOptions, ForwardEnvironmentFogOptions, ForwardShadowMapOptions } from "../ForwardPass.js";
+import type { MorphTargetDelta } from "../MorphTarget.js";
+import type { RenderItem } from "./renderItem.js";
+import type { EnvironmentBackgroundOptions } from "../EnvironmentBackgroundPass.js";
+import type { StaticBatchOptions } from "../SceneOptimization.js";
+import type { MeshConsolidationOptions } from "../MeshConsolidation.js";
+import type { CollectedLight } from "../LightCollector.js";
+import type { RendererCameraPolicy, RendererCameraFrameOptions, RendererCameraProjection, RendererPostProcessOptions, RenderResourceLookup, RendererShadowOptions } from "../Renderer.js";
+export interface RenderSource {
+    collectRenderItems?(): Iterable<RenderItem>;
+    readonly renderItems?: Iterable<RenderItem>;
+    readonly scene?: Scene;
+    readonly renderTarget?: RenderTarget;
+    readonly cameraPolicy?: RendererCameraPolicy;
+    readonly cameraFrameBounds?: SceneBounds3 | {
+        readonly min: readonly [number, number, number];
+        readonly max: readonly [number, number, number];
+    };
+    readonly cameraFrameOptions?: RendererCameraFrameOptions;
+    /**
+     * Projection used when the renderer frames the scene itself.
+     *
+     * Defaults to `"perspective"`, which is what auto-framing has always
+     * produced. Set `"orthographic"` for views defined by the absence of
+     * foreshortening — CAD and technical drawings, isometric gameplay, floor
+     * plans, sprite bakes, product turntables — where a perspective frustum
+     * renders a visibly different image from the one the scene describes.
+     */
+    readonly cameraProjection?: RendererCameraProjection;
+    readonly collectedLights?: Iterable<CollectedLight>;
+    readonly environmentBackground?: EnvironmentBackgroundOptions | false;
+    readonly environmentLighting?: EnvironmentLightingOptions | false;
+    readonly environmentFog?: ForwardEnvironmentFogOptions | false;
+    readonly shadowMap?: ForwardShadowMapOptions;
+    readonly shadow?: RendererShadowOptions | boolean;
+    readonly postprocess?: RendererPostProcessOptions | boolean;
+    readonly cameraPosition?: readonly [number, number, number];
+    readonly geometryLibrary?: RenderResourceLookup<Geometry>;
+    readonly materialLibrary?: RenderResourceLookup<RenderMaterial>;
+    readonly morphTargetLibrary?: RenderResourceLookup<readonly MorphTargetDelta[]>;
+    readonly frustumCulling?: boolean;
+    readonly staticBatching?: boolean | StaticBatchOptions;
+    /**
+     * Merge distinct static geometries that share a material into single buffers.
+     *
+     * Complements `staticBatching`, which instances one geometry many times and therefore cannot help
+     * when every mesh owns unique geometry — the normal case for architecture exported from level
+     * editors. Consolidation bakes each source model matrix into vertex positions, so it is only valid
+     * for geometry that never moves, deforms, or needs independent culling.
+     *
+     * Applied before batching, so any geometry left unmerged can still be instanced.
+     */
+    readonly staticMeshConsolidation?: boolean | MeshConsolidationOptions;
+}
+//# sourceMappingURL=renderSource.d.ts.map

package/dist/contracts/renderSource.d.ts.map

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

package/dist/contracts/renderSource.js

@@ -0,0 +1,7 @@
+/**
+ * RenderSource — moved verbatim from Renderer.ts:246-292 per §3.3, re-exported
+ * from Renderer.ts. PR 0a adds the flag-off sentinel/fog/environment carry-overs
+ * the post split needs (declaration-only optional fields).
+ */
+export {};
+//# sourceMappingURL=renderSource.js.map

package/dist/contracts/renderSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderSource.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/renderSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/contracts/rendererFactory.d.ts

@@ -0,0 +1,42 @@
+/**
+ * C-29 — renderer factory, backends, frame API, device lifecycle (CONTRACTS.md).
+ * Provider: PRD 11. Flag: A3D_QR_WEBGPU for backend selection; lifecycle itself is flag-free.
+ */
+import type { RenderDevice, RenderDeviceDiagnostics } from "../RenderDevice.js";
+import { type ContractSlot } from "./core.js";
+export interface RendererCreateOptions {
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    readonly width?: number;
+    readonly height?: number;
+    readonly backend?: "webgl2" | "webgpu" | "auto";
+    readonly antialias?: boolean;
+    readonly powerPreference?: "default" | "high-performance" | "low-power";
+    readonly errorCheckMode?: "off" | "frame" | "draw";
+}
+export interface RendererFrameResult {
+    readonly backend: "webgl2" | "webgpu";
+    readonly diagnostics: RenderDeviceDiagnostics;
+    readonly timing: {
+        readonly cpuMs: number;
+        readonly gpuMs: number | null;
+    };
+}
+export interface RendererLifecycle {
+    onDeviceLost(l: () => void): () => void;
+    onDeviceRestored(l: () => void): () => void;
+    isDeviceLost(): boolean;
+}
+export interface ResourceRegistryLike {
+    register<T extends object>(handle: T, descriptor: {
+        readonly kind: string;
+        readonly rebuild: () => Promise<void> | void;
+    }): T;
+    unregister(handle: object): void;
+    rebuild(device: RenderDevice): Promise<{
+        readonly rebuilt: number;
+        readonly refetched: number;
+        readonly failed: readonly string[];
+    }>;
+}
+export declare const resourceRegistrySlot: ContractSlot<() => ResourceRegistryLike>;
+//# sourceMappingURL=rendererFactory.d.ts.map

package/dist/contracts/rendererFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererFactory.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/rendererFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IAAG,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,kBAAkB,GAAG,WAAW,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;CAAE;AAC/V,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAAE;AAC1M,MAAM,WAAW,iBAAiB;IAAG,YAAY,CAAC,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAAC,YAAY,IAAI,OAAO,CAAC;CAAE;AAGrJ,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,CAAC,CAAC;IAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAAE;AA8BhV,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,MAAM,oBAAoB,CACc,CAAC"}

package/dist/contracts/rendererFactory.js

@@ -0,0 +1,32 @@
+/**
+ * C-29 — renderer factory, backends, frame API, device lifecycle (CONTRACTS.md).
+ * Provider: PRD 11. Flag: A3D_QR_WEBGPU for backend selection; lifecycle itself is flag-free.
+ */
+import { defineContractSlot } from "./core.js";
+/** PR 0a stub: records registrations; rebuild invokes each registered rebuild. */
+class StubResourceRegistry {
+    entries = new Map();
+    register(handle, descriptor) {
+        this.entries.set(handle, descriptor);
+        return handle;
+    }
+    unregister(handle) {
+        this.entries.delete(handle);
+    }
+    async rebuild(_device) {
+        let rebuilt = 0;
+        const failed = [];
+        for (const descriptor of this.entries.values()) {
+            try {
+                await descriptor.rebuild();
+                rebuilt += 1;
+            }
+            catch {
+                failed.push(descriptor.kind);
+            }
+        }
+        return { rebuilt, refetched: 0, failed };
+    }
+}
+export const resourceRegistrySlot = defineContractSlot("C-29", "prd11", "A3D_QR_WEBGPU", () => new StubResourceRegistry());
+//# sourceMappingURL=rendererFactory.js.map

package/dist/contracts/rendererFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererFactory.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/rendererFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAS/D,kFAAkF;AAClF,MAAM,oBAAoB;IACP,OAAO,GAAG,IAAI,GAAG,EAAmF,CAAC;IAEtH,QAAQ,CAAmB,MAAS,EAAE,UAAmF;QACvH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAqB;QACjC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAC/B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/contracts/sampling.d.ts

@@ -0,0 +1,23 @@
+/**
+ * C-12 — sampler and texture-sampling descriptors (CONTRACTS.md). Provider: PRD 02
+ * (webgl2/Samplers.ts). SamplerDescriptor (Sampler.ts:11) gains optional fields in PR 0a.
+ */
+import type { AuraQualityTier } from "./quality.js";
+export type AuraTextureWrap = "repeat" | "clamp" | "mirror";
+export interface AuraTextureSampling {
+    readonly wrap?: AuraTextureWrap;
+    readonly filter?: "trilinear" | "bilinear" | "nearest";
+    readonly anisotropy?: number;
+}
+export declare function resolveSamplerAnisotropy(req: {
+    readonly desired?: number;
+    readonly tier?: AuraQualityTier;
+    readonly deviceMax: number;
+}): number;
+export declare function resolveLightingSamplerBudget(programDefines: Readonly<Record<string, unknown>>, materialSamplerCount: number, deviceLimits: {
+    readonly maxTextureImageUnits: number;
+}): {
+    readonly droppedFeatures: readonly string[];
+};
+export declare const LIGHTING_SAMPLER_DROP_ORDER: readonly ["contact-shadow", "irradiance-volume", "reflection-probe-2", "local-shadow-atlas", "sh-texture", "cascade-3", "lobe:iridescence", "lobe:sheen", "lobe:anisotropy", "lobe:clearcoat"];
+//# sourceMappingURL=sampling.d.ts.map

package/dist/contracts/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/sampling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMjD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC5D,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAAE;AAK/J,wBAAgB,wBAAwB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKhJ;AAED,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE;IAAE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAEtO;AACD,eAAO,MAAM,2BAA2B,EAAE,SAAS,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,CAChD,CAAC"}

package/dist/contracts/sampling.js

@@ -0,0 +1,17 @@
+/**
+ * C-12 — sampler and texture-sampling descriptors (CONTRACTS.md). Provider: PRD 02
+ * (webgl2/Samplers.ts). SamplerDescriptor (Sampler.ts:11) gains optional fields in PR 0a.
+ */
+/** R9 table: L4 / M8 / H16 / U16, clamped to the device maximum. */
+const TIER_ANISOTROPY = { low: 4, medium: 8, high: 16, ultra: 16 };
+export function resolveSamplerAnisotropy(req) {
+    const fromTier = req.tier ? TIER_ANISOTROPY[req.tier] : 8;
+    const requested = req.desired ?? fromTier;
+    const clamped = Math.max(1, Math.min(requested, req.deviceMax));
+    return clamped;
+}
+export function resolveLightingSamplerBudget(programDefines, materialSamplerCount, deviceLimits) {
+    return { droppedFeatures: [] };
+}
+export const LIGHTING_SAMPLER_DROP_ORDER = ["contact-shadow", "irradiance-volume", "reflection-probe-2", "local-shadow-atlas", "sh-texture", "cascade-3", "lobe:iridescence", "lobe:sheen", "lobe:anisotropy", "lobe:clearcoat"];
+//# sourceMappingURL=sampling.js.map

package/dist/contracts/sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/sampling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,oEAAoE;AACpE,MAAM,eAAe,GAA8C,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAE9G,MAAM,UAAU,wBAAwB,CAAC,GAA+F;IACtI,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,cAAiD,EAAE,oBAA4B,EAAE,YAAuD;IACnL,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC;AACD,MAAM,CAAC,MAAM,2BAA2B,GACtC,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/contracts/shadows.d.ts

@@ -0,0 +1,53 @@
+/**
+ * C-11 — ShadowCaster depth-variant hook and shadow lookup (CONTRACTS.md). Provider: PRD 02.
+ * Flag: A3D_QR_LIGHTING.
+ */
+import type { RenderItem } from "./renderItem.js";
+import type { QrFlags } from "./core.js";
+import type { ShaderFeature } from "./program.js";
+import type { Texture } from "../Texture.js";
+export interface ShadowCasterVariantKey {
+    readonly skinning: 0 | 4 | 8;
+    readonly skinningTexture: boolean;
+    readonly morphTargets: boolean;
+    readonly instanced: boolean;
+    readonly batched: boolean;
+    readonly alphaTest: boolean;
+    readonly alphaHash: boolean;
+    readonly doubleSided: boolean;
+    readonly features: Readonly<Record<string, string | number | boolean>>;
+}
+/**
+ * PR 0a stub: returns a key with only `instanced` and `doubleSided` filled,
+ * matching today's depth shader (ShaderLibraryCore.ts:784-806). Registered
+ * depth features are stored and applied once PRD 02's DepthPass consumes them.
+ */
+export declare function resolveShadowCasterVariant(item: RenderItem, _flags: QrFlags): ShadowCasterVariantKey;
+export declare function shadowCasterVariantId(key: ShadowCasterVariantKey): string;
+/** Depth-pass feature: same shape as C-02 ShaderFeature but applied to pass "depth" | "distance". */
+export interface DepthVariantFeature extends ShaderFeature {
+    readonly passes: readonly ("depth" | "distance" | "velocity")[];
+}
+export declare function registerDepthVariantFeature(feature: DepthVariantFeature): () => void;
+/** Depth-variant features active under `flags`, in (order, id) order (#751, 02-DEPTH). */
+export declare function depthVariantFeaturesFor(flags: QrFlags): readonly DepthVariantFeature[];
+export interface ShadowFrameUniforms {
+    readonly cascadeTexture: Texture | null;
+    readonly cascadeMatrices: Float32Array;
+    readonly cascadeSplits: Float32Array;
+    readonly cascadeTexelWorld: Float32Array;
+    readonly atlasTexture: Texture | null;
+    readonly localShadowData: Float32Array;
+    readonly perLightShadowIndex: Int32Array;
+}
+/** Published on the C-01 blackboard under "prd02.shadowFrameUniforms". */
+export declare const SHADOW_BLACKBOARD_KEY: "prd02.shadowFrameUniforms";
+/** GLSL (chunk "a3d_prd02_shadow_lookup"): float a3dSunShadowAt(vec3 worldPos); usable in vertex and fragment stages of non-forward passes. */
+export declare const SHADOW_LOOKUP_CHUNK: "a3d_prd02_shadow_lookup";
+export interface SkinnedBoundsProvider {
+    worldBounds(item: RenderItem): Float32Array | null;
+}
+export declare function registerSkinnedBoundsProvider(p: SkinnedBoundsProvider): void;
+/** First provider able to produce bounds wins; null when none is registered or all decline. */
+export declare function skinnedWorldBounds(item: RenderItem): Float32Array | null;
+//# sourceMappingURL=shadows.d.ts.map

package/dist/contracts/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/shadows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,WAAW,sBAAsB;IAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAAE;AAErW;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAYpG;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAgBzE;AAED,qGAAqG;AACrG,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,EAAE,CAAC;CAAE;AAI/H,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAEpF;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,mBAAmB,EAAE,CAEtF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC;IAChK,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC;CACzH;AACD,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,EAAE,2BAAyD,CAAC;AAC9F,+IAA+I;AAC/I,eAAO,MAAM,mBAAmB,EAAE,yBAAqD,CAAC;AACxF,MAAM,WAAW,qBAAqB;IAAG,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;CAAE;AAI9F,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAE5E;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAMxE"}

package/dist/contracts/shadows.js

@@ -0,0 +1,66 @@
+/**
+ * C-11 — ShadowCaster depth-variant hook and shadow lookup (CONTRACTS.md). Provider: PRD 02.
+ * Flag: A3D_QR_LIGHTING.
+ */
+import { createRegistry } from "./core.js";
+/**
+ * PR 0a stub: returns a key with only `instanced` and `doubleSided` filled,
+ * matching today's depth shader (ShaderLibraryCore.ts:784-806). Registered
+ * depth features are stored and applied once PRD 02's DepthPass consumes them.
+ */
+export function resolveShadowCasterVariant(item, _flags) {
+    return {
+        skinning: 0,
+        skinningTexture: false,
+        morphTargets: false,
+        instanced: item.instanceTransforms !== undefined || item.instanceAttributes !== undefined,
+        batched: false,
+        alphaTest: false,
+        alphaHash: false,
+        doubleSided: false,
+        features: {}
+    };
+}
+export function shadowCasterVariantId(key) {
+    const extra = Object.keys(key.features)
+        .sort()
+        .map((name) => `${name}=${String(key.features[name])}`)
+        .join(",");
+    return [
+        `sk${key.skinning}`,
+        key.skinningTexture ? "skt" : "",
+        key.morphTargets ? "m" : "",
+        key.instanced ? "i" : "",
+        key.batched ? "b" : "",
+        key.alphaTest ? "at" : "",
+        key.alphaHash ? "ah" : "",
+        key.doubleSided ? "ds" : "",
+        extra
+    ].filter((part) => part.length > 0).join("|");
+}
+const depthVariantFeatures = createRegistry("depthVariantFeatures");
+export function registerDepthVariantFeature(feature) {
+    return depthVariantFeatures.register(feature);
+}
+/** Depth-variant features active under `flags`, in (order, id) order (#751, 02-DEPTH). */
+export function depthVariantFeaturesFor(flags) {
+    return depthVariantFeatures.active(flags);
+}
+/** Published on the C-01 blackboard under "prd02.shadowFrameUniforms". */
+export const SHADOW_BLACKBOARD_KEY = "prd02.shadowFrameUniforms";
+/** GLSL (chunk "a3d_prd02_shadow_lookup"): float a3dSunShadowAt(vec3 worldPos); usable in vertex and fragment stages of non-forward passes. */
+export const SHADOW_LOOKUP_CHUNK = "a3d_prd02_shadow_lookup";
+const skinnedBoundsProviders = new Set();
+export function registerSkinnedBoundsProvider(p) {
+    skinnedBoundsProviders.add(p);
+}
+/** First provider able to produce bounds wins; null when none is registered or all decline. */
+export function skinnedWorldBounds(item) {
+    for (const provider of skinnedBoundsProviders) {
+        const bounds = provider.worldBounds(item);
+        if (bounds)
+            return bounds;
+    }
+    return null;
+}
+//# sourceMappingURL=shadows.js.map

package/dist/contracts/shadows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/shadows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAIxC;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAgB,EAAE,MAAe;IAC1E,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI,CAAC,kBAAkB,KAAK,SAAS,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS;QACzF,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAA2B;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;SACpC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;SACtD,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO;QACL,KAAK,GAAG,CAAC,QAAQ,EAAE;QACnB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAChC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACxB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACtB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACzB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACzB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC3B,KAAK;KACN,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AAKD,MAAM,oBAAoB,GAAG,cAAc,CAAsB,sBAAsB,CAAC,CAAC;AAEzF,MAAM,UAAU,2BAA2B,CAAC,OAA4B;IACtE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAMD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAgC,2BAA2B,CAAC;AAC9F,+IAA+I;AAC/I,MAAM,CAAC,MAAM,mBAAmB,GAA8B,yBAAyB,CAAC;AAGxF,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEhE,MAAM,UAAU,6BAA6B,CAAC,CAAwB;IACpE,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,KAAK,MAAM,QAAQ,IAAI,sBAAsB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/contracts/testing/ChunkHarness.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ChunkHarness (PR 0a): wraps registered C-02 chunks into a minimal GLSL ES 3.00
+ * vertex+fragment pair so chunks compile in the browser conformance suite and
+ * can be text-checked in unit tests (CONTRACTS.md §C-02 / §3.8).
+ *
+ * Declares both the legacy per-uniform camera symbols and the C-08
+ * AuraFrame/AuraLights uniform blocks so stub chunks compile either way.
+ */
+import type { ShaderChunk } from "../program.js";
+export interface ChunkHarnessProgram {
+    readonly vertex: string;
+    readonly fragment: string;
+}
+export declare function buildChunkHarnessProgram(chunks: readonly ShaderChunk[], entry?: {
+    readonly vertexMain?: string;
+    readonly fragmentMain?: string;
+}): ChunkHarnessProgram;
+//# sourceMappingURL=ChunkHarness.d.ts.map

package/dist/contracts/testing/ChunkHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChunkHarness.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/contracts/testing/ChunkHarness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAkBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,mBAAmB,CAyC1K"}