@aura3d/rendering 3.0.0 → 4.0.0

package/dist/contracts/frameGraph.d.ts

@@ -0,0 +1,78 @@
+/**
+ * C-01 — frame graph phase hooks (CONTRACTS.md). Provider: PRD 01.
+ * File: packages/rendering/src/contracts/frameGraph.ts.
+ * Seam: packages/rendering/src/renderer/FrameGraph.ts (PR 0b).
+ */
+import type { RenderPass } from "../RenderPass.js";
+import type { RenderItem } from "./renderItem.js";
+import type { RenderSource } from "./renderSource.js";
+import type { CameraLike } from "./frameUniforms.js";
+import type { AuraQualityTierSettings } from "./quality.js";
+import type { QrFlags, PrdId, QrFlagName, RegistryEntry } from "./core.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import type { Texture } from "../Texture.js";
+export type AuraFramePhase = "collect" | "shadows" | "background" | "opaque" | "after-opaque" | "transmission" | "transparent" | "after-transparent" | "post-hdr" | "output" | "after-output";
+/** Well-known frame resource names (RenderGraph reads/writes). */
+export declare const FRAME_RESOURCES: {
+    readonly sceneColor: "aura.scene.color";
+    readonly sceneDepth: "aura.scene.depth";
+    readonly sceneDepthCopy: "aura.scene.depth.copy";
+    readonly sceneVelocity: "aura.scene.velocity";
+    readonly sceneReactive: "aura.scene.reactive";
+    readonly sceneColorCopy: "aura.scene.color.copy";
+    readonly shadowMaps: "aura.shadow.maps";
+    readonly output: "aura.output";
+};
+export interface FrameCamera extends CameraLike {
+    readonly viewMatrix: Float32Array;
+    readonly projectionMatrix: Float32Array;
+    readonly viewProjectionMatrix: Float32Array;
+    readonly previousViewProjectionMatrix: Float32Array | null;
+    readonly near: number;
+    readonly far: number;
+    readonly projection: "perspective" | "orthographic";
+    readonly position: readonly [number, number, number];
+}
+export interface TransparentQueueItem {
+    readonly sortDepth: number;
+    readonly order?: number;
+    draw(ctx: FrameContributorContext): void;
+}
+export interface SceneDepthSource {
+    readonly texture: Texture | null;
+    readonly linearize: {
+        readonly near: number;
+        readonly far: number;
+        readonly orthographic: boolean;
+    };
+    readonly available: boolean;
+}
+export interface FrameContributorContext {
+    readonly device: RenderDevice;
+    readonly width: number;
+    readonly height: number;
+    readonly frameIndex: number;
+    readonly timeSeconds: number;
+    readonly camera: FrameCamera | null;
+    readonly source: RenderSource;
+    readonly items: readonly RenderItem[];
+    readonly tier: AuraQualityTierSettings;
+    readonly flags: QrFlags;
+    readonly sceneDepth: SceneDepthSource;
+    /** Publish/read cross-pass values (e.g. "shadow.frameUniforms"); keys namespaced "<prdNN>.<name>". */
+    readonly blackboard: Map<string, unknown>;
+}
+export interface FrameContributor extends RegistryEntry {
+    readonly id: string;
+    readonly owner: PrdId;
+    readonly flag: QrFlagName;
+    readonly phases: readonly AuraFramePhase[];
+    readonly order?: number;
+    collect?(items: RenderItem[], ctx: FrameContributorContext): RenderItem[];
+    passes?(phase: AuraFramePhase, ctx: FrameContributorContext): readonly RenderPass[];
+    transparentItems?(ctx: FrameContributorContext): readonly TransparentQueueItem[];
+    dispose?(): void;
+}
+export declare function registerFrameContributor(contributor: FrameContributor): () => void;
+export declare function frameContributors(flags: QrFlags): readonly FrameContributor[];
+//# sourceMappingURL=frameGraph.d.ts.map

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

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

package/dist/contracts/frameGraph.js

