@oasys/oecs 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.3] — 2026-07-09
+
+### Fixed — heap columns back on V8's fast element-access path (~5× iteration)
+
+- The pure-TS **heap profile** (`heapArraybufferAllocator` — the default backing)
+  now reserves its store as a **fixed, non-resizable `ArrayBuffer`** at the full
+  cap instead of a growable one resized via `.resize()`. V8 has no fast
+  element-access path for TypedArray views over a **resizable/growable**
+  `ArrayBuffer` — every `col[i]` re-checks the mutable length — so iterating a
+  column was ~4× slower than over a fixed buffer (measured on V8 13.6, an
+  isolated `col[i] *= 2` loop: ~0.37G vs ~1.6G element-accesses/s). This
+  silently regressed every iteration-bound system ~5× from 0.3.x (a
+  cross-library bench had oecs at ~85k op/s on the `packed_5` scenario vs
+  ~407k at 0.3.1); 0.5.3 restores it (~420k, measured against 0.5.2 in a
+  same-toolchain A/B: 85.9k → 422.7k op/s).
+- The fixed buffer faults pages in lazily, so RSS tracks real use, not the
+  reservation (a 256 MiB default cap on a 1000-entity world stays a few MiB
+  resident — measured ~4 MiB RSS, within ~1 MiB of the old resizable buffer).
+  Growth remains in place: the store relocates columns within the pre-reserved
+  buffer, so the buffer identity never changes and every existing view stays
+  valid —
+  `isInPlace: true` and ADR-0008's entity-index-hoist-across-grow invariant hold
+  unchanged. The store keys its tail cursor off the header `capacity` (the
+  logical high-water) rather than `buffer.byteLength` (now always the cap).
+- Only the heap backing changed. The `growable_sab` / `wasm_memory` backings
+  keep their resizable buffers and page-rounded tail layout byte-for-byte
+  (their determinism/layout goldens are unchanged).
+
 ## [0.5.2] — 2026-07-08
 
 ### Added — a guards-on build and an explicit dev entry

package/dist/core/ecs/ecs_memory.d.cts

@@ -43,12 +43,12 @@ export type WasmMemoryArm = {
     readonly initialPages?: number;
     readonly memory?: never;
 };
