@oasys/oecs 0.5.3 → 0.6.0

package/dist/core/store/extend.d.ts

@@ -2,23 +2,29 @@ import { ArchetypeSpec, ColumnStore } from './column_store.js';
 import { BufferAllocator } from './allocator.js';
 import { ArchetypeGrowSpec } from './layout_ops.js';
 export interface ExtendPlan {
-    /** Archetypes to append. Each `archetype_id` MUST be absent from
-     * `old.archetypes`; collisions throw `StoreExtendError`. */
+    /** Archetypes to append. Each `archetype_id` must be absent from
+     * `old.archetypes`. Collisions throw `StoreExtendError`. */
     readonly newArchetypes: readonly ArchetypeSpec[];
     /** Per-existing-archetype live row counts. Same shape as
      * `GrowPlan.archetypes` so callers can reuse plan-building helpers.
-     * Omitted or `0` ⇒ no rows to copy (the archetype is empty). */
-    readonly existing?: readonly ArchetypeGrowSpec[];
+     * Omitted or `0` ⇒ no rows to copy (the archetype is empty).
+     *
+     * Only the realloc path reads it: the in-place path moves no rows. A
+     * caller that must walk every archetype to build the list can pass a
+     * function instead, and the list is then built only when the realloc path
+     * runs. The in-place path is the common one, and a list built for every
+     * extend made the cost of the N-th archetype grow with N. */
+    readonly existing?: readonly ArchetypeGrowSpec[] | (() => readonly ArchetypeGrowSpec[]);
 }
 export interface ExtendResult {
     readonly store: ColumnStore;
     readonly oldViewStamp: number;
     readonly newViewStamp: number;
-    /** True when the in-place fast path (#237 Option A) was taken: the SAB
+    /** True when the in-place fast path was taken: the SAB
      * instance is reused, existing column TypedArray views are unchanged,
      * and callers may skip `refreshViews` on every pre-existing
      * Archetype. False when the slow path ran (fresh SAB or wasm-memory
-     * grow with detached views); callers MUST refresh every Archetype's
+     * grow with detached views). A caller must then refresh every Archetype's
      * SAB-backed columns from the returned `store` before reading them. */
     readonly viewsPreserved: boolean;
 }
