@moku-labs/game 0.14.12 → 0.14.13

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
-import { Bt as NodeFx, Dt as AnyFlow, Gt as FakeClock, Lt as Descriptor, Nt as NodeTable, Ut as ClockSource, Zt as Json, ht as FeaturePlugin, zt as Hint } from "./types-BjTtGSFb.mjs";
-import { t as createApp } from "./index-CLQ8NOTw.mjs";
-import { n as saveOf, t as memory } from "./memory-pUQ7YZWC.mjs";
-import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-CMHNsKjW.mjs";
+import { $n as NodeFx, In as FeaturePlugin, Jn as Descriptor, Qn as Hint, Rn as AnyFlow, Wn as NodeTable, ir as FakeClock, nr as ClockSource, ur as Json } from "./types-BGcda5Le.mjs";
+import { t as createApp } from "./index-DedbED3T.mjs";
+import { b as saveOf, v as WithGameState, y as memory } from "./types-C73hbmxi.mjs";
+import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-cFveciuY.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/clock/fake.d.ts
@@ -160,12 +160,12 @@ type StubsOf<Nodes extends NodeTable> = { readonly [Name in keyof Nodes & string
  *
  * @example
  * ```ts
- * const options: IsolateOptions<typeof boardFlow.nodes> = {
+ * const options: IsolateOptions<typeof boardFlow.nodes, Player> = {
  *   flow: boardFlow, shared: sharedLayer, stubs: { settings: stub("closed") }, player: fresh
  * };
  * ```
  */
-type IsolateOptions<Nodes extends NodeTable> = {
+type IsolateOptions<Nodes extends NodeTable, Player extends Json = Json, Session extends Json = Json> = {
   /** The feature's flow. It becomes the one node of the harness main flow, named by `as`. */flow: AnyFlow & {
     readonly nodes: Nodes;
   };
@@ -182,9 +182,9 @@ type IsolateOptions<Nodes extends NodeTable> = {
   as?: string; /** The shared layer, composed as `logicOnly` before the feature. */
   shared?: FeaturePlugin; /** Node name of `flow` to the stub that replaces it. A node not listed runs for real. */
   stubs?: StubsOf<Nodes>; /** More plugins the feature needs headless, for example a feature-own plugin. */
-  plugins?: readonly AnyPluginInstance[]; /** The player a new save starts from. */
-  player: Json; /** The session at start. `{}` by default. */
-  session?: Json; /** The rng seed. `1` by default. */
+  plugins?: readonly AnyPluginInstance[]; /** The player a new save starts from. Its type types `model.store.snapshot().player`. */
+  player: Player; /** The session at start. `{}` by default. Its type types `model.store.snapshot().session`. */
+  session?: Session; /** The rng seed. `1` by default. */
   seed?: number;
 };
 /**
@@ -206,6 +206,12 @@ type IsolateSeams = {
  * plugins on it.
  */
 type IsolatedApp = ReturnType<typeof createApp>;
+/**
+ * The app of an isolated feature with `model.store.snapshot()` typed by the player and session
+ * of the `isolate` call, as `WithGameState` types `game.headless()`. A call whose player and
+ * session are `Model.Json` reads a `Model.Json` snapshot, as before. Only the type.
+ */
+type IsolatedAppOf<Player, Session> = WithGameState<IsolatedApp, Player, Session>;
 /**
  * A stub: the replaced node or sub-flow ends at once with this outcome. Written as a sub-flow of
  * one transit node, so a route can still substitute it for one visit:
@@ -223,14 +229,16 @@ type IsolatedApp = ReturnType<typeof createApp>;
 declare function stub<const Name extends string>(outcome: Name, payload?: Json): Stub<Name>;
 /**
  * Composes one feature without the rest of the game: the shared layer and the feature as
- * `logicOnly`, the feature's flow inside a harness main flow `isolated`, and every stubbed node
+ * `logicOnly` (a parent feature is composed with its sub-features), the feature's flow inside a
+ * harness main flow `isolated`, and every stubbed node
  * replaced by a sub-flow that ends with the stub's outcome. Every exit of the flow lands on the
  * rest node `exited`, whose intent `again` enters the flow once more. Paths read as in the game:
  * the harness holds the flow under `options.as`, its id by default. A node that is not stubbed
  * runs for real, even when it belongs to a feature that is not composed.
  *
  * @param feature - The feature under test.
- * @param options - Its flow, the shared layer, the stubs, the starting state.
+ * @param options - Its flow, the shared layer, the stubs, the starting state. The types of
+ *   `player` and `session` type the app's `model.store.snapshot()`.
  * @returns A factory of apps, not started; pass one to `createHeadless`.
  * @throws {Error} For a stub key that is not a node of the flow, or an outcome the node does not declare.
  * @example
@@ -239,11 +247,13 @@ declare function stub<const Name extends string>(outcome: Name, payload?: Json):
  * const homeOnly = isolate(homeFeature, {
  *   flow: mainFlow, stubs: { info: stub("ok") }, player: startingPlayer, session: startingSession
  * });
- * const game = await createHeadless(homeOnly());
+ * const app = homeOnly();
+ * const game = await createHeadless(app);
  * const state = await game.walk([{ at: "main/home", intent: "info" }]);
  * state.path; // "main/home"
+ * app.model.store.snapshot().player.count; // 0, typed number: startingPlayer types the snapshot
  * ```
  */
-declare function isolate<Nodes extends NodeTable>(feature: FeaturePlugin, options: IsolateOptions<Nodes>): (seams?: IsolateSeams) => IsolatedApp;
+declare function isolate<Nodes extends NodeTable, Player extends Json = Json, Session extends Json = Json>(feature: FeaturePlugin, options: IsolateOptions<Nodes, Player, Session>): (seams?: IsolateSeams) => IsolatedAppOf<Player, Session>;
 //#endregion
 export { type FakeFx, type FakeFxOptions, type HeadlessApp, type HeadlessGame, type IsolateOptions, type IsolateSeams, type Repro, type ReproResult, type Stub, type StubsOf, createHeadless, fakeClock, fakeFx, isolate, memory, runRepro, saveOf, stepFrames, stub };

package/dist/testing.mjs

@@ -1,6 +1,6 @@
-import { Ut as refuseStart, Wt as exit, qt as type, t as createApp } from "./src-CtC8w3_z.mjs";
+import { $t as refuseStart, en as exit, p as flattenFeatures, rn as type, t as createApp } from "./src-BEbJ_sSx.mjs";
 import { n as saveOf, t as memory } from "./memory-CWlqhS7l.mjs";
-import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
+import { t as fakeClock } from "./fake-6mazmHK3.mjs";
 import { i as stepFrames, r as runRepro, t as createHeadless } from "./headless-BA6ffzqD.mjs";
 //#region src/testing/fake-fx.ts
 /** The node path a refused `fx.start` names when the test gives none. */
@@ -235,14 +235,16 @@ function harnessOf(flow, name = flow.id) {
 }
 /**
 * Composes one feature without the rest of the game: the shared layer and the feature as
-* `logicOnly`, the feature's flow inside a harness main flow `isolated`, and every stubbed node
+* `logicOnly` (a parent feature is composed with its sub-features), the feature's flow inside a
+* harness main flow `isolated`, and every stubbed node
 * replaced by a sub-flow that ends with the stub's outcome. Every exit of the flow lands on the
 * rest node `exited`, whose intent `again` enters the flow once more. Paths read as in the game:
 * the harness holds the flow under `options.as`, its id by default. A node that is not stubbed
 * runs for real, even when it belongs to a feature that is not composed.
 *
 * @param feature - The feature under test.
-* @param options - Its flow, the shared layer, the stubs, the starting state.
+* @param options - Its flow, the shared layer, the stubs, the starting state. The types of
+*   `player` and `session` type the app's `model.store.snapshot()`.
 * @returns A factory of apps, not started; pass one to `createHeadless`.
 * @throws {Error} For a stub key that is not a node of the flow, or an outcome the node does not declare.
 * @example
@@ -251,16 +253,18 @@ function harnessOf(flow, name = flow.id) {
 * const homeOnly = isolate(homeFeature, {
 *   flow: mainFlow, stubs: { info: stub("ok") }, player: startingPlayer, session: startingSession
 * });
-* const game = await createHeadless(homeOnly());
+* const app = homeOnly();
+* const game = await createHeadless(app);
 * const state = await game.walk([{ at: "main/home", intent: "info" }]);
 * state.path; // "main/home"
+* app.model.store.snapshot().player.count; // 0, typed number: startingPlayer types the snapshot
 * ```
 */
 function isolate(feature, options) {
 	const mainFlow = harnessOf(withStubs(options.flow, options.stubs ?? {}), options.as);
 	const plugins = [
 		...options.shared === void 0 ? [] : [options.shared.logicOnly],
-		feature.logicOnly,
+		...flattenFeatures([feature.logicOnly]),
 		...options.plugins ?? []
 	];
 	return (seams = {}) => createApp({