@typeonce/ritmo 0.6.0 → 0.8.0

package/dist/System.js

@@ -47,6 +47,38 @@ export const writeResource = (descriptor) => ({
     mode: "write",
     descriptor
 });
+/**
+ * Creates a resource read that also reports `changed()`: whether a committed
+ * write left a different value since this system's previous completed run.
+ *
+ * Use it for work worth doing only when a value moved: rewriting a HUD label,
+ * rebuilding a cache from settings. Use `readResource` when the system needs
+ * the value every run anyway.
+ *
+ * A write that leaves an equal value is not a change: primitives compare
+ * with `Object.is`, plain objects and arrays by their entries, other objects
+ * by reference. This differs from `Game.Query.changed`, where every write
+ * through a component write cell counts. The first run reports `true`; a
+ * failed run (rolled back) is not a change, and a failed reader sees the same
+ * change again next run. Its own writes are not reported to the writer.
+ *
+ * Conditions (`Game.Condition.check`) cannot declare it: they own no cursor.
+ *
+ * @example
+ * ```ts
+ * const SyncHud = Game.System("SyncHud", {
+ *   resources: { score: Game.System.changedResource(Score) },
+ *   services: { hud: Game.System.service(Hud) }
+ * }, ({ resources, services }) => {
+ *   if (!resources.score.changed()) return
+ *   services.hud.score.textContent = `${resources.score.get()}`
+ * })
+ * ```
+ */
+export const changedResource = (descriptor) => ({
+    mode: "changed",
+    descriptor
+});
 /**
  * Creates an event-read declaration for a system spec.
  *
@@ -80,7 +112,7 @@ export const readEvent = (descriptor) => ({
  *
  * If the payload needs to name an entity for later work, emit a durable
  * `Game.Entity.handle(...)` (optionally with an intent component) and let the later
- * reader re-resolve it through `lookup.getHandle(...)`.
+ * reader re-resolve it through `queries.x.getHandle(...)` (through a declared query).
  *
  * @example
  * ```ts
@@ -97,6 +129,50 @@ export const writeEvent = (descriptor) => ({
     mode: "write",
     descriptor
 });
+/**
+ * Requires that every system writing this event or resource runs earlier in
+ * the same `runtime.tick(...)` call than the reading system: the reader then
+ * sees this tick's data, never last tick's. The library never reorders
+ * anything; it only checks.
+ *
+ * `runtime.tick(...)` checks it at compile time over everything passed to that
+ * call, in order (gated groups count by position), and rejects a writer that
+ * runs after the reader and a call whose order is not statically known. A
+ * read with no writer in the call compiles (a reader reused in several
+ * ticks); the `event-never-written` lint reports data nobody writes.
+ * `tryTick` checks the same at runtime.
+ *
+ * Use it on reads whose correctness depends on running after their writers
+ * (damage applied the tick it is dealt). A plain read is right when last
+ * tick's data is acceptable.
+ *
+ * On a query (`queries: { enemies: Game.System.thisTick(Enemies) }`), the
+ * writers are systems whose declared commands can change what it matches:
+ * `spawns` covering every component it requires, or `inserts` / `removes` of
+ * any component it names (selection slots, optional ones included, `with`,
+ * `without`, filters). Each must run earlier with an `applyDeferred()` (or
+ * `applyStateTransitions(...)`) between it and the reader, since commands
+ * apply only there. `despawns` never count: a despawned entity stays visible
+ * to queries until the next `applyDeferred()`. Nested schedules are
+ * flattened, gated groups count by position, and a transition bundle counts
+ * at its `applyStateTransitions(...)` step (which applies queued commands
+ * first), as if every schedule in it runs, markers inside included.
+ *
+ * @example
+ * ```ts
+ * const ApplyDamage = Game.System("ApplyDamage", {
+ *   events: { damage: Game.System.thisTick(Game.System.readEvent(Damage)) }
+ * }, ({ events }) => { ... })
+ *
+ * runtime.tick(Game.Schedule(DealDamage, ApplyDamage)) // compiles
+ * runtime.tick(Game.Schedule(ApplyDamage, DealDamage)) // "ApplyDamage needs Damage from this tick, but its writer DealDamage runs after it"
+ *
+ * const AimAtNewest = Game.System("AimAtNewest", { queries: { enemies: Game.System.thisTick(Enemies) } }, ...)
+ * runtime.tick(Game.Schedule(SpawnWave, Game.Schedule.applyDeferred(), AimAtNewest)) // compiles
+ * runtime.tick(Game.Schedule(SpawnWave, AimAtNewest)) // "AimAtNewest needs this tick's commands for queries.enemies, but SpawnWave queues them with no applyDeferred() in between"
+ * ```
+ */
+export const thisTick = (read) => ({ ...read, thisTick: true });
 /**
  * Declares read access to the current committed value of a finite-state machine.
  *
@@ -129,7 +205,7 @@ export const transition = (stateMachine) => Machine.transition(stateMachine);
  * normal events: each run sees those published since its previous run.
  *
  * This is one of the clearest signs that the modeled value should be a machine
- * rather than a plain state descriptor.
+ * rather than a resource or a `Descriptor.EntityState` component.
  */
 export const readTransitionEvent = (stateMachine) => Machine.readTransitionEvent(stateMachine);
 /**
@@ -141,8 +217,9 @@ export const readTransitionEvent = (stateMachine) => Machine.readTransitionEvent
  * ticked less often than the one that removes (rendering after several fixed
  * updates) still sees every removal. A system skipped by its run conditions
  * keeps its position, like `added`/`changed`, and sees the removals when it
- * runs again. Each log is capped at `Runtime.streamCapacity` entries; drops
- * show up as `missed` reads in the debug trace. Systems usually pair this
+ * runs again. Each log is capped at `Runtime.streamCapacity` entries; a
+ * reader that missed dropped ones sees `lagged() === true` (and a `missed`
+ * read in the debug trace). Systems usually pair this
  * with host cleanup such as removing renderer-owned nodes. {@link readDespawned}
  * complements this for whole-entity teardown.
  *
@@ -196,8 +273,8 @@ export const readDespawned = () => ({
  * Defines a system from an explicit spec and a typed implementation.
  *
  * This is the public entrypoint for authoring systems. The implementation only
- * receives the capabilities declared in the spec, and the returned effect keeps
- * service dependencies tracked in the type system.
+ * receives the capabilities declared in the spec; return
+ * `Result.failure(error)` for an expected failure (see {@link SystemRun}).
  *
  * Use the string-name overload in normal code. The name is turned into an
  * internal ordering token automatically, so the system can participate in
@@ -265,6 +342,7 @@ export function System(name, spec, run) {
         pauseWhen: spec.pauseWhen ?? [],
         transitions: spec.transitions ?? {},
         local: spec.local,
+        commands: spec.commands,
         __schemaRoot: undefined
     };
     return {

package/dist/System.js.map

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

package/dist/index.d.ts

@@ -5,7 +5,8 @@
  * small number of stable namespaces instead of many deep internal paths.
  */
 /**
- * Branding helpers for validated values.
+ * Branding helpers for packages that author validated value types (like
+ * `@typeonce/ritmo-math`). Game code validates through descriptors instead.
  */
 export * as Brand from "./Brand.ts";
 /**
@@ -17,13 +18,13 @@ export * as Decode from "./Decode.ts";
  */
 export * as Debug from "./Debug.ts";
 /**
- * Descriptor authoring helpers.
+ * Simulation time: the fixed step, the clock resource, durations in whole steps.
  */
