@aura3d/rendering 3.0.1 → 4.0.2

package/dist/vfx/ParticleBatchPass.d.ts

@@ -0,0 +1,61 @@
+import type { RenderDevice } from "../RenderDevice.js";
+import type { FrameContributorContext, TransparentQueueItem } from "../contracts/frameGraph.js";
+import type { ParticleBatchDescriptor, ParticleBatchHandle } from "../contracts/particles.js";
+export interface ParticlePassDiagnostics {
+    drawCalls: number;
+    instancesDrawn: number;
+    readonly errors: {
+        code: string;
+        nodeId: string;
+        message: string;
+    }[];
+    /** P6-T4: half-res path state for this frame. */
+    readonly lowRes?: {
+        readonly active: boolean;
+        readonly batches: number;
+    };
+    /** C-28 device counters snapshot at report time (e.g. `readbacks` must stay 0). */
+    readonly deviceCounters?: {
+        readonly readbacks: number;
+    };
+}
+export declare class ParticleBatchPass {
+    private readonly device;
+    private readonly batches;
+    private readonly programs;
+    private readonly sorter;
+    private programLimitWarned;
+    private frameDiagnostics;
+    private frameDepth;
+    private frameOutputColorSpace;
+    private honoursBlendMode;
+    private lowResManual;
+    private lowResAuto;
+    private readonly lowResBudget;
+    private lowRes;
+    private lowResUnsupportedWarned;
+    constructor(device: RenderDevice);
+    /** Force the half-res path on/off; `null` restores budget auto-control. */
+    setLowResEnabled(on: boolean): void;
+    /** Measured particle-GPU-ms sample; auto-enables above the tier budget. */
+    noteGpuMs(particleGpuMs: number, budgetMs: number): void;
+    get lowResActive(): boolean;
+    upsertBatch(desc: ParticleBatchDescriptor): ParticleBatchHandle;
+    writeInstances(h: ParticleBatchHandle, data: Float32Array, liveCount: number): void;
+    removeBatch(h: ParticleBatchHandle): void;
+    transparentItems(ctx: FrameContributorContext): TransparentQueueItem[];
+    /** Half-res path engages only when the pass is enabled AND the device can
+     *  report the bound target (needed to restore after the divert). */
+    private lowResEligible;
+    private lowResOffscreenItem;
+    private lowResComposite;
+    private queueItem;
+    private drawBatch;
+    private program;
+    private deviceHonoursBlendMode;
+    private note;
+    get diagnostics(): ParticlePassDiagnostics;
+    get batchCount(): number;
+    dispose(): void;
+}
+//# sourceMappingURL=ParticleBatchPass.d.ts.map

package/dist/vfx/ParticleBatchPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleBatchPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/ParticleBatchPass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,YAAY,EAAuB,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAkB3F,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,mFAAmF;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAaD,qBAAa,iBAAiB;IAgBhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAfnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAA4E;IACpG,OAAO,CAAC,UAAU,CAAqD;IACvE,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,gBAAgB,CAAwB;IAEhD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,uBAAuB,CAAS;gBAEX,MAAM,EAAE,YAAY;IAIjD,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAInC,2EAA2E;IAC3E,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIxD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAID,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,mBAAmB;IAqB/D,cAAc,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBnF,WAAW,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAWzC,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,EAAE;IAoDtE;wEACoE;IACpE,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;IAyDjB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,IAAI;IAIZ,IAAI,WAAW,IAAI,uBAAuB,CAKzC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,IAAI,IAAI;CAQhB"}

package/dist/vfx/ParticleBatchPass.js

