@oasys/oecs 0.5.4 → 0.6.0

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

@@ -1,110 +1,14 @@
 import { Store } from './store.js';
-import { EntityID } from './entity.js';
-import { OnDeleteTarget, RelationDef, RelationOptions } from './relation.js';
 import { ResourceKey } from './resource.js';
-import { EventFieldsCover, EventKey, EventReader, EventShape, SignalKey } from './event.js';
-/** Relations — sparse `(relation, target)` pairs and hierarchy traversal.
- * Add/remove/re-target cause no archetype
- * transition; ops are immediate and safe mid-tick. Traversal and wildcard
- * reads are cold-path. */
-export declare class ECSRelations {
-    private readonly store;
-    /** @internal constructed by `ECS`. */
-    constructor(store: Store);
-    /** Register a relation kind. Exclusive (default) stores one target per
-     * source; `{ multi: true }` stores a target set per source.
-     * `{ onDeleteTarget: "delete" | "clear" | "orphan" }` selects target-death
-     * cleanup (default `orphan`).
-     *
-     * The overloads stamp the CARDINALITY into the handle type, exactly like
-     * the flat `registerRelation`:
-     * the exclusive-only surfaces (`targetOf`, `ancestorsOf`/`rootOf`/
-     * `cascadeOf`, `Query.hierarchy`) accept only `RelationDef<"exclusive">`,
-     * so passing a `{ multi: true }` relation is a compile error. A
-     * dynamically-built options value falls to the erased overload and keeps
-     * the runtime check as its only guard. */
-    register(opts?: {
-        readonly exclusive?: true;
-        readonly multi?: false;
-        readonly onDeleteTarget?: OnDeleteTarget;
-    }): RelationDef<"exclusive">;
-    register(opts: {
-        readonly multi: true;
-        readonly exclusive?: false;
-        readonly onDeleteTarget?: OnDeleteTarget;
-    }): RelationDef<"multi">;
-    register(opts?: RelationOptions): RelationDef;
-    /** Count of registered relations. */
-    get count(): number;
-    /** Add a `(R, tgt)` pair to `src`. Exclusive replaces the existing target;
-     * multi adds to the set. No archetype transition. */
-    add(src: EntityID, def: RelationDef, tgt: EntityID): this;
-    /** Remove a `(R, tgt)` pair from `src`. For multi, omitting `tgt` removes
-     * all of `src`'s targets. No archetype transition. */
-    remove(src: EntityID, def: RelationDef, tgt?: EntityID): this;
-    /** Whether `src` holds any pair under `R`. */
-    has(src: EntityID, def: RelationDef): boolean;
-    /** The single target of `src` under an exclusive relation, or `undefined`. */
-    targetOf(src: EntityID, def: RelationDef<"exclusive">): EntityID | undefined;
-    /** All targets of `src` under `R`, ascending by id. */
-    targetsOf(src: EntityID, def: RelationDef): EntityID[];
-    /** Sources pointing at `tgt` under `R` (the reverse index), ascending by id.
-     * `(entity, def)` order, matching `targetOf` / `targetsOf`. */
-    sourcesOf(tgt: EntityID, def: RelationDef): EntityID[];
-    /** All `(source, target)` pairs of relation `R` — the `(R, *)` wildcard.
-     * Sources in canonical entity-index order. Cold path. */
-    pairsOf(def: RelationDef): readonly (readonly [EntityID, EntityID])[];
-    /** Every `(relation, source)` pointing at `tgt`, across all relation kinds —
-     * the `(*, T)` wildcard. Ordered by relation id then source id. */
-    sourcesOfAny(tgt: EntityID): readonly (readonly [RelationDef, EntityID])[];
-    /** Walk relation `R` up from `src` to its chain root, returning
-     * `[src, parent, …, root]` (nearest-ancestor-first). Exclusive only. */
-    ancestorsOf(src: EntityID, def: RelationDef<"exclusive">): EntityID[];
-    /** The root of `src`'s `R`-chain (`src` itself when it has no target).
-     * Exclusive only. */
-    rootOf(src: EntityID, def: RelationDef<"exclusive">): EntityID;
-    /** Walk relation `R` down from `root` over the reverse index, returning the
-     * subtree (including `root`) breadth-first — parents before children (the
-     * `cascade` order). Exclusive only. */
-    cascadeOf(root: EntityID, def: RelationDef<"exclusive">): EntityID[];
-    /** Reclaim relation reverse-index memory: drop every reverse entry whose
-     * target has been destroyed, returning the total dropped. Purely
-     * cold-path, no observable state change — call at scene/snapshot
-     * boundaries. */
-    compact(): number;
-}
-/** Event channels and signals. Emit during one `update()`, visible to every
- * later system in that call, cleared before the next. System-side reads and
- * emits go through `ctx` — this facade is the HOST-side surface. */
-export declare class ECSEvents {
-    private readonly store;
-    /** @internal constructed by `ECS`. */
-    constructor(store: Store);
-    /** Register an event channel at world setup, before anything emits on it.
-     * `fields` must name EVERY schema key — an under-registered channel would
-     * silently drop the missing fields at emit (see `EventFieldsCover`).
-     *
-     * @example
-     * const Damaged = eventKey<{ target: EntityID; amount: number }>("Damaged");
-     * ecs.events.register(Damaged, ["target", "amount"]);
-     * ecs.events.emit(Damaged, { target: e, amount: 10 }); // or ctx.emit inside a system
-     */
-    register<S extends EventShape<S>, const F extends readonly (keyof S & string)[]>(key: EventKey<S>, fields: F & EventFieldsCover<S, F>): void;
-    /** Register a signal (empty-payload event channel). */
-    registerSignal(key: SignalKey): void;
-    emit(key: SignalKey): void;
-    emit<S extends EventShape<S>>(key: EventKey<S>, values: NoInfer<S>): void;
-    read<S extends EventShape<S>>(key: EventKey<S>): EventReader<S>;
-}
-/** World resources — singleton values keyed by `ResourceKey<T>`. Runtime
- * mutations (`set` / `remove`) are access-checked as resource writes inside
- * a system span; `register` is a one-time world-setup op. */
+/** World resources, singleton values keyed by `ResourceKey<T>`. Runtime
+ * mutations (`set` and `remove`) are access-checked as resource writes inside
+ * a system span. `register` is a one-time world-setup op. */
 export declare class ECSResources {
-    private readonly store;
+    private readonly _store;
     /** @internal constructed by `ECS`. */
     constructor(store: Store);
-    /** Register a resource at world setup. Reading/writing an unregistered
-     * key throws (fail-closed) — registration is the explicit "this world has
+    /** Register a resource at world setup. Reading and writing an unregistered
+     * key throws (fail-closed), registration is the explicit "this world has
      * this singleton" declaration, not a lazy default.
      *
      * @example
@@ -115,44 +19,26 @@ export declare class ECSResources {
     register<T>(key: ResourceKey<T>, value: NoInfer<T>): void;
     get<T>(key: ResourceKey<T>): T;
     set<T>(key: ResourceKey<T>, value: NoInfer<T>): void;
-    /** Drop a resource from the world. Access-checked as a *write*;
+    /** Drop a resource from the world. Access-checked as a *write*, and it
      * fails closed on a missing key. Afterwards the key is free to `register`
-     * again — the present → absent → present lifecycle. */
+     * again, the present → absent → present lifecycle. */
     remove<T>(key: ResourceKey<T>): void;
     has<T>(key: ResourceKey<T>): boolean;
 }
