@oasys/oecs 0.5.3 → 0.5.4

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

@@ -16,7 +16,7 @@ export interface ArchetypeEdge {
  * Cached resolution of a *multi*-component add out of this archetype: the
  * target archetype the union lands in, plus the pre-built src→target batch
  * transition map. Keyed (on the source archetype) by an exact N-tagged pack of
- * the added component ids — see `Store.addComponents` (#659).
+ * the added component ids — see `Store.addComponents`.
  *
  * Where `ArchetypeEdge` is the per-*component* edge the single-add path indexes
  * by `edges[component_id]`, this is the per-*set* edge the plural-add path looks
@@ -53,7 +53,7 @@ export type ColumnFactory = (componentId: ComponentID, fieldIdx: number, tag: Ty
  * across every SAB-backed archetype; after the handler returns,
  * `arch._flatColumns[i].buf.length` is guaranteed to be `>= arch.length +
  * additional`. Heap-backed archetypes leave this unset — their
- * `GrowableTypedArray` grows in place. (#171 §6.1.9 Phase 3)
+ * `GrowableTypedArray` grows in place.
  */
 export type ArchetypeGrowHandler = (arch: Archetype, additional: number) => void;
 /**
@@ -63,8 +63,7 @@ export type ArchetypeGrowHandler = (arch: Archetype, additional: number) => void
  * `removeEntity`, `moveEntityFrom`, `writeFields`, `setEdge`, and the
  * mutable `getColumn`) stays internal so query iteration can't bypass the
  * deferred-flush path that prevents iterator invalidation. This is the same
- * back door PR #163 closed for `Store`; issue #378 closed it again for
- * `Query`.
+ * back door that is closed for `Store` and closed again for `Query`.
  *
  * `id` is the archetype's opaque identity (not a mutator) — exposed so the
  * public `ECS.batchAddComponent`/`batchRemoveComponent` API can target an
@@ -73,16 +72,16 @@ export type ArchetypeGrowHandler = (arch: Archetype, additional: number) => void
 export interface ArchetypeView<out Defs extends readonly ComponentDef<any>[] = readonly ComponentDef<any>[]> {
     /** Opaque archetype identity. Pass to `ECS.batch_*_component`. */
     readonly id: ArchetypeID;
-    /** Number of **enabled** entities — the default-iteration bound (#577). Rows
+    /** Number of **enabled** entities — the default-iteration bound. Rows
      * `0..entityCount-1` are enabled; disabled rows (if any) sit contiguously at
      * `entityCount..totalCount-1`. `forEach` SoA loops read this, so they skip
      * disabled rows for free. Use `totalCount` to span disabled rows too. */
     readonly entityCount: number;
-    /** Total live rows, enabled + disabled (#577). Equal to `entityCount` unless
+    /** Total live rows, enabled + disabled. Equal to `entityCount` unless
      * some rows are disabled. Use for full-state work (serialization, snapshot,
      * determinism) that must see every entity regardless of enabled state. */
     readonly totalCount: number;
-    /** Number of disabled rows = `totalCount - entityCount` (#577). */
+    /** Number of disabled rows = `totalCount - entityCount`. */
     readonly disabledCount: number;
     /** Raw entity ID buffer (packed `EntityID`s). Valid data at indices
      * 0..totalCount-1 (enabled rows first, then disabled). */
@@ -91,7 +90,7 @@ export interface ArchetypeView<out Defs extends readonly ComponentDef<any>[] = r
     hasComponent(id: ComponentID): boolean;
     /** Get a single field's column (read-only). Valid data: indices
      * 0..entityCount-1. `def` must be a term of the iterating query
-     * (POLISH_AUDIT #6); the bare-`ArchetypeView` default stays permissive. */
+     *; the bare-`ArchetypeView` default stays permissive. */
     getColumnRead<D extends ComponentDef<any>, K extends string & keyof SchemaOf<D>>(def: D & DeclaredQueryTerm<Defs, D>, field: K): ReadonlyColumn;
     /** Tuple fetch of several of one component's columns —
      * `const [q, r] = arch.getColumnsRead(HexPos, "q", "r")`. One small
@@ -100,7 +99,7 @@ export interface ArchetypeView<out Defs extends readonly ComponentDef<any>[] = r
         [I in keyof K]: ReadonlyColumn;
     };
     /** Get a single field's column **if this archetype has the component**,
-     * else `undefined` — the optional-query fetch-if-present accessor (#575).
+     * else `undefined` — the optional-query fetch-if-present accessor.
      * The absent branch is expected (resolve the column pointer per archetype
      * span: present ⇒ column, absent ⇒ `undefined`), not an error. Same
      * advisory-readonly view and `reads`-access-check as `getColumnRead`. */
@@ -125,7 +124,7 @@ export declare class Archetype implements ArchetypeView {
     private readonly _entityIds;
     length: number;
     /**
-     * Enabled/disabled row partition (#577 — entity enable/disable). Rows
+     * Enabled/disabled row partition (entity enable/disable). Rows
      * `[0, enabled_count)` are enabled, `[enabled_count, length)` are disabled.
      * `enabled_count === length` (no disabled rows) is the common case — every
      * fast path below short-circuits on it, so an archetype that never disables
@@ -139,14 +138,14 @@ export declare class Archetype implements ArchetypeView {
     enabledCount: number;
     /**
      * Flush-epoch stamp + captured pre-counts for the Store's per-entity flush
-     * 0-crossing detector (#328, #812): `_flushAdds`/`_flushRemoves` stamp each
+     * 0-crossing detector: `_flushAdds`/`_flushRemoves` stamp each
      * archetype on first sight per flush (a few field accesses) instead of probing
      * a `Map<archetype_id, pre_count>` per entity — the same per-entity Map
-     * cost the destroy drain shed in #457. Both `_flushPreLen` and
+     * cost the destroy drain also avoids. Both `_flushPreLen` and
      * `_flushPreEnabled` are recorded so the settle pass can detect a 0-crossing
      * on either the total (`length`) or the enabled partition (`enabledCount`) —
-     * an enabled append into an all-disabled archetype crosses only the latter
-     * (#812). Owned by Store; pure scheduling bookkeeping, never folded into
+     * an enabled append into an all-disabled archetype crosses only the latter.
+     * Owned by Store; pure scheduling bookkeeping, never folded into
      * `stateHash`/snapshot.
      */
     _flushSeenEpoch: number;
@@ -171,13 +170,17 @@ export declare class Archetype implements ArchetypeView {
      */
     private readonly batchTransitionMaps;
     /**
-     * Per-set add-edge cache for `Store.addComponents` (#659), keyed by an
+     * Per-set add-edge cache for `Store.addComponents`, keyed by an
      * exact pack of the added component ids. Lazily allocated: most archetypes
      * never originate a plural add, so the Map stays `null` until the first one
      * is resolved — the single-add `edges[]` path never touches it.
      */
     private compositeAddEdges;
     readonly _flatColumns: ColumnBacking<AnyTypedArray>[];
+    _bufs: AnyTypedArray[];
+    private _eids;
+    private _rowCap;
+    private _colCap;
     /** Set by `fromColumnStore` to record which SAB archetype this Archetype
      * draws its column views from. `null` for the default heap-backed path
      * (no SAB linkage; `refreshViews` would be a no-op there and so
@@ -196,9 +199,66 @@ export declare class Archetype implements ArchetypeView {
      * archetype during construction; `null` on heap-backed archetypes (the
      * default `GrowableTypedArray` grows in place). Insertion methods call
      * `_invoke_grow(...)` below before any push that would overflow the
-     * current SAB row capacity. (#171 §6.1.9 Phase 3) */
+     * current SAB row capacity. */
     growHandler: ArchetypeGrowHandler | null;
     constructor(id: ArchetypeID, mask: BitSet, layouts?: ArchetypeColumnLayout[], initialCapacity?: number, columnFactory?: ColumnFactory);
+    /** Re-derive the `_bufs` / `_eids` / `_rowCap` row plane from the backing
+     * columns. The sole writer of all three — see the `_bufs` field doc for the
+     * invariant it restores. Cold: construction, `refreshViews`, tail of a grow. */
+    private _syncRowPlane;
+    /** Re-point every cached `eachChunk` column group at the current `_bufs`.
+     *
+     * Called only from `_syncRowPlane`, which is the only thing that can change a
+     * column's buffer identity — so after this runs, a cached group is correct by
+     * construction and `columnGroupMut` / `columnGroupRead` need no staleness test
+     * at all. That absence is the point: those two run once per archetype per
+     * `eachChunk` pass, which for a fragmented query is once per chunk, and this
+     * file already carries one hard-won lesson (`_onArchLenChange`): one more
+     * statement pushed that per-mutation function past V8's inlining budget, and
+     * it became much slower. We measured two earlier forms of this optimisation
+     * and rejected both for the same cause. A fill through a shared helper made
+     * fragmented iteration slower, and an inline test for a stale buffer also made
+     * it slower. Each loss was larger than the gain in system dispatch. Move the
+     * work to the cold path, and the gain stays with no loss.
+     *
+     * Refreshes in place, preserving object identity, for the same reason
+     * `_syncRowPlane` refills `_bufs` in place: a caller that captured the group
+     * sees fresh buffers rather than silently stale ones. */
+    private _refreshGroupCaches;
+    /** DEV-only: assert the row plane still addresses the live buffers.
+     *
+     * `_bufs`/`_eids` and `_flatColumns[i].buf`/`_entityIds.buf` are two paths to
+     * one buffer, and only the first is cached — the row ops index the cache while
+     * `getColumnRead` / `writeFields` read `.buf` fresh. Anything that changes a
+     * buffer's identity owes a `_syncRowPlane`; miss one and the two paths split
+     * silently, with row writes landing in an orphan that later reads never see.
+     *
+     * Checked at the boundaries that read `.buf` directly, and O(1): index 0 alone
+     * is enough, because `_syncRowPlane` rewrites every entry together — there is
+     * no way to desync one column and not the first. */
+    private _assertRowPlaneFresh;
+    /** Make room for `additional` more rows, growing if the append would
+     * overflow. Replaces the `this.length >= cols[0].buf.length` probe the append
+     * paths each open-coded — that read a column object and its buffer's length
+     * on every single-row append; this is one compare against a cached number.
+     *
+     * Both backings are handled by `_growRows` so callers don't branch: a
+     * SAB-backed archetype delegates to the store's `growHandler` (realloc +
+     * republish, which re-enters `refreshViews`), a heap-backed one
+     * (`growHandler === null`, the unit-test factory) grows each column in place.
+     * Either way the buffers may have moved, so the row plane is re-synced before
+     * returning — including when the grow throws. */
+    private _reserveRows;
+    /** Cold half of `_reserveRows`: the append genuinely doesn't fit, so grow.
+     * Never called on the fast path — see the caller. */
+    private _growRows;
+    /** Push `Archetype.length` down into each column's own logical length (and
+     * the entity-id array's). The row plane keeps `length` authoritative and never
+     * touches `_len`, so the columns' view of it goes stale between publishes.
+     * Nothing on the ECS hot paths reads it; the boundaries that DO — a
+     * reallocating `ensureCapacity`, `refreshView`'s shrink check, `view()` —
+     * publish first. */
+    private _publishRowCounts;
     /**
      * Build an Archetype whose columns are TypedArray views into a single
      * `ColumnStore`-managed `SharedArrayBuffer`. The store must contain an
@@ -208,7 +268,7 @@ export declare class Archetype implements ArchetypeView {
      * The resulting archetype is fixed-capacity at the SAB row capacity —
      * any operation that would push past it throws `StoreColumnOverflowError`.
      * To grow capacity, call `growColumnStore(...)` between ticks and then
-     * `refreshViews(newStore)` on this archetype (#171 §6.1.4 / §8.1).
+     * `refreshViews(newStore)` on this archetype.
      */
     static fromColumnStore(id: ArchetypeID, mask: BitSet, layouts: ArchetypeColumnLayout[], columnStore: ColumnStore, storeArchetypeId: number): Archetype;
     /** True iff this archetype was constructed via `fromColumnStore` and its
@@ -228,7 +288,7 @@ export declare class Archetype implements ArchetypeView {
      * expects.
      */
     refreshViews(newColumnStore: ColumnStore): void;
-    /** Enabled-row count — the default iteration bound (#577). See `enabled_count`.
+    /** Enabled-row count — the default iteration bound. See `enabled_count`.
      * Equals `length` whenever no entity is disabled (the common case).
      *
      * During an `includeDisabled()` query's `forEach`, the module flag
@@ -237,9 +297,9 @@ export declare class Archetype implements ArchetypeView {
      * transparently, with no change to the loop. Outside such iteration the flag is
      * false and this is `enabled_count`. */
     get entityCount(): number;
-    /** Total live rows incl. disabled (#577). */
+    /** Total live rows incl. disabled. */
     get totalCount(): number;
-    /** Disabled-row count (#577). */
+    /** Disabled-row count. */
     get disabledCount(): number;
     /** Raw entity ID buffer (packed `EntityID`s). Valid data at indices
      * 0..totalCount-1 (enabled rows first, then disabled). */
@@ -250,7 +310,7 @@ export declare class Archetype implements ArchetypeView {
      * cares about (it knows the two `entityIds` after the swap). The partition
      * primitives (`disableRow`/`enableRow`/`removeRow`/`_placeTail`) build on
      * this. Writes through each column's live backing buffer (`buf`), so it works
-     * for both heap- and SAB-backed columns. No-op when `a === b`. (#577) */
+     * for both heap- and SAB-backed columns. No-op when `a === b`. */
     swapRows(a: number, b: number): void;
     /**
      * Place a freshly-appended ENABLED entity (currently at the tail row `tail`,
@@ -259,11 +319,11 @@ export declare class Archetype implements ArchetypeView {
      *
      * Common case — no disabled rows (`enabled_count === tail`): the tail row IS
      * the next enabled slot, so this is just `enabled_count++` and returns `tail`
-     * (byte-for-byte the pre-#577 behaviour, `entityRow` untouched). Rare case —
+     * (byte-for-byte the earlier behaviour, `entityRow` untouched). Rare case —
      * disabled rows occupy `[enabled_count, tail)`: swap the appended row into the
      * first disabled slot and push that disabled occupant to the tail, updating
      * its `entityRow`. Requires `entityRow` in that case (a `DEV` guard fires
-     * if a caller appends into a disabled-bearing archetype without passing it). (#577) */
+     * if a caller appends into a disabled-bearing archetype without passing it). */
     private _placeTail;
     /**
      * Bulk analog of `_placeTail` for `count` freshly-appended enabled rows at
@@ -271,21 +331,21 @@ export declare class Archetype implements ArchetypeView {
      * start`): `enabled_count += count`, return `start`. The bulk callers
      * (`spawnMany`, batch ops) fall back to a per-entity append loop when the
      * target already has disabled rows, so the rare branch is a `DEV` guard
-     * rather than a block-rotation. (#577) */
+     * rather than a block-rotation. */
     private _placeTailBulk;
     /**
      * Disable the entity at `row` (precondition: enabled, `row < enabled_count`).
      * Swaps it to the end of the enabled region and shrinks the region, so it
      * lands in the disabled tail with its data intact — no archetype transition,
-     * O(1)+one row swap. Updates `entityRow` for both rows touched. (#577) */
+     * O(1)+one row swap. Updates `entityRow` for both rows touched. */
     disableRow(row: number, entityRow: Int32Array): void;
     /**
      * Enable the entity at `row` (precondition: disabled, `row >= enabled_count`).
      * Swaps it to the front of the disabled region and grows the enabled region.
-     * Updates `entityRow` for both rows touched. (#577) */
+     * Updates `entityRow` for both rows touched. */
     enableRow(row: number, entityRow: Int32Array): void;
     /**
-     * Partition-aware swap-remove that owns its `entityRow` updates (#577). The
+     * Partition-aware swap-remove that owns its `entityRow` updates. The
      * Store's destroy/move paths call this instead of `removeEntity`; it keeps the
      * enabled prefix contiguous in every case:
      *  - disabled row (`row >= enabled_count`): swap-remove within the disabled
@@ -297,9 +357,9 @@ export declare class Archetype implements ArchetypeView {
      * Updates `entityRow` for every relocated entity (never for the removed one —
      * the caller frees/repoints it). */
     removeRow(row: number, entityRow: Int32Array): void;
-    /** @internal — cold partition-aware tail of `removeRow` (#577): the
+    /** @internal — cold partition-aware tail of `removeRow`: the
      * disabled-bearing archetype case. Split out so the no-disabled fast path
-     * above stays small enough to inline (#649); see the doc on `removeRow`. */
+     * above stays small enough to inline; see the doc on `removeRow`. */
     private _removeRowPartitioned;
     get entityList(): Uint32Array;
     hasComponent(id: ComponentID): boolean;
@@ -309,7 +369,7 @@ export declare class Archetype implements ArchetypeView {
      * data: indices 0..entityCount-1. The `ReadonlyColumn` return is an
      * *advisory* compile-time barrier: it is the live mutable backing buffer,
      * so the `readonly` index signature blocks writes at the type layer only
-     * (a §10c-policed cast can still write through). For writes use the
+     * (a deliberate cast can still write through). For writes use the
      * mutable `getColumn` (tick-bumping) below.
      */
     getColumnRead<S extends ComponentSchema, K extends string & keyof S>(def: ComponentDef<S>, field: K): ReadonlyColumn;
@@ -326,8 +386,8 @@ export declare class Archetype implements ArchetypeView {
     };
     /**
      * Get a single field's column **if this archetype has the component**, else
-     * `undefined` — the fetch-if-present accessor for optional query terms (#575,
-     * Bevy `Option<&T>` / flecs `?`). An optional query (`q.optional(T)`) spans
+     * `undefined` — the fetch-if-present accessor for optional query terms
+     * (Bevy `Option<&T>` / flecs `?`). An optional query (`q.optional(T)`) spans
      * archetypes both with and without `T`; the caller branches once per
      * archetype span on the return:
      *
@@ -344,7 +404,7 @@ export declare class Archetype implements ArchetypeView {
      * depend on whether the current span happens to hold `T`. Two checks fire:
      * (1) `accessCheck.checkRead` — an optional read needs `reads:[T]` coverage
      * exactly as a required read does; (2) `accessCheck.checkOptionalFetch` —
-     * the iterating query must have declared `.optional(T)` (#592), the read-side
+     * the iterating query must have declared `.optional(T)`, the read-side
      * analog that makes the query term the fetch's authorization rather than inert
      * decoration. The return is the same advisory-readonly view `getColumnRead`
      * hands back.
@@ -389,9 +449,9 @@ export declare class Archetype implements ArchetypeView {
      * starting dstRow for the batch. Caller is responsible for tracking
      * entityIndex → row for every entity in the batch.
      *
-     * Collapses the N×C `push(0)` cost of N sequential `addEntity` calls
-     * into C `bulkAppendZeroes(count)` calls — the same pattern
-     * `bulkMoveAllFrom` (`:580`) uses for the move-with-data case (#330).
+     * Collapses the N×C per-element cost of N sequential `addEntity` calls into
+     * C `fill` calls, one for each column — the same pattern `bulkMoveAllFrom`
+     * uses for the move-with-data case.
      */
     addEntities(entityIds: Uint32Array, count?: number): number;
     /** Tag-optimized bulk add: skip the per-column zero-fill entirely. */
@@ -401,8 +461,8 @@ export declare class Archetype implements ArchetypeView {
      * `addEntitiesWithValues` appends run internally, lifted out so the spawn
      * path can pre-reserve capacity BEFORE it commits an entity slot. A SAB-cap
      * grow throws here (with the world untouched) instead of mid-append after the
-     * slot is already live — see `Store.spawn`/`spawnMany` (#775). No-op for a
-     * tag-only archetype (no SAB columns) or when no grow handler is installed. */
+     * slot is already live — see `Store.spawn`/`spawnMany`. Now just the
+     * public name for `_reserveRows`, which every append path shares. */
     ensureRowCapacity(additional: number): void;
     /** Append one entity, writing `flatValues[i]` straight into column `i`
      * (in `_flatColumns` order) — no zero-fill-then-overwrite. Bumps every
@@ -424,7 +484,7 @@ export declare class Archetype implements ArchetypeView {
     /**
      * Move an entity from src into this archetype (tag-only: no columns to copy).
      * Writes dstRow to _moveResult[0]; _moveResult[1] is always NO_SWAP (the
-     * partition-aware src/dst updates are owned internally, #577).
+     * partition-aware src/dst updates are owned internally).
      */
     moveEntityFromTag(src: Archetype, srcRow: number, entityId: EntityID, entityRow: Int32Array): void;
     /**
@@ -444,7 +504,7 @@ export declare class Archetype implements ArchetypeView {
     clearRows(): void;
     /**
      * Re-derive the host-side row bookkeeping after a snapshot is mounted onto a
-     * live world (#789, `Store.restoreInto`). A snapshot reloads the column bytes
+     * live world (`Store.restoreInto`). A snapshot reloads the column bytes
      * (dense SAB) but NOT the host-side `length` / `enabledCount` / `_entityIds`
      * back-reference — those are reconstructed here. `refreshViews` must have
      * already repointed the columns at the restored SAB.
@@ -452,7 +512,7 @@ export declare class Archetype implements ArchetypeView {
      * The caller scans the restored entity-index region to learn which entity
      * occupies each row and passes them in row order (`rowEntityIds[r]` is the
      * packed `EntityID` at row `r`; rows `[0, length)` are dense, enabled rows
-     * first then disabled per the #577 partition). `enabledCount` is the restored
+     * first then disabled per the partition). `enabledCount` is the restored
      * partition boundary. This is the inverse of the per-row `addEntity` /
      * `disableRow` bookkeeping the live run accumulated.
      */
@@ -465,12 +525,12 @@ export declare class Archetype implements ArchetypeView {
      * cache only covers single-component steps.
      */
     getBatchTransitionMap(target: Archetype): Int16Array;
-    /** Look up a cached plural-add transition by its packed key (#659). Returns
+    /** Look up a cached plural-add transition by its packed key. Returns
      * `undefined` until the first composite add out of this archetype plants the
      * lazy Map — the common case for archetypes that only ever see single adds. */
     getCompositeAddEdge(key: number): CompositeAddEdge | undefined;
     /** Cache a resolved plural-add transition (target + src→target map) under its
-     * packed key (#659), allocating the backing Map on first use. */
+     * packed key, allocating the backing Map on first use. */
     cacheCompositeAddEdge(key: number, target: ArchetypeID, map: Int16Array): void;
 }
 /** Reusable result buffer for move_entity_from/move_entity_from_tag. [dstRow, swapped_index] */

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

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

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

@@ -14,7 +14,7 @@ export interface ArchetypeGraphHost {
     /** Row capacity for a new archetype's column region. */
     readonly initialCapacity: () => number;
     /** Extend the SAB with the new archetypes' column regions (one call for
-     * the whole batch — the bulk path's O(N²)→O(N) win, #213). */
+     * the whole batch — the bulk path's O(N²)→O(N) win). */
     readonly extendStore: (specs: ArchetypeSpec[]) => void;
     /** Materialise the `Archetype` over the live column store and attach the
      * store's grow handler. */
@@ -34,7 +34,7 @@ export declare class ArchetypeGraph {
      * superset scan from the smallest bucket. Each bucket is a plain push-only
      * array — NOT a Set — and deliberately does NOT dedup: a (component,
      * archetype) pair can be inserted here at most once (see the "no duplicate
-     * pair" invariant on `install` + ADR-0015), so there is nothing for a Set
+     * pair" invariant on `install`), so there is nothing for a Set
      * to collapse. Archetypes are never removed from a Store, so buckets only
      * grow, in ascending archetype-id order — which is canonical order,
      * exploited by `_forEachChangedArchetype` to skip a sort. */
@@ -48,21 +48,21 @@ export declare class ArchetypeGraph {
      * Find or create an archetype for the given component mask.
      * Also updates the componentIndex and pushes into matching registered queries.
      *
-     * Hot single-mask path. The bulk batched variant — used by Phase C
-     * pre-warming at `ecs.startup()` — is `createManyFromMasks`;
-     * see #213 / `ECS.startup()` for how it gets called and why.
+     * Hot single-mask path. The bulk batched variant — used by the prewarm
+     * pass at `ecs.startup()` — is `createManyFromMasks`;
+     * see `ECS.startup()` for how it gets called and why.
      */
     getOrCreateFromMask(mask: BitSet): ArchetypeID;
     /**
-     * Bulk variant of `getOrCreateFromMask` — Phase C of issue #213.
+     * Bulk variant of `getOrCreateFromMask` — the archetype prewarm pass.
      *
      * Given a set of masks, creates Archetypes for the ones not already
      * planted, in a SINGLE `extendColumnStore` call (instead of one per
      * archetype). Single-mask creation is O(N) in archetypes-so-far because
      * the extend has to copy every existing archetype's live rows forward;
      * N such calls compound to O(N²). Batching collapses the per-archetype
-     * setup-and-copy down to one pass — the per-startup cost the design doc
-     * §5.2 calls out as "O(N²) → O(N)" for in-tree systems whose archetype
+     * setup-and-copy down to one pass — the per-startup cost goes from
+     * O(N²) to O(N) for in-tree systems whose archetype
      * set is known at registration time via `spawns` + `transitions`.
      *
      * Masks already in the map are skipped. Returns the resolved

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

@@ -14,7 +14,7 @@ export interface ArchetypeGraphHost {
     /** Row capacity for a new archetype's column region. */
     readonly initialCapacity: () => number;
     /** Extend the SAB with the new archetypes' column regions (one call for
-     * the whole batch — the bulk path's O(N²)→O(N) win, #213). */
+     * the whole batch — the bulk path's O(N²)→O(N) win). */
     readonly extendStore: (specs: ArchetypeSpec[]) => void;
     /** Materialise the `Archetype` over the live column store and attach the
      * store's grow handler. */
@@ -34,7 +34,7 @@ export declare class ArchetypeGraph {
      * superset scan from the smallest bucket. Each bucket is a plain push-only
      * array — NOT a Set — and deliberately does NOT dedup: a (component,
      * archetype) pair can be inserted here at most once (see the "no duplicate
-     * pair" invariant on `install` + ADR-0015), so there is nothing for a Set
+     * pair" invariant on `install`), so there is nothing for a Set
      * to collapse. Archetypes are never removed from a Store, so buckets only
      * grow, in ascending archetype-id order — which is canonical order,
      * exploited by `_forEachChangedArchetype` to skip a sort. */
@@ -48,21 +48,21 @@ export declare class ArchetypeGraph {
      * Find or create an archetype for the given component mask.
      * Also updates the componentIndex and pushes into matching registered queries.
      *
-     * Hot single-mask path. The bulk batched variant — used by Phase C
-     * pre-warming at `ecs.startup()` — is `createManyFromMasks`;
-     * see #213 / `ECS.startup()` for how it gets called and why.
+     * Hot single-mask path. The bulk batched variant — used by the prewarm
+     * pass at `ecs.startup()` — is `createManyFromMasks`;
+     * see `ECS.startup()` for how it gets called and why.
      */
     getOrCreateFromMask(mask: BitSet): ArchetypeID;
     /**
-     * Bulk variant of `getOrCreateFromMask` — Phase C of issue #213.
+     * Bulk variant of `getOrCreateFromMask` — the archetype prewarm pass.
      *
      * Given a set of masks, creates Archetypes for the ones not already
      * planted, in a SINGLE `extendColumnStore` call (instead of one per
      * archetype). Single-mask creation is O(N) in archetypes-so-far because
      * the extend has to copy every existing archetype's live rows forward;
      * N such calls compound to O(N²). Batching collapses the per-archetype
-     * setup-and-copy down to one pass — the per-startup cost the design doc
-     * §5.2 calls out as "O(N²) → O(N)" for in-tree systems whose archetype
+     * setup-and-copy down to one pass — the per-startup cost goes from
+     * O(N²) to O(N) for in-tree systems whose archetype
      * set is known at registration time via `spawns` + `transitions`.
      *
      * Masks already in the map are skipped. Returns the resolved

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

@@ -1 +1 @@
-{"version":3,"file":"archetype_graph.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/archetype_graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAsB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EACN,SAAS,EAGT,KAAK,qBAAqB,EAE1B,KAAK,WAAW,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,OAAO,EAGN,KAAK,aAAa,EAElB,MAAM,UAAU,CAAC;AAGlB;;;4EAG4E;AAC5E,MAAM,WAAW,kBAAkB;IAClC;qCACiC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,SAAS,aAAa,EAAE,CAAC;IACxD,wDAAwD;IACxD,QAAQ,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC;IACvC;kEAC8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IACvD;+BAC2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,CACrB,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,EAAE,KAC5B,SAAS,CAAC;IACf;6BACyB;IACzB,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,qBAAa,cAAc;IAC1B;8EAC0E;IAC1E,SAAgB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7C;;;;;;;;;;iEAU6D;IAC7D,SAAgB,cAAc,EAAE,WAAW,EAAE,EAAE,CAAM;IAErD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,eAAe,CAAK;IAE5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAE9B,IAAI,EAAE,kBAAkB;IAI7B,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS;IAStC;;;;;;;OAOG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAkBrD;;;;;;;;;;;;;;;OAeG;IACI,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE;IA4DnE,iFAAiF;IACjF,OAAO,CAAC,MAAM;IASd;sEACkE;IAClE,OAAO,CAAC,YAAY;IAkBpB;;;;;;;;;yEASqE;IACrE,OAAO,CAAC,OAAO;IA0Df,wFAAwF;IACjF,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,WAAW;IAYlF,6FAA6F;IACtF,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,WAAW;IAYrF,oEAAoE;IACpE,OAAO,CAAC,SAAS;CAuBjB"}
+{"version":3,"file":"archetype_graph.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/archetype_graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAsB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EACN,SAAS,EAGT,KAAK,qBAAqB,EAE1B,KAAK,WAAW,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,OAAO,EAGN,KAAK,aAAa,EAElB,MAAM,UAAU,CAAC;AAGlB;;;4EAG4E;AAC5E,MAAM,WAAW,kBAAkB;IAClC;qCACiC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,SAAS,aAAa,EAAE,CAAC;IACxD,wDAAwD;IACxD,QAAQ,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC;IACvC;4DACwD;IACxD,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IACvD;+BAC2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,CACrB,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,EAAE,KAC5B,SAAS,CAAC;IACf;6BACyB;IACzB,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,qBAAa,cAAc;IAC1B;8EAC0E;IAC1E,SAAgB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7C;;;;;;;;;;iEAU6D;IAC7D,SAAgB,cAAc,EAAE,WAAW,EAAE,EAAE,CAAM;IAErD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,eAAe,CAAK;IAE5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAE9B,IAAI,EAAE,kBAAkB;IAI7B,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS;IAStC;;;;;;;OAOG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAkBrD;;;;;;;;;;;;;;;OAeG;IACI,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE;IA4DnE,iFAAiF;IACjF,OAAO,CAAC,MAAM;IASd;sEACkE;IAClE,OAAO,CAAC,YAAY;IAkBpB;;;;;;;;;yEASqE;IACrE,OAAO,CAAC,OAAO;IA0Df,wFAAwF;IACjF,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,WAAW;IAYlF,6FAA6F;IACtF,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,WAAW;IAYrF,oEAAoE;IACpE,OAAO,CAAC,SAAS;CAuBjB"}

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

@@ -16,7 +16,7 @@ export interface BuiltinRelationOptions {
  *   `ecs.relations.ancestorsOf(instance, IsA)` / `rootOf` / `cascadeOf(exemplar, IsA)`.
  * - **No component inheritance** — IsA records the link only; materialization of
  *   an instance from its exemplar stays a spawn-time copy (the template path,
- *   #462), deliberately decoupled (#477 / #478). An exemplar is a real entity,
+ *   deliberately decoupled. An exemplar is a real entity,
  *   not a `Template` (a non-entity template can't be a relation target).
  *
  * Default `onDeleteTarget: "clear"` — destroying an exemplar drops its

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

@@ -16,7 +16,7 @@ export interface BuiltinRelationOptions {
  *   `ecs.relations.ancestorsOf(instance, IsA)` / `rootOf` / `cascadeOf(exemplar, IsA)`.
  * - **No component inheritance** — IsA records the link only; materialization of
  *   an instance from its exemplar stays a spawn-time copy (the template path,
- *   #462), deliberately decoupled (#477 / #478). An exemplar is a real entity,
+ *   deliberately decoupled. An exemplar is a real entity,
  *   not a `Template` (a non-entity template can't be a relation target).
  *
  * Default `onDeleteTarget: "clear"` — destroying an exemplar drops its

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

@@ -85,14 +85,14 @@ export interface ReplayResult {
     readonly ticks: number;
     /** Per-tick `stateHash` captured after each `update`, in tick order — empty
      * unless the world is deterministic (or `hash` was forced). Compare against
-     * the original run's per-tick hashes to prove the replay matched (ADR-0020). */
+     * the original run's per-tick hashes to prove the replay matched. */
     readonly stateHashes: readonly number[];
 }
 /** Options for {@link replayCommandLog}. */
 export interface ReplayOptions {
     /** Capture `ecs.snapshots.stateHash()` after each tick. Defaults to the world's
      * `deterministic` flag — a deterministic world is hashed, a non-deterministic
-     * one is not (its `stateHash` would throw, ADR-0020). Force `true` only on a
+     * one is not (its `stateHash` would throw). Force `true` only on a
      * deterministic world. */
     readonly hash?: boolean;
 }
@@ -106,9 +106,9 @@ export interface ReplayOptions {
  * (which drains them at PRE_STARTUP), then for each recorded tick enqueues that
  * tick's commands and calls `ecs.update(dt)` with the recorded `dt`.
  *
- * Determinism (ADR-0020): with `{ deterministic: true }` the per-tick
+ * Determinism: with `{ deterministic: true }` the per-tick
  * `stateHashes` this returns must equal the original run's — that equality is
- * replay fidelity. Identity caveat (§85): a despawned-then-respawned entity gets
+ * replay fidelity. Identity caveat: a despawned-then-respawned entity gets
  * a fresh id, but because spawn order is reproduced, every recorded id still
  * resolves to the same entity on replay.
  */

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

@@ -85,14 +85,14 @@ export interface ReplayResult {
     readonly ticks: number;
     /** Per-tick `stateHash` captured after each `update`, in tick order — empty
      * unless the world is deterministic (or `hash` was forced). Compare against
-     * the original run's per-tick hashes to prove the replay matched (ADR-0020). */
+     * the original run's per-tick hashes to prove the replay matched. */
     readonly stateHashes: readonly number[];
 }
 /** Options for {@link replayCommandLog}. */
 export interface ReplayOptions {
     /** Capture `ecs.snapshots.stateHash()` after each tick. Defaults to the world's
      * `deterministic` flag — a deterministic world is hashed, a non-deterministic
-     * one is not (its `stateHash` would throw, ADR-0020). Force `true` only on a
+     * one is not (its `stateHash` would throw). Force `true` only on a
      * deterministic world. */
     readonly hash?: boolean;
 }
@@ -106,9 +106,9 @@ export interface ReplayOptions {
  * (which drains them at PRE_STARTUP), then for each recorded tick enqueues that
  * tick's commands and calls `ecs.update(dt)` with the recorded `dt`.
  *
- * Determinism (ADR-0020): with `{ deterministic: true }` the per-tick
+ * Determinism: with `{ deterministic: true }` the per-tick
  * `stateHashes` this returns must equal the original run's — that equality is
- * replay fidelity. Identity caveat (§85): a despawned-then-respawned entity gets
+ * replay fidelity. Identity caveat: a despawned-then-respawned entity gets
  * a fresh id, but because spawn order is reproduced, every recorded id still
  * resolves to the same entity on replay.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"command_log.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/command_log.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;2EAG2E;AAC3E,MAAM,WAAW,YAAY;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;+BAC2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAC1B;;iEAE6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;2EACuE;IACvE,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAiBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IAC1D,iEAAiE;IACjE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C;4EACwE;IACxE,OAAO,CAAC,IAAI,CAAgC;gBAEhC,IAAI,SAAI;IAIpB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxC,QAAQ,CAAC,MAAM,QAAS,WAAW,KAAG,IAAI,CAExC;IAEF;;4EAEwE;IACxE,GAAG,IAAI,UAAU;IAIjB;mFAC+E;IAC/E,WAAW,IAAI,UAAU;CAOzB;AAYD;;;;;;;;;gFASgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAqB3D;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAW9D;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;oFAEgF;IAChF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC7B;;;8BAG0B;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,aAAa,GAClB,YAAY,CAcd"}
+{"version":3,"file":"command_log.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/command_log.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;2EAG2E;AAC3E,MAAM,WAAW,YAAY;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;+BAC2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAC1B;;iEAE6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;2EACuE;IACvE,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAiBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IAC1D,iEAAiE;IACjE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C;4EACwE;IACxE,OAAO,CAAC,IAAI,CAAgC;gBAEhC,IAAI,SAAI;IAIpB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxC,QAAQ,CAAC,MAAM,QAAS,WAAW,KAAG,IAAI,CAExC;IAEF;;4EAEwE;IACxE,GAAG,IAAI,UAAU;IAIjB;mFAC+E;IAC/E,WAAW,IAAI,UAAU;CAOzB;AAYD;;;;;;;;;gFASgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAqB3D;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAW9D;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;yEAEqE;IACrE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC7B;;;8BAG0B;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,aAAa,GAClB,YAAY,CAcd"}

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

@@ -99,8 +99,8 @@ export interface ComponentDef<S extends ComponentSchema = ComponentSchema> {
 export type SchemaOf<D> = D extends ComponentDef<infer S extends ComponentSchema> ? S : never;
 /**
  * `unknown` if `D` is one of the query's declared terms, else an error tuple —
- * the query-seam sibling of system.ts's `DeclaredRead` (§typestate,
- * POLISH_AUDIT #6). `Query.eachChunk`'s cursor and `ArchetypeView`'s column
+ * the query-seam sibling of system.ts's `DeclaredRead` (§typestate).
+ * `Query.eachChunk`'s cursor and `ArchetypeView`'s column
  * accessors intersect this into their `def` parameter so fetching a component
  * that is NOT a term of the iterating query fails to compile (previously
  * caught only by the dev-mode access check, and only when the system's
@@ -133,7 +133,7 @@ export type ComponentHandle = {
  * returned function produces a `Bundle` when called (`Pos({x,y})`) and carries
  * its numeric id on a non-enumerable `.id` (invisible to spreads / `JSON`).
  * The single cast bridges the function value to the branded handle type — the
- * `.id` is installed at runtime by `defineProperty` (§10c branded-ID boundary).
+ * `.id` is installed at runtime by `defineProperty` (the branded-ID boundary).
  */
 export declare function makeComponentDef<S extends ComponentSchema>(id: ComponentID): ComponentDef<S>;
 export interface Bundle<S extends ComponentSchema = ComponentSchema> {
@@ -180,7 +180,7 @@ export declare function bundleValues(item: BundleOrDef): Readonly<Record<string,
  *
  * **Advisory, not a runtime barrier:** the value behind this type is the live
  * mutable backing `TypedArray` (`Archetype.getColumnRead` returns
- * `.buf as unknown as ReadonlyColumn`), so a §10c-policed cast can still write
+ * `.buf as unknown as ReadonlyColumn`), so a deliberate cast can still write
  * through. For mutation use the mutable `Archetype.getColumn` (tick-bumping).
  * Enforced by the escape-hatch lint, not the runtime.
  */