@@ -0,0 +1,32 @@
+/**
+ * C-01 — frame graph phase hooks (CONTRACTS.md). Provider: PRD 01.
+ * File: packages/rendering/src/contracts/frameGraph.ts.
+ * Seam: packages/rendering/src/renderer/FrameGraph.ts (PR 0b).
+ */
+/** Well-known frame resource names (RenderGraph reads/writes). */
+export const FRAME_RESOURCES = {
+    sceneColor: "aura.scene.color",
+    sceneDepth: "aura.scene.depth",
+    sceneDepthCopy: "aura.scene.depth.copy",
+    sceneVelocity: "aura.scene.velocity",
+    sceneReactive: "aura.scene.reactive",
+    sceneColorCopy: "aura.scene.color.copy",
+    shadowMaps: "aura.shadow.maps",
+    output: "aura.output"
+};
+import { createRegistry } from "./core.js";
+const frameContributorRegistry = createRegistry("frameContributors");
+/** Reserved phases are owned by PRD 01 itself; anyone else registering for them throws FRAME_PHASE_RESERVED. */
+const RESERVED_PHASES = ["opaque", "output"];
+export function registerFrameContributor(contributor) {
+    for (const phase of contributor.phases) {
+        if (RESERVED_PHASES.includes(phase) && !contributor.id.startsWith("prd01.")) {
+            throw new Error(`FRAME_PHASE_RESERVED:${phase}:${contributor.id}`);
+        }
+    }
+    return frameContributorRegistry.register(contributor);
+}
+export function frameContributors(flags) {
+    return frameContributorRegistry.active(flags);
+}
+//# sourceMappingURL=frameGraph.js.map

package/dist/contracts/frameGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameGraph.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/frameGraph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GASxB;IACF,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,kBAAkB;IAC9B,cAAc,EAAE,uBAAuB;IACvC,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,qBAAqB;IACpC,cAAc,EAAE,uBAAuB;IACvC,UAAU,EAAE,kBAAkB;IAC9B,MAAM,EAAE,aAAa;CACtB,CAAC;AAqDF,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,wBAAwB,GAAG,cAAc,CAAmB,mBAAmB,CAAC,CAAC;AAEvF,gHAAgH;AAChH,MAAM,eAAe,GAA8B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,UAAU,wBAAwB,CAAC,WAA6B;IACpE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,IAAI,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/contracts/frameUniforms.d.ts

@@ -0,0 +1,43 @@
+/**
+ * C-08 — frame uniforms and CameraLike (CONTRACTS.md). Provider: PRD 01. Flag: A3D_QR_CORE.
+ */
+import type { RenderBuffer, RenderDevice } from "../RenderDevice.js";
+import type { FrameCamera } from "./frameGraph.js";
+import { type ContractSlot } from "./core.js";
+export interface CameraLike {
+    readonly viewMatrix?: Float32Array;
+    readonly projectionMatrix?: Float32Array;
+    readonly viewProjectionMatrix: Float32Array;
+    readonly position?: readonly [number, number, number];
+    readonly near?: number;
+    readonly far?: number;
+    readonly fov?: number;
+    readonly aspect?: number;
+    readonly projection?: "perspective" | "orthographic";
+}
+/** std140 block AuraFrame, binding 0. Field order is frozen. */
+export declare const AURA_FRAME_BLOCK: readonly [
+    [
+        "u_view",
+        "mat4"
+    ],
+    ["u_projection", "mat4"],
+    ["u_viewProjection", "mat4"],
+    ["u_prevViewProjection", "mat4"],
+    [
+        "u_cameraPositionNear",
+        "vec4"
+    ],
+    ["u_resolutionFarTime", "vec4"],
+    ["u_exposureFlags", "vec4"]
+];
+/** std140 block AuraLights, binding 1; layout owned by PRD 02 inside this name (C-10). */
+export declare const AURA_LIGHTS_BLOCK_NAME: "AuraLights";
+export interface FrameUniformsLike {
+    update(camera: FrameCamera, timeSeconds: number, exposure: number, flags: number): void;
+    readonly buffer: RenderBuffer | null;
+}
+export declare function createStubFrameUniforms(): FrameUniformsLike;
+/** Provider: `resources/UniformBlock.ts` `FrameUniforms` (AuraFrame @ binding 0). */
+export declare const frameUniformsSlot: ContractSlot<(device: RenderDevice) => FrameUniformsLike>;
+//# sourceMappingURL=frameUniforms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frameUniforms.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/frameUniforms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC;CACtD;AACD,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,SAAS;IACtC;QAAC,QAAQ;QAAE,MAAM;KAAC;IAAE,CAAC,cAAc,EAAE,MAAM,CAAC;IAAE,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAAE,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAC5G;QAAC,sBAAsB;QAAE,MAAM;KAAC;IAAE,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAI/F,CAAC;AACF,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,EAAE,YAA2B,CAAC;AACjE,MAAM,WAAW,iBAAiB;IAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAAE;AAsBrK,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,iBAAiB,CACH,CAAC"}