-/** The determinism surface: world snapshot/resume and the
+/** The determinism surface: world snapshot and resume and the
  * canonical state digest. Every member except `deterministic` throws
  * `DETERMINISM_DISABLED` unless the world was constructed with
- * `{ deterministic: true }`. All cold-path — take captures at tick
+ * `{ deterministic: true }`. All cold-path, take captures at tick
  * boundaries (between `update()`s). */
 export declare class ECSSnapshots {
-    private readonly store;
+    protected readonly _store: Store;
     /** @internal constructed by `ECS`. */
     constructor(store: Store);
     /** Whether the determinism surface is enabled. */
     get deterministic(): boolean;
-    /** FNV-1a 32 digest over every archetype's live rows in id order — the
+    /** FNV-1a 32 digest over every archetype's live rows in id order, the
      * canonical "live ECS state digest". Per-call cost scales with live
      * entity count, not SAB capacity. */
     stateHash(): number;
-    /** Capture the full live world (dense + sparse/relations + host-side
-     * bookkeeping) to one self-contained byte buffer that `restore` can mount
-     * back onto a live, ticking world. v1 does NOT capture resources,
-     * events, or change-detection baselines. */
-    capture(): Uint8Array;
-    /** Mount a `capture()` buffer onto this live world and keep ticking.
-     * Fails closed on a malformed frame or registration mismatch BEFORE
-     * mutating any live state. Requires a matching archetype set + column
-     * layout (prewarm so the set is stable). */
-    restore(bytes: Uint8Array): void;
-    /** Serialize the sparse stores + relations to a self-contained buffer —
-     * the sparse half of a world snapshot, canonical entity-index order.
-     * Pairs with `restoreSparse`. */
-    captureSparse(): Uint8Array;
-    /** Repopulate the sparse stores + relation indices from `captureSparse`
-     * bytes. Sparse components must already be registered in the same order;
-     * throws `SparseRestoreError` on a shape or identity mismatch. */
-    restoreSparse(bytes: Uint8Array): void;
 }
 //# sourceMappingURL=facades.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"facades.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/facades.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facades.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/facades.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C;;6DAE6D;AAC7D,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,sCAAsC;gBAC1B,KAAK,EAAE,KAAK;IAIxB;;;;;;;;OAQG;IACI,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAOzD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAU9B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAU3D;;0DAEsD;IAC/C,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAUpC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO;CAG3C;AAED;;;;uCAIuC;AACvC,qBAAa,YAAY;IAGxB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACjC,sCAAsC;gBAC1B,KAAK,EAAE,KAAK;IAIxB,kDAAkD;IAClD,IAAW,aAAa,IAAI,OAAO,CAElC;IAED;;yCAEqC;IAC9B,SAAS,IAAI,MAAM;CAG1B"}

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

