@aura3d/rendering 1.0.6

package/dist/effects/GPUParticleBackend.d.ts

@@ -0,0 +1,153 @@
+export interface GPUParticleBackendCapabilities {
+    supported: boolean;
+    backend: "webgpu" | "webgl2" | "none";
+    reason?: string;
+    adapterName?: string;
+}
+export interface GPUParticleUpdateInput {
+    positions: Float32Array;
+    velocities: Float32Array;
+    accelerations?: Float32Array;
+    deltaTime: number;
+    count: number;
+}
+export interface GPUParticleUpdateResult {
+    backend: "webgpu";
+    count: number;
+    workgroups: number;
+    positions: Float32Array;
+    velocities: Float32Array;
+}
+export interface GPUParticleSpawnInput {
+    positions: Float32Array;
+    velocities: Float32Array;
+    accelerations?: Float32Array;
+    count: number;
+}
+export interface GPUParticleSpawnResult {
+    backend: "webgpu";
+    count: number;
+    workgroups: number;
+    positions: Float32Array;
+    velocities: Float32Array;
+    accelerations: Float32Array;
+}
+export interface GPUParticleBackend {
+    readonly capabilities: GPUParticleBackendCapabilities;
+    initialize(): Promise<void>;
+    spawn?(input: GPUParticleSpawnInput): Promise<GPUParticleSpawnResult>;
+    update(input: GPUParticleUpdateInput): Promise<GPUParticleUpdateResult>;
+    dispose(): void;
+}
+interface WebGPULike {
+    requestAdapter(): Promise<WebGPUAdapterLike | null>;
+}
+interface WebGPUAdapterLike {
+    requestDevice(): Promise<WebGPUDeviceLike>;
+    name?: string;
+    info?: {
+        vendor?: string;
+        architecture?: string;
+        device?: string;
+        description?: string;
+    };
+}
+interface WebGPUDeviceLike {
+    queue: WebGPUQueueLike;
+    createShaderModule(descriptor: {
+        code: string;
+        label?: string;
+    }): WebGPUShaderModuleLike;
+    createComputePipeline(descriptor: {
+        label?: string;
+        layout: "auto";
+        compute: {
+            module: WebGPUShaderModuleLike;
+            entryPoint: string;
+        };
+    }): WebGPUComputePipelineLike;
+    createBuffer(descriptor: {
+        label?: string;
+        size: number;
+        usage: number;
+        mappedAtCreation?: boolean;
+    }): WebGPUBufferLike;
+    createBindGroup(descriptor: {
+        label?: string;
+        layout: unknown;
+        entries: readonly WebGPUBindGroupEntryLike[];
+    }): WebGPUBindGroupLike;
+    createCommandEncoder(descriptor?: {
+        label?: string;
+    }): WebGPUCommandEncoderLike;
+    destroy?(): void;
+}
+interface WebGPUQueueLike {
+    writeBuffer(buffer: WebGPUBufferLike, offset: number, data: ArrayBuffer | ArrayBufferView, dataOffset?: number, size?: number): void;
+    submit(commands: readonly unknown[]): void;
+}
+interface WebGPUShaderModuleLike {
+}
+interface WebGPUComputePipelineLike {
+    getBindGroupLayout(index: number): unknown;
+}
+interface WebGPUBindGroupLike {
+}
+interface WebGPUBindGroupEntryLike {
+    binding: number;
+    resource: {
+        buffer: WebGPUBufferLike;
+    };
+}
+interface WebGPUBufferLike {
+    mapAsync(mode: number): Promise<void>;
+    getMappedRange(): ArrayBuffer;
+    unmap(): void;
+    destroy(): void;
+}
+interface WebGPUCommandEncoderLike {
+    beginComputePass(descriptor?: {
+        label?: string;
+    }): WebGPUComputePassEncoderLike;
+    copyBufferToBuffer(source: WebGPUBufferLike, sourceOffset: number, destination: WebGPUBufferLike, destinationOffset: number, size: number): void;
+    finish(): unknown;
+}
+interface WebGPUComputePassEncoderLike {
+    setPipeline(pipeline: WebGPUComputePipelineLike): void;
+    setBindGroup(index: number, bindGroup: WebGPUBindGroupLike): void;
+    dispatchWorkgroups(x: number): void;
+    end(): void;
+}
+export interface WebGPUParticleBackendOptions {
+    gpu?: WebGPULike;
+    shaderSource?: string;
+}
+export declare function detectGPUParticleBackend(globalScope?: Pick<typeof globalThis, "navigator">): GPUParticleBackendCapabilities;
+export declare function queryGPUParticleBackendCapabilities(globalScope?: Pick<typeof globalThis, "navigator">): Promise<GPUParticleBackendCapabilities>;
+export declare function createGPUParticleBackend(options?: WebGPUParticleBackendOptions): GPUParticleBackend;
+export declare class UnsupportedGPUParticleBackend implements GPUParticleBackend {
+    readonly capabilities: GPUParticleBackendCapabilities;
+    constructor(capabilities?: GPUParticleBackendCapabilities);
+    initialize(): Promise<void>;
+    update(): Promise<GPUParticleUpdateResult>;
+    dispose(): void;
+}
+export declare class WebGPUParticleBackend implements GPUParticleBackend {
+    readonly capabilities: GPUParticleBackendCapabilities;
+    private readonly gpu;
+    private readonly shaderSource;
+    private adapter;
+    private device;
+    private updatePipeline;
+    private spawnPipeline;
+    constructor(options?: WebGPUParticleBackendOptions);
+    initialize(): Promise<void>;
+    spawn(input: GPUParticleSpawnInput): Promise<GPUParticleSpawnResult>;
+    update(input: GPUParticleUpdateInput): Promise<GPUParticleUpdateResult>;
+    dispose(): void;
+    private requireDevice;
+    private requireUpdatePipeline;
+    private requireSpawnPipeline;
+}
+export {};
+//# sourceMappingURL=GPUParticleBackend.d.ts.map