package/dist/contracts/frameUniforms.js

@@ -0,0 +1,35 @@
+/**
+ * C-08 — frame uniforms and CameraLike (CONTRACTS.md). Provider: PRD 01. Flag: A3D_QR_CORE.
+ */
+import { defineContractSlot } from "./core.js";
+/** std140 block AuraFrame, binding 0. Field order is frozen. */
+export const AURA_FRAME_BLOCK = [
+    ["u_view", "mat4"], ["u_projection", "mat4"], ["u_viewProjection", "mat4"], ["u_prevViewProjection", "mat4"],
+    ["u_cameraPositionNear", "vec4"], ["u_resolutionFarTime", "vec4"], ["u_exposureFlags", "vec4"]
+];
+/** std140 block AuraLights, binding 1; layout owned by PRD 02 inside this name (C-10). */
+export const AURA_LIGHTS_BLOCK_NAME = "AuraLights";
+/**
+ * PR 0a stub: `buffer` is null. Chunks read the legacy uniforms
+ * `u_cameraPosition`/`u_viewProjection`, and the ChunkHarness declares both
+ * forms. `update` records the latest values so consumers can read them.
+ */
+class StubFrameUniforms {
+    buffer = null;
+    lastCamera = null;
+    lastTimeSeconds = 0;
+    lastExposure = 1;
+    lastFlags = 0;
+    update(camera, timeSeconds, exposure, flags) {
+        this.lastCamera = camera;
+        this.lastTimeSeconds = timeSeconds;
+        this.lastExposure = exposure;
+        this.lastFlags = flags;
+    }
+}
+export function createStubFrameUniforms() {
+    return new StubFrameUniforms();
+}
+/** Provider: `resources/UniformBlock.ts` `FrameUniforms` (AuraFrame @ binding 0). */
+export const frameUniformsSlot = defineContractSlot("C-08", "prd01", "A3D_QR_CORE", () => createStubFrameUniforms());
+//# sourceMappingURL=frameUniforms.js.map

package/dist/contracts/frameUniforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameUniforms.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/frameUniforms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAU/D,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAGzB;IACF,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,CAAC,EAAE,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAC5G,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAAE,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAC/F,CAAC;AACF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,sBAAsB,GAAiB,YAAY,CAAC;AAGjE;;;;GAIG;AACH,MAAM,iBAAiB;IACL,MAAM,GAAwB,IAAI,CAAC;IAC5C,UAAU,GAAuB,IAAI,CAAC;IACtC,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAG,CAAC,CAAC;IACjB,SAAS,GAAG,CAAC,CAAC;IAErB,MAAM,CAAC,MAAmB,EAAE,WAAmB,EAAE,QAAgB,EAAE,KAAa;QAC9E,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAC5B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC"}

package/dist/contracts/geometry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * C-07 — primitive tessellation and InstanceBuffer (CONTRACTS.md). Provider: PRD 01.
+ * AuraPrimitiveOptions.tessellation? / AuraPrimitiveNode.batch?/.static? added in PR 0a (engine side).
+ */
+import type { RenderBuffer, RenderDevice } from "../RenderDevice.js";
+import { type ContractSlot } from "./core.js";
+export interface AuraPrimitiveTessellation {
+    readonly widthSegments?: number;
+    readonly heightSegments?: number;
+    readonly depthSegments?: number;
+    readonly radialSegments?: number;
+    readonly tubularSegments?: number;
+    readonly capSegments?: number;
+    readonly openEnded?: boolean;
+    readonly radiusTop?: number;
+    readonly radiusBottom?: number;
+    readonly tube?: number;
+}
+export interface InstanceBufferLike {
+    readonly count: number;
+    readonly version: number;
+    setMatrices(m: Float32Array, count?: number): void;
+    setColors(c: Float32Array): void;
+    bind(): {
+        readonly matrixBuffer: RenderBuffer;
+        readonly colorBuffer?: RenderBuffer;
+    };
+    dispose(): void;
+}
+export declare const instanceBufferSlot: ContractSlot<(device: RenderDevice, capacity: number, options?: {
+    colors?: boolean;
+}) => InstanceBufferLike>;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/geometry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IAAG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAAE;AAEzW,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACjD,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,IAAI,IAAI;QAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IACrF,OAAO,IAAI,IAAI,CAAC;CACjB;AAyDD,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,kBAAkB,CACN,CAAC"}

