@ecsia/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andy Aragon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @ecsia/core
+
+The single-threaded kernel of [**ecsia**](https://github.com/andymai/ecsia) — a fast,
+type-safe Entity Component System for TypeScript.
+
+`@ecsia/core` provides archetype/SoA tables, a serial-only per-entity bitmask membership
+index, monomorphic typed accessors, live queries, and reactivity. It runs standalone; the
+opt-in `@ecsia/scheduler`, `@ecsia/relations`, and `@ecsia/serialization` layers attach to a
+world through injected seams (the dependency graph is acyclic).
+
+> **Status:** 0.1.0, unpublished. Most users want the umbrella package
+> [`ecsia`](https://www.npmjs.com/package/ecsia), which re-exports the whole cohesive
+> surface and tree-shakes what you don't touch. Reach for `@ecsia/core` directly only when
+> you want the kernel without the scheduler/serialization layers.
+
+## Install
+
+```sh
+pnpm add @ecsia/core   # not yet published — local workspace for now
+```
+
+## Links
+
+- Repository & full docs: https://github.com/andymai/ecsia
+- Umbrella package: [`ecsia`](https://github.com/andymai/ecsia)
+
+## License
+
+[MIT](./LICENSE) © Andy Aragon

package/dist/bitmask/bitmask.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentId } from '@ecsia/schema';
+import type { Buffers } from '../memory/index.js';
+import type { Signature } from '../storage/signature.js';
+/** Main-thread / serial-phase gate. Workers establish membership from the archetype signature. */
+export type PhaseGate = () => 'serial' | 'wave';
+export declare class Bitmask {
+    #private;
+    constructor(buffers: Buffers, componentCount: number, maxEntities: number, phase: PhaseGate);
+    get stride(): number;
+    /** O(1) membership point test for a single entity index. */
+    bitmaskHas(index: number, c: ComponentId): boolean;
+    /** Coherence with the table: set added bits, clear removed bits, after a serial migration. */
+    bitmaskApplyDelta(index: number, fromSig: Signature, toSig: Signature): void;
+    /** Clear all of an entity's membership words on despawn. O(stride). */
+    bitmaskClear(index: number): void;
+    /** Zero-copy view of one entity's fixed-stride shape words (for the single-entity matcher ). */
+    entityShapeWords(index: number): Uint32Array;
+    /** Re-publish the region view after a fallback grow (the region length-tracks on the primary path). */
+    rebind(): void;
+}
+//# sourceMappingURL=bitmask.d.ts.map

package/dist/bitmask/bitmask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmask.d.ts","sourceRoot":"","sources":["../../src/bitmask/bitmask.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAKxD,kGAAkG;AAClG,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE/C,qBAAa,OAAO;;gBAUN,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;IAe3F,IAAI,MAAM,IAAI,MAAM,CAEnB;IAWD,4DAA4D;IAC5D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO;IAOlD,8FAA8F;IAC9F,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAsB5E,uEAAuE;IACvE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC,gGAAgG;IAChG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAK5C,uGAAuG;IACvG,MAAM,IAAI,IAAI;CAYf"}

package/dist/bitmask/bitmask.js

@@ -0,0 +1,103 @@
+// The per-entity bitmask membership index. MAIN-THREAD / SERIAL-ONLY:
+// every read and write asserts world.phase === 'serial' (Invariant). It is the
+// O(1) entity.has(C) point-test substrate and the single-entity incremental query matcher — NOT
+// the iteration path (that is per-archetype). Coherence with the archetype tables is one-way:
+// bitmaskApplyDelta refreshes it immediately after each serial migration commit.
+//
+// Layout: bitmask.words is a u32 region of length capacity*stride, addressed by ENTITY INDEX (low
+// handle bits, stable across swap-pop). stride = ceil(N/32) where N = registered component-type
+// count ( C4). Pair ids beyond the fixed stride live in a lazily-grown sparse vector.
+import { sigHas } from '../storage/signature.js';
+const BITMASK_REGION_KEY = 'bitmask.words';
+export class Bitmask {
+    #region;
+    #words;
+    #stride;
+    /** Fixed bit count covered by the dense words; ids at/above this use the sparse vector. */
+    #fixedBitCount;
+    #phase;
+    /** Out-of-stride pair bits, lazily grown per entity index (unbounded pair-id space). */
+    #sparse = new Map();
+    constructor(buffers, componentCount, maxEntities, phase) {
+        // stride = ceil(N/32) exactly per ( C4). N (registered component count) is always >= 1
+        // (FIRST_USER_COMPONENT_ID), so this is >= 1 without a max(1,...) floor; ids beyond fixedBitCount
+        // fall through to the sparse vector. The backing region reserves at least one word so a
+        // degenerate N=0 world still has a valid (length-tracking) allocation.
+        this.#stride = Math.ceil(componentCount / 32);
+        this.#fixedBitCount = this.#stride * 32;
+        this.#phase = phase;
+        const regionWords = Math.max(1, maxEntities * this.#stride);
+        this.#region = buffers.region(BITMASK_REGION_KEY, 'u32', regionWords, {
+            maxLength: regionWords,
+        });
+        this.#words = this.#region.view;
+    }
+    get stride() {
+        return this.#stride;
+    }
+    #assertSerial() {
+        if (this.#phase() !== 'serial') {
+            throw new Error('component bitmask access is main-thread / serial-phase only; perform structural reads or mutations ' +
+                'outside worker waves (before scheduler.update() or in a serial system), not from a worker-wave system');
+        }
+    }
+    /** O(1) membership point test for a single entity index. */
+    bitmaskHas(index, c) {
+        this.#assertSerial();
+        const cid = c;
+        if (cid >= this.#fixedBitCount)
+            return this.#sparse.get(index)?.has(cid) ?? false;
+        return (this.#words[index * this.#stride + (cid >>> 5)] & (1 << (cid & 31))) !== 0;
+    }
+    /** Coherence with the table: set added bits, clear removed bits, after a serial migration. */
+    bitmaskApplyDelta(index, fromSig, toSig) {
+        this.#assertSerial();
+        const base = index * this.#stride;
+        for (let i = 0; i < toSig.length; i++) {
+            const c = toSig[i];
+            if (c < this.#fixedBitCount) {
+                this.#words[base + (c >>> 5)] = (this.#words[base + (c >>> 5)] | (1 << (c & 31))) >>> 0;
+            }
+            else {
+                this.#sparseSet(index, c);
+            }
+        }
+        for (let i = 0; i < fromSig.length; i++) {
+            const c = fromSig[i];
+            if (sigHas(toSig, c))
+                continue;
+            if (c < this.#fixedBitCount) {
+                this.#words[base + (c >>> 5)] = (this.#words[base + (c >>> 5)] & ~(1 << (c & 31))) >>> 0;
+            }
+            else {
+                this.#sparse.get(index)?.delete(c);
+            }
+        }
+    }
+    /** Clear all of an entity's membership words on despawn. O(stride). */
+    bitmaskClear(index) {
+        this.#assertSerial();
+        const base = index * this.#stride;
+        for (let w = 0; w < this.#stride; w++)
+            this.#words[base + w] = 0;
+        this.#sparse.delete(index);
+    }
+    /** Zero-copy view of one entity's fixed-stride shape words (for the single-entity matcher ). */
+    entityShapeWords(index) {
+        this.#assertSerial();
+        return this.#words.subarray(index * this.#stride, index * this.#stride + this.#stride);
+    }
+    /** Re-publish the region view after a fallback grow (the region length-tracks on the primary path). */
+    rebind() {
+        this.#words = this.#region.view;
+    }
+    #sparseSet(index, c) {
+        let s = this.#sparse.get(index);
+        if (s === undefined) {
+            s = new Set();
+            this.#sparse.set(index, s);
+        }
+        s.add(c);
+    }
+}
+//# sourceMappingURL=bitmask.js.map

package/dist/bitmask/bitmask.js.map

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

package/dist/bitmask/index.d.ts

@@ -0,0 +1,3 @@
+export { Bitmask } from './bitmask.js';
+export type { PhaseGate } from './bitmask.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bitmask/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bitmask/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/bitmask/index.js

@@ -0,0 +1,2 @@
+export { Bitmask } from './bitmask.js';
+//# sourceMappingURL=index.js.map

package/dist/bitmask/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bitmask/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/component/accessor.d.ts

@@ -0,0 +1,40 @@
+import type { AccessorFactory, ColumnBinding, ComponentDef, ComponentId, EntityHandle, Schema } from '@ecsia/schema';
+import type { Backing, ColumnLayout, TypedArray } from '../memory/index.js';
+import { columnKey } from '../memory/index.js';
+import type { SidecarKey } from './sidecar.js';
+export interface AccessorWorld {
+    trackWrite(index: number, componentId: ComponentId, fieldIndex?: number): void;
+    handleIndex(handle: EntityHandle): number;
+    readonly tracking: {
+        readonly active: boolean;
+    };
+    sidecarRead(key: SidecarKey, index: number, gen: number): unknown;
+    sidecarWrite(key: SidecarKey, index: number, gen: number, value: unknown): void;
+    /** Low generationBits of the live handle at `index` — the RF-HYGIENE stamp source. */
+    generationOf(index: number): number;
+}
+export interface AccessorBinding {
+    readonly world: AccessorWorld;
+    readonly componentId: ComponentId;
+}
+export interface AccessorInstanceBase {
+    __idx: number;
+    __eid: EntityHandle;
+    __binding: AccessorBinding | null;
+    __rebind(newBacking: Backing): void;
+    /**
+     * Fallback-grow rebind for ONE column. Each column-bearing field owns a SEPARATE backing buffer
+     * (one `buffers.column` per field), so a fallback grow re-points exactly that field's view. A
+     * whole-instance `__rebind` would alias every field onto the single grown backing (corrupting the
+     * other fields' columns); the buffers layer always targets the field that actually grew.
+     */
+    __rebindField(fieldIndex: number, newBacking: Backing): void;
+}
+export declare function bindingsFor(columns: ReadonlyArray<{
+    view: TypedArray;
+    layout: ColumnLayout;
+}>): ColumnBinding[];
+export declare function makeAccessorFactory<S extends Schema>(def: ComponentDef<S>): AccessorFactory<S>;
+export { columnKey };
+export type { ColumnKey } from '../memory/index.js';
+//# sourceMappingURL=accessor.d.ts.map

package/dist/component/accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../src/component/accessor.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EAEZ,MAAM,EACP,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAe,MAAM,oBAAoB,CAAA;AAG3D,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,cAAc,CAAA;AAIxD,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9E,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;IAOzC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;IAG/C,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACjE,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/E,sFAAsF;IACtF,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CAClC;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAA;IACnC;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7D;AAgED,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,GACjE,aAAa,EAAE,CAMjB;AAID,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CA2H9F;AAuCD,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/component/accessor.js

@@ -0,0 +1,220 @@
+// The factory-closure accessor class. ONE hidden
+// class per (archetype, component), closing over the column views and reading a mutable __idx.
+// This is NOT an ES Proxy on the accessor itself and NOT new Function() — it is a parameterised
+// closure returning a plain JS class (the permitted technique).
+//
+// Each instance is the single monomorphic singleton for its (archetype, component): read()/the
+// shorthand return it typed Readonly, write() returns it mutable. A getter reads the
+// captured view at __idx; a setter writes the slot AND calls world.trackWrite. On the primary
+// grow path captured views auto-widen (no rebind call); on the fallback path __rebind rebuilds
+// them from the new backing.
+import { columnKey, elementCtor } from '../memory/index.js';
+import { sidecarKey } from './sidecar.js';
+function columnElementOf(f) {
+    const ctor = f.ctor;
+    if (ctor === Float32Array)
+        return 'f32';
+    if (ctor === Float64Array)
+        return 'f64';
+    if (ctor === Int8Array)
+        return 'i8';
+    if (ctor === Uint8Array)
+        return 'u8';
+    if (ctor === Uint8ClampedArray)
+        return 'u8c';
+    if (ctor === Int16Array)
+        return 'i16';
+    if (ctor === Uint16Array)
+        return 'u16';
+    if (ctor === Int32Array)
+        return 'i32';
+    if (ctor === Uint32Array)
+        return 'u32';
+    throw new Error('unsupported column element ctor');
+}
+function planFields(def) {
+    const columnPlans = [];
+    const richPlans = [];
+    const componentId = def.id;
+    let fieldIndex = 0;
+    for (const f of def.fields) {
+        if (f.ctor !== null) {
+            columnPlans.push({
+                fieldIndex,
+                name: f.name,
+                stride: f.stride,
+                element: columnElementOf(f),
+                encode: f.encode,
+                decode: f.decode,
+                isVec: f.stride > 1,
+            });
+        }
+        else if (f.rich !== undefined) {
+            // Rich (sidecar-backed) field: gets a getter/setter pair targeting the sidecar. Its field
+            // index is still consumed so column keys stay stable across the field set.
+            richPlans.push({ fieldIndex, name: f.name, rich: f.rich, sidecarKey: sidecarKey(componentId, fieldIndex) });
+        }
+        fieldIndex += 1;
+    }
+    return { columnPlans, richPlans };
+}
+// Build the per-(archetype, component) ColumnBinding[] for a column set the caller allocated. The
+// archetype-binding seam will produce these from a real archetype's columns; for the
+// caller passes the freshly-allocated columns directly.
+export function bindingsFor(columns) {
+    return columns.map((c) => ({
+        view: c.view,
+        byteOffset: c.view.byteOffset,
+        element: c.layout.element,
+    }));
+}
+const AXIS_NAMES = ['x', 'y', 'z', 'w'];
+export function makeAccessorFactory(def) {
+    const { columnPlans: plans, richPlans } = planFields(def);
+    const componentId = def.id;
+    return ((columns) => {
+        // The assert counts ONLY column-bearing plans: a rich-only or mixed
+        // component binds against its column subset, and the rich getters install independently below.
+        if (columns.length !== plans.length) {
+            throw new Error(`accessor factory for '${def.name}': expected ${plans.length} columns, got ${columns.length}`);
+        }
+        // Captured per-field state, closed over by every getter/setter. `views` is mutated in place on
+        // a fallback rebind so the closures keep seeing the live view without regeneration.
+        const views = columns.map((c) => c.view);
+        const offsets = columns.map((c) => c.byteOffset);
+        const elements = columns.map((c) => c.element);
+        // One reusable VecView per vec field (no allocation on read). Lazily built on first get
+        // and cached here, then re-returned for every subsequent get; it reads owner.__idx lazily so it
+        // stays correct as __idx is re-poked, and resolves the live view from `views[i]` so a fallback
+        // rebind is transparent.
+        const vecViews = plans.map(() => undefined);
+        class Accessor {
+            __idx = 0;
+            __eid = 0;
+            __binding = null;
+            __rebind(newBacking) {
+                for (let i = 0; i < views.length; i++)
+                    this.__rebindField(i, newBacking);
+            }
+            __rebindField(fieldIndex, newBacking) {
+                const Ctor = elementCtor(elements[fieldIndex]);
+                // No length argument: rebuild the length-tracking view at the captured byteOffset.
+                views[fieldIndex] = new Ctor(newBacking, offsets[fieldIndex]);
+            }
+        }
+        plans.forEach((plan, i) => {
+            const stride = plan.stride;
+            const decode = plan.decode;
+            const encode = plan.encode;
+            const fieldIndex = plan.fieldIndex;
+            // fieldIndex is forwarded ONLY by field-granular setters. There is no changeTracking
+            // surface, so vec setters pass withField=true unconditionally. TODO: gate withField on the
+            // per-component changeTrackingDefault when reactivity config lands, so component-granular
+            // components omit fieldIndex.
+            const track = (self, withField) => {
+                const b = self.__binding;
+                if (b === null)
+                    return;
+                // Fast-out: no write consumer ⇒ trackWrite is a no-op anyway, so skip the handleIndex decode
+                // and the two closure hops entirely ( write-path gate). See AccessorWorld.tracking.
+                if (!b.world.tracking.active)
+                    return;
+                if (withField)
+                    b.world.trackWrite(b.world.handleIndex(self.__eid), componentId, fieldIndex);
+                else
+                    b.world.trackWrite(b.world.handleIndex(self.__eid), componentId);
+            };
+            if (plan.isVec) {
+                Object.defineProperty(Accessor.prototype, plan.name, {
+                    enumerable: true,
+                    configurable: true,
+                    get() {
+                        let v = vecViews[i];
+                        if (v === undefined) {
+                            v = makeVecView(views, i, stride, this, decode, encode, () => track(this, true));
+                            vecViews[i] = v;
+                        }
+                        return v;
+                    },
+                    set(value) {
+                        const view = views[i];
+                        const base = this.__idx * stride;
+                        for (let a = 0; a < stride; a++)
+                            view[base + a] = encode(value[a]);
+                        track(this, true);
+                    },
+                });
+            }
+            else {
+                Object.defineProperty(Accessor.prototype, plan.name, {
+                    enumerable: true,
+                    configurable: true,
+                    get() {
+                        const view = views[i];
+                        return decode(view[this.__idx]);
+                    },
+                    set(value) {
+                        const view = views[i];
+                        view[this.__idx] = encode(value);
+                        track(this, false);
+                    },
+                });
+            }
+        });
+        // Rich (sidecar-backed) getters/setters. The getter returns the live JS
+        // reference (string primitive / object<T>); the setter writes the sidecar slot AND routes through
+        // the SAME field-granular trackWrite numeric setters use, so Changed/observers fire identically
+        // (RF-CHANGED). In-place mutation of an object<T> reference is NOT tracked — only re-assignment is.
+        richPlans.forEach((plan) => {
+            const key = plan.sidecarKey;
+            const fieldIndex = plan.fieldIndex;
+            Object.defineProperty(Accessor.prototype, plan.name, {
+                enumerable: true,
+                configurable: true,
+                get() {
+                    const b = this.__binding;
+                    if (b === null)
+                        return undefined;
+                    const idx = b.world.handleIndex(this.__eid);
+                    return b.world.sidecarRead(key, idx, b.world.generationOf(idx));
+                },
+                set(value) {
+                    const b = this.__binding;
+                    if (b === null)
+                        return;
+                    const idx = b.world.handleIndex(this.__eid);
+                    b.world.sidecarWrite(key, idx, b.world.generationOf(idx), value);
+                    b.world.trackWrite(idx, componentId, fieldIndex);
+                },
+            });
+        });
+        return Accessor;
+    });
+}
+// A thin vec view, built ONCE per (accessor, vec field) and reused across gets (no allocation
+// on read). It reads `owner.__idx` lazily so the single cached wrapper stays correct as __idx is
+// re-poked, and resolves the live view from `views[viewIndex]` so a fallback rebind is transparent.
+// Indexed/named axis reads decode; writes encode + report a field-granular write.
+function makeVecView(views, viewIndex, stride, owner, decode, encode, trackWrite) {
+    const read = (axis) => decode(views[viewIndex][owner.__idx * stride + axis]);
+    const write = (axis, value) => {
+        ;
+        views[viewIndex][owner.__idx * stride + axis] = encode(value);
+        trackWrite();
+    };
+    const obj = { length: stride };
+    for (let a = 0; a < stride; a++) {
+        const axis = a;
+        const def = {
+            enumerable: true,
+            get: () => read(axis),
+            set: (v) => write(axis, v),
+        };
+        Object.defineProperty(obj, axis, def);
+        if (axis < AXIS_NAMES.length)
+            Object.defineProperty(obj, AXIS_NAMES[axis], def);
+    }
+    return obj;
+}
+export { columnKey };
+//# sourceMappingURL=accessor.js.map

package/dist/component/accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.js","sourceRoot":"","sources":["../../src/component/accessor.ts"],"names":[],"mappings":"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"}

package/dist/component/column-set.d.ts

@@ -0,0 +1,20 @@
+import type { ComponentDef, ComponentId, EntityHandle, Schema } from '@ecsia/schema';
+import type { Buffers, Column } from '../memory/index.js';
+import type { AccessorInstanceBase, AccessorWorld } from './accessor.js';
+export interface ColumnSet {
+    readonly archetypeId: number;
+    readonly componentId: ComponentId;
+    readonly columns: readonly Column[];
+    /** The monomorphic accessor singleton for this (archetype, component). */
+    readonly accessor: AccessorInstanceBase;
+}
+export interface BuildColumnSetParams {
+    readonly buffers: Buffers;
+    readonly archetypeId: number;
+    readonly def: ComponentDef<Schema>;
+    readonly world: AccessorWorld;
+    readonly initialCapacity: number;
+}
+export declare function buildColumnSet(params: BuildColumnSetParams): ColumnSet;
+export declare function bindAccessorRow(set: ColumnSet, row: number, eid: EntityHandle): AccessorInstanceBase;
+//# sourceMappingURL=column-set.d.ts.map

package/dist/component/column-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-set.d.ts","sourceRoot":"","sources":["../../src/component/column-set.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAmB,MAAM,EAAE,MAAM,eAAe,CAAA;AACrG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGzD,OAAO,KAAK,EAAmB,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAGzF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CA0CtE;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,oBAAoB,CAKpG"}

package/dist/component/column-set.js

@@ -0,0 +1,60 @@
+// The (archetype, component) ColumnSet allocation + accessor instantiation.
+// This is the binding seam: it allocates one column per column-backed field
+// through Buffers.column, instantiates the component's accessor singleton over those columns, and
+// registers the singleton as a ViewHolder for the fallback grow path.
+//
+// ARCHETYPE-BINDING SEAM: storage owns producing this from a real archetype's row store. For
+// the caller passes any archetypeId (e.g. a single test/empty archetype) and the columns are
+// allocated directly so the read/write paths are exercisable now.
+import { columnKey } from '../memory/index.js';
+import { bindingsFor } from './accessor.js';
+export function buildColumnSet(params) {
+    const { buffers, archetypeId, def, world, initialCapacity } = params;
+    const rt = def;
+    const componentId = def.id;
+    if (componentId < 0) {
+        throw new Error(`buildColumnSet: component '${def.name}' has no id (register it with a world first)`);
+    }
+    const columns = [];
+    let fieldIndex = 0;
+    let layoutIndex = 0;
+    for (const f of def.fields) {
+        if (f.ctor !== null) {
+            const layout = rt.columnLayouts[layoutIndex];
+            if (layout === undefined)
+                throw new Error(`buildColumnSet: missing layout for field '${f.name}'`);
+            const key = columnKey(archetypeId, componentId, fieldIndex);
+            columns.push(buffers.column(key, layout, initialCapacity));
+            layoutIndex += 1;
+        }
+        fieldIndex += 1;
+    }
+    const factory = rt.accessorFactory;
+    if (factory === null)
+        throw new Error(`buildColumnSet: component '${def.name}' has no accessor factory`);
+    const AccessorClass = factory(bindingsFor(columns));
+    const accessor = new AccessorClass();
+    const binding = { world, componentId };
+    accessor.__binding = binding;
+    // Register one ViewHolder PER column so a fallback grow re-binds exactly that field's view.
+    // Each column owns a separate backing; a whole-instance rebind would alias every field onto the
+    // single grown backing. `columns` is in accessor field-order, so the index is the rebind target.
+    for (let i = 0; i < columns.length; i++) {
+        const fieldIndex = i;
+        buffers.registerAccessor(columns[i].key, {
+            __rebind(newBacking) {
+                accessor.__rebindField(fieldIndex, newBacking);
+            },
+        });
+    }
+    return { archetypeId, componentId, columns, accessor };
+}
+// Point a column set's accessor singleton at a (row, entity). 's query/iteration loop pokes
+// __idx; the entity read/write path pokes both before handing the view out.
+export function bindAccessorRow(set, row, eid) {
+    const a = set.accessor;
+    a.__idx = row;
+    a.__eid = eid;
+    return a;
+}
+//# sourceMappingURL=column-set.js.map

package/dist/component/column-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-set.js","sourceRoot":"","sources":["../../src/component/column-set.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,kGAAkG;AAClG,sEAAsE;AACtE,EAAE;AACF,6FAA6F;AAC7F,6FAA6F;AAC7F,kEAAkE;AAIlE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAoB3C,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA;IACpE,MAAM,EAAE,GAAG,GAA+B,CAAA;IAC1C,MAAM,WAAW,GAAG,GAAG,CAAC,EAAiB,CAAA;IACzC,IAAK,WAAsB,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,8CAA8C,CAAC,CAAA;IACvG,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAoC,EAAE,CAAC;QACzD,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;YAC5C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,IAAI,GAAG,CAAC,CAAA;YACjG,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,WAAqB,EAAE,UAAU,CAAC,CAAA;YACrE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;YAC1D,WAAW,IAAI,CAAC,CAAA;QAClB,CAAC;QACD,UAAU,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,eAAe,CAAA;IAClC,IAAI,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,2BAA2B,CAAC,CAAA;IACxG,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAqC,CAAA;IACvE,MAAM,OAAO,GAAoB,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;IACvD,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAA;IAE5B,4FAA4F;IAC5F,gGAAgG;IAChG,iGAAiG;IACjG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,CAAC,CAAA;QACpB,OAAO,CAAC,gBAAgB,CAAE,OAAO,CAAC,CAAC,CAAY,CAAC,GAAG,EAAE;YACnD,QAAQ,CAAC,UAAU;gBACjB,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;YAChD,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AACxD,CAAC;AAED,4FAA4F;AAC5F,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,GAAc,EAAE,GAAW,EAAE,GAAiB;IAC5E,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAA;IACtB,CAAC,CAAC,KAAK,GAAG,GAAG,CAAA;IACb,CAAC,CAAC,KAAK,GAAG,GAAG,CAAA;IACb,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/component/define.d.ts

@@ -0,0 +1,23 @@
+import type { AccessorFactory, ComponentDef, ComponentId, ComponentOptions, Schema } from '@ecsia/schema';
+import type { ColumnLayout } from '../memory/index.js';
+export declare const UNREGISTERED: ComponentId;
+export type DefKind = 'component' | 'relation-presence' | 'relation-overflow';
+export interface ComponentRuntime<S extends Schema> extends ComponentDef<S> {
+    id: ComponentId;
+    accessorFactory: AccessorFactory<S> | null;
+    readonly columnLayouts: readonly ColumnLayout[];
+    readonly defKind: DefKind;
+    readonly restrictedToMainThread: boolean;
+    /** True iff the component carries >=1 rich (sidecar-backed) field. */
+    readonly hasRichFields: boolean;
+}
+export declare function defineComponent<const S extends Schema, const B extends string = never, const N extends string = never>(schema: S, options: ComponentOptions & ({
+    readonly name: N;
+    readonly brand?: B;
+} | {
+    readonly brand: B;
+    readonly name?: N;
+})): ComponentDef<S, [B] extends [never] ? N : B>;
+export declare function defineTag<const N extends string>(name: N): ComponentDef<Record<never, never>, N>;
+export declare function registerComponentId<S extends Schema>(def: ComponentDef<S>, id: ComponentId): void;
+//# sourceMappingURL=define.d.ts.map

package/dist/component/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/component/define.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAGhB,MAAM,EACP,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKtD,eAAO,MAAM,YAAY,EAAS,WAAW,CAAA;AAE7C,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,mBAAmB,GAAG,mBAAmB,CAAA;AAK7E,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACzE,EAAE,EAAE,WAAW,CAAA;IACf,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAA;IACxC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAwED,wBAAgB,eAAe,CAC7B,KAAK,CAAC,CAAC,SAAS,MAAM,EACtB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,EAC9B,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,EAE9B,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,gBAAgB,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC,GAChH,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CA0D9C;AAID,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAKhG;AAKD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAOjG"}