@ecsia/core 0.1.0

package/dist/internal.d.ts

@@ -0,0 +1,19 @@
+export { makeHandle, handleGeneration, CapacityExceeded, } from './entity/index.js';
+export type { EntityGeneration, HandleStats, EntityLocation, EntityAccessors, } from './entity/index.js';
+export { allocU32 } from './memory/index.js';
+export type { AllocU32Options, U32Region } from './memory/index.js';
+export { Buffers, probeCapabilities, selectBacking, sharedBacking, snapshotInto, rowSlice, columnKey, tokenToColumnLayout, fieldToColumnLayout, stringIndexElement, EID_NULL, } from './memory/index.js';
+export type { Backing, BackingStrategy, Region, RegionOpts, ViewHolder, BuffersConfig, ExportedColumnHandle, ExportedRegionHandle, } from './memory/index.js';
+export { registerComponentId, UNREGISTERED, resolveDescriptor, makeAccessorFactory, bindingsFor, } from './component/index.js';
+export type { ComponentRuntime, DefKind, AccessorWorld, AccessorBinding, AccessorInstanceBase, BuildColumnSetParams, } from './component/index.js';
+export { ComponentRegistry } from './registry.js';
+export { ArchetypeStore, Storage, EMPTY_ARCHETYPE_ID, canonicalize, sigEquals, sigHash, sigHas, sigWithAdded, sigWithRemoved, buildSigWords, signatureMatches, makeColdStore, coldRowOf, } from './storage/index.js';
+export type { Archetype, ColdStore, Signature, MatchTerm, RecordSurface, StorageDeps, StorageConfig, DefRegistry, } from './storage/index.js';
+export { Bitmask } from './bitmask/index.js';
+export type { PhaseGate } from './bitmask/index.js';
+export { Reactivity, LogRing, WriteCorral, ChangeVersionStore, ObserverRegistry, OVERFLOW_SENTINEL } from './reactivity/index.js';
+export type { ReactivityDeps, LogPointer, ObserverKind, ObserverHandler, ObserverDeps, } from './reactivity/index.js';
+export { QueryEngine, LiveQuery, SparseSetU32, compileQuery } from './query/index.js';
+export type { QueryEngineDeps, LiveQueryDeps, ReactivityQueryHooks, PooledElement, CompiledQuery, CompiledValueTerm, CompileContext, ResidualTerm, RowFilterTerm, ValueRole, Word, } from './query/index.js';
+export type { ScalarValue, FieldValue, VecView, ReadonlyVecView, FieldDescriptor, TypedArrayCtor, SpawnArg, SpawnTuple, SpawnArgFor, AccessorInstance, AccessorFactory, TypedArrayLike, ColumnBinding, ReadTerm, WriteTerm, HasTerm, WithoutTerm, OptionalTerm, TermElement, UnionToIntersection, WorldQuery, LooseQueryElement, CompKey, } from '@ecsia/schema';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEnE,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,GACT,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACN,UAAU,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EACL,cAAc,EACd,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,MAAM,EACN,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACjI,YAAY,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACrF,YAAY,EACV,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,IAAI,GACL,MAAM,kBAAkB,CAAA;AAIzB,YAAY,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,eAAe,EACf,eAAe,EACf,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,OAAO,GACR,MAAM,eAAe,CAAA"}

package/dist/internal.js