package/dist/contracts/geometry.js

@@ -0,0 +1,59 @@
+/**
+ * C-07 — primitive tessellation and InstanceBuffer (CONTRACTS.md). Provider: PRD 01.
+ * AuraPrimitiveOptions.tessellation? / AuraPrimitiveNode.batch?/.static? added in PR 0a (engine side).
+ */
+import { defineContractSlot } from "./core.js";
+/**
+ * PR 0a stub: wraps the per-frame instance upload behaviour used by ForwardPass
+ * today — device buffers created up front, data re-uploaded on each set,
+ * `version` incremented per write. Capacity is the hard limit: writing past it
+ * throws INSTANCE_CAPACITY_EXCEEDED.
+ */
+class StubInstanceBuffer {
+    device;
+    capacity;
+    matrices;
+    colors = null;
+    matrixBuffer;
+    colorBuffer = null;
+    count = 0;
+    version = 0;
+    constructor(device, capacity, options) {
+        this.device = device;
+        this.capacity = capacity;
+        this.matrices = new Float32Array(capacity * 16);
+        this.matrixBuffer = device.createBuffer("vertex", this.matrices.byteLength);
+        if (options?.colors) {
+            this.colors = new Float32Array(capacity * 4);
+            this.colorBuffer = device.createBuffer("vertex", this.colors.byteLength);
+        }
+    }
+    setMatrices(m, count) {
+        const n = count ?? Math.floor(m.length / 16);
+        if (n > this.capacity)
+            throw new Error(`INSTANCE_CAPACITY_EXCEEDED:${n}>${this.capacity}`);
+        this.matrices.set(m.subarray(0, n * 16));
+        this.device.updateBuffer(this.matrixBuffer, 0, this.matrices);
+        this.count = n;
+        this.version += 1;
+    }
+    setColors(c) {
+        if (!this.colors || !this.colorBuffer)
+            throw new Error("INSTANCE_COLORS_NOT_ENABLED");
+        const n = Math.floor(c.length / 4);
+        if (n > this.capacity)
+            throw new Error(`INSTANCE_CAPACITY_EXCEEDED:${n}>${this.capacity}`);
+        this.colors.set(c.subarray(0, n * 4));
+        this.device.updateBuffer(this.colorBuffer, 0, this.colors);
+        this.version += 1;
+    }
+    bind() {
+        return this.colorBuffer ? { matrixBuffer: this.matrixBuffer, colorBuffer: this.colorBuffer } : { matrixBuffer: this.matrixBuffer };
+    }
+    dispose() {
+        this.matrixBuffer.dispose();
+        this.colorBuffer?.dispose();
+    }
+}
+export const instanceBufferSlot = defineContractSlot("C-07", "prd01", "A3D_QR_CORE", (device, capacity, options) => new StubInstanceBuffer(device, capacity, options));
+//# sourceMappingURL=geometry.js.map

package/dist/contracts/geometry.js.map

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

