@oasys/oecs 0.5.1 → 0.5.3

package/CHANGELOG.md

@@ -5,6 +5,58 @@ 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
+
+- **`@oasys/oecs/dev`** — the same public API as `@oasys/oecs` with the `__DEV__`
+  guards left **on**, for a direct guards-on import (browser/CDN, quick debugging,
+  or bundlers that don't auto-select conditions).
+- **`development` export condition** — dev-mode bundlers (`vite dev`,
+  `webpack --mode development`) now resolve `@oasys/oecs` (and every subpath) to a
+  guards-on build automatically; production-mode builds resolve to the stripped
+  build as before.
+- npm now ships a **dual build** (`scripts/build.mjs`): the default `*.js`/`*.cjs`
+  are the stripped production artifacts (unchanged), alongside new guards-on
+  `*.development.js`/`*.development.cjs`.
+- New guide: [Development guards & production builds](docs/PRODUCTION.md).
+
+### Changed — dev-guard default is now production on JSR/Deno
+
+- Raw-source (JSR/Deno) consumers now default to `__DEV__ = false` (**production —
+  guards off, no per-frame tax**), matching npm's default. Previously the raw path
+  defaulted to guards-on. To enable the guards while developing on Deno, set
+  `globalThis.__DEV__ = true` **before the first import**. The `globalThis.__DEV__`
+  override is unchanged; only the default flipped. (`dev_flag.ts`)
+
 ## [0.5.1] — 2026-07-06
 
 ### Changed (breaking) — one attach grammar

package/README.md

@@ -168,7 +168,8 @@ The core is `@oasys/oecs`; everything else is opt-in and costs nothing until imp
 
 | Import | What it is |
 | --- | --- |
-| `@oasys/oecs` | the ECS — pure-TS heap profile by default |
+| `@oasys/oecs` | the ECS — pure-TS heap profile by default (production build; dev guards stripped) |
+| `@oasys/oecs/dev` | the same ECS with the dev guards **on** — for a direct guards-on import; see [Dev vs prod](#dev-vs-prod) |
 | `@oasys/oecs/shared` | opt-in `SharedArrayBuffer` allocators for worker offload / a WASM backend (needs COOP/COEP) |
 | `@oasys/oecs/reactive` | zero-dependency reactive kernel (`signal`/`computed`/`effect`, reactive collections) |
 | `@oasys/oecs/reactive-sync` | ECS→reactive bridge — publishes only dirty entities/columns |
@@ -182,9 +183,16 @@ The core is `@oasys/oecs`; everything else is opt-in and costs nothing until imp
 A compile-time `__DEV__` flag gates every runtime check — bounds and liveness checks, duplicate-system
 detection, registration validation, and the system access checker (`reads`/`writes`). These are
 **tree-shaken out of production builds**, so treat "throws in dev" as a development tripwire, not a
-production guarantee. (Raw-source consumers — JSR/Deno — get `__DEV__ = true` by default; set
-`globalThis.__DEV__ = false` to opt out.) The scheduler's cycle detection and constructor-option
-validation (timestep, memory options, relation cardinality) are always active.
+production guarantee. The scheduler's cycle detection and constructor-option validation (timestep,
+memory options, relation cardinality) are always active.
+
+**Production is the default on both channels; you opt *into* the guards.** On **npm**, `@oasys/oecs`
+is the stripped production build — dev-mode bundlers (`vite dev`, `webpack --mode development`) pick
+the guards-on build automatically via the `development` export condition, or import `@oasys/oecs/dev`
+for it directly. On **JSR/Deno** (raw source, no bundler) the default is also production
+(`__DEV__ = false`); set `globalThis.__DEV__ = true` before the first import to turn the guards on
+while developing. Full details — including the browser/CDN and manual-override paths — are in the
+[**Development guards & production builds**](docs/PRODUCTION.md) guide.
 
 ## Documentation
 

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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAMN,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAGxF,OAAO,EAGN,KAAK,sBAAsB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB;;;yDAGyD;AACzD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED;;8EAE8E;AAC9E,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;CACJ;AAED;;;;;;;;6BAQ6B;AAC7B,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACxC;IAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA+B1D;AAED;;;;;;;+BAO+B;AAC/B,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,MAAM,GACd;IAAE,WAAW,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAIrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,wBAAwB,CAwCzE;AAED;;;;6BAI6B;AAC7B,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,oBAAoB,CAsB5E;AAED;;;;mFAImF;AACnF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAc5F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAmB3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,GAClC,IAAI,CAeN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,SAAS,EAAE,eAAe,GAAG,SAAS,GACpC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAmBpE"}
+{"version":3,"file":"layout_ops.d.ts","sourceRoot":"","sources":["../../../src/core/store/layout_ops.ts"],"names":[],"mappings":"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"}

package/dist/dev_flag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev_flag.d.ts","sourceRoot":"","sources":["../src/dev_flag.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,GAAG,EAAE,OAAyD,CAAC"}
+{"version":3,"file":"dev_flag.d.ts","sourceRoot":"","sources":["../src/dev_flag.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,GAAG,EAAE,OAA0D,CAAC"}

package/dist/extensions/editor/index.development.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(r,t,e){return`${r}:${t.id}:${e}`}const a=new WeakMap;class h{constructor(t,e){this.readField=t,this.shadow=e,a.set(this,{forward:[],inverse:[]})}staged=new Map;get _txn(){return a.get(this)}spawn(t,e){const s={kind:"despawn",eid:0};return this._txn.inverse.push(s),this._txn.forward.push({kind:"spawn",components:t,onSpawned:n=>{s.eid=n,e?.(n)}}),this}despawn(t,e){const s={kind:"despawn",eid:t};return this._txn.forward.push(s),this._txn.inverse.push({kind:"spawn",components:e,onSpawned:n=>{s.eid=n}}),this}setField(t,e,s,n){const i=o(t,e,s),d=this.staged.get(i)??this.shadow.get(i)??this.readField(t,e,s)??0;return this.staged.set(i,n),this._txn.forward.push({kind:"set_field",eid:t,def:e,field:s,value:n}),this._txn.inverse.push({kind:"set_field",eid:t,def:e,field:s,value:d}),this}add(t,e,s){return this._txn.forward.push({kind:"add_component",eid:t,def:e,values:s}),this._txn.inverse.push({kind:"remove_component",eid:t,def:e}),this}remove(t,e,s){return this._txn.forward.push({kind:"remove_component",eid:t,def:e}),this._txn.inverse.push({kind:"add_component",eid:t,def:e,values:s}),this}disable(t){return this._txn.forward.push({kind:"disable",eid:t}),this._txn.inverse.push({kind:"enable",eid:t}),this}enable(t){return this._txn.forward.push({kind:"enable",eid:t}),this._txn.inverse.push({kind:"disable",eid:t}),this}}class u{constructor(t,e){this.queue=t,this.readField=e}undoStack=[];redoStack=[];listeners=[];shadow=new Map;transaction(t){const e=new h(this.readField,this.shadow);return t(e),this.commit(a.get(e))}spawn(t,e){return this.transaction(s=>s.spawn(t,e))}despawn(t,e){return this.transaction(s=>s.despawn(t,e))}setField(t,e,s,n){return this.transaction(i=>i.setField(t,e,s,n))}add(t,e,s){return this.transaction(n=>n.add(t,e,s))}remove(t,e,s){return this.transaction(n=>n.remove(t,e,s))}disable(t){return this.transaction(e=>e.disable(t))}enable(t){return this.transaction(e=>e.enable(t))}undo(){const t=this.undoStack.pop();if(t===void 0)return!1;const e=t.inverse.slice().reverse();for(const s of e)this.queue.push(s);return this.applyShadow(e),this.redoStack.push(t),this.notify(),!0}redo(){const t=this.redoStack.pop();if(t===void 0)return!1;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.notify(),!0}clear(){this.undoStack.length=0,this.redoStack.length=0,this.shadow.clear(),this.notify()}depths(){return{undo:this.undoStack.length,redo:this.redoStack.length}}get canUndo(){return this.undoStack.length>0}get canRedo(){return this.redoStack.length>0}onChange(t){return this.listeners.push(t),()=>{const e=this.listeners.indexOf(t);e!==-1&&this.listeners.splice(e,1)}}notify(){for(const t of this.listeners.slice())t()}committedField(t,e,s){return this.readField(t,e,s)}pendingField(t,e,s){const n=o(t,e,s),i=this.shadow.get(n);if(i===void 0)return;const d=this.readField(t,e,s);if(d===i||d===void 0){this.shadow.delete(n);return}return i}commit(t){if(t.forward.length===0)return t;for(const e of t.forward)this.queue.push(e);return this.applyShadow(t.forward),this.undoStack.push(t),this.redoStack.length=0,this.notify(),t}applyShadow(t){for(const e of t)e.kind==="set_field"&&this.shadow.set(o(e.eid,e.def,e.field),e.value)}}function c(r,t,e,s,n){return{get value(){return n!==void 0?n():r.committedField(t,e,s)},set(i){r.setField(t,e,s,i)},get pending(){return r.pendingField(t,e,s)}}}exports.Editor=u;exports.TransactionBuilder=h;exports.fieldHandle=c;