@@ -0,0 +1,19 @@
+// @ecsia/core — INTERNAL surface. NOT part of the published package (`package.json#exports` maps only
+// `.` → index.ts). These are the kernel implementation primitives — store/bitmask/registry/query
+// engine/memory backing/reactivity log classes and the low-level schema inference helpers — that this
+// package's own tests reach through a RELATIVE import (`../src/internal.js`). They are deliberately
+// kept OFF the public `index.ts` so the published surface stays curated.
+//
+// Cross-package note: the symbols genuinely needed by sibling packages (@ecsia/{relations,
+// serialization}) live on the PUBLIC index.ts under an "INTERNAL (cross-package)" banner — they are
+// NOT here, because removing them would break those siblings' `@ecsia/core` imports.
+export { makeHandle, handleGeneration, CapacityExceeded, } from './entity/index.js';
+export { allocU32 } from './memory/index.js';
+export { Buffers, probeCapabilities, selectBacking, sharedBacking, snapshotInto, rowSlice, columnKey, tokenToColumnLayout, fieldToColumnLayout, stringIndexElement, EID_NULL, } from './memory/index.js';
+export { registerComponentId, UNREGISTERED, resolveDescriptor, makeAccessorFactory, bindingsFor, } from './component/index.js';
+export { ComponentRegistry } from './registry.js';
+export { ArchetypeStore, Storage, EMPTY_ARCHETYPE_ID, canonicalize, sigEquals, sigHash, sigHas, sigWithAdded, sigWithRemoved, buildSigWords, signatureMatches, makeColdStore, coldRowOf, } from './storage/index.js';
+export { Bitmask } from './bitmask/index.js';
+export { Reactivity, LogRing, WriteCorral, ChangeVersionStore, ObserverRegistry, OVERFLOW_SENTINEL } from './reactivity/index.js';
+export { QueryEngine, LiveQuery, SparseSetU32, compileQuery } from './query/index.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,iGAAiG;AACjG,sGAAsG;AACtG,oGAAoG;AACpG,yEAAyE;AACzE,EAAE;AACF,2FAA2F;AAC3F,oGAAoG;AACpG,qFAAqF;AAErF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAQ1B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,GACT,MAAM,mBAAmB,CAAA;AAY1B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAU7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EACL,cAAc,EACd,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,MAAM,EACN,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAA;AAY3B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAG5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AASjI,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/memory/allocU32.d.ts

@@ -0,0 +1,25 @@
+export interface AllocU32Options {
+    /** When true and the runtime allows it, back the array with a SharedArrayBuffer. */
+    readonly shared?: boolean;
+    /**
+     * Reserve a resizable backing whose view widens on `.grow()` up to `maxLength` elements.
+     * Omit for a fixed-size, non-resizable buffer.
+     */
+    readonly maxLength?: number;
+}
+export interface U32Region {
+    /**
+     * Length-tracking on a resizable backing (re-derives its length on `.grow()`), or fixed-size
+     * over a non-resizable backing. Never constructed with an explicit length argument over a
+     * resizable buffer.
+     */
+    readonly view: Uint32Array;
+    readonly backing: ArrayBufferLike;
+    readonly shared: boolean;
+    /** Current element capacity (`backing.byteLength / 4`). */
+    capacity(): number;
+    /** Grow the backing to at least `length` elements. No-op if already large enough. */
+    grow(length: number): void;
+}
+export declare function allocU32(length: number, opts?: AllocU32Options): U32Region;
+//# sourceMappingURL=allocU32.d.ts.map

package/dist/memory/allocU32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocU32.d.ts","sourceRoot":"","sources":["../../src/memory/allocU32.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,2DAA2D;IAC3D,QAAQ,IAAI,MAAM,CAAA;IAClB,qFAAqF;IACrF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AA8CD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,SAAS,CA0D9E"}

package/dist/memory/allocU32.js