@@ -6,11 +6,11 @@ export interface FrameStepperOptions {
     /** Delta used by `step()` when no dt is supplied, in seconds. Default 1/60. */
     readonly fixedDt?: number;
     /** Clamp browser-frame deltas before forwarding them to `ECS.update()`, in
-     * seconds. Default 0.25. A backgrounded tab suspends rAF; the first frame
+     * seconds. Default 0.25. A backgrounded tab suspends rAF. The first frame
      * after it resumes carries the whole suspended interval as one delta, and
      * without the clamp that lands in `update()`'s accumulator as a giant
      * catch-up burst (bounded by `maxFixedSteps`, but still a burst). Manual
-     * `step()` deltas are deliberately not clamped — an explicit dt is trusted. */
+     * `step()` deltas are deliberately not clamped, an explicit dt is trusted. */
     readonly maxDt?: number;
     /** Dependency injection for tests or non-browser hosts. Defaults to `requestAnimationFrame`. */
     readonly requestFrame?: RequestFrame;
@@ -23,16 +23,16 @@ export interface FrameStepperOptions {
  * Small host-side controller for manual ECS frame stepping.
  *
  * `ECS.update(dt)` is already the authoritative "run one frame" primitive.
- * This class wraps it with pause/play controls for browser loops and an explicit
+ * This class wraps it with pause and play controls for browser loops and an explicit
  * `step()` method for debuggers, tests, editor tools, and rollback playback.
  */
 export declare class FrameStepper {
-    private readonly ecs;
-    private readonly requestFrame?;
-    private readonly cancelFrame?;
-    private frameHandle;
-    private lastTimestampMs;
-    private running;
+    private readonly _ecs;
+    private readonly _requestFrame?;
+    private readonly _cancelFrame?;
+    private _frameHandle;
+    private _lastTimestampMs;
+    private _running;
     private _fixedDt;
     private _maxDt;
     constructor(ecs: ECS, options?: FrameStepperOptions);
@@ -45,14 +45,14 @@ export declare class FrameStepper {
     step(dt?: number): void;
     /** Advance several fixed-size frames, useful for replaying a paused sim. */
     stepFrames(count: number, dt?: number): void;
-    /** Start ticking with `requestAnimationFrame`; no-op when already running. */
+    /** Start ticking with `requestAnimationFrame`. No-op when already running. */
     play(): void;
     /** Stop the automatic frame loop. Manual `step()` still works while paused. */
     pause(): void;
     toggle(): void;
     dispose(): void;
-    private scheduleNextFrame;
-    private readonly onFrame;
+    private _requestNextFrame;
+    private readonly _onFrame;
 }
 export {};
 //# sourceMappingURL=frame_stepper.d.ts.map

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

@@ -6,11 +6,11 @@ export interface FrameStepperOptions {
     /** Delta used by `step()` when no dt is supplied, in seconds. Default 1/60. */
     readonly fixedDt?: number;
     /** Clamp browser-frame deltas before forwarding them to `ECS.update()`, in
-     * seconds. Default 0.25. A backgrounded tab suspends rAF; the first frame
+     * seconds. Default 0.25. A backgrounded tab suspends rAF. The first frame
      * after it resumes carries the whole suspended interval as one delta, and
      * without the clamp that lands in `update()`'s accumulator as a giant
      * catch-up burst (bounded by `maxFixedSteps`, but still a burst). Manual
-     * `step()` deltas are deliberately not clamped — an explicit dt is trusted. */
+     * `step()` deltas are deliberately not clamped, an explicit dt is trusted. */
     readonly maxDt?: number;
     /** Dependency injection for tests or non-browser hosts. Defaults to `requestAnimationFrame`. */
     readonly requestFrame?: RequestFrame;
@@ -23,16 +23,16 @@ export interface FrameStepperOptions {
  * Small host-side controller for manual ECS frame stepping.
  *
  * `ECS.update(dt)` is already the authoritative "run one frame" primitive.
- * This class wraps it with pause/play controls for browser loops and an explicit
+ * This class wraps it with pause and play controls for browser loops and an explicit
  * `step()` method for debuggers, tests, editor tools, and rollback playback.
  */
 export declare class FrameStepper {
-    private readonly ecs;
-    private readonly requestFrame?;
-    private readonly cancelFrame?;
-    private frameHandle;
-    private lastTimestampMs;
-    private running;
+    private readonly _ecs;
+    private readonly _requestFrame?;
+    private readonly _cancelFrame?;
+    private _frameHandle;
+    private _lastTimestampMs;
+    private _running;
     private _fixedDt;
     private _maxDt;
     constructor(ecs: ECS, options?: FrameStepperOptions);
@@ -45,14 +45,14 @@ export declare class FrameStepper {
     step(dt?: number): void;
     /** Advance several fixed-size frames, useful for replaying a paused sim. */
     stepFrames(count: number, dt?: number): void;
-    /** Start ticking with `requestAnimationFrame`; no-op when already running. */
+    /** Start ticking with `requestAnimationFrame`. No-op when already running. */
     play(): void;
     /** Stop the automatic frame loop. Manual `step()` still works while paused. */
     pause(): void;
     toggle(): void;
     dispose(): void;
-    private scheduleNextFrame;
-    private readonly onFrame;
+    private _requestNextFrame;
+    private readonly _onFrame;
 }
 export {};
 //# sourceMappingURL=frame_stepper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"frame_stepper.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/frame_stepper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,KAAK,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AACnD,KAAK,YAAY,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,CAAC;AACxD,KAAK,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAM5C,MAAM,WAAW,mBAAmB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;mFAK+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAsBD;;;;;;GAMG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEJ,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,mBAAwB;IAW9D,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,MAAM,EAE/B;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,qCAAqC;IAC9B,IAAI,CAAC,EAAE,GAAE,MAAsB,GAAG,IAAI;IAI7C,4EAA4E;IACrE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAE,MAAsB,GAAG,IAAI;IAMlE,8EAA8E;IACvE,IAAI,IAAI,IAAI;IAanB,+EAA+E;IACxE,KAAK,IAAI,IAAI;IASb,MAAM,IAAI,IAAI;IAKd,OAAO,IAAI,IAAI;IAItB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAQtB;CACF"}
+{"version":3,"file":"frame_stepper.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/frame_stepper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,KAAK,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AACnD,KAAK,YAAY,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,CAAC;AACxD,KAAK,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAM5C,MAAM,WAAW,mBAAmB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;kFAK8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAsBD;;;;;;GAMG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAc;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEJ,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,mBAAwB;IAW9D,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,MAAM,EAE/B;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,qCAAqC;IAC9B,IAAI,CAAC,EAAE,GAAE,MAAsB,GAAG,IAAI;IAI7C,4EAA4E;IACrE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAE,MAAsB,GAAG,IAAI;IAMlE,8EAA8E;IACvE,IAAI,IAAI,IAAI;IAanB,+EAA+E;IACxE,KAAK,IAAI,IAAI;IASb,MAAM,IAAI,IAAI;IAKd,OAAO,IAAI,IAAI;IAItB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAQvB;CACF"}

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

@@ -1,38 +1,38 @@
 import { EntityID } from './entity.cjs';
 import { SystemDescriptor } from './system.cjs';
-import { SCHEDULE } from './schedule.cjs';
-/** A deferred structural command issued through `ctx.commands.*` (`query.ts`).
- * `spawn`/`despawn`/`enable`/`disable` carry a `null` component; `add`/`remove`
+import { PhaseName } from './phase.cjs';
+/** A deferred structural command issued through `ctx.commands.*` (`system_context.ts`).
+ * `spawn`, `despawn`, `enable` and `disable` carry a `null` component. `add` and `remove`
  * carry the affected component's id. */
 export type StructuralOp = "spawn" | "despawn" | "add" | "remove" | "enable" | "disable";
-/** An observer edge that fired at a flush (`add`/`remove`/`enable`/`disable`) or
+/** An observer edge that fired at a flush (`add`, `remove`, `enable` and `disable`) or
  * at the post-update onSet detection point (`set`). */
 export type ObserverOp = "add" | "remove" | "set" | "enable" | "disable";
 /**
  * The push sink. All callers are `DEV`-gated, so the methods receive raw ids
- * and descriptor references (no string-building on the hot path); the recorder
+ * and descriptor references, with no string-building on the hot path. The recorder
  * decides what to retain. Implementations must be side-effect-free with respect
- * to the ECS — they observe, never mutate.
+ * to the ECS. They observe, never mutate.
  */
 export interface FrameTraceSink {
     /** Opens a frame. Fired first in `ecs.update`, before any phase runs. */
     tickBegin(tick: number, dt: number): void;
-    /** Closes the frame opened by `tickBegin` (after onSet + `clearEvents`). */
+    /** Closes the frame opened by `tickBegin` (after the onSet dispatch and the event clear). */
     tickEnd(tick: number): void;
     /** A scheduled system is about to run, in the given phase. */
-    systemStart(system: SystemDescriptor, phase: SCHEDULE): void;
-    /** The system that last `systemStart`'d has returned. */
+    systemBegin(system: SystemDescriptor, phase: PhaseName): void;
+    /** The system that `systemBegin` opened has returned. */
     systemEnd(system: SystemDescriptor): void;
     /** A deferred structural command was enqueued (applied at the next flush). */
     commandQueued(op: StructuralOp, entity: EntityID, component: number | null): void;
     /** The deferred command buffer is about to drain for this phase. */
-    flushBegin(phase: SCHEDULE): void;
+    flushBegin(phase: PhaseName): void;
     /** The deferred command buffer (and any observer cascade) has settled. */
-    flushEnd(phase: SCHEDULE): void;
+    flushEnd(phase: PhaseName): void;
     /**
-     * A schedule phase has fully settled — every system in `phase` ran and the
-     * deferred command buffer (plus any observer cascade) flushed — so the live
-     * world sits at a consistent, fingerprint-able point WITHIN the frame. Fired
+     * A schedule phase has fully settled, every system in `phase` ran and the
+     * deferred command buffer (plus any observer cascade) flushed, so the live
+     * world sits at a consistent, fingerprint-able point within the frame. Fired
      * once per phase that runs (each startup phase, each fixed step, and each
      * update phase), immediately after `flushEnd(phase)`.
      *
@@ -40,22 +40,22 @@ export interface FrameTraceSink {
      * phases of one `update()` and bisect a divergence to the exact phase that
      * introduced it. `flushEnd` marks the same instant, but it
      * is an observation of the flush *mechanism*, not a "safe to read consistent
-     * state" contract — so per-phase fingerprinting binds to this method, not to a
+     * state" contract, so per-phase fingerprinting binds to this method, not to a
      * flush-internal name. Like every sink method the call is read-only w.r.t. the
      * ECS: reading `stateHash()` here cannot perturb the per-tick hash or ordering.
      *
-     * Caveat: the POST_UPDATE boundary fires BEFORE the tick-tail onSet-observer
-     * dispatch + `clearEvents`, so for a world with onSet observers the final
+     * Caveat: the POST_UPDATE boundary fires before the tick-tail onSet-observer
+     * dispatch and the event clear, so for a world with onSet observers the final
      * per-tick `stateHash` (after `update()` returns) may differ from the
      * POST_UPDATE phase hash. A world with no onSet observers reconciles exactly.
      */
-    phaseBoundary(phase: SCHEDULE): void;
+    phaseBoundary(phase: PhaseName): void;
     /** An observer callback fired for one entity (`entity === -1` for an
      * archetype-granular onSet, which has no per-entity id). */
     observerFired(op: ObserverOp, component: number, entity: number, observer: SystemDescriptor): void;
     /** A system emitted an event on `key` (the channel's symbol description). */
     eventEmitted(key: string): void;
-    /** A system read an event channel; `count` is how many events it saw. */
+    /** A system read an event channel. `count` is how many events it saw. */
     eventRead(key: string, count: number): void;
 }
 /** One captured event, as plain JSON-serialisable data (string names + numeric
@@ -63,7 +63,7 @@ export interface FrameTraceSink {
 export type FrameTraceEvent = {
     readonly kind: "system_start";
     readonly system: string;
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "system_end";
     readonly system: string;
@@ -74,10 +74,10 @@ export type FrameTraceEvent = {
     readonly component: number | null;
 } | {
     readonly kind: "flush_begin";
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "flush_end";
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "observer_fired";
     readonly op: ObserverOp;
@@ -99,10 +99,10 @@ export interface FrameTrace {
     readonly events: FrameTraceEvent[];
 }
 /**
- * The in-tree `FrameTraceSink`. Mirrors `command_log.ts`'s `openTick` /
- * `RecordedTick` shape: `tickBegin` opens a fresh `FrameTrace`, every other
+ * The in-tree `FrameTraceSink`. Mirrors the `openTick` and `RecordedTick`
+ * shape of `command_log.ts`: `tickBegin` opens a fresh `FrameTrace`, every other
  * method appends to it, `tickEnd` closes it. Events arriving with no open
- * frame (e.g. a stray pre-`update` flush) are ignored rather than throwing —
+ * frame (e.g. a stray pre-`update` flush) are ignored rather than throwing,
  * the recorder is a passive observer.
  */
 export declare class FrameTraceRecorder implements FrameTraceSink {
@@ -110,18 +110,18 @@ export declare class FrameTraceRecorder implements FrameTraceSink {
     private _current;
     tickBegin(tick: number, dt: number): void;
     tickEnd(_tick: number): void;
-    systemStart(system: SystemDescriptor, phase: SCHEDULE): void;
+    systemBegin(system: SystemDescriptor, phase: PhaseName): void;
     systemEnd(system: SystemDescriptor): void;
     commandQueued(op: StructuralOp, entity: EntityID, component: number | null): void;
-    flushBegin(phase: SCHEDULE): void;
-    flushEnd(phase: SCHEDULE): void;
+    flushBegin(phase: PhaseName): void;
+    flushEnd(phase: PhaseName): void;
     /** No-op. The recorder already marks this instant with
-     * `flushEnd`, and a per-phase fingerprint is a consumer concern — the recorder
-     * holds no world reference to hash. The seam exists so a consumer's OWN sink can
-     * run code (e.g. `stateHash()`) at the safe post-flush point; the in-tree
+     * `flushEnd`, and a per-phase fingerprint is a consumer concern, the recorder
+     * holds no world reference to hash. The seam exists so a consumer's own sink can
+     * run code (e.g. `stateHash()`) at the safe post-flush point. The in-tree
      * event-stream recorder has nothing to add, so it stays a stream of causal
      * events, not fingerprints. */
-    phaseBoundary(_phase: SCHEDULE): void;
+    phaseBoundary(_phase: PhaseName): void;
     observerFired(op: ObserverOp, component: number, entity: number, observer: SystemDescriptor): void;
     eventEmitted(key: string): void;
     eventRead(key: string, count: number): void;

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

@@ -1,38 +1,38 @@
 import { EntityID } from './entity.js';
 import { SystemDescriptor } from './system.js';
-import { SCHEDULE } from './schedule.js';
-/** A deferred structural command issued through `ctx.commands.*` (`query.ts`).
- * `spawn`/`despawn`/`enable`/`disable` carry a `null` component; `add`/`remove`
+import { PhaseName } from './phase.js';
+/** A deferred structural command issued through `ctx.commands.*` (`system_context.ts`).
+ * `spawn`, `despawn`, `enable` and `disable` carry a `null` component. `add` and `remove`
  * carry the affected component's id. */
 export type StructuralOp = "spawn" | "despawn" | "add" | "remove" | "enable" | "disable";
-/** An observer edge that fired at a flush (`add`/`remove`/`enable`/`disable`) or
+/** An observer edge that fired at a flush (`add`, `remove`, `enable` and `disable`) or
  * at the post-update onSet detection point (`set`). */
 export type ObserverOp = "add" | "remove" | "set" | "enable" | "disable";
 /**
  * The push sink. All callers are `DEV`-gated, so the methods receive raw ids
- * and descriptor references (no string-building on the hot path); the recorder
+ * and descriptor references, with no string-building on the hot path. The recorder
  * decides what to retain. Implementations must be side-effect-free with respect
- * to the ECS — they observe, never mutate.
+ * to the ECS. They observe, never mutate.
  */
 export interface FrameTraceSink {
     /** Opens a frame. Fired first in `ecs.update`, before any phase runs. */
     tickBegin(tick: number, dt: number): void;
-    /** Closes the frame opened by `tickBegin` (after onSet + `clearEvents`). */
+    /** Closes the frame opened by `tickBegin` (after the onSet dispatch and the event clear). */
     tickEnd(tick: number): void;
     /** A scheduled system is about to run, in the given phase. */
-    systemStart(system: SystemDescriptor, phase: SCHEDULE): void;
-    /** The system that last `systemStart`'d has returned. */
+    systemBegin(system: SystemDescriptor, phase: PhaseName): void;
+    /** The system that `systemBegin` opened has returned. */
     systemEnd(system: SystemDescriptor): void;
     /** A deferred structural command was enqueued (applied at the next flush). */
     commandQueued(op: StructuralOp, entity: EntityID, component: number | null): void;
     /** The deferred command buffer is about to drain for this phase. */
-    flushBegin(phase: SCHEDULE): void;
+    flushBegin(phase: PhaseName): void;
     /** The deferred command buffer (and any observer cascade) has settled. */
-    flushEnd(phase: SCHEDULE): void;
+    flushEnd(phase: PhaseName): void;
     /**
-     * A schedule phase has fully settled — every system in `phase` ran and the
-     * deferred command buffer (plus any observer cascade) flushed — so the live
-     * world sits at a consistent, fingerprint-able point WITHIN the frame. Fired
+     * A schedule phase has fully settled, every system in `phase` ran and the
+     * deferred command buffer (plus any observer cascade) flushed, so the live
+     * world sits at a consistent, fingerprint-able point within the frame. Fired
      * once per phase that runs (each startup phase, each fixed step, and each
      * update phase), immediately after `flushEnd(phase)`.
      *
@@ -40,22 +40,22 @@ export interface FrameTraceSink {
      * phases of one `update()` and bisect a divergence to the exact phase that
      * introduced it. `flushEnd` marks the same instant, but it
      * is an observation of the flush *mechanism*, not a "safe to read consistent
-     * state" contract — so per-phase fingerprinting binds to this method, not to a
+     * state" contract, so per-phase fingerprinting binds to this method, not to a
      * flush-internal name. Like every sink method the call is read-only w.r.t. the
      * ECS: reading `stateHash()` here cannot perturb the per-tick hash or ordering.
      *
-     * Caveat: the POST_UPDATE boundary fires BEFORE the tick-tail onSet-observer
-     * dispatch + `clearEvents`, so for a world with onSet observers the final
+     * Caveat: the POST_UPDATE boundary fires before the tick-tail onSet-observer
+     * dispatch and the event clear, so for a world with onSet observers the final
      * per-tick `stateHash` (after `update()` returns) may differ from the
      * POST_UPDATE phase hash. A world with no onSet observers reconciles exactly.
      */
-    phaseBoundary(phase: SCHEDULE): void;
+    phaseBoundary(phase: PhaseName): void;
     /** An observer callback fired for one entity (`entity === -1` for an
      * archetype-granular onSet, which has no per-entity id). */
     observerFired(op: ObserverOp, component: number, entity: number, observer: SystemDescriptor): void;
     /** A system emitted an event on `key` (the channel's symbol description). */
     eventEmitted(key: string): void;
-    /** A system read an event channel; `count` is how many events it saw. */
+    /** A system read an event channel. `count` is how many events it saw. */
     eventRead(key: string, count: number): void;
 }
 /** One captured event, as plain JSON-serialisable data (string names + numeric
@@ -63,7 +63,7 @@ export interface FrameTraceSink {
 export type FrameTraceEvent = {
     readonly kind: "system_start";
     readonly system: string;
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "system_end";
     readonly system: string;
@@ -74,10 +74,10 @@ export type FrameTraceEvent = {
     readonly component: number | null;
 } | {
     readonly kind: "flush_begin";
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "flush_end";
-    readonly phase: SCHEDULE;
+    readonly phase: PhaseName;
 } | {
     readonly kind: "observer_fired";
     readonly op: ObserverOp;
@@ -99,10 +99,10 @@ export interface FrameTrace {
     readonly events: FrameTraceEvent[];
 }
 /**
- * The in-tree `FrameTraceSink`. Mirrors `command_log.ts`'s `openTick` /
- * `RecordedTick` shape: `tickBegin` opens a fresh `FrameTrace`, every other
+ * The in-tree `FrameTraceSink`. Mirrors the `openTick` and `RecordedTick`
+ * shape of `command_log.ts`: `tickBegin` opens a fresh `FrameTrace`, every other
  * method appends to it, `tickEnd` closes it. Events arriving with no open
- * frame (e.g. a stray pre-`update` flush) are ignored rather than throwing —
+ * frame (e.g. a stray pre-`update` flush) are ignored rather than throwing,
  * the recorder is a passive observer.
  */
 export declare class FrameTraceRecorder implements FrameTraceSink {
@@ -110,18 +110,18 @@ export declare class FrameTraceRecorder implements FrameTraceSink {
     private _current;
     tickBegin(tick: number, dt: number): void;
     tickEnd(_tick: number): void;
-    systemStart(system: SystemDescriptor, phase: SCHEDULE): void;
+    systemBegin(system: SystemDescriptor, phase: PhaseName): void;
     systemEnd(system: SystemDescriptor): void;
     commandQueued(op: StructuralOp, entity: EntityID, component: number | null): void;
-    flushBegin(phase: SCHEDULE): void;
-    flushEnd(phase: SCHEDULE): void;
+    flushBegin(phase: PhaseName): void;
+    flushEnd(phase: PhaseName): void;
     /** No-op. The recorder already marks this instant with
-     * `flushEnd`, and a per-phase fingerprint is a consumer concern — the recorder
-     * holds no world reference to hash. The seam exists so a consumer's OWN sink can
-     * run code (e.g. `stateHash()`) at the safe post-flush point; the in-tree
+     * `flushEnd`, and a per-phase fingerprint is a consumer concern, the recorder
+     * holds no world reference to hash. The seam exists so a consumer's own sink can
+     * run code (e.g. `stateHash()`) at the safe post-flush point. The in-tree
      * event-stream recorder has nothing to add, so it stays a stream of causal
      * events, not fingerprints. */
-    phaseBoundary(_phase: SCHEDULE): void;
+    phaseBoundary(_phase: PhaseName): void;
     observerFired(op: ObserverOp, component: number, entity: number, observer: SystemDescriptor): void;
     eventEmitted(key: string): void;
     eventRead(key: string, count: number): void;

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

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