package/dist/contracts/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @aura3d/rendering/contracts — frozen rebuild contract surface (PR 0a).
+ * Registry-backed contracts are real (store + validate); generators are stubs.
+ */
+export * from "./core.js";
+export * from "./frameGraph.js";
+export * from "./program.js";
+export * from "./materialLobes.js";
+export * from "./blend.js";
+export * from "./output.js";
+export * from "./geometry.js";
+export * from "./frameUniforms.js";
+export * from "./environment.js";
+export * from "./shadows.js";
+export * from "./sampling.js";
+export * from "./post.js";
+export * from "./velocity.js";
+export * from "./textureFormats.js";
+export * from "./deform.js";
+export * from "./particles.js";
+export * from "./atmosphere.js";
+export * from "./quality.js";
+export * from "./device.js";
+export * from "./rendererFactory.js";
+export * from "./renderItem.js";
+export * from "./renderSource.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,27 @@
+/**
+ * @aura3d/rendering/contracts — frozen rebuild contract surface (PR 0a).
+ * Registry-backed contracts are real (store + validate); generators are stubs.
+ */
+export * from "./core.js";
+export * from "./frameGraph.js";
+export * from "./program.js";
+export * from "./materialLobes.js";
+export * from "./blend.js";
+export * from "./output.js";
+export * from "./geometry.js";
+export * from "./frameUniforms.js";
+export * from "./environment.js";
+export * from "./shadows.js";
+export * from "./sampling.js";
+export * from "./post.js";
+export * from "./velocity.js";
+export * from "./textureFormats.js";
+export * from "./deform.js";
+export * from "./particles.js";
+export * from "./atmosphere.js";
+export * from "./quality.js";
+export * from "./device.js";
+export * from "./rendererFactory.js";
+export * from "./renderItem.js";
+export * from "./renderSource.js";
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/contracts/materialLobes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * C-03 — MaterialFeature lobe registry (CONTRACTS.md). Provider: PRD 04.
+ * File: packages/rendering/src/contracts/materialLobes.ts.
+ */
+import type { RegistryEntry, QrFlags } from "./core.js";
+import type { MaterialExtensionFeature, ProgramFeatures } from "./program.js";
+import type { AuraQualityTierSettings } from "./quality.js";
+import type { UniformValue } from "../RenderDevice.js";
+import type { Texture } from "../Texture.js";
+export type MaterialLobeId = "base" | "clearcoat" | "sheen" | "iridescence" | "anisotropy" | "transmission" | "volume" | "specular" | "ior" | "dispersion" | "emissive-strength" | "unlit" | `${"prd04" | "prd10" | "prd07"}.${string}`;
+export interface MaterialLobe extends RegistryEntry {
+    readonly id: MaterialLobeId;
+    /** Return the extension feature for this material or undefined when the lobe is inactive. */
+    feature(material: MaterialLobeInput): MaterialExtensionFeature | undefined;
+    /** Chunk names (C-02). `direct` (optional) is a per-light call chunk spliced inside every light-loop iteration. */
+    readonly chunks: {
+        readonly pars: string;
+        readonly fragment: string;
+        readonly ibl?: string;
+        readonly direct?: string;
+    };
+    readonly samplerSlots: readonly string[];
+    bind(material: MaterialLobeInput, set: (uniform: string, value: UniformValue) => void): void;
+    readonly glTFExtension?: string;
+}
+export interface MaterialLobeInput {
+    readonly parameters: Readonly<Record<string, unknown>>;
+    readonly textures: Readonly<Record<string, Texture | undefined>>;
+}
+export interface MaterialFeatureContext {
+    readonly flags: QrFlags;
+    readonly tier: AuraQualityTierSettings;
+}
+/** Implemented by every Material subclass (abstract in Material.ts, PRD 01). */
+export interface ProgramFeatureSource {
+    programFeatures(ctx: MaterialFeatureContext): Omit<ProgramFeatures, "lights" | "shadows" | "environment" | "fog" | "pass" | "target" | "backgroundCoverage">;
+}
+/** Registry is real in PR 0a: lobes store and validate; they have no render effect until the C-02 generator is real. */
+export declare function registerMaterialLobe(lobe: MaterialLobe): () => void;
+export declare function materialLobes(flags: QrFlags): readonly MaterialLobe[];
+//# sourceMappingURL=materialLobes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materialLobes.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/materialLobes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,cAAc,GACtB,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,GACzF,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,mBAAmB,GAAG,OAAO,GAAG,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;AACnH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,wBAAwB,GAAG,SAAS,CAAC;IAC3E,mHAAmH;IACnH,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;CAAE;AAChK,MAAM,WAAW,sBAAsB;IAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CAAE;AAC5G,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,oBAAoB,CAAC,CAAC;CAC9J;AAMD,wHAAwH;AACxH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI,CAEnE;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,YAAY,EAAE,CAErE"}

package/dist/contracts/materialLobes.js

@@ -0,0 +1,14 @@
+/**
+ * C-03 — MaterialFeature lobe registry (CONTRACTS.md). Provider: PRD 04.
+ * File: packages/rendering/src/contracts/materialLobes.ts.
+ */
+import { createRegistry } from "./core.js";
+const materialLobeRegistry = createRegistry("materialLobes");
+/** Registry is real in PR 0a: lobes store and validate; they have no render effect until the C-02 generator is real. */
+export function registerMaterialLobe(lobe) {
+    return materialLobeRegistry.register(lobe);
+}
+export function materialLobes(flags) {
+    return materialLobeRegistry.active(flags);
+}
+//# sourceMappingURL=materialLobes.js.map