@@ -0,0 +1,95 @@
+// The single length-tracking-view primitive the entity-identity flat arrays need
+// This is the minimal slice of the memory layer the entity layer needs: it
+// owns the one branch that decides SharedArrayBuffer vs ArrayBuffer and constructs the view
+// WITH NO LENGTH ARGUMENT so it widens automatically on `.grow()`.
+const BYTES = Uint32Array.BYTES_PER_ELEMENT;
+// Shareable iff the SharedArrayBuffer ctor exists AND cross-origin isolation is not explicitly off.
+// Node/worker_threads report `crossOriginIsolated === undefined` and CAN share SABs, so the gate is
+// `!== false` (matching the Buffers capability probe, /3) rather than
+// `=== true` — otherwise the entity-record regions would be AB in Node while columns are SAB, and a
+// worker could not read an entity's (archetypeId, row) from the shared record region.
+const canShare = () => typeof SharedArrayBuffer !== 'undefined' && globalThis.crossOriginIsolated !== false;
+// SharedArrayBuffer does not EXIST as a global in non-cross-origin-isolated browsers — referencing
+// it at module scope would throw on load. Resolve it lazily behind a typeof guard.
+const sabCtor = () => typeof SharedArrayBuffer === 'undefined'
+    ? undefined
+    : SharedArrayBuffer;
+const plainSabCtor = () => typeof SharedArrayBuffer === 'undefined' ? undefined : SharedArrayBuffer;
+const missingSab = () => {
+    throw new Error('shared backing requested but SharedArrayBuffer is unavailable (page not cross-origin isolated)');
+};
+const ResizableAb = ArrayBuffer;
+const tryResizableSab = (byteLen, maxBytes) => {
+    try {
+        const Sab = sabCtor();
+        if (!Sab)
+            return undefined;
+        return new Sab(byteLen, { maxByteLength: maxBytes });
+    }
+    catch {
+        return undefined;
+    }
+};
+const tryResizableAb = (byteLen, maxBytes) => {
+    try {
+        return new ResizableAb(byteLen, { maxByteLength: maxBytes });
+    }
+    catch {
+        return undefined;
+    }
+};
+export function allocU32(length, opts = {}) {
+    if (!Number.isInteger(length) || length < 0) {
+        throw new RangeError(`allocU32 length must be a non-negative integer; got ${length}`);
+    }
+    const wantShared = opts.shared === true && canShare();
+    const hasMax = opts.maxLength !== undefined;
+    if (hasMax && (!Number.isInteger(opts.maxLength) || opts.maxLength < length)) {
+        throw new RangeError(`allocU32 maxLength must be an integer >= length (${length}); got ${opts.maxLength}`);
+    }
+    const byteLen = length * BYTES;
+    const maxBytes = hasMax ? opts.maxLength * BYTES : byteLen;
+    let backing;
+    let shared = false;
+    if (hasMax) {
+        const sab = wantShared ? tryResizableSab(byteLen, maxBytes) : undefined;
+        if (sab !== undefined) {
+            backing = sab;
+            shared = true;
+        }
+        else {
+            const ab = tryResizableAb(byteLen, maxBytes);
+            backing = ab ?? new ArrayBuffer(byteLen);
+        }
+    }
+    else {
+        backing = wantShared ? new (plainSabCtor() ?? missingSab())(byteLen) : new ArrayBuffer(byteLen);
+        shared = wantShared;
+    }
+    // No length argument: the view length-tracks the (possibly resizable) backing.
+    return {
+        view: new Uint32Array(backing),
+        backing,
+        shared,
+        capacity() {
+            return this.backing.byteLength / BYTES;
+        },
+        grow(target) {
+            if (target <= this.capacity())
+                return;
+            const buf = this.backing;
+            const resizeFn = buf.grow ?? buf.resize;
+            const max = buf.maxByteLength;
+            if (typeof resizeFn === 'function' && typeof max === 'number') {
+                const needBytes = target * BYTES;
+                if (needBytes > max) {
+                    throw new RangeError(`allocU32 cannot grow to ${target} elements; reserved max is ${max / BYTES}`);
+                }
+                resizeFn.call(buf, needBytes);
+                return;
+            }
+            throw new RangeError('allocU32 region is not resizable (allocate with { maxLength } to enable growth)');
+        },
+    };
+}
+//# sourceMappingURL=allocU32.js.map

package/dist/memory/allocU32.js.map

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

package/dist/memory/buffers.d.ts