-/** Pure-TS **heap** backing (#643 / ADR-0018 §1B): a plain resizable
- * `ArrayBuffer` instead of a `SharedArrayBuffer`. Needs no cross-origin
- * isolation (COOP/COEP) and is the intended default for embedders that can't
- * set those headers (the oecs profile). Trade-off: no worker offload and no
- * WASM compute backend — both require a transferable `SharedArrayBuffer`. An
- * empty `{}` takes the default 256 MiB growable cap. */
+/** Pure-TS **heap** backing (#643 / ADR-0018 §1B): a plain fixed (non-resizable)
+ * `ArrayBuffer` reserved at the cap up front, instead of a `SharedArrayBuffer`.
+ * Needs no cross-origin isolation (COOP/COEP) and is the intended default for
+ * embedders that can't set those headers (the oecs profile). Trade-off: no
+ * worker offload and no WASM compute backend — both require a transferable
+ * `SharedArrayBuffer`. An empty `{}` takes the default 256 MiB cap. */
 export interface HeapMemoryArm {
     /** Byte ceiling of the growable heap backing. Default
      * `DEFAULT_ECS_CAP_BYTES` (256 MiB), same hard-ceiling semantics as the

package/dist/core/ecs/ecs_memory.d.ts

@@ -43,12 +43,12 @@ export type WasmMemoryArm = {
     readonly initialPages?: number;
     readonly memory?: never;
 };
-/** Pure-TS **heap** backing (#643 / ADR-0018 §1B): a plain resizable
- * `ArrayBuffer` instead of a `SharedArrayBuffer`. Needs no cross-origin
- * isolation (COOP/COEP) and is the intended default for embedders that can't
- * set those headers (the oecs profile). Trade-off: no worker offload and no
- * WASM compute backend — both require a transferable `SharedArrayBuffer`. An
- * empty `{}` takes the default 256 MiB growable cap. */
+/** Pure-TS **heap** backing (#643 / ADR-0018 §1B): a plain fixed (non-resizable)
+ * `ArrayBuffer` reserved at the cap up front, instead of a `SharedArrayBuffer`.
+ * Needs no cross-origin isolation (COOP/COEP) and is the intended default for
+ * embedders that can't set those headers (the oecs profile). Trade-off: no
+ * worker offload and no WASM compute backend — both require a transferable
+ * `SharedArrayBuffer`. An empty `{}` takes the default 256 MiB cap. */
 export interface HeapMemoryArm {
     /** Byte ceiling of the growable heap backing. Default
      * `DEFAULT_ECS_CAP_BYTES` (256 MiB), same hard-ceiling semantics as the

package/dist/core/ecs/ecs_memory.d.ts.map

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

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

@@ -58,10 +58,11 @@ export interface BufferAllocator {
     /** Returns a buffer of byteLength >= `bytes`. The historical name is
      * "SAB", but the return is `ArrayBufferLike`: `growableSabAllocator` /
      * `wasmMemoryAllocator` produce a `SharedArrayBuffer` (the SAB profile),
-     * while `heapArraybufferAllocator` produces a plain resizable
-     * `ArrayBuffer` (the pure-TS heap profile — no cross-origin isolation
-     * required). The store layer treats the backing uniformly; only the
-     * WASM/worker boundary narrows back to `SharedArrayBuffer`. */
+     * while `heapArraybufferAllocator` produces a plain fixed (non-resizable)
+     * `ArrayBuffer` reserved at the cap (the pure-TS heap profile — no
+     * cross-origin isolation required). The store layer treats the backing
+     * uniformly; only the WASM/worker boundary narrows back to
+     * `SharedArrayBuffer`. */
     (bytes: number): ArrayBufferLike;
     readonly isInPlace?: boolean;
 }
@@ -74,9 +75,11 @@ export interface BufferAllocator {
  * return it; `DEFAULT_SAB_ALLOCATOR` keeps the wide `BufferAllocator` type and
  * therefore cannot typecheck where a live-Store backing is required. Non-in-place
  * allocators remain valid for snapshot/test sizing only. The brand says nothing
- * about *shared* vs *heap* backing — `heapArraybufferAllocator`'s resizable
- * `ArrayBuffer` is just as in-place as a growable SAB (`.resize()` preserves
- * existing views exactly like `SharedArrayBuffer.prototype.grow`).
+ * about *shared* vs *heap* backing — `heapArraybufferAllocator`'s fixed
+ * `ArrayBuffer` is just as in-place as a growable SAB: it is reserved at the full
+ * cap up front and never moves, so grow/extend relocate columns *within* it
+ * (`copyWithin`) rather than resizing the buffer — existing views stay valid, the
+ * same guarantee `SharedArrayBuffer.prototype.grow` gives by resizing in place.
  */
 export type InPlaceBufferAllocator = BufferAllocator & {
     readonly isInPlace: true;
@@ -177,20 +180,42 @@ export declare const DEFAULT_SAB_ALLOCATOR: BufferAllocator;
  */
 export declare function growableSabAllocator(maxBytes?: number): InPlaceBufferAllocator;
 /**
- * Allocator that backs the store by a single growable **plain `ArrayBuffer`**
- * (created with `{ maxByteLength: maxBytes }`, grown via `.resize()`). This is
- * the pure-TS **heap profile** — the oecs default and the answer to ADR-0018's
+ * Allocator that backs the store by a single **fixed (non-resizable) plain
+ * `ArrayBuffer`** reserved at the full `maxBytes` cap up front. This is the
+ * pure-TS **heap profile** — the oecs default and the answer to ADR-0018's
  * deferred §1B: no `SharedArrayBuffer`, hence no cross-origin isolation
  * (COOP/COEP) requirement, and no worker/WASM transfer (single-process worlds
- * only). Otherwise identical to `growableSabAllocator`:
- *
- *   - `isInPlace: true`. A resizable `ArrayBuffer`'s `.resize()` keeps the
- *     same buffer object and preserves existing TypedArray/DataView views, so
- *     the store's `extend`/`grow` fast path carries column views forward
- *     unchanged — exactly as `SharedArrayBuffer.prototype.grow` does. ADR-0008's
- *     entity-index-hoist-across-grow invariant holds identically.
- *   - same 256 MiB default cap with hard-ceiling semantics (#380): reaching it
- *     signals runaway growth upstream, not a limit to route around.
+ * only).
+ *
+ * WHY FIXED, NOT RESIZABLE (the 0.5.3 iteration-perf fix): V8 has no fast
+ * element-access path for TypedArray views over a **resizable/growable**
+ * `ArrayBuffer` — every `col[i]` re-checks bounds against the buffer's mutable
+ * length, a ~4× per-element tax measured on V8 13.6 (an isolated `col[i] *= 2`
+ * loop: fixed `ArrayBuffer` ~1.6G vs a view over a resizable buffer ~0.37G
+ * element-accesses/s). oecs 0.3.x gave each column its own fixed buffer and sat
+ * mid-pack among SoA ECS libs; the 0.5.0 switch to one resizable arena silently
+ * regressed all iteration-bound systems ~5× (the cross-library `packed_5`
+ * scenario: 0.5.2 ~86k op/s → 0.5.3 ~420k). A fixed buffer restores the fast path.
+ *
+ * How growth still works in place: the cap is reserved as one fixed buffer at
+ * construction. A resizable buffer was originally chosen so `.resize()` could
+ * grow in place without moving views; a fixed buffer never moves EITHER — the
+ * store's grow/extend relocate columns to the tail *within* this buffer
+ * (`copyWithin`), so the buffer object and every existing view stay valid.
+ * `isInPlace: true` therefore still holds, and ADR-0008's
+ * entity-index-hoist-across-grow invariant is preserved. The store keys its
+ * tail cursor off the header `capacity` (the logical high-water), NOT
+ * `buffer.byteLength` — which is now always `maxBytes` (the same decoupling the
+ * wasm page-rounded allocator already relied on).
+ *
+ *   - Memory cost is unchanged: a fixed `ArrayBuffer(maxBytes)` faults pages in
+ *     lazily (untouched pages cost no RSS), exactly like the resizable buffer's
+ *     `maxByteLength` reservation — a 256 MiB reservation on a 1000-entity world
+ *     stays a few MiB resident (measured ~4 MiB RSS, within ~1 MiB of the old
+ *     resizable buffer).
+ *   - same 256 MiB default cap with hard-ceiling semantics (#380): a request
+ *     past `maxBytes` throws `StoreCapExceededError` — runaway growth signal,
+ *     not a limit to route around.
  *
  * Why a non-shared buffer suffices: `Atomics` live only on the cross-thread
  * command/event/action rings, never on the core store path, so a single-process

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

@@ -58,10 +58,11 @@ export interface BufferAllocator {
     /** Returns a buffer of byteLength >= `bytes`. The historical name is
      * "SAB", but the return is `ArrayBufferLike`: `growableSabAllocator` /
      * `wasmMemoryAllocator` produce a `SharedArrayBuffer` (the SAB profile),
-     * while `heapArraybufferAllocator` produces a plain resizable
-     * `ArrayBuffer` (the pure-TS heap profile — no cross-origin isolation
-     * required). The store layer treats the backing uniformly; only the
-     * WASM/worker boundary narrows back to `SharedArrayBuffer`. */
+     * while `heapArraybufferAllocator` produces a plain fixed (non-resizable)
+     * `ArrayBuffer` reserved at the cap (the pure-TS heap profile — no
+     * cross-origin isolation required). The store layer treats the backing
+     * uniformly; only the WASM/worker boundary narrows back to
+     * `SharedArrayBuffer`. */
     (bytes: number): ArrayBufferLike;
     readonly isInPlace?: boolean;
 }
@@ -74,9 +75,11 @@ export interface BufferAllocator {
  * return it; `DEFAULT_SAB_ALLOCATOR` keeps the wide `BufferAllocator` type and
  * therefore cannot typecheck where a live-Store backing is required. Non-in-place
  * allocators remain valid for snapshot/test sizing only. The brand says nothing
- * about *shared* vs *heap* backing — `heapArraybufferAllocator`'s resizable
- * `ArrayBuffer` is just as in-place as a growable SAB (`.resize()` preserves
- * existing views exactly like `SharedArrayBuffer.prototype.grow`).
+ * about *shared* vs *heap* backing — `heapArraybufferAllocator`'s fixed
+ * `ArrayBuffer` is just as in-place as a growable SAB: it is reserved at the full
+ * cap up front and never moves, so grow/extend relocate columns *within* it
+ * (`copyWithin`) rather than resizing the buffer — existing views stay valid, the
+ * same guarantee `SharedArrayBuffer.prototype.grow` gives by resizing in place.
  */
 export type InPlaceBufferAllocator = BufferAllocator & {
     readonly isInPlace: true;
@@ -177,20 +180,42 @@ export declare const DEFAULT_SAB_ALLOCATOR: BufferAllocator;
  */
 export declare function growableSabAllocator(maxBytes?: number): InPlaceBufferAllocator;
 /**
- * Allocator that backs the store by a single growable **plain `ArrayBuffer`**
- * (created with `{ maxByteLength: maxBytes }`, grown via `.resize()`). This is
- * the pure-TS **heap profile** — the oecs default and the answer to ADR-0018's
+ * Allocator that backs the store by a single **fixed (non-resizable) plain
+ * `ArrayBuffer`** reserved at the full `maxBytes` cap up front. This is the
+ * pure-TS **heap profile** — the oecs default and the answer to ADR-0018's
  * deferred §1B: no `SharedArrayBuffer`, hence no cross-origin isolation
  * (COOP/COEP) requirement, and no worker/WASM transfer (single-process worlds
- * only). Otherwise identical to `growableSabAllocator`:
- *
- *   - `isInPlace: true`. A resizable `ArrayBuffer`'s `.resize()` keeps the
- *     same buffer object and preserves existing TypedArray/DataView views, so
- *     the store's `extend`/`grow` fast path carries column views forward
- *     unchanged — exactly as `SharedArrayBuffer.prototype.grow` does. ADR-0008's
- *     entity-index-hoist-across-grow invariant holds identically.
- *   - same 256 MiB default cap with hard-ceiling semantics (#380): reaching it
- *     signals runaway growth upstream, not a limit to route around.
+ * only).
+ *
+ * WHY FIXED, NOT RESIZABLE (the 0.5.3 iteration-perf fix): V8 has no fast
+ * element-access path for TypedArray views over a **resizable/growable**
+ * `ArrayBuffer` — every `col[i]` re-checks bounds against the buffer's mutable
+ * length, a ~4× per-element tax measured on V8 13.6 (an isolated `col[i] *= 2`
+ * loop: fixed `ArrayBuffer` ~1.6G vs a view over a resizable buffer ~0.37G
+ * element-accesses/s). oecs 0.3.x gave each column its own fixed buffer and sat
+ * mid-pack among SoA ECS libs; the 0.5.0 switch to one resizable arena silently
+ * regressed all iteration-bound systems ~5× (the cross-library `packed_5`
+ * scenario: 0.5.2 ~86k op/s → 0.5.3 ~420k). A fixed buffer restores the fast path.
+ *
+ * How growth still works in place: the cap is reserved as one fixed buffer at
+ * construction. A resizable buffer was originally chosen so `.resize()` could
+ * grow in place without moving views; a fixed buffer never moves EITHER — the
+ * store's grow/extend relocate columns to the tail *within* this buffer
+ * (`copyWithin`), so the buffer object and every existing view stay valid.
+ * `isInPlace: true` therefore still holds, and ADR-0008's
+ * entity-index-hoist-across-grow invariant is preserved. The store keys its
+ * tail cursor off the header `capacity` (the logical high-water), NOT
+ * `buffer.byteLength` — which is now always `maxBytes` (the same decoupling the
+ * wasm page-rounded allocator already relied on).
+ *
+ *   - Memory cost is unchanged: a fixed `ArrayBuffer(maxBytes)` faults pages in
+ *     lazily (untouched pages cost no RSS), exactly like the resizable buffer's
+ *     `maxByteLength` reservation — a 256 MiB reservation on a 1000-entity world
+ *     stays a few MiB resident (measured ~4 MiB RSS, within ~1 MiB of the old
+ *     resizable buffer).
+ *   - same 256 MiB default cap with hard-ceiling semantics (#380): a request
+ *     past `maxBytes` throws `StoreCapExceededError` — runaway growth signal,
+ *     not a limit to route around.
  *
  * Why a non-shared buffer suffices: `Atomics` live only on the cross-thread
  * command/event/action rings, never on the core store path, so a single-process

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

@@ -1 +1 @@
-{"version":3,"file":"allocator.d.ts","sourceRoot":"","sources":["../../../src/core/store/allocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;mEAM+D;IAC/D,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEpF;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG9B,cAAc,EAAE,MAAM;IACtC;6DACyD;aACzC,QAAQ,EAAE,MAAM,GAAG,IAAI;gBAJvC,OAAO,EAAE,MAAM,EACC,cAAc,EAAE,MAAM;IACtC;6DACyD;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,YAAY;CAKvB;AAED;;;;;;oEAMoE;AACpE,qBAAa,mBAAoB,SAAQ,KAAK;;CAe7C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAGnC,CAAC;AA+DF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAA0B,GAAG,sBAAsB,CA6BjG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,GAAE,MAA0B,GAClC,sBAAsB,CAuBxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,sBAAsB,CA6DtF"}
+{"version":3,"file":"allocator.d.ts","sourceRoot":"","sources":["../../../src/core/store/allocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;8BAO0B;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEpF;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG9B,cAAc,EAAE,MAAM;IACtC;6DACyD;aACzC,QAAQ,EAAE,MAAM,GAAG,IAAI;gBAJvC,OAAO,EAAE,MAAM,EACC,cAAc,EAAE,MAAM;IACtC;6DACyD;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,YAAY;CAKvB;AAED;;;;;;oEAMoE;AACpE,qBAAa,mBAAoB,SAAQ,KAAK;;CAe7C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAGnC,CAAC;AAgEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAA0B,GAAG,sBAAsB,CA6BjG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,GAAE,MAA0B,GAClC,sBAAsB,CAsBxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,sBAAsB,CA6DtF"}

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

@@ -51,7 +51,7 @@ export interface ArchetypeViews {
 }
 export interface ColumnStore {
     /** The backing buffer. `ArrayBufferLike` because the store is backing-agnostic:
-     * a `SharedArrayBuffer` for the SAB/WASM/worker profile, or a plain resizable
+     * a `SharedArrayBuffer` for the SAB/WASM/worker profile, or a plain fixed
      * `ArrayBuffer` for the pure-TS heap profile (`heapArraybufferAllocator`).
      * Consumers that genuinely require sharing (worker transfer, WASM memory)
      * narrow back to `SharedArrayBuffer` at their boundary. */

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

@@ -51,7 +51,7 @@ export interface ArchetypeViews {
 }
 export interface ColumnStore {
     /** The backing buffer. `ArrayBufferLike` because the store is backing-agnostic:
-     * a `SharedArrayBuffer` for the SAB/WASM/worker profile, or a plain resizable
+     * a `SharedArrayBuffer` for the SAB/WASM/worker profile, or a plain fixed
      * `ArrayBuffer` for the pure-TS heap profile (`heapArraybufferAllocator`).
      * Consumers that genuinely require sharing (worker transfer, WASM memory)
      * narrow back to `SharedArrayBuffer` at their boundary. */

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,EAIN,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,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"}

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,EAIN,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;AAyJD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

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

@@ -50,6 +50,24 @@ export declare function growBufferInPlace(old: ColumnStoreInternal, newTotal: nu
     grownBuffer: ArrayBufferLike;
     newView: DataView;
 };
+/**
+ * Byte offset where the next appended column region begins — the tail cursor
+ * the in-place grow/extend paths pass to `layoutColumnsAtTail`.
+ *
+ * For the growable-SAB and wasm backings the buffer is sized to the live extent
+ * (`SharedArrayBuffer.grow` resizes exactly; wasm rounds up to a page, and its
+ * fast path deliberately lands new regions past that page-rounded tail), so
+ * `buffer.byteLength` IS the tail. For the pure-TS **heap** backing (0.5.3) the
+ * buffer is a FIXED `ArrayBuffer` reserved at the full cap for V8 fast-path
+ * element access, so its `byteLength` is `maxBytes`, NOT the used size — the
+ * true tail is the header `capacity` (the logical high-water; new columns land
+ * in still-zero fixed-buffer space just past the last live column).
+ *
+ * A plain (non-shared) `ArrayBuffer` is uniquely the heap profile's fixed
+ * reservation — every other in-place backing is a `SharedArrayBuffer`. Keying
+ * off the backing keeps the SAB/wasm layouts byte-for-byte unchanged.
+ */
+export declare function tailCursorBytes(old: ColumnStoreInternal): number;
 /**
  * Derive `CreateColumnStoreOptions` from an old ColumnStore so a slow-path realloc
  * preserves the same set of optional regions at the same byte offsets in the

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

@@ -50,6 +50,24 @@ export declare function growBufferInPlace(old: ColumnStoreInternal, newTotal: nu
     grownBuffer: ArrayBufferLike;
     newView: DataView;
 };
+/**
+ * Byte offset where the next appended column region begins — the tail cursor
+ * the in-place grow/extend paths pass to `layoutColumnsAtTail`.
+ *
+ * For the growable-SAB and wasm backings the buffer is sized to the live extent
+ * (`SharedArrayBuffer.grow` resizes exactly; wasm rounds up to a page, and its
+ * fast path deliberately lands new regions past that page-rounded tail), so
+ * `buffer.byteLength` IS the tail. For the pure-TS **heap** backing (0.5.3) the
+ * buffer is a FIXED `ArrayBuffer` reserved at the full cap for V8 fast-path
+ * element access, so its `byteLength` is `maxBytes`, NOT the used size — the
+ * true tail is the header `capacity` (the logical high-water; new columns land
+ * in still-zero fixed-buffer space just past the last live column).
+ *
+ * A plain (non-shared) `ArrayBuffer` is uniquely the heap profile's fixed
+ * reservation — every other in-place backing is a `SharedArrayBuffer`. Keying
+ * off the backing keeps the SAB/wasm layouts byte-for-byte unchanged.
+ */
+export declare function tailCursorBytes(old: ColumnStoreInternal): number;
 /**
  * Derive `CreateColumnStoreOptions` from an old ColumnStore so a slow-path realloc
  * preserves the same set of optional regions at the same byte offsets in the

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

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

package/dist/{host_commands-BI8pEmjH.js → host_commands-3jyFfWNg.js}

@@ -1,5 +1,5 @@
 import { S as et, t as tt } from "./topological_sort-DK6EjpWa.js";
-import { D as nt, h as K, w as we, g as st } from "./shared-BU1Cd40h.js";
+import { D as nt, h as K, w as we, g as st } from "./shared-DQKK0i-E.js";
 class Be extends Error {
   constructor(t, n, r) {
     super(t), this.isOperational = n, this.context = r, this.name = this.constructor.name, Error.captureStackTrace(this, this.constructor);
@@ -1906,7 +1906,7 @@ function as(e) {
       intentLabel: `pure-TS heap backing (${I(s)} growable cap, no SharedArrayBuffer)`,
       budgetEntities: null,
       derivation: [
-        `backing = heap_arraybuffer_allocator(${I(s)}) — resizable ArrayBuffer, no SAB / no COOP+COEP (is_in_place ✓)`,
+        `backing = heap_arraybuffer_allocator(${I(s)}) — fixed ArrayBuffer reserved at the cap, no SAB / no COOP+COEP (is_in_place ✓)`,
         "trade-off: no worker offload / no WASM backend (both need a transferable SharedArrayBuffer)",
         `column_capacity = ${o} (${n !== void 0 ? "pinned" : "default"})`,
         `entity_index = floor_pow2(cap/4 ÷ ${D} B) = ${i} slots`