@moku-labs/game 0.10.0 → 0.11.0

package/dist/app/page.d.mts

@@ -1,4 +1,4 @@
-import { h as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-hQgI_wrq.mjs";
+import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-Ca_z_4tQ.mjs";
 
 //#region src/app/page.d.ts
 /**
@@ -20,7 +20,7 @@ import { h as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions }
  * // Written by moku-game dev. Do not edit.
  * import "./dev.ts";
  * import { startPage } from "@moku-labs/game/app/page";
- * import { systemShell } from "@moku-labs/game/app/system";
+ * import { systemShellOf } from "@moku-labs/game/app/system";
  * import game from "../index.ts";
  * import config from "../config.ts";
  * import scenario0 from "../tests/scenarios/empty.ts";
@@ -30,7 +30,10 @@ import { h as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions }
  *
  * await startPage(game, config, {
  *   scenarios: { "empty": scenario0, "full": scenario1 },
- *   system: systemShell,
+ *   system: systemShellOf({
+ *     system: () => import("@moku-labs/system"),
+ *     lifecycle: () => import("@moku-labs/system/lifecycle")
+ *   }),
  *   agents: [agent0],
  *   devModules: [devModule0]
  * });

package/dist/app/page.mjs

@@ -322,7 +322,7 @@ async function startAgents(app, settings, options) {
 * // Written by moku-game dev. Do not edit.
 * import "./dev.ts";
 * import { startPage } from "@moku-labs/game/app/page";
-* import { systemShell } from "@moku-labs/game/app/system";
+* import { systemShellOf } from "@moku-labs/game/app/system";
 * import game from "../index.ts";
 * import config from "../config.ts";
 * import scenario0 from "../tests/scenarios/empty.ts";
@@ -332,7 +332,10 @@ async function startAgents(app, settings, options) {
 *
 * await startPage(game, config, {
 *   scenarios: { "empty": scenario0, "full": scenario1 },
-*   system: systemShell,
+*   system: systemShellOf({
+*     system: () => import("@moku-labs/system"),
+*     lifecycle: () => import("@moku-labs/system/lifecycle")
+*   }),
 *   agents: [agent0],
 *   devModules: [devModule0]
 * });

package/dist/app/system.d.mts

@@ -1,6 +1,6 @@
 import { tn as PlayerStateProvider } from "../types-ZQLYXo5X.mjs";
-import { ot as PlatformProvider } from "../index-xxSxKJJW.mjs";
-import { _ as SystemShell, d as ResolvedGameConfig, g as SystemName } from "../types-hQgI_wrq.mjs";
+import { ot as PlatformProvider } from "../index-8TiJQjQA.mjs";
+import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-Ca_z_4tQ.mjs";
 import { Back, Haptics, KeepAwake, Lifecycle, Store } from "@moku-labs/system";
 
 //#region src/app/system.d.ts
@@ -11,7 +11,8 @@ import { Back, Haptics, KeepAwake, Lifecycle, Store } from "@moku-labs/system";
  *
  * @example
  * ```ts
- * const slice: SystemSlice = await createSystemApp(["haptics"], "moku-game"); // slice.haptics only
+ * const modules = { system: () => import("@moku-labs/system"), haptics: () => import("@moku-labs/system/haptics") };
+ * const slice: SystemSlice = await createSystemApp(["haptics"], "moku-game", modules); // slice.haptics only
  * ```
  */
 type SystemSlice = {
@@ -36,7 +37,11 @@ type StoreSlice = Pick<Store.StoreApi, "get" | "set">;
  *
  * @example
  * ```ts
- * const system: SystemApp = await createSystemApp(["lifecycle", "store"], "com.mokulabs.timber");
+ * const system: SystemApp = await createSystemApp(["lifecycle", "store"], "com.mokulabs.timber", {
+ *   system: () => import("@moku-labs/system"),
+ *   lifecycle: () => import("@moku-labs/system/lifecycle"),
+ *   store: () => import("@moku-labs/system/store")
+ * });
  * await system.start(); // system.lifecycle and system.store answer from here on
  * ```
  */
@@ -64,22 +69,28 @@ declare function fromSystem(system: SystemSlice): PlatformProvider;
 /**
  * Creates the `@moku-labs/system` app of the named plugins, in the fixed order `lifecycle`,
  * `back`, `haptics`, `keepAwake`, `store`, each name once. The store is named after `namespace`.
- * Each plugin is loaded by its own `import()`, so a page loads only the plugins its game names.
- * The app is not started.
+ * Each plugin is loaded by its loader in `modules`, and only the named ones are called, so a page
+ * loads only the plugins its game names. The app is not started.
  *
  * @param names - The system plugins the game names, in any order.
  * @param namespace - The store name: the native identifier, or `"moku-game"`.
+ * @param modules - The loaders of the page: the package, and one per named plugin.
  * @returns The system app, not started.
- * @throws {Error} When `@moku-labs/system` is not installed.
+ * @throws {Error} When a named plugin has no loader in `modules`, or a loader rejects because
+ *   `@moku-labs/system` is not installed.
  * @example
  * ```ts
  * // A shell of its own: the store named after the app, and the haptics.
- * const system = await createSystemApp(["store", "haptics"], "com.mokulabs.timber");
+ * const system = await createSystemApp(["store", "haptics"], "com.mokulabs.timber", {
+ *   system: () => import("@moku-labs/system"),
+ *   haptics: () => import("@moku-labs/system/haptics"),
+ *   store: () => import("@moku-labs/system/store")
+ * });
  * await system.start();
  * await system.haptics?.selection(); // { ok: false, provider: "web", reason: "unsupported" } in iOS Safari
  * ```
  */
-declare function createSystemApp(names: readonly SystemName[], namespace: string): Promise<SystemApp>;
+declare function createSystemApp(names: readonly SystemName[], namespace: string, modules: SystemModules): Promise<SystemApp>;
 /**
  * Builds the save provider over the system store: idb on the web, the Tauri store in the native
  * app. It holds the document it loaded and applies each commit's patches to it, then queues one
@@ -102,28 +113,32 @@ declare function createSystemApp(names: readonly SystemName[], namespace: string
  */
 declare function storeSave(store: StoreSlice, key: string, report: (problem: string) => void): PlayerStateProvider;
 /**
- * Builds the system shell from the resolved `config.ts`: the `@moku-labs/system` app of the names
- * `config.system` lists, plus the store when `config.save` is `"store"`, in the fixed order. It
- * hands the engine the platform provider over that app and, for a store save, the save provider.
- * The page starts the shell before the game; this function does not start it. The generated
- * `main.ts` passes the function itself to `startPage`, only when `config.ts` names a system
- * plugin or the store save.
+ * Makes the system shell factory of a page over its loaders. The factory builds the shell from the
+ * resolved `config.ts`: the `@moku-labs/system` app of the names `config.system` lists, plus the
+ * store when `config.save` is `"store"`, in the fixed order. It hands the engine the platform
+ * provider over that app and, for a store save, the save provider. Nothing loads until the page
+ * calls the factory, and the page starts the shell before the game. The generated `main.ts`
+ * passes it to `startPage` with one loader per name, only when `config.ts` names a system plugin
+ * or the store save.
  *
- * @param config - The resolved `config.ts` of the game.
- * @param report - Takes a problem the page reports later, such as a write the store refused.
- * @returns The shell, not started.
- * @throws {Error} When `@moku-labs/system` is not installed.
+ * @param modules - The loaders of the page: the package, and one per named plugin.
+ * @returns The factory the page calls; it throws the messages of `createSystemApp`.
  * @example
  * ```ts
- * // The in-memory .moku/build/main.ts of moku-game build, for a game whose config.ts names system plugins.
+ * // The in-memory .moku/build/main.ts of moku-game build, for a game whose config.ts names back.
  * import { startPage } from "@moku-labs/game/app/page";
- * import { systemShell } from "@moku-labs/game/app/system";
+ * import { systemShellOf } from "@moku-labs/game/app/system";
  * import game from "../../index.ts";
  * import config from "../../config.ts";
  *
- * await startPage(game, config, { system: systemShell });
+ * await startPage(game, config, {
+ *   system: systemShellOf({
+ *     system: () => import("@moku-labs/system"),
+ *     back: () => import("@moku-labs/system/back")
+ *   })
+ * });
  * ```
  */
-declare function systemShell(config: ResolvedGameConfig, report: (problem: string) => void): Promise<SystemShell>;
+declare function systemShellOf(modules: SystemModules): SystemShellFactory;
 //#endregion
-export { StoreSlice, SystemApp, SystemSlice, createSystemApp, fromSystem, storeSave, systemShell };
+export { StoreSlice, SystemApp, type SystemModules, SystemSlice, createSystemApp, fromSystem, storeSave, systemShellOf };

package/dist/app/system.mjs

@@ -8,21 +8,6 @@ const systemOrder = [
 	"keepAwake",
 	"store"
 ];
-/** One lazy import per capability plugin: the page loads only the plugins the game names. */
-const capabilityLoaders = {
-	lifecycle: () => import("@moku-labs/system/lifecycle").then((module) => module.lifecyclePlugin),
-	back: () => import("@moku-labs/system/back").then((module) => module.backPlugin),
-	haptics: () => import("@moku-labs/system/haptics").then((module) => module.hapticsPlugin),
-	keepAwake: () => import("@moku-labs/system/keep-awake").then((module) => module.keepAwakePlugin)
-};
-/**
-* Loads the store plugin, by its own lazy import.
-*
-* @returns The store plugin.
-*/
-function loadStore() {
-	return import("@moku-labs/system/store").then((module) => module.storePlugin);
-}
 /** The store namespace of a game with no native identifier. */
 const defaultNamespace = "moku-game";
 /** The store key of the save, inside the game's namespace. */
@@ -99,20 +84,45 @@ function fromSystem(system) {
 	};
 }
 /**
-* Loads `@moku-labs/system` and the plugins of the names, all at once.
+* Refuses a named plugin the page has no loader for, before anything loads. The generated
+* `main.ts` writes a loader per name; a page of its own may miss one.
+*
+* @param names - The system plugins of the shell.
+* @param modules - The loaders of the page.
+* @throws {Error} When a name has no loader.
+*/
+function checkLoaders(names, modules) {
+	const missing = names.find((name) => modules[name] === void 0);
+	if (missing !== void 0) throw new Error(`[game] config.system names "${missing}", but main.ts has no loader for it.`);
+}
+/**
+* One plugin per capability, through the loader of the page. The loaders are checked first, so
+* each one called is there.
+*/
+const capabilityPlugins = {
+	lifecycle: (modules) => modules.lifecycle?.().then((module) => module.lifecyclePlugin),
+	back: (modules) => modules.back?.().then((module) => module.backPlugin),
+	haptics: (modules) => modules.haptics?.().then((module) => module.hapticsPlugin),
+	keepAwake: (modules) => modules.keepAwake?.().then((module) => module.keepAwakePlugin)
+};
+/**
+* Loads `@moku-labs/system` and the plugins of the names, all at once, with the loaders of the
+* page.
 *
 * @param names - The system plugins, in the fixed order.
+* @param modules - The loaders of the page.
 * @returns The `createApp` of the package, the capability plugins in the order of the names, and
 *   the store plugin when the names hold it.
-* @throws {Error} When the package is not installed.
+* @throws {Error} When a name has no loader, or a loader rejects: the package is not installed.
 */
-async function loadSystem(names) {
+async function loadSystem(names, modules) {
+	checkLoaders(names, modules);
 	const capabilities = names.filter((name) => name !== "store");
 	try {
 		const [system, store, ...plugins] = await Promise.all([
-			import("@moku-labs/system"),
-			names.includes("store") ? loadStore() : void 0,
-			...capabilities.map((name) => capabilityLoaders[name]())
+			modules.system(),
+			names.includes("store") ? modules.store?.().then((module) => module.storePlugin) : void 0,
+			...capabilities.map((name) => capabilityPlugins[name](modules))
 		]);
 		return {
 			createApp: system.createApp,
@@ -126,23 +136,29 @@ async function loadSystem(names) {
 /**
 * Creates the `@moku-labs/system` app of the named plugins, in the fixed order `lifecycle`,
 * `back`, `haptics`, `keepAwake`, `store`, each name once. The store is named after `namespace`.
-* Each plugin is loaded by its own `import()`, so a page loads only the plugins its game names.
-* The app is not started.
+* Each plugin is loaded by its loader in `modules`, and only the named ones are called, so a page
+* loads only the plugins its game names. The app is not started.
 *
 * @param names - The system plugins the game names, in any order.
 * @param namespace - The store name: the native identifier, or `"moku-game"`.
+* @param modules - The loaders of the page: the package, and one per named plugin.
 * @returns The system app, not started.
-* @throws {Error} When `@moku-labs/system` is not installed.
+* @throws {Error} When a named plugin has no loader in `modules`, or a loader rejects because
+*   `@moku-labs/system` is not installed.
 * @example
 * ```ts
 * // A shell of its own: the store named after the app, and the haptics.
-* const system = await createSystemApp(["store", "haptics"], "com.mokulabs.timber");
+* const system = await createSystemApp(["store", "haptics"], "com.mokulabs.timber", {
+*   system: () => import("@moku-labs/system"),
+*   haptics: () => import("@moku-labs/system/haptics"),
+*   store: () => import("@moku-labs/system/store")
+* });
 * await system.start();
 * await system.haptics?.selection(); // { ok: false, provider: "web", reason: "unsupported" } in iOS Safari
 * ```
 */
-async function createSystemApp(names, namespace) {
-	const { createApp, capabilities, store } = await loadSystem(systemOrder.filter((name) => names.includes(name)));
+async function createSystemApp(names, namespace, modules) {
+	const { createApp, capabilities, store } = await loadSystem(systemOrder.filter((name) => names.includes(name)), modules);
 	if (store === void 0) return createApp({ plugins: capabilities });
 	return createApp({
 		plugins: [...capabilities, store],
@@ -271,37 +287,43 @@ function storeSave(store, key, report) {
 	};
 }
 /**
-* Builds the system shell from the resolved `config.ts`: the `@moku-labs/system` app of the names
-* `config.system` lists, plus the store when `config.save` is `"store"`, in the fixed order. It
-* hands the engine the platform provider over that app and, for a store save, the save provider.
-* The page starts the shell before the game; this function does not start it. The generated
-* `main.ts` passes the function itself to `startPage`, only when `config.ts` names a system
-* plugin or the store save.
+* Makes the system shell factory of a page over its loaders. The factory builds the shell from the
+* resolved `config.ts`: the `@moku-labs/system` app of the names `config.system` lists, plus the
+* store when `config.save` is `"store"`, in the fixed order. It hands the engine the platform
+* provider over that app and, for a store save, the save provider. Nothing loads until the page
+* calls the factory, and the page starts the shell before the game. The generated `main.ts`
+* passes it to `startPage` with one loader per name, only when `config.ts` names a system plugin
+* or the store save.
 *
-* @param config - The resolved `config.ts` of the game.
-* @param report - Takes a problem the page reports later, such as a write the store refused.
-* @returns The shell, not started.
-* @throws {Error} When `@moku-labs/system` is not installed.
+* @param modules - The loaders of the page: the package, and one per named plugin.
+* @returns The factory the page calls; it throws the messages of `createSystemApp`.
 * @example
 * ```ts
-* // The in-memory .moku/build/main.ts of moku-game build, for a game whose config.ts names system plugins.
+* // The in-memory .moku/build/main.ts of moku-game build, for a game whose config.ts names back.
 * import { startPage } from "@moku-labs/game/app/page";
-* import { systemShell } from "@moku-labs/game/app/system";
+* import { systemShellOf } from "@moku-labs/game/app/system";
 * import game from "../../index.ts";
 * import config from "../../config.ts";
 *
-* await startPage(game, config, { system: systemShell });
+* await startPage(game, config, {
+*   system: systemShellOf({
+*     system: () => import("@moku-labs/system"),
+*     back: () => import("@moku-labs/system/back")
+*   })
+* });
 * ```
 */
-async function systemShell(config, report) {
-	const app = await createSystemApp(config.save === "store" ? [...config.system, "store"] : config.system, config.native?.identifier ?? defaultNamespace);
-	return {
-		handle: app,
-		platform: fromSystem(app),
-		save: app.store === void 0 ? void 0 : storeSave(app.store, saveKey, report),
-		start: () => app.start(),
-		stop: () => app.stop()
+function systemShellOf(modules) {
+	return async (config, report) => {
+		const app = await createSystemApp(config.save === "store" ? [...config.system, "store"] : config.system, config.native?.identifier ?? defaultNamespace, modules);
+		return {
+			handle: app,
+			platform: fromSystem(app),
+			save: app.store === void 0 ? void 0 : storeSave(app.store, saveKey, report),
+			start: () => app.start(),
+			stop: () => app.stop()
+		};
 	};
 }
 //#endregion
-export { createSystemApp, fromSystem, storeSave, systemShell };
+export { createSystemApp, fromSystem, storeSave, systemShellOf };

package/dist/app.d.mts

@@ -1,5 +1,5 @@
 import { Xt as Json } from "./types-ZQLYXo5X.mjs";
-import { a as GameHandle, c as MemoryProvider, f as SaveKind, g as SystemName, i as GameDefinition, l as PageAgent, m as ScreenSeams, n as GameApp, o as GamePluginConfigs, p as Scenario, r as GameConfig, s as HeadlessSeams } from "./types-hQgI_wrq.mjs";
+import { a as GameHandle, c as MemoryProvider, d as SaveKind, f as Scenario, g as SystemName, i as GameDefinition, l as PageAgent, n as GameApp, o as GamePluginConfigs, p as ScreenSeams, r as GameConfig, s as HeadlessSeams } from "./types-Ca_z_4tQ.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/app/define.d.ts

package/dist/app.mjs

@@ -1,4 +1,4 @@
-import { H as platformPlugin, i as screen, jt as audioPlugin, t as createApp, xt as effectsPlugin } from "./src-DSl1eNB1.mjs";
+import { H as platformPlugin, i as screen, jt as audioPlugin, t as createApp, xt as effectsPlugin } from "./src-BSbtHZWk.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
 //#region src/app/define.ts

package/dist/cli.mjs

@@ -13,6 +13,17 @@ const SAFE_VALUE = /^[#\w(),.%\s-]+$/;
 /** The files of `tests/scenarios/` that are not scenarios. */
 const NOT_SCENARIO = /\.(?:test|spec|d)\.ts$|^index\.ts$/;
 /**
+* The entry of `@moku-labs/system` each system plugin loads from, in the order the shell composes
+* them.
+*/
+const SYSTEM_ENTRIES = [
+	["lifecycle", "lifecycle"],
+	["back", "back"],
+	["haptics", "haptics"],
+	["keepAwake", "keep-awake"],
+	["store", "store"]
+];
+/**
 * Escapes the five characters HTML reads as markup.
 *
 * @param text - The text.
@@ -133,7 +144,7 @@ function scenarioFiles(files) {
 * Whether the page needs the system shell: a system plugin is named, or the save is the store.
 *
 * @param settings - The resolved `config.ts`.
-* @returns True when `main.ts` imports `systemShell`.
+* @returns True when `main.ts` imports `systemShellOf`.
 * @example
 * ```ts
 * needsShell(resolveConfig({ page: { title: "T" }, save: "store" })); // true
@@ -143,6 +154,26 @@ function needsShell(settings) {
 	return settings.system.length > 0 || settings.save === "store";
 }
 /**
+* The `system` option of `startPage`: `systemShellOf` over the loader of the package and one
+* loader per plugin the shell composes, in the fixed order. The store is one when `config.system`
+* names it or the save is the store. Only these `import()`s are written, so the page bundles no
+* other plugin and never needs its native package.
+*
+* @param settings - The resolved `config.ts`.
+* @returns The option, indented two spaces, with no comma after it.
+* @example
+* ```ts
+* shellOption(resolveConfig({ page: { title: "T" }, system: ["haptics"] })).split("\n")[2]; // '    haptics: () => import("@moku-labs/system/haptics")'
+* ```
+*/
+function shellOption(settings) {
+	return [
+		"  system: systemShellOf({",
+		["    system: () => import(\"@moku-labs/system\")", ...SYSTEM_ENTRIES.filter(([name]) => settings.system.includes(name) || name === "store" && settings.save === "store").map(([name, entry]) => `    ${name}: () => import("@moku-labs/system/${entry}")`)].join(",\n"),
+		"  })"
+	].join("\n");
+}
+/**
 * The imports of `main.ts` every page has: the page entry, the shell when needed, the game and its
 * config.
 *
@@ -157,7 +188,7 @@ function needsShell(settings) {
 function pageImports(settings, toRoot) {
 	return [
 		"import { startPage } from \"@moku-labs/game/app/page\";",
-		...needsShell(settings) ? ["import { systemShell } from \"@moku-labs/game/app/system\";"] : [],
+		...needsShell(settings) ? ["import { systemShellOf } from \"@moku-labs/game/app/system\";"] : [],
 		`import game from "${toRoot}index.ts";`,
 		`import config from "${toRoot}config.ts";`
 	];
@@ -194,8 +225,8 @@ function importLine(binding, specifier) {
 /**
 * The `main.ts` of the dev page: the dev flag first, then the page entry, the game, its config,
 * one import per scenario, and, with agents, one per `.dev` module and one per agent. It calls
-* `startPage` with the scenarios by file stem, the shell when the game needs it, the agents and
-* the `.dev` modules.
+* `startPage` with the scenarios by file stem, the shell with the loaders of the named plugins
+* when the game needs it, the agents and the `.dev` modules.
 *
 * @param settings - The resolved `config.ts`.
 * @param sources - The scenario files, the `.dev` modules and the agents.
@@ -212,7 +243,7 @@ function devMain(settings, sources) {
 	const keys = scenarios.map((file, index) => `${JSON.stringify(file.slice(0, -3))}: scenario${index}`);
 	const options = [
 		`  scenarios: ${keys.length === 0 ? "{}" : `{ ${keys.join(", ")} }`}`,
-		...needsShell(settings) ? ["  system: systemShell"] : [],
+		...needsShell(settings) ? [shellOption(settings)] : [],
 		...agents.length === 0 ? [] : [`  agents: [${numbered("agent", agents.length)}]`],
 		...devModules.length === 0 ? [] : [`  devModules: [${numbered("devModule", devModules.length)}]`]
 	];
@@ -232,8 +263,8 @@ function devMain(settings, sources) {
 }
 /**
 * The `main.ts` of the production page: the page entry, the game and its config, and the shell
-* when the game needs it. No dev flag, no scenario, no agent, no `.dev` module, no door: none of
-* them ships.
+* with the loaders of the named plugins when the game needs it. No dev flag, no scenario, no
+* agent, no `.dev` module, no door: none of them ships.
 *
 * @param settings - The resolved `config.ts`.
 * @returns The text of the in-memory `.moku/build/main.ts`.
@@ -243,11 +274,15 @@ function devMain(settings, sources) {
 * ```
 */
 function buildMain(settings) {
-	const call = needsShell(settings) ? "await startPage(game, config, { system: systemShell });" : "await startPage(game, config);";
+	const call = needsShell(settings) ? [
+		"await startPage(game, config, {",
+		shellOption(settings),
+		"});"
+	] : ["await startPage(game, config);"];
 	return [
 		...pageImports(settings, "../../"),
 		"",
-		call,
+		...call,
 		""
 	].join("\n");
 }

package/dist/{index-xxSxKJJW.d.mts → index-8TiJQjQA.d.mts}

@@ -476,6 +476,19 @@ type PlatformApi = {
    * ```
    */
   back(): BackResult;
+  /**
+   * Leaves the app through the provider, as the last step of `back()` does: no Escape, no intent
+   * `back`. A provider `exit` that throws is logged, never thrown. Without a provider it does
+   * nothing.
+   *
+   * @example
+   * ```ts
+   * // merge-game's exit plugin answers the fx "exit" of the Leave button.
+   * ctx.require(flowPlugin).fx.handle("exit", () => ctx.require(platformPlugin).exit());
+   * // a press of Leave: the provider leaves the app; on the web page without a provider, nothing
+   * ```
+   */
+  exit(): void;
 };
 /**
  * What the kernel context offers the files of the plugin.

package/dist/index.d.mts

@@ -2,5 +2,5 @@ import { $ as DescriptionNode, $t as types_d_exports$9, C as types_d_exports$11,
 import { B as sequence, F as frames, G as stagger, H as sfx, I as haptic, J as wait, K as tween, L as mark, M as HAPTIC_KINDS, N as defineAnimation, O as types_d_exports, P as external, R as parallel, U as spawn, V as set, W as spawned, b as types_d_exports$12, f as types_d_exports$2, i as types_d_exports$15, k as HapticKind, q as use, z as play } from "./types-BM4shh8K.mjs";
 import { a as types_d_exports$4 } from "./types-CefgYzFt.mjs";
 import { C as TextFormat, D as types_d_exports$13, H as Transform, I as Parent, L as Shape, M as types_d_exports$7, N as Display, O as defineComponent, P as NineSlice, W as sprite, Z as types_d_exports$6, d as popup, f as defineTokens, g as BindOptions, l as Box, u as LocalWrite, v as CountdownValue, z as Sprite } from "./types-BUwDHKXm.mjs";
-import { $ as uiPlugin, A as Pointer, B as Layer, C as defineScene, Ct as label, D as DropTarget, E as Draggable, F as Tappable, G as resource, H as Tree, I as Touchable, J as guide, K as system, L as Traceable, M as Pressable, N as Pressed, O as Held, P as Swipeable, Q as worldPlugin, R as Traced, S as Frames, St as defineTextStyles, T as load, U as component, V as Order, W as mut, X as schedule, Y as hint, Z as defineFeature, _ as defineStyle, _t as animPlugin, a as defineEmitter, at as BackResult, b as AnimPlayer, bt as Text, c as Alpha, ct as modelPlugin, d as Displacement, dt as i18nPlugin, et as timePlugin, f as Glow, ft as flowPlugin, g as resolve, gt as assetsPlugin, h as music, ht as audioPlugin, i as screen, it as platformPlugin, j as PointerOver, k as Hovered, l as Blur, lt as lifecyclePlugin, m as Outline, mt as clockPlugin, n as createPlugin, nt as scenesPlugin, o as Emitter, ot as PlatformProvider, p as Noise, pt as effectsPlugin, q as tag, r as defineGame, rt as rendererPlugin, s as defineFilter, st as types_d_exports$10, t as createApp, tt as textPlugin, u as ColorMatrix, ut as inputPlugin, v as tr, vt as projection, w as defineBundles, x as Animation, xt as bind, y as defineMotion, yt as Countdown, z as Exiting } from "./index-xxSxKJJW.mjs";
+import { $ as uiPlugin, A as Pointer, B as Layer, C as defineScene, Ct as label, D as DropTarget, E as Draggable, F as Tappable, G as resource, H as Tree, I as Touchable, J as guide, K as system, L as Traceable, M as Pressable, N as Pressed, O as Held, P as Swipeable, Q as worldPlugin, R as Traced, S as Frames, St as defineTextStyles, T as load, U as component, V as Order, W as mut, X as schedule, Y as hint, Z as defineFeature, _ as defineStyle, _t as animPlugin, a as defineEmitter, at as BackResult, b as AnimPlayer, bt as Text, c as Alpha, ct as modelPlugin, d as Displacement, dt as i18nPlugin, et as timePlugin, f as Glow, ft as flowPlugin, g as resolve, gt as assetsPlugin, h as music, ht as audioPlugin, i as screen, it as platformPlugin, j as PointerOver, k as Hovered, l as Blur, lt as lifecyclePlugin, m as Outline, mt as clockPlugin, n as createPlugin, nt as scenesPlugin, o as Emitter, ot as PlatformProvider, p as Noise, pt as effectsPlugin, q as tag, r as defineGame, rt as rendererPlugin, s as defineFilter, st as types_d_exports$10, t as createApp, tt as textPlugin, u as ColorMatrix, ut as inputPlugin, v as tr, vt as projection, w as defineBundles, x as Animation, xt as bind, y as defineMotion, yt as Countdown, z as Exiting } from "./index-8TiJQjQA.mjs";
 export { Alpha, types_d_exports as Anim, AnimPlayer, Animation, types_d_exports$1 as Assets, types_d_exports$2 as Audio, type BackResult, type BindOptions, Blur, Box, types_d_exports$3 as Clock, ColorMatrix, Countdown, type CountdownValue, type DescriptionNode, Displacement, Display, Draggable, DropTarget, types_d_exports$4 as Effects, Emitter, Exiting, types_d_exports$5 as Flow, Frames, Glow, HAPTIC_KINDS, type HapticKind, Held, Hovered, types_d_exports$6 as I18n, types_d_exports$7 as Input, Layer, types_d_exports$8 as Lifecycle, LocalWrite, types_d_exports$9 as Model, NineSlice, Noise, Order, Outline, Parent, types_d_exports$10 as Platform, type PlatformProvider, Pointer, PointerOver, Pressable, Pressed, types_d_exports$11 as Renderer, SaveUnreadableError, types_d_exports$12 as Scenes, Shape, Sprite, Swipeable, Tappable, Text, type TextFormat, types_d_exports$13 as TextTypes, types_d_exports$14 as Time, Touchable, Traceable, Traced, Transform, Tree, types_d_exports$15 as Ui, types_d_exports$16 as World, animPlugin, assetsPlugin, audioPlugin, bind, clockPlugin, component, createApp, createPlugin, defineAnimation, defineBundles, defineComponent, defineEmitter, defineFeature, defineFilter, defineGame, defineMotion, defineScene, defineStyle, defineTextStyles, defineTokens, effectsPlugin, exit, external, flowPlugin, frames, guide, haptic, hint, i18nPlugin, inputPlugin, label, lifecyclePlugin, load, mark, modelPlugin, music, mut, parallel, platformPlugin, play, popup, projection, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as sfx, A as types_exports$3, At as defineFilter, B as defineStyle, Bt as flowPlugin, C as types_exports$10, Ct as Alpha, D as types_exports$6, Dt as Glow, E as types_exports$7, Et as Displacement, F as resolve, Ft as AnimPlayer, G as external, Gt as modelPlugin, H as platformPlugin, Ht as slot, I as Box, It as Animation, J as mark, Jt as timePlugin, K as frames, Kt as SaveUnreadableError, L as LocalWrite, Lt as Frames, M as types_exports$1, Mt as scenesPlugin, N as types_exports, Nt as assetsPlugin, O as types_exports$5, Ot as Noise, P as uiPlugin, Pt as animPlugin, Q as set, R as popup, Rt as rendererPlugin, S as types_exports$11, St as Emitter, T as types_exports$8, Tt as ColorMatrix, U as HAPTIC_KINDS, Ut as to, V as textPlugin, Vt as exit, W as defineAnimation, Wt as type, X as play, Y as parallel, Yt as clockPlugin, Z as sequence, _ as types_exports$16, _t as Touchable, a as defineMotion, at as wait, b as types_exports$13, bt as i18nPlugin, c as schedule, ct as DropTarget, d as tr, dt as Pointer, et as spawn, f as defineFeature, ft as PointerOver, g as load, gt as Tappable, h as defineBundles, ht as Swipeable, i as screen, it as use, j as types_exports$2, jt as audioPlugin, k as types_exports$4, kt as Outline, l as projection, lt as Held, m as music, mt as Pressed, n as createPlugin, nt as stagger, o as guide, ot as inputPlugin, p as defineEmitter, pt as Pressable, q as haptic, qt as lifecyclePlugin, r as defineGame, rt as tween, s as hint, st as Draggable, t as createApp, tt as spawned, u as defineScene, ut as Hovered, v as types_exports$15, vt as Traceable, w as types_exports$9, wt as Blur, x as types_exports$12, xt as effectsPlugin, y as types_exports$14, yt as Traced, z as defineTokens, zt as worldPlugin } from "./src-DSl1eNB1.mjs";
+import { $ as sfx, A as types_exports$3, At as defineFilter, B as defineStyle, Bt as flowPlugin, C as types_exports$10, Ct as Alpha, D as types_exports$6, Dt as Glow, E as types_exports$7, Et as Displacement, F as resolve, Ft as AnimPlayer, G as external, Gt as modelPlugin, H as platformPlugin, Ht as slot, I as Box, It as Animation, J as mark, Jt as timePlugin, K as frames, Kt as SaveUnreadableError, L as LocalWrite, Lt as Frames, M as types_exports$1, Mt as scenesPlugin, N as types_exports, Nt as assetsPlugin, O as types_exports$5, Ot as Noise, P as uiPlugin, Pt as animPlugin, Q as set, R as popup, Rt as rendererPlugin, S as types_exports$11, St as Emitter, T as types_exports$8, Tt as ColorMatrix, U as HAPTIC_KINDS, Ut as to, V as textPlugin, Vt as exit, W as defineAnimation, Wt as type, X as play, Y as parallel, Yt as clockPlugin, Z as sequence, _ as types_exports$16, _t as Touchable, a as defineMotion, at as wait, b as types_exports$13, bt as i18nPlugin, c as schedule, ct as DropTarget, d as tr, dt as Pointer, et as spawn, f as defineFeature, ft as PointerOver, g as load, gt as Tappable, h as defineBundles, ht as Swipeable, i as screen, it as use, j as types_exports$2, jt as audioPlugin, k as types_exports$4, kt as Outline, l as projection, lt as Held, m as music, mt as Pressed, n as createPlugin, nt as stagger, o as guide, ot as inputPlugin, p as defineEmitter, pt as Pressable, q as haptic, qt as lifecyclePlugin, r as defineGame, rt as tween, s as hint, st as Draggable, t as createApp, tt as spawned, u as defineScene, ut as Hovered, v as types_exports$15, vt as Traceable, w as types_exports$9, wt as Blur, x as types_exports$12, xt as effectsPlugin, y as types_exports$14, yt as Traced, z as defineTokens, zt as worldPlugin } from "./src-BSbtHZWk.mjs";
 import { A as system, C as Exiting, D as component, E as Tree, O as mut, S as sprite, T as Order, _ as Parent, b as Transform, c as Text, d as defineTextStyles, f as label, g as NineSlice, h as Display, j as tag, k as resource, l as bind, s as Countdown, v as Shape, w as Layer, y as Sprite } from "./visual-dMW8iqAE.mjs";
 import { r as defineComponent } from "./flatten-BkXuscAV.mjs";
 export { Alpha, types_exports as Anim, AnimPlayer, Animation, types_exports$1 as Assets, types_exports$2 as Audio, Blur, Box, types_exports$3 as Clock, ColorMatrix, Countdown, Displacement, Display, Draggable, DropTarget, types_exports$4 as Effects, Emitter, Exiting, types_exports$5 as Flow, Frames, Glow, HAPTIC_KINDS, Held, Hovered, types_exports$6 as I18n, types_exports$7 as Input, Layer, types_exports$8 as Lifecycle, LocalWrite, types_exports$9 as Model, NineSlice, Noise, Order, Outline, Parent, types_exports$10 as Platform, Pointer, PointerOver, Pressable, Pressed, types_exports$11 as Renderer, SaveUnreadableError, types_exports$12 as Scenes, Shape, Sprite, Swipeable, Tappable, Text, types_exports$13 as TextTypes, types_exports$14 as Time, Touchable, Traceable, Traced, Transform, Tree, types_exports$15 as Ui, types_exports$16 as World, animPlugin, assetsPlugin, audioPlugin, bind, clockPlugin, component, createApp, createPlugin, defineAnimation, defineBundles, defineComponent, defineEmitter, defineFeature, defineFilter, defineGame, defineMotion, defineScene, defineStyle, defineTextStyles, defineTokens, effectsPlugin, exit, external, flowPlugin, frames, guide, haptic, hint, i18nPlugin, inputPlugin, label, lifecyclePlugin, load, mark, modelPlugin, music, mut, parallel, platformPlugin, play, popup, projection, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/{src-DSl1eNB1.mjs → src-BSbtHZWk.mjs}

@@ -23490,13 +23490,24 @@ function setAwake(ctx, provider, on) {
 //#endregion
 //#region src/plugins/platform/api.ts
 /**
-* @file platform plugin — API factory and the Back chain. One press runs three steps and the
-* first that takes it wins: the Escape button of the top popup, the intent `back` of the resting
-* node, the provider leaving the app.
+* @file platform plugin — API factory, the Back chain and the exit. One press runs three steps and
+* the first that takes it wins: the Escape button of the top popup, the intent `back` of the
+* resting node, the provider leaving the app. `exit()` is that last step alone.
 */
 /** The intent a resting node lists to take the Back press itself. */
 const BACK_INTENT = "back";
 /**
+* Leaves the app through the provider, guarded like every provider call. Without a provider it
+* does nothing. The last step of the Back chain and `exit()` both go through here.
+*
+* @param ctx - Kernel context of the platform plugin.
+*/
+function leave(ctx) {
+	const provider = ctx.config.provider;
+	if (provider === void 0) return;
+	safely(ctx.log, "exit", () => provider.exit());
+}
+/**
 * Runs the Back chain once. `back()` and the provider's `onBack` both go through here, so a test
 * and a real press end the same way. Escape is what ui answers with the `escape` button of its
 * top root; it also ends the editing of a text field. While the graph moves between nodes the gate
@@ -23507,22 +23518,24 @@ const BACK_INTENT = "back";
 * @returns What took the press, `"none"` without a provider.
 */
 function runBack(ctx) {
-	const provider = ctx.config.provider;
-	if (provider === void 0) return "none";
+	if (ctx.config.provider === void 0) return "none";
 	if (ctx.require(inputPlugin).pressKey("Escape")) return "popup";
 	const gate = ctx.require(flowPlugin).gate;
 	if (gate.answer({ intent: BACK_INTENT }) || !gate.state().open) return "intent";
-	safely(ctx.log, "exit", () => provider.exit());
+	leave(ctx);
 	return "exit";
 }
 /**
-* Creates the platform API: the Back chain on demand.
+* Creates the platform API: the Back chain and the exit on demand.
 *
 * @param ctx - Kernel context of the platform plugin.
 * @returns The plugin API.
 */
 function createPlatformApi(ctx) {
-	return { back: () => runBack(ctx) };
+	return {
+		back: () => runBack(ctx),
+		exit: () => leave(ctx)
+	};
 }
 //#endregion
 //#region src/plugins/platform/state.ts
@@ -34254,7 +34267,7 @@ function defineMotion(spec) {
 * |---|---|
 * | `@moku-labs/game/app` | `defineGameApp`, the game as one data object with `headless()` and `screen()`; `startMoment`; the types of `index.ts` and `config.ts` (`GameConfig`) |
 * | `@moku-labs/game/app/page` | `startPage`, the page the generated `.moku/main.ts` calls: `?player=` scenarios, the system shell, the dev agents |
-* | `@moku-labs/game/app/system` | the system shell over the optional peer `@moku-labs/system`: `systemShell`, `fromSystem`, `storeSave`, `createSystemApp` |
+* | `@moku-labs/game/app/system` | the system shell over the optional peer `@moku-labs/system`: `systemShellOf`, `fromSystem`, `storeSave`, `createSystemApp` |
 * | `@moku-labs/game/cli` | `runCli` of the bin `moku-game` and `preparePage` for the editor, node and bun only |
 * | `@moku-labs/game/testing` | headless play, repro runs, isolated feature tests (`isolate`, `stub`), the in-memory save, the fake clock |
 * | `@moku-labs/game/visual` | the visual tests, node and bun only |

package/dist/testing.d.mts

@@ -1,5 +1,5 @@
 import { Dt as AnyFlow, Ht as ClockSource, Nt as NodeTable, Wt as FakeClock, Xt as Json, ht as FeaturePlugin } from "./types-ZQLYXo5X.mjs";
-import { t as createApp } from "./index-xxSxKJJW.mjs";
+import { t as createApp } from "./index-8TiJQjQA.mjs";
 import { n as saveOf, t as memory } from "./memory-DwDhfFWK.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-G4nuZ-xz.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-import { Vt as exit, Wt as type, t as createApp } from "./src-DSl1eNB1.mjs";
+import { Vt as exit, Wt as type, t as createApp } from "./src-BSbtHZWk.mjs";
 import { n as saveOf, t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
 import { i as stepFrames, r as runRepro, t as createHeadless } from "./headless-BsNdJs9W.mjs";

package/dist/{types-hQgI_wrq.d.mts → types-Ca_z_4tQ.d.mts}

@@ -1,6 +1,6 @@
 import { Dt as AnyFlow, Ht as ClockSource, Jt as Config, Wt as FakeClock, Xt as Json, a as Config$3, g as Config$2, ht as FeaturePlugin, n as AssetsIo, pt as Config$1, tn as PlayerStateProvider, u as Manifest, v as PixiModule } from "./types-ZQLYXo5X.mjs";
 import { o as AudioContextLike, s as Config$4 } from "./types-BM4shh8K.mjs";
-import { ht as audioPlugin, i as screen, it as platformPlugin, ot as PlatformProvider, pt as effectsPlugin, t as createApp } from "./index-xxSxKJJW.mjs";
+import { ht as audioPlugin, i as screen, it as platformPlugin, ot as PlatformProvider, pt as effectsPlugin, t as createApp } from "./index-8TiJQjQA.mjs";
 import { t as memory } from "./memory-DwDhfFWK.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
@@ -440,12 +440,14 @@ type PageAgent<App = ScreenAppOfGame<AnyGameApp>> = (page: {
   modules: readonly object[];
 }) => void | Promise<void>;
 /**
- * Builds the system shell from the resolved config: the type of `systemShell` of
- * `@moku-labs/game/app/system`. The page reaches the shell only through this.
+ * Builds the system shell from the resolved config: what `systemShellOf` of
+ * `@moku-labs/game/app/system` returns over the loaders of the page. The page reaches the shell
+ * only through this.
  *
  * @example
  * ```ts
- * await startPage(game, config, { system: systemShell }); // systemShell is a SystemShellFactory
+ * const factory: SystemShellFactory = systemShellOf({ system: () => import("@moku-labs/system"), back: () => import("@moku-labs/system/back") });
+ * await startPage(game, config, { system: factory }); // the page builds the shell of config.system: ["back"]
  * ```
  */
 type SystemShellFactory = (config: ResolvedGameConfig, report: (problem: string) => void) => Promise<SystemShell>;
@@ -454,7 +456,8 @@ type SystemShellFactory = (config: ResolvedGameConfig, report: (problem: string)
  *
  * @example
  * ```ts
- * const options: PageOptions = { scenarios: { ready }, system: systemShell, agents: [agent0], devModules: [devModule0] };
+ * const system = systemShellOf({ system: () => import("@moku-labs/system"), haptics: () => import("@moku-labs/system/haptics") });
+ * const options: PageOptions = { scenarios: { ready }, system, agents: [agent0], devModules: [devModule0] };
  * ```
  */
 type PageOptions = {
@@ -477,13 +480,52 @@ type StartedPage<Game extends AnyGameApp> = {
   /** The screen app, started. */app: ScreenAppOfGame<Game>; /** The `@moku-labs/system` app, or `undefined` without a shell. Typed `unknown`: see `SystemShell.handle`. */
   system: unknown;
 };
+/**
+ * The modules of `@moku-labs/system` the page loads, one loader per name of `config.ts`: the
+ * package itself always, and the entry of each plugin the game names, the store for a store save.
+ * The generated `main.ts` writes only the loaders of the names, so the page bundles only those
+ * plugins and never meets the native package of another. Typed `unknown`: a system type here would
+ * land in the `.d.mts` of every game and break the typecheck of a web-only one.
+ *
+ * @example
+ * ```ts
+ * // A page of its own for a game whose config.ts names haptics, with a memory save.
+ * const modules: SystemModules = {
+ *   system: () => import("@moku-labs/system"),
+ *   haptics: () => import("@moku-labs/system/haptics")
+ * };
+ * await startPage(game, config, { system: systemShellOf(modules) }); // the bundle holds no store plugin
+ * ```
+ */
+type SystemModules = {
+  /** `@moku-labs/system` itself, for its `createApp`. Always there. */system: () => Promise<{
+    createApp: unknown;
+  }>; /** `@moku-labs/system/lifecycle`, when the game names `lifecycle`. */
+  lifecycle?: () => Promise<{
+    lifecyclePlugin: unknown;
+  }>; /** `@moku-labs/system/back`, when the game names `back`. */
+  back?: () => Promise<{
+    backPlugin: unknown;
+  }>; /** `@moku-labs/system/haptics`, when the game names `haptics`. */
+  haptics?: () => Promise<{
+    hapticsPlugin: unknown;
+  }>; /** `@moku-labs/system/keep-awake`, when the game names `keepAwake`. */
+  keepAwake?: () => Promise<{
+    keepAwakePlugin: unknown;
+  }>; /** `@moku-labs/system/store`, when the game names `store` or its save is `"store"`. */
+  store?: () => Promise<{
+    storePlugin: unknown;
+  }>;
+};
 /**
  * The system shell: the `@moku-labs/system` app the config names, and what the engine takes from
- * it. `systemShell` builds it; the page starts it before the game and stops it after.
+ * it. The factory of `systemShellOf` builds it; the page starts it before the game and stops it
+ * after.
  *
  * @example
  * ```ts
- * const shell = await systemShell(resolveConfig(config), problem => problems.push(problem));
+ * const build = systemShellOf({ system: () => import("@moku-labs/system"), store: () => import("@moku-labs/system/store") });
+ * const shell = await build(resolveConfig({ page: { title: "T" }, save: "store" }), problem => problems.push(problem));
  * game.screen({ platform: shell.platform, provider: shell.save });
  * ```
  */
@@ -541,4 +583,4 @@ type SystemShell = {
   stop(): Promise<void>;
 };
 //#endregion
-export { SystemShell as _, GameHandle as a, MemoryProvider as c, ResolvedGameConfig as d, SaveKind as f, SystemName as g, StartedPage as h, GameDefinition as i, PageAgent as l, ScreenSeams as m, GameApp as n, GamePluginConfigs as o, Scenario as p, GameConfig as r, HeadlessSeams as s, AnyGameApp as t, PageOptions as u };
+export { SystemShellFactory as _, GameHandle as a, MemoryProvider as c, SaveKind as d, Scenario as f, SystemName as g, SystemModules as h, GameDefinition as i, PageAgent as l, StartedPage as m, GameApp as n, GamePluginConfigs as o, ScreenSeams as p, GameConfig as r, HeadlessSeams as s, AnyGameApp as t, PageOptions as u };

package/llms.txt

@@ -9,7 +9,7 @@ Facts: Bun only. ESM only. `"sideEffects": false`. `pixi.js` `^8.0.0` is a peer
 - `@moku-labs/game`: everything a game imports.
 - `@moku-labs/game/app`: `defineGameApp`, `startMoment` and the types of a game's `index.ts` and `config.ts`. No `node:` import, no system or native package. See "The game shell".
 - `@moku-labs/game/app/page` (the browser): `startPage`, the page the generated `.moku/main.ts` calls.
-- `@moku-labs/game/app/system` (the browser, the native shell): `systemShell`, `fromSystem`, `storeSave`, `createSystemApp` over the optional peer `@moku-labs/system`. The one entry that reaches it.
+- `@moku-labs/game/app/system` (the browser, the native shell): `systemShellOf`, `fromSystem`, `storeSave`, `createSystemApp`, the type `SystemModules`, over the optional peer `@moku-labs/system`. The one entry that names it, in types only: the page hands it the loaders.
 - `@moku-labs/game/cli` (node and bun only): `runCli`, the bin `moku-game`, and `preparePage`, the editor's dev page.
 - `@moku-labs/game/testing`: headless play, repro runs, isolated feature tests (`isolate`, `stub`), fake clock, in-memory save provider. No `node:` import.
 - `@moku-labs/game/visual` (node and bun only): the visual tests `defineVisualTest`, `runVisualTests`, `parseVisualArgv`.
@@ -300,7 +300,7 @@ The page. `moku-game dev` and `build` write a `main.ts` that calls `startPage(ga
 - `?player=<name>` starts from the scenario `tests/scenarios/<name>.ts` on a fresh memory save, never on the stored one. An unknown name logs `[game] No scenario "<name>".` and starts from the starting player. A scenario is `Scenario<Player>`: `(now) => ({ player, session? })`, its default export.
 - `?renderer=webgl` asks Pixi for WebGL.
 - Save kinds: `"memory"` lives for the page only; `"local"` is `localStorage` under `<native.identifier>:save` or `moku-game:save`, and falls back to memory with a warning where storage is refused; `"store"` is the system store (idb on the web, the Tauri store native), needs the shell, rejects a load it cannot read instead of starting a new player.
-- System: the generated `main.ts` imports `systemShell` of `@moku-labs/game/app/system` only when `system` is not empty or `save` is `"store"`, so a web-only page bundles no system code. The shell loads each named `@moku-labs/system` plugin with its own `import()`. Not installed: `[game] config.system needs @moku-labs/system.` with `bun add @moku-labs/system@^0.3.1`.
+- System: the generated `main.ts` imports `systemShellOf` of `@moku-labs/game/app/system` only when `system` is not empty or `save` is `"store"`, so a web-only page bundles no system code. It passes `system: systemShellOf({ system: () => import("@moku-labs/system"), haptics: () => import("@moku-labs/system/haptics") })`: one loader per named plugin, in the order `lifecycle`, `back`, `haptics`, `keepAwake` (entry `keep-awake`), `store` (when named or `save` is `"store"`). The engine holds no `import()` of the package, so the page bundles only the named plugins: a game with `system: ["haptics"]` and a memory save builds without `@tauri-apps/plugin-store`. A loader that rejects: `[game] config.system needs @moku-labs/system.` with `bun add @moku-labs/system@^0.3.1`. A named plugin without a loader: `[game] config.system names "<name>", but main.ts has no loader for it.`
 
 ```ts
 // .moku/main.ts of the engine's mini game, written by moku-game dev
@@ -571,6 +571,7 @@ Cosmetic rendering extras as data, drawn by `effectsPlugin`: `plugins: [...scree
 The phone as a provider, last in the array: `plugins: [...screen, effectsPlugin, audioPlugin, platformPlugin]` with `pluginConfigs: { platform: { provider, keepAwake: true } }`. `game.screen()` composes it and takes the provider as its `platform` seam. A game imports no native package: the engine page builds the provider from the `system` list of `config.ts` through `@moku-labs/game/app/system`, and turns keep-awake on when the list names `keepAwake`. The full reference is `src/plugins/platform/README.md`.
 - `PlatformProvider` has six members: `onPause(fn)`, `onResume(fn)`, `onBack(fn)` (each returns its remover), `haptic(kind)`, `keepAwake(on)`, `exit()`. Pause and resume push and pop the `"background"` reason of `lifecycle`. A provider method that throws is logged, never thrown into the frame.
 - Back chain, `app.platform.back(): BackResult`. First an Escape press: a popup with an `escape` button closes, `"popup"`. Then `flow.gate.answer({ intent: "back" })` when the resting node lists `back`, `"intent"`. Then `provider.exit()`, `"exit"`. Without a provider `"none"`.
+- `app.platform.exit()`: the last step of the Back chain alone, `provider.exit()`, for a Leave button: `ctx.require(flowPlugin).fx.handle("exit", () => ctx.require(platformPlugin).exit())`. A throw is logged; without a provider it does nothing.
 - Haptics: `await fx(haptic("success"))` in a node, or `haptic("light")` as a timeline step. The kinds are `HAPTIC_KINDS`: `light`, `medium`, `heavy`, `selection`, `success`, `warning`, `error`. A fast walk is silent.
 - Config: `provider: undefined`, which leaves the plugin inert: a `haptic` effect resolves at once, so the same node runs on the web and headless. `keepAwake: false`.
 - No events. Depends on `lifecycle`, `flow`, `input`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/game",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "2D puzzle game engine on TypeScript and PixiJS, built on @moku-labs/core.",
   "type": "module",
   "sideEffects": false,