@@ -0,0 +1,94 @@
+import type { ColumnLayout, ElementKind, TypedArray } from './layout.js';
+export type Backing = SharedArrayBuffer | ArrayBuffer;
+export type ColumnKey = string & {
+    readonly __columnKey: unique symbol;
+};
+export type RegionKey = string & {
+    readonly __regionKey: unique symbol;
+};
+export type WorkerMode = 'single' | 'sab' | 'no-sab' | 'auto';
+export type BackingStrategy = 'resizable-sab' | 'grow-patch-sab' | 'resizable-ab' | 'grow-patch-ab';
+export interface RuntimeCapabilities {
+    readonly sabAvailable: boolean;
+    readonly resizableSab: boolean;
+    readonly resizableAb: boolean;
+    readonly waitAsync: boolean;
+    readonly waitBlocking: boolean;
+    readonly crossOriginIsolated: boolean | undefined;
+    readonly backing: BackingStrategy;
+}
+export declare const isSharedBacking: (b: ArrayBufferLike) => b is SharedArrayBuffer;
+export declare function selectBacking(req: WorkerMode, sabAvailable: boolean, resizableSab: boolean, resizableAb: boolean, emitDiagnostic?: (message: string) => void): BackingStrategy;
+export declare function probeCapabilities(req: WorkerMode, emitDiagnostic?: (message: string) => void): RuntimeCapabilities;
+export interface Column<TA extends TypedArray = TypedArray> {
+    readonly layout: ColumnLayout;
+    readonly key: ColumnKey;
+    view: TA;
+    backing: Backing;
+    capacity(): number;
+}
+export interface Region<TA extends TypedArray = TypedArray> {
+    view: TA;
+    backing: Backing;
+    readonly key: RegionKey;
+    capacity(): number;
+}
+export interface RegionOpts {
+    readonly fixed?: boolean;
+    readonly maxLength?: number;
+    readonly fill?: number;
+}
+export interface ViewHolder {
+    __rebind(newBacking: Backing): void;
+}
+export interface BuffersConfig {
+    readonly capabilities: RuntimeCapabilities;
+    readonly maxEntities: number;
+    /** _RESERVE_FACTOR — multiplies initialCapacity for the address-space reservation. */
+    readonly growthReserveFactor?: number;
+    /** _RESERVE_ROWS — floor on a column's reserved capacity. */
+    readonly minReserveRows?: number;
+}
+export interface ExportedColumnHandle {
+    readonly key: ColumnKey;
+    readonly backing: SharedArrayBuffer;
+    readonly layout: ColumnLayout;
+}
+export interface ExportedRegionHandle {
+    readonly key: RegionKey;
+    readonly backing: SharedArrayBuffer;
+    readonly element: ElementKind;
+}
+export interface SharedHandleManifest {
+    readonly columns: ReadonlyArray<ExportedColumnHandle>;
+    readonly regions: ReadonlyArray<ExportedRegionHandle>;
+}
+export interface ColumnGrowthNotice {
+    readonly key: ColumnKey;
+    readonly backing: SharedArrayBuffer;
+    readonly layout: ColumnLayout;
+}
+export interface ColumnGrowthLog {
+    /** Monotonic re-backing generation. Equal across two reads ⇒ nothing re-backed (the steady-state check). */
+    readonly generation: number;
+    /** Re-backing notices accumulated since the last drain (latest backing per column). Empty unless `generation` advanced. */
+    drain(): ColumnGrowthNotice[];
+}
+export declare class Buffers {
+    #private;
+    readonly capabilities: RuntimeCapabilities;
+    constructor(config: BuffersConfig);
+    column(key: ColumnKey, layout: ColumnLayout, initialCapacity: number): Column;
+    region(key: RegionKey, element: ElementKind, length: number, opts?: RegionOpts): Region;
+    grow(col: Column, newCapacity: number): Column;
+    columnGrowth(): ColumnGrowthLog;
+    registerAccessor(key: ColumnKey, accessor: ViewHolder): void;
+    unregisterAccessor(key: ColumnKey, accessor: ViewHolder): void;
+    get(key: ColumnKey | RegionKey): Column | Region | undefined;
+    exportSharedHandles(): SharedHandleManifest;
+}
+export declare function sharedBacking(col: Column): SharedArrayBuffer | null;
+export declare function snapshotInto(col: Column, count: number, out: TypedArray, outOffset: number): number;
+export declare function rowSlice(col: Column, row: number): TypedArray;
+export declare function columnKey(archetypeId: number, componentTypeId: number, fieldIndex: number): ColumnKey;
+//# sourceMappingURL=buffers.d.ts.map