package/dist/effects/GPUParticleBackend.d.ts.map

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

package/dist/effects/GPUParticleBackend.js

@@ -0,0 +1,397 @@
+const BUFFER_USAGE = {
+    MAP_READ: 0x0001,
+    COPY_SRC: 0x0004,
+    COPY_DST: 0x0008,
+    UNIFORM: 0x0040,
+    STORAGE: 0x0080,
+};
+const MAP_MODE = {
+    READ: 0x0001,
+};
+const WORKGROUP_SIZE = 64;
+export function detectGPUParticleBackend(globalScope = globalThis) {
+    const gpu = readWebGPU(globalScope);
+    if (gpu) {
+        return { supported: true, backend: "webgpu" };
+    }
+    return {
+        supported: false,
+        backend: "none",
+        reason: "GPU particle simulation requires WebGPU; CPU particles remain the supported path on this runtime.",
+    };
+}
+export async function queryGPUParticleBackendCapabilities(globalScope = globalThis) {
+    const gpu = readWebGPU(globalScope);
+    if (!gpu) {
+        return detectGPUParticleBackend(globalScope);
+    }
+    const adapter = await gpu.requestAdapter();
+    if (!adapter) {
+        return {
+            supported: false,
+            backend: "webgpu",
+            reason: "WebGPU exists but no adapter was granted for particle simulation.",
+        };
+    }
+    return {
+        supported: true,
+        backend: "webgpu",
+        adapterName: describeAdapter(adapter),
+    };
+}
+export function createGPUParticleBackend(options = {}) {
+    const gpu = options.gpu ?? readWebGPU(globalThis);
+    return gpu ? new WebGPUParticleBackend({ ...options, gpu }) : new UnsupportedGPUParticleBackend();
+}
+export class UnsupportedGPUParticleBackend {
+    capabilities;
+    constructor(capabilities = detectGPUParticleBackend()) {
+        this.capabilities = capabilities.supported
+            ? {
+                supported: false,
+                backend: capabilities.backend,
+                reason: "GPU particle simulation is not supported by the current runtime configuration.",
+            }
+            : capabilities;
+    }
+    async initialize() {
+        throw new Error(this.capabilities.reason ?? "GPU particle simulation is not supported by this runtime.");
+    }
+    async update() {
+        throw new Error(this.capabilities.reason ?? "GPU particle simulation is not supported by this runtime.");
+    }
+    dispose() {
+        // No native resources are owned when the backend is unsupported.
+    }
+}
+export class WebGPUParticleBackend {
+    capabilities = { supported: true, backend: "webgpu" };
+    gpu;
+    shaderSource;
+    adapter = null;
+    device = null;
+    updatePipeline = null;
+    spawnPipeline = null;
+    constructor(options = {}) {
+        const gpu = options.gpu ?? readWebGPU(globalThis);
+        if (!gpu) {
+            throw new Error("WebGPUParticleBackend requires a WebGPU-capable runtime or an injected gpu adapter.");
+        }
+        this.gpu = gpu;
+        this.shaderSource = options.shaderSource ?? createDefaultParticleComputeShader();
+    }
+    async initialize() {
+        if (this.device && this.updatePipeline && this.spawnPipeline) {
+            return;
+        }
+        this.adapter = await this.gpu.requestAdapter();
+        if (!this.adapter) {
+            throw new Error("WebGPU adapter request failed for particle simulation.");
+        }
+        this.device = await this.adapter.requestDevice();
+        const module = this.device.createShaderModule({
+            label: "aura3d-particles-update",
+            code: this.shaderSource,
+        });
+        this.updatePipeline = this.device.createComputePipeline({
+            label: "aura3d-particles-update",
+            layout: "auto",
+            compute: {
+                module,
+                entryPoint: "main",
+            },
+        });
+        this.spawnPipeline = this.device.createComputePipeline({
+            label: "aura3d-particles-spawn",
+            layout: "auto",
+            compute: {
+                module,
+                entryPoint: "spawn_main",
+            },
+        });
+    }
+    async spawn(input) {
+        validateSpawnInput(input);
+        if (input.count === 0) {
+            return {
+                backend: "webgpu",
+                count: 0,
+                workgroups: 0,
+                positions: input.positions.slice(),
+                velocities: input.velocities.slice(),
+                accelerations: input.accelerations?.slice() ?? new Float32Array(),
+            };
+        }
+        await this.initialize();
+        const device = this.requireDevice();
+        const pipeline = this.requireSpawnPipeline();
+        const byteLength = input.count * 4 * Float32Array.BYTES_PER_ELEMENT;
+        const positionBuffer = createStorageBuffer(device, "aura3d-particles-spawn-positions", byteLength);
+        const velocityBuffer = createStorageBuffer(device, "aura3d-particles-spawn-velocities", byteLength);
+        const accelerationBuffer = createStorageBuffer(device, "aura3d-particles-spawn-accelerations", byteLength);
+        const paramsBuffer = device.createBuffer({
+            label: "aura3d-particles-spawn-params",
+            size: 16,
+            usage: BUFFER_USAGE.UNIFORM | BUFFER_USAGE.COPY_DST,
+        });
+        const positionReadback = createReadbackBuffer(device, "aura3d-particles-spawn-positions-readback", byteLength);
+        const velocityReadback = createReadbackBuffer(device, "aura3d-particles-spawn-velocities-readback", byteLength);
+        const accelerationReadback = createReadbackBuffer(device, "aura3d-particles-spawn-accelerations-readback", byteLength);
+        try {
+            device.queue.writeBuffer(positionBuffer, 0, viewParticleSlice(input.positions, input.count));
+            device.queue.writeBuffer(velocityBuffer, 0, viewParticleSlice(input.velocities, input.count));
+            device.queue.writeBuffer(accelerationBuffer, 0, viewParticleSlice(input.accelerations ?? new Float32Array(input.count * 4), input.count));
+            device.queue.writeBuffer(paramsBuffer, 0, createParamsBuffer(0, input.count));
+            const bindGroup = device.createBindGroup({
+                label: "aura3d-particles-spawn-bind-group",
+                layout: pipeline.getBindGroupLayout(0),
+                entries: [
+                    { binding: 0, resource: { buffer: positionBuffer } },
+                    { binding: 1, resource: { buffer: velocityBuffer } },
+                    { binding: 2, resource: { buffer: accelerationBuffer } },
+                    { binding: 3, resource: { buffer: paramsBuffer } },
+                ],
+            });
+            const commandEncoder = device.createCommandEncoder({ label: "aura3d-particles-spawn-encoder" });
+            const computePass = commandEncoder.beginComputePass({ label: "aura3d-particles-spawn-pass" });
+            computePass.setPipeline(pipeline);
+            computePass.setBindGroup(0, bindGroup);
+            const workgroups = Math.ceil(input.count / WORKGROUP_SIZE);
+            computePass.dispatchWorkgroups(workgroups);
+            computePass.end();
+            commandEncoder.copyBufferToBuffer(positionBuffer, 0, positionReadback, 0, byteLength);
+            commandEncoder.copyBufferToBuffer(velocityBuffer, 0, velocityReadback, 0, byteLength);
+            commandEncoder.copyBufferToBuffer(accelerationBuffer, 0, accelerationReadback, 0, byteLength);
+            device.queue.submit([commandEncoder.finish()]);
+            const [positions, velocities, accelerations] = await Promise.all([
+                readFloat32Buffer(positionReadback, byteLength),
+                readFloat32Buffer(velocityReadback, byteLength),
+                readFloat32Buffer(accelerationReadback, byteLength),
+            ]);
+            return {
+                backend: "webgpu",
+                count: input.count,
+                workgroups,
+                positions,
+                velocities,
+                accelerations,
+            };
+        }
+        finally {
+            positionBuffer.destroy();
+            velocityBuffer.destroy();
+            accelerationBuffer.destroy();
+            paramsBuffer.destroy();
+            positionReadback.destroy();
+            velocityReadback.destroy();
+            accelerationReadback.destroy();
+        }
+    }
+    async update(input) {
+        validateUpdateInput(input);
+        if (input.count === 0) {
+            return {
+                backend: "webgpu",
+                count: 0,
+                workgroups: 0,
+                positions: input.positions.slice(),
+                velocities: input.velocities.slice(),
+            };
+        }
+        await this.initialize();
+        const device = this.requireDevice();
+        const pipeline = this.requireUpdatePipeline();
+        const byteLength = input.count * 4 * Float32Array.BYTES_PER_ELEMENT;
+        const positionBuffer = createStorageBuffer(device, "aura3d-particles-positions", byteLength);
+        const velocityBuffer = createStorageBuffer(device, "aura3d-particles-velocities", byteLength);
+        const accelerationBuffer = createStorageBuffer(device, "aura3d-particles-accelerations", byteLength);
+        const paramsBuffer = device.createBuffer({
+            label: "aura3d-particles-params",
+            size: 16,
+            usage: BUFFER_USAGE.UNIFORM | BUFFER_USAGE.COPY_DST,
+        });
+        const positionReadback = createReadbackBuffer(device, "aura3d-particles-positions-readback", byteLength);
+        const velocityReadback = createReadbackBuffer(device, "aura3d-particles-velocities-readback", byteLength);
+        try {
+            device.queue.writeBuffer(positionBuffer, 0, viewParticleSlice(input.positions, input.count));
+            device.queue.writeBuffer(velocityBuffer, 0, viewParticleSlice(input.velocities, input.count));
+            device.queue.writeBuffer(accelerationBuffer, 0, viewParticleSlice(input.accelerations ?? new Float32Array(input.count * 4), input.count));
+            device.queue.writeBuffer(paramsBuffer, 0, createParamsBuffer(input.deltaTime, input.count));
+            const bindGroup = device.createBindGroup({
+                label: "aura3d-particles-update-bind-group",
+                layout: pipeline.getBindGroupLayout(0),
+                entries: [
+                    { binding: 0, resource: { buffer: positionBuffer } },
+                    { binding: 1, resource: { buffer: velocityBuffer } },
+                    { binding: 2, resource: { buffer: accelerationBuffer } },
+                    { binding: 3, resource: { buffer: paramsBuffer } },
+                ],
+            });
+            const commandEncoder = device.createCommandEncoder({ label: "aura3d-particles-update-encoder" });
+            const computePass = commandEncoder.beginComputePass({ label: "aura3d-particles-update-pass" });
+            computePass.setPipeline(pipeline);
+            computePass.setBindGroup(0, bindGroup);
+            const workgroups = Math.ceil(input.count / WORKGROUP_SIZE);
+            computePass.dispatchWorkgroups(workgroups);
+            computePass.end();
+            commandEncoder.copyBufferToBuffer(positionBuffer, 0, positionReadback, 0, byteLength);
+            commandEncoder.copyBufferToBuffer(velocityBuffer, 0, velocityReadback, 0, byteLength);
+            device.queue.submit([commandEncoder.finish()]);
+            const [positions, velocities] = await Promise.all([
+                readFloat32Buffer(positionReadback, byteLength),
+                readFloat32Buffer(velocityReadback, byteLength),
+            ]);
+            return {
+                backend: "webgpu",
+                count: input.count,
+                workgroups,
+                positions,
+                velocities,
+            };
+        }
+        finally {
+            positionBuffer.destroy();
+            velocityBuffer.destroy();
+            accelerationBuffer.destroy();
+            paramsBuffer.destroy();
+            positionReadback.destroy();
+            velocityReadback.destroy();
+        }
+    }
+    dispose() {
+        this.updatePipeline = null;
+        this.spawnPipeline = null;
+        this.adapter = null;
+        this.device?.destroy?.();
+        this.device = null;
+    }
+    requireDevice() {
+        if (!this.device) {
+            throw new Error("WebGPU particle backend was not initialized.");
+        }
+        return this.device;
+    }
+    requireUpdatePipeline() {
+        if (!this.updatePipeline) {
+            throw new Error("WebGPU particle update compute pipeline was not initialized.");
+        }
+        return this.updatePipeline;
+    }
+    requireSpawnPipeline() {
+        if (!this.spawnPipeline) {
+            throw new Error("WebGPU particle spawn compute pipeline was not initialized.");
+        }
+        return this.spawnPipeline;
+    }
+}
+function readWebGPU(globalScope) {
+    return globalScope.navigator?.gpu;
+}
+function describeAdapter(adapter) {
+    if (adapter.name) {
+        return adapter.name;
+    }
+    if (!adapter.info) {
+        return undefined;
+    }
+    const parts = [adapter.info.vendor, adapter.info.architecture, adapter.info.device, adapter.info.description].filter(Boolean);
+    return parts.length > 0 ? parts.join(" ") : undefined;
+}
+function validateUpdateInput(input) {
+    if (!Number.isFinite(input.deltaTime) || input.deltaTime < 0) {
+        throw new RangeError("GPU particle deltaTime must be a finite non-negative number.");
+    }
+    if (!Number.isInteger(input.count) || input.count < 0) {
+        throw new RangeError("GPU particle count must be a non-negative integer.");
+    }
+    const requiredFloats = input.count * 4;
+    if (input.positions.length < requiredFloats || input.velocities.length < requiredFloats) {
+        throw new RangeError("GPU particle positions and velocities must provide vec4 values for each particle.");
+    }
+    if (input.accelerations && input.accelerations.length < requiredFloats) {
+        throw new RangeError("GPU particle accelerations must provide vec4 values for each particle.");
+    }
+}
+function validateSpawnInput(input) {
+    if (!Number.isInteger(input.count) || input.count < 0) {
+        throw new RangeError("GPU particle spawn count must be a non-negative integer.");
+    }
+    const requiredFloats = input.count * 4;
+    if (input.positions.length < requiredFloats || input.velocities.length < requiredFloats) {
+        throw new RangeError("GPU particle spawn positions and velocities must provide vec4 values for each particle.");
+    }
+    if (input.accelerations && input.accelerations.length < requiredFloats) {
+        throw new RangeError("GPU particle spawn accelerations must provide vec4 values for each particle.");
+    }
+}
+function createStorageBuffer(device, label, size) {
+    return device.createBuffer({
+        label,
+        size,
+        usage: BUFFER_USAGE.STORAGE | BUFFER_USAGE.COPY_DST | BUFFER_USAGE.COPY_SRC,
+    });
+}
+function createReadbackBuffer(device, label, size) {
+    return device.createBuffer({
+        label,
+        size,
+        usage: BUFFER_USAGE.MAP_READ | BUFFER_USAGE.COPY_DST,
+    });
+}
+function viewParticleSlice(values, count) {
+    const floatCount = count * 4;
+    return values.byteOffset === 0 && values.length === floatCount ? values : values.slice(0, floatCount);
+}
+function createParamsBuffer(deltaTime, count) {
+    const buffer = new ArrayBuffer(16);
+    const view = new DataView(buffer);
+    view.setFloat32(0, deltaTime, true);
+    view.setUint32(4, count, true);
+    return buffer;
+}
+async function readFloat32Buffer(buffer, byteLength) {
+    await buffer.mapAsync(MAP_MODE.READ);
+    const mapped = buffer.getMappedRange();
+    const copy = mapped.slice(0, byteLength);
+    buffer.unmap();
+    return new Float32Array(copy);
+}
+function createDefaultParticleComputeShader() {
+    return `
+struct SimParams {
+  deltaTime: f32,
+  count: u32,
+  pad0: u32,
+  pad1: u32,
+};
+
+@group(0) @binding(0) var<storage, read_write> positions: array<vec4<f32>>;
+@group(0) @binding(1) var<storage, read_write> velocities: array<vec4<f32>>;
+@group(0) @binding(2) var<storage, read> accelerations: array<vec4<f32>>;
+@group(0) @binding(3) var<uniform> params: SimParams;
+
+@compute @workgroup_size(${WORKGROUP_SIZE})
+fn main(@builtin(global_invocation_id) globalId: vec3<u32>) {
+  let index = globalId.x;
+  if (index >= params.count) {
+    return;
+  }
+
+  velocities[index].xyz = velocities[index].xyz + accelerations[index].xyz * params.deltaTime;
+  positions[index].xyz = positions[index].xyz + velocities[index].xyz * params.deltaTime;
+  positions[index].w = positions[index].w + params.deltaTime;
+}
+
+@compute @workgroup_size(${WORKGROUP_SIZE})
+fn spawn_main(@builtin(global_invocation_id) globalId: vec3<u32>) {
+  let index = globalId.x;
+  if (index >= params.count) {
+    return;
+  }
+
+  positions[index] = positions[index];
+  velocities[index] = velocities[index];
+}
+`;
+}
+//# sourceMappingURL=GPUParticleBackend.js.map