-export * as Descriptor from "./Descriptor.ts";
+export * as Clock from "./Clock.ts";
 /**
- * Reusable validated authored definitions.
+ * Descriptor authoring helpers.
  */
-export * as Definition from "./Definition.ts";
+export * as Descriptor from "./Descriptor.ts";
 /**
  * Entity identity and proof helpers.
  */
@@ -33,9 +34,9 @@ export * as Entity from "./Entity.ts";
  */
 export * as EntityScope from "./EntityScope.ts";
 /**
- * Minimal effect-style computation type.
+ * The host's wall clock as an injected contract (`standard`, `test()`).
  */
-export * as Fx from "./Fx.ts";
+export * as HostClock from "./HostClock.ts";
 /**
  * Read-only typed world projections.
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;;GAGG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -5,7 +5,8 @@
  * small number of stable namespaces instead of many deep internal paths.
  */
 /**
- * Branding helpers for validated values.
+ * Branding helpers for packages that author validated value types (like
+ * `@typeonce/ritmo-math`). Game code validates through descriptors instead.
  */
 export * as Brand from "./Brand.js";
 /**
@@ -17,13 +18,13 @@ export * as Decode from "./Decode.js";
  */
 export * as Debug from "./Debug.js";
 /**
- * Descriptor authoring helpers.
+ * Simulation time: the fixed step, the clock resource, durations in whole steps.
  */
