@cazala/party 0.0.0

package/dist/modules/render/trails.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Trails (Render Module)
+ *
+ * Two compute image passes over the scene texture:
+ * - decay: exponential fade toward clear color with alpha decay
+ * - diffuse: gaussian-like blur with configurable radius
+ * Both read from input texture and write to output, participating in ping-pong.
+ */
+import { Module, type WebGPUDescriptor, ModuleRole, CPUDescriptor, DataType } from "../../module";
+export declare const DEFAULT_TRAILS_TRAIL_DECAY = 10;
+export declare const DEFAULT_TRAILS_TRAIL_DIFFUSE = 0;
+type TrailsInputs = {
+    trailDecay: number;
+    trailDiffuse: number;
+};
+export declare class Trails extends Module<"trails", TrailsInputs> {
+    readonly name: "trails";
+    readonly role = ModuleRole.Render;
+    readonly inputs: {
+        readonly trailDecay: DataType.NUMBER;
+        readonly trailDiffuse: DataType.NUMBER;
+    };
+    constructor(opts?: {
+        enabled?: boolean;
+        trailDecay?: number;
+        trailDiffuse?: number;
+    });
+    setTrailDecay(value: number): void;
+    setTrailDiffuse(value: number): void;
+    getTrailDecay(): number;
+    getTrailDiffuse(): number;
+    webgpu(): WebGPUDescriptor<TrailsInputs>;
+    cpu(): CPUDescriptor<TrailsInputs>;
+}
+export {};
+//# sourceMappingURL=trails.d.ts.map

package/dist/modules/render/trails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trails.d.ts","sourceRoot":"","sources":["../../../src/modules/render/trails.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,MAAM,EACN,KAAK,gBAAgB,EACrB,UAAU,EAEV,aAAa,EAEb,QAAQ,EACT,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,4BAA4B,IAAM,CAAC;AAEhD,KAAK,YAAY,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,MAAO,SAAQ,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,MAAM;;;MAGJ;gBAEC,IAAI,CAAC,EAAE;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAYD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,aAAa,IAAI,MAAM;IAGvB,eAAe,IAAI,MAAM;IAIzB,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAkExC,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC;CA2CnC"}

package/dist/oscillators.d.ts

@@ -0,0 +1,66 @@
+export type OscillatorKey = string;
+export interface AddOscillatorOptions {
+    curveExponent?: number;
+    jitter?: boolean | number;
+    initialDirection?: -1 | 1;
+    currentValue?: number;
+    phaseOffset?: number;
+}
+export interface OscillatorConfigInternal {
+    moduleName: string;
+    inputName: string;
+    min: number;
+    max: number;
+    speedHz: number;
+    curveExponent: number;
+    jitterMultiplier: number;
+    phaseOffset: number;
+    lastValue: number;
+    lastDirection: -1 | 0 | 1;
+    active: boolean;
+}
+export interface OscillatorPublicConfig {
+    moduleName: string;
+    inputName: string;
+    min: number;
+    max: number;
+    speedHz: number;
+    curveExponent: number;
+    jitterMultiplier: number;
+    phaseOffset: number;
+    lastDirection: -1 | 0 | 1;
+    lastValue: number;
+    active: boolean;
+}
+export declare class OscillatorManager {
+    private keyToIndex;
+    private oscillators;
+    private elapsedSeconds;
+    private setInput;
+    private listeners;
+    constructor(setInput: (moduleName: string, inputName: string, value: number) => void);
+    private static makeKey;
+    addOscillator(params: {
+        moduleName: string;
+        inputName: string;
+        min: number;
+        max: number;
+        speedHz: number;
+        options?: AddOscillatorOptions;
+    }): OscillatorKey;
+    removeOscillator(moduleName: string, inputName: string): void;
+    updateOscillatorSpeed(moduleName: string, inputName: string, speedHz: number): void;
+    updateOscillatorBounds(moduleName: string, inputName: string, min: number, max: number): void;
+    hasOscillator(moduleName: string, inputName: string): boolean;
+    getOscillator(moduleName: string, inputName: string): OscillatorPublicConfig | undefined;
+    clear(): void;
+    getElapsedSeconds(): number;
+    setElapsedSeconds(seconds: number): void;
+    clearModule(moduleName: string): void;
+    updateAll(dtSeconds: number): void;
+    private recalculatePhaseOffset;
+    addOscillatorListener(moduleName: string, inputName: string, handler: (value: number) => void): void;
+    removeOscillatorListener(moduleName: string, inputName: string, handler: (value: number) => void): void;
+    setOscillatorState(moduleName: string, inputName: string, lastValue: number, lastDirection: -1 | 0 | 1): boolean;
+}
+//# sourceMappingURL=oscillators.d.ts.map