@@ -0,0 +1,320 @@
+// PRD-07 P1-T5/P1-T8/P1-T9 — C-20 ParticleRenderHook implementation and the
+// transparent-queue draw path. One instanced draw per batch; non-additive
+// batches sorted back-to-front; additive batches appended last.
+import { TextureBinding } from "../TextureBinding.js";
+import { PRD07_DEPTH_SAMPLER } from "./depthSampler.js";
+import { ParticleInstanceRing, createParticleQuad, particleInstanceAttributes } from "./ParticleInstanceLayout.js";
+import { consumeBlendFallbackReport, resolveVfxBlend } from "./BlendFallback.js";
+import { LowResAutoBudget, LowResParticleTarget } from "./LowResParticles.js";
+import { ParticleSort } from "./ParticleSort.js";
+import { resolveOutputColorSpace, resolveSceneDepth } from "./SceneDepthAdapter.js";
+import { PARTICLE_SHADER_MARKER, particleFragmentSource, particleProgramKey, particleVertexSource } from "./shaders/particle.glsl.js";
+const MAX_PARTICLE_PROGRAMS = 12;
+export class ParticleBatchPass {
+    device;
+    batches = new Map();
+    programs = new Map();
+    sorter = new ParticleSort();
+    programLimitWarned = false;
+    frameDiagnostics = { drawCalls: 0, instancesDrawn: 0, errors: [] };
+    frameDepth = null;
+    frameOutputColorSpace = "srgb";
+    honoursBlendMode = null;
+    // P6-T4 half-res particle path: off by default; auto via noteGpuMs budget.
+    lowResManual = null;
+    lowResAuto = false;
+    lowResBudget = new LowResAutoBudget();
+    lowRes = null;
+    lowResUnsupportedWarned = false;
+    constructor(device) {
+        this.device = device;
+    }
+    /* ---------------- P6-T4 half-res path ---------------- */
+    /** Force the half-res path on/off; `null` restores budget auto-control. */
+    setLowResEnabled(on) {
+        this.lowResManual = on;
+    }
+    /** Measured particle-GPU-ms sample; auto-enables above the tier budget. */
+    noteGpuMs(particleGpuMs, budgetMs) {
+        this.lowResAuto = this.lowResBudget.note(particleGpuMs, budgetMs, this.lowResAuto);
+    }
+    get lowResActive() {
+        return (this.lowResManual ?? this.lowResAuto) && typeof this.device.getRenderTarget === "function";
+    }
+    /* ---------------- C-20 ParticleRenderHook ---------------- */
+    upsertBatch(desc) {
+        let batch = this.batches.get(desc.key);
+        if (!batch) {
+            batch = {
+                key: desc.key,
+                desc,
+                ring: new ParticleInstanceRing(this.device),
+                buffer: null,
+                liveCount: 0,
+                sortDepth: 0,
+                changed: true,
+                centre: [0, 0, 0],
+                removed: false
+            };
+            this.batches.set(desc.key, batch);
+        }
+        else {
+            batch.desc = desc;
+        }
+        return batch;
+    }
+    writeInstances(h, data, liveCount) {
+        const batch = this.batches.get(h.key);
+        if (!batch || batch.removed)
+            return;
+        const live = Math.min(liveCount, Math.floor(data.length / 16));
+        if (live <= 0) {
+            batch.liveCount = 0;
+            batch.buffer = null;
+            return;
+        }
+        batch.buffer = batch.ring.write(data, live);
+        batch.liveCount = live;
+        batch.changed = true;
+        // Track centre from the first particle (positions are world-space already).
+        if (data.length >= 3)
+            batch.centre = [data[0], data[1], data[2]];
+    }
+    removeBatch(h) {
+        const batch = this.batches.get(h.key);
+        if (!batch)
+            return;
+        batch.ring.dispose();
+        batch.removed = true;
+        batch.liveCount = 0;
+        this.batches.delete(h.key);
+    }
+    /* ---------------- transparent-phase draw ---------------- */
+    transparentItems(ctx) {
+        this.frameDiagnostics = { drawCalls: 0, instancesDrawn: 0, errors: [] };
+        this.frameDepth = resolveSceneDepth(ctx);
+        this.frameOutputColorSpace = resolveOutputColorSpace(ctx);
+        if (this.frameDepth.pendingNote === "SOFT_DEPTH_PENDING")
+            this.note("SOFT_DEPTH_PENDING", null, "scene depth is the C-01 stub; soft particles are off");
+        else if (this.frameDepth.pendingNote === "SOFT_DEPTH_INVALID_SOURCE")
+            this.note("SOFT_DEPTH_INVALID_SOURCE", null, "aura.scene.depth.copy has no sampleable depth texture; soft particles are off");
+        const live = [];
+        for (const batch of this.batches.values()) {
+            if (batch.removed || batch.liveCount === 0 || batch.buffer === null)
+                continue;
+            const res = resolveVfxBlend(batch.desc.blend, this.deviceHonoursBlendMode());
+            if (res.degraded) {
+                const id = consumeBlendFallbackReport(batch.key, res.degraded);
+                if (id)
+                    this.note(res.degraded, null, `batch "${batch.key}" blend "${String(batch.desc.blend)}" emulated under the C-04 stub`);
+            }
+            if (res.skipped)
+                continue;
+            live.push(batch);
+        }
+        if (live.length === 0)
+            return [];
+        // View depth from the camera basis; additive batches draw last.
+        const basis = cameraBasis(ctx);
+        const additive = [];
+        const rest = [];
+        for (const b of live) {
+            b.sortDepth = viewDepth(b.centre, basis);
+            (b.desc.blend === "additive" ? additive : rest).push(b);
+        }
+        const order = this.sorter.sort(rest, basis);
+        const items = [];
+        // P6-T4: eligible batches divert into the half-res target when active.
+        const lowResBatches = this.lowResEligible() ? [...Array.from(order, (i) => rest[i]), ...additive].filter((b) => b.desc.lowRes === true) : [];
+        const lowResKeys = new Set(lowResBatches.map((b) => b.key));
+        if (lowResBatches.length > 0) {
+            const offscreen = this.lowResOffscreenItem(lowResBatches, ctx);
+            if (offscreen)
+                items.push(offscreen);
+            this.frameDiagnostics = { ...this.frameDiagnostics, lowRes: { active: true, batches: lowResBatches.length } };
+        }
+        for (const i of order)
+            if (!lowResKeys.has(rest[i].key))
+                items.push(this.queueItem(rest[i], ctx));
+        for (const b of additive)
+            if (!lowResKeys.has(b.key))
+                items.push(this.queueItem(b, ctx));
+        if (lowResBatches.length > 0) {
+            // Composite last: the low-res buffer already contains every diverted
+            // batch merged in draw order, so it lands over the other transparents.
+            items.push({
+                sortDepth: Math.max(...lowResBatches.map((b) => b.sortDepth)),
+                draw: () => this.lowResComposite(ctx)
+            });
+        }
+        return items;
+    }
+    /** Half-res path engages only when the pass is enabled AND the device can
+     *  report the bound target (needed to restore after the divert). */
+    lowResEligible() {
+        const enabled = this.lowResManual ?? this.lowResAuto;
+        if (!enabled)
+            return false;
+        if (typeof this.device.getRenderTarget !== "function") {
+            if (!this.lowResUnsupportedWarned) {
+                this.lowResUnsupportedWarned = true;
+                this.note("LOWRES_UNSUPPORTED", null, "half-res particles need device.getRenderTarget(); staying at full res");
+            }
+            return false;
+        }
+        return true;
+    }
+    lowResOffscreenItem(batches, ctx) {
+        if (this.lowRes === null)
+            this.lowRes = new LowResParticleTarget(this.device);
+        const lowRes = this.lowRes;
+        return {
+            sortDepth: Number.POSITIVE_INFINITY,
+            draw: () => {
+                const previous = this.device.getRenderTarget?.() ?? null;
+                const target = lowRes.acquire(ctx.width, ctx.height);
+                this.device.setRenderTarget(target);
+                this.device.clear([0, 0, 0, 0]);
+                for (const batch of batches)
+                    this.drawBatch(batch, ctx);
+                this.device.setRenderTarget(previous);
+            }
+        };
+    }
+    lowResComposite(ctx) {
+        this.lowRes?.composite(this.frameDepth);
+        this.frameDiagnostics.drawCalls += 1;
+    }
+    queueItem(batch, ctx) {
+        return {
+            sortDepth: batch.sortDepth,
+            draw: () => this.drawBatch(batch, ctx)
+        };
+    }
+    drawBatch(batch, ctx) {
+        if (!batch.buffer || batch.liveCount === 0)
+            return;
+        const res = resolveVfxBlend(batch.desc.blend, this.deviceHonoursBlendMode());
+        const quad = createParticleQuad();
+        const vertexBuffer = quad.vertexBuffer.upload(this.device);
+        const indexBuffer = quad.indexBuffer?.upload(this.device);
+        const camera = ctx.camera;
+        const depth = this.frameDepth;
+        const softParticles = depth?.available === true && batch.desc.softDepth && depth.source.texture !== null;
+        const defines = {
+            stretch: batch.desc.stretch,
+            frameBlend: batch.desc.frameBlend,
+            softParticles,
+            blendAdditive: batch.desc.blend === "additive" && !res.additiveFallback,
+            blendAdditiveFallback: res.additiveFallback,
+            unpremultiplyOutput: res.unpremultiplyOutput,
+            proceduralSoftDot: batch.desc.atlas.width <= 1,
+            fogAnalytic: false,
+            straightAlpha: batch.desc.atlasStraightAlpha === true
+        };
+        const shader = this.program(defines);
+        const uniforms = new Map([
+            ["u_view", camera?.viewMatrix ?? IDENTITY],
+            ["u_viewProjection", camera?.viewProjectionMatrix ?? IDENTITY],
+            ["u_atlasRect", [0, 0, 1, 1]],
+            ["u_grid", batch.desc.atlasGrid ? [batch.desc.atlasGrid[0], batch.desc.atlasGrid[1]] : [1, 1]],
+            ["u_atlas", new TextureBinding({ name: "u_atlas", texture: batch.desc.atlas })],
+            ["u_nearFade", batch.desc.nearFade ?? 0.5],
+            ["u_cameraNear", camera?.near ?? 0.1],
+            ["u_softDistance", batch.desc.softDistance ?? 1],
+            ["u_outputColorSpace", this.frameOutputColorSpace === "srgb" ? 1 : 0],
+            ["u_fogColor", [0, 0, 0]],
+            ["u_fogDensity", 0]
+        ]);
+        if (softParticles && depth) {
+            uniforms.set("u_sceneDepth", new TextureBinding({ name: "u_sceneDepth", texture: depth.source.texture, sampler: PRD07_DEPTH_SAMPLER }));
+            uniforms.set("u_depthLinearize", [depth.source.linearize.near, depth.source.linearize.far, depth.source.linearize.orthographic ? 1 : 0, 0]);
+        }
+        this.device.draw({
+            label: `prd07.particles.${batch.key}`,
+            topology: "triangles",
+            vertexBuffer,
+            vertexFormat: quad.vertexBuffer.format,
+            vertexCount: 4,
+            indexBuffer: indexBuffer ?? undefined,
+            indexType: indexBuffer ? quad.indexBuffer?.type : undefined,
+            indexCount: indexBuffer ? 6 : undefined,
+            instanceCount: batch.liveCount,
+            instanceAttributes: particleInstanceAttributes(batch.buffer),
+            shader,
+            uniforms,
+            renderState: res.renderState
+        });
+        this.frameDiagnostics.drawCalls += 1;
+        this.frameDiagnostics.instancesDrawn += batch.liveCount;
+    }
+    program(defines) {
+        const key = particleProgramKey(defines);
+        let shader = this.programs.get(key);
+        if (!shader) {
+            if (this.programs.size >= MAX_PARTICLE_PROGRAMS && !this.programLimitWarned) {
+                this.programLimitWarned = true;
+                this.note("VFX_PROGRAM_LIMIT", null, `particle program cache exceeds ${MAX_PARTICLE_PROGRAMS} define combinations`);
+            }
+            shader = this.device.createShaderProgram({
+                label: key,
+                vertex: particleVertexSource(defines),
+                fragment: particleFragmentSource(defines),
+                marker: PARTICLE_SHADER_MARKER
+            });
+            this.programs.set(key, shader);
+        }
+        return shader;
+    }
+    deviceHonoursBlendMode() {
+        if (this.honoursBlendMode === null) {
+            // C-04 is still a stub on every shipping backend: `blendMode` is ignored
+            // and `blend: true` lowers to alpha-over. "native-render-pipeline" is the
+            // probe for a backend where named blends are real — extend it when C-04
+            // lands an explicit capability. Until then the §6.2.7 fallback table
+            // applies everywhere (honest degradation, reported once per key).
+            // WebGL2: C-04 landed — MultiDraw resolves `blendMode` (named + custom
+            // factors), so the alpha-over emulation (×1.6 "additive", saturating to
+            // the sprite colour) no longer applies there.
+            this.honoursBlendMode = this.device.kind === "webgl2" || this.device.info.capabilities?.includes("native-render-pipeline") === true;
+        }
+        return this.honoursBlendMode;
+    }
+    note(code, nodeId, message) {
+        this.frameDiagnostics.errors.push({ code, nodeId: nodeId ?? "", message });
+    }
+    get diagnostics() {
+        const counters = this.device.counters?.();
+        return counters === undefined
+            ? this.frameDiagnostics
+            : { ...this.frameDiagnostics, deviceCounters: { readbacks: counters.readbacks } };
+    }
+    get batchCount() {
+        return this.batches.size;
+    }
+    dispose() {
+        for (const batch of this.batches.values())
+            batch.ring.dispose();
+        this.batches.clear();
+        for (const program of this.programs.values())
+            program.dispose?.();
+        this.programs.clear();
+        this.lowRes?.dispose();
+        this.lowRes = null;
+    }
+}
+const IDENTITY = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
+/** 12 floats of the view matrix (3x4 basis) for sort/skip checks. */
+function cameraBasis(ctx) {
+    const m = ctx.camera?.viewMatrix;
+    if (!m || m.length < 16)
+        return new Float32Array(12);
+    return new Float32Array([m[0], m[1], m[2], m[4], m[5], m[6], m[8], m[9], m[10], m[12], m[13], m[14]]);
+}
+/** View-space depth of a world point (positive = in front of the camera). */
+function viewDepth(p, basis) {
+    // view-space z = row3·p + tz of the *view* matrix (column-major m[8..10], m[14]).
+    const z = basis[6] * p[0] + basis[7] * p[1] + basis[8] * p[2] + basis[11];
+    return -z;
+}
+//# sourceMappingURL=ParticleBatchPass.js.map