package/dist/contracts/materialLobes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialLobes.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/materialLobes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,oBAAoB,GAAG,cAAc,CAAe,eAAe,CAAC,CAAC;AAE3E,wHAAwH;AACxH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}

package/dist/contracts/output.d.ts

@@ -0,0 +1,35 @@
+/**
+ * C-05 — output: HDR target, tone mapping, exposure, background coverage, overlay
+ * (CONTRACTS.md). Provider: PRD 01. Flag: A3D_QR_CORE.
+ */
+import type { RenderTarget } from "../RenderDevice.js";
+import type { RenderDevice } from "../RenderDevice.js";
+export type AuraToneMappingOperatorLike = "none" | "linear" | "reinhard" | "aces" | "agx" | "neutral";
+export interface OutputPassOptions {
+    readonly toneMapping: AuraToneMappingOperatorLike;
+    readonly exposure: number;
+    readonly dithering: boolean;
+    readonly backgroundCoverage: boolean;
+    readonly overlay?: OutputOverlayUniforms;
+}
+export interface OutputOverlayUniforms {
+    readonly flash: readonly [number, number, number, number];
+    readonly vignette: readonly [number, number, number, number];
+    readonly shape: readonly [number, number];
+    readonly fade: readonly [number, number, number, number];
+}
+export interface OutputPassLike {
+    execute(input: RenderTarget, coverage: RenderTarget | null, options: OutputPassOptions, output: RenderTarget | "canvas"): void;
+}
+/**
+ * Frozen as "aces" at PR 0 (PRD 03 :451/:680, PRD 01 :1020). It switches to "agx"
+ * only in a separate PRD 01 PR linking PRD 12's ACES-vs-AgX A/B record.
+ */
+export declare const DEFAULT_TONE_MAPPING: AuraToneMappingOperatorLike;
+export type HdrTargetFormat = "rgba16f" | "r11f_g11f_b10f" | "rgba8";
+/**
+ * PR 0a stub: "rgba16f" when the `hdr-render-targets` capability exists, else
+ * "rgba8". Real (PRD 01) probes r11f_g11f_b10f as the middle rung.
+ */
+export declare function probeHdrTargetFormat(device: RenderDevice): HdrTargetFormat;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AACtG,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAAE;AACjO,MAAM,WAAW,qBAAqB;IAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAAE;AACxQ,MAAM,WAAW,cAAc;IAAG,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAC;CAAE;AAEnK;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,2BAAoC,CAAC;AACxE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAErE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAG1E"}

package/dist/contracts/output.js

@@ -0,0 +1,18 @@
+/**
+ * C-05 — output: HDR target, tone mapping, exposure, background coverage, overlay
+ * (CONTRACTS.md). Provider: PRD 01. Flag: A3D_QR_CORE.
+ */
+/**
+ * Frozen as "aces" at PR 0 (PRD 03 :451/:680, PRD 01 :1020). It switches to "agx"
+ * only in a separate PRD 01 PR linking PRD 12's ACES-vs-AgX A/B record.
+ */
+export const DEFAULT_TONE_MAPPING = "aces";
+/**
+ * PR 0a stub: "rgba16f" when the `hdr-render-targets` capability exists, else
+ * "rgba8". Real (PRD 01) probes r11f_g11f_b10f as the middle rung.
+ */
+export function probeHdrTargetFormat(device) {
+    const capabilities = device.info.capabilities ?? [];
+    return capabilities.includes("hdr-render-targets") ? "rgba16f" : "rgba8";
+}
+//# sourceMappingURL=output.js.map

package/dist/contracts/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgC,MAAM,CAAC;AAGxE;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IACpD,OAAO,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3E,CAAC"}

package/dist/contracts/particles.d.ts

