@sadhaka/loom-engine 0.11.0 → 0.13.0

package/dist/network/sse-multiplayer-bridge.js

@@ -0,0 +1,264 @@
+// SSEMultiplayerBridge - real EventSource subscription to the
+// backend's presence endpoint, paired with a fetch POST for outbound
+// position broadcasts.
+//
+// Wire protocol (paired with Track B server-side):
+//   GET <baseUrl>?character_id=...&zone=... opens an SSE stream that
+//   emits three event types:
+//     - 'presence.snapshot' { peers: [{ character_id, x, y, zone, ts_ms, name? }] }
+//         emitted once on connect with the full current peer roster.
+//     - 'presence.update'   { character_id, x, y, zone, ts_ms, name? }
+//         emitted as peers move.
+//     - 'presence.depart'   { character_id }
+//         emitted when a peer disconnects.
+//
+//   POST <broadcastUrl> { character_id, x, y, zone, ts_ms }
+//     called by broadcastPosition at most BROADCAST_HZ per second.
+//     Engine-side rate limit; the bridge silently drops excess calls
+//     and increments rateLimitedDrops.
+//
+// Reconnect strategy: EventSource handles transport-layer reconnect
+// internally. We observe via onerror/onopen and surface 'reconnecting'
+// to the consumer. On reconnect the server is expected to re-emit a
+// fresh 'presence.snapshot', which the PeerPool consumes and treats
+// as authoritative (any peer not in the snapshot is dropped).
+//
+// Browser-only. Constructor throws if EventSource is undefined (Node
+// test environment). Tests use MockMultiplayerBridge instead.
+import { BROADCAST_MIN_INTERVAL_MS, } from './multiplayer-bridge.js';
+export class SSEMultiplayerBridge {
+    baseUrl;
+    broadcastUrl;
+    characterId;
+    zone;
+    eventSourceFactory;
+    fetchFn;
+    es = null;
+    queue = [];
+    statusValue = 'idle';
+    statsValue = {
+        messagesReceived: 0,
+        messagesSent: 0,
+        rateLimitedDrops: 0,
+        reconnects: 0,
+    };
+    lastBroadcastMs = -Infinity;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl;
+        this.broadcastUrl = opts.broadcastUrl ?? defaultBroadcastUrl(opts.baseUrl);
+        this.characterId = opts.characterId;
+        this.zone = opts.zone;
+        if (opts.eventSourceFactory) {
+            this.eventSourceFactory = opts.eventSourceFactory;
+        }
+        else {
+            if (typeof EventSource === 'undefined') {
+                throw new Error('SSEMultiplayerBridge: EventSource is not available in this environment. Use MockMultiplayerBridge for tests.');
+            }
+            const ESCtor = EventSource;
+            this.eventSourceFactory = (u) => new ESCtor(u, { withCredentials: true });
+        }
+        if (opts.fetchFn) {
+            this.fetchFn = opts.fetchFn;
+        }
+        else {
+            if (typeof fetch === 'undefined') {
+                throw new Error('SSEMultiplayerBridge: fetch is not available in this environment.');
+            }
+            this.fetchFn = fetch.bind(globalThis);
+        }
+    }
+    connect() {
+        if (this.es)
+            return;
+        this.statusValue = 'connecting';
+        this.openConnection();
+    }
+    disconnect() {
+        this.statusValue = 'closed';
+        this.closeConnection();
+    }
+    status() {
+        return this.statusValue;
+    }
+    pollMessages() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    broadcastPosition(x, y, zone, tsMs) {
+        const now = typeof performance !== 'undefined' ? performance.now() : Date.now();
+        if (now - this.lastBroadcastMs < BROADCAST_MIN_INTERVAL_MS) {
+            this.statsValue.rateLimitedDrops++;
+            return;
+        }
+        this.lastBroadcastMs = now;
+        this.statsValue.messagesSent++;
+        // Fire-and-forget POST. Errors are surfaced via stats only - the
+        // engine doesn't block on the network round trip. The body
+        // matches the server contract from the phase 15.1 spec.
+        const body = JSON.stringify({
+            character_id: this.characterId,
+            x,
+            y,
+            zone,
+            ts_ms: tsMs,
+        });
+        void this.fetchFn(this.broadcastUrl, {
+            method: 'POST',
+            credentials: 'include',
+            headers: { 'Content-Type': 'application/json' },
+            body,
+        }).catch(() => { });
+    }
+    stats() {
+        return this.statsValue;
+    }
+    // ----- Internal -----
+    buildUrl() {
+        const sep = this.baseUrl.includes('?') ? '&' : '?';
+        return (this.baseUrl +
+            sep +
+            'character_id=' + encodeURIComponent(this.characterId) +
+            '&zone=' + encodeURIComponent(this.zone));
+    }
+    openConnection() {
+        const url = this.buildUrl();
+        let es;
+        try {
+            es = this.eventSourceFactory(url);
+        }
+        catch (err) {
+            this.statusValue = 'closed';
+            throw err;
+        }
+        this.es = es;
+        es.onopen = () => {
+            this.statusValue = 'connected';
+        };
+        es.onerror = () => {
+            const closed = es.readyState === 2; // EventSource.CLOSED
+            if (closed) {
+                this.statusValue = 'closed';
+                this.closeConnection();
+                return;
+            }
+            this.statusValue = 'reconnecting';
+            this.statsValue.reconnects++;
+        };
+        es.addEventListener('presence.update', (e) => {
+            this.handleUpdate(e);
+        });
+        es.addEventListener('presence.depart', (e) => {
+            this.handleDepart(e);
+        });
+        es.addEventListener('presence.snapshot', (e) => {
+            this.handleSnapshot(e);
+        });
+    }
+    closeConnection() {
+        if (!this.es)
+            return;
+        try {
+            this.es.close();
+        }
+        catch { /* ignore */ }
+        this.es = null;
+    }
+    handleUpdate(e) {
+        const data = parseJson(e.data);
+        if (!data || typeof data !== 'object')
+            return;
+        const characterId = data.character_id;
+        const x = data.x;
+        const y = data.y;
+        const zone = data.zone;
+        const tsMs = data.ts_ms;
+        if (typeof characterId !== 'string')
+            return;
+        if (typeof x !== 'number' || typeof y !== 'number')
+            return;
+        if (typeof zone !== 'string')
+            return;
+        if (typeof tsMs !== 'number')
+            return;
+        const name = data.name;
+        this.statsValue.messagesReceived++;
+        this.queue.push({
+            kind: 'update',
+            characterId,
+            x,
+            y,
+            zone,
+            tsMs,
+            ...(typeof name === 'string' ? { name } : {}),
+        });
+    }
+    handleDepart(e) {
+        const data = parseJson(e.data);
+        if (!data || typeof data !== 'object')
+            return;
+        const characterId = data.character_id;
+        if (typeof characterId !== 'string')
+            return;
+        this.statsValue.messagesReceived++;
+        this.queue.push({ kind: 'depart', characterId });
+    }
+    handleSnapshot(e) {
+        const data = parseJson(e.data);
+        if (!data || typeof data !== 'object')
+            return;
+        const peersRaw = data.peers;
+        if (!Array.isArray(peersRaw))
+            return;
+        const peers = [];
+        for (let i = 0; i < peersRaw.length; i++) {
+            const p = peersRaw[i];
+            if (!p || typeof p !== 'object')
+                continue;
+            const characterId = p.character_id;
+            const x = p.x;
+            const y = p.y;
+            const zone = p.zone;
+            const tsMs = p.ts_ms;
+            if (typeof characterId !== 'string')
+                continue;
+            if (typeof x !== 'number' || typeof y !== 'number')
+                continue;
+            if (typeof zone !== 'string')
+                continue;
+            if (typeof tsMs !== 'number')
+                continue;
+            const name = p.name;
+            peers.push({
+                characterId,
+                x,
+                y,
+                zone,
+                tsMs,
+                ...(typeof name === 'string' ? { name } : {}),
+            });
+        }
+        this.statsValue.messagesReceived++;
+        this.queue.push({ kind: 'snapshot', peers });
+    }
+}
+function parseJson(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function defaultBroadcastUrl(baseUrl) {
+    if (baseUrl.endsWith('/events')) {
+        return baseUrl.slice(0, -'/events'.length) + '/move';
+    }
+    return baseUrl + '/move';
+}
+//# sourceMappingURL=sse-multiplayer-bridge.js.map

package/dist/network/sse-multiplayer-bridge.js.map

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

package/dist/renderer/shaders/sprite-shader-source.d.ts

@@ -0,0 +1,4 @@
+export declare const SPRITE_VERT_SRC: string;
+export declare const SPRITE_FRAG_SRC: string;
+export declare const UNIT_QUAD_VERTICES: Float32Array;
+//# sourceMappingURL=sprite-shader-source.d.ts.map

package/dist/renderer/shaders/sprite-shader-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-shader-source.d.ts","sourceRoot":"","sources":["../../../src/renderer/shaders/sprite-shader-source.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,eAAe,EAAE,MAkClB,CAAC;AAEb,eAAO,MAAM,eAAe,EAAE,MAkBlB,CAAC;AAMb,eAAO,MAAM,kBAAkB,EAAE,YAO/B,CAAC"}

package/dist/renderer/shaders/sprite-shader-source.js

@@ -0,0 +1,83 @@
+// GLSL ES 3.00 shader source for the WebGL2 sprite batcher.
+//
+// One pair of shaders services every batched draw the WebGL2Device
+// performs - sprites, tiles, particles, glyphs - by treating each
+// quad as an instance with its own screen-space origin, pixel size,
+// atlas UV rect, and RGBA tint. The vertex shader maps a static unit
+// quad onto the per-instance origin/size and forwards UV + tint to
+// the fragment shader, which samples the bound atlas and multiplies
+// by tint.
+//
+// The host (JS) is responsible for iso projection and camera
+// transform, mirroring what Canvas2DDevice does today. Keeping that
+// math out of the shader makes the GL path identical-output to the
+// Canvas2D path - very useful for parity testing and later perf
+// tuning. The trade is per-instance JS work that could in principle
+// move to the GPU; we measure that in phase 14.3.
+export const SPRITE_VERT_SRC = [
+    '#version 300 es',
+    'precision highp float;',
+    '',
+    '// Per-vertex unit-quad position. Six vertices forming two',
+    '// triangles cover (0,0)-(1,1) in normalized quad space.',
+    'layout(location = 0) in vec2 a_quadVertex;',
+    '',
+    '// Per-instance attributes - vertexAttribDivisor(1).',
+    'layout(location = 1) in vec2 a_origin;   // screen-pixel top-left of the quad',
+    'layout(location = 2) in vec2 a_size;     // screen-pixel width, height',
+    'layout(location = 3) in vec4 a_uvRect;   // u0, v0, u1, v1 within atlas',
+    'layout(location = 4) in vec4 a_tint;     // r, g, b, a',
+    '',
+    'uniform vec2 u_viewport; // viewport in pixels',
+    '',
+    'out vec2 v_uv;',
+    'out vec4 v_tint;',
+    '',
+    'void main() {',
+    '  vec2 screenPx = a_origin + a_quadVertex * a_size;',
+    '  // Map screen-pixel to clip-space NDC. Origin is top-left in',
+    '  // pixel space; flip Y to match GL clip-space.',
+    '  vec2 ndc;',
+    '  ndc.x = (screenPx.x / u_viewport.x) * 2.0 - 1.0;',
+    '  ndc.y = 1.0 - (screenPx.y / u_viewport.y) * 2.0;',
+    '  gl_Position = vec4(ndc, 0.0, 1.0);',
+    '',
+    '  // UV is linearly interpolated between the rect corners using',
+    '  // the unit-quad position as the mix factor.',
+    '  v_uv = mix(a_uvRect.xy, a_uvRect.zw, a_quadVertex);',
+    '  v_tint = a_tint;',
+    '}',
+    '',
+].join('\n');
+export const SPRITE_FRAG_SRC = [
+    '#version 300 es',
+    'precision highp float;',
+    '',
+    'in vec2 v_uv;',
+    'in vec4 v_tint;',
+    '',
+    'uniform sampler2D u_atlas;',
+    '',
+    'out vec4 outColor;',
+    '',
+    'void main() {',
+    '  vec4 sampled = texture(u_atlas, v_uv);',
+    '  vec4 c = sampled * v_tint;',
+    '  if (c.a <= 0.0) discard;',
+    '  outColor = c;',
+    '}',
+    '',
+].join('\n');
+// Static unit-quad vertex data: two triangles covering 0..1 in xy.
+// Vertex order top-left, bottom-left, top-right, top-right, bottom-
+// left, bottom-right matches the UV mapping in the vertex shader.
+// Six vertices x 2 floats = 12 floats.
+export const UNIT_QUAD_VERTICES = new Float32Array([
+    0, 0, // top-left
+    0, 1, // bottom-left
+    1, 0, // top-right
+    1, 0, // top-right
+    0, 1, // bottom-left
+    1, 1, // bottom-right
+]);
+//# sourceMappingURL=sprite-shader-source.js.map

package/dist/renderer/shaders/sprite-shader-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-shader-source.js","sourceRoot":"","sources":["../../../src/renderer/shaders/sprite-shader-source.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,mEAAmE;AACnE,kEAAkE;AAClE,oEAAoE;AACpE,qEAAqE;AACrE,mEAAmE;AACnE,oEAAoE;AACpE,WAAW;AACX,EAAE;AACF,6DAA6D;AAC7D,oEAAoE;AACpE,mEAAmE;AACnE,gEAAgE;AAChE,oEAAoE;AACpE,kDAAkD;AAElD,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,iBAAiB;IACjB,wBAAwB;IACxB,EAAE;IACF,4DAA4D;IAC5D,0DAA0D;IAC1D,4CAA4C;IAC5C,EAAE;IACF,sDAAsD;IACtD,+EAA+E;IAC/E,wEAAwE;IACxE,yEAAyE;IACzE,wDAAwD;IACxD,EAAE;IACF,gDAAgD;IAChD,EAAE;IACF,gBAAgB;IAChB,kBAAkB;IAClB,EAAE;IACF,eAAe;IACf,qDAAqD;IACrD,gEAAgE;IAChE,kDAAkD;IAClD,aAAa;IACb,oDAAoD;IACpD,oDAAoD;IACpD,sCAAsC;IACtC,EAAE;IACF,iEAAiE;IACjE,gDAAgD;IAChD,uDAAuD;IACvD,oBAAoB;IACpB,GAAG;IACH,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,iBAAiB;IACjB,wBAAwB;IACxB,EAAE;IACF,eAAe;IACf,iBAAiB;IACjB,EAAE;IACF,4BAA4B;IAC5B,EAAE;IACF,oBAAoB;IACpB,EAAE;IACF,eAAe;IACf,0CAA0C;IAC1C,8BAA8B;IAC9B,4BAA4B;IAC5B,iBAAiB;IACjB,GAAG;IACH,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,mEAAmE;AACnE,oEAAoE;AACpE,kEAAkE;AAClE,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAiB,IAAI,YAAY,CAAC;IAC/D,CAAC,EAAE,CAAC,EAAI,WAAW;IACnB,CAAC,EAAE,CAAC,EAAI,cAAc;IACtB,CAAC,EAAE,CAAC,EAAI,YAAY;IACpB,CAAC,EAAE,CAAC,EAAI,YAAY;IACpB,CAAC,EAAE,CAAC,EAAI,cAAc;IACtB,CAAC,EAAE,CAAC,EAAI,eAAe;CACxB,CAAC,CAAC"}

package/dist/renderer/sprite-batcher.d.ts

@@ -0,0 +1,30 @@
+import type { TextureAtlas } from './texture-atlas.js';
+export type BlendMode = 'alpha' | 'add';
+export declare const FLOATS_PER_INSTANCE: number;
+export type FlushHandler = (atlas: TextureAtlas, blendMode: BlendMode, data: Float32Array, count: number) => void;
+export declare class SpriteBatcher {
+    private buffer;
+    private capacity;
+    private count;
+    private currentAtlas;
+    private currentBlend;
+    private flushCount;
+    private instanceTotal;
+    private readonly flushHandler;
+    constructor(flushHandler: FlushHandler, initialCapacity?: number);
+    beginFrame(): void;
+    submit(atlas: TextureAtlas, blendMode: BlendMode, originX: number, originY: number, sizeX: number, sizeY: number, u0: number, v0: number, u1: number, v1: number, tintR: number, tintG: number, tintB: number, tintA: number): void;
+    flush(): void;
+    endFrame(): void;
+    getStats(out: {
+        flushCount: number;
+        instanceTotal: number;
+        capacity: number;
+    }): void;
+    _peekCount(): number;
+    _peekCurrentAtlas(): TextureAtlas | null;
+    _peekCurrentBlend(): BlendMode;
+    _peekBuffer(): Float32Array;
+    private grow;
+}
+//# sourceMappingURL=sprite-batcher.d.ts.map

package/dist/renderer/sprite-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-batcher.d.ts","sourceRoot":"","sources":["../../src/renderer/sprite-batcher.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;AAExC,eAAO,MAAM,mBAAmB,EAAE,MAAW,CAAC;AAO9C,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,KACV,IAAI,CAAC;AAIV,qBAAa,aAAa;IAIxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAsB;IAI1C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAa;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,YAAY,EAAE,YAAY,EAAE,eAAe,GAAE,MAAyB;IAUlF,UAAU,IAAI,IAAI;IAalB,MAAM,CACJ,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAoCP,KAAK,IAAI,IAAI;IAYb,QAAQ,IAAI,IAAI;IAQhB,QAAQ,CAAC,GAAG,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASpF,UAAU,IAAI,MAAM;IAGpB,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAGxC,iBAAiB,IAAI,SAAS;IAG9B,WAAW,IAAI,YAAY;IAO3B,OAAO,CAAC,IAAI;CAOb"}

package/dist/renderer/sprite-batcher.js

@@ -0,0 +1,146 @@
+// SpriteBatcher - per-frame instance accumulator for the WebGL2 path.
+//
+// Pure CPU-side: holds a growable Float32Array of per-instance data
+// and tracks the current batch key (atlas + blend mode). submit()
+// appends; if the batch key changes it flushes the current run via
+// a handler the device wires up at construction. flush() also runs
+// from endFrame to drain any pending instances.
+//
+// 12 floats per instance:
+//   [origin.x, origin.y, size.x, size.y,
+//    uv0.x, uv0.y, uv1.x, uv1.y,
+//    tint.r, tint.g, tint.b, tint.a]
+//
+// Why: a single drawArraysInstanced call covers the whole batch with
+// one CPU->GPU upload of the instance buffer. Atlas swap forces a
+// flush because the bound texture changes; blend-mode swap forces a
+// flush because gl.blendFunc state changes.
+//
+// Submission order is preserved within a batch. Higher-level systems
+// (SpriteRenderSystem) sort globally before submitting; the batcher
+// trusts that order. Subsequent atlas batches reset the order chain
+// but never mix across atlases - that is intentional, the cost is
+// borne by the consumer (sort by atlas then by depth if global
+// ordering across atlases matters).
+export const FLOATS_PER_INSTANCE = 12;
+const INITIAL_CAPACITY = 1024;
+export class SpriteBatcher {
+    // Instance data buffer. Grows by doubling when capacity is hit.
+    // Backing typed-array stays referentially stable when count is
+    // below capacity to avoid per-frame allocation.
+    buffer;
+    capacity;
+    // Current run state.
+    count = 0;
+    currentAtlas = null;
+    currentBlend = 'alpha';
+    // Flush statistics. Reset at beginFrame; surfaced by getStats for
+    // tests + diagnostics.
+    flushCount = 0;
+    instanceTotal = 0;
+    flushHandler;
+    constructor(flushHandler, initialCapacity = INITIAL_CAPACITY) {
+        this.flushHandler = flushHandler;
+        this.capacity = Math.max(64, initialCapacity);
+        this.buffer = new Float32Array(this.capacity * FLOATS_PER_INSTANCE);
+    }
+    // Reset for a new frame. Counts go to zero; batch state cleared.
+    // Flushes any pending instances first as a safety net (endFrame
+    // should have done this, but we belt-and-suspenders to keep the
+    // device contract clean).
+    beginFrame() {
+        if (this.count > 0 && this.currentAtlas) {
+            this.flush();
+        }
+        this.count = 0;
+        this.currentAtlas = null;
+        this.currentBlend = 'alpha';
+        this.flushCount = 0;
+        this.instanceTotal = 0;
+    }
+    // Submit one instance to the batcher. Triggers flush if the
+    // (atlas, blendMode) key differs from the current batch.
+    submit(atlas, blendMode, originX, originY, sizeX, sizeY, u0, v0, u1, v1, tintR, tintG, tintB, tintA) {
+        if (atlas.released)
+            return;
+        if (this.currentAtlas !== atlas || this.currentBlend !== blendMode) {
+            // Atlas / blend change forces a batch break. Flush the current
+            // run before installing the new key.
+            if (this.count > 0 && this.currentAtlas) {
+                this.flush();
+            }
+            this.currentAtlas = atlas;
+            this.currentBlend = blendMode;
+        }
+        if (this.count >= this.capacity) {
+            this.grow();
+        }
+        var off = this.count * FLOATS_PER_INSTANCE;
+        var b = this.buffer;
+        b[off + 0] = originX;
+        b[off + 1] = originY;
+        b[off + 2] = sizeX;
+        b[off + 3] = sizeY;
+        b[off + 4] = u0;
+        b[off + 5] = v0;
+        b[off + 6] = u1;
+        b[off + 7] = v1;
+        b[off + 8] = tintR;
+        b[off + 9] = tintG;
+        b[off + 10] = tintB;
+        b[off + 11] = tintA;
+        this.count++;
+    }
+    // Flush the current run via the device-supplied handler. No-op if
+    // nothing pending or no atlas selected.
+    flush() {
+        if (this.count === 0 || !this.currentAtlas)
+            return;
+        var atlas = this.currentAtlas;
+        var blend = this.currentBlend;
+        var n = this.count;
+        this.flushHandler(atlas, blend, this.buffer, n);
+        this.flushCount++;
+        this.instanceTotal += n;
+        this.count = 0;
+    }
+    // Final drain - call from endFrame to push the last partial batch.
+    endFrame() {
+        if (this.count > 0 && this.currentAtlas) {
+            this.flush();
+        }
+    }
+    // Diagnostics. Returned object is owned by the caller; we copy
+    // into it to avoid allocating per-frame.
+    getStats(out) {
+        out.flushCount = this.flushCount;
+        out.instanceTotal = this.instanceTotal;
+        out.capacity = this.capacity;
+    }
+    // Test-only inspection helpers. Not part of the public API but
+    // exported so the test file can assert internal state without
+    // brittle reflection.
+    _peekCount() {
+        return this.count;
+    }
+    _peekCurrentAtlas() {
+        return this.currentAtlas;
+    }
+    _peekCurrentBlend() {
+        return this.currentBlend;
+    }
+    _peekBuffer() {
+        return this.buffer;
+    }
+    // Grow by doubling. Float32Array does not resize in place; we
+    // allocate a new buffer and copy the live prefix. Triggered when
+    // submit overruns capacity.
+    grow() {
+        var next = this.capacity * 2;
+        var b = new Float32Array(next * FLOATS_PER_INSTANCE);
+        b.set(this.buffer.subarray(0, this.count * FLOATS_PER_INSTANCE));
+        this.buffer = b;
+        this.capacity = next;
+    }
+}
+//# sourceMappingURL=sprite-batcher.js.map

package/dist/renderer/sprite-batcher.js.map

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

package/dist/renderer/texture-atlas.d.ts

@@ -0,0 +1,24 @@
+import type { AtlasDescriptor } from './graphics-device.js';
+export declare class TextureAtlas {
+    texture: WebGLTexture | null;
+    readonly width: number;
+    readonly height: number;
+    readonly uvRects: Float32Array;
+    readonly frameSizes: Float32Array;
+    readonly frameCount: number;
+    readonly name: string;
+    private sourceImage;
+    released: boolean;
+    constructor(gl: WebGL2RenderingContext | null, desc: AtlasDescriptor);
+    upload(gl: WebGL2RenderingContext): void;
+    bind(gl: WebGL2RenderingContext): void;
+    handleContextLoss(): void;
+    dispose(gl: WebGL2RenderingContext | null): void;
+    lookupUVRect(frame: number, out: Float32Array, offset: number): boolean;
+    lookupFrameSize(frame: number, out: {
+        w: number;
+        h: number;
+    }): boolean;
+}
+export declare function makeParticleDiscAtlas(gl: WebGL2RenderingContext | null): TextureAtlas | null;
+//# sourceMappingURL=texture-atlas.d.ts.map

package/dist/renderer/texture-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-atlas.d.ts","sourceRoot":"","sources":["../../src/renderer/texture-atlas.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,qBAAa,YAAY;IAGvB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAKpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAMxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAI/B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAElC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAG5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAItB,OAAO,CAAC,WAAW,CAAqD;IAIxE,QAAQ,EAAE,OAAO,CAAS;gBAEd,EAAE,EAAE,sBAAsB,GAAG,IAAI,EAAE,IAAI,EAAE,eAAe;IAmCpE,MAAM,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI;IAkCxC,IAAI,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI;IAMtC,iBAAiB,IAAI,IAAI;IAIzB,OAAO,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI;IAWhD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAWvE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;CAOvE;AASD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,sBAAsB,GAAG,IAAI,GAChC,YAAY,GAAG,IAAI,CAqBrB"}