@aura3d/rendering 3.0.1 → 4.0.2

package/dist/contracts/core.js

@@ -0,0 +1,70 @@
+/**
+ * Aura3D Quality Rebuild — shared contract mechanics (CONTRACTS.md §1.1).
+ *
+ * `@aura3d/rendering` is the lowest package shared by renderer, assets and
+ * engine. Every cross-PRD dependency is a numbered contract with a frozen
+ * TypeScript surface, a stub shipped in PR 0, and a conformance test. The real
+ * implementation replaces the stub behind a flag; consumers never change code
+ * at swap time.
+ */
+class ContractSlotImpl {
+    id;
+    owner;
+    flag;
+    stub;
+    real;
+    constructor(id, owner, flag, stub) {
+        this.id = id;
+        this.owner = owner;
+        this.flag = flag;
+        this.stub = stub;
+    }
+    get provided() {
+        return this.real !== undefined;
+    }
+    provide(real) {
+        if (this.real !== undefined) {
+            throw new Error(`CONTRACT_ALREADY_PROVIDED:${this.id}`);
+        }
+        this.real = real;
+    }
+    get(flags) {
+        if (this.real !== undefined && flags.on(this.flag)) {
+            return this.real;
+        }
+        return this.stub;
+    }
+}
+export function defineContractSlot(id, owner, flag, stub) {
+    return new ContractSlotImpl(id, owner, flag, stub);
+}
+class RegistryImpl {
+    name;
+    entries = new Map();
+    constructor(name) {
+        this.name = name;
+    }
+    register(entry) {
+        if (this.entries.has(entry.id)) {
+            throw new Error(`REGISTRY_DUPLICATE:${entry.id}`);
+        }
+        this.entries.set(entry.id, entry);
+        return () => {
+            if (this.entries.get(entry.id) === entry) {
+                this.entries.delete(entry.id);
+            }
+        };
+    }
+    active(flags) {
+        return [...this.entries.values()]
+            .filter((entry) => flags.on(entry.flag))
+            .sort((a, b) => (a.order ?? 0) - (b.order ?? 0) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    }
+    all() {
+        return [...this.entries.values()];
+    }
+}
+export function createRegistry(name) {
+    return new RegistryImpl(name);
+}
+//# sourceMappingURL=core.js.map

package/dist/contracts/core.js.map

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

package/dist/contracts/deform.d.ts

@@ -0,0 +1,38 @@
+/**
+ * C-18 — deform hook point (CONTRACTS.md). Provider: PRD 06. Flag: A3D_QR_ANIMATION.
+ */
+import type { ProgramFeatures } from "./program.js";
+import type { Texture } from "../Texture.js";
+export interface SkinningPaletteBinding {
+    readonly kind: "palette" | "skeleton" | "uniforms";
+    readonly mode: "rgba32f-texture" | "rgba16f-texture" | "mat4-uniforms" | "mat3x4-uniforms";
+    readonly texture?: Texture;
+    readonly matrices?: Float32Array;
+    readonly boneCount: number;
+}
+export interface DeformVertexContext {
+    readonly item: import("./renderItem.js").RenderItem;
+    readonly features: ProgramFeatures;
+}
+export interface MorphTargetTexture {
+    readonly texture: Texture;
+    readonly width: number;
+    readonly height: number;
+    rowOf(vertex: number, target: number): number;
+}
+export interface SkinningDeformer {
+    readonly mode: "linear" | "dual-quat";
+    paletteFor(item: import("./renderItem.js").RenderItem): SkinningPaletteBinding;
+}
+export declare const DEFORM_CHUNKS: Readonly<Record<"skinning" | "morph" | "instance", string>>;
+/** C-02 feature id PRD 06 registers: "prd06.deform". `vertexPars` + `vertex` chunks are owner-scoped. */
+export declare const deformFeatureId: "prd06.deform";
+/**
+ * PR 0a stub: returns {fallback:"cpu", reason:"PRD06_PENDING"} — morphs keep
+ * running on the CPU path exactly as today (agent-api/index.ts skinningTexture is untouched).
+ */
+export declare function buildMorphTargetTexture(item: import("./renderItem.js").RenderItem): MorphTargetTexture | {
+    readonly fallback: "cpu";
+    readonly reason: string;
+};
+//# sourceMappingURL=deform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deform.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/deform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,sBAAsB;IAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAAE;AACrR,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,cAAc,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CAAE;AAC9H,MAAM,WAAW,kBAAkB;IAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAAE;AAClK,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,UAAU,CAAC,IAAI,EAAE,OAAO,cAAc,EAAE,UAAU,GAAG,sBAAsB,CAAC;CAAE;AACzJ,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,GAAG,OAAO,GAAG,UAAU,EAAE,MAAM,CAAC,CAAgG,CAAC;AACvL,yGAAyG;AACzG,eAAO,MAAM,eAAe,EAAE,cAA+B,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,cAAc,EAAE,UAAU,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAE3J"}

package/dist/contracts/deform.js

@@ -0,0 +1,14 @@
+/**
+ * C-18 — deform hook point (CONTRACTS.md). Provider: PRD 06. Flag: A3D_QR_ANIMATION.
+ */
+export const DEFORM_CHUNKS = { skinning: "a3d_prd06_skinning", morph: "a3d_prd06_morph", instance: "a3d_prd01_instance" };
+/** C-02 feature id PRD 06 registers: "prd06.deform". `vertexPars` + `vertex` chunks are owner-scoped. */
+export const deformFeatureId = "prd06.deform";
+/**
+ * PR 0a stub: returns {fallback:"cpu", reason:"PRD06_PENDING"} — morphs keep
+ * running on the CPU path exactly as today (agent-api/index.ts skinningTexture is untouched).
+ */
+export function buildMorphTargetTexture(item) {
+    return { fallback: "cpu", reason: "PRD06_PENDING" };
+}
+//# sourceMappingURL=deform.js.map

package/dist/contracts/deform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deform.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/deform.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,CAAC,MAAM,aAAa,GAAgE,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;AACvL,yGAAyG;AACzG,MAAM,CAAC,MAAM,eAAe,GAAmB,cAAc,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAuC;IAC7E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AACtD,CAAC"}

package/dist/contracts/device.d.ts

@@ -0,0 +1,71 @@
+/**
+ * C-28 — device capabilities: probe, counters, compileAsync, FrameStats, resource
+ * registry (CONTRACTS.md). Provider: PRD 11. Flag: A3D_QR_TIERS. RenderDevice
+ * gains optional members in PR 0a (declared on RenderDevice.ts).
+ */
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { TextureFormat } from "../Texture.js";
+import { type ContractSlot } from "./core.js";
+export interface DeviceProbe {
+    readonly backend: "webgl2" | "webgpu";
+    readonly rendererString: string;
+    readonly unmaskedRenderer: string | null;
+    readonly unmaskedVendor: string | null;
+    readonly maxTextureSize: number;
+    readonly maxSamples: number;
+    readonly floatColorBuffer: boolean;
+    readonly halfFloatColorBuffer: boolean;
+    readonly timerQuery: boolean;
+    readonly parallelShaderCompile: boolean;
+    readonly multiDraw: boolean;
+    readonly devicePixelRatio: number;
+    readonly screen: readonly [number, number];
+    readonly hardwareConcurrency: number | null;
+    readonly deviceMemoryGB: number | null;
+    readonly mobile: boolean | null;
+}
+export interface DeviceCounters {
+    readonly drawCalls: number;
+    readonly bufferCreates: number;
+    readonly textureUploads: number;
+    readonly readbacks: number;
+    readonly renderTargetsCreated: number;
+    readonly programCompiles: number;
+    readonly liveBuffers: number;
+    readonly liveVertexArrays: number;
+    readonly textureBytes: number;
+    readonly renderTargetBytes: number;
+}
+export interface FrameStatsSample {
+    readonly intervalMs: number;
+    readonly cpuFrameMs: number;
+    readonly cpuSubmitMs: number;
+    readonly gpuMs: number | null;
+    readonly scopes: Readonly<Record<string, number>>;
+}
+export interface FrameStatsLike {
+    begin(ts: number): void;
+    end(): FrameStatsSample;
+    scope<T>(name: "shadow" | "forward" | "post" | "particles" | string, fn: () => T): T;
+    percentiles(field: "intervalMs" | "cpuFrameMs" | "cpuSubmitMs" | "gpuMs"): {
+        readonly p50: number;
+        readonly p95: number;
+        readonly p99: number;
+        readonly max: number;
+    };
+    fps(): number | null;
+}
+export declare const frameStatsSlot: ContractSlot<(capacity?: number) => FrameStatsLike>;
+export interface RenderTargetPoolLike {
+    acquire(desc: {
+        width: number;
+        height: number;
+        format: TextureFormat;
+        samples: 1 | 4;
+        depth: boolean;
+    }): RenderTarget;
+    release(t: RenderTarget): void;
+    trim(maxIdleFrames: number): void;
+}
+export declare const renderTargetPoolSlot: ContractSlot<(device: RenderDevice) => RenderTargetPoolLike>;
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/device.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAA0B,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,WAAW;IAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAAE;AAC7mB,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAAE;AAQzW,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAAE;AAC/M,MAAM,WAAW,cAAc;IAAG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,IAAI,gBAAgB,CAAC;IAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAAC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,GAAG,IAAI,MAAM,GAAG,IAAI,CAAC;CAAE;AA6ExW,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,cAAc,CACc,CAAC;AAE9F,MAAM,WAAW,oBAAoB;IAAG,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,YAAY,CAAC;IAAC,OAAO,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE;AAsBnO,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,oBAAoB,CACK,CAAC"}

package/dist/contracts/device.js

@@ -0,0 +1,97 @@
+/**
+ * C-28 — device capabilities: probe, counters, compileAsync, FrameStats, resource
+ * registry (CONTRACTS.md). Provider: PRD 11. Flag: A3D_QR_TIERS. RenderDevice
+ * gains optional members in PR 0a (declared on RenderDevice.ts).
+ */
+import { defineContractSlot } from "./core.js";
+/**
+ * PR 0a stub FrameStats — real because it is pure: rAF/draw intervals, CPU
+ * timings, scope aggregation; gpuMs is null until PRD 11's timer queries land.
+ */
+class FrameStats {
+    frameStart = 0;
+    submitStart = 0;
+    samples = [];
+    activeScopes = {};
+    capacity;
+    constructor(capacity = 120) {
+        this.capacity = capacity;
+    }
+    lastBeginTs = 0;
+    begin(ts) {
+        this.frameStart = ts;
+        this.submitStart = ts;
+        this.activeScopes = {};
+    }
+    end() {
+        const now = nowMs();
+        const intervalMs = this.lastBeginTs === 0 ? 0 : this.frameStart - this.lastBeginTs;
+        this.lastBeginTs = this.frameStart;
+        const sample = {
+            intervalMs,
+            cpuFrameMs: now - this.frameStart,
+            cpuSubmitMs: now - this.submitStart,
+            gpuMs: null,
+            scopes: { ...this.activeScopes }
+        };
+        this.pushSample(sample);
+        return sample;
+    }
+    scope(name, fn) {
+        const start = nowMs();
+        try {
+            return fn();
+        }
+        finally {
+            this.activeScopes[name] = (this.activeScopes[name] ?? 0) + (nowMs() - start);
+        }
+    }
+    percentiles(field) {
+        const values = this.samples
+            .map((sample) => sample[field])
+            .filter((v) => v !== null)
+            .sort((a, b) => a - b);
+        if (values.length === 0)
+            return { p50: 0, p95: 0, p99: 0, max: 0 };
+        const pick = (q) => values[Math.min(values.length - 1, Math.floor(q * values.length))];
+        return { p50: pick(0.5), p95: pick(0.95), p99: pick(0.99), max: values[values.length - 1] };
+    }
+    /** Measured fps: null until 30 samples exist. Never a constant 60. */
+    fps() {
+        if (this.samples.length < 30)
+            return null;
+        const recent = this.samples.slice(-30);
+        const mean = recent.reduce((sum, sample) => sum + sample.intervalMs, 0) / recent.length;
+        return mean > 0 ? 1000 / mean : null;
+    }
+    pushSample(sample) {
+        this.samples.push(sample);
+        if (this.samples.length > this.capacity)
+            this.samples.shift();
+    }
+}
+function nowMs() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+export const frameStatsSlot = defineContractSlot("C-28", "prd11", "A3D_QR_TIERS", (capacity) => new FrameStats(capacity));
+/** PR 0a stub: creates targets on every acquire and disposes them on release. */
+class StubRenderTargetPool {
+    device;
+    constructor(device) {
+        this.device = device;
+    }
+    acquire(desc) {
+        const target = this.device.createRenderTarget(desc);
+        target.__qrPooled = true;
+        return target;
+    }
+    release(t) {
+        if (t.__qrPooled) {
+            delete t.__qrPooled;
+            t.dispose();
+        }
+    }
+    trim(_maxIdleFrames) { }
+}
+export const renderTargetPoolSlot = defineContractSlot("C-28", "prd11", "A3D_QR_TIERS", (device) => new StubRenderTargetPool(device));
+//# sourceMappingURL=device.js.map

package/dist/contracts/device.js.map

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

package/dist/contracts/environment.d.ts

@@ -0,0 +1,55 @@
+/**
+ * C-09 — EnvironmentSource / EnvironmentProbe (CONTRACTS.md). Provider: PRD 02.
+ * Flag: A3D_QR_LIGHTING.
+ */
+import type { Texture } from "../Texture.js";
+import type { RenderTarget } from "../RenderDevice.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import { type ContractSlot } from "./core.js";
+import type { AuraQualityTier } from "./quality.js";
+export interface EnvironmentProbe {
+    readonly kind: "environment-probe";
+    readonly specularCube: Texture;
+    readonly mipCount: number;
+    readonly faceSize: 128 | 256 | 512 | 1024;
+    readonly sh9: Float32Array;
+    readonly shTexture: Texture | null;
+    readonly background: Texture | null;
+    readonly source: "neutral" | "preset" | "hdri" | "capture" | "sky" | "space-bake" | "legacy";
+    dispose(): void;
+}
+export interface EnvironmentCaptureRequest {
+    renderFace(face: 0 | 1 | 2 | 3 | 4 | 5, target: RenderTarget, viewProjection: Float32Array): void;
+    readonly resolution: 64 | 128 | 256;
+}
+export interface EnvironmentProbeFactory {
+    fromEquirect(src: Texture, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    fromCube(src: Texture, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    fromScene(req: EnvironmentCaptureRequest, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    neutral(tier: AuraQualityTier): EnvironmentProbe;
+}
+/**
+ * True for the pending stub (C-09 slot not provided yet, or A3D_QR_LIGHTING
+ * off). Consumers keep their fallback environment instead of calling it.
+ */
+export declare function isEnvironmentProbeFactoryPending(factory: EnvironmentProbeFactory): boolean;
+export declare const environmentProbeFactorySlot: ContractSlot<(device: RenderDevice) => EnvironmentProbeFactory>;
+/** Real SH2 projection of six cube faces (row-major RGBA texels per face). */
+export declare function projectCubeToSH9(faces: readonly Float32Array[], faceSize: number): Float32Array;
+export declare function evaluateSH9Irradiance(sh9: Float32Array, normal: readonly [number, number, number]): [number, number, number];
+/** GLSL entry points every consumer may call (chunk "a3d_prd02_sh9"): vec3 a3dSampleIrradianceSH(vec3 N); uniform block A3DSH9 { vec4 u_sh9[9]; } */
+export declare const SH9_CHUNK: "a3d_prd02_sh9";
+/**
+ * E3 stage-2b: ShaderFeature id of the PRD-02 IBL indirect-body replacement.
+ * The feature is registered by lane prd02 under `A3D_QR_LIGHTING`; its
+ * `select` (and the C-02 generator) additionally require `A3D_QR_COMPILER`,
+ * so the bit only ever reaches a program under the E3 conjunction.
+ */
+export declare const PRD02_IBL_FEATURE: "prd02.ibl";
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC7F,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,MAAM,WAAW,yBAAyB;IAAG,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;CAAE;AACtL,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB,CAAC;IAC9F,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB,CAAC;IAC1F,SAAS,CAAC,GAAG,EAAE,yBAAyB,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB,CAAC;IAC7G,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC;CAClD;AAcD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAE1F;AAED,eAAO,MAAM,2BAA2B,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,uBAAuB,CACrB,CAAC;AAEpF,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAkC/F;AA0BD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAoB5H;AAED,qJAAqJ;AACrJ,eAAO,MAAM,SAAS,EAAE,eAAiC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAyB,CAAC"}

package/dist/contracts/environment.js

@@ -0,0 +1,115 @@
+/**
+ * C-09 — EnvironmentSource / EnvironmentProbe (CONTRACTS.md). Provider: PRD 02.
+ * Flag: A3D_QR_LIGHTING.
+ */
+import { defineContractSlot } from "./core.js";
+/**
+ * PR 0a placeholder: the documented stub arrives in PR 0b wrapping the existing
+ * PMREM path (production-runtime/environment/PMREMGenerator.ts). Until then the
+ * factory reports pending so no consumer can mistake it for the real one.
+ */
+const probeFactoryPending = {
+    fromEquirect() { throw new Error("ENVIRONMENT_PROBE_PENDING:fromEquirect"); },
+    fromCube() { throw new Error("ENVIRONMENT_PROBE_PENDING:fromCube"); },
+    fromScene() { throw new Error("ENVIRONMENT_PROBE_PENDING:fromScene"); },
+    neutral() { throw new Error("ENVIRONMENT_PROBE_PENDING:neutral"); }
+};
+/**
+ * True for the pending stub (C-09 slot not provided yet, or A3D_QR_LIGHTING
+ * off). Consumers keep their fallback environment instead of calling it.
+ */
+export function isEnvironmentProbeFactoryPending(factory) {
+    return factory === probeFactoryPending;
+}
+export const environmentProbeFactorySlot = defineContractSlot("C-09", "prd02", "A3D_QR_LIGHTING", () => probeFactoryPending);
+/** Real SH2 projection of six cube faces (row-major RGBA texels per face). */
+export function projectCubeToSH9(faces, faceSize) {
+    const result = new Float32Array(27);
+    const faceDirs = [
+        // GL cube-map basis [n, U(+s), V(+t)] (02 IBL fix; matches the lane-02
+        // CUBE_FACE_BASIS — the previous table had U and V swapped on every face).
+        [[1, 0, 0], [0, 0, -1], [0, -1, 0]],
+        [[-1, 0, 0], [0, 0, 1], [0, -1, 0]],
+        [[0, 1, 0], [1, 0, 0], [0, 0, 1]],
+        [[0, -1, 0], [1, 0, 0], [0, 0, -1]],
+        [[0, 0, 1], [1, 0, 0], [0, -1, 0]],
+        [[0, 0, -1], [-1, 0, 0], [0, -1, 0]]
+    ];
+    const step = 2 / faceSize;
+    for (let f = 0; f < 6; f++) {
+        const face = faces[f];
+        if (!face)
+            continue;
+        const [n, u, v] = faceDirs[f];
+        for (let y = 0; y < faceSize; y++) {
+            const fv = (y + 0.5) * step - 1;
+            for (let x = 0; x < faceSize; x++) {
+                const fu = (x + 0.5) * step - 1;
+                const dx = n[0] + u[0] * fu + v[0] * fv;
+                const dy = n[1] + u[1] * fu + v[1] * fv;
+                const dz = n[2] + u[2] * fu + v[2] * fv;
+                const len = Math.hypot(dx, dy, dz);
+                const nx = dx / len, ny = dy / len, nz = dz / len;
+                const weight = 4 / (len * len * faceSize * faceSize * Math.PI) * Math.PI; // solid angle approx
+                const i = (y * faceSize + x) * 4;
+                const r = face[i], g = face[i + 1], b = face[i + 2];
+                accumulateSH9(result, nx, ny, nz, r, g, b, weight);
+            }
+        }
+    }
+    return result;
+}
+function accumulateSH9(out, x, y, z, r, g, b, w) {
+    const c0 = 0.282095;
+    const c1 = 0.488603;
+    const c2 = 1.092548;
+    const c3 = 0.315392;
+    const c4 = 0.546274;
+    const basis = [
+        c0,
+        -c1 * y,
+        c1 * z,
+        -c1 * x,
+        c2 * x * y,
+        c2 * y * z,
+        c3 * (3 * z * z - 1),
+        c2 * x * z,
+        c4 * (x * x - y * y)
+    ];
+    for (let i = 0; i < 9; i++) {
+        out[i * 3] += basis[i] * r * w;
+        out[i * 3 + 1] += basis[i] * g * w;
+        out[i * 3 + 2] += basis[i] * b * w;
+    }
+}
+export function evaluateSH9Irradiance(sh9, normal) {
+    const [x, y, z] = normal;
+    const basis = [
+        0.886227, // sqrt(pi)/2 * c0 scaled for irradiance convolution
+        -1.023328 * y,
+        1.023328 * z,
+        -1.023328 * x,
+        0.858086 * x * y,
+        0.858086 * y * z,
+        0.247708 * (3 * z * z - 1),
+        0.858086 * x * z,
+        0.429043 * (x * x - y * y)
+    ];
+    const out = [0, 0, 0];
+    for (let i = 0; i < 9; i++) {
+        out[0] += basis[i] * sh9[i * 3];
+        out[1] += basis[i] * sh9[i * 3 + 1];
+        out[2] += basis[i] * sh9[i * 3 + 2];
+    }
+    return out;
+}
+/** GLSL entry points every consumer may call (chunk "a3d_prd02_sh9"): vec3 a3dSampleIrradianceSH(vec3 N); uniform block A3DSH9 { vec4 u_sh9[9]; } */
+export const SH9_CHUNK = "a3d_prd02_sh9";
+/**
+ * E3 stage-2b: ShaderFeature id of the PRD-02 IBL indirect-body replacement.
+ * The feature is registered by lane prd02 under `A3D_QR_LIGHTING`; its
+ * `select` (and the C-02 generator) additionally require `A3D_QR_COMPILER`,
+ * so the bit only ever reaches a program under the E3 conjunction.
+ */
+export const PRD02_IBL_FEATURE = "prd02.ibl";
+//# sourceMappingURL=environment.js.map

package/dist/contracts/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAsB/D;;;;GAIG;AACH,MAAM,mBAAmB,GAA4B;IACnD,YAAY,KAAK,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC,CAAC;IAC7E,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC;IACrE,SAAS,KAAK,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAgC;IAC/E,OAAO,OAAO,KAAK,mBAAmB,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GACtC,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,CAAC;AAEpF,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,KAA8B,EAAE,QAAgB;IAC/E,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG;QACf,uEAAuE;QACvE,2EAA2E;QAC3E,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;KAC5B,CAAC;IACX,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;gBAChC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;gBACxC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;gBACxC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;gBACnC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;gBAClD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,qBAAqB;gBAC/F,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBACjC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACpD,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,GAAiB,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;IACnH,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpB,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpB,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpB,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpB,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpB,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,CAAC,EAAE,GAAG,CAAC;QACP,EAAE,GAAG,CAAC;QACN,CAAC,EAAE,GAAG,CAAC;QACP,EAAE,GAAG,CAAC,GAAG,CAAC;QACV,EAAE,GAAG,CAAC,GAAG,CAAC;QACV,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,EAAE,GAAG,CAAC,GAAG,CAAC;QACV,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KACrB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAiB,EAAE,MAAyC;IAChG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;IACzB,MAAM,KAAK,GAAG;QACZ,QAAQ,EAAwB,oDAAoD;QACpF,CAAC,QAAQ,GAAG,CAAC;QACb,QAAQ,GAAG,CAAC;QACZ,CAAC,QAAQ,GAAG,CAAC;QACb,QAAQ,GAAG,CAAC,GAAG,CAAC;QAChB,QAAQ,GAAG,CAAC,GAAG,CAAC;QAChB,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,QAAQ,GAAG,CAAC,GAAG,CAAC;QAChB,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KAC3B,CAAC;IACF,MAAM,GAAG,GAA6B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qJAAqJ;AACrJ,MAAM,CAAC,MAAM,SAAS,GAAoB,eAAe,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgB,WAAW,CAAC"}

package/dist/contracts/flags.state.d.ts

@@ -0,0 +1,15 @@
+/**
+ * §5.3 — flag states and defaults. Custodian-owned (PRD 15 / G5).
+ *
+ * Owner decision 2026-10-11 (#839): no checkpoint wait. A flag moves to
+ * `default-on` in its own PR as soon as its GPU (L4) screenshots render
+ * correctly, score above flags-off, and the `all` run stays green; the PR
+ * carries the before/after pair. `default-on` is honoured by resolveQrFlags:
+ * the flag is on unless a source sets it explicitly (`none`, `-x`, `=0`).
+ */
+import type { QrFlagName } from "./core.js";
+export type QrFlagState = "dev" | "standalone-accepted" | "integrated-accepted" | "default-on" | "removed";
+export declare const QR_FLAG_STATES: Readonly<Partial<Record<QrFlagName, QrFlagState>>>;
+/** §5.4 — flags removed after two consecutive default-on checkpoints. */
+export declare const REMOVED_QR_FLAGS: readonly QrFlagName[];
+//# sourceMappingURL=flags.state.d.ts.map

package/dist/contracts/flags.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.state.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/flags.state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,YAAY,GAAG,SAAS,CAAC;AAE3G,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAgC7E,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAO,CAAC"}

package/dist/contracts/flags.state.js

@@ -0,0 +1,45 @@
+/**
+ * §5.3 — flag states and defaults. Custodian-owned (PRD 15 / G5).
+ *
+ * Owner decision 2026-10-11 (#839): no checkpoint wait. A flag moves to
+ * `default-on` in its own PR as soon as its GPU (L4) screenshots render
+ * correctly, score above flags-off, and the `all` run stays green; the PR
+ * carries the before/after pair. `default-on` is honoured by resolveQrFlags:
+ * the flag is on unless a source sets it explicitly (`none`, `-x`, `=0`).
+ */
+export const QR_FLAG_STATES = {
+    // Promoted 2026-10-11 (owner rule): GPU L4 promote run 38172695387 on
+    // 1102f10ae, PASS, mean LPIPS vs three.js 0.0750 -> 0.0573, 0 regressed beyond noise.
+    A3D_QR_CORE: "default-on",
+    // Promoted 2026-10-11 (owner rule): GPU L4 promote run 38159877336 on
+    // 8b38273f, PASS, mean LPIPS vs three.js 0.1972 -> 0.1785, 0 regressed.
+    A3D_QR_LIGHTING: "default-on",
+    // Promoted 2026-10-11 (owner rule): GPU L4 promote run 38210220126 on
+    // 154cb93f5, PASS, mean LPIPS vs three.js 0.0444 -> 0.0441, 0 regressed.
+    A3D_QR_POST: "default-on",
+    // Promoted 2026-10-11 (owner rule): GPU L4 promote run 38197365077 on
+    // e0701cccd, PASS, mean LPIPS vs three.js 0.1684 -> 0.1630 over 30 scenes, 0 regressed.
+    A3D_QR_MATERIALS: "default-on",
+    // Promoted 2026-10-11 (owner rule): GPU L4 promote run 38198433913 on
+    // b596b4a81, PASS, mean LPIPS vs three.js 0.1684 -> 0.1111 over 24 scenes, 0 regressed.
+    A3D_QR_ASSETS: "default-on",
+    // Promoted 2026-10-12 (owner rule): GPU L4 promote run 38210437847 on
+    // 86dad98c8, PASS, mean LPIPS vs three.js 0.0506 -> 0.0502 over 21 scenes, 0 regressed.
+    A3D_QR_ANIMATION: "default-on",
+    // Promoted 2026-10-12 (owner rule): GPU L4 promote run 38226517198 on
+    // 17c57cf5d, PASS, mean LPIPS vs three.js 0.1158 -> 0.0950 over 34 scenes, 0 regressed.
+    A3D_QR_VFX: "default-on",
+    A3D_QR_CAMERA: "default-on",
+    A3D_QR_GAME: "dev",
+    A3D_QR_WORLD: "dev",
+    A3D_QR_TIERS: "dev",
+    A3D_QR_WEBGPU: "dev",
+    A3D_QR_LOOKS: "dev",
+    // Promoted 2026-10-13 (owner rule): GPU L4 promote run 38455588100 on
+    // 0b97a9305, PASS, mean LPIPS vs three.js 0.0368 -> 0.0367 over 19 scenes, 0 regressed.
+    A3D_QR_COMPILER: "default-on",
+    A3D_QR_STRICT: "dev"
+};
+/** §5.4 — flags removed after two consecutive default-on checkpoints. */
+export const REMOVED_QR_FLAGS = [];
+//# sourceMappingURL=flags.state.js.map

package/dist/contracts/flags.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.state.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/flags.state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,CAAC,MAAM,cAAc,GAAuD;IAChF,sEAAsE;IACtE,sFAAsF;IACtF,WAAW,EAAE,YAAY;IACzB,sEAAsE;IACtE,wEAAwE;IACxE,eAAe,EAAE,YAAY;IAC7B,sEAAsE;IACtE,yEAAyE;IACzE,WAAW,EAAE,YAAY;IACzB,sEAAsE;IACtE,wFAAwF;IACxF,gBAAgB,EAAE,YAAY;IAC9B,sEAAsE;IACtE,wFAAwF;IACxF,aAAa,EAAE,YAAY;IAC3B,sEAAsE;IACtE,wFAAwF;IACxF,gBAAgB,EAAE,YAAY;IAC9B,sEAAsE;IACtE,wFAAwF;IACxF,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,YAAY;IAC3B,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,KAAK;IACnB,sEAAsE;IACtE,wFAAwF;IACxF,eAAe,EAAE,YAAY;IAC7B,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAA0B,EAAE,CAAC"}