package/dist/vfx/ParticleBatchPass.js.map

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

package/dist/vfx/ParticleGpuSim.d.ts

@@ -0,0 +1,85 @@
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { Texture } from "../Texture.js";
+import type { DeviceProbe } from "../contracts/device.js";
+import type { QrFlags } from "../contracts/index.js";
+export interface GpuSimEmitterSpec {
+    readonly origin: readonly [number, number, number];
+    readonly direction: readonly [number, number, number];
+    readonly spread: number;
+    readonly speed: readonly [number, number];
+    readonly discRadius?: number;
+}
+export interface GpuSimSpec {
+    /** Particle capacity; state textures are width × ceil(capacity/width). */
+    readonly capacity: number;
+    /** Texel grid width (default: next power of two ≥ sqrt(capacity)). */
+    readonly stateWidth?: number;
+    readonly gravity?: readonly [number, number, number];
+    readonly wind?: readonly [number, number, number];
+    readonly drag?: number;
+    readonly noiseFreq?: number;
+    readonly noiseScroll?: number;
+    readonly noiseStrength?: number;
+    readonly groundPlane?: number;
+    readonly bounce?: number;
+    readonly lifeLoss?: number;
+    readonly lifetimeMax: number;
+    readonly emitter?: GpuSimEmitterSpec;
+    readonly seed?: number;
+    readonly useHeightfield?: boolean;
+    readonly heightfield?: Texture;
+    readonly heightUvScale?: number;
+    readonly heightMax?: number;
+}
+export interface ParticleGpuSimState {
+    /** Current (post-step) state textures. */
+    readonly posTexture: Texture;
+    readonly velTexture: Texture;
+    /** Current state targets — exposed for readback (specs/tests) and device-loss rebuilds. */
+    readonly posTarget: RenderTarget;
+    readonly velTarget: RenderTarget;
+    readonly capacity: number;
+    readonly width: number;
+    readonly height: number;
+    /** Ring head — index of the next slot to emit into. */
+    readonly head: number;
+    readonly frame: number;
+}
+/** 3D value noise — identical constants to the GLSL a3dValueNoise. */
+export declare function a3dValueNoise(px: number, py: number, pz: number): number;
+/** Curl of F = (N(p), N(p+o1), N(p+o2)) — identical to the GLSL. */
+export declare function a3dCurlNoise(px: number, py: number, pz: number): [number, number, number];
+/** Emit slot `index` — identical hashing to the GLSL a3dEmit. */
+export declare function gpuSimEmit(index: number, seed: number, frame: number, spec: GpuSimSpec, pos: Float32Array, vel: Float32Array): void;
+/**
+ * One §8.3 step across the whole state (CPU mirror of a3dSimStep).
+ * `pos`/`vel` are rgba32f state (pos.xyz+age, vel.xyz+seed), length
+ * capacity*4; `emitHead`/`emitCount` select ring slots for (re)emission.
+ */
+export declare function gpuSimCpuStep(pos: Float32Array, vel: Float32Array, spec: GpuSimSpec, dt: number, time: number, frame: number, emitHead: number, emitCount: number, heightAt?: (x: number, z: number) => number): void;
+/** True when the device can render to rgba32f (EXT_color_buffer_float, C-28). */
+export declare function particleGpuSimAvailable(device: RenderDevice): boolean;
+export declare class ParticleGpuSim {
+    private readonly device;
+    private readonly width;
+    private readonly height;
+    private readonly spec;
+    private pos;
+    private vel;
+    private read;
+    private head;
+    private frame;
+    private posProgram;
+    private velProgram;
+    constructor(device: RenderDevice, spec: GpuSimSpec, flags?: QrFlags);
+    /** Capability check per P5-T1: false → caller keeps the CPU emitter. */
+    static isAvailable(probe: DeviceProbe | undefined): boolean;
+    private allocate;
+    get state(): ParticleGpuSimState | null;
+    private program;
+    private uniforms;
+    /** One §8.3 step: pos pass then vel pass, then ping-pong swap. */
+    step(dt: number, emitCount?: number, time?: number): ParticleGpuSimState;
+    dispose(): void;
+}
+//# sourceMappingURL=ParticleGpuSim.d.ts.map

package/dist/vfx/ParticleGpuSim.d.ts.map

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