@ecsia/core 0.3.0 → 0.5.0

package/dist/topics/define.js

@@ -0,0 +1,61 @@
+// `defineTopic` — module-scope definition of a typed event queue, mirroring `defineComponent`:
+// a pure descriptor with no world attached, interned (id minted) when a world first sees it.
+// Topic payloads are schema'd rows: the same field-token set as components, MINUS the non-shareable
+// tokens (`object<T>`, `'string'`) — an event row must be encodable to plain u32 words so it can
+// live in the SAB-backed canonical ring and cross the worker boundary byte-deterministically.
+import { resolveDescriptor, UNREGISTERED } from '../component/index.js';
+const IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function isFieldSpec(token) {
+    return typeof token === 'object' && token !== null && token.__fieldSpec === true;
+}
+/**
+ * Define a typed event queue. `schema` uses the component field tokens (`'f32'`, `'eid'`, `vec`,
+ * `staticString`, ...); `object<T>` and `'string'` fields are rejected — event rows are fixed-width
+ * u32 words so the stream is shareable, byte-deterministic, and serializable.
+ *
+ * `eid` payload fields carry the full generational handle with NO liveness validation on delivery:
+ * an event is a fact about the past, and the referenced entity may legitimately be dead by the time
+ * a consumer reads it (especially on next-frame delivery). Check `world.isAlive(ev.target)` if the
+ * consumer needs the entity.
+ *
+ * Like a `defineComponent` def, a topic def binds to ONE world: registration writes the minted id
+ * into the def, so a second world (another test, an HMR cycle) must call `defineTopic` afresh
+ * rather than reuse the module-scope def — reuse throws "already registered with another world".
+ */
+export function defineTopic(name, schema) {
+    if (typeof name !== 'string' || name.length === 0) {
+        throw new Error('defineTopic: a non-empty topic name is required');
+    }
+    if (typeof schema !== 'object' || schema === null || Array.isArray(schema)) {
+        throw new Error(`defineTopic('${name}'): schema must be a plain object`);
+    }
+    const fields = [];
+    for (const fieldName of Object.keys(schema)) {
+        if (!IDENT.test(fieldName) || fieldName.startsWith('__')) {
+            throw new Error(`defineTopic('${name}'): invalid field name '${fieldName}' (reserved __ prefix or non-identifier)`);
+        }
+        const raw = schema[fieldName];
+        const token = isFieldSpec(raw) ? raw.token : raw;
+        if (typeof token === 'object' && token !== null && token.kind === 'object') {
+            throw new Error(`defineTopic('${name}'): field '${fieldName}' is an object<T> field — object fields cannot live in a topic ring or cross the worker boundary (v1)`);
+        }
+        if (token === 'string') {
+            throw new Error(`defineTopic('${name}'): field '${fieldName}' is a free-form 'string' field — rich fields are sidecar-backed and cannot live in a topic ring (v1); use staticString(...) for enumerated strings`);
+        }
+        const descriptor = isFieldSpec(raw)
+            ? resolveDescriptor(fieldName, raw.token, raw.default)
+            : resolveDescriptor(fieldName, raw);
+        fields.push(descriptor);
+    }
+    const def = {
+        name,
+        schema,
+        fields: Object.freeze(fields),
+        __ecsiaTopic: true,
+    };
+    // `id` is the registry's single commit point (mirrors ComponentRuntime): mutable so a world (or a
+    // worker aligning ids from the boot manifest) can intern the def after construction.
+    Object.defineProperty(def, 'id', { value: UNREGISTERED, enumerable: true, writable: true, configurable: true });
+    return Object.preventExtensions(def);
+}
+//# sourceMappingURL=define.js.map

package/dist/topics/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/topics/define.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,6FAA6F;AAC7F,oGAAoG;AACpG,iGAAiG;AACjG,8FAA8F;AAa9F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAoCvE,MAAM,KAAK,GAAG,4BAA4B,CAAA;AAE1C,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAmC,CAAC,WAAW,KAAK,IAAI,CAAA;AACjH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAiD,IAAO,EAAE,MAAS;IAC5F,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,mCAAmC,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,2BAA2B,SAAS,0CAA0C,CAAC,CAAA;QACrH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAe,CAAA;QAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClG,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,cAAc,SAAS,uGAAuG,CACnJ,CAAA;QACH,CAAC;QACD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,cAAc,SAAS,qJAAqJ,CACjM,CAAA;QACH,CAAC;QACD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;YACtD,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,GAAG,GAAG;QACV,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,YAAY,EAAE,IAAa;KACV,CAAA;IACnB,kGAAkG;IAClG,qFAAqF;IACrF,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/G,OAAO,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;AACtC,CAAC"}