package/dist/oscillators.d.ts.map

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

package/dist/particle.d.ts

@@ -0,0 +1,19 @@
+import { IParticle } from "./interfaces";
+import { Vector } from "./vector";
+export declare class Particle implements IParticle {
+    id: number;
+    position: Vector;
+    velocity: Vector;
+    acceleration: Vector;
+    size: number;
+    mass: number;
+    color: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    constructor(options: IParticle);
+    toJSON(): IParticle;
+}
+//# sourceMappingURL=particle.d.ts.map

package/dist/particle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../src/particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,qBAAa,QAAS,YAAW,SAAS;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEjD,OAAO,EAAE,SAAS;IAU9B,MAAM,IAAI,SAAS;CASpB"}

package/dist/runtimes/cpu/engine.d.ts

@@ -0,0 +1,60 @@
+import { AbstractEngine, IParticle } from "../../interfaces";
+import { Module } from "../../module";
+export declare class CPUEngine extends AbstractEngine {
+    private particles;
+    private canvas;
+    private grid;
+    private animationId;
+    constructor(options: {
+        canvas: HTMLCanvasElement;
+        forces: Module[];
+        render: Module[];
+        constrainIterations?: number;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        cellSize?: number;
+    });
+    initialize(): Promise<void>;
+    protected startAnimationLoop(): void;
+    protected stopAnimationLoop(): void;
+    /**
+     * Resets animation timing to prevent large deltaTime spikes.
+     * Useful when starting after engine restoration or long pauses.
+     */
+    resetTiming(): void;
+    /**
+     * Resets the simulation to its initial state.
+     *
+     * This method:
+     * - Pauses the simulation
+     * - Clears all particles
+     * - Resets timing and FPS data
+     * - Clears force-specific caches
+     */
+    reset(): void;
+    clear(): void;
+    getCount(): number;
+    protected getEffectiveCount(): number;
+    setSize(width: number, height: number): void;
+    setParticles(particle: IParticle[]): void;
+    addParticle(particle: IParticle): void;
+    getParticles(): Promise<IParticle[]>;
+    getParticle(index: number): Promise<IParticle>;
+    destroy(): Promise<void>;
+    protected onClearColorChanged(): void;
+    protected onCellSizeChanged(): void;
+    protected onConstrainIterationsChanged(): void;
+    protected onMaxNeighborsChanged(): void;
+    protected onMaxParticlesChanged(): void;
+    private animate;
+    private getNeighbors;
+    private getImageData;
+    private update;
+    private createRenderUtils;
+    private render;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/runtimes/cpu/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cpu/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EACL,MAAM,EAKP,MAAM,cAAc,CAAC;AAKtB,qBAAa,SAAU,SAAQ,cAAc;IAC3C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,WAAW,CAAuB;gBAE9B,OAAO,EAAE;QACnB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAUD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAQpC,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAOnC;;;OAGG;IACI,WAAW,IAAI,IAAI;IAI1B;;;;;;;;OAQG;IACI,KAAK,IAAI,IAAI;IAapB,KAAK,IAAI,IAAI;IAQb,QAAQ,IAAI,MAAM;IAQlB,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAKrC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5C,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI;IASzC,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAMtC,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxB,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAKrC,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAKnC,SAAS,CAAC,4BAA4B,IAAI,IAAI;IAK9C,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAIvC,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAIvC,OAAO,CAAC,OAAO,CAab;IAEF,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,MAAM;IAwOd,OAAO,CAAC,iBAAiB;IAwCzB,OAAO,CAAC,MAAM;CAgHf"}

package/dist/runtimes/cpu/spatial-grid.d.ts

@@ -0,0 +1,56 @@
+import { Particle } from "../../particle";
+import { Vector } from "../../vector";
+export interface SpatialGridOptions {
+    width: number;
+    height: number;
+    cellSize: number;
+}
+export declare class SpatialGrid {
+    private width;
+    private height;
+    private cellSize;
+    private cols;
+    private rows;
+    private grid;
+    private minX;
+    private minY;
+    private maxX;
+    private maxY;
+    private cameraX;
+    private cameraY;
+    private zoom;
+    private particlePositions;
+    constructor(options: SpatialGridOptions);
+    private updateBounds;
+    setCamera(cameraX: number, cameraY: number, zoom: number): void;
+    private initializeGrid;
+    clear(): void;
+    /**
+     * Incrementally clear only cells that contained particles
+     * Much more efficient than full clear for sparse grids
+     */
+    clearIncremental(_particles: Particle[]): void;
+    insert(particle: Particle): void;
+    getParticles(point: Vector, radius: number, maxNeighbors?: number): Particle[];
+    getCellParticleCount(col: number, row: number): number;
+    getGridDimensions(): {
+        cols: number;
+        rows: number;
+        cellSize: number;
+    };
+    getGridBounds(): {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    };
+    getSize(): {
+        width: number;
+        height: number;
+    };
+    setSize(width: number, height: number): void;
+    getCellSize(): number;
+    setCellSize(cellSize: number): void;
+    getAllParticles(): Particle[];
+}
+//# sourceMappingURL=spatial-grid.d.ts.map

package/dist/runtimes/cpu/spatial-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-grid.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cpu/spatial-grid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAkB;IAG9B,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAU;IAEtB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,IAAI,CAAa;IAGzB,OAAO,CAAC,iBAAiB,CACb;gBAEA,OAAO,EAAE,kBAAkB;IASvC,OAAO,CAAC,YAAY;IAyBpB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAc/D,OAAO,CAAC,cAAc;IAUtB,KAAK,IAAI,IAAI;IAWb;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAsB9C,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAuBhC,YAAY,CACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,QAAQ,EAAE;IA8Cb,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAOtD,iBAAiB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAQrE,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAS3E,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO5C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5C,WAAW,IAAI,MAAM;IAIrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMnC,eAAe,IAAI,QAAQ,EAAE;CAS9B"}

package/dist/runtimes/webgpu/builders/program.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Module Builder (Program generator)
+ *
+ * Builds a single WGSL Program from a list of `Module` instances by:
+ * - Creating a packed uniform layout per module and mapping named fields to `vec4` slots
+ * - Emitting internal global helpers (simulation/grid) and optional force module globals
+ * - Generating optional state/apply/constrain/correct functions for force modules
+ * - Defining simulation entrypoints and grid entrypoints (inlined internally)
+ * - Assigning extra bind group bindings (grid, sim state, scene texture)
+ *
+ * Output:
+ * - `Program.code`: complete WGSL source for all compute passes
+ * - `Program.layouts`: uniform layout/offset metadata for writing uniforms from CPU
+ * - `Program.simStateStride`: size of the shared SIM_STATE row per particle
+ * - `Program.extraBindings`: indices for additional buffers/textures bound by pipelines
+ */
+import { Module, ModuleRole } from "../../../module";
+export declare const PARTICLE_STRUCT = "\nstruct Particle {\n  position: vec2<f32>,\n  velocity: vec2<f32>,\n  acceleration: vec2<f32>,\n  size: f32,\n  mass: f32,\n  color: vec4<f32>,\n}";
+export declare const STORAGE_DECL = "@group(0) @binding(0) var<storage, read_write> particles: array<Particle>;";
+export interface ModuleUniformLayout {
+    moduleName: string;
+    moduleRole: ModuleRole;
+    bindingIndex: number;
+    uniformsVar: string;
+    structName: string;
+    sizeBytes: number;
+    vec4Count: number;
+    mapping: Record<string, {
+        flatIndex: number;
+        expr: string;
+        offsetExpr?: string;
+    }>;
+}
+export interface Program {
+    code: string;
+    layouts: ModuleUniformLayout[];
+    simStateStride: number;
+    extraBindings: {
+        grid?: {
+            countsBinding: number;
+            indicesBinding: number;
+        };
+        simState?: {
+            stateBinding: number;
+        };
+        sceneTexture?: {
+            textureBinding: number;
+        };
+        arrays?: Record<string, {
+            arrayBinding: number;
+            lengthBinding: number;
+        }>;
+    };
+}
+export declare function buildProgram(modules: readonly Module[]): Program;
+//# sourceMappingURL=program.d.ts.map

package/dist/runtimes/webgpu/builders/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../../../src/runtimes/webgpu/builders/program.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,MAAM,EACN,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,eAAe,wJAQ1B,CAAC;AAEH,eAAO,MAAM,YAAY,+EAA+E,CAAC;AAMzG,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CACzD,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE;QACb,IAAI,CAAC,EAAE;YAAE,aAAa,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,QAAQ,CAAC,EAAE;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,YAAY,CAAC,EAAE;YAAE,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1E,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAoiBhE"}

package/dist/runtimes/webgpu/builders/render-pass.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Render Pass Builder
+ *
+ * Translates `RenderModuleDescriptor` passes into standalone WGSL programs:
+ * - Fullscreen (raster) pass: draws a screen-aligned quad; optionally instanced per particle
+ * - Compute image pass: reads from an input scene texture and writes to an output scene texture
+ *
+ * Provides helpers to resolve module uniforms (`getUniform`), sample/read/write scene
+ * textures, and injects default vertex logic for instanced vs non-instanced fullscreen draws.
+ */
+import type { FullscreenRenderPass, ComputeRenderPass } from "../../../module";
+import { DataType } from "../../../module";
+import { ModuleUniformLayout } from "./program";
+export declare function buildFullscreenPassWGSL<Inputs extends Record<string, number | number[]> = Record<string, number | number[]>>(pass: FullscreenRenderPass<Inputs>, moduleName: string, layout: ModuleUniformLayout, moduleInputs: Record<keyof Inputs, DataType>, clearColor: {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}): string;
+export declare function buildComputeImagePassWGSL<Inputs extends Record<string, number | number[]> = Record<string, number | number[]>>(pass: ComputeRenderPass<Inputs>, moduleName: string, layout: ModuleUniformLayout, moduleInputs: Record<keyof Inputs, DataType>, clearColor: {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}, workgroup?: [number, number, number]): string;
+//# sourceMappingURL=render-pass.d.ts.map

package/dist/runtimes/webgpu/builders/render-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pass.d.ts","sourceRoot":"","sources":["../../../../src/runtimes/webgpu/builders/render-pass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AA6HhD,wBAAgB,uBAAuB,CACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CACvD,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,CAClB,EAED,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,MAAM,EAAE,QAAQ,CAAC,EAC5C,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,MAAM,CAkHR;AAED,wBAAgB,yBAAyB,CACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CACvD,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,CAClB,EAED,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,MAAM,EAAE,QAAQ,CAAC,EAC5C,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1D,SAAS,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAa,GAC9C,MAAM,CAkDR"}

package/dist/runtimes/webgpu/engine.d.ts

@@ -0,0 +1,73 @@
+/**
+ * WebGPU Engine
+ *
+ * High-level orchestrator that wires together GPU resources, the simulation pipeline,
+ * the render pipeline, the spatial grid, and the view controller. It owns the main
+ * animation loop and exposes a minimal API for sizing, camera/zoom control, particle
+ * data management, and play/pause lifecycle.
+ *
+ * Responsibilities:
+ * - Initialize GPU device/context and allocate core buffers via GPUResources
+ * - Build the WGSL program and per-module uniform buffers via ModuleRegistry
+ * - Initialize compute (simulation) and render pipelines
+ * - Maintain and sync the spatial grid to match the current view/camera
+ * - Drive per-frame simulation passes and render passes into ping-pong scene textures
+ * - Present the final texture to the canvas, tracking an EMA FPS estimate
+ */
+import type { Module } from "../../module";
+import { AbstractEngine, IParticle } from "../../interfaces";
+export declare class WebGPUEngine extends AbstractEngine {
+    private resources;
+    private particles;
+    private registry;
+    private sim;
+    private render;
+    private grid;
+    private bufferMaxParticles;
+    private workgroupSize;
+    private simStrideValue;
+    private shouldSyncNextTick;
+    private animationId;
+    constructor(options: {
+        canvas: HTMLCanvasElement;
+        forces: Module[];
+        render: Module[];
+        constrainIterations?: number;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        cellSize?: number;
+        maxParticles?: number;
+        workgroupSize?: number;
+        maxNeighbors?: number;
+    });
+    initialize(): Promise<void>;
+    protected startAnimationLoop(): void;
+    protected stopAnimationLoop(): void;
+    destroy(): Promise<void>;
+    setSize(width: number, height: number): void;
+    protected onViewChanged(): void;
+    setParticles(p: IParticle[]): void;
+    addParticle(p: IParticle): Promise<void>;
+    /**
+     * Forces GPU-to-CPU synchronization and returns current particle data.
+     * Use this when you need the most up-to-date particle positions from GPU.
+     */
+    getParticles(): Promise<IParticle[]>;
+    getParticle(index: number): Promise<IParticle>;
+    getCount(): number;
+    clear(): void;
+    private animate;
+    private waitForNextTick;
+    export(): Record<string, Record<string, number>>;
+    protected onModuleSettingsChanged(): void;
+    protected onClearColorChanged(): void;
+    protected onCellSizeChanged(): void;
+    protected onConstrainIterationsChanged(): void;
+    protected onMaxNeighborsChanged(): void;
+    protected onMaxParticlesChanged(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/runtimes/webgpu/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/runtimes/webgpu/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAM7D,qBAAa,YAAa,SAAQ,cAAc;IAC9C,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,WAAW,CAAuB;gBAE9B,OAAO,EAAE;QACnB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAkBK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCjC,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAQpC,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAK7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAa5C,SAAS,CAAC,aAAa,IAAI,IAAI;IAQ/B,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI;IAU5B,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKpC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKpD,QAAQ,IAAI,MAAM;IAQlB,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,OAAO,CA2Eb;IAEF,OAAO,CAAC,eAAe;IASvB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUhD,SAAS,CAAC,uBAAuB,IAAI,IAAI;IAKzC,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAKrC,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAenC,SAAS,CAAC,4BAA4B,IAAI,IAAI;IAK9C,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAIvC,SAAS,CAAC,qBAAqB,IAAI,IAAI;CAGxC"}

package/dist/runtimes/webgpu/gpu-resources.d.ts

@@ -0,0 +1,141 @@
+import type { Program, ModuleUniformLayout } from "./builders/program";
+import { ViewSnapshot } from "../../view";
+export interface SceneTextures {
+    a: GPUTexture;
+    b: GPUTexture;
+    viewA: GPUTextureView;
+    viewB: GPUTextureView;
+    sampler: GPUSampler;
+}
+export type ModuleUniformBuffer = {
+    buffer: GPUBuffer;
+    layout: ModuleUniformLayout;
+};
+export interface SimulationPipelines {
+    gridClear?: GPUComputePipeline;
+    gridBuild?: GPUComputePipeline;
+    state?: GPUComputePipeline;
+    apply?: GPUComputePipeline;
+    integrate?: GPUComputePipeline;
+    constrain?: GPUComputePipeline;
+    correct?: GPUComputePipeline;
+    main?: GPUComputePipeline;
+}
+export declare class GPUResources {
+    private particleBuffer;
+    private moduleUniformBuffers;
+    private combinedArrayStorageBuffers;
+    private arrayStorageBuffers;
+    private arrayLengthBuffers;
+    private renderUniformBuffer;
+    private renderBindGroupLayoutCache;
+    private computeBindGroupLayout;
+    private computePipelineLayout;
+    private simulationPipelines;
+    private gridCountsBuffer;
+    private gridIndicesBuffer;
+    private simStateBuffer;
+    private scene;
+    private currentScene;
+    private sceneSize;
+    private copyPipelines;
+    private simUniformCache;
+    private fullscreenPipelines;
+    private imageComputePipelines;
+    private hashWGSL;
+    canvas: HTMLCanvasElement;
+    requiredFeatures: GPUFeatureName[];
+    device: GPUDevice | null;
+    context: GPUCanvasContext | null;
+    adapter: GPUAdapter | null;
+    format: GPUTextureFormat;
+    private disposePromise;
+    constructor(options: {
+        canvas: HTMLCanvasElement;
+        requiredFeatures?: GPUFeatureName[];
+    });
+    initialize(): Promise<void>;
+    /**
+     * Starts disposal (idempotent) and returns a promise you can await *optionally*.
+     * We keep the public destroy()/dispose() calls synchronous to avoid breaking runtime toggle,
+     * but callers that care (like runtime toggle) can await this promise.
+     */
+    isInitialized(): boolean;
+    getDevice(): GPUDevice;
+    getContext(): GPUCanvasContext;
+    getParticleBuffer(): GPUBuffer | null;
+    getModuleUniformBuffers(): ModuleUniformBuffer[];
+    getRenderUniformBuffer(): GPUBuffer | null;
+    getGridCountsBuffer(): GPUBuffer | null;
+    getGridIndicesBuffer(): GPUBuffer | null;
+    getSimStateBuffer(): GPUBuffer | null;
+    createParticleBuffer(maxParticles: number, floatsPerParticle: number): void;
+    writeParticleSlice(offsetFloats: number, data: Float32Array): void;
+    writeParticleBuffer(data: Float32Array): void;
+    /**
+     * Reads particle data back from GPU to CPU
+     */
+    readParticleBuffer(sizeFloats: number): Promise<Float32Array>;
+    createModuleUniformBuffers(layouts: ModuleUniformLayout[]): void;
+    createRenderUniformBuffer(byteSize: number): void;
+    writeRenderUniforms(snapshot: ViewSnapshot): void;
+    writeModuleUniform(index: number, data: ArrayBufferView, offset?: number): void;
+    /**
+     * Writes simulation uniforms (dt, count, simStride) into the internal
+     * 'simulation' uniform buffer using the provided Program's layout.
+     */
+    writeSimulationUniform(program: Program, values: {
+        dt?: number;
+        count?: number;
+        simStride?: number;
+        maxSize?: number;
+        iteration?: number;
+        maxNeighbors?: number;
+        maxParticles?: number;
+    }): void;
+    ensureSceneTextures(width: number, height: number): void;
+    createGridStorage(totalCells: number, maxPerCell: number): void;
+    createSimStateBuffer(maxParticles: number, strideFloats: number): void;
+    getCurrentSceneTextureView(): GPUTextureView;
+    getOtherSceneTextureView(): GPUTextureView;
+    getSceneSampler(): GPUSampler;
+    swapSceneTextures(): void;
+    getRenderBindGroupLayout(arrayInputs?: string[], fragmentParticleAccess?: boolean): GPUBindGroupLayout;
+    buildComputeLayouts(compute: Program): void;
+    getComputeBindGroupLayout(): GPUBindGroupLayout;
+    buildComputePipelines(code: string): void;
+    getSimulationPipelines(): SimulationPipelines;
+    getCopyPipeline(format: GPUTextureFormat): GPURenderPipeline;
+    getOrCreateFullscreenRenderPipeline(shaderCode: string, arrayInputs?: string[], fragmentParticleAccess?: boolean): GPURenderPipeline;
+    getOrCreateImageComputePipeline(shaderCode: string): GPUComputePipeline;
+    createFullscreenBindGroup(particleBuffer: GPUBuffer, renderUniformBuffer: GPUBuffer, readSceneView: GPUTextureView, sceneSampler: GPUSampler, moduleUniformBuffer: GPUBuffer, moduleName: string, arrayInputs?: string[], fragmentParticleAccess?: boolean): GPUBindGroup;
+    createComputeBindGroup(compute: Program): GPUBindGroup;
+    createImageComputeBindGroup(pipeline: GPUComputePipeline, readView: GPUTextureView, writeView: GPUTextureView, moduleUniformBuffer: GPUBuffer, moduleName: string, arrayInputs?: string[]): GPUBindGroup;
+    /**
+     * Create combined array storage buffer for a module's array inputs
+     */
+    createCombinedArrayStorageBuffer(moduleName: string, arrayInputs: string[]): void;
+    /**
+     * Create array storage buffers for a module's array inputs
+     */
+    createArrayStorageBuffers(moduleName: string, arrayInputs: string[]): void;
+    /**
+     * Write combined array data to storage buffer
+     */
+    writeCombinedArrayStorage(moduleName: string, arrayDataMap: Record<string, number[]>, arrayOffsets: Record<string, number>): void;
+    /**
+     * Write array data to storage buffer
+     */
+    writeArrayStorage(moduleName: string, arrayKey: string, data: number[]): void;
+    /**
+     * Get array storage buffer for a module's array input
+     */
+    getArrayStorageBuffer(moduleName: string, arrayKey: string): GPUBuffer | undefined;
+    /**
+     * Get array length buffer for a module's array input
+     */
+    getArrayLengthBuffer(moduleName: string, arrayKey: string): GPUBuffer | undefined;
+    dispose(): Promise<void>;
+    private disposeAsync;
+}
+//# sourceMappingURL=gpu-resources.d.ts.map

package/dist/runtimes/webgpu/gpu-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-resources.d.ts","sourceRoot":"","sources":["../../../src/runtimes/webgpu/gpu-resources.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,UAAU,CAAC;IACd,CAAC,EAAE,UAAU,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,2BAA2B,CAAqC;IACxE,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,0BAA0B,CAC3B;IACP,OAAO,CAAC,sBAAsB,CAAmC;IACjE,OAAO,CAAC,qBAAqB,CAAkC;IAC/D,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,qBAAqB,CAA8C;IAC3E,OAAO,CAAC,QAAQ;IAQT,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gBAAgB,EAAE,cAAc,EAAE,CAAM;IACxC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAChC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACxC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAQ;IAClC,MAAM,EAAE,gBAAgB,CAAgB;IAI/C,OAAO,CAAC,cAAc,CAA8B;gBAExC,OAAO,EAAE;QACnB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;KACrC;IAKK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4GjC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,SAAS;IAKtB,UAAU,IAAI,gBAAgB;IAK9B,iBAAiB,IAAI,SAAS,GAAG,IAAI;IAIrC,uBAAuB,IAAI,mBAAmB,EAAE;IAIhD,sBAAsB,IAAI,SAAS,GAAG,IAAI;IAI1C,mBAAmB,IAAI,SAAS,GAAG,IAAI;IAIvC,oBAAoB,IAAI,SAAS,GAAG,IAAI;IAIxC,iBAAiB,IAAI,SAAS,GAAG,IAAI;IAIrC,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAY3E,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAWlE,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAW7C;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCnE,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAYhE,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQjD,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAmBjD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,SAAI,GAAG,IAAI;IAY1E;;;OAGG;IACH,sBAAsB,CACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,IAAI;IA2BP,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAkDxD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAe/D,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAStE,0BAA0B,IAAI,cAAc;IAK5C,wBAAwB,IAAI,cAAc;IAK1C,eAAe,IAAI,UAAU;IAK7B,iBAAiB,IAAI,IAAI;IAIzB,wBAAwB,CACtB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,sBAAsB,CAAC,EAAE,OAAO,GAC/B,kBAAkB;IA4DrB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAoE3C,yBAAyB,IAAI,kBAAkB;IAM/C,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA+BzC,sBAAsB,IAAI,mBAAmB;IAI7C,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB;IA2C5D,mCAAmC,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,sBAAsB,CAAC,EAAE,OAAO,GAC/B,iBAAiB;IAuCpB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAevE,yBAAyB,CACvB,cAAc,EAAE,SAAS,EACzB,mBAAmB,EAAE,SAAS,EAC9B,aAAa,EAAE,cAAc,EAC7B,YAAY,EAAE,UAAU,EACxB,mBAAmB,EAAE,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,sBAAsB,CAAC,EAAE,OAAO,GAC/B,YAAY;IA8Bf,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IA+EtD,2BAA2B,CACzB,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,cAAc,EACzB,mBAAmB,EAAE,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,YAAY;IA0Bf;;OAEG;IACH,gCAAgC,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,GACpB,IAAI;IAoBP;;OAEG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1E;;OAEG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,IAAI;IAuDP;;OAEG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,IAAI;IA6CP;;OAEG;IACH,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,SAAS;IAIxB;;OAEG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,SAAS;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQV,YAAY;CAuE3B"}

package/dist/runtimes/webgpu/module-registry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ModuleRegistry
+ *
+ * Central registry for modules. It builds the combined WGSL Program and manages
+ * per-module uniform state on the CPU, mirroring it into GPU uniform buffers.
+ *
+ * Key behaviors:
+ * - Builds `Program` via the builders (uniform layouts + generated WGSL code)
+ * - Allocates module uniform buffers and seeds default CPU-side uniform values
+ * - Attaches uniform writers/readers to each Module instance
+ * - Exposes helpers to get enabled render descriptors for the render pipeline
+ * - Flushes uniform state to GPU upon writes and on initialization
+ */
+import type { GPUResources } from "./gpu-resources";
+import { type Program } from "./builders/program";
+import { Module, type WebGPURenderDescriptor } from "../../module";
+/**
+ * Manages module enablement/state, builds the Program, and exposes uniform writers/readers.
+ */
+export declare class ModuleRegistry {
+    private readonly modules;
+    private program;
+    private moduleUniformState;
+    private moduleArrayState;
+    private nameToIndex;
+    private resources;
+    constructor(modules: readonly Module[]);
+    /**
+     * Build WGSL program and allocate per-module uniform buffers.
+     * Also seeds CPU-side uniform state and attaches writers/readers to modules.
+     */
+    initialize(resources: GPUResources): void;
+    getProgram(): Program;
+    /** Returns a writer for the given module name. */
+    getUniformWriter(name: string): (values: Partial<Record<string, number | number[]>>) => void;
+    /** Returns a reader for the given module name. */
+    getUniformReader(name: string): () => Partial<Record<string, number | number[]>>;
+    /** Filter enabled render module descriptors for the render pipeline. */
+    getEnabledRenderDescriptors(): WebGPURenderDescriptor[];
+    /** Get enabled render modules for the render pipeline.
+     *  Includes any module that provides render passes in its descriptor, regardless of role.
+     */
+    getEnabledRenderModules(): Module[];
+    /** Get all modules. */
+    getModules(): readonly Module[];
+    /** Write the current CPU state for all module uniforms to GPU buffers. */
+    writeAllModuleUniforms(): void;
+    private readModuleUniform;
+    private writeModuleUniform;
+    private flushModuleUniform;
+    private getModuleIndex;
+}
+//# sourceMappingURL=module-registry.d.ts.map

package/dist/runtimes/webgpu/module-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../../src/runtimes/webgpu/module-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,MAAM,EAEN,KAAK,sBAAsB,EAE5B,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,SAAS,CAA6B;gBAElC,OAAO,EAAE,SAAS,MAAM,EAAE;IAItC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IA2DzC,UAAU,IAAI,OAAO;IAKrB,kDAAkD;IAClD,gBAAgB,CACd,IAAI,EAAE,MAAM,GACX,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI;IAI/D,kDAAkD;IAClD,gBAAgB,CACd,IAAI,EAAE,MAAM,GACX,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAInD,wEAAwE;IACxE,2BAA2B,IAAI,sBAAsB,EAAE;IAUvD;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE;IAYnC,uBAAuB;IACvB,UAAU,IAAI,SAAS,MAAM,EAAE;IAI/B,0EAA0E;IAC1E,sBAAsB,IAAI,IAAI;IAU9B,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,kBAAkB;IA8D1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;CAKvB"}