@asciiz/atoolkit 0.1.0

package/dist/adiag/bus.js

@@ -0,0 +1,225 @@
+// ==================== Bus =====================
+export class Bus {
+    state = {}; // shared state for all diag
+    maxHistory;
+    #buffer;
+    #head = 0;
+    #count = 0;
+    _listeners = new Map();
+    static TYPE_OK = "ok";
+    static TYPE_ERR = "err";
+    static TYPE_WARN = "warn";
+    static TYPE_INFO = "info";
+    constructor(maxHistory = 1000) {
+        this.maxHistory = maxHistory;
+        this.#buffer = new Array(maxHistory).fill(null);
+    }
+    get results() {
+        if (this.#count === 0)
+            return [];
+        const res = new Array(this.#count);
+        const start = (this.#head - this.#count + this.maxHistory) % this.maxHistory;
+        for (let i = 0; i < this.#count; i++) {
+            res[i] = this.#buffer[(start + i) % this.maxHistory];
+        }
+        return res;
+    }
+    set results(items) {
+        this.clear();
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            this.#add(item.type, item);
+        }
+    }
+    ok(args = {}) { return this.#add(Bus.TYPE_OK, args); }
+    err(args = {}) { return this.#add(Bus.TYPE_ERR, args); }
+    warn(args = {}) { return this.#add(Bus.TYPE_WARN, args); }
+    info(args = {}) { return this.#add(Bus.TYPE_INFO, args); }
+    /**
+     * Subscribes to diagnostic records of specified category type, or '*' for all records.
+     * Returns an unsubscribe function.
+     */
+    on(type, listener) {
+        let set = this._listeners.get(type);
+        if (!set) {
+            set = new Set();
+            this._listeners.set(type, set);
+        }
+        set.add(listener);
+        return () => {
+            set?.delete(listener);
+            if (set && set.size === 0)
+                this._listeners.delete(type);
+        };
+    }
+    onError(listener) {
+        return this.on(Bus.TYPE_ERR, listener);
+    }
+    onWarn(listener) {
+        return this.on(Bus.TYPE_WARN, listener);
+    }
+    #add(type, { code = "", raw = "", data = null, ref = null } = {}) {
+        const item = { type, code, raw, data, ref };
+        this.#buffer[this.#head] = item;
+        this.#head = (this.#head + 1) % this.maxHistory;
+        if (this.#count < this.maxHistory) {
+            this.#count++;
+        }
+        const typeListeners = this._listeners.get(type);
+        if (typeListeners) {
+            for (const fn of typeListeners)
+                fn(item);
+        }
+        const allListeners = this._listeners.get("*");
+        if (allListeners) {
+            for (const fn of allListeners)
+                fn(item);
+        }
+        return item;
+    }
+    clear() {
+        this.#head = 0;
+        this.#count = 0;
+        this.#buffer.fill(null);
+    }
+    last() {
+        if (this.#count === 0)
+            return null;
+        const lastIdx = (this.#head - 1 + this.maxHistory) % this.maxHistory;
+        return this.#buffer[lastIdx];
+    }
+    lastErr() {
+        for (let i = 0; i < this.#count; i++) {
+            const idx = (this.#head - 1 - i + this.maxHistory) % this.maxHistory;
+            const item = this.#buffer[idx];
+            if (item && item.type === Bus.TYPE_ERR) {
+                return item;
+            }
+        }
+        return null;
+    }
+    allOk() {
+        for (let i = 0; i < this.#count; i++) {
+            const idx = (this.#head - 1 - i + this.maxHistory) % this.maxHistory;
+            const item = this.#buffer[idx];
+            if (item && item.type !== Bus.TYPE_OK)
+                return false;
+        }
+        return true;
+    }
+    _findType(type) {
+        if (this.#count === 0)
+            return [];
+        const res = [];
+        const start = (this.#head - this.#count + this.maxHistory) % this.maxHistory;
+        for (let i = 0; i < this.#count; i++) {
+            const item = this.#buffer[(start + i) % this.maxHistory];
+            if (item && item.type === type) {
+                res.push(item);
+            }
+        }
+        return res;
+    }
+    findOk() {
+        return this._findType(Bus.TYPE_OK);
+    }
+    hasErrs() {
+        return this.lastErr() !== null;
+    }
+    findErrs() {
+        return this._findType(Bus.TYPE_ERR);
+    }
+    hasWarns() {
+        for (let i = 0; i < this.#count; i++) {
+            const idx = (this.#head - 1 - i + this.maxHistory) % this.maxHistory;
+            const item = this.#buffer[idx];
+            if (item && item.type === Bus.TYPE_WARN)
+                return true;
+        }
+        return false;
+    }
+    findWarns() {
+        return this._findType(Bus.TYPE_WARN);
+    }
+    hasInfos() {
+        for (let i = 0; i < this.#count; i++) {
+            const idx = (this.#head - 1 - i + this.maxHistory) % this.maxHistory;
+            const item = this.#buffer[idx];
+            if (item && item.type === Bus.TYPE_INFO)
+                return true;
+        }
+        return false;
+    }
+    findInfos() {
+        return this._findType(Bus.TYPE_INFO);
+    }
+    /**
+     * Extracts the causal reference chain starting from `result` in order of causality.
+     */
+    static getCauseChain(result) {
+        const chain = [];
+        let curr = result;
+        const seen = new Set();
+        while (curr && !seen.has(curr)) {
+            seen.add(curr);
+            chain.push(curr);
+            curr = curr.ref;
+        }
+        return chain;
+    }
+    /*
+    Replace all $key$ with data[key] in the message.
+    Support dot nesting: $key.subkey$ -> data.key.subkey
+    */
+    static compileMsg(raw = "", data = {}) {
+        if (typeof raw !== "string" || raw.length === 0)
+            return raw;
+        if (data == null || typeof data !== "object")
+            return raw;
+        return raw.replace(/\$([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)\$/g, (match, path) => {
+            if (data == null || typeof data !== "object")
+                return match;
+            let value = data;
+            for (const key of path.split(".")) {
+                if (value == null || typeof value !== "object" || !(key in value))
+                    return match;
+                value = value[key];
+            }
+            if (value instanceof Error)
+                return value.message;
+            if (typeof value === "string")
+                return value;
+            if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
+                return String(value);
+            if (value == null)
+                return String(value);
+            if (typeof value === "function")
+                return value.name ? `[Function ${value.name}]` : "[Function]";
+            try {
+                return JSON.stringify(value);
+            }
+            catch {
+                return String(value);
+            }
+        });
+    }
+    /**
+     * Formats diagnostic result into human-readable string with causal chain details.
+     */
+    static formatResult(result) {
+        const compiled = Bus.resultToMsg(result);
+        const prefix = `[${result.type.toUpperCase()}]${result.code ? ` (${result.code})` : ""}: `;
+        return `${prefix}${compiled || result.raw || "No message"}`;
+    }
+    static resultToMsg(result) {
+        return Bus.compileMsg(result.raw, result.data);
+    }
+    /**
+     * Compiles full message including causal chain explanations
+     */
+    static resultToChainMsg(result) {
+        const chain = Bus.getCauseChain(result);
+        return chain.map((r, i) => `${i > 0 ? "  -> " : ""}${Bus.resultToMsg(r) || r.code || r.type}`).join("\n");
+    }
+}
+//# sourceMappingURL=bus.js.map

package/dist/adiag/bus.js.map

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

package/dist/adiag/index.d.ts

@@ -0,0 +1,3 @@
+export { Bus } from "./bus.js";
+export type { Result, AddArgs, Type, } from "./bus.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adiag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../adiag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EACR,MAAM,EACN,OAAO,EACP,IAAI,GACP,MAAM,UAAU,CAAC"}

package/dist/adiag/index.js

@@ -0,0 +1,2 @@
+export { Bus } from "./bus.js";
+//# sourceMappingURL=index.js.map

package/dist/adiag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../adiag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/aecs/ComponentSet.d.ts

@@ -0,0 +1,33 @@
+import { type Entity } from "./Entity.js";
+/**
+ * Contiguous component set indexed by Entity.
+ */
+export declare class ComponentSet<T> implements Iterable<[Entity, T]> {
+    readonly dense: T[];
+    readonly entities: Entity[];
+    readonly sparse: number[];
+    get size(): number;
+    has(entity: Entity): boolean;
+    get(entity: Entity): T | undefined;
+    set(entity: Entity, value: T): this;
+    /**
+     * Returns existing component if present, or sets and returns defaultValue.
+     */
+    getOrAdd(entity: Entity, valueOrFactory: T | (() => T)): T;
+    /**
+     * Ensures component exists for entity. If absent, sets initial value.
+     */
+    ensure(entity: Entity, value: T): T;
+    delete(entity: Entity): boolean;
+    /**
+     * Swaps component values between two entities.
+     */
+    swap(entityA: Entity, entityB: Entity): boolean;
+    clear(): void;
+    [Symbol.iterator](): Iterator<[Entity, T]>;
+    entries(): IterableIterator<[Entity, T]>;
+    keys(): IterableIterator<Entity>;
+    values(): IterableIterator<T>;
+    each(fn: (entity: Entity, value: T) => void): void;
+}
+//# sourceMappingURL=ComponentSet.d.ts.map

package/dist/aecs/ComponentSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentSet.d.ts","sourceRoot":"","sources":["../../aecs/ComponentSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,aAAa,CAAC;AAEvD;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAE/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM5B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IASlC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAenC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;IAQ1D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAInC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAsB/B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAe/C,KAAK,IAAI,IAAI;IAMZ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAO1C,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAOxC,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAOhC,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAO9B,IAAI,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;CAMrD"}

package/dist/aecs/ComponentSet.js

@@ -0,0 +1,127 @@
+import { entityIndex } from "./Entity.js";
+/**
+ * Contiguous component set indexed by Entity.
+ */
+export class ComponentSet {
+    dense = [];
+    entities = [];
+    sparse = [];
+    get size() {
+        return this.dense.length;
+    }
+    has(entity) {
+        const slot = entityIndex(entity);
+        const denseIdx = this.sparse[slot];
+        return denseIdx !== undefined && denseIdx >= 0 && denseIdx < this.dense.length && this.entities[denseIdx] === entity;
+    }
+    get(entity) {
+        const slot = entityIndex(entity);
+        const denseIdx = this.sparse[slot];
+        if (denseIdx !== undefined && denseIdx >= 0 && denseIdx < this.dense.length && this.entities[denseIdx] === entity) {
+            return this.dense[denseIdx];
+        }
+        return undefined;
+    }
+    set(entity, value) {
+        const slot = entityIndex(entity);
+        const denseIdx = this.sparse[slot];
+        if (denseIdx !== undefined && denseIdx >= 0 && denseIdx < this.dense.length && this.entities[denseIdx] === entity) {
+            this.dense[denseIdx] = value;
+            return this;
+        }
+        const newIdx = this.dense.length;
+        this.dense.push(value);
+        this.entities.push(entity);
+        this.sparse[slot] = newIdx;
+        return this;
+    }
+    /**
+     * Returns existing component if present, or sets and returns defaultValue.
+     */
+    getOrAdd(entity, valueOrFactory) {
+        const existing = this.get(entity);
+        if (existing !== undefined)
+            return existing;
+        const val = typeof valueOrFactory === "function" ? valueOrFactory() : valueOrFactory;
+        this.set(entity, val);
+        return val;
+    }
+    /**
+     * Ensures component exists for entity. If absent, sets initial value.
+     */
+    ensure(entity, value) {
+        return this.getOrAdd(entity, value);
+    }
+    delete(entity) {
+        const slot = entityIndex(entity);
+        const denseIdx = this.sparse[slot];
+        if (denseIdx === undefined || denseIdx < 0 || denseIdx >= this.dense.length || this.entities[denseIdx] !== entity) {
+            return false;
+        }
+        const lastIdx = this.dense.length - 1;
+        if (denseIdx < lastIdx) {
+            const lastEntity = this.entities[lastIdx];
+            const lastVal = this.dense[lastIdx];
+            this.dense[denseIdx] = lastVal;
+            this.entities[denseIdx] = lastEntity;
+            this.sparse[entityIndex(lastEntity)] = denseIdx;
+        }
+        this.dense.pop();
+        this.entities.pop();
+        this.sparse[slot] = -1;
+        return true;
+    }
+    /**
+     * Swaps component values between two entities.
+     */
+    swap(entityA, entityB) {
+        const slotA = entityIndex(entityA);
+        const slotB = entityIndex(entityB);
+        const idxA = this.sparse[slotA];
+        const idxB = this.sparse[slotB];
+        if (idxA === undefined || idxA < 0 || idxA >= this.dense.length || this.entities[idxA] !== entityA)
+            return false;
+        if (idxB === undefined || idxB < 0 || idxB >= this.dense.length || this.entities[idxB] !== entityB)
+            return false;
+        const tmp = this.dense[idxA];
+        this.dense[idxA] = this.dense[idxB];
+        this.dense[idxB] = tmp;
+        return true;
+    }
+    clear() {
+        this.dense.length = 0;
+        this.entities.length = 0;
+        this.sparse.length = 0;
+    }
+    *[Symbol.iterator]() {
+        const len = this.dense.length;
+        for (let i = 0; i < len; i++) {
+            yield [this.entities[i], this.dense[i]];
+        }
+    }
+    *entries() {
+        const len = this.dense.length;
+        for (let i = 0; i < len; i++) {
+            yield [this.entities[i], this.dense[i]];
+        }
+    }
+    *keys() {
+        const len = this.dense.length;
+        for (let i = 0; i < len; i++) {
+            yield this.entities[i];
+        }
+    }
+    *values() {
+        const len = this.dense.length;
+        for (let i = 0; i < len; i++) {
+            yield this.dense[i];
+        }
+    }
+    each(fn) {
+        const len = this.dense.length;
+        for (let i = 0; i < len; i++) {
+            fn(this.entities[i], this.dense[i]);
+        }
+    }
+}
+//# sourceMappingURL=ComponentSet.js.map

package/dist/aecs/ComponentSet.js.map

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

package/dist/aecs/Entity.d.ts

@@ -0,0 +1,43 @@
+export type Entity = number;
+export declare const ENTITY_INDEX_BITS = 20;
+export declare const ENTITY_INDEX_MASK = 1048575;
+export declare const ENTITY_GEN_BITS = 12;
+export declare const ENTITY_GEN_MASK = 4095;
+/** Extracts slot index from entity identifier. */
+export declare function entityIndex(entity: Entity): number;
+/** Extracts generation counter from entity identifier. */
+export declare function entityGeneration(entity: Entity): number;
+/** Composes an entity identifier from slot index and generation. */
+export declare function makeEntity(index: number, generation: number): Entity;
+/**
+ * Generational entity identifier allocator.
+ */
+export declare class EntityPool {
+    private _nextIndex;
+    private readonly _generations;
+    private readonly _free;
+    /** Total currently active living entities. */
+    get aliveCount(): number;
+    /** Total entity slots allocated since creation. */
+    get totalAllocated(): number;
+    /**
+     * Allocates an entity identifier.
+     * Reuses recycled slot indices with incremented generation if available.
+     */
+    spawn(): Entity;
+    /**
+     * Destroys an entity and reclaims its slot for reuse.
+     * Increments slot generation to invalidate outstanding references.
+     * Returns false if entity is already destroyed or invalid.
+     */
+    destroy(entity: Entity): boolean;
+    /**
+     * Verifies whether entity identifier is currently allocated and matches active generation.
+     */
+    isAlive(entity: Entity): boolean;
+    /**
+     * Resets pool to initial state, invalidating all issued entities.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=Entity.d.ts.map

package/dist/aecs/Entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../aecs/Entity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,8CAA8C;IAC9C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,mDAAmD;IACnD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACH,KAAK,IAAI,MAAM;IAYf;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAehC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMhC;;OAEG;IACH,KAAK,IAAI,IAAI;CAMhB"}

package/dist/aecs/Entity.js

@@ -0,0 +1,82 @@
+export const ENTITY_INDEX_BITS = 20;
+export const ENTITY_INDEX_MASK = 0xFFFFF; // 1,048,575 slots
+export const ENTITY_GEN_BITS = 12;
+export const ENTITY_GEN_MASK = 0xFFF; // 4,095 generations
+/** Extracts slot index from entity identifier. */
+export function entityIndex(entity) {
+    return (entity & ENTITY_INDEX_MASK) >>> 0;
+}
+/** Extracts generation counter from entity identifier. */
+export function entityGeneration(entity) {
+    return ((entity >>> ENTITY_INDEX_BITS) & ENTITY_GEN_MASK) >>> 0;
+}
+/** Composes an entity identifier from slot index and generation. */
+export function makeEntity(index, generation) {
+    return ((((generation & ENTITY_GEN_MASK) << ENTITY_INDEX_BITS) | (index & ENTITY_INDEX_MASK)) >>> 0);
+}
+/**
+ * Generational entity identifier allocator.
+ */
+export class EntityPool {
+    _nextIndex = 1;
+    _generations = [0];
+    _free = [];
+    /** Total currently active living entities. */
+    get aliveCount() {
+        return (this._nextIndex - 1) - this._free.length;
+    }
+    /** Total entity slots allocated since creation. */
+    get totalAllocated() {
+        return this._nextIndex - 1;
+    }
+    /**
+     * Allocates an entity identifier.
+     * Reuses recycled slot indices with incremented generation if available.
+     */
+    spawn() {
+        if (this._free.length > 0) {
+            const index = this._free.pop();
+            const gen = this._generations[index];
+            return makeEntity(index, gen);
+        }
+        const index = this._nextIndex++;
+        this._generations[index] = 1;
+        return makeEntity(index, 1);
+    }
+    /**
+     * Destroys an entity and reclaims its slot for reuse.
+     * Increments slot generation to invalidate outstanding references.
+     * Returns false if entity is already destroyed or invalid.
+     */
+    destroy(entity) {
+        const index = entityIndex(entity);
+        const gen = entityGeneration(entity);
+        if (index <= 0 || index >= this._nextIndex || this._generations[index] !== gen) {
+            return false;
+        }
+        let nextGen = (gen + 1) & ENTITY_GEN_MASK;
+        if (nextGen === 0)
+            nextGen = 1;
+        this._generations[index] = nextGen;
+        this._free.push(index);
+        return true;
+    }
+    /**
+     * Verifies whether entity identifier is currently allocated and matches active generation.
+     */
+    isAlive(entity) {
+        const index = entityIndex(entity);
+        const gen = entityGeneration(entity);
+        return index > 0 && index < this._nextIndex && this._generations[index] === gen;
+    }
+    /**
+     * Resets pool to initial state, invalidating all issued entities.
+     */
+    clear() {
+        this._nextIndex = 1;
+        this._free.length = 0;
+        this._generations.length = 1;
+        this._generations[0] = 0;
+    }
+}
+//# sourceMappingURL=Entity.js.map

package/dist/aecs/Entity.js.map

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

package/dist/aecs/FloatSet.d.ts

@@ -0,0 +1,34 @@
+import { type Entity } from "./Entity.js";
+/**
+ * Contiguous Float32Array component storage for high-frequency numeric data.
+ */
+export declare class FloatSet implements Iterable<[Entity, Float32Array]> {
+    readonly stride: number;
+    dense: Float32Array;
+    entities: Entity[];
+    sparse: number[];
+    private _size;
+    constructor(stride: number, initialCapacity?: number);
+    get size(): number;
+    has(entity: Entity): boolean;
+    get(entity: Entity): Float32Array | undefined;
+    /**
+     * Reads a single float component from the entity record without allocating a subarray view.
+     */
+    getDirect(entity: Entity, componentIndex: number): number | undefined;
+    /**
+     * Writes a single float component directly into dense memory without allocating an array.
+     */
+    setDirect(entity: Entity, componentIndex: number, value: number): boolean;
+    /**
+     * Copies entity float record directly into destination buffer without creating intermediate views.
+     */
+    copyTo(entity: Entity, dst: Float32Array, dstOffset?: number): boolean;
+    set(entity: Entity, values: ArrayLike<number>): this;
+    delete(entity: Entity): boolean;
+    clear(): void;
+    [Symbol.iterator](): Iterator<[Entity, Float32Array]>;
+    keys(): IterableIterator<Entity>;
+    each(fn: (entity: Entity, data: Float32Array) => void): void;
+}
+//# sourceMappingURL=FloatSet.d.ts.map

package/dist/aecs/FloatSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatSet.d.ts","sourceRoot":"","sources":["../../aecs/FloatSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,aAAa,CAAC;AAEvD;;GAEG;AACH,qBAAa,QAAS,YAAW,QAAQ,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAM;IACxB,MAAM,EAAE,MAAM,EAAE,CAAM;IACtB,OAAO,CAAC,KAAK,CAAK;gBAEN,MAAM,EAAE,MAAM,EAAE,eAAe,SAAM;IAMjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM5B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAU7C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWrE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAYzE;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,SAAI,GAAG,OAAO;IAajE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI;IA0BpD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqB/B,KAAK,IAAI,IAAI;IAMZ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IASrD,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAOjC,IAAI,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;CAQ/D"}