package/dist/effects/GPUParticleBackend.js.map

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

package/dist/effects/Particle.d.ts

@@ -0,0 +1,49 @@
+export interface Vector3Like {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface ColorLike {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface Particle {
+    id: number;
+    age: number;
+    lifetime: number;
+    position: Vector3Like;
+    previousPosition: Vector3Like;
+    velocity: Vector3Like;
+    acceleration: Vector3Like;
+    color: ColorLike;
+    size: number;
+    rotation: number;
+    angularVelocity: number;
+    alive: boolean;
+    userData: Record<string, unknown>;
+}
+export interface ParticleInitialState {
+    id?: number;
+    age?: number;
+    lifetime?: number;
+    position?: Partial<Vector3Like>;
+    velocity?: Partial<Vector3Like>;
+    acceleration?: Partial<Vector3Like>;
+    color?: Partial<ColorLike>;
+    size?: number;
+    rotation?: number;
+    angularVelocity?: number;
+    alive?: boolean;
+    userData?: Record<string, unknown>;
+}
+export declare function createVector3(value?: Partial<Vector3Like>): Vector3Like;
+export declare function cloneVector3(value: Vector3Like): Vector3Like;
+export declare function addScaledVector3(target: Vector3Like, source: Vector3Like, scale: number): void;
+export declare function setVector3(target: Vector3Like, source: Vector3Like): void;
+export declare function createColor(value?: Partial<ColorLike>): ColorLike;
+export declare function cloneColor(value: ColorLike): ColorLike;
+export declare function createParticle(initial?: ParticleInitialState): Particle;
+export declare function normalizedParticleAge(particle: Particle): number;
+//# sourceMappingURL=Particle.d.ts.map

package/dist/effects/Particle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Particle.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/Particle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,WAAW,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,aAAa,CAAC,KAAK,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAM3E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI9F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAIzE;AAED,wBAAgB,WAAW,CAAC,KAAK,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAOrE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAEtD;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,oBAAyB,GAAG,QAAQ,CAsB3E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEhE"}