package/dist/topics/index.d.ts

@@ -0,0 +1,7 @@
+export { defineTopic } from './define.js';
+export type { TopicDef, TopicEvent, TopicEventInit, TopicFieldValue } from './define.js';
+export { buildTopicCodec } from './codec.js';
+export type { TopicCodec, TopicFieldCodec } from './codec.js';
+export { Topics, TOPIC_HEADER_WORDS } from './store.js';
+export type { TopicsConfig } from './store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/topics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/topics/index.js

@@ -0,0 +1,4 @@
+export { defineTopic } from './define.js';
+export { buildTopicCodec } from './codec.js';
+export { Topics, TOPIC_HEADER_WORDS } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/topics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/topics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/topics/store.d.ts

@@ -0,0 +1,83 @@
+import type { Schema } from '@ecsia/schema';
+import type { Buffers } from '../memory/index.js';
+import type { TopicDef } from './define.js';
+/** Reserved-zero metadata words per event row (future: tick + publishing system; payload-only v1). */
+export declare const TOPIC_HEADER_WORDS = 2;
+export interface TopicsConfig {
+    readonly buffers: Buffers;
+    /** Mint the next dense ComponentId (the topic's virtual id; same space as relations' synthetics). */
+    readonly allocId: () => number;
+    readonly phase: () => 'serial' | 'wave';
+    readonly dev: boolean;
+    readonly warn: (message: string) => void;
+}
+export declare class Topics {
+    #private;
+    constructor(cfg: TopicsConfig);
+    /** Number of topics registered with this world. Zero ⇒ every per-frame hook is a no-op. */
+    get count(): number;
+    /** Intern a topic with this world (idempotent): mints its virtual ComponentId + canonical ring. */
+    register(def: TopicDef<Schema>): void;
+    /** The topic's virtual ComponentId, or -1 if not registered. */
+    idOf(def: TopicDef<Schema>): number;
+    /** `(name, id)` pairs for worker id alignment (the boot manifest). */
+    manifest(): readonly {
+        name: string;
+        id: number;
+    }[];
+    /** Scheduler frame hooks: world.publish is illegal while an update is in progress. */
+    beginUpdate(): void;
+    endUpdate(): void;
+    /**
+     * `world.publish` — the outside-systems path (input/network handlers, between frames). Appends
+     * directly to the canonical stream in call order, ahead of wave 0 of the next frame. Registers
+     * the topic on first use. Serial phase only; inside a system body use `ctx.publish` instead
+     * (direct appends mid-update would bypass the SystemId canonicalization).
+     */
+    publishOutside(def: TopicDef<Schema>, init: Record<string, unknown> | undefined): void;
+    /** `ctx.publish` (main-thread system) — encode now, stage to the system's segment. */
+    stageValues(def: TopicDef<Schema>, systemId: number, init: Record<string, unknown> | undefined): void;
+    /** OP_PUBLISH apply (worker publishes replayed at the command flush) — stage raw field words. */
+    stageWords(topicId: number, systemId: number, words: ArrayLike<number>, at: number, fieldWords: number): void;
+    /**
+     * The wave's serial-slot merge: for every topic with staged events, sort the staging segments by
+     * publishing SystemId ascending and append each segment FIFO to the canonical stream. Runs once
+     * per wave, after the wave's command flush — the single canonicalization point for every
+     * execution mode.
+     */
+    mergeStaged(): void;
+    /**
+     * Eagerly position a reader's cursor at plan time. Before the first update has ever run
+     * (the FIRST plan), the cursor starts at the oldest retained event so `world.publish` calls made
+     * before `createScheduler` are still delivered; once any update has run, a newly-added reader
+     * (a late re-plan join) starts at the current head — no replay of stale retained events.
+     */
+    initCursor(def: TopicDef<Schema>, readerKey: string): void;
+    /**
+     * Iterate the reader's unseen events up to the current visible head and advance its cursor —
+     * exactly-once per (reader, topic), independent cursors per reader (no drain stealing). The
+     * yielded view is pooled: read fields inside the loop, never store the view itself.
+     *
+     * A reader with no cursor starts at the oldest retained event (the manual-consumption default);
+     * scheduler consumers are positioned eagerly via `initCursor` at plan time — at the oldest
+     * retained event for the first plan (pre-plan `world.publish` events are delivered), at the
+     * current head for a re-plan join (no replay).
+     */
+    consume(def: TopicDef<Schema>, readerKey: string): IterableIterator<Record<string, unknown>>;
+    /**
+     * Frame reset (serial, quiescent): drop events two frames old, fold any spill back into the ring
+     * (regrowing it to 2x the observed peak), and compact retained rows to the ring front.
+     */
+    frameReset(): void;
+    /** Oldest retained / next sequence numbers for `def`. */
+    bounds(def: TopicDef<Schema>): {
+        tail: number;
+        head: number;
+    };
+    /**
+     * A copy of the retained canonical stream `[tail, head)` in sequence order — the byte-identity
+     * surface the serial-equivalence suite compares across worker counts and transports.
+     */
+    streamWords(def: TopicDef<Schema>): Uint32Array;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/topics/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/topics/store.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,oBAAoB,CAAA;AAKpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAoDnC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,QAAQ,GAAG,MAAM,CAAA;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED,qBAAa,MAAM;;gBAoBL,GAAG,EAAE,YAAY;IAQ7B,2FAA2F;IAC3F,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,mGAAmG;IACnG,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAsErC,gEAAgE;IAChE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM;IAInC,sEAAsE;IACtE,QAAQ,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE;IAInD,sFAAsF;IACtF,WAAW,IAAI,IAAI;IAQnB,SAAS,IAAI,IAAI;IAMjB;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI;IAYtF,sFAAsF;IACtF,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI;IAMrG,iGAAiG;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAyB7G;;;;;OAKG;IACH,WAAW,IAAI,IAAI;IA8CnB;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAK1D;;;;;;;;;OASG;IACF,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA4B7F;;;OAGG;IACH,UAAU,IAAI,IAAI;IAqFlB,yDAAyD;IACzD,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAK7D;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW;CAYhD"}

package/dist/topics/store.js

@@ -0,0 +1,416 @@
+// The world-owned topic store: one canonical event stream per topic plus the per-system staging
+// segments and per-(reader, topic) consume cursors.
+//
+// THE DETERMINISM CONTRACT (the reason this module exists): the total order of events within a
+// topic is `(frame, wave, publishing SystemId ascending, per-system FIFO append order)`.
+// `publish()` therefore NEVER appends to the canonical stream directly — it appends to a
+// per-(topic, system) staging segment, and the wave's serial slot performs ONE segment sort by
+// SystemId (`mergeStaged`). Worker publishes arrive in the same staging via OP_PUBLISH records
+// replayed at the command flush; main-thread publishes stage directly. One code path, every
+// execution mode, byte-identical stream — direct append would expose round/worker order, which
+// varies with workerCount and greedy round packing.
+//
+// The canonical stream is mutated ONLY while world.phase === 'serial' (asserted): the merge runs in
+// the wave's serial slot, so a system mid-wave reads a frozen stream with plain loads.
+//
+// Retention is double-buffered by frame (Bevy's model): at the frame reset entering frame N, every
+// event belonging to frame N-2 or earlier is dropped, so every event is visible for at least one
+// complete frame after the frame it was published in. `world.publish` calls between updates are
+// stamped for the UPCOMING frame. Overflow inside one frame spills to a main-thread array and the
+// ring is regrown to 2x the observed peak at the next frame reset — never a hard throw.
+import { isSharedBacking } from '../memory/buffers.js';
+import { UNREGISTERED } from '../component/index.js';
+import { buildTopicCodec } from './codec.js';
+/** Reserved-zero metadata words per event row (future: tick + publishing system; payload-only v1). */
+export const TOPIC_HEADER_WORDS = 2;
+const INITIAL_CAPACITY_ROWS = 256;
+const NO_SPILL = Number.MAX_SAFE_INTEGER;
+function nextPow2(n) {
+    let p = 1;
+    while (p < n)
+        p *= 2;
+    return p;
+}
+export class Topics {
+    #buffers;
+    #allocId;
+    #phase;
+    #dev;
+    #warn;
+    #byDef = new Map();
+    #byId = new Map();
+    #byName = new Map();
+    /** Topics with >= 1 staged segment this cycle — the O(1) merge-skip gate, not an event count. */
+    #stagedTopics = 0;
+    #inUpdate = false;
+    /**
+     * Has any update (or manual merge) ever run? Discriminates the FIRST plan from a late re-plan:
+     * a consumer in the first plan must see `world.publish` events appended before the plan existed
+     * (the input-event contract — "every system sees it next update"), while a consumer added by a
+     * re-plan after frames have run starts at the head (no replay of stale retained events).
+     */
+    #everUpdated = false;
+    constructor(cfg) {
+        this.#buffers = cfg.buffers;
+        this.#allocId = cfg.allocId;
+        this.#phase = cfg.phase;
+        this.#dev = cfg.dev;
+        this.#warn = cfg.warn;
+    }
+    /** Number of topics registered with this world. Zero ⇒ every per-frame hook is a no-op. */
+    get count() {
+        return this.#byDef.size;
+    }
+    /** Intern a topic with this world (idempotent): mints its virtual ComponentId + canonical ring. */
+    register(def) {
+        if (this.#byDef.has(def))
+            return;
+        if (def.id !== UNREGISTERED) {
+            throw new Error(`topic '${def.name}' is already registered with another world`);
+        }
+        const collision = this.#byName.get(def.name);
+        if (collision !== undefined) {
+            throw new Error(`a different topic named '${def.name}' is already registered with this world — topic names must be unique per world`);
+        }
+        const id = this.#allocId();
+        def.id = id;
+        const codec = buildTopicCodec(def.fields);
+        const rowWords = TOPIC_HEADER_WORDS + codec.fieldWords;
+        const capacityWords = INITIAL_CAPACITY_ROWS * rowWords;
+        const region = this.#buffers.region(`topic.${def.name}.ring`, 'u32', capacityWords, {
+            maxLength: capacityWords * 16,
+        });
+        const view = {};
+        let curWords = region.view;
+        let curBase = 0;
+        for (const f of codec.fields) {
+            Object.defineProperty(view, f.name, {
+                enumerable: true,
+                get: () => f.decode(curWords, curBase + f.offset),
+            });
+        }
+        const rt = {
+            def,
+            id,
+            name: def.name,
+            codec,
+            rowWords,
+            region,
+            ring: region.view,
+            baseSeq: 0,
+            tail: 0,
+            head: 0,
+            spill: [],
+            spillStartSeq: NO_SPILL,
+            prevFrameStart: 0,
+            frameEndHead: -1,
+            peakRows: 0,
+            staged: new Map(),
+            stagedEvents: 0,
+            cursors: new Map(),
+            view,
+            bind(words, base) {
+                curWords = words;
+                curBase = base;
+            },
+            scratchRow: new Uint32Array(Math.max(codec.fieldWords, 1)),
+            overflowWarned: false,
+        };
+        this.#byDef.set(def, rt);
+        this.#byId.set(id, rt);
+        this.#byName.set(def.name, rt);
+    }
+    #runtimeOf(def) {
+        const rt = this.#byDef.get(def);
+        if (rt === undefined) {
+            throw new Error(`topic '${def.name}' is not registered with this world — declare it in a system's publish/consume or publish it once via world.publish`);
+        }
+        return rt;
+    }
+    /** The topic's virtual ComponentId, or -1 if not registered. */
+    idOf(def) {
+        return this.#byDef.get(def)?.id ?? -1;
+    }
+    /** `(name, id)` pairs for worker id alignment (the boot manifest). */
+    manifest() {
+        return [...this.#byId.values()].map((rt) => ({ name: rt.name, id: rt.id }));
+    }
+    /** Scheduler frame hooks: world.publish is illegal while an update is in progress. */
+    beginUpdate() {
+        if (this.#inUpdate) {
+            throw new Error('topics: beginUpdate re-entered — a world update is already in progress (nested scheduler.update?)');
+        }
+        this.#inUpdate = true;
+        this.#everUpdated = true;
+    }
+    endUpdate() {
+        this.#inUpdate = false;
+        if (this.#byDef.size === 0)
+            return;
+        for (const rt of this.#byId.values())
+            rt.frameEndHead = rt.head;
+    }
+    /**
+     * `world.publish` — the outside-systems path (input/network handlers, between frames). Appends
+     * directly to the canonical stream in call order, ahead of wave 0 of the next frame. Registers
+     * the topic on first use. Serial phase only; inside a system body use `ctx.publish` instead
+     * (direct appends mid-update would bypass the SystemId canonicalization).
+     */
+    publishOutside(def, init) {
+        if (this.#inUpdate) {
+            throw new Error(`world.publish('${def.name}') called during world update — world.publish is for code outside systems; use the system's ctx.publish so the event enters the canonical (frame, wave, SystemId, FIFO) order`);
+        }
+        if (!this.#byDef.has(def))
+            this.register(def);
+        const rt = this.#runtimeOf(def);
+        rt.codec.encode(init, rt.scratchRow, 0);
+        this.#appendRow(rt, rt.scratchRow, 0);
+    }
+    /** `ctx.publish` (main-thread system) — encode now, stage to the system's segment. */
+    stageValues(def, systemId, init) {
+        const rt = this.#runtimeOf(def);
+        rt.codec.encode(init, rt.scratchRow, 0);
+        this.#stage(rt, systemId, rt.scratchRow, 0);
+    }
+    /** OP_PUBLISH apply (worker publishes replayed at the command flush) — stage raw field words. */
+    stageWords(topicId, systemId, words, at, fieldWords) {
+        const rt = this.#byId.get(topicId);
+        if (rt === undefined) {
+            this.#warn(`OP_PUBLISH names unknown topic id ${topicId}; record dropped`);
+            return;
+        }
+        if (fieldWords !== rt.codec.fieldWords) {
+            this.#warn(`OP_PUBLISH for topic '${rt.name}' carries ${fieldWords} field words, expected ${rt.codec.fieldWords}; record dropped`);
+            return;
+        }
+        this.#stage(rt, systemId, words, at);
+    }
+    #stage(rt, systemId, words, at) {
+        let segment = rt.staged.get(systemId);
+        if (segment === undefined) {
+            segment = { words: [], events: 0 };
+            rt.staged.set(systemId, segment);
+            if (rt.staged.size === 1)
+                this.#stagedTopics += 1;
+        }
+        for (let i = 0; i < rt.codec.fieldWords; i++)
+            segment.words.push(words[at + i] >>> 0);
+        segment.events += 1;
+        rt.stagedEvents += 1;
+    }
+    /**
+     * The wave's serial-slot merge: for every topic with staged events, sort the staging segments by
+     * publishing SystemId ascending and append each segment FIFO to the canonical stream. Runs once
+     * per wave, after the wave's command flush — the single canonicalization point for every
+     * execution mode.
+     */
+    mergeStaged() {
+        this.#everUpdated = true;
+        if (this.#stagedTopics === 0)
+            return;
+        if (this.#phase() !== 'serial') {
+            throw new Error('topics: canonical stream merge attempted outside the serial phase');
+        }
+        for (const rt of this.#byId.values()) {
+            if (rt.stagedEvents === 0)
+                continue;
+            const systemIds = [...rt.staged.keys()].sort((a, b) => a - b);
+            const f = rt.codec.fieldWords;
+            for (const sid of systemIds) {
+                const segment = rt.staged.get(sid);
+                for (let e = 0; e < segment.events; e++)
+                    this.#appendRow(rt, segment.words, e * f);
+            }
+            rt.staged.clear();
+            rt.stagedEvents = 0;
+        }
+        this.#stagedTopics = 0;
+    }
+    #appendRow(rt, words, at) {
+        if (this.#phase() !== 'serial') {
+            throw new Error(`topics: canonical stream for '${rt.name}' mutated outside the serial phase`);
+        }
+        const seq = rt.head;
+        const f = rt.codec.fieldWords;
+        if (rt.spillStartSeq === NO_SPILL && (seq - rt.baseSeq + 1) * rt.rowWords <= rt.ring.length) {
+            const base = (seq - rt.baseSeq) * rt.rowWords;
+            for (let i = 0; i < TOPIC_HEADER_WORDS; i++)
+                rt.ring[base + i] = 0;
+            for (let i = 0; i < f; i++)
+                rt.ring[base + TOPIC_HEADER_WORDS + i] = words[at + i] >>> 0;
+        }
+        else {
+            if (rt.spillStartSeq === NO_SPILL)
+                rt.spillStartSeq = seq;
+            for (let i = 0; i < TOPIC_HEADER_WORDS; i++)
+                rt.spill.push(0);
+            for (let i = 0; i < f; i++)
+                rt.spill.push(words[at + i] >>> 0);
+            if (this.#dev && !rt.overflowWarned) {
+                rt.overflowWarned = true;
+                this.#warn(`topic '${rt.name}' ring overflowed (${Math.floor(rt.ring.length / rt.rowWords)} rows); spilling — the ring grows to 2x peak at the next frame reset`);
+            }
+        }
+        rt.head = seq + 1;
+        const retained = rt.head - rt.tail;
+        if (retained > rt.peakRows)
+            rt.peakRows = retained;
+    }
+    /**
+     * Eagerly position a reader's cursor at plan time. Before the first update has ever run
+     * (the FIRST plan), the cursor starts at the oldest retained event so `world.publish` calls made
+     * before `createScheduler` are still delivered; once any update has run, a newly-added reader
+     * (a late re-plan join) starts at the current head — no replay of stale retained events.
+     */
+    initCursor(def, readerKey) {
+        const rt = this.#runtimeOf(def);
+        if (!rt.cursors.has(readerKey))
+            rt.cursors.set(readerKey, this.#everUpdated ? rt.head : rt.tail);
+    }
+    /**
+     * Iterate the reader's unseen events up to the current visible head and advance its cursor —
+     * exactly-once per (reader, topic), independent cursors per reader (no drain stealing). The
+     * yielded view is pooled: read fields inside the loop, never store the view itself.
+     *
+     * A reader with no cursor starts at the oldest retained event (the manual-consumption default);
+     * scheduler consumers are positioned eagerly via `initCursor` at plan time — at the oldest
+     * retained event for the first plan (pre-plan `world.publish` events are delivered), at the
+     * current head for a re-plan join (no replay).
+     */
+    *consume(def, readerKey) {
+        const rt = this.#runtimeOf(def);
+        let cursor = rt.cursors.get(readerKey) ?? rt.tail;
+        if (cursor < rt.tail) {
+            if (this.#dev) {
+                this.#warn(`topic '${rt.name}': reader '${readerKey}' missed ${rt.tail - cursor} event(s) dropped by retention; cursor snapped to the oldest retained event`);
+            }
+            cursor = rt.tail;
+        }
+        // The visible head is frozen for the duration of this iteration: merges happen only at serial
+        // slots, never while a system body runs, so `end` is the head as of the consumer's wave start.
+        const end = rt.head;
+        rt.cursors.set(readerKey, cursor);
+        for (let seq = cursor; seq < end; seq++) {
+            // Advance BEFORE the yield: a consumer that breaks out of the loop has still observed the
+            // yielded event, and exactly-once means it must not be redelivered next consume.
+            rt.cursors.set(readerKey, seq + 1);
+            if (seq >= rt.spillStartSeq) {
+                rt.bind(rt.spill, (seq - rt.spillStartSeq) * rt.rowWords + TOPIC_HEADER_WORDS);
+            }
+            else {
+                rt.bind(rt.ring, (seq - rt.baseSeq) * rt.rowWords + TOPIC_HEADER_WORDS);
+            }
+            yield rt.view;
+        }
+    }
+    /**
+     * Frame reset (serial, quiescent): drop events two frames old, fold any spill back into the ring
+     * (regrowing it to 2x the observed peak), and compact retained rows to the ring front.
+     */
+    frameReset() {
+        if (this.#byDef.size === 0)
+            return;
+        for (const rt of this.#byId.values()) {
+            // Frame boundary: events appended after the last update ended belong to the UPCOMING frame
+            // (the world.publish input-event path). Without a scheduler (no endUpdate), everything
+            // appended so far belongs to the frame now ending.
+            const boundary = rt.frameEndHead >= 0 ? rt.frameEndHead : rt.head;
+            const newTail = Math.max(rt.tail, rt.prevFrameStart);
+            rt.prevFrameStart = boundary;
+            rt.frameEndHead = -1;
+            this.#compact(rt, newTail);
+            rt.peakRows = rt.head - rt.tail;
+            rt.overflowWarned = false;
+        }
+    }
+    #compact(rt, newTail) {
+        const retained = rt.head - newTail;
+        const needWords = retained * rt.rowWords;
+        const hadSpill = rt.spillStartSeq !== NO_SPILL;
+        if (hadSpill || needWords > rt.ring.length) {
+            // Regrow to 2x the frame's peak (never below what must be retained right now), then re-place
+            // every retained row contiguously from the front.
+            const targetRows = Math.max(retained, nextPow2(rt.peakRows * 2));
+            const rows = [];
+            for (let seq = newTail; seq < rt.head; seq++) {
+                const src = seq >= rt.spillStartSeq ? rt.spill : rt.ring;
+                const base = seq >= rt.spillStartSeq
+                    ? (seq - rt.spillStartSeq) * rt.rowWords
+                    : (seq - rt.baseSeq) * rt.rowWords;
+                const row = [];
+                for (let i = 0; i < rt.rowWords; i++)
+                    row.push(src[base + i]);
+                rows.push(row);
+            }
+            this.#growRing(rt, targetRows * rt.rowWords);
+            for (let r = 0; r < rows.length; r++) {
+                const base = r * rt.rowWords;
+                for (let i = 0; i < rt.rowWords; i++)
+                    rt.ring[base + i] = rows[r][i];
+            }
+            rt.spill = [];
+            rt.spillStartSeq = NO_SPILL;
+        }
+        else if (newTail > rt.baseSeq) {
+            // Reclaim the dropped prefix in place so appends keep landing inside the ring.
+            rt.ring.copyWithin(0, (newTail - rt.baseSeq) * rt.rowWords, (rt.head - rt.baseSeq) * rt.rowWords);
+        }
+        rt.baseSeq = newTail;
+        rt.tail = newTail;
+    }
+    #growRing(rt, requiredWords) {
+        const region = rt.region;
+        const requiredBytes = requiredWords * 4;
+        if (requiredBytes <= region.backing.byteLength) {
+            rt.ring = region.view;
+            return;
+        }
+        // The reactivity-ring growth protocol: in-place resizable grow when the reservation allows,
+        // else allocate-copy re-back (serial quiescent point; main thread is the only ring reader in
+        // v1 — worker-side consume, and with it the TopicRingGrown re-wrap notice, is the deferred leg).
+        const growable = region.backing;
+        const resizeFn = growable.grow ?? growable.resize;
+        const max = growable.maxByteLength;
+        if (typeof resizeFn === 'function' && typeof max === 'number' && requiredBytes <= max) {
+            try {
+                resizeFn.call(growable, requiredBytes);
+                region.view = new Uint32Array(region.backing);
+                rt.ring = region.view;
+                return;
+            }
+            catch {
+                // fall through to re-back
+            }
+        }
+        const shared = isSharedBacking(region.backing);
+        const fresh = shared ? new SharedArrayBuffer(requiredBytes) : new ArrayBuffer(requiredBytes);
+        const freshView = new Uint32Array(fresh);
+        freshView.set(region.view);
+        region.backing = fresh;
+        region.view = freshView;
+        rt.ring = freshView;
+    }
+    // ---- introspection (tests, diagnostics) ------------------------------------------------------
+    /** Oldest retained / next sequence numbers for `def`. */
+    bounds(def) {
+        const rt = this.#runtimeOf(def);
+        return { tail: rt.tail, head: rt.head };
+    }
+    /**
+     * A copy of the retained canonical stream `[tail, head)` in sequence order — the byte-identity
+     * surface the serial-equivalence suite compares across worker counts and transports.
+     */
+    streamWords(def) {
+        const rt = this.#runtimeOf(def);
+        const out = new Uint32Array((rt.head - rt.tail) * rt.rowWords);
+        let w = 0;
+        for (let seq = rt.tail; seq < rt.head; seq++) {
+            const src = seq >= rt.spillStartSeq ? rt.spill : rt.ring;
+            const base = seq >= rt.spillStartSeq ? (seq - rt.spillStartSeq) * rt.rowWords : (seq - rt.baseSeq) * rt.rowWords;
+            for (let i = 0; i < rt.rowWords; i++)
+                out[w++] = src[base + i];
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/topics/store.js.map

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