@moku-labs/game 0.7.0 → 0.8.0

package/dist/{types-CYYKjvLn.d.mts → types-CDSKa0vl.d.mts}

@@ -1,184 +1,7 @@
-import { At as JournalEntry, Kt as Json, Lt as Answer, Rt as Api, in as RngState, jt as RouteStep, kt as FlowState, tn as Snapshot, ut as Api$1 } from "./types-BMEn0tSC.mjs";
+import { R as Json, q as Snapshot } from "./types-ERb2Y9U5.mjs";
+import { t as HeadlessApp } from "./headless-q98SwADR.mjs";
 import { Log } from "@moku-labs/common/browser";
 
-//#region src/plugins/flow/headless.d.ts
-/**
- * The part of an app the headless helpers use. Structural on purpose: any app created with the
- * default plugins fits.
- *
- * @example
- * ```ts
- * const app: HeadlessApp = createApp({ pluginConfigs: { flow: { mainFlow } } });
- * ```
- */
-type HeadlessApp = {
-  start(): Promise<void>;
-  stop(): Promise<void>;
-  time: Api;
-  flow: Api$1;
-};
-/**
- * A game played without a screen: answers go through the gate, effects resolve instantly.
- *
- * @example
- * ```ts
- * // A test of the dice game: two rolls, no screen, no waiting.
- * const game = await createHeadless(app);
- * const state = await game.walk([{ at: "home", intent: "roll" }, { at: "home", intent: "roll" }]);
- *
- * state.path; // "home"
- * await game.stop();
- * ```
- */
-type HeadlessGame = {
-  /**
-   * Walks a route through the running loop.
-   *
-   * @param route - The player's answers and substituted sub-flow results, in order.
-   * @returns The state the walk ended in.
-   * @throws {Error} When a step is never reached, or the loop failed fatally.
-   * @example
-   * ```ts
-   * // Open the board and tap the generator twice. Every node's logic runs for real.
-   * const tap = { at: "board/awaitIntent", intent: "tap", payload: { generatorId: "sawmill" } };
-   * const state = await game.walk([{ at: "home", intent: "play" }, tap, tap]);
-   *
-   * state.path; // "board/awaitIntent"
-   * ```
-   */
-  walk(route: readonly RouteStep[]): Promise<FlowState>;
-  /**
-   * Gives one answer to the gate, the way a tap does.
-   *
-   * @param answer - Intent and optional payload.
-   * @returns Whether the gate took it.
-   * @example
-   * ```ts
-   * // One tap without a route. The test then waits for the loop by itself.
-   * game.answer({ intent: "play" }); // true: "home" rests and lists "play"
-   * ```
-   */
-  answer(answer: Answer): boolean;
-  /**
-   * Reads where the graph stands.
-   *
-   * @returns Whether it runs, the path, the stack, what it waits for and the mode.
-   * @example
-   * ```ts
-   * // Right after createHeadless: the graph rests at its first rest node.
-   * game.state().path; // "home"
-   * game.state().pending; // { gate: ["play"] }
-   * ```
-   */
-  state(): FlowState;
-  /**
-   * Reads the edges taken since the last checkpoint.
-   *
-   * @returns A copy of the journal.
-   * @example
-   * ```ts
-   * // After a merge onto an empty cell: the last edge says why the move was refused.
-   * const last = game.history().at(-1);
-   * // last?.path: "board/merge", last?.outcome: "rejected", last?.payload: { reason: "empty" }
-   * ```
-   */
-  history(): readonly JournalEntry[];
-  /**
-   * Stops the app, then re-throws a fatal error of the loop.
-   *
-   * @throws {Error} When the loop failed fatally.
-   * @example
-   * ```ts
-   * // The last line of a headless test. A fatal error of the loop fails the test here.
-   * await game.stop();
-   * ```
-   */
-  stop(): Promise<void>;
-};
-/**
- * A reproducible run: a starting state, an optional checkpoint and the route played from it.
- *
- * @example
- * ```ts
- * const repro: Repro = { player: { coins: 0 }, checkpoint: "home", route: [{ at: "home", intent: "play" }] };
- * ```
- */
-type Repro = {
-  player: Json;
-  session?: Json;
-  rng?: RngState;
-  checkpoint?: string;
-  route: RouteStep[];
-};
-/**
- * What a repro run ends with: the path where the loop rests and the committed state.
- *
- * @example
- * ```ts
- * const result: ReproResult = { path: ["home"], player: { coins: 3 }, session: { visits: 1 } };
- * ```
- */
-type ReproResult = {
-  path: string[];
-  player: Json;
-  session: Json;
-};
-/**
- * Starts an app headless: sets flow mode `"fast"`, awaits `app.start()`, starts `flow.run()`
- * unless the app's own `onStart` already did, and waits until the loop rests for the first time.
- * `game.state().path` therefore names the first rest node of the graph as soon as the call
- * resolves. A fatal error of the loop rejects this call, and a later one is re-thrown by `walk`
- * and by `stop`, so a headless test never loses it.
- *
- * @param app - An app that is not started yet.
- * @returns The game: walk it, answer it, read it, stop it.
- * @throws {Error} When the loop failed fatally before it reached its first rest node.
- * @example
- * ```ts
- * // A test starts the merge game without a screen. The call resolves at the first rest node.
- * const game = await createHeadless(app);
- *
- * game.state().path; // "home": the transit node "boot" was played out
- * game.state().mode; // "fast"
- * await game.stop();
- * ```
- */
-declare function createHeadless(app: HeadlessApp): Promise<HeadlessGame>;
-/**
- * Plays a repro: starts the app headless, restores the bookmark built from its state and
- * checkpoint, then walks its route. The app keeps running, so the caller can read more than the
- * result and stops it itself.
- *
- * @param app - An app that is not started yet.
- * @param repro - Starting state, optional checkpoint and the route.
- * @returns The path the run ended at, and the committed state.
- * @example
- * ```ts
- * // A bug report on the dice game: "reset keeps my coins". Replay it from the "home" checkpoint.
- * const reset = { at: "home", intent: "reset" };
- * const result = await runRepro(app, { player: { coins: 7 }, checkpoint: "home", route: [reset] });
- *
- * result.player; // { coins: 0 }; result.path is ["home"]
- * await app.stop(); // the app keeps running after the run
- * ```
- */
-declare function runRepro(app: HeadlessApp, repro: Repro): Promise<ReproResult>;
-/**
- * Steps the frame loop by hand: `count` calls of `app.time.step(deltaMs)`. A headless game has no
- * frame source, so this is the only thing that moves the frame phases.
- *
- * @param app - A started app.
- * @param count - Number of frames.
- * @param deltaMs - Milliseconds per frame.
- * @example
- * ```ts
- * // A headless game has no frame source: the test moves the six frame phases by hand.
- * stepFrames(app, 2, 16);
- * app.time.snapshot(); // frame: 2, delta: 16, elapsed: 32
- * ```
- */
-declare function stepFrames(app: HeadlessApp, count: number, deltaMs: number): void;
-//#endregion
 //#region src/plugins/flow/doors/types.d.ts
 /**
  * The kinds an input field can take. `json` is any JSON value the command checks itself.
@@ -276,7 +99,7 @@ type Effect = "read" | "route" | "cosmetic" | "cheat" | "raw";
  * ```ts
  * // A game's .dev module: the coins a panel shows, re-read on every commit.
  * const coins = defineSource({
- *   id: "timber.coins",
+ *   id: "mini.coins",
  *   title: "Coins",
  *   input: {},
  *   changes: "commit",
@@ -300,7 +123,7 @@ type Source<S extends InputSchema, O, App = HeadlessApp> = {
  * ```ts
  * // A game's .dev module: jump to a level through the graph, the session stays clean.
  * const jumpToLevel = defineCommand({
- *   id: "timber.jumpToLevel",
+ *   id: "mini.jumpToLevel",
  *   title: "Go to level",
  *   input: { level: "number" },
  *   effect: "route",
@@ -389,4 +212,4 @@ type ControlApp = HeadlessApp & {
   readonly log: Log.LogApi;
 };
 //#endregion
-export { stepFrames as _, InputOf as a, Source as c, HeadlessApp as d, HeadlessGame as f, runRepro as g, createHeadless as h, InputArguments as i, WatchApp as l, ReproResult as m, Command as n, InputSchema as o, Repro as p, ControlApp as r, Ran as s, CheatEntry as t, WatchInput as u };
+export { InputOf as a, Source as c, InputArguments as i, WatchApp as l, Command as n, InputSchema as o, ControlApp as r, Ran as s, CheatEntry as t, WatchInput as u };

package/dist/{types-ClF8say0.d.mts → types-DF5kkW-C.d.mts}

@@ -1,5 +1,6 @@
-import { D as Point, E as FilterSlot, L as ComponentHandle, V as Entity, _ as PixiModule, _n as Events$1, g as PixiFilter, k as Api$1, m as Api$2, o as Events, t as Api$3, ut as Api, v as PixiSprite, vn as Require, y as PixiTexture, z as ComponentType } from "./types-BMEn0tSC.mjs";
-import { b as AnimApi } from "./types-CXyipKhE.mjs";
+import { lt as Events, t as Api, ut as Require } from "./types-ERb2Y9U5.mjs";
+import { D as Point, E as FilterSlot, L as ComponentHandle, V as Entity, _ as PixiModule, g as PixiFilter, k as Api$1, m as Api$2, o as Events$1, t as Api$3, v as PixiSprite, y as PixiTexture, z as ComponentType } from "./types-BWzCSRM2.mjs";
+import { b as AnimApi } from "./types-DlgsfOmW.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -643,10 +644,10 @@ type EffectsCtx = KernelSlice & {
 /**
  * Payload of the `assets:bundle-unloaded` hook: `keys` names every texture that is gone.
  */