@@ -0,0 +1,41 @@
+/**
+ * C-20 — renderable particle interface (rendering side, CONTRACTS.md). Provider: PRD 07.
+ * Flag: A3D_QR_VFX.
+ */
+import type { Texture } from "../Texture.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import type { BlendMode } from "./blend.js";
+import { type ContractSlot } from "./core.js";
+export interface ParticleBatchDescriptor {
+    readonly key: string;
+    readonly capacity: number;
+    readonly source: "cpu" | "gpu" | "procedural" | "compute";
+    readonly atlas: Texture;
+    readonly blend: BlendMode;
+    readonly shading: "unlit" | "lit";
+    readonly softDepth: boolean;
+    readonly softDistance?: number;
+    readonly nearFade?: number;
+    readonly stretch: boolean;
+    readonly frameBlend: boolean; /** P6-T4: eligible for the optional half-resolution particle target. */
+    readonly lowRes?: boolean; /** Flipbook frame grid (columns, rows) on `atlas`; default 1×1. */
+    readonly atlasGrid?: readonly [number, number]; /** `atlas` texels are straight alpha (premultiplied in-shader). */
+    readonly atlasStraightAlpha?: boolean;
+}
+export interface ParticleBatchHandle {
+    readonly key: string;
+    readonly liveCount: number;
+}
+export interface ParticleRenderHook {
+    upsertBatch(desc: ParticleBatchDescriptor): ParticleBatchHandle;
+    writeInstances(h: ParticleBatchHandle, data: Float32Array, liveCount: number): void;
+    removeBatch(h: ParticleBatchHandle): void;
+    /** P6-T4: force the half-res particle path on/off (off by default). */
+    setLowResEnabled?(on: boolean): void;
+    /** P6-T4: feed a measured particle-GPU-ms sample; auto-enables the half-res
+     *  path when the EWMA exceeds `budgetMs` (and disables below 75% of it). */
+    noteGpuMs?(particleGpuMs: number, budgetMs: number): void;
+}
+export declare const particleRenderHookSlot: ContractSlot<(device: RenderDevice) => ParticleRenderHook>;
+export declare const PARTICLE_PROGRAM_DEFINES: readonly ["PARTICLE_SOURCE", "STRETCH", "SHADING_LIT", "PARTICLE_SHADOW", "SOFT_PARTICLES", "FRAME_BLEND", "BLEND_ADDITIVE", "FOG_VOLUMETRIC"];
+//# sourceMappingURL=particles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/particles.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,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,wEAAwE;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,mEAAmE;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,mEAAmE;IAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAAE;AACpsB,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAAE;AAC1F,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,mBAAmB,CAAC;IAChE,cAAc,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,WAAW,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,uEAAuE;IACvE,gBAAgB,CAAC,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC;gFAC4E;IAC5E,SAAS,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AAUD,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,kBAAkB,CACP,CAAC;AAExF,eAAO,MAAM,wBAAwB,EAAE,SAAS,CAAC,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAC7C,CAAC"}

package/dist/contracts/particles.js

@@ -0,0 +1,15 @@
+/**
+ * C-20 — renderable particle interface (rendering side, CONTRACTS.md). Provider: PRD 07.
+ * Flag: A3D_QR_VFX.
+ */
+import { defineContractSlot } from "./core.js";
+/** PRD 07 registers a C-01 FrameContributor "prd07.particles" (phase "transparent") that draws all batches. */
+/** PR 0a: calling the stub's methods throws PARTICLE_PASS_PENDING. */
+class StubParticleRenderHook {
+    upsertBatch() { throw new Error("PARTICLE_PASS_PENDING"); }
+    writeInstances() { throw new Error("PARTICLE_PASS_PENDING"); }
+    removeBatch() { }
+}
+export const particleRenderHookSlot = defineContractSlot("C-20", "prd07", "A3D_QR_VFX", () => new StubParticleRenderHook());
+export const PARTICLE_PROGRAM_DEFINES = ["PARTICLE_SOURCE", "STRETCH", "SHADING_LIT", "PARTICLE_SHADOW", "SOFT_PARTICLES", "FRAME_BLEND", "BLEND_ADDITIVE", "FOG_VOLUMETRIC"]; // C-07-OUT-7
+//# sourceMappingURL=particles.js.map

package/dist/contracts/particles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/particles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAc/D,+GAA+G;AAE/G,sEAAsE;AACtE,MAAM,sBAAsB;IAC1B,WAAW,KAA0B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAChF,cAAc,KAAW,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACpE,WAAW,KAA8D,CAAC;CAC3E;AAED,MAAM,CAAC,MAAM,sBAAsB,GACjC,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,wBAAwB,GACnC,CAAC,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,aAAa"}