@@ -28,12 +34,12 @@ export declare class StoreExtendError extends Error {
 /** Allocate a new SAB sized for `old` + `plan.newArchetypes`, copy
  * existing rows, bump `view_stamp`.
  *
- * `allocator` (PR 3D / #234): pluggable buffer source forwarded into
+ * `allocator`: pluggable buffer source forwarded into
  * `createColumnStore`. When the allocator is `wasmMemoryAllocator`,
  * `memory.grow` may detach `old`'s typed-array views before the copy
- * runs — so live rows are snapshotted into heap `Uint8Array`s BEFORE the
+ * runs, so live rows are snapshotted into heap `Uint8Array`s before the
  * allocator call and restored into the new views afterwards. The cost
- * is one extra heap allocation per live archetype-column; negligible
+ * is one extra heap allocation per live archetype-column. Negligible
  * compared to the SAB walk itself. */
 export declare function extendColumnStore(old: ColumnStore, plan: ExtendPlan, allocator?: BufferAllocator): ExtendResult;
 //# sourceMappingURL=extend.d.ts.map

package/dist/core/store/extend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../src/core/store/extend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAEN,KAAK,aAAa,EAElB,KAAK,WAAW,EAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,OAAO,EAKN,KAAK,iBAAiB,EAEtB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,UAAU;IAC1B;gEAC4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD;;oEAEgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;2EAKuE;IACvE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACjC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;sCASsC;AACtC,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,eAAe,GACzB,YAAY,CAoId"}
+{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../src/core/store/extend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAEN,KAAK,aAAa,EAElB,KAAK,WAAW,EAIhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAKN,KAAK,iBAAiB,EAEtB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,UAAU;IAC1B;gEAC4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD;;;;;;;;iEAQ6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,CAAC,MAAM,SAAS,iBAAiB,EAAE,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;2EAKuE;IACvE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACjC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;sCASsC;AACtC,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,eAAe,GACzB,YAAY,CAqId"}

package/dist/core/store/grow.d.cts

@@ -11,7 +11,7 @@ export interface GrowResult {
     readonly store: ColumnStore;
     readonly oldViewStamp: number;
     readonly newViewStamp: number;
-    /** True when the in-place fast path ran: every archetype EXCEPT those in
+    /** True when the in-place fast path ran: every archetype except those in
      * `grownArchetypeIds` kept its column views, so the caller only needs to
      * `refreshViews` the grown ones. False on the realloc path, where the
      * whole store moved and every view must be refreshed. */
@@ -27,8 +27,8 @@ export declare class StoreGrowError extends Error {
  * `view_stamp`. With the default allocator the old SAB is untouched and
  * callers may continue reading from it until they finish swapping in
  * the new views. With a `wasmMemoryAllocator`, `old`'s typed-array
- * views may be detached as soon as `createColumnStore` returns — live
+ * views may be detached as soon as `createColumnStore` returns, live
  * data is snapshotted before the allocator call to make both code paths
- * behave identically from the caller's perspective. (PR 3D / #234) */
+ * behave identically from the caller's perspective. */
 export declare function growColumnStore(old: ColumnStore, plan: GrowPlan, allocator?: BufferAllocator): GrowResult;
 //# sourceMappingURL=grow.d.ts.map

package/dist/core/store/grow.d.ts

@@ -11,7 +11,7 @@ export interface GrowResult {
     readonly store: ColumnStore;
     readonly oldViewStamp: number;
     readonly newViewStamp: number;
-    /** True when the in-place fast path ran: every archetype EXCEPT those in
+    /** True when the in-place fast path ran: every archetype except those in
      * `grownArchetypeIds` kept its column views, so the caller only needs to
      * `refreshViews` the grown ones. False on the realloc path, where the
      * whole store moved and every view must be refreshed. */
@@ -27,8 +27,8 @@ export declare class StoreGrowError extends Error {
  * `view_stamp`. With the default allocator the old SAB is untouched and
  * callers may continue reading from it until they finish swapping in
  * the new views. With a `wasmMemoryAllocator`, `old`'s typed-array
- * views may be detached as soon as `createColumnStore` returns — live
+ * views may be detached as soon as `createColumnStore` returns, live
  * data is snapshotted before the allocator call to make both code paths
- * behave identically from the caller's perspective. (PR 3D / #234) */
+ * behave identically from the caller's perspective. */
 export declare function growColumnStore(old: ColumnStore, plan: GrowPlan, allocator?: BufferAllocator): GrowResult;
 //# sourceMappingURL=grow.d.ts.map

package/dist/core/store/grow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grow.d.ts","sourceRoot":"","sources":["../../../src/core/store/grow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AASH,OAAO,EAIN,KAAK,WAAW,EAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAKN,KAAK,iBAAiB,EAEtB,MAAM,cAAc,CAAC;AAMtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED;mEACmE;AACnE,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;6DAGyD;IACzD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;2BACuB;IACvB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AA4JD,qBAAa,cAAe,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;sEAMsE;AACtE,wBAAgB,eAAe,CAC9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,eAAe,GACzB,UAAU,CAmGZ"}
+{"version":3,"file":"grow.d.ts","sourceRoot":"","sources":["../../../src/core/store/grow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AASH,OAAO,EAIN,KAAK,WAAW,EAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAKN,KAAK,iBAAiB,EAEtB,MAAM,cAAc,CAAC;AAMtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED;mEACmE;AACnE,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;6DAGyD;IACzD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;2BACuB;IACvB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AA+JD,qBAAa,cAAe,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;uDAMuD;AACvD,wBAAgB,eAAe,CAC9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,eAAe,GACzB,UAAU,CAmGZ"}

package/dist/core/store/header.d.cts

@@ -1,64 +1,68 @@
-import { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS } from './vendored_abi/abi.cjs';
-export { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS };
+import { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS } from './vendored_abi/abi.cjs';
+export { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS };
 export interface StoreHeader {
-    /** Magic value `STORE_MAGIC`; used to detect a stale or foreign buffer
+    /** Magic value `STORE_MAGIC`. Used to detect a stale or foreign buffer
      * before any other field is trusted. */
     readonly magic: number;
-    /** ABI version; mismatch means the WASM and TS disagree on layout and
+    /** ABI version. Mismatch means the WASM and TS disagree on layout and
      * the SAB must not be used. */
     readonly simAbiVersion: number;
-    /** Monotonic; incremented every time the host reallocates the SAB.
-     * Cached TypedArray views become stale on bump. (#171 §8.1) */
+    /** Monotonic. Incremented every time the host reallocates the SAB.
+     * Cached TypedArray views become stale on bump. */
     readonly viewStamp: number;
-    /** Total SAB size in bytes. */
+    /** Store span in bytes, measured from the store base. The store writes
+     * only inside `[storeBase, storeBase + capacity)`. */
     readonly capacity: number;
     /** Number of archetype regions described by the layout descriptor. */
     readonly archetypeCount: number;
-    /** Byte offset into the SAB where the layout descriptor region starts. */
+    /** Byte offset of the layout descriptor region, measured from the store
+     * base. */
     readonly layoutDescriptorOff: number;
-    /** Byte offset of the WASM→TS command ring header. (#171 §7.5) */
+    /** Byte offset of the WASM→TS command ring header. */
     readonly commandRingOff: number;
-    /** Byte offset of the TS→WASM action ring header. (#171 §7.5, Phase 5) */
+    /** Byte offset of the TS→WASM action ring header. */
     readonly actionRingOff: number;
     /** Byte offset of the entity-index region (entityId → archetype_id,
-     * row, generation lookup). 0 means absent — fixtures and bare-SAB
+     * row, generation lookup). 0 means absent, fixtures and bare-SAB
      * tests that don't need the index see the v1 layout (the engine's
-     * `Store` always allocates one). (#245 / Phase 4 PR 4B) */
+     * `Store` always allocates one). */
     readonly entityIndexOff: number;
     /** Byte offset of the event ring region (ECS signal payloads shared
-     * with the Zig sim). 0 means absent. (#247 / Phase 4 PR 4C) */
+     * with a compute backend). 0 means absent. */
     readonly eventRingOff: number;
-    /** Byte offset of the region-table directory — a `RegionTableEntry[]`
+    /** Byte offset of the region-table directory, a `RegionTableEntry[]`
      * (`(region_id, byte_offset, byte_length)` triples) holding one entry
      * per consumer-declared region. 0 means no consumer regions were
-     * declared. The engine treats `region_id` as opaque; a consumer resolves
-     * its region with `findRegionOffset(view, header, id)` (TS) /
-     * `abi.find_region(header_addr, id)` (Zig). Replaces the five game-named
-     * offset fields (`terrain_off`/`spatial_grid_off`/… ) the SAB header
-     * used to hard-code. (#623 — de-game the SAB substrate; ADR-0018.) */
+     * declared. The engine treats `region_id` as opaque. A consumer resolves
+     * its region with `findRegionOffset(view, id)` in TS, or with the
+     * matching module-side lookup. Replaces the five consumer-named
+     * offset fields the SAB header used to hard-code. This de-games the SAB
+     * substrate. */
     readonly regionTableOff: number;
-    /** Number of `RegionTableEntry` records at `region_table_off`. (#623) */
+    /** Number of `RegionTableEntry` records at `region_table_off`. */
     readonly regionTableCount: number;
-    /** Byte offset of the sim-bindings region — an opaque block of `u16`
-     * `(component_id, field_id)` IDs (layout owned by the game, in
-     * `@internal/sim`'s `sim_bindings.ts` / `bindings.zig`). The host writes it
-     * once per layout via `write_sim_bindings`; the Zig per-system exports
-     * (`tick_cooldown_ready` / `tick_movement_tick` / `tick_faith_production`
-     * and the batched `tick_all`) read their IDs from here instead of taking
-     * them as call args. Present only when the consumer opts into a WASM backend
-     * by passing `bindingsRegionBytes` to `createColumnStore`; 0 = absent (a
-     * pure-TS game pays nothing for this region). The size is a runtime input,
-     * not an engine ABI constant, since #625. (v5 / "SAB-is-the-interface".) */
+    /** Byte offset of the sim-bindings region, an opaque block of `u16`
+     * `(component_id, field_id)` ids. The consumer owns the layout, and the host
+     * writes the block once per layout. A WASM per-system export reads its ids
+     * from here instead of taking them as call args. Present only when the
+     * consumer opts into a WASM backend by passing `bindingsRegionBytes` to
+     * `createColumnStore`. 0 = absent, so a pure-TS world pays nothing for this
+     * region. The size is a runtime input, not an engine ABI constant. */
     readonly bindingsOff: number;
 }
+/** Write the header at offset 0 of `view`. The caller passes a `DataView`
+ * whose start is the store base, so every offset the header carries stays
+ * relative to that base. */
 export declare function writeStoreHeader(view: DataView, h: StoreHeader): void;
+/** Read the header at offset 0 of `view`. Pass a `DataView` whose start is the
+ * store base. */
 export declare function readStoreHeader(view: DataView): StoreHeader;
 /** Increment `view_stamp` in place after a host-side SAB reallocation. The
  * monotonic counter is the trigger for cached-view invalidation on the TS
- * side and for re-pointing in WASM. (#171 §8.1) */
+ * side and for re-pointing in WASM. */
 export declare function bumpViewStamp(view: DataView): number;
-/** True iff the buffer's first four bytes are `STORE_MAGIC` AND the ABI
+/** True iff the buffer's first four bytes are `STORE_MAGIC` and the ABI
  * version matches the current build. Used by both TS and WASM as a
  * pre-flight before treating any other field as meaningful. */
-export declare function isValidSab(view: DataView): boolean;
+export declare function isValidStoreHeader(view: DataView): boolean;
 //# sourceMappingURL=header.d.ts.map

package/dist/core/store/header.d.ts

@@ -1,64 +1,68 @@
-import { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS } from './vendored_abi/abi.js';
-export { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS };
+import { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS } from './vendored_abi/abi.js';
+export { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS };
 export interface StoreHeader {
-    /** Magic value `STORE_MAGIC`; used to detect a stale or foreign buffer
+    /** Magic value `STORE_MAGIC`. Used to detect a stale or foreign buffer
      * before any other field is trusted. */
     readonly magic: number;
-    /** ABI version; mismatch means the WASM and TS disagree on layout and
+    /** ABI version. Mismatch means the WASM and TS disagree on layout and
      * the SAB must not be used. */
     readonly simAbiVersion: number;
-    /** Monotonic; incremented every time the host reallocates the SAB.
-     * Cached TypedArray views become stale on bump. (#171 §8.1) */
+    /** Monotonic. Incremented every time the host reallocates the SAB.
+     * Cached TypedArray views become stale on bump. */
     readonly viewStamp: number;
-    /** Total SAB size in bytes. */
+    /** Store span in bytes, measured from the store base. The store writes
+     * only inside `[storeBase, storeBase + capacity)`. */
     readonly capacity: number;
     /** Number of archetype regions described by the layout descriptor. */
     readonly archetypeCount: number;
-    /** Byte offset into the SAB where the layout descriptor region starts. */
+    /** Byte offset of the layout descriptor region, measured from the store
+     * base. */
     readonly layoutDescriptorOff: number;
-    /** Byte offset of the WASM→TS command ring header. (#171 §7.5) */
+    /** Byte offset of the WASM→TS command ring header. */
     readonly commandRingOff: number;
-    /** Byte offset of the TS→WASM action ring header. (#171 §7.5, Phase 5) */
+    /** Byte offset of the TS→WASM action ring header. */
     readonly actionRingOff: number;
     /** Byte offset of the entity-index region (entityId → archetype_id,
-     * row, generation lookup). 0 means absent — fixtures and bare-SAB
+     * row, generation lookup). 0 means absent, fixtures and bare-SAB
      * tests that don't need the index see the v1 layout (the engine's
-     * `Store` always allocates one). (#245 / Phase 4 PR 4B) */
+     * `Store` always allocates one). */
     readonly entityIndexOff: number;
     /** Byte offset of the event ring region (ECS signal payloads shared
-     * with the Zig sim). 0 means absent. (#247 / Phase 4 PR 4C) */
+     * with a compute backend). 0 means absent. */
     readonly eventRingOff: number;
-    /** Byte offset of the region-table directory — a `RegionTableEntry[]`
+    /** Byte offset of the region-table directory, a `RegionTableEntry[]`
      * (`(region_id, byte_offset, byte_length)` triples) holding one entry
      * per consumer-declared region. 0 means no consumer regions were
-     * declared. The engine treats `region_id` as opaque; a consumer resolves
-     * its region with `findRegionOffset(view, header, id)` (TS) /
-     * `abi.find_region(header_addr, id)` (Zig). Replaces the five game-named
-     * offset fields (`terrain_off`/`spatial_grid_off`/… ) the SAB header
-     * used to hard-code. (#623 — de-game the SAB substrate; ADR-0018.) */
+     * declared. The engine treats `region_id` as opaque. A consumer resolves
+     * its region with `findRegionOffset(view, id)` in TS, or with the
+     * matching module-side lookup. Replaces the five consumer-named
+     * offset fields the SAB header used to hard-code. This de-games the SAB
+     * substrate. */
     readonly regionTableOff: number;
-    /** Number of `RegionTableEntry` records at `region_table_off`. (#623) */
+    /** Number of `RegionTableEntry` records at `region_table_off`. */
     readonly regionTableCount: number;
-    /** Byte offset of the sim-bindings region — an opaque block of `u16`
-     * `(component_id, field_id)` IDs (layout owned by the game, in
-     * `@internal/sim`'s `sim_bindings.ts` / `bindings.zig`). The host writes it
-     * once per layout via `write_sim_bindings`; the Zig per-system exports
-     * (`tick_cooldown_ready` / `tick_movement_tick` / `tick_faith_production`
-     * and the batched `tick_all`) read their IDs from here instead of taking
-     * them as call args. Present only when the consumer opts into a WASM backend
-     * by passing `bindingsRegionBytes` to `createColumnStore`; 0 = absent (a
-     * pure-TS game pays nothing for this region). The size is a runtime input,
-     * not an engine ABI constant, since #625. (v5 / "SAB-is-the-interface".) */
+    /** Byte offset of the sim-bindings region, an opaque block of `u16`
+     * `(component_id, field_id)` ids. The consumer owns the layout, and the host
+     * writes the block once per layout. A WASM per-system export reads its ids
+     * from here instead of taking them as call args. Present only when the
+     * consumer opts into a WASM backend by passing `bindingsRegionBytes` to
+     * `createColumnStore`. 0 = absent, so a pure-TS world pays nothing for this
+     * region. The size is a runtime input, not an engine ABI constant. */
     readonly bindingsOff: number;
 }
+/** Write the header at offset 0 of `view`. The caller passes a `DataView`
+ * whose start is the store base, so every offset the header carries stays
+ * relative to that base. */
 export declare function writeStoreHeader(view: DataView, h: StoreHeader): void;
+/** Read the header at offset 0 of `view`. Pass a `DataView` whose start is the
+ * store base. */
 export declare function readStoreHeader(view: DataView): StoreHeader;
 /** Increment `view_stamp` in place after a host-side SAB reallocation. The
  * monotonic counter is the trigger for cached-view invalidation on the TS
- * side and for re-pointing in WASM. (#171 §8.1) */
+ * side and for re-pointing in WASM. */
 export declare function bumpViewStamp(view: DataView): number;
-/** True iff the buffer's first four bytes are `STORE_MAGIC` AND the ABI
+/** True iff the buffer's first four bytes are `STORE_MAGIC` and the ABI
  * version matches the current build. Used by both TS and WASM as a
  * pre-flight before treating any other field as meaningful. */
-export declare function isValidSab(view: DataView): boolean;
+export declare function isValidStoreHeader(view: DataView): boolean;
 //# sourceMappingURL=header.d.ts.map

package/dist/core/store/header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/core/store/header.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAoBH,OAAO,EACN,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC3B;4CACwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;mCAC+B;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;mEAC+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;+DAG2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;mEAC+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;;;0EAOsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;;;;;;gFAS4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,CAcrE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAgB3D;AAED;;mDAEmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAIpD;AAED;;+DAE+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAKlD"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/core/store/header.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAmBH,OAAO,EACN,WAAW,EACX,eAAe,EACf,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,WAAW,EACX,eAAe,EACf,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC3B;4CACwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;mCAC+B;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;uDACmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;0DACsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;eACW;IACX,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;wCAGoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;kDAC8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;;;oBAOgB;IAChB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;;;0EAMsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED;;4BAE4B;AAC5B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,CAcrE;AAED;iBACiB;AACjB,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAgB3D;AAED;;uCAEuC;AACvC,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAIpD;AAED;;+DAE+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAK1D"}

package/dist/core/store/index.d.cts

@@ -1,17 +1,17 @@
-export { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS, type StoreHeader, writeStoreHeader, readStoreHeader, bumpViewStamp, isValidSab } from './header.cjs';
-export { type StoreRegionSpec, type RegionTableEntry, type ColumnStoreRegionHandle, RegionRegistryError, regionTableBytes, validateRegionSpecs, writeRegionTableEntry, readRegionTableEntry, writeRegionTable, readRegionTable, readHeaderRegionTable, findRegionOffset, findRegionEntry } from './region_table.cjs';
-export { TYPE_TAG, type TypeTagValue, TYPE_TAG_STRIDE, TYPED_ARRAY_TAG_TO_TYPE_TAG, COLUMN_DESCRIPTOR_BYTES, COLUMN_DESCRIPTOR_OFFSETS, type ColumnDescriptor, writeColumnDescriptor, readColumnDescriptor, ARCHETYPE_DESCRIPTOR_HEADER_BYTES, ARCHETYPE_DESCRIPTOR_OFFSETS, COMPONENT_MASK_WORDS, STORE_DESCRIPTOR_COMPONENT_LIMIT, type ArchetypeDescriptor, archetypeDescriptorBytes, writeArchetypeDescriptor, readArchetypeDescriptor, writeLayoutDescriptorRegion, readLayoutDescriptorRegion, layoutDescriptorRegionBytes } from './descriptor.cjs';
-export { type ColumnSpec, type ArchetypeSpec, type ColumnView, type ArchetypeViews, type ColumnStore, type AnyTypedArray, type CreateColumnStoreOptions, alignUp, buildArchetypeViews, columnKey, createColumnStore, StoreLayoutOverflowError, STORE_MAX_BYTE_OFFSET, COMMAND_RING_DEFAULT_CAPACITY_SLOTS, ENTITY_INDEX_DEFAULT_CAPACITY, EVENT_RING_DEFAULT_CAPACITY_SLOTS } from './column_store.cjs';
-export { EVENT_OP_EMPTY, EVENT_RING_HEADER_BYTES, EVENT_RING_SLOT_BYTES, EVENT_RING_HEADER_OFFSETS, EventRingError, drainEventRing, eventRingBytes, initEventRing, pendingEventCount, popEvent, pushEvent, ringCapacitySlots as eventRingCapacitySlots, ringOverflow as eventRingOverflow, ringReadHead as eventRingReadHead, ringWriteHead as eventRingWriteHead } from './event_ring.cjs';
-export { ENTITY_INDEX_HEADER_BYTES, ENTITY_INDEX_BYTES_PER_SLOT, ENTITY_INDEX_HEADER_OFFSETS, EntityIndexError, buildEntityIndexViews, entityIndexCapacity, entityIndexLength, entityIndexRegionBytes, initEntityIndexRegion, setEntityIndexLength } from './entity_index.cjs';
-export { COMMAND_OP_EMPTY, COMMAND_RING_HEADER_BYTES, COMMAND_RING_SLOT_BYTES, COMMAND_RING_HEADER_OFFSETS, CommandRingError, commandRingBytes, drainCommandRing, initCommandRing, pendingCommandCount, popCommand, pushCommand, ringCapacitySlots, ringOverflow, ringReadHead, ringWriteHead } from './command_ring.cjs';
+export { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS, type StoreHeader, writeStoreHeader, readStoreHeader, bumpViewStamp, isValidStoreHeader } from './header.cjs';
+export { type StoreRegionSpec, type RegionTableEntry, type ColumnStoreRegionHandle, RegionRegistryError, regionTableBytes, assertRegionSpecs, writeRegionTableEntry, readRegionTableEntry, writeRegionTable, readRegionTable, readHeaderRegionTable, findRegionOffset, findRegionEntry } from './region_table.cjs';
+export { TYPE_TAG, type TypeTagValue, TYPE_TAG_STRIDE, TYPED_ARRAY_TAG_TO_TYPE_TAG, COLUMN_DESCRIPTOR_BYTES, COLUMN_DESCRIPTOR_OFFSETS, type ColumnDescriptor, writeColumnDescriptor, readColumnDescriptor, ARCHETYPE_DESCRIPTOR_HEADER_BYTES, LEGACY_ARCHETYPE_DESCRIPTOR_HEADER_BYTES, ARCHETYPE_DESCRIPTOR_OFFSETS, COMPONENT_MASK_WORDS, STORE_DESCRIPTOR_COMPONENT_LIMIT, type ArchetypeDescriptor, archetypeDescriptorBytes, writeArchetypeDescriptor, readArchetypeDescriptor, writeLayoutDescriptorRegion, readLayoutDescriptorRegion, layoutDescriptorRegionBytes } from './descriptor.cjs';
+export { type ColumnSpec, type ArchetypeSpec, type ColumnView, type ArchetypeViews, type ColumnStore, type AnyTypedArray, type CreateColumnStoreOptions, alignUp, createArchetypeViews, columnKey, createColumnStore, StoreLayoutOverflowError, STORE_MAX_BYTE_OFFSET, STORE_BASE_ALIGNMENT, assertStoreBase, COMMAND_RING_DEFAULT_CAPACITY_SLOTS, ENTITY_INDEX_DEFAULT_CAPACITY, EVENT_RING_DEFAULT_CAPACITY_SLOTS } from './column_store.cjs';
+export { EVENT_OP_EMPTY, EVENT_RING_HEADER_BYTES, EVENT_RING_SLOT_BYTES, EVENT_RING_HEADER_OFFSETS, EventRingError, drainEventRing, eventRingBytes, initEventRing, pendingEventCount, popEvent, pushEvent, eventRingCapacitySlots, eventRingOverflow, eventRingReadHead, eventRingWriteHead } from './event_ring.cjs';
+export { ENTITY_INDEX_HEADER_BYTES, ENTITY_INDEX_BYTES_PER_SLOT, ENTITY_INDEX_HEADER_OFFSETS, EntityIndexError, createEntityIndexViews, entityIndexCapacity, entityIndexLength, entityIndexRegionBytes, initEntityIndexRegion, setEntityIndexLength } from './entity_index.cjs';
+export { COMMAND_OP_EMPTY, COMMAND_RING_HEADER_BYTES, COMMAND_RING_SLOT_BYTES, COMMAND_RING_HEADER_OFFSETS, CommandRingError, commandRingBytes, drainCommandRing, initCommandRing, pendingCommandCount, popCommand, pushCommand, commandRingCapacitySlots, commandRingOverflow, commandRingReadHead, commandRingWriteHead } from './command_ring.cjs';
 export { type PayloadCodec, CommandDispatcher } from './command_dispatch.cjs';
 export { BufferBackedColumn, StoreColumnOverflowError } from './buffer_backed_column.cjs';
 export { type ArchetypeGrowSpec, type GrowPlan, type GrowResult, StoreGrowError, growColumnStore } from './grow.cjs';
 export { type ExtendPlan, type ExtendResult, StoreExtendError, extendColumnStore } from './extend.cjs';
-export { snapshotLiveColumns, restoreColumnSnapshots } from './layout_ops.cjs';
-export { type BufferAllocator, type InPlaceBufferAllocator, StoreCapExceededError, SabUnavailableError, DEFAULT_SAB_ALLOCATOR, wasmMemoryAllocator, growableSabAllocator, heapArraybufferAllocator } from './allocator.cjs';
-export { StoreRestoreError, snapshotColumnStore, restoreColumnStore } from './snapshot.cjs';
+export { snapshotLiveColumns, restoreLiveColumns } from './layout_ops.cjs';
+export { type BufferAllocator, type InPlaceBufferAllocator, StoreCapExceededError, SabUnavailableError, DEFAULT_SAB_ALLOCATOR, wasmMemoryAllocator, growableSabAllocator, heapArrayBufferAllocator, fixedSabAllocator } from './allocator.cjs';
+export { StoreRestoreError, type RestoreColumnStoreOptions, columnStoreBytesView, restoreColumnStore } from './snapshot.cjs';
 export { FNV1A_OFFSET_BASIS, FNV1A_PRIME, fnv1a32, fnv1aStep, fnv1aStepWord, columnStoreStateHash } from './state_hash.cjs';
 export { ACTION_RING_DEFAULT_CAPACITY_SLOTS, ACTION_RING_HEADER_BYTES, ACTION_RING_HEADER_OFFSETS, ACTION_RING_MAX_PAYLOAD_BYTES, ACTION_RING_SLOT_BYTES, ActionRingError, actionRingBytes, actionRingCapacitySlots, actionRingOverflow, actionRingReadHead, actionRingWriteHead, clearActionRingOverflow, drainActionRing, initActionRing, pendingActionCount, popAction, pushAction } from './action_ring.cjs';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/store/index.d.ts

@@ -1,17 +1,17 @@
-export { STORE_MAGIC, SIM_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS, type StoreHeader, writeStoreHeader, readStoreHeader, bumpViewStamp, isValidSab } from './header.js';
-export { type StoreRegionSpec, type RegionTableEntry, type ColumnStoreRegionHandle, RegionRegistryError, regionTableBytes, validateRegionSpecs, writeRegionTableEntry, readRegionTableEntry, writeRegionTable, readRegionTable, readHeaderRegionTable, findRegionOffset, findRegionEntry } from './region_table.js';
-export { TYPE_TAG, type TypeTagValue, TYPE_TAG_STRIDE, TYPED_ARRAY_TAG_TO_TYPE_TAG, COLUMN_DESCRIPTOR_BYTES, COLUMN_DESCRIPTOR_OFFSETS, type ColumnDescriptor, writeColumnDescriptor, readColumnDescriptor, ARCHETYPE_DESCRIPTOR_HEADER_BYTES, ARCHETYPE_DESCRIPTOR_OFFSETS, COMPONENT_MASK_WORDS, STORE_DESCRIPTOR_COMPONENT_LIMIT, type ArchetypeDescriptor, archetypeDescriptorBytes, writeArchetypeDescriptor, readArchetypeDescriptor, writeLayoutDescriptorRegion, readLayoutDescriptorRegion, layoutDescriptorRegionBytes } from './descriptor.js';
-export { type ColumnSpec, type ArchetypeSpec, type ColumnView, type ArchetypeViews, type ColumnStore, type AnyTypedArray, type CreateColumnStoreOptions, alignUp, buildArchetypeViews, columnKey, createColumnStore, StoreLayoutOverflowError, STORE_MAX_BYTE_OFFSET, COMMAND_RING_DEFAULT_CAPACITY_SLOTS, ENTITY_INDEX_DEFAULT_CAPACITY, EVENT_RING_DEFAULT_CAPACITY_SLOTS } from './column_store.js';
-export { EVENT_OP_EMPTY, EVENT_RING_HEADER_BYTES, EVENT_RING_SLOT_BYTES, EVENT_RING_HEADER_OFFSETS, EventRingError, drainEventRing, eventRingBytes, initEventRing, pendingEventCount, popEvent, pushEvent, ringCapacitySlots as eventRingCapacitySlots, ringOverflow as eventRingOverflow, ringReadHead as eventRingReadHead, ringWriteHead as eventRingWriteHead } from './event_ring.js';
-export { ENTITY_INDEX_HEADER_BYTES, ENTITY_INDEX_BYTES_PER_SLOT, ENTITY_INDEX_HEADER_OFFSETS, EntityIndexError, buildEntityIndexViews, entityIndexCapacity, entityIndexLength, entityIndexRegionBytes, initEntityIndexRegion, setEntityIndexLength } from './entity_index.js';
-export { COMMAND_OP_EMPTY, COMMAND_RING_HEADER_BYTES, COMMAND_RING_SLOT_BYTES, COMMAND_RING_HEADER_OFFSETS, CommandRingError, commandRingBytes, drainCommandRing, initCommandRing, pendingCommandCount, popCommand, pushCommand, ringCapacitySlots, ringOverflow, ringReadHead, ringWriteHead } from './command_ring.js';
+export { STORE_MAGIC, SIM_ABI_VERSION, LEGACY_ABSOLUTE_ABI_VERSION, STORE_HEADER_BYTES, STORE_HEADER_OFFSETS, REGION_TABLE_ENTRY_BYTES, REGION_TABLE_ENTRY_OFFSETS, type StoreHeader, writeStoreHeader, readStoreHeader, bumpViewStamp, isValidStoreHeader } from './header.js';
+export { type StoreRegionSpec, type RegionTableEntry, type ColumnStoreRegionHandle, RegionRegistryError, regionTableBytes, assertRegionSpecs, writeRegionTableEntry, readRegionTableEntry, writeRegionTable, readRegionTable, readHeaderRegionTable, findRegionOffset, findRegionEntry } from './region_table.js';
+export { TYPE_TAG, type TypeTagValue, TYPE_TAG_STRIDE, TYPED_ARRAY_TAG_TO_TYPE_TAG, COLUMN_DESCRIPTOR_BYTES, COLUMN_DESCRIPTOR_OFFSETS, type ColumnDescriptor, writeColumnDescriptor, readColumnDescriptor, ARCHETYPE_DESCRIPTOR_HEADER_BYTES, LEGACY_ARCHETYPE_DESCRIPTOR_HEADER_BYTES, ARCHETYPE_DESCRIPTOR_OFFSETS, COMPONENT_MASK_WORDS, STORE_DESCRIPTOR_COMPONENT_LIMIT, type ArchetypeDescriptor, archetypeDescriptorBytes, writeArchetypeDescriptor, readArchetypeDescriptor, writeLayoutDescriptorRegion, readLayoutDescriptorRegion, layoutDescriptorRegionBytes } from './descriptor.js';
+export { type ColumnSpec, type ArchetypeSpec, type ColumnView, type ArchetypeViews, type ColumnStore, type AnyTypedArray, type CreateColumnStoreOptions, alignUp, createArchetypeViews, columnKey, createColumnStore, StoreLayoutOverflowError, STORE_MAX_BYTE_OFFSET, STORE_BASE_ALIGNMENT, assertStoreBase, COMMAND_RING_DEFAULT_CAPACITY_SLOTS, ENTITY_INDEX_DEFAULT_CAPACITY, EVENT_RING_DEFAULT_CAPACITY_SLOTS } from './column_store.js';
+export { EVENT_OP_EMPTY, EVENT_RING_HEADER_BYTES, EVENT_RING_SLOT_BYTES, EVENT_RING_HEADER_OFFSETS, EventRingError, drainEventRing, eventRingBytes, initEventRing, pendingEventCount, popEvent, pushEvent, eventRingCapacitySlots, eventRingOverflow, eventRingReadHead, eventRingWriteHead } from './event_ring.js';
+export { ENTITY_INDEX_HEADER_BYTES, ENTITY_INDEX_BYTES_PER_SLOT, ENTITY_INDEX_HEADER_OFFSETS, EntityIndexError, createEntityIndexViews, entityIndexCapacity, entityIndexLength, entityIndexRegionBytes, initEntityIndexRegion, setEntityIndexLength } from './entity_index.js';
+export { COMMAND_OP_EMPTY, COMMAND_RING_HEADER_BYTES, COMMAND_RING_SLOT_BYTES, COMMAND_RING_HEADER_OFFSETS, CommandRingError, commandRingBytes, drainCommandRing, initCommandRing, pendingCommandCount, popCommand, pushCommand, commandRingCapacitySlots, commandRingOverflow, commandRingReadHead, commandRingWriteHead } from './command_ring.js';
 export { type PayloadCodec, CommandDispatcher } from './command_dispatch.js';
 export { BufferBackedColumn, StoreColumnOverflowError } from './buffer_backed_column.js';
 export { type ArchetypeGrowSpec, type GrowPlan, type GrowResult, StoreGrowError, growColumnStore } from './grow.js';
 export { type ExtendPlan, type ExtendResult, StoreExtendError, extendColumnStore } from './extend.js';
-export { snapshotLiveColumns, restoreColumnSnapshots } from './layout_ops.js';
-export { type BufferAllocator, type InPlaceBufferAllocator, StoreCapExceededError, SabUnavailableError, DEFAULT_SAB_ALLOCATOR, wasmMemoryAllocator, growableSabAllocator, heapArraybufferAllocator } from './allocator.js';
-export { StoreRestoreError, snapshotColumnStore, restoreColumnStore } from './snapshot.js';
+export { snapshotLiveColumns, restoreLiveColumns } from './layout_ops.js';
+export { type BufferAllocator, type InPlaceBufferAllocator, StoreCapExceededError, SabUnavailableError, DEFAULT_SAB_ALLOCATOR, wasmMemoryAllocator, growableSabAllocator, heapArrayBufferAllocator, fixedSabAllocator } from './allocator.js';
+export { StoreRestoreError, type RestoreColumnStoreOptions, columnStoreBytesView, restoreColumnStore } from './snapshot.js';
 export { FNV1A_OFFSET_BASIS, FNV1A_PRIME, fnv1a32, fnv1aStep, fnv1aStepWord, columnStoreStateHash } from './state_hash.js';
 export { ACTION_RING_DEFAULT_CAPACITY_SLOTS, ACTION_RING_HEADER_BYTES, ACTION_RING_HEADER_OFFSETS, ACTION_RING_MAX_PAYLOAD_BYTES, ACTION_RING_SLOT_BYTES, ActionRingError, actionRingBytes, actionRingCapacitySlots, actionRingOverflow, actionRingReadHead, actionRingWriteHead, clearActionRingOverflow, drainActionRing, initActionRing, pendingActionCount, popAction, pushAction } from './action_ring.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/store/index.d.ts.map

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