-type BundleUnloaded = Events["assets:bundle-unloaded"];
+type BundleUnloaded = Events$1["assets:bundle-unloaded"];
 /**
  * Payload of the global `ui:hot-swap` hook: the saved file and its new exports.
  */
-type HotSwap = Events$1["ui:hot-swap"];
+type HotSwap = Events["ui:hot-swap"];
 //#endregion
 export { NoiseValue as _, types_d_exports as a, EmitterValue as c, ColorMatrixValue as d, DisplacementValue as f, GlowValue as g, FilterValueOf as h, State as i, AlphaValue as l, FilterSpec as m, EffectsApi as n, EmitterConfig as o, FilterComponent as p, EffectsStats as r, EmitterDefinition as s, Config as t, BlurValue as u, OutlineValue as v, UniformDeclaration as y };

package/dist/{types-BaUUcIaN.d.mts → types-DgdMLZnV.d.mts}

@@ -1,4 +1,5 @@
-import { B as ComponentValue, D as Point$2, F as AnyComponentType, I as AnyComponentValue, It as Hint, Kt as Json, O as ViewportSize, P as AnyComponent, Pt as Descriptor, Rt as Api, V as Entity, Z as ChangeHook, at as ProjectionMotion, dn as Api$5, it as NumericFields, k as Api$2, lt as ViewHandle, m as Api$3, nt as Motion, o as Events$1, rt as MotionHandle, t as Api$4, ut as Api$1, vn as Require, z as ComponentType } from "./types-BMEn0tSC.mjs";
+import { A as Api, E as Descriptor, O as Hint, R as Json, rt as Api$2, t as Api$1, ut as Require } from "./types-ERb2Y9U5.mjs";
+import { B as ComponentValue, D as Point$2, F as AnyComponentType, I as AnyComponentValue, O as ViewportSize, P as AnyComponent, V as Entity, Z as ChangeHook, at as ProjectionMotion, it as NumericFields, k as Api$3, lt as ViewHandle, m as Api$4, nt as Motion, o as Events$1, rt as MotionHandle, t as Api$5, z as ComponentType } from "./types-BWzCSRM2.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -634,8 +635,8 @@ type InputApi = {
 type Deps$1 = {
   time: Api;
   flow: Api$1;
-  world: Api$2;
-  renderer: Api$3;
+  world: Api$3;
+  renderer: Api$4;
 };
 /**
  * What the kernel context offers before the deps are attached.
@@ -1510,11 +1511,11 @@ type TextApi = {
 type Deps = {
   time: Api;
   flow: Api$1;
-  world: Api$2;
-  renderer: Api$3;
-  assets: Api$4;
+  world: Api$3;
+  renderer: Api$4;
+  assets: Api$5;
   i18n: I18nApi;
-  clock: Api$5;
+  clock: Api$2;
 };
 /**
  * What the kernel context offers before the deps are attached.

package/dist/{types-CXyipKhE.d.mts → types-DlgsfOmW.d.mts}

@@ -1,5 +1,6 @@
-import { $ as Ease, Gt as Events$3, I as AnyComponentValue, K as Owner, Kt as Json, L as ComponentHandle, Nt as TypeTag, P as AnyComponent, Pt as Descriptor, Rt as Api, Ut as Api$5, V as Entity, _n as Events$2, ct as TrackSegment, et as LayerSort, it as NumericFields, k as Api$2, m as Api$3, o as Events$5, rt as MotionHandle, sn as Events$4, st as TrackOptions, t as Api$4, tt as LayerSpec, ut as Api$1, vn as Require, z as ComponentType } from "./types-BMEn0tSC.mjs";
-import { D as TextApi, H as InputApi, I as I18nApi, c as UiNode, i as Finding, n as ElementChange, o as JsxState, r as ElementMotion, v as StylesState } from "./types-BaUUcIaN.mjs";
+import { $ as Events$4, A as Api, E as Descriptor, F as Api$2, L as Events$3, R as Json, T as TypeTag, lt as Events$2, t as Api$1, ut as Require } from "./types-ERb2Y9U5.mjs";
+import { $ as Ease, I as AnyComponentValue, K as Owner, L as ComponentHandle, P as AnyComponent, V as Entity, ct as TrackSegment, et as LayerSort, it as NumericFields, k as Api$3, m as Api$4, o as Events$5, rt as MotionHandle, st as TrackOptions, t as Api$5, tt as LayerSpec, z as ComponentType } from "./types-BWzCSRM2.mjs";
+import { D as TextApi, H as InputApi, I as I18nApi, c as UiNode, i as Finding, n as ElementChange, o as JsxState, r as ElementMotion, v as StylesState } from "./types-DgdMLZnV.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 import { Node, Yoga } from "yoga-layout/load";
@@ -1065,7 +1066,7 @@ type AnimApi = {
 type Deps$3 = {
   time: Api;
   flow: Api$1;
-  world: Api$2;
+  world: Api$3;
 };
 /**
  * What the kernel context offers before the deps are attached.
@@ -1211,8 +1212,8 @@ type Deps$2 = {
   anim: AnimApi;
   time: Api;
   flow: Api$1;
-  world: Api$2;
-  renderer: Api$3;
+  world: Api$3;
+  renderer: Api$4;
   input: InputApi;
   i18n: I18nApi;
   text: TextApi;
@@ -1568,8 +1569,8 @@ type ScenesApi = {
  */
 type Deps$1 = {
   flow: Api$1;
-  world: Api$2;
-  assets: Api$4;
+  world: Api$3;
+  assets: Api$5;
   time: Api;
 };
 /**
@@ -1944,8 +1945,8 @@ type AudioApi = {
  */
 type Deps = {
   flow: Api$1;
-  assets: Api$4;
-  model: Api$5;
+  assets: Api$5;
+  model: Api$2;
   time: Api;
 };
 /**