@oasys/oecs 0.5.4 → 0.6.0

package/dist/primitives.js

@@ -1,5 +1,4 @@
-import { B as h, a as o, b as l, d as p, e as _, c as d, G as b, g as u, h as w, f as G } from "./typed_arrays-DIVwVy5_.js";
-import { B as y, S as A, t as S } from "./topological_sort-DK6EjpWa.js";
+import { i as l, B as _, a as d, b as o, d as p, e as u, c as g, G as y, g as K, h as b, f as c, t as f } from "./topological_sort-Cc_yXqPT.js";
 class a {
   _dense = [];
   _sparse = [];
@@ -9,16 +8,16 @@ class a {
   get values() {
     return this._dense;
   }
-  has(e) {
-    return this._dense[this._sparse[e]] === e;
+  has(s) {
+    return this._dense[this._sparse[s]] === s;
   }
-  add(e) {
-    this.has(e) || (this._sparse[e] = this._dense.length, this._dense.push(e));
+  add(s) {
+    this.has(s) || (this._sparse[s] = this._dense.length, this._dense.push(s));
   }
-  delete(e) {
-    if (!this.has(e)) return !1;
-    const s = this._sparse[e], r = this._dense[this._dense.length - 1];
-    return this._dense[s] = r, this._sparse[r] = s, this._dense.pop(), !0;
+  delete(s) {
+    if (!this.has(s)) return !1;
+    const e = this._sparse[s], t = this._dense[this._dense.length - 1];
+    return this._dense[e] = t, this._sparse[t] = e, this._dense.pop(), !0;
   }
   clear() {
     this._dense.length = 0, this._sparse.length = 0;
@@ -27,19 +26,64 @@ class a {
     return this._dense[Symbol.iterator]();
   }
 }
+class n {
+  _denseKeys = [];
+  _denseVals = [];
+  _sparse = [];
+  get size() {
+    return this._denseKeys.length;
+  }
+  get keys() {
+    return this._denseKeys;
+  }
+  has(s) {
+    return this._denseKeys[this._sparse[s]] === s;
+  }
+  get(s) {
+    return this.has(s) ? this._denseVals[this._sparse[s]] : void 0;
+  }
+  set(s, e) {
+    if (this.has(s)) {
+      this._denseVals[this._sparse[s]] = e;
+      return;
+    }
+    this._sparse[s] = this._denseKeys.length, this._denseKeys.push(s), this._denseVals.push(e);
+  }
+  delete(s) {
+    if (!this.has(s)) return !1;
+    const e = this._sparse[s], t = this._denseKeys[this._denseKeys.length - 1];
+    return this._denseKeys[e] = t, this._denseVals[e] = this._denseVals[this._denseVals.length - 1], this._sparse[t] = e, this._denseKeys.pop(), this._denseVals.pop(), !0;
+  }
+  clear() {
+    this._denseKeys.length = 0, this._denseVals.length = 0, this._sparse.length = 0;
+  }
+  forEach(s) {
+    for (let e = 0; e < this._denseKeys.length; e++)
+      s(this._denseKeys[e], this._denseVals[e]);
+  }
+  [Symbol.iterator]() {
+    let s = 0;
+    const e = this._denseKeys, t = this._denseVals;
+    return {
+      next() {
+        return s < e.length ? { value: [e[s], t[s++]], done: !1 } : { value: void 0, done: !0 };
+      }
+    };
+  }
+}
 export {
-  y as BinaryHeap,
-  h as BitSet,
-  o as GrowableFloat32Array,
-  l as GrowableFloat64Array,
+  l as BinaryHeap,
+  _ as BitSet,
+  d as GrowableFloat32Array,
+  o as GrowableFloat64Array,
   p as GrowableInt16Array,
-  _ as GrowableInt32Array,
-  d as GrowableInt8Array,
-  b as GrowableTypedArray,
-  u as GrowableUint16Array,
-  w as GrowableUint32Array,
-  G as GrowableUint8Array,
-  A as SparseMap,
+  u as GrowableInt32Array,
+  g as GrowableInt8Array,
+  y as GrowableTypedArray,
+  K as GrowableUint16Array,
+  b as GrowableUint32Array,
+  c as GrowableUint8Array,
+  n as SparseMap,
   a as SparseSet,
-  S as topologicalSort
+  f as topologicalSort
 };

package/dist/shared-BKl12xF1.js

@@ -0,0 +1,132 @@
+class c extends Error {
+  constructor(t, e, o, a) {
+    super(t, a), this.requestedBytes = e, this.capBytes = o, this.name = "StoreCapExceededError";
+  }
+}
+class u extends Error {
+  constructor() {
+    super(
+      'SharedArrayBuffer is not available in this runtime. The chosen world backing is SAB-based and cannot start without it. In browsers this requires cross-origin isolation: serve the page with `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp` (or `credentialless`). Alternatively choose the pure-TS heap profile (`memory: { backing: "heap" }`), which is backed by a plain ArrayBuffer and needs no SAB and no COOP+COEP. In Bun or Node SAB is available unconditionally. If you see this there, the runtime is older than expected, or the global was shadowed.'
+    ), this.name = "SabUnavailableError";
+  }
+}
+const d = (r) => {
+  if (typeof SharedArrayBuffer > "u") throw new u();
+  return new SharedArrayBuffer(r);
+}, h = 64 * 1024;
+function f(r, t, e, o = !1) {
+  if (e <= 0 || !Number.isInteger(e))
+    throw new Error(`${r}: maxBytes must be a positive integer (got ${e})`);
+  let a = null;
+  const i = (n) => {
+    if (n > e)
+      throw new c(
+        `${r}: requested ${n} bytes exceeds the by-design maxBytes cap of ${e}. This is a hard ceiling with no grow-beyond-cap fallback. Reaching it signals runaway entity or column growth upstream, so diagnose that rather than raising the cap blindly.`,
+        n,
+        e
+      );
+    return a === null ? (a = t.create(n, e), a) : (n > a.byteLength && t.growTo(a, n), a);
+  };
+  return Object.defineProperty(i, "isInPlace", { value: !0, enumerable: !0 }), Object.defineProperty(i, "reservedAtCap", { value: o, enumerable: !0 }), i;
+}
+function w(r = 256 * 1024 * 1024) {
+  if (typeof SharedArrayBuffer > "u") throw new u();
+  return f(
+    "growableSabAllocator",
+    {
+      create: (t, e) => {
+        const o = SharedArrayBuffer;
+        return new o(t, { maxByteLength: e });
+      },
+      // boundary: SharedArrayBuffer.grow is in the spec but not in all
+      // lib types. Widen here so the rest of the layer doesn't need to.
+      growTo: (t, e) => t.grow(e)
+    },
+    r
+  );
+}
+function b(r = 256 * 1024 * 1024) {
+  return f(
+    "heapArrayBufferAllocator",
+    {
+      // Reserve the whole cap as one fixed buffer. `byteLength` (the current
+      // need) is ignored: the buffer never resizes, so it must be born at the
+      // ceiling. Lazy page-faulting keeps RSS proportional to real use.
+      create: (t, e) => new ArrayBuffer(e),
+      // Unreachable: the buffer is created at `maxByteLength`, so
+      // `createSingleBufferAllocator`'s `bytes > buffer.byteLength` guard never fires
+      // (a byte count past the cap throws first). A fixed `ArrayBuffer` has no
+      // `.resize()`. Assert loudly rather than attempt one, in case the guard
+      // logic ever changes.
+      growTo: () => {
+        throw new Error(
+          "heapArrayBufferAllocator: the heap buffer is fixed at maxBytes and must never grow. Relocate columns within the buffer instead of resizing it."
+        );
+      }
+    },
+    r,
+    !0
+  );
+}
+function g(r = 256 * 1024 * 1024) {
+  if (typeof SharedArrayBuffer > "u") throw new u();
+  return f(
+    "fixedSabAllocator",
+    {
+      // Reserve the whole cap as one fixed buffer, as the heap allocator
+      // does. `byteLength` (the current need) is ignored: the buffer never
+      // grows, so it must be born at the ceiling.
+      create: (t, e) => new SharedArrayBuffer(e),
+      // Unreachable for the same reason as the heap allocator's: the buffer
+      // is created at the cap, and a request past the cap throws first.
+      growTo: () => {
+        throw new Error(
+          "fixedSabAllocator: the buffer is fixed at maxBytes and must never grow. Relocate columns within the buffer instead of resizing it."
+        );
+      }
+    },
+    r,
+    !0
+  );
+}
+function A(r) {
+  if (!(r.buffer instanceof SharedArrayBuffer))
+    throw new Error(
+      "wasmMemoryAllocator: WebAssembly.Memory must be constructed with `shared: true` so its buffer is a SharedArrayBuffer"
+    );
+  const t = () => r.buffer, e = (o) => {
+    const a = r.buffer.byteLength;
+    if (o <= a)
+      return t();
+    const i = Math.ceil((o - a) / h), n = (s) => (
+      // The JS API doesn't expose the Memory's `maximum`, so the cap is
+      // reported as unknowable (`null`), the caller declared it at
+      // `new WebAssembly.Memory({ maximum })` time.
+      new c(
+        `wasmMemoryAllocator: memory.grow(${i}) failed (current=${a} bytes, requested=${o} bytes, maximum may be reached)`,
+        o,
+        null,
+        { cause: s }
+      )
+    );
+    let l;
+    try {
+      l = r.grow(i);
+    } catch (s) {
+      throw n(s);
+    }
+    if (l === -1)
+      throw n();
+    return t();
+  };
+  return Object.defineProperty(e, "isInPlace", { value: !0, enumerable: !0 }), e;
+}
+export {
+  d as D,
+  c as S,
+  u as a,
+  g as f,
+  w as g,
+  b as h,
+  A as w
+};

package/dist/shared-Dk-pACZT.cjs

@@ -0,0 +1 @@
+"use strict";class u extends Error{constructor(t,e,o,a){super(t,a),this.requestedBytes=e,this.capBytes=o,this.name="StoreCapExceededError"}}class l extends Error{constructor(){super('SharedArrayBuffer is not available in this runtime. The chosen world backing is SAB-based and cannot start without it. In browsers this requires cross-origin isolation: serve the page with `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp` (or `credentialless`). Alternatively choose the pure-TS heap profile (`memory: { backing: "heap" }`), which is backed by a plain ArrayBuffer and needs no SAB and no COOP+COEP. In Bun or Node SAB is available unconditionally. If you see this there, the runtime is older than expected, or the global was shadowed.'),this.name="SabUnavailableError"}}const h=r=>{if(typeof SharedArrayBuffer>"u")throw new l;return new SharedArrayBuffer(r)},d=64*1024;function f(r,t,e,o=!1){if(e<=0||!Number.isInteger(e))throw new Error(`${r}: maxBytes must be a positive integer (got ${e})`);let a=null;const i=n=>{if(n>e)throw new u(`${r}: requested ${n} bytes exceeds the by-design maxBytes cap of ${e}. This is a hard ceiling with no grow-beyond-cap fallback. Reaching it signals runaway entity or column growth upstream, so diagnose that rather than raising the cap blindly.`,n,e);return a===null?(a=t.create(n,e),a):(n>a.byteLength&&t.growTo(a,n),a)};return Object.defineProperty(i,"isInPlace",{value:!0,enumerable:!0}),Object.defineProperty(i,"reservedAtCap",{value:o,enumerable:!0}),i}function w(r=256*1024*1024){if(typeof SharedArrayBuffer>"u")throw new l;return f("growableSabAllocator",{create:(t,e)=>{const o=SharedArrayBuffer;return new o(t,{maxByteLength:e})},growTo:(t,e)=>t.grow(e)},r)}function b(r=256*1024*1024){return f("heapArrayBufferAllocator",{create:(t,e)=>new ArrayBuffer(e),growTo:()=>{throw new Error("heapArrayBufferAllocator: the heap buffer is fixed at maxBytes and must never grow. Relocate columns within the buffer instead of resizing it.")}},r,!0)}function A(r=256*1024*1024){if(typeof SharedArrayBuffer>"u")throw new l;return f("fixedSabAllocator",{create:(t,e)=>new SharedArrayBuffer(e),growTo:()=>{throw new Error("fixedSabAllocator: the buffer is fixed at maxBytes and must never grow. Relocate columns within the buffer instead of resizing it.")}},r,!0)}function g(r){if(!(r.buffer instanceof SharedArrayBuffer))throw new Error("wasmMemoryAllocator: WebAssembly.Memory must be constructed with `shared: true` so its buffer is a SharedArrayBuffer");const t=()=>r.buffer,e=o=>{const a=r.buffer.byteLength;if(o<=a)return t();const i=Math.ceil((o-a)/d),n=s=>new u(`wasmMemoryAllocator: memory.grow(${i}) failed (current=${a} bytes, requested=${o} bytes, maximum may be reached)`,o,null,{cause:s});let c;try{c=r.grow(i)}catch(s){throw n(s)}if(c===-1)throw n();return t()};return Object.defineProperty(e,"isInPlace",{value:!0,enumerable:!0}),e}exports.DEFAULT_SAB_ALLOCATOR=h;exports.SabUnavailableError=l;exports.StoreCapExceededError=u;exports.fixedSabAllocator=A;exports.growableSabAllocator=w;exports.heapArrayBufferAllocator=b;exports.wasmMemoryAllocator=g;

package/dist/shared.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./shared-DU78k0pU.cjs");exports.DEFAULT_SAB_ALLOCATOR=a.DEFAULT_SAB_ALLOCATOR;exports.SabUnavailableError=a.SabUnavailableError;exports.growableSabAllocator=a.growableSabAllocator;exports.wasmMemoryAllocator=a.wasmMemoryAllocator;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./shared-Dk-pACZT.cjs");exports.DEFAULT_SAB_ALLOCATOR=a.DEFAULT_SAB_ALLOCATOR;exports.SabUnavailableError=a.SabUnavailableError;exports.fixedSabAllocator=a.fixedSabAllocator;exports.growableSabAllocator=a.growableSabAllocator;exports.wasmMemoryAllocator=a.wasmMemoryAllocator;

package/dist/shared.d.cts

@@ -1,22 +1,22 @@
 /**
- * `@oasys/oecs/shared` — the opt-in SharedArrayBuffer / WASM profile.
+ * `@oasys/oecs/shared`, the opt-in SharedArrayBuffer and WASM profile.
  *
  * The default `@oasys/oecs` profile runs the column store over a plain
  * fixed `ArrayBuffer` (no cross-origin isolation). This entry surfaces the
  * `SharedArrayBuffer`-backed allocators for worlds that opt into worker offload
- * or a WASM compute backend — construct with `new ECS({ memory: { shared: {} } })`,
- * or pass one of these allocators through `memory: { allocator }`.
+ * or a WASM compute backend, construct with `new ECS({ memory: { backing: "shared" } })`,
+ * or pass one of these allocators through `memory: { backing: { allocator } }`.
  *
- * **Requires cross-origin isolation (COOP/COEP) in browsers** — that's the
+ * **Requires cross-origin isolation (COOP and COEP) in browsers**, that's the
  * whole reason it's a separate, opt-in profile.
  *
- * The WASM compute backend itself is NOT bundled here: oecs ships the
+ * The WASM compute backend itself is not bundled here: oecs ships the
  * `ComputeBackend` *seam* (`@oasys/oecs` → `attachBackend`) plus the
  * cross-thread ring transport (`HostCommandDispatcher`). The worker entrypoint
  * and the compiled WASM module are the consumer's to provide.
  *
  * @module
  */
-export { growableSabAllocator, wasmMemoryAllocator, DEFAULT_SAB_ALLOCATOR, SabUnavailableError } from './core/store/index.cjs';
-export type { SharedMemoryArm } from './core/ecs/ecs_memory.cjs';
+export { growableSabAllocator, fixedSabAllocator, wasmMemoryAllocator, DEFAULT_SAB_ALLOCATOR, SabUnavailableError } from './core/store/index.cjs';
+export type { BufferAllocator, InPlaceBufferAllocator } from './core/store/index.cjs';
 //# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts

@@ -1,22 +1,22 @@
 /**
- * `@oasys/oecs/shared` — the opt-in SharedArrayBuffer / WASM profile.
+ * `@oasys/oecs/shared`, the opt-in SharedArrayBuffer and WASM profile.
  *
  * The default `@oasys/oecs` profile runs the column store over a plain
  * fixed `ArrayBuffer` (no cross-origin isolation). This entry surfaces the
  * `SharedArrayBuffer`-backed allocators for worlds that opt into worker offload
- * or a WASM compute backend — construct with `new ECS({ memory: { shared: {} } })`,
- * or pass one of these allocators through `memory: { allocator }`.
+ * or a WASM compute backend, construct with `new ECS({ memory: { backing: "shared" } })`,
+ * or pass one of these allocators through `memory: { backing: { allocator } }`.
  *
- * **Requires cross-origin isolation (COOP/COEP) in browsers** — that's the
+ * **Requires cross-origin isolation (COOP and COEP) in browsers**, that's the
  * whole reason it's a separate, opt-in profile.
  *
- * The WASM compute backend itself is NOT bundled here: oecs ships the
+ * The WASM compute backend itself is not bundled here: oecs ships the
  * `ComputeBackend` *seam* (`@oasys/oecs` → `attachBackend`) plus the
  * cross-thread ring transport (`HostCommandDispatcher`). The worker entrypoint
  * and the compiled WASM module are the consumer's to provide.
  *
  * @module
  */
-export { growableSabAllocator, wasmMemoryAllocator, DEFAULT_SAB_ALLOCATOR, SabUnavailableError } from './core/store/index.js';
-export type { SharedMemoryArm } from './core/ecs/ecs_memory.js';
+export { growableSabAllocator, fixedSabAllocator, wasmMemoryAllocator, DEFAULT_SAB_ALLOCATOR, SabUnavailableError } from './core/store/index.js';
+export type { BufferAllocator, InPlaceBufferAllocator } from './core/store/index.js';
 //# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACN,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared.development.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./shared-DU78k0pU.cjs");exports.DEFAULT_SAB_ALLOCATOR=a.DEFAULT_SAB_ALLOCATOR;exports.SabUnavailableError=a.SabUnavailableError;exports.growableSabAllocator=a.growableSabAllocator;exports.wasmMemoryAllocator=a.wasmMemoryAllocator;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./shared-Dk-pACZT.cjs");exports.DEFAULT_SAB_ALLOCATOR=a.DEFAULT_SAB_ALLOCATOR;exports.SabUnavailableError=a.SabUnavailableError;exports.fixedSabAllocator=a.fixedSabAllocator;exports.growableSabAllocator=a.growableSabAllocator;exports.wasmMemoryAllocator=a.wasmMemoryAllocator;

package/dist/shared.development.js

@@ -1,7 +1,8 @@
-import { D as r, a as l, g as A, w as s } from "./shared-B4v0L1cw.js";
+import { D as r, a as l, f as A, g as s, w as b } from "./shared-BKl12xF1.js";
 export {
   r as DEFAULT_SAB_ALLOCATOR,
   l as SabUnavailableError,
-  A as growableSabAllocator,
-  s as wasmMemoryAllocator
+  A as fixedSabAllocator,
+  s as growableSabAllocator,
+  b as wasmMemoryAllocator
 };

package/dist/shared.js

@@ -1,7 +1,8 @@
-import { D as r, a as l, g as A, w as s } from "./shared-B4v0L1cw.js";
+import { D as r, a as l, f as A, g as s, w as b } from "./shared-BKl12xF1.js";
 export {
   r as DEFAULT_SAB_ALLOCATOR,
   l as SabUnavailableError,
-  A as growableSabAllocator,
-  s as wasmMemoryAllocator
+  A as fixedSabAllocator,
+  s as growableSabAllocator,
+  b as wasmMemoryAllocator
 };