-export * as Descriptor from "./Descriptor.js";
+export * as Clock from "./Clock.js";
 /**
- * Reusable validated authored definitions.
+ * Descriptor authoring helpers.
  */
-export * as Definition from "./Definition.js";
+export * as Descriptor from "./Descriptor.js";
 /**
  * Entity identity and proof helpers.
  */
@@ -33,9 +34,9 @@ export * as Entity from "./Entity.js";
  */
 export * as EntityScope from "./EntityScope.js";
 /**
- * Minimal effect-style computation type.
+ * The host's wall clock as an injected contract (`standard`, `test()`).
  */
-export * as Fx from "./Fx.js";
+export * as HostClock from "./HostClock.js";
 /**
  * Read-only typed world projections.
  */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;;GAGG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/internal/cells.d.ts

@@ -15,14 +15,14 @@ import type { EntityRecord, World } from "./world.ts";
 declare abstract class WriteCellBase<T> {
     abstract get(): T;
     abstract set(value: T): void;
-    setResult<E>(result: Result.Result<T, E>): Result.Result<void, E>;
+    /** Writes a validated candidate only on success. Backs `setRaw` / `updateRaw`. */
+    writeResult<E>(result: Result.Result<T, E>): Result.Result<void, E>;
     update(f: (current: T) => T): void;
-    updateResult<E>(f: (current: T) => Result.Result<T, E>): Result.Result<void, E>;
 }
 export declare const componentRead: (record: EntityRecord, ordinal: number) => {
     get(): unknown;
 };
