@codexo/exojs 0.4.0

package/dist/esm/rendering/video/Video.js

@@ -0,0 +1,293 @@
+import { clamp } from '../../math/utils.js';
+import { Sprite } from '../sprite/Sprite.js';
+import { Texture } from '../texture/Texture.js';
+import { Signal } from '../../core/Signal.js';
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../../audio/audio-context.js';
+import { Rectangle } from '../../math/Rectangle.js';
+
+class Video extends Sprite {
+    onStart = new Signal();
+    onStop = new Signal();
+    _videoElement;
+    _duration;
+    _volume = 1;
+    _playbackRate = 1;
+    _loop = false;
+    _muted = false;
+    _audioSetup = null;
+    _textureDirty = true;
+    _lastVideoTime = Number.NaN;
+    _videoFrameCallbackHandle = null;
+    _onMetadataHandler;
+    _onResizeHandler;
+    _onVideoFrameHandler;
+    constructor(videoElement, playbackOptions, samplerOptions) {
+        super(new Texture(videoElement, samplerOptions));
+        const { duration, volume, playbackRate, loop, muted } = videoElement;
+        this._videoElement = videoElement;
+        this._duration = duration;
+        this._volume = volume;
+        this._playbackRate = playbackRate;
+        this._loop = loop;
+        this._muted = muted;
+        this._onMetadataHandler = this._onVideoMetadataUpdated.bind(this);
+        this._onResizeHandler = this._onVideoMetadataUpdated.bind(this);
+        this._onVideoFrameHandler = this._onVideoFrame.bind(this);
+        if (this._videoElement.videoWidth === 0 || this._videoElement.videoHeight === 0) {
+            this._videoElement.addEventListener('loadedmetadata', this._onMetadataHandler);
+            this._videoElement.addEventListener('resize', this._onResizeHandler);
+        }
+        if (playbackOptions) {
+            this.applyOptions(playbackOptions);
+        }
+        if (isAudioContextReady()) {
+            this.setupWithAudioContext(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this.setupWithAudioContext, this);
+        }
+        // Initialize frame bounds early when metadata is already available.
+        this.updateTexture();
+        this._requestVideoFrameCallback();
+    }
+    get videoElement() {
+        return this._videoElement;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get progress() {
+        const elapsed = this.currentTime, duration = this.duration;
+        return ((elapsed % duration) / duration);
+    }
+    get volume() {
+        return this._volume;
+    }
+    set volume(value) {
+        this.setVolume(value);
+    }
+    get loop() {
+        return this._loop;
+    }
+    set loop(loop) {
+        this.setLoop(loop);
+    }
+    get playbackRate() {
+        return this._playbackRate;
+    }
+    set playbackRate(value) {
+        this.setPlaybackRate(value);
+    }
+    get currentTime() {
+        return this.getTime();
+    }
+    set currentTime(time) {
+        this.setTime(time);
+    }
+    get muted() {
+        return this._muted;
+    }
+    set muted(muted) {
+        this.setMuted(muted);
+    }
+    get paused() {
+        return this._videoElement.paused;
+    }
+    set paused(paused) {
+        if (paused) {
+            this.pause();
+        }
+        else {
+            this.play();
+        }
+    }
+    get playing() {
+        return !this.paused;
+    }
+    set playing(playing) {
+        if (playing) {
+            this.play();
+        }
+        else {
+            this.pause();
+        }
+    }
+    get analyserTarget() {
+        return this._audioSetup?.gainNode ?? null;
+    }
+    play(options) {
+        if (options) {
+            this.applyOptions(options);
+        }
+        if (this.paused) {
+            this._videoElement.play();
+            this.onStart.dispatch();
+        }
+        return this;
+    }
+    pause(options) {
+        if (options) {
+            this.applyOptions(options);
+        }
+        if (this.playing) {
+            this._videoElement.pause();
+            this.onStop.dispatch();
+        }
+        return this;
+    }
+    stop(options) {
+        this.pause(options);
+        this.currentTime = 0;
+        return this;
+    }
+    toggle(options) {
+        return this.paused ? this.play(options) : this.pause(options);
+    }
+    applyOptions(options = {}) {
+        const { volume, loop, playbackRate, time, muted } = options;
+        if (volume !== undefined) {
+            this.volume = volume;
+        }
+        if (loop !== undefined) {
+            this.loop = loop;
+        }
+        if (playbackRate !== undefined) {
+            this.playbackRate = playbackRate;
+        }
+        if (time !== undefined) {
+            this.currentTime = time;
+        }
+        if (muted !== undefined) {
+            this.muted = muted;
+        }
+        return this;
+    }
+    setVolume(value) {
+        const volume = clamp(value, 0, 2);
+        if (this._volume === volume) {
+            return this;
+        }
+        this._volume = volume;
+        if (this._audioSetup) {
+            const { gainNode, audioContext } = this._audioSetup;
+            gainNode.gain.setTargetAtTime(this.muted ? 0 : volume, audioContext.currentTime, 10);
+        }
+        return this;
+    }
+    setLoop(loop) {
+        if (this._loop !== loop) {
+            this._loop = loop;
+            this._videoElement.loop = loop;
+        }
+        return this;
+    }
+    setPlaybackRate(value) {
+        const playbackRate = clamp(value, 0.1, 20);
+        if (this._playbackRate !== playbackRate) {
+            this._playbackRate = playbackRate;
+            this._videoElement.playbackRate = playbackRate;
+        }
+        return this;
+    }
+    getTime() {
+        return this._videoElement.currentTime;
+    }
+    setTime(time) {
+        this._videoElement.currentTime = Math.max(0, time);
+        return this;
+    }
+    setMuted(muted) {
+        if (this._muted !== muted) {
+            this._muted = muted;
+            if (this._audioSetup) {
+                const { gainNode, audioContext } = this._audioSetup;
+                gainNode.gain.setTargetAtTime(muted ? 0 : this.volume, audioContext.currentTime, 10);
+            }
+        }
+        return this;
+    }
+    render(renderManager) {
+        if (this.visible) {
+            this._markTextureDirtyIfPlaybackAdvanced();
+            this.updateTexture();
+            super.render(renderManager);
+        }
+        return this;
+    }
+    updateTexture() {
+        const texture = this.texture;
+        if (!texture || !this._videoElement) {
+            return this;
+        }
+        if (this._videoElement.videoWidth === 0 || this._videoElement.videoHeight === 0) {
+            return this;
+        }
+        if (!this._textureDirty) {
+            return this;
+        }
+        const preserveSize = this.textureFrame.width > 0 && this.textureFrame.height > 0;
+        texture.updateSource();
+        if (texture.width > 0 && texture.height > 0) {
+            this.setTextureFrame(Rectangle.temp.set(0, 0, texture.width, texture.height), !preserveSize);
+        }
+        this._textureDirty = false;
+        return this;
+    }
+    destroy() {
+        super.destroy();
+        this.stop();
+        this._videoElement.removeEventListener('loadedmetadata', this._onMetadataHandler);
+        this._videoElement.removeEventListener('resize', this._onResizeHandler);
+        this._cancelVideoFrameCallback();
+        onAudioContextReady.clearByContext(this);
+        if (this._audioSetup) {
+            this._audioSetup.sourceNode.disconnect();
+            this._audioSetup.gainNode.disconnect();
+            this._audioSetup = null;
+        }
+        this.onStart.destroy();
+        this.onStop.destroy();
+    }
+    _onVideoMetadataUpdated() {
+        this._textureDirty = true;
+        this.updateTexture();
+    }
+    _onVideoFrame(_now, _metadata) {
+        this._videoFrameCallbackHandle = null;
+        this._textureDirty = true;
+        this._requestVideoFrameCallback();
+    }
+    _markTextureDirtyIfPlaybackAdvanced() {
+        const currentTime = this._videoElement.currentTime;
+        if (this._lastVideoTime !== currentTime) {
+            this._lastVideoTime = currentTime;
+            this._textureDirty = true;
+        }
+    }
+    _requestVideoFrameCallback() {
+        const frameCallbackVideo = this._videoElement;
+        if (!frameCallbackVideo.requestVideoFrameCallback || this._videoFrameCallbackHandle !== null) {
+            return;
+        }
+        this._videoFrameCallbackHandle = frameCallbackVideo.requestVideoFrameCallback(this._onVideoFrameHandler);
+    }
+    _cancelVideoFrameCallback() {
+        const frameCallbackVideo = this._videoElement;
+        if (!frameCallbackVideo.cancelVideoFrameCallback || this._videoFrameCallbackHandle === null) {
+            return;
+        }
+        frameCallbackVideo.cancelVideoFrameCallback(this._videoFrameCallbackHandle);
+        this._videoFrameCallbackHandle = null;
+    }
+    setupWithAudioContext(audioContext) {
+        const gainNode = audioContext.createGain();
+        gainNode.gain.setTargetAtTime(this.muted ? 0 : this.volume, audioContext.currentTime, 10);
+        gainNode.connect(audioContext.destination);
+        const sourceNode = audioContext.createMediaElementSource(this._videoElement);
+        sourceNode.connect(gainNode);
+        this._audioSetup = { audioContext, gainNode, sourceNode };
+    }
+}
+
+export { Video };
+//# sourceMappingURL=Video.js.map

package/dist/esm/rendering/video/Video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Video.js","sources":["../../../../../src/rendering/video/Video.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/webgl2/AbstractWebGl2BatchedRenderer.d.ts

@@ -0,0 +1,49 @@
+import { AbstractWebGl2Renderer } from './AbstractWebGl2Renderer';
+import { Shader } from '../shader/Shader';
+import type { WebGl2VertexArrayObject, WebGl2VertexArrayObjectRuntime } from './WebGl2VertexArrayObject';
+import { WebGl2RenderBuffer, type WebGl2RenderBufferRuntime } from './WebGl2RenderBuffer';
+import type { Texture } from '../texture/Texture';
+import type { BlendModes } from '@/rendering/types';
+import type { View } from '../View';
+import type { WebGl2RendererRuntime } from './WebGl2RendererRuntime';
+import type { RenderTexture } from '../texture/RenderTexture';
+import type { Drawable } from '../Drawable';
+interface ManagedBufferState {
+    readonly handle: WebGLBuffer;
+    dataByteLength: number;
+}
+interface RendererConnection {
+    readonly gl: WebGL2RenderingContext;
+    readonly buffers: Map<WebGl2RenderBuffer, ManagedBufferState>;
+    readonly vaoHandle: WebGLVertexArrayObject;
+}
+export declare abstract class AbstractWebGl2BatchedRenderer extends AbstractWebGl2Renderer<Drawable> {
+    protected readonly attributeCount: number;
+    protected readonly batchSize: number;
+    protected readonly indexData: Uint16Array;
+    protected readonly vertexData: ArrayBuffer;
+    protected readonly float32View: Float32Array;
+    protected readonly uint32View: Uint32Array;
+    protected readonly shader: Shader;
+    protected batchIndex: number;
+    protected currentTexture: Texture | RenderTexture | null;
+    protected currentBlendMode: BlendModes | null;
+    protected currentView: View | null;
+    protected currentViewId: number;
+    protected vao: WebGl2VertexArrayObject | null;
+    protected indexBuffer: WebGl2RenderBuffer | null;
+    protected vertexBuffer: WebGl2RenderBuffer | null;
+    protected connection: RendererConnection | null;
+    protected constructor(batchSize: number, attributeCount: number, vertexSource: string, fragmentSource: string);
+    flush(): void;
+    destroy(): void;
+    protected onConnect(runtime: WebGl2RendererRuntime): void;
+    protected onDisconnect(): void;
+    abstract render(drawable: Drawable): void;
+    protected abstract createVao(gl: WebGL2RenderingContext, indexBuffer: WebGl2RenderBuffer, vertexBuffer: WebGl2RenderBuffer): WebGl2VertexArrayObject;
+    protected abstract updateView(view: View): void;
+    protected createConnection(gl: WebGL2RenderingContext): RendererConnection;
+    protected createBufferRuntime(connection: RendererConnection): WebGl2RenderBufferRuntime;
+    protected createVaoRuntime(connection: RendererConnection): WebGl2VertexArrayObjectRuntime;
+}
+export {};

package/dist/esm/rendering/webgl2/AbstractWebGl2BatchedRenderer.js

@@ -0,0 +1,175 @@
+import { AbstractWebGl2Renderer } from './AbstractWebGl2Renderer.js';
+import { Shader } from '../shader/Shader.js';
+import { createWebGl2ShaderRuntime } from './WebGl2ShaderRuntime.js';
+import { WebGl2RenderBuffer } from './WebGl2RenderBuffer.js';
+import { createQuadIndices } from '../utils.js';
+import { BufferTypes, BufferUsage } from '../types.js';
+
+class AbstractWebGl2BatchedRenderer extends AbstractWebGl2Renderer {
+    attributeCount;
+    batchSize;
+    indexData;
+    vertexData;
+    float32View;
+    uint32View;
+    shader;
+    batchIndex = 0;
+    currentTexture = null;
+    currentBlendMode = null;
+    currentView = null;
+    currentViewId = -1;
+    vao = null;
+    indexBuffer = null;
+    vertexBuffer = null;
+    connection = null;
+    constructor(batchSize, attributeCount, vertexSource, fragmentSource) {
+        super();
+        this.batchSize = batchSize;
+        this.attributeCount = attributeCount;
+        this.vertexData = new ArrayBuffer(batchSize * attributeCount * 4);
+        this.float32View = new Float32Array(this.vertexData);
+        this.uint32View = new Uint32Array(this.vertexData);
+        this.indexData = createQuadIndices(batchSize);
+        this.shader = new Shader(vertexSource, fragmentSource);
+    }
+    flush() {
+        const runtime = this.getRuntimeOrNull();
+        const vertexBuffer = this.vertexBuffer;
+        const vao = this.vao;
+        if (this.batchIndex === 0 || runtime === null || vertexBuffer === null || vao === null) {
+            return;
+        }
+        const view = runtime.view;
+        if (this.currentView !== view || this.currentViewId !== view.updateId) {
+            this.currentView = view;
+            this.currentViewId = view.updateId;
+            this.updateView(view);
+        }
+        this.shader.sync();
+        runtime.bindVertexArrayObject(vao);
+        vertexBuffer.upload(this.float32View.subarray(0, this.batchIndex * this.attributeCount));
+        vao.draw(this.batchIndex * 6, 0);
+        runtime.stats.batches++;
+        runtime.stats.drawCalls++;
+        this.batchIndex = 0;
+    }
+    destroy() {
+        this.disconnect();
+        this.shader.destroy();
+        this.currentTexture = null;
+        this.currentBlendMode = null;
+        this.currentView = null;
+        this.connection = null;
+    }
+    onConnect(runtime) {
+        const gl = runtime.context;
+        this.shader.connect(createWebGl2ShaderRuntime(gl));
+        this.connection = this.createConnection(gl);
+        this.indexBuffer = new WebGl2RenderBuffer(BufferTypes.ElementArrayBuffer, this.indexData, BufferUsage.StaticDraw)
+            .connect(this.createBufferRuntime(this.connection));
+        this.vertexBuffer = new WebGl2RenderBuffer(BufferTypes.ArrayBuffer, this.vertexData, BufferUsage.DynamicDraw)
+            .connect(this.createBufferRuntime(this.connection));
+        this.vao = this.createVao(gl, this.indexBuffer, this.vertexBuffer)
+            .connect(this.createVaoRuntime(this.connection));
+    }
+    onDisconnect() {
+        this.flush();
+        this.shader.disconnect();
+        this.indexBuffer?.destroy();
+        this.indexBuffer = null;
+        this.vertexBuffer?.destroy();
+        this.vertexBuffer = null;
+        this.vao?.destroy();
+        this.vao = null;
+        this.connection = null;
+        this.currentTexture = null;
+        this.currentBlendMode = null;
+        this.currentView = null;
+        this.currentViewId = -1;
+        this.batchIndex = 0;
+    }
+    createConnection(gl) {
+        const vaoHandle = gl.createVertexArray();
+        if (vaoHandle === null) {
+            throw new Error('Could not create vertex array object.');
+        }
+        return {
+            gl,
+            buffers: new Map(),
+            vaoHandle,
+        };
+    }
+    createBufferRuntime(connection) {
+        const handle = connection.gl.createBuffer();
+        if (handle === null) {
+            throw new Error('Could not create render buffer.');
+        }
+        return {
+            bind: (buffer) => {
+                connection.gl.bindBuffer(buffer.type, handle);
+            },
+            upload: (buffer, offset) => {
+                const gl = connection.gl;
+                const data = buffer.data;
+                const state = connection.buffers.get(buffer);
+                gl.bindBuffer(buffer.type, handle);
+                if (state && state.dataByteLength >= data.byteLength) {
+                    gl.bufferSubData(buffer.type, offset, data);
+                    state.dataByteLength = data.byteLength;
+                }
+                else {
+                    gl.bufferData(buffer.type, data, buffer.usage);
+                    connection.buffers.set(buffer, { handle, dataByteLength: data.byteLength });
+                }
+            },
+            destroy: (buffer) => {
+                connection.gl.deleteBuffer(handle);
+                connection.buffers.delete(buffer);
+                buffer.disconnect();
+            },
+        };
+    }
+    createVaoRuntime(connection) {
+        let appliedVersion = -1;
+        return {
+            bind: (vao) => {
+                const gl = connection.gl;
+                gl.bindVertexArray(connection.vaoHandle);
+                if (appliedVersion !== vao.version) {
+                    let lastBuffer = null;
+                    for (const attribute of vao.attributes) {
+                        if (lastBuffer !== attribute.buffer) {
+                            attribute.buffer.bind();
+                            lastBuffer = attribute.buffer;
+                        }
+                        gl.vertexAttribPointer(attribute.location, attribute.size, attribute.type, attribute.normalized, attribute.stride, attribute.start);
+                        gl.enableVertexAttribArray(attribute.location);
+                    }
+                    if (vao.indexBuffer) {
+                        vao.indexBuffer.bind();
+                    }
+                    appliedVersion = vao.version;
+                }
+            },
+            unbind: () => {
+                connection.gl.bindVertexArray(null);
+            },
+            draw: (vao, size, start, type) => {
+                const gl = connection.gl;
+                if (vao.indexBuffer) {
+                    gl.drawElements(type, size, gl.UNSIGNED_SHORT, start);
+                }
+                else {
+                    gl.drawArrays(type, start, size);
+                }
+            },
+            destroy: (vao) => {
+                connection.gl.deleteVertexArray(connection.vaoHandle);
+                vao.disconnect();
+            },
+        };
+    }
+}
+
+export { AbstractWebGl2BatchedRenderer };
+//# sourceMappingURL=AbstractWebGl2BatchedRenderer.js.map

package/dist/esm/rendering/webgl2/AbstractWebGl2BatchedRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractWebGl2BatchedRenderer.js","sources":["../../../../../src/rendering/webgl2/AbstractWebGl2BatchedRenderer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/webgl2/AbstractWebGl2Renderer.d.ts

@@ -0,0 +1,44 @@
+import { RenderBackendType } from '../RenderBackendType';
+import type { Drawable } from '../Drawable';
+import type { Renderer } from '../Renderer';
+import type { WebGl2RendererRuntime } from './WebGl2RendererRuntime';
+/**
+ * Base class for WebGL2 renderers.
+ *
+ * Manages the connect/disconnect lifecycle and provides a safe
+ * `getRuntime()` accessor that throws if the renderer is not connected.
+ *
+ * Subclasses must implement:
+ * - onConnect(runtime): set up GL resources
+ * - onDisconnect(): tear down GL resources
+ * - render(drawable): batch or immediately draw the given drawable
+ * - flush(): submit any batched draw calls to the GPU
+ */
+export declare abstract class AbstractWebGl2Renderer<Target extends Drawable> implements Renderer<WebGl2RendererRuntime, Target> {
+    readonly backendType = RenderBackendType.WebGl2;
+    private _runtime;
+    connect(runtime: WebGl2RendererRuntime): void;
+    disconnect(): void;
+    abstract render(drawable: Target): void;
+    abstract flush(): void;
+    /**
+     * Called once when the renderer is first connected to a runtime.
+     * Subclasses create GL resources here.
+     */
+    protected abstract onConnect(runtime: WebGl2RendererRuntime): void;
+    /**
+     * Called when the renderer is disconnected from its runtime.
+     * Subclasses tear down GL resources here.
+     */
+    protected abstract onDisconnect(): void;
+    /**
+     * Safe accessor for the connected runtime.
+     * @throws Error if the renderer is not connected.
+     */
+    protected getRuntime(): WebGl2RendererRuntime;
+    /**
+     * Returns the connected runtime, or null if not connected.
+     * Use this for conditional checks where disconnected state is expected.
+     */
+    protected getRuntimeOrNull(): WebGl2RendererRuntime | null;
+}

package/dist/esm/rendering/webgl2/AbstractWebGl2Renderer.js

@@ -0,0 +1,57 @@
+import { RenderBackendType } from '../RenderBackendType.js';
+
+/**
+ * Base class for WebGL2 renderers.
+ *
+ * Manages the connect/disconnect lifecycle and provides a safe
+ * `getRuntime()` accessor that throws if the renderer is not connected.
+ *
+ * Subclasses must implement:
+ * - onConnect(runtime): set up GL resources
+ * - onDisconnect(): tear down GL resources
+ * - render(drawable): batch or immediately draw the given drawable
+ * - flush(): submit any batched draw calls to the GPU
+ */
+class AbstractWebGl2Renderer {
+    backendType = RenderBackendType.WebGl2;
+    _runtime = null;
+    connect(runtime) {
+        if (this._runtime !== null) {
+            return;
+        }
+        if (runtime.backendType !== RenderBackendType.WebGl2) {
+            throw new Error(`${this.constructor.name} requires a WebGL2 runtime, `
+                + `but received backendType ${String(runtime.backendType)}.`);
+        }
+        this._runtime = runtime;
+        this.onConnect(runtime);
+    }
+    disconnect() {
+        if (this._runtime === null) {
+            return;
+        }
+        this.flush();
+        this.onDisconnect();
+        this._runtime = null;
+    }
+    /**
+     * Safe accessor for the connected runtime.
+     * @throws Error if the renderer is not connected.
+     */
+    getRuntime() {
+        if (this._runtime === null) {
+            throw new Error(`${this.constructor.name} is not connected to a runtime.`);
+        }
+        return this._runtime;
+    }
+    /**
+     * Returns the connected runtime, or null if not connected.
+     * Use this for conditional checks where disconnected state is expected.
+     */
+    getRuntimeOrNull() {
+        return this._runtime;
+    }
+}
+
+export { AbstractWebGl2Renderer };
+//# sourceMappingURL=AbstractWebGl2Renderer.js.map

package/dist/esm/rendering/webgl2/AbstractWebGl2Renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractWebGl2Renderer.js","sources":["../../../../../src/rendering/webgl2/AbstractWebGl2Renderer.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;;AAWG;MACmB,sBAAsB,CAAA;AAExB,IAAA,WAAW,GAAG,iBAAiB,CAAC,MAAM;IAE9C,QAAQ,GAAiC,IAAI;AAE9C,IAAA,OAAO,CAAC,OAA8B,EAAA;AACzC,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;YACxB;QACJ;QAEA,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,CAAC,MAAM,EAAE;YAClD,MAAM,IAAI,KAAK,CACX,CAAA,EAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA,4BAAA;kBACtB,CAAA,yBAAA,EAA4B,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA,CAAA,CAAG,CAC/D;QACL;AAEA,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO;AACvB,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;IAC3B;IAEO,UAAU,GAAA;AACb,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;YACxB;QACJ;QAEA,IAAI,CAAC,KAAK,EAAE;QACZ,IAAI,CAAC,YAAY,EAAE;AACnB,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;IACxB;AAiBA;;;AAGG;IACO,UAAU,GAAA;AAChB,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA,+BAAA,CAAiC,CAAC;QAC9E;QAEA,OAAO,IAAI,CAAC,QAAQ;IACxB;AAEA;;;AAGG;IACO,gBAAgB,GAAA;QACtB,OAAO,IAAI,CAAC,QAAQ;IACxB;AACH;;;;"}

package/dist/esm/rendering/webgl2/WebGl2ParticleRenderer.d.ts

@@ -0,0 +1,11 @@
+import type { WebGl2RenderBuffer } from './WebGl2RenderBuffer';
+import { WebGl2VertexArrayObject } from './WebGl2VertexArrayObject';
+import type { ParticleSystem } from '@/particles/ParticleSystem';
+import { AbstractWebGl2BatchedRenderer } from './AbstractWebGl2BatchedRenderer';
+import type { View } from '../View';
+export declare class WebGl2ParticleRenderer extends AbstractWebGl2BatchedRenderer {
+    constructor(batchSize: number);
+    render(system: ParticleSystem): this;
+    protected createVao(gl: WebGL2RenderingContext, indexBuffer: WebGl2RenderBuffer, vertexBuffer: WebGl2RenderBuffer): WebGl2VertexArrayObject;
+    protected updateView(view: View): this;
+}