@ecsia/core 0.1.0

package/dist/reactivity/reactivity.js

@@ -0,0 +1,479 @@
+// The reactivity facade: owns the write log + shape log, the per-row changeVersion
+// columns, the deferred observers, and the query-flavor hooks. It fills the trackWrite stub, the
+// enqueueRemoveLog stub, and the LiveQuery.changed()/eachChanged() stubs — wiring the dual
+// mechanism the spec mandates:
+// - the WRITE LOG drives the `.changed` query FILTER (drainChanged);
+// - the per-row changeVersion drives the PUBLIC changedSince predicate + delta serializer.
+// They never read each other's mechanism.
+import { LogRing, OVERFLOW_SENTINEL, ShapeKind, WriteCorral } from './log.js';
+import { ChangeVersionStore } from './change-version.js';
+import { StructuralJournal } from './structural-journal.js';
+import { ObserverRegistry } from './observers.js';
+export class Reactivity {
+    #deps;
+    #writeLog;
+    #shapeLog;
+    #changeVersion;
+    #structuralJournal;
+    #observers;
+    #corral;
+    /** One per LiveQuery that declares the `changed` flavor (lazily allocated). */
+    #changedFlavors = new WeakMap();
+    /** Strong list of every changed-flavor pointer, so frame-recycle can rewind lagging cursors. */
+    #changedPointers = [];
+    #indexMask;
+    #componentIdBits;
+    #wide;
+    // Saved consumer pointers for the serial drains.
+    #maintainShapePtr;
+    #observerShapePtr;
+    #observerWritePtr;
+    // Filled by the world wiring so MAINTAIN_STRUCTURAL + observer "all present" can re-test entities.
+    #maintainHook = null;
+    #currentMembers = null;
+    #spilledThisFrame = false;
+    /** True iff the write log has a consumer (a changed-flavor pointer or a change observer); else the
+     * per-write push is dead (recomputed on (de)registration, not per write). */
+    #writeLogActive = false;
+    constructor(deps) {
+        this.#deps = deps;
+        this.#wide = deps.logEntryWords === 2;
+        this.#indexMask = deps.indexBits >= 32 ? 0xffffffff : ((1 << deps.indexBits) - 1) >>> 0;
+        this.#componentIdBits = 32 - deps.indexBits;
+        // One-word write entry / two-word shape entry by default; wide worlds add a word each.
+        const writeWords = this.#wide ? 2 : 1;
+        const shapeWords = this.#wide ? 3 : 2;
+        this.#writeLog = new LogRing({
+            buffers: deps.buffers,
+            kind: 'write',
+            entryWords: writeWords,
+            capacityEntries: deps.maxWritesPerFrame,
+            keyPrefix: 'reactivity.log.write',
+            shrinkRings: deps.shrinkRings,
+        });
+        this.#shapeLog = new LogRing({
+            buffers: deps.buffers,
+            kind: 'shape',
+            entryWords: shapeWords,
+            capacityEntries: deps.maxShapeChangesPerFrame,
+            keyPrefix: 'reactivity.log.shape',
+            shrinkRings: deps.shrinkRings,
+        });
+        this.#changeVersion = new ChangeVersionStore(deps.buffers, Math.min(64, deps.maxEntities));
+        this.#structuralJournal = new StructuralJournal(Math.max(1024, deps.maxShapeChangesPerFrame));
+        this.#corral = new WriteCorral();
+        const obsDeps = {
+            idOf: deps.idOf,
+            holdsAll: deps.holdsAll,
+            refOf: deps.refOf,
+            tick: deps.tick,
+        };
+        this.#observers = new ObserverRegistry(obsDeps);
+        this.#maintainShapePtr = this.#shapeLog.makePointer();
+        this.#observerShapePtr = this.#shapeLog.makePointer();
+        this.#observerWritePtr = this.#writeLog.makePointer();
+    }
+    /** Late-bind the single-entity maintenance hook (the query engine's maintainEntity). */
+    setMaintainHook(fn) {
+        this.#maintainHook = fn;
+    }
+    /** Late-bind a "current matching members across all queries" source for the conservative path. */
+    setCurrentMembersSource(fn) {
+        this.#currentMembers = fn;
+    }
+    // --- entry packing -------------------------------------------
+    #packWriteEntry(index, componentId) {
+        if (this.#wide)
+            return [index >>> 0, componentId >>> 0];
+        return [(((componentId << this.#deps.indexBits) | (index & this.#indexMask)) >>> 0)];
+    }
+    #unpackWrite(source, base) {
+        if (this.#wide) {
+            return { index: source[base] >>> 0, componentId: source[base + 1] >>> 0 };
+        }
+        const w = source[base];
+        return { index: w & this.#indexMask, componentId: (w >>> this.#deps.indexBits) >>> 0 };
+    }
+    #packShapeEntry(index, componentId, kind, targetIndex = 0) {
+        if (this.#wide) {
+            const a = index >>> 0;
+            const c = (((targetIndex << 3) | (kind & 0x7)) >>> 0);
+            return [a, componentId >>> 0, c];
+        }
+        const a = (((componentId << this.#deps.indexBits) | (index & this.#indexMask)) >>> 0);
+        const b = (((targetIndex << 3) | (kind & 0x7)) >>> 0);
+        return [a, b];
+    }
+    #unpackShape(source, base) {
+        if (this.#wide) {
+            const a = source[base];
+            const componentId = source[base + 1] >>> 0;
+            const c = source[base + 2];
+            return { index: a >>> 0, componentId, kind: (c & 0x7), target: c >>> 3 };
+        }
+        const a = source[base];
+        const b = source[base + 1];
+        return {
+            index: a & this.#indexMask,
+            componentId: (a >>> this.#deps.indexBits) >>> 0,
+            kind: (b & 0x7),
+            target: b >>> 3,
+        };
+    }
+    // --- hot-path hooks -------------------------------------
+    /** +: push the write entry (when a consumer exists) and stamp changeVersion (when enabled).
+     * Single-thread. The write log is read ONLY by changed-flavor query pointers and change observers; with
+     * neither present every appended word is dead (rewound at frame-recycle), so the push is a pure cost on
+     * the iteration hot path. Gate it on `#writeLogActive` (recomputed on flavor/observer (de)registration) —
+     * a semantics-preserving fast-out, since a later-attached changed flavor's pointer starts at the live head
+     * and sees only writes after it attaches. Pack the word inline (no per-write array). */
+    trackWrite(index, componentId, fieldIndex) {
+        if (this.#writeLogActive) {
+            // Main thread: append directly to the ring. (Worker corrals merge at mergeCorrals — .)
+            if (this.#wide) {
+                this.#writeLog.pushWord(index >>> 0);
+                this.#writeLog.pushWord(componentId >>> 0);
+            }
+            else {
+                this.#writeLog.pushWord((((componentId << this.#deps.indexBits) | (index & this.#indexMask)) >>> 0));
+            }
+        }
+        if (this.#changeVersion.enabled) {
+            // fieldIndex affects only field-granular stamping (deferred); component-granular default
+            // stamps the whole-entity slot regardless of which component/field changed. Keyed by entity INDEX
+            // so the stamp follows the entity across any later relocation.
+            void fieldIndex;
+            this.#changeVersion.stamp(index, this.#deps.tick());
+        }
+    }
+    /**: append one shape entry. Main thread only, O(1). */
+    trackShape(index, componentId, kind) {
+        this.#shapeLog.push(this.#packShapeEntry(index, componentId, kind));
+        // Persistent since-T mirror for the delta serializer. Resolve the
+        // FULL handle NOW — for Destroy this hook runs BEFORE identity invalidation,
+        // so the dying handle is still recoverable. No-op until a delta serializer enables journaling.
+        if (this.#structuralJournal.enabled) {
+            this.#structuralJournal.record(this.#deps.tick(), kind, this.#deps.resolveHandle(index), componentId, 0);
+        }
+    }
+    /**: carries the target index in word B/C. */
+    trackShapePair(index, pairId, targetIndex, kind) {
+        this.#shapeLog.push(this.#packShapeEntry(index, pairId, kind, targetIndex));
+        if (this.#structuralJournal.enabled) {
+            this.#structuralJournal.record(this.#deps.tick(), kind, this.#deps.resolveHandle(index), pairId, this.#deps.resolveHandle(targetIndex));
+        }
+    }
+    /**
+     * _PAYLOAD: a non-exclusive overflow pair's payload changed on an already-live pair. This is
+     * NOT a membership change (no shape-log entry, no add/remove observer), but it IS a structural delta
+     * the since-T stream must carry, so we record it in the persistent journal only
+     * (overflow payload changes are explicit OP_PAIR_PAYLOAD records).
+     */
+    trackShapeSetPayload(index, pairId, targetIndex) {
+        if (this.#structuralJournal.enabled) {
+            this.#structuralJournal.record(this.#deps.tick(), ShapeKind.SetPayload, this.#deps.resolveHandle(index), pairId, this.#deps.resolveHandle(targetIndex));
+        }
+    }
+    /**
+     * The enqueueRemoveLog stub body: storage calls this for each component in fromArch \ toArch at
+     * a migration, and for each held component at despawn (BEFORE removeRow + identity invalidation,
+     * ). It emits a shape-log Remove entry — the single source for onRemove dispatch + Removed
+     * delta maintenance.
+     */
+    enqueueRemoveLog(index, componentId) {
+        this.trackShape(index, componentId, ShapeKind.Remove);
+    }
+    // --- public predicate + delta ---------------------------------------
+    /** Enable per-row changeVersion stamping (a `.changed` predicate consumer / serializer exists). */
+    enableChangeVersion() {
+        this.#changeVersion.enabled = true;
+        this.#deps.tracking.active = true;
+    }
+    /**
+     * Enable the persistent structural journal (the since-T STRUCTURAL source). A delta serializer
+     * that includes the structural section calls this once at construction — it is the structural twin of
+     * `enableChangeVersion`. Until then, zero record cost.
+     */
+    enableStructuralJournal() {
+        this.#structuralJournal.enabled = true;
+    }
+    /**
+     * /: the structural ops committed with tick > since, in commit order, as portable full-handle
+     * records. `gap` is true when `since` predates the bounded journal's live window (the caller must
+     * resync from a fresh snapshot — the no-partial-apply delta-gap rule).
+     */
+    drainStructuralSince(since) {
+        return this.#structuralJournal.drainSince(since);
+    }
+    /**: "did any component on `handle` change since tick `since`?" (strict >). */
+    changedSince(handle, since) {
+        const index = handle & this.#indexMask;
+        return this.#changeVersion.changedSince(index, since);
+    }
+    /**
+     * /: rows of `archetypeId` whose ENTITY's stamp is > since (the delta-serializer scan).
+     * `indexOfRow` maps a live row of the archetype to its entity index — the stamp is keyed by entity
+     * index (it follows the entity across relocations), so we resolve each row's current occupant.
+     */
+    *changedRows(_archetypeId, since, count, indexOfRow) {
+        for (let row = 0; row < count; row++) {
+            if (this.#changeVersion.changedSince(indexOfRow(row), since))
+                yield row;
+        }
+    }
+    currentTick() {
+        return this.#deps.tick();
+    }
+    // --- observers --------------------------------------------------------
+    /** Recompute the write-log fast-out flag after any consumer (de)registers. Also refreshes the
+     * accessor's shared `tracking.active` cell: true iff trackWrite would do real work (a write-log
+     * consumer exists OR changeVersion stamping is enabled). When false the setter skips the whole chain. */
+    #refreshWriteLogActive() {
+        this.#writeLogActive = this.#changedPointers.length > 0 || this.#observers.hasChangeObservers;
+        this.#deps.tracking.active = this.#writeLogActive || this.#changeVersion.enabled;
+    }
+    observe(term, handler) {
+        const handle = this.#observers.observe(term, handler);
+        this.#refreshWriteLogActive();
+        const dispose = handle.dispose;
+        return {
+            id: handle.id,
+            dispose: () => {
+                dispose();
+                this.#refreshWriteLogActive();
+            },
+        };
+    }
+    /**: is there a remove-observer on `componentId` (gates deferred row reclaim)? */
+    hasRemoveObserver(componentId) {
+        return this.#observers.hasKindFor('remove', componentId);
+    }
+    // --- query-flavor hooks ---------------------
+    /**
+     *: allocate the `changed` flavor's LogPointer + dedup bitset for `q`. `added`/`removed` lists
+     * are owned by the LiveQuery itself and filled by maintenance; this hook wires only `changed`.
+     */
+    attachChangedFlavor(q, componentIds) {
+        this.enableChangeVersion();
+        if (this.#changedFlavors.has(q))
+            return;
+        const ptr = this.#writeLog.makePointer();
+        this.#changedPointers.push(ptr);
+        this.#changedFlavors.set(q, {
+            ptr,
+            dedup: new Uint8Array(Math.min(64, this.#deps.maxEntities)),
+            out: new Uint32Array(64),
+            componentIds: new Set(componentIds),
+        });
+        this.#refreshWriteLogActive();
+    }
+    /**
+     * _CHANGED: drain `q`'s write-log pointer, returning this frame's changed indices (deduped,
+     * intersected with `q.current` and the query's filtered components). Write-log driven — never
+     * consults changeVersion.
+     */
+    drainChanged(q) {
+        const flavor = this.#changedFlavors.get(q);
+        if (flavor === undefined)
+            return EMPTY_U32;
+        let count = 0;
+        const current = q.current;
+        // Size the dedup bitset to the current matching high-water (entity indices).
+        const need = this.#maxIndexOf(current) + 1;
+        if (need > flavor.dedup.length)
+            flavor.dedup = new Uint8Array(need);
+        flavor.dedup.fill(0);
+        const emit = (index) => {
+            if (count >= flavor.out.length) {
+                const grown = new Uint32Array(flavor.out.length * 2);
+                grown.set(flavor.out);
+                flavor.out = grown;
+            }
+            flavor.out[count++] = index;
+        };
+        this.#writeLog.consume(flavor.ptr, (source, base) => {
+            if (source.length === 1 && source[0] === OVERFLOW_SENTINEL) {
+                // Treat every current match as changed.
+                for (const index of current) {
+                    if (index < flavor.dedup.length && flavor.dedup[index] === 1)
+                        continue;
+                    if (index < flavor.dedup.length)
+                        flavor.dedup[index] = 1;
+                    emit(index);
+                }
+                return;
+            }
+            const { index, componentId } = this.#unpackWrite(source, base);
+            if (flavor.componentIds.size > 0 && !flavor.componentIds.has(componentId))
+                return;
+            if (!current.has(index))
+                return;
+            if (index < flavor.dedup.length && flavor.dedup[index] === 1)
+                return;
+            if (index < flavor.dedup.length)
+                flavor.dedup[index] = 1;
+            emit(index);
+        });
+        return flavor.out.subarray(0, count);
+    }
+    #maxIndexOf(set) {
+        let max = 0;
+        for (const i of set)
+            if (i > max)
+                max = i;
+        return max;
+    }
+    // --- lifecycle -------------------------------
+    /**: start of frame — advance the world tick, snapshot peak, recycle the rings. */
+    frameReset() {
+        this.#deps.advanceTick();
+        if (this.#deps.tick() === 0xffffffff) {
+            this.#changeVersion.resetAll(); //
+            this.#structuralJournal.resetAll();
+        }
+        this.#spilledThisFrame = false;
+        this.#writeLog.frameReset(this.#minWriteCursor());
+        this.#shapeLog.frameReset(this.#minShapeCursor());
+        // When the ring recycled to slot 0 (all consumers caught up), rewind every caught-up
+        // consumer's cursor to 0 too, so it scans the new frame's entries from the head. A still-lagging
+        // consumer (cursor below the now-zero head is impossible) keeps its cursor.
+        this.#rewindCaughtUp(this.#writeLog.header[0], [this.#observerWritePtr, ...this.#changedPointers]);
+        this.#rewindCaughtUp(this.#shapeLog.header[0], [this.#observerShapePtr, this.#maintainShapePtr]);
+    }
+    #rewindCaughtUp(head, pointers) {
+        if (head !== 0)
+            return; // ring was not recycled (a lagging consumer pinned it)
+        for (const ptr of pointers) {
+            ptr.cursor = 0;
+            ptr.spillCursor = 0;
+        }
+    }
+    /**: merge per-worker write corrals into the shared ring (deterministic). No-op single-thread. */
+    mergeCorrals() {
+        const c = this.#corral;
+        for (let i = 0; i < c.count; i++) {
+            this.#writeLog.pushWord(c.data[i]);
+        }
+        c.reset();
+    }
+    /**
+     * /+: merge ONE worker's staged value writes into the shared write log. `pairs` is a
+     * flat `[index, componentId, index, componentId, …]` buffer (the worker's raw corral payload); the
+     * caller drives this in ASCENDING worker-index order so the merged stream is deterministic. We
+     * (re)pack each pair through the module's own packWrite so single/wide layout stays the single
+     * source of truth — the worker never duplicates the packing scheme. Writes flow into the SAME ring
+     * the main thread appends to, so `.changed` filters and onChange observers fire for worker writes
+     * exactly as for single-thread writes.: when changeVersion is enabled we also
+     * stamp each row here (the worker hot path stays atomic-free; the stamp lands at the serial merge).
+     */
+    mergeWorkerWrites(pairs, count) {
+        for (let i = 0; i < count; i++) {
+            const index = pairs[i * 2] >>> 0;
+            const componentId = pairs[i * 2 + 1] >>> 0;
+            for (const w of this.#packWriteEntry(index, componentId))
+                this.#writeLog.pushWord(w);
+            if (this.#changeVersion.enabled) {
+                this.#changeVersion.stamp(index, this.#deps.tick());
+            }
+        }
+    }
+    /**
+     * _STRUCTURAL: drain the shape log, re-testing each affected entity against the queries
+     * referencing the changed component. In single-thread mode already maintains `current`
+     * synchronously at the commit point, so this re-runs the same idempotent re-test off the log (the
+     * drain is the spec's serial mechanism; the synchronous path is the optimization that agrees with
+     * it). Add/remove coalesce within the frame because the drain happens once.
+     */
+    maintainStructural() {
+        const hook = this.#maintainHook;
+        if (hook === null) {
+            this.#maintainShapePtr.cursor = this.#shapeLogHead();
+            return;
+        }
+        this.#shapeLog.consume(this.#maintainShapePtr, (source, base) => {
+            if (source.length === 1 && source[0] === OVERFLOW_SENTINEL)
+                return;
+            const { index, componentId, kind } = this.#unpackShape(source, base);
+            if (kind === ShapeKind.Add || kind === ShapeKind.Remove)
+                hook(index, componentId);
+        });
+    }
+    /** _DRAIN: fire deferred observers from the saved shape/write pointers. */
+    observerDrain() {
+        if (!this.#observers.hasObservers) {
+            this.#observerShapePtr.cursor = this.#shapeLogHead();
+            this.#observerWritePtr.cursor = this.#writeLogHead();
+            return;
+        }
+        this.#observers.resetChangeDedup();
+        // Capture BOTH log heads at drain entry. A structural (add/remove) handler may
+        // call entity.write(C), which appends to the write log; bounding the change consume to this snapshot
+        // defers that observer-issued write to the NEXT drain — no intra-drain write-cascade (review #2).
+        const writeHeadSnapshot = this.#writeLogHead();
+        // Structural observers (add/remove) off the shape log.
+        this.#shapeLog.consume(this.#observerShapePtr, (source, base) => {
+            if (source.length === 1 && source[0] === OVERFLOW_SENTINEL)
+                return;
+            const { index, componentId, kind } = this.#unpackShape(source, base);
+            const okind = kind === ShapeKind.Add || kind === ShapeKind.AddPair
+                ? 'add'
+                : kind === ShapeKind.Remove || kind === ShapeKind.RemovePair || kind === ShapeKind.Destroy
+                    ? 'remove'
+                    : null;
+            if (okind === null)
+                return; // CREATE has no per-component observer
+            this.#observers.dispatchStructural(okind, index, componentId);
+        });
+        // Change observers off the write log.
+        this.#writeLog.consume(this.#observerWritePtr, (source, base) => {
+            if (source.length === 1 && source[0] === OVERFLOW_SENTINEL) {
+                if (this.#currentMembers !== null)
+                    this.#observers.fireAllChangeConservatively(this.#currentMembers());
+                return;
+            }
+            const { index, componentId } = this.#unpackWrite(source, base);
+            this.#observers.dispatchChange(index, componentId);
+        }, writeHeadSnapshot);
+    }
+    /** _LOGS: drain/merge spill (consumers already drained it), schedule next-frame resize. */
+    flushLogs() {
+        if (this.#writeLog.spill.length > 0 || this.#shapeLog.spill.length > 0)
+            this.#spilledThisFrame = true;
+        this.#writeLog.observePeak();
+        this.#shapeLog.observePeak();
+        if (this.#deps.dev && this.#spilledThisFrame && typeof console !== 'undefined') {
+            console.warn(`[ecsia] reactivity log overflowed its ring this frame; entries spilled to the main-thread ` +
+                `array and the ring will grow next frame. Set createWorld({ reactivity: { maxWritesPerFrame / ` +
+                `maxShapeChangesPerFrame } }) to pre-size.`);
+        }
+    }
+    // --- internals -------------------------------------------------------------
+    #shapeLogHead() {
+        return this.#shapeLog.header[0];
+    }
+    #writeLogHead() {
+        return this.#writeLog.header[0];
+    }
+    #minWriteCursor() {
+        let min = this.#writeLog.header[0];
+        if (this.#observerWritePtr.cursor < min)
+            min = this.#observerWritePtr.cursor;
+        // changed-flavor pointers are drained lazily; they pin the ring until read so the recycle never
+        // overruns an unread consumer ("ring is not recycled past a lagging pointer"). In the common
+        // case every system reads its filter within the frame, so they equal head and the ring recycles.
+        for (const ptr of this.#changedPointers)
+            if (ptr.cursor < min)
+                min = ptr.cursor;
+        return min;
+    }
+    #minShapeCursor() {
+        let min = this.#shapeLog.header[0];
+        if (this.#observerShapePtr.cursor < min)
+            min = this.#observerShapePtr.cursor;
+        if (this.#maintainShapePtr.cursor < min)
+            min = this.#maintainShapePtr.cursor;
+        return min;
+    }
+}
+const EMPTY_U32 = new Uint32Array(0);
+//# sourceMappingURL=reactivity.js.map

package/dist/reactivity/reactivity.js.map

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

package/dist/reactivity/structural-journal.d.ts

@@ -0,0 +1,30 @@
+import type { ShapeKind } from './log.js';
+export interface StructuralRecord {
+    readonly tick: number;
+    readonly kind: ShapeKind;
+    /** The FULL (generational) subject/entity handle, resolved at commit time (portable across boundary). */
+    readonly handle: number;
+    /** User/synthetic component id (Add/Remove) or synthetic pair id (AddPair/RemovePair). 0 for Create/Destroy. */
+    readonly componentId: number;
+    /** The FULL pair-target handle (AddPair/RemovePair/SetPayload), resolved at commit time; else 0. */
+    readonly target: number;
+}
+export declare class StructuralJournal {
+    #private;
+    /** False ⇒ zero record cost (no delta serializer attached). Mirrors ChangeVersionStore.enabled. */
+    enabled: boolean;
+    constructor(initialCapacityRecords?: number);
+    /** Append one structural op at `tick`. O(1); drops the oldest record once the ring is full. */
+    record(tick: number, kind: ShapeKind, handle: number, componentId: number, target: number): void;
+    /**
+     * Records with tick > since, in commit (append) order. Returns `gap: true` if `since` predates the
+     * oldest resident record (the live window evicted it — the caller must resync from a snapshot).
+     */
+    drainSince(since: number): {
+        records: StructuralRecord[];
+        gap: boolean;
+    };
+    /**: clear the journal at a serial flush (alongside changeVersion.resetAll). */
+    resetAll(): void;
+}
+//# sourceMappingURL=structural-journal.d.ts.map

package/dist/reactivity/structural-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-journal.d.ts","sourceRoot":"","sources":["../../src/reactivity/structural-journal.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,yGAAyG;IACzG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,gHAAgH;IAChH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,oGAAoG;IACpG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAID,qBAAa,iBAAiB;;IAC5B,mGAAmG;IACnG,OAAO,UAAQ;gBASH,sBAAsB,SAAO;IAKzC,+FAA+F;IAC/F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBhG;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE;IAoBxE,+EAA+E;IAC/E,QAAQ,IAAI,IAAI;CAIjB"}

package/dist/reactivity/structural-journal.js

@@ -0,0 +1,77 @@
+// The persistent, bounded, tick-keyed STRUCTURAL JOURNAL — the since-T structural source the
+// delta serializer consumes. The per-frame shape log (log.ts) is RECYCLED at every frame
+// boundary, so a "since tick T" serializer cannot pin that ring across frames. Exactly as
+// `changeVersion` is the persistent
+// since-T source for VALUE changes, this journal is the persistent since-T source for STRUCTURAL
+// changes (Create/Destroy/ComponentAdd/ComponentRemove/AddPair/RemovePair/SetPayload).
+//
+// It is appended SYNCHRONOUSLY at the structural commit point (from trackShape/trackShapePair), so the
+// dying entity's FULL handle is still resolvable (Destroy is emitted BEFORE identity
+// invalidation). Each record is keyed by the current frame tick; drainSince(T) returns the ops
+// with tick > T in commit order. The journal is a bounded ring (drop-oldest); when a requested T has
+// been evicted, the caller must resync from a fresh snapshot (the delta-gap rule).
+// LAZILY enabled: zero memory/zero record cost until a delta serializer attaches.
+const FIELDS_PER_RECORD = 5;
+export class StructuralJournal {
+    /** False ⇒ zero record cost (no delta serializer attached). Mirrors ChangeVersionStore.enabled. */
+    enabled = false;
+    /** A flat ring: [tick, kind, handle, componentId, target] × capacity. Drop-oldest on overflow. */
+    #ring;
+    #capacity;
+    /** Total records ever appended (monotonic). The live window is [count-capacity, count). */
+    #count = 0;
+    /** The oldest tick still resident; a drainSince(T) with T < this floor signals an evicted gap. */
+    #oldestResidentTick = 0;
+    constructor(initialCapacityRecords = 1024) {
+        this.#capacity = Math.max(16, initialCapacityRecords);
+        this.#ring = new Uint32Array(this.#capacity * FIELDS_PER_RECORD);
+    }
+    /** Append one structural op at `tick`. O(1); drops the oldest record once the ring is full. */
+    record(tick, kind, handle, componentId, target) {
+        if (!this.enabled)
+            return;
+        const slot = (this.#count % this.#capacity) * FIELDS_PER_RECORD;
+        if (this.#count >= this.#capacity) {
+            // About to overwrite the oldest live record — advance the resident-floor to its successor's tick.
+            const nextOldest = ((this.#count + 1) % this.#capacity) * FIELDS_PER_RECORD;
+            this.#oldestResidentTick = this.#ring[nextOldest];
+        }
+        this.#ring[slot] = tick >>> 0;
+        this.#ring[slot + 1] = kind >>> 0;
+        this.#ring[slot + 2] = handle >>> 0;
+        this.#ring[slot + 3] = componentId >>> 0;
+        this.#ring[slot + 4] = target >>> 0;
+        this.#count += 1;
+    }
+    /**
+     * Records with tick > since, in commit (append) order. Returns `gap: true` if `since` predates the
+     * oldest resident record (the live window evicted it — the caller must resync from a snapshot).
+     */
+    drainSince(since) {
+        const out = [];
+        if (!this.enabled)
+            return { records: out, gap: false };
+        const gap = this.#count > this.#capacity && since < this.#oldestResidentTick;
+        const start = this.#count > this.#capacity ? this.#count - this.#capacity : 0;
+        for (let i = start; i < this.#count; i++) {
+            const slot = (i % this.#capacity) * FIELDS_PER_RECORD;
+            const tick = this.#ring[slot];
+            if (tick <= since)
+                continue;
+            out.push({
+                tick,
+                kind: this.#ring[slot + 1],
+                handle: this.#ring[slot + 2],
+                componentId: this.#ring[slot + 3],
+                target: this.#ring[slot + 4],
+            });
+        }
+        return { records: out, gap };
+    }
+    /**: clear the journal at a serial flush (alongside changeVersion.resetAll). */
+    resetAll() {
+        this.#count = 0;
+        this.#oldestResidentTick = 0;
+    }
+}
+//# sourceMappingURL=structural-journal.js.map

package/dist/reactivity/structural-journal.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,26 @@
+import type { ComponentDef, ComponentId, Schema } from '@ecsia/schema';
+import type { ComponentRuntime } from './component/index.js';
+export declare class ComponentRegistry {
+    #private;
+    constructor(..._legacy: readonly unknown[]);
+    register(components: readonly ComponentDef<Schema>[]): void;
+    /**
+     * Mint the next dense ComponentId WITHOUT binding a def (allocSyntheticComponentId).
+     * Pair/presence/overflow ids draw from the SAME dense space as ordinary
+     * components so storage, queries, and the bitmask treat them identically. Serial / main-thread.
+     */
+    allocSyntheticId(): ComponentId;
+    /**
+     * Intern a synthetic ComponentDef (a relation presence/overflow def, or a per-pair def) at an id
+     * already minted by `allocSyntheticId`, so `defOf`/`idOf` resolve it and storage can build its
+     * ColumnSet. Serial / main-thread; relations is the only caller (the acyclic boundary holds —
+     * the world exposes this through a seam, core never imports relations).
+     */
+    registerSynthetic(def: ComponentDef<Schema>, id: ComponentId): void;
+    idOf(def: ComponentDef<Schema>): ComponentId | undefined;
+    defOf(id: ComponentId): ComponentDef<Schema> | undefined;
+    /**: seeds the bitmask/sigWords fixed stride = ceil(nextComponentId/32) ( C4). */
+    get nextComponentId(): number;
+}
+export type { ComponentRuntime };
+//# sourceMappingURL=registry.d.ts.map