-export declare const componentWrite: (record: EntityRecord, ordinal: number, world: World, constructor: ResultConstructor<unknown, unknown, unknown> | undefined, state: string | undefined) => WriteCellBase<unknown>;
+export declare const componentWrite: (record: EntityRecord, ordinal: number, world: World, constructor: ResultConstructor<unknown, unknown, unknown> | undefined, entityState: string | undefined) => WriteCellBase<unknown>;
 export declare const componentOptional: (record: EntityRecord, ordinal: number) => {
     readonly present: boolean;
     get(): unknown;

package/dist/internal/cells.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cells.d.ts","sourceRoot":"","sources":["../../src/internal/cells.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGrD;;GAEG;AACH,uBAAe,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IAE5B,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAMhE;IAED,MAAM,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAEjC;IAED,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAE9E;CACF;AAyHD,eAAO,MAAM,aAAa,WAAY,YAAY,WAAW,MAAM,KAAG;IAAE,GAAG,IAAI,OAAO,CAAA;CAC9C,CAAA;AAExC,eAAO,MAAM,cAAc,WACjB,YAAY,WACX,MAAM,SACR,KAAK,eACC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,SAC9D,MAAM,GAAG,SAAS,KACxB,aAAa,CAAC,OAAO,CAIvB,CAAA;AAED,eAAO,MAAM,iBAAiB,WAAY,YAAY,WAAW,MAAM,KAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,IAAI,OAAO,CAAA;CACzE,CAAA;AAE5C,eAAO,MAAM,SAAS,UAAW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,MAAM,KAAG;IAAE,GAAG,IAAI,OAAO,CAAA;CACtD,CAAA;AAE/B;;;GAGG;AACH,eAAO,MAAM,UAAU,UACd,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OACtB,MAAM,SACJ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,eAC/B,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,KACpE,aAAa,CAAC,OAAO,CAGvB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,QAAQ,MAAM,CAAC,KAAG;IAAE,GAAG,IAAI,CAAC,CAAA;CAAqB,CAAA;AAE9E;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aACpB,MAAM,OAAO,QAClB,MAAM,CAAC,KACZ;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,IAAI,CAAC,CAAA;CAKtC,CAAA"}
+{"version":3,"file":"cells.d.ts","sourceRoot":"","sources":["../../src/internal/cells.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGrD;;GAEG;AACH,uBAAe,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IAE5B,kFAAkF;IAClF,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAMlE;IAED,MAAM,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAEjC;CAEF;AAyHD,eAAO,MAAM,aAAa,WAAY,YAAY,WAAW,MAAM,KAAG;IAAE,GAAG,IAAI,OAAO,CAAA;CAC9C,CAAA;AAExC,eAAO,MAAM,cAAc,WACjB,YAAY,WACX,MAAM,SACR,KAAK,eACC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,eACxD,MAAM,GAAG,SAAS,KAC9B,aAAa,CAAC,OAAO,CAIvB,CAAA;AAED,eAAO,MAAM,iBAAiB,WAAY,YAAY,WAAW,MAAM,KAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,IAAI,OAAO,CAAA;CACzE,CAAA;AAE5C,eAAO,MAAM,SAAS,UAAW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,MAAM,KAAG;IAAE,GAAG,IAAI,OAAO,CAAA;CACtD,CAAA;AAE/B;;;GAGG;AACH,eAAO,MAAM,UAAU,UACd,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OACtB,MAAM,SACJ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,eAC/B,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,KACpE,aAAa,CAAC,OAAO,CAGvB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,QAAQ,MAAM,CAAC,KAAG;IAAE,GAAG,IAAI,CAAC,CAAA;CAAqB,CAAA;AAE9E;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aACpB,MAAM,OAAO,QAClB,MAAM,CAAC,KACZ;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,IAAI,CAAC,CAAA;CAKtC,CAAA"}

package/dist/internal/cells.js

@@ -4,7 +4,8 @@ import { ABSENT } from "./world.js";
  * Validation behavior shared by every writable cell.
  */
 class WriteCellBase {
-    setResult(result) {
+    /** Writes a validated candidate only on success. Backs `setRaw` / `updateRaw`. */
+    writeResult(result) {
         if (!result.ok) {
             return Result.failure(result.error);
         }
@@ -14,30 +15,27 @@ class WriteCellBase {
     update(f) {
         this.set(f(this.get()));
     }
-    updateResult(f) {
-        return this.setResult(f(this.get()));
-    }
 }
 /**
  * Adds raw-validation helpers for values owned by constructed descriptors.
  */
 const withConstructor = (cell, constructor) => Object.assign(cell, {
     setRaw(raw) {
-        return cell.setResult(constructor.result(raw));
+        return cell.writeResult(constructor.result(raw));
     },
     updateRaw(f) {
-        return cell.setResult(constructor.result(f(cell.get())));
+        return cell.writeResult(constructor.result(f(cell.get())));
     }
 });
 /**
- * Adds `transition` to the write cell of a state component: a compare-and-set
+ * Adds `transition` to the write cell of an entity state component: a compare-and-set
  * that writes `to` only while the current state is still `from`.
  */
-const withTransition = (cell, state) => Object.assign(cell, {
+const withTransition = (cell, component) => Object.assign(cell, {
     transition(from, to) {
         const actual = cell.get();
         if (actual !== from) {
-            return Result.failure({ _tag: "StateMismatch", state, expected: from, actual });
+            return Result.failure({ _tag: "EntityStateMismatch", component, expected: from, actual });
         }
         cell.set(to);
         return Result.success(undefined);
@@ -115,10 +113,10 @@ class StoreWriteCell extends WriteCellBase {
     }
 }
 export const componentRead = (record, ordinal) => new ComponentReadCell(record, ordinal);
-export const componentWrite = (record, ordinal, world, constructor, state) => {
+export const componentWrite = (record, ordinal, world, constructor, entityState) => {
     const cell = new ComponentWriteCell(record, ordinal, world);
     const constructed = constructor === undefined ? cell : withConstructor(cell, constructor);
-    return state === undefined ? constructed : withTransition(constructed, state);
+    return entityState === undefined ? constructed : withTransition(constructed, entityState);
 };
 export const componentOptional = (record, ordinal) => new OptionalComponentCell(record, ordinal);
 export const storeRead = (store, key) => new StoreReadCell(store, key);

package/dist/internal/cells.js.map

@@ -1 +1 @@
-{"version":3,"file":"cells.js","sourceRoot":"","sources":["../../src/internal/cells.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cells.js","sourceRoot":"","sources":["../../src/internal/cells.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,MAAe,aAAa;IAI1B,kFAAkF;IAClF,WAAW,CAAI,MAA2B;QACxC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,CAAC,CAAoB;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACzB,CAAC;CAEF;AAED;;GAEG;AACH,MAAM,eAAe,GAAG,CACtB,IAAsB,EACtB,WAA6C,EAC7C,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;IACvB,MAAM,CAAC,GAAQ;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAClD,CAAC;IACD,SAAS,CAAC,CAAsB;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAC5D,CAAC;CACF,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,IAA4B,EAAE,SAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;IAC9F,UAAU,CAAC,IAAa,EAAE,EAAW;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACzB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3F,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACZ,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAClC,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,iBAAiB;IACZ,MAAM,CAAc;IACpB,OAAO,CAAQ;IAExB,YAAY,MAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;CACF;AAED,MAAM,kBAAmB,SAAQ,aAAsB;IAC5C,MAAM,CAAc;IACpB,OAAO,CAAQ;IACf,KAAK,CAAO;IAErB,YAAY,MAAoB,EAAE,OAAe,EAAE,KAAY;QAC7D,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,GAAG,CAAC,KAAc;QAChB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAChE,CAAC;CACF;AAED,MAAM,qBAAqB;IAChB,MAAM,CAAc;IACpB,OAAO,CAAQ;IAExB,YAAY,MAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,IAAI,OAAO;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;QACjC,OAAO,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,CAAA;IACxE,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;CACF;AAED,MAAM,aAAa;IACR,KAAK,CAAsB;IAC3B,GAAG,CAAQ;IAEpB,YAAY,KAA2B,EAAE,GAAW;QAClD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;CACF;AAED,MAAM,cAAe,SAAQ,aAAsB;IACxC,KAAK,CAAsB;IAC3B,GAAG,CAAQ;IACX,KAAK,CAAuC;IAErD,YAAY,KAA2B,EAAE,GAAW,EAAE,KAA4C;QAChG,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAED,GAAG,CAAC,KAAc;QAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAoB,EAAE,OAAe,EAAsB,EAAE,CACzF,IAAI,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAoB,EACpB,OAAe,EACf,KAAY,EACZ,WAAqE,EACrE,WAA+B,EACP,EAAE;IAC1B,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3D,MAAM,WAAW,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IACzF,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;AAC3F,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAoB,EAAE,OAAe,EAAiD,EAAE,CACxH,IAAI,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAA2B,EAAE,GAAW,EAAsB,EAAE,CACxF,IAAI,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAE/B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAA2B,EAC3B,GAAW,EACX,KAA4C,EAC5C,WAAqE,EAC7C,EAAE;IAC1B,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IAClD,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;AAC9E,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,IAAa,EAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAwB,EACxB,IAAa,EAC4B,EAAE,CAAC,CAAC;IAC7C,IAAI,OAAO;QACT,OAAO,SAAS,EAAE,CAAA;IACpB,CAAC;IACD,GAAG,EAAE,IAAI;CACV,CAAC,CAAA"}

package/dist/internal/debug.d.ts

@@ -5,6 +5,7 @@
  */
 import type * as Debug from "../Debug.ts";
 import type { Descriptor } from "../Descriptor.ts";
+import type * as EntityScope from "../EntityScope.ts";
 import type * as Machine from "../Machine.ts";
 import * as Schedule from "../Schedule.ts";
 import type { Schema } from "../Schema.ts";
@@ -22,8 +23,20 @@ export interface DescribeInput {
     readonly schema: Schema.Any;
     readonly machines: ReadonlyArray<Machine.StateMachine.Any>;
     readonly currentMachine: (machine: Machine.StateMachine.Any) => Machine.StateValue | undefined;
+    /** Whether the runtime was given an initial value for the machine. */
+    readonly providesMachine: (machine: Machine.StateMachine.Any) => boolean;
+    /** Every scope defined through the game, with its despawn triggers. */
+    readonly scopes: ReadonlyArray<EntityScope.EntityScope.Any>;
     readonly providedServices: ReadonlyArray<string>;
     readonly externallyWrittenEvents: ReadonlySet<string>;
+    /** Relations commands have tried to relate or reorder, by the queuing systems. */
+    readonly relationMutations: ReadonlyMap<string, ReadonlySet<string>>;
+    /** What each system's applied commands did, as `kind:name`; see `Runtime`. */
+    readonly commandUses: ReadonlyMap<string, ReadonlySet<string>>;
+    /** Systems that ran in this session. */
+    readonly ranSystems: ReadonlySet<string>;
+    /** Commands skipped because they would have broken a `Schema.requires` requirement. */
+    readonly requirementViolations: ReadonlyArray<Debug.RequirementViolation>;
     readonly hasResource: (descriptor: Descriptor.Any) => boolean;
     readonly schedules: ReadonlyArray<readonly [string, AnySchedule]>;
 }

package/dist/internal/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/internal/debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAA;AAG7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,KAAK,SAAS,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAChD,KAAK,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;CAAE,CAAA;AAC3E,KAAK,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAE9E,eAAO,MAAM,SAAS,eAAgB,UAAU,CAAC,GAAG,KAAG,KAAK,CAAC,OAGlD,CAAA;AAEX,eAAO,MAAM,eAAe,cAAe,OAAO,CAAC,SAAS,KAAG,MAe9D,CAAA;AAkBD,eAAO,MAAM,sBAAsB,aAAc,kBAAkB,KAAG,MAUrE,CAAA;AAiDD,eAAO,MAAM,cAAc,WAAY,SAAS,cAAc,aAAa,CAAC,MAAM,CAAC,KAAG,KAAK,CAAC,iBAsC3F,CAAA;AAqED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC1D,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAA;IAC9F,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrD,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,KAAK,OAAO,CAAA;IAC7D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;CAClE;AAED,eAAO,MAAM,QAAQ,UAAW,aAAa,KAAG,KAAK,CAAC,WA6HrD,CAAA"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/internal/debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,KAAK,WAAW,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAA;AAG7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,KAAK,SAAS,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAChD,KAAK,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;CAAE,CAAA;AAC3E,KAAK,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAE9E,eAAO,MAAM,SAAS,eAAgB,UAAU,CAAC,GAAG,KAAG,KAAK,CAAC,OAGlD,CAAA;AAEX,eAAO,MAAM,eAAe,cAAe,OAAO,CAAC,SAAS,KAAG,MAe9D,CAAA;AAkBD,eAAO,MAAM,sBAAsB,aAAc,kBAAkB,KAAG,MAUrE,CAAA;AA+ED,eAAO,MAAM,cAAc,WAAY,SAAS,cAAc,aAAa,CAAC,MAAM,CAAC,KAAG,KAAK,CAAC,iBAgD3F,CAAA;AAqED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC1D,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAA;IAC9F,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,OAAO,CAAA;IACxE,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrD,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IACpE,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9D,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACxC,uFAAuF;IACvF,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;IACzE,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,KAAK,OAAO,CAAA;IAC7D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;CAClE;AAED,eAAO,MAAM,QAAQ,UAAW,aAAa,KAAG,KAAK,CAAC,WAoOrD,CAAA"}