package/dist/memory/buffers.d.ts.map

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

package/dist/memory/buffers.js

@@ -0,0 +1,308 @@
+// The buffer layer. Owns the physical column/region representation,
+// the SAB-vs-ArrayBuffer decision (the single site), and the growth protocol with its
+// load-bearing correctness invariant — accessor view-invalidation:
+// PRIMARY: length-tracking views over a resizable backing auto-widen on `.grow()`,
+// so growth re-points NOTHING.
+// FALLBACK: a non-resizable backing is re-allocated, copied, and every live ViewHolder
+// is re-bound via `__rebind` (the live-accessor registry).
+import { elementCtor } from './layout.js';
+// SharedArrayBuffer is ABSENT as a global in non-isolated browsers — never reference it at
+// module scope or in bare instanceof checks; resolve lazily behind typeof guards.
+const resizableSabCtor = () => typeof SharedArrayBuffer === 'undefined'
+    ? undefined
+    : SharedArrayBuffer;
+const plainSab = () => typeof SharedArrayBuffer === 'undefined' ? undefined : SharedArrayBuffer;
+export const isSharedBacking = (b) => typeof SharedArrayBuffer !== 'undefined' && b instanceof SharedArrayBuffer;
+const missingSharedBacking = () => {
+    throw new Error('shared backing requested but SharedArrayBuffer is unavailable (page not cross-origin isolated)');
+};
+const ResizableAb = ArrayBuffer;
+const tryCtor = (make) => {
+    try {
+        make();
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+export function selectBacking(req, sabAvailable, resizableSab, resizableAb, emitDiagnostic = () => { }) {
+    switch (req) {
+        case 'single':
+            return resizableAb ? 'resizable-ab' : 'grow-patch-ab';
+        case 'sab':
+            if (!sabAvailable) {
+                throw new Error("workers:'sab' requires SharedArrayBuffer + cross-origin isolation");
+            }
+            return resizableSab ? 'resizable-sab' : 'grow-patch-sab';
+        case 'no-sab':
+            return resizableAb ? 'resizable-ab' : 'grow-patch-ab';
+        case 'auto':
+            if (sabAvailable)
+                return resizableSab ? 'resizable-sab' : 'grow-patch-sab';
+            emitDiagnostic('SAB/cross-origin-isolation unavailable; running single-threaded');
+            return resizableAb ? 'resizable-ab' : 'grow-patch-ab';
+    }
+}
+export function probeCapabilities(req, emitDiagnostic) {
+    const sabCtor = typeof SharedArrayBuffer === 'function';
+    const coi = typeof globalThis.crossOriginIsolated !== 'undefined'
+        ? globalThis.crossOriginIsolated
+        : undefined;
+    const sabAvailable = sabCtor && coi !== false;
+    const resizableSab = sabAvailable && tryCtor(() => new (resizableSabCtor() ?? missingSharedBacking())(8, { maxByteLength: 16 }));
+    const resizableAb = tryCtor(() => new ResizableAb(8, { maxByteLength: 16 }));
+    // Atomics.waitAsync is ES2024; lib is ES2023, so it is probed through a localized cast.
+    const waitAsync = sabAvailable && typeof Atomics.waitAsync === 'function';
+    const waitBlocking = sabAvailable && typeof Atomics.wait === 'function';
+    const backing = selectBacking(req, sabAvailable, resizableSab, resizableAb, emitDiagnostic);
+    return Object.freeze({
+        sabAvailable,
+        resizableSab,
+        resizableAb,
+        waitAsync,
+        waitBlocking,
+        crossOriginIsolated: coi,
+        backing,
+    });
+}
+const DEFAULT_GROWTH_RESERVE_FACTOR = 16;
+const DEFAULT_MIN_RESERVE_ROWS = 1024;
+const isResizable = (strategy) => strategy === 'resizable-sab' || strategy === 'resizable-ab';
+const isSab = (strategy) => strategy === 'resizable-sab' || strategy === 'grow-patch-sab';
+function makeView(element, backing) {
+    // No length argument: the view length-tracks the (possibly resizable) backing.
+    const Ctor = elementCtor(element);
+    return new Ctor(backing);
+}
+function fillRange(view, start, end, value) {
+    view.fill(value, start, end);
+}
+function nextCapacityBytes(currentBytes, requiredBytes, maxBytes) {
+    // Doubling needs a non-zero base: from currentBytes===0 the doubling loop never progresses
+    // (0*2===0) and spins forever. Seed from requiredBytes so a grow off a zero-capacity backing
+    // still terminates at the required size.
+    let target = currentBytes > 0 ? currentBytes : requiredBytes;
+    while (target < requiredBytes)
+        target = target * 2;
+    return Math.min(target, maxBytes);
+}
+export class Buffers {
+    capabilities;
+    #maxEntities;
+    #growthReserveFactor;
+    #minReserveRows;
+    // One registry of column/region objects, keyed for idempotent allocation.
+    #registry = new Map();
+    #regionElement = new Map();
+    // The live-accessor registry: walked ONLY on the fallback grow path.
+    #accessors = new Map();
+    // Bumped + appended ONLY on the SAB #growFallback path (workers re-wrap the
+    // new backing at the wave fence). In-place `.grow()` never touches this — keeps it zero-cost.
+    #growGeneration = 0;
+    #pendingGrowth = new Map();
+    constructor(config) {
+        this.capabilities = config.capabilities;
+        this.#maxEntities = config.maxEntities;
+        this.#growthReserveFactor = config.growthReserveFactor ?? DEFAULT_GROWTH_RESERVE_FACTOR;
+        this.#minReserveRows = config.minReserveRows ?? DEFAULT_MIN_RESERVE_ROWS;
+    }
+    #maxCapacityFor(initialCapacity) {
+        return Math.min(Math.max(initialCapacity * this.#growthReserveFactor, this.#minReserveRows), this.#maxEntities);
+    }
+    #allocBacking(byteLen, maxBytes) {
+        switch (this.capabilities.backing) {
+            case 'resizable-sab':
+                return new (resizableSabCtor() ?? missingSharedBacking())(byteLen, { maxByteLength: maxBytes });
+            case 'resizable-ab':
+                return new ResizableAb(byteLen, { maxByteLength: maxBytes });
+            case 'grow-patch-sab':
+                return new (plainSab() ?? missingSharedBacking())(byteLen);
+            case 'grow-patch-ab':
+                return new ArrayBuffer(byteLen);
+        }
+    }
+    // Allocate (or fetch existing) a column. Idempotent per key.
+    column(key, layout, initialCapacity) {
+        const existing = this.#registry.get(key);
+        if (existing !== undefined)
+            return existing;
+        const rowBytes = layout.rowBytes;
+        const byteLen = rowBytes * initialCapacity;
+        const maxBytes = rowBytes * this.#maxCapacityFor(initialCapacity);
+        const backing = this.#allocBacking(byteLen, maxBytes);
+        const view = makeView(layout.element, backing);
+        const col = {
+            layout,
+            key,
+            view,
+            backing,
+            capacity() {
+                return this.backing.byteLength / rowBytes;
+            },
+        };
+        if (layout.fillOnInit !== 0) {
+            fillRange(view, 0, view.length, layout.fillOnInit);
+        }
+        this.#registry.set(key, col);
+        return col;
+    }
+    // A flat global region (entity records, bitmask words, log rings).
+    region(key, element, length, opts = {}) {
+        const existing = this.#registry.get(key);
+        if (existing !== undefined)
+            return existing;
+        const elementBytes = elementCtor(element).BYTES_PER_ELEMENT;
+        const byteLen = length * elementBytes;
+        const fixed = opts.fixed === true;
+        const maxRows = fixed ? length : (opts.maxLength ?? this.#maxCapacityFor(length));
+        const maxBytes = maxRows * elementBytes;
+        // A fixed region never grows; over a resizable strategy reserve exactly its length so the
+        // reservation == length and `.grow()` would refuse anyway.
+        const backing = this.#allocBacking(byteLen, Math.max(maxBytes, byteLen));
+        const view = makeView(element, backing);
+        const fill = opts.fill ?? 0;
+        if (fill !== 0)
+            fillRange(view, 0, view.length, fill);
+        const reg = {
+            view,
+            backing,
+            key,
+            capacity() {
+                return this.backing.byteLength / elementBytes;
+            },
+        };
+        this.#registry.set(key, reg);
+        this.#regionElement.set(key, element);
+        return reg;
+    }
+    // >= newCapacity rows. Returns the (possibly re-pointed) Column.
+    grow(col, newCapacity) {
+        const rowBytes = col.layout.rowBytes;
+        const required = newCapacity * rowBytes;
+        if (required <= col.backing.byteLength)
+            return col;
+        const oldCapacity = col.backing.byteLength / rowBytes;
+        const growable = col.backing;
+        const resizeFn = isResizable(this.capabilities.backing) ? (growable.grow ?? growable.resize) : undefined;
+        const max = growable.maxByteLength;
+        if (typeof resizeFn === 'function' && typeof max === 'number') {
+            const target = nextCapacityBytes(col.backing.byteLength, required, max);
+            if (target >= required) {
+                try {
+                    resizeFn.call(growable, target);
+                    // No view re-point, no registry walk, no worker re-broadcast: the length-tracking
+                    // view (and every captured view) auto-widens.: fill to the ACTUAL post-grow capacity
+                    // (the doubling protocol over-allocates beyond newCapacity), else eid rows in
+                    // [newCapacity, actualCapacity) read 0 — a valid entity index, not the -1 null sentinel.
+                    this.#fillGrownTail(col.view, col.layout, oldCapacity, col.backing.byteLength / rowBytes);
+                    return col;
+                }
+                catch {
+                    return this.#growFallback(col, newCapacity);
+                }
+            }
+            // Reservation exhausted: clamp failed to cover required → exact alloc, no cap.
+        }
+        return this.#growFallback(col, newCapacity);
+    }
+    // Serial flush point, no worker executing.
+    #growFallback(col, newCapacity) {
+        const rowBytes = col.layout.rowBytes;
+        const oldView = col.view;
+        const oldCapacity = col.backing.byteLength / rowBytes;
+        const newByteLen = newCapacity * rowBytes;
+        const newBacking = isSab(this.capabilities.backing)
+            ? new (plainSab() ?? missingSharedBacking())(newByteLen)
+            : new ArrayBuffer(newByteLen);
+        const newView = makeView(col.layout.element, newBacking);
+        newView.set(oldView);
+        this.#fillGrownTail(newView, col.layout, oldCapacity, newCapacity);
+        col.backing = newBacking;
+        col.view = newView;
+        const holders = this.#accessors.get(col.key);
+        if (holders !== undefined) {
+            for (const holder of holders)
+                holder.__rebind(newBacking);
+        }
+        // Main-thread holders are re-bound above, but worker views captured the OLD SAB at bootstrap.
+        // Record the new backing so the pool re-wraps it at the next wave fence (only SAB is worker-visible).
+        if (isSharedBacking(newBacking)) {
+            this.#growGeneration += 1;
+            this.#pendingGrowth.set(col.key, { key: col.key, backing: newBacking, layout: col.layout });
+        }
+        return col;
+    }
+    // The re-backing journal the worker pool drains at the wave fence. `generation` is a cheap
+    // monotonic int: when it is unchanged across two reads the pool skips the drain entirely (zero
+    // steady-state cost). `drain()` returns the latest backing per re-backed column and clears the queue.
+    columnGrowth() {
+        return {
+            generation: this.#growGeneration,
+            drain: () => {
+                const out = [...this.#pendingGrowth.values()];
+                this.#pendingGrowth.clear();
+                return out;
+            },
+        };
+    }
+    // Only eid columns need an explicit fill (their zero is a valid entity); everything else
+    // relies on the runtime zero-init of the grown region.
+    #fillGrownTail(view, layout, oldCapacity, newCapacity) {
+        if (layout.fillOnInit === 0)
+            return;
+        // Upper bound clamped to the view's real length: the grown capacity is derived from the backing
+        // (the doubling protocol over-allocates), so the eid -1 fill must cover the whole tail.
+        const end = Math.min(newCapacity * layout.stride, view.length);
+        fillRange(view, oldCapacity * layout.stride, end, layout.fillOnInit);
+    }
+    registerAccessor(key, accessor) {
+        let set = this.#accessors.get(key);
+        if (set === undefined) {
+            set = new Set();
+            this.#accessors.set(key, set);
+        }
+        set.add(accessor);
+    }
+    unregisterAccessor(key, accessor) {
+        this.#accessors.get(key)?.delete(accessor);
+    }
+    get(key) {
+        return this.#registry.get(key);
+    }
+    // The worker-relevant SAB handles, posted once at worker startup.
+    exportSharedHandles() {
+        const columns = [];
+        const regions = [];
+        for (const entry of this.#registry.values()) {
+            if (!(isSharedBacking(entry.backing)))
+                continue;
+            if ('layout' in entry) {
+                columns.push({ key: entry.key, backing: entry.backing, layout: entry.layout });
+            }
+            else {
+                const element = this.#regionElement.get(entry.key);
+                if (element !== undefined)
+                    regions.push({ key: entry.key, backing: entry.backing, element });
+            }
+        }
+        return { columns, regions };
+    }
+}
+// Zero-copy SAB vs copy snapshot.
+export function sharedBacking(col) {
+    return isSharedBacking(col.backing) ? col.backing : null;
+}
+export function snapshotInto(col, count, out, outOffset) {
+    const elements = count * col.layout.stride;
+    out.set(col.view.subarray(0, elements), outOffset);
+    return elements;
+}
+export function rowSlice(col, row) {
+    const n = col.layout.stride;
+    return col.view.subarray(row * n, row * n + n);
+}
+export function columnKey(archetypeId, componentTypeId, fieldIndex) {
+    return `${archetypeId}:${componentTypeId}.${fieldIndex}`;
+}
+//# sourceMappingURL=buffers.js.map

package/dist/memory/buffers.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export { allocU32 } from './allocU32.js';
+export type { AllocU32Options, U32Region } from './allocU32.js';
+export { elementCtor, elementBytes, makeColumnLayout, tokenToColumnLayout, fieldToColumnLayout, stringIndexElement, encodeEid, decodeEid, EID_NULL, } from './layout.js';
+export type { ElementKind, TypedArray, ColumnLayout } from './layout.js';
+export { Buffers, probeCapabilities, selectBacking, sharedBacking, snapshotInto, rowSlice, columnKey, } from './buffers.js';
+export type { Backing, ColumnKey, RegionKey, WorkerMode, BackingStrategy, RuntimeCapabilities, Column, Region, RegionOpts, ViewHolder, BuffersConfig, SharedHandleManifest, ExportedColumnHandle, ExportedRegionHandle, ColumnGrowthNotice, ColumnGrowthLog, } from './buffers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE/D,OAAO,EACL,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAExE,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,cAAc,CAAA"}

package/dist/memory/index.js

@@ -0,0 +1,4 @@
+export { allocU32 } from './allocU32.js';
+export { elementCtor, elementBytes, makeColumnLayout, tokenToColumnLayout, fieldToColumnLayout, stringIndexElement, encodeEid, decodeEid, EID_NULL, } from './layout.js';
+export { Buffers, probeCapabilities, selectBacking, sharedBacking, snapshotInto, rowSlice, columnKey, } from './buffers.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAA"}