@moku-labs/game 0.15.0 → 0.15.2

package/dist/app/page.d.mts

@@ -1,4 +1,4 @@
-import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-C73hbmxi.mjs";
+import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-DEYQF_tT.mjs";
 
 //#region src/app/page.d.ts
 /**

package/dist/app/page.mjs

@@ -1,7 +1,7 @@
 import { r as systemSource, t as memory } from "../memory-CWlqhS7l.mjs";
 import { t as applyTo } from "../drafts-BawpSaVp.mjs";
-import { i as isControl } from "../dev-DbHgx-R-.mjs";
-import { n as read, r as watch, t as sources } from "../sources-Cdvb0rOS.mjs";
+import { i as isControl } from "../dev-BNndV-hU.mjs";
+import { n as read, r as watch, t as sources } from "../sources-OvHvyeJS.mjs";
 import { t as resolveConfig } from "../config-B87aFTW-.mjs";
 //#region src/app/save.ts
 /**

package/dist/app/system.d.mts

@@ -1,6 +1,6 @@
-import { hr as PlayerStateProvider } from "../types-BGcda5Le.mjs";
-import { ft as PlatformProvider } from "../index-DedbED3T.mjs";
-import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-C73hbmxi.mjs";
+import { Dr as PlayerStateProvider } from "../types-BHgJ1F6f.mjs";
+import { pt as PlatformProvider } from "../index-w2uyRKkj.mjs";
+import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-DEYQF_tT.mjs";
 import { Back, Haptics, KeepAwake, Lifecycle, Store } from "@moku-labs/system";
 
 //#region src/app/system.d.ts

package/dist/app.d.mts

@@ -1,6 +1,6 @@
-import { ur as Json } from "./types-BGcda5Le.mjs";
-import { V as StringTable } from "./types-7GXcXxxv.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, v as WithGameState } from "./types-C73hbmxi.mjs";
+import { Sr as Json } from "./types-BHgJ1F6f.mjs";
+import { V as StringTable } from "./types-Bm7DVtA_.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, v as WithGameState } from "./types-DEYQF_tT.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/app/define.d.ts

package/dist/app.mjs

@@ -1,4 +1,4 @@
-import { Dt as effectsPlugin, K as platformPlugin, Rt as audioPlugin, i as screen, p as flattenFeatures, t as createApp } from "./src-BEbJ_sSx.mjs";
+import { Dt as effectsPlugin, K as platformPlugin, Rt as audioPlugin, i as screen, p as flattenFeatures, t as createApp } from "./src-Ca8W8Dvv.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { n as isFakeClock, t as fakeClock } from "./fake-6mazmHK3.mjs";
 //#region src/app/define.ts

package/dist/assets.d.mts

@@ -1,4 +1,4 @@
-import { d as Manifest } from "./types-BGcda5Le.mjs";
+import { d as Manifest } from "./types-BHgJ1F6f.mjs";
 
 //#region src/plugins/assets/scan/cli.d.ts
 /**

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 import { t as resolveConfig } from "./config-B87aFTW-.mjs";
 import { t as findFeatureOwners } from "./features-DowEilZm.mjs";
-import { r as watchTree, t as createBatcher, x as isSkippedFolder$1 } from "./watch-BEdrp80i.mjs";
+import { r as watchTree, t as createBatcher, x as isSkippedFolder$1 } from "./watch-BSgptowj.mjs";
 import { a as runCli$1, i as compileStrings, n as importStrings, t as exportStrings } from "./assets-CEMfBogh.mjs";
 import { constants, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import path from "node:path";
@@ -631,10 +631,10 @@ function devFlag(engine) {
 	].join("\n");
 }
 /**
-* The in-memory `agent.ts` module of a debug page, imported after the startup mark: six lines
-* that set the build id, the engine id and the editor address, each through `JSON.stringify`, the
-* control flag of the profile, the agent flag, and the dev flag `false`. No header: nobody opens
-* it.
+* The in-memory `agent.ts` module of a debug page, imported after the startup mark: lines that
+* set the build id, the engine id, the editor address and, when the game has one, the app id, each
+* through `JSON.stringify`, the control flag of the profile, the agent flag, and the dev flag
+* `false`. No header: nobody opens it.
 *
 * @param page - What the page is built with.
 * @returns The text.
@@ -648,6 +648,7 @@ function agentFlag(page) {
 		`globalThis.__MOKU_GAME_BUILD__ = ${JSON.stringify(page.build)};`,
 		`globalThis.__MOKU_GAME_ENGINE__ = ${JSON.stringify(page.engine)};`,
 		`globalThis.__MOKU_GAME_EDITOR__ = ${JSON.stringify(page.editor)};`,
+		...page.app === void 0 ? [] : [`globalThis.__MOKU_GAME_APP__ = ${JSON.stringify(page.app)};`],
 		`globalThis.__MOKU_GAME_CONTROL__ = ${String(page.control)};`,
 		"globalThis.__MOKU_GAME_AGENT__ = true;",
 		"globalThis.__MOKU_GAME_DEV__ = false;",
@@ -1465,7 +1466,7 @@ async function serveChild(run, deps) {
 * under a virtual `<game>/.moku/build/` that is never written, then the packed assets copied
 * beside the page. A release page that carries the editor's agent is refused and removed. With
 * `--debug` the page is a debug page instead: the editor's page agent, the game's `.dev` modules,
-* the agent flag and a control profile, a marked title and a build id. The output works from any
+* the agent and control flags, a marked title, a build id and the app id. The output works from any
 * http sub-path and from the Tauri protocol: every link starts with `./`, and the page reads
 * `manifest.json` next to itself. Node and Bun only: the bin bundles it.
 */
@@ -1629,24 +1630,41 @@ async function loadPlugins(files) {
 	}));
 }
 /**
-* The id of a debug build: the profile and the UTC time of the run, `YYYYMMDDTHHMMSSZ`.
+* The id of a debug build: the UTC time of the run, `YYYYMMDDTHHMMSSZ`, the same for both
+* profiles (the editor tells them apart by the CONTROL flag).
 *
-* @param debug - The profile.
 * @param now - The wall-clock time of the run, ms.
 * @returns The id.
 * @example
 * ```ts
-* buildIdOf("read", Date.UTC(2026, 9, 14, 15, 30, 12)); // "debug-20261014T153012Z"
+* buildIdOf(Date.UTC(2026, 9, 14, 15, 30, 12)); // "debug-20261014T153012Z"
 * ```
 */
-function buildIdOf(debug, now) {
-	const stamp = `${new Date(now).toISOString().slice(0, 19).replaceAll(/[-:]/g, "")}Z`;
-	return debug === "full" ? `debug-full-${stamp}` : `debug-${stamp}`;
+function buildIdOf(now) {
+	return `debug-${new Date(now).toISOString().slice(0, 19).replaceAll(/[-:]/g, "")}Z`;
+}
+/**
+* The app id a debug page carries, so the editor pairs a device stream with its project: the
+* native bundle identifier, with `.debug` when native builds its debug app
+* (`MOKU_NATIVE_PROFILE=debug`), which installs under that id.
+*
+* @param identifier - `native.identifier` of `config.ts`, `undefined` without a native section.
+* @param profile - `MOKU_NATIVE_PROFILE` of the run.
+* @returns The app id, or `undefined` without an identifier.
+* @example
+* ```ts
+* appIdOf("com.mokulabs.timber", "debug"); // "com.mokulabs.timber.debug"
+* ```
+*/
+function appIdOf(identifier, profile) {
+	if (identifier === void 0) return void 0;
+	return profile === "debug" ? `${identifier}.debug` : identifier;
 }
 /**
 * The `define` map of a page: a release page defines the three flags `false`; a debug page the
 * dev flag `false`, the agent flag `true`, the control flag of its profile, and the build id, the
-* engine id and the editor address as strings.
+* engine id, the editor address and, when the game has one, the app id (`__MOKU_GAME_APP__`) as
+* strings.
 *
 * @param page - What a debug page is built with; `undefined` for a release page.
 * @returns The defines for `Bun.build`.
@@ -1667,7 +1685,8 @@ function definesOf(page) {
 		__MOKU_GAME_CONTROL__: page.level === "full" ? "true" : "false",
 		__MOKU_GAME_BUILD__: JSON.stringify(page.build),
 		__MOKU_GAME_ENGINE__: JSON.stringify(page.engine),
-		__MOKU_GAME_EDITOR__: JSON.stringify(page.editor)
+		__MOKU_GAME_EDITOR__: JSON.stringify(page.editor),
+		...page.app === void 0 ? {} : { __MOKU_GAME_APP__: JSON.stringify(page.app) }
 	};
 }
 /**
@@ -1695,7 +1714,8 @@ function pageFiles(run, settings, page) {
 	const flags = {
 		build: page.build,
 		control: page.level === "full",
-		engine: page.engine
+		engine: page.engine,
+		app: page.app
 	};
 	return {
 		...release,
@@ -1842,17 +1862,18 @@ function refuseStoreDebug(run, env) {
 	throw new Error("[game] build: MOKU_NATIVE_PROFILE is store: a store page must not carry the editor agent.\n  Build the store app without --debug.");
 }
 /**
-* What a debug run builds its page with: the editor's page agent must resolve from the game, and
-* the engine the page bundles is fingerprinted.
+* What a debug run builds its page with: the editor's page agent must resolve from the game, the
+* engine the page bundles is fingerprinted, and the app id comes from the native identifier.
 *
 * @param run - The flags of a debug run.
 * @param level - Its profile.
-* @param deps - The resolver and the clock.
+* @param settings - The resolved config, for the native identifier.
+* @param deps - The resolver, the clock and the environment.
 * @returns The debug page and the engine fingerprint.
 * @throws {Error} With the install line when the game cannot resolve `@moku-labs/editor`, and
 *   when it cannot resolve `@moku-labs/game/hot`.
 */
-function debugPageOf(run, level, deps) {
+function debugPageOf(run, level, settings, deps) {
 	try {
 		deps.resolve(DEBUG_AGENT, run.root);
 	} catch (error) {
@@ -1862,9 +1883,10 @@ function debugPageOf(run, level, deps) {
 	return {
 		page: {
 			level,
-			build: buildIdOf(level, deps.now()),
+			build: buildIdOf(deps.now()),
 			engine: engine.id,
-			editor: run.editor ?? "127.0.0.1:47600"
+			editor: run.editor ?? "127.0.0.1:47600",
+			app: appIdOf(settings.native?.identifier, deps.env.MOKU_NATIVE_PROFILE)
 		},
 		engine
 	};
@@ -1902,7 +1924,7 @@ async function runBuild(run, deps) {
 	refuseStoreDebug(run, deps.env);
 	const settings = await loadGame(run.root);
 	refuseOut(run.root, run.out);
-	const debug = run.debug === void 0 ? void 0 : debugPageOf(run, run.debug, deps);
+	const debug = run.debug === void 0 ? void 0 : debugPageOf(run, run.debug, settings, deps);
 	const packed = await deps.assets(packArguments(run.root, settings, false));
 	if (packed !== 0) return packed;
 	rmSync(run.out, {
@@ -2192,13 +2214,17 @@ const DEFAULT_PORT = "3000";
 const MAX_PORT = 65535;
 /** A host of `--editor`: a name or an IPv4 address, or an IPv6 address in brackets. */
 const EDITOR_HOST = /^(?:[\w.-]+|\[[\da-f:.]+\])$/i;
+/** The value a bare `--debug` reads as: the full profile, with no alias note. */
+const BARE_DEBUG = "";
+/** The one line `--debug=full` prints: the alias builds the same page as `--debug`. */
+const FULL_ALIAS_NOTE = "--debug already includes control; =full is no longer needed";
 /** The text of `moku-game help`. */
 const USAGE = [
 	"moku-game <command> [options]",
 	"",
 	"  dev [--port 3000] [--packed]          serve the game with hot reload",
-	"  build [--out dist/web] [--debug[=full] [--editor host:port]]  pack the assets and build the page; --debug adds the editor agent",
-	"  native build <target> [--simulator] [--debug[=full] [--editor host:port]]  build the native app (ios, macos, android)",
+	"  build [--out dist/web] [--debug [--editor host:port]]  pack the assets and build the page; --debug adds the editor agent and control",
+	"  native build <target> [--simulator] [--debug [--editor host:port]]  build the native app (ios, macos, android)",
 	"  native dev <target>                   run the native shell on the dev server",
 	"  native doctor | native clean          check or remove the native project",
 	"  keys [--check]                        write generated/assets.ts and generated/manifest.json",
@@ -2279,8 +2305,8 @@ function checkTokens(command, tokens) {
 }
 /**
 * Reads the command line into one command with its flags, the paths resolved against the
-* working directory. A bare `--debug` reads as `--debug=read`: a string flag without its value
-* would take the next word.
+* working directory. A bare `--debug` reads as `--debug=` (the empty value, the full profile): a
+* string flag without its value would take the next word.
 *
 * @param given - The arguments after the bin.
 * @param cwd - The working directory.
@@ -2288,7 +2314,7 @@ function checkTokens(command, tokens) {
 * @throws {Error} When the command is unknown or a flag is refused.
 */
 function parseCommand(given, cwd) {
-	const argv = given.map((word) => word === "--debug" ? "--debug=read" : word);
+	const argv = given.map((word) => word === "--debug" ? `--debug=${BARE_DEBUG}` : word);
 	const loose = parseLoose(argv);
 	const word = loose.positionals[0];
 	if (loose.values.help === true || word === "help") return "help";
@@ -2316,27 +2342,38 @@ function parseCommand(given, cwd) {
 function refuseExtra(parsed, count) {
 	const extra = parsed.rest[count];
 	if (extra === void 0) return;
-	const advice = parsed.values.debug !== void 0 && (extra === "full" || extra === "read") ? ` Write --debug=${extra}.` : "";
+	const advice = parsed.values.debug !== void 0 && (extra === "full" || extra === "read") ? ` Write ${extra === "read" ? "--debug=read" : "--debug"}.` : "";
 	throw new Error(`[game] ${parsed.command}: unexpected argument "${extra}".${advice}`);
 }
 /**
-* Reads `--debug`: no flag is a release page, a bare flag or `read` the read profile, `full`
-* every command.
+* Reads `--debug`: no flag is a release page, a bare flag or its alias `full` every command,
+* `read` the read and cosmetic commands only.
 *
-* @param value - The value of the flag, `read` for a bare `--debug`.
+* @param value - The value of the flag, the empty value for a bare `--debug`.
 * @param command - The command word, for the message.
 * @returns The profile, or `undefined` without the flag.
 * @throws {Error} When the value is another word.
 * @example
 * ```ts
-* debugLevelOf("full"); // "full"
+* debugLevelOf(""); // "full"
 * ```
 */
 function debugLevelOf(value, command = "build") {
+	if (value === BARE_DEBUG) return "full";
 	if (value === void 0 || value === "read" || value === "full") return value;
 	throw new Error(`[game] ${command}: --debug takes no value, "read" or "full", got "${value}".`);
 }
 /**
+* Prints the alias note once when the command line spells the full profile out: `--debug=full`
+* builds the same page as `--debug`.
+*
+* @param parsed - The command line.
+* @param ui - The console.
+*/
+function noteFullAlias(parsed, ui) {
+	if (parsed.values.debug === "full") ui.info(FULL_ALIAS_NOTE);
+}
+/**
 * Reads `--editor`: the `host:port` the page agent of a debug page dials, 127.0.0.1:47600 when
 * left out.
 *
@@ -2425,6 +2462,7 @@ async function runNativeVerb(parsed, deps) {
 	if (verb === void 0) throw new Error(`[game] native: no verb "${word}". Name one of build, dev, doctor, clean.`);
 	refuseExtra(parsed, 2);
 	const debug = nativeDebugOf(parsed, verb, target);
+	noteFullAlias(parsed, deps.ui);
 	const settings = await loadSettings(parsed.root);
 	const where = {
 		cwd: parsed.root,
@@ -2537,8 +2575,8 @@ function hop(argv, parsed, deps) {
 	}).exited;
 }
 /**
-* Runs `moku-game build`: a release page, or with `--debug[=full]` a debug page whose agent dials
-* `--editor`.
+* Runs `moku-game build`: a release page, or with `--debug` a debug page whose agent dials
+* `--editor` (`--debug=read` for the rare read-only page).
 *
 * @param parsed - The command line.
 * @param deps - The process seams.
@@ -2550,6 +2588,7 @@ function runBuildCommand(parsed, deps) {
 	const debug = debugLevelOf(parsed.values.debug);
 	const editor = parsed.values.editor;
 	if (debug === void 0 && editor !== void 0) throw new Error("[game] build: --editor goes with --debug.");
+	noteFullAlias(parsed, deps.ui);
 	const out = parsed.values.out ?? path.join(parsed.root, "dist", "web");
 	return runBuild({
 		root: parsed.root,
@@ -2955,12 +2994,12 @@ function systemRowsOf(settings) {
 * @returns The command.
 * @example
 * ```ts
-* webBuildOf({ cwd: "/g", command: '"bun" "/g/bin/moku-game.mjs"' }, { level: "full", editor: "192.168.1.20:47600" }); // '"bun" "/g/bin/moku-game.mjs" build --debug=full --editor 192.168.1.20:47600'
+* webBuildOf({ cwd: "/g", command: '"bun" "/g/bin/moku-game.mjs"' }, { level: "full", editor: "192.168.1.20:47600" }); // '"bun" "/g/bin/moku-game.mjs" build --debug --editor 192.168.1.20:47600'
 * ```
 */
 function webBuildOf(where, debug) {
 	if (debug === void 0) return `${where.command} build`;
-	const level = debug.level === "full" ? "--debug=full" : "--debug";
+	const level = debug.level === "full" ? "--debug" : "--debug=read";
 	const editor = debug.editor === void 0 ? "" : ` --editor ${debug.editor}`;
 	return `${where.command} build ${level}${editor}`;
 }

package/dist/{commands-DAETmK86.d.mts → commands-C_GccOFq.d.mts}

@@ -1,14 +1,14 @@
-import { Hn as FlowState, I as Captured, Ir as Time, Mr as FrameRate, S as ScenesApi, T as Api$1, ht as DebugSwitches, wr as Api, xr as StoreApi, yr as Snapshot, zn as Bookmark, zt as Api$2 } from "./types-BGcda5Le.mjs";
-import { P as AnimApi, a as AudioApi, h as EffectsApi, r as UiApi } from "./types-GHE4J5Uf.mjs";
-import { j as InputApi } from "./types-7GXcXxxv.mjs";
-import { t as HeadlessApp } from "./headless-cFveciuY.mjs";
-import { n as Command, r as ControlApp } from "./types-DngFQJro.mjs";
+import { Dt as DebugSwitches, I as Captured, Ir as Api, Jr as Time, Nr as StoreApi, S as ScenesApi, T as Api$1, Wr as FrameRate, Zn as Bookmark, Zt as Api$2, er as FlowState, jr as Snapshot } from "./types-BHgJ1F6f.mjs";
+import { P as AnimApi, a as AudioApi, h as EffectsApi, r as UiApi } from "./types-fpFKYm6E.mjs";
+import { j as InputApi } from "./types-Bm7DVtA_.mjs";
+import { t as HeadlessApp } from "./headless-D6BrEwCf.mjs";
+import { n as Command, r as ControlApp } from "./types-jiWJhLPE.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**
  * Every command of the engine, keyed by its short name: what an editor lists as buttons and MCP
  * tools. Frozen. Each runs on the dev page and on a debug page, by the profile `run` checks: a
- * `--debug` page runs the read and cosmetic ones.
+ * `--debug` page runs every one, a `--debug=read` page the read and cosmetic ones.
  *
  * @example
  * ```ts
@@ -115,6 +115,7 @@ declare const commands: Readonly<{
     nineSlice: "boolean?";
     verifyFrames: "boolean?";
     kept: "boolean?";
+    overdraw: "boolean?";
   }, DebugSwitches, HeadlessApp & {
     readonly log: import("@moku-labs/common/browser").LogApi;
   } & {

package/dist/control.d.mts

@@ -1,7 +1,7 @@
-import { t as HeadlessApp } from "./headless-cFveciuY.mjs";
-import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-DngFQJro.mjs";
-import { t as commands } from "./commands-DAETmK86.mjs";
-import { t as defineCommand } from "./define-BASd9ZUh.mjs";
+import { t as HeadlessApp } from "./headless-D6BrEwCf.mjs";
+import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-jiWJhLPE.mjs";
+import { t as commands } from "./commands-C_GccOFq.mjs";
+import { t as defineCommand } from "./define-DnO7ZLGl.mjs";
 
 //#region src/plugins/flow/doors/dev.d.ts
 /**
@@ -42,18 +42,18 @@ declare global {
   var __MOKU_GAME_AGENT__: boolean | undefined;
   /**
    * The control flag: every /control command runs, the state-changing ones too (`route`, `cheat`, `raw`).
-   * `moku-game dev` and `moku-game build --debug=full` set it; `--debug` and `moku-game build` define it `false`.
+   * `moku-game dev` and `moku-game build --debug` set it; `--debug=read` and `moku-game build` define it `false`.
    *
    * @example
    * ```ts
-   * // The in-memory agent.ts of `moku-game build --debug=full`.
+   * // The in-memory agent.ts of `moku-game build --debug`.
    * globalThis.__MOKU_GAME_CONTROL__ = true;
    * ```
    */
   var __MOKU_GAME_CONTROL__: boolean | undefined;
   /**
-   * The id of the build the page came from: `"dev"` on the dev page, `"debug-20261014T153012Z"` or
-   * `"debug-full-20261014T153012Z"` on a debug build, undefined on a release build.
+   * The id of the build the page came from: `"dev"` on the dev page, `"debug-20261014T153012Z"` on a
+   * debug build of either profile, undefined on a release build.
    *
    * @example
    * ```ts
@@ -86,6 +86,18 @@ declare global {
    * ```
    */
   var __MOKU_GAME_EDITOR__: string | undefined;
+  /**
+   * The app id of a debug build, so the editor pairs a device stream with its project: `native.identifier` of
+   * `config.ts`, with `.debug` in the native debug app (`MOKU_NATIVE_PROFILE=debug`), which installs under that id.
+   * Undefined on a debug build of a game with no native section, on the dev page and on a release build.
+   *
+   * @example
+   * ```ts
+   * // moku-game native build android --debug, a game with native: { identifier: "com.mokulabs.timber" }
+   * globalThis.__MOKU_GAME_APP__; // "com.mokulabs.timber.debug"
+   * ```
+   */
+  var __MOKU_GAME_APP__: string | undefined;
   /**
    * The overlay channel of the page agent: the editor's page agent sets it when it starts and deletes it when it stops.
    * `open()` shows the card; `open({ mode: "pill" })` the small pill; `toggle()` switches between hidden and the last
@@ -107,7 +119,7 @@ declare global {
   } | undefined;
 }
 /**
- * The error `run` throws on a `--debug` page for a command that changes the game: its `reason`
+ * The error `run` throws on a `--debug=read` page for a command that changes the game: its `reason`
  * tells it apart from any other failure.
  *
  * @example
@@ -123,7 +135,7 @@ type ControlReadOnlyError = Error & {
 /**
  * The error a control command throws when its body runs outside the builds its guard allows. It
  * carries `reason: "dev-only"`, so an editor tells a refusal by the body's guard apart from a
- * failure, as `reason: "read-only"` tells the refusal of `run` on a `--debug` page.
+ * failure, as `reason: "read-only"` tells the refusal of `run` on a `--debug=read` page.
  *
  * @example
  * ```ts
@@ -147,14 +159,14 @@ type ControlRefusedError = Error & {
  */
 declare function controlRefused(): ControlRefusedError;
 /**
- * Builds the error `run` throws on a `--debug` page for a command whose effect is `route`,
+ * Builds the error `run` throws on a `--debug=read` page for a command whose effect is `route`,
  * `cheat` or `raw`. It carries `reason: "read-only"`, so an editor tells it apart from a failure.
  *
  * @param id - The id of the refused command.
  * @returns The error, ready to throw.
  * @example
  * ```ts
- * // The editor on a --debug page.
+ * // The editor on a --debug=read page.
  * try { await run(app, commands.tap, { key: "play" }); } catch (error) { Reflect.get(Object(error), "reason"); // "read-only" }
  * ```
  */
@@ -162,17 +174,17 @@ declare function controlReadOnly(id: string): ControlReadOnlyError;
 //#endregion
 //#region src/plugins/flow/doors/run.d.ts
 /**
- * Runs a command in a dev build or a debug build. A debug build of `--debug` runs the read and
- * cosmetic commands only; `--debug=full` and the dev page run every command. A `cheat` or `raw`
+ * Runs a command in a dev build or a debug build. A `--debug` build and the dev page run every
+ * command; a `--debug=read` build runs the read and cosmetic ones only. A `cheat` or `raw`
  * command taints the session and is journaled before it runs, so a failing one still counts.
  *
  * @param app - The app the command acts on.
  * @param command - The command.
  * @param input - Its input; left out when every field of its schema is optional.
  * @returns The command's value and the envelope read after it.
- * @throws {Error} Outside dev builds and debug builds (read and cosmetic commands; every command
- *   with `--debug=full`), the read-only refusal of `controlReadOnly` for a `route`, `cheat` or
- *   `raw` command on a `--debug` page, and whatever the command throws.
+ * @throws {Error} Outside dev builds and debug builds (every command with `--debug`; the read and
+ *   cosmetic ones alone with `--debug=read`), the read-only refusal of `controlReadOnly` for a
+ *   `route`, `cheat` or `raw` command on a `--debug=read` page, and whatever the command throws.
  * @example
  * ```ts
  * // An e2e script: load the bug report, then tap Play.
@@ -180,7 +192,7 @@ declare function controlReadOnly(id: string): ControlReadOnlyError;
  * const ran = await run(app, commands.answer, { intent: "play" });
  * ran.value; // true
  * ran.state; // { path: "board/awaitIntent", frame: 14, tainted: true }
- * // On a --debug page: await run(app, commands.tap, { key: "play" }); // throws "[game] The command game.tap changes the game: …"
+ * // On a --debug=read page: await run(app, commands.tap, { key: "play" }); // throws "[game] The command game.tap changes the game: …"
  * ```
  */
 declare function run<S extends InputSchema, O, App extends HeadlessApp>(app: App, command: Command<S, O, App>, ...input: InputArguments<S>): Promise<Ran<O>>;

package/dist/control.mjs

@@ -1,4 +1,4 @@
-import { n as controlRefused, t as controlReadOnly } from "./dev-DbHgx-R-.mjs";
+import { n as controlRefused, t as controlReadOnly } from "./dev-BNndV-hU.mjs";
 import { s as defineCommand } from "./session-CeKgO2hy.mjs";
-import { n as commands, t as run } from "./run-BbipFRc6.mjs";
+import { n as commands, t as run } from "./run-C07NXds7.mjs";
 export { commands, controlReadOnly, controlRefused, defineCommand, run };

package/dist/{define-BASd9ZUh.d.mts → define-DnO7ZLGl.d.mts}

@@ -1,5 +1,5 @@
-import { t as HeadlessApp } from "./headless-cFveciuY.mjs";
-import { c as Source, n as Command, o as InputSchema } from "./types-DngFQJro.mjs";
+import { t as HeadlessApp } from "./headless-D6BrEwCf.mjs";
+import { c as Source, n as Command, o as InputSchema } from "./types-jiWJhLPE.mjs";
 
 //#region src/plugins/flow/doors/define.d.ts
 /**

package/dist/{dev-DbHgx-R-.mjs → dev-BNndV-hU.mjs}

@@ -33,7 +33,7 @@ function isAgent() {
 * @returns True only when `__MOKU_GAME_CONTROL__` is exactly `true`.
 * @example
 * ```ts
-* isControl(); // true on the page of moku-game build --debug=full, false on a --debug page
+* isControl(); // true on the page of moku-game build --debug, false on a --debug=read page
 * ```
 */
 function isControl() {
@@ -54,19 +54,19 @@ function controlRefused() {
 	return Object.assign(/* @__PURE__ */ new Error("[game] Control commands run in dev builds only.\n  Define __MOKU_GAME_DEV__ as true in the dev build."), { reason: "dev-only" });
 }
 /**
-* Builds the error `run` throws on a `--debug` page for a command whose effect is `route`,
+* Builds the error `run` throws on a `--debug=read` page for a command whose effect is `route`,
 * `cheat` or `raw`. It carries `reason: "read-only"`, so an editor tells it apart from a failure.
 *
 * @param id - The id of the refused command.
 * @returns The error, ready to throw.
 * @example
 * ```ts
-* // The editor on a --debug page.
+* // The editor on a --debug=read page.
 * try { await run(app, commands.tap, { key: "play" }); } catch (error) { Reflect.get(Object(error), "reason"); // "read-only" }
 * ```
 */
 function controlReadOnly(id) {
-	return Object.assign(/* @__PURE__ */ new Error(`[game] The command ${id} changes the game: this debug build runs read and cosmetic commands only.\n  Build with moku-game build --debug=full to run it.`), { reason: "read-only" });
+	return Object.assign(/* @__PURE__ */ new Error(`[game] The command ${id} changes the game: this debug build runs read and cosmetic commands only.\n  Build with moku-game build --debug to run it.`), { reason: "read-only" });
 }
 /**
 * Builds the error a door source or command throws when the opt-in plugin it uses is not

package/dist/{headless-cFveciuY.d.mts → headless-D6BrEwCf.d.mts}

@@ -1,4 +1,4 @@
-import { Ar as Api, Cr as RngState, Gn as RouteStep, Hn as FlowState, Un as JournalEntry, bn as Api$1, er as Answer, ur as Json } from "./types-BGcda5Le.mjs";
+import { Fr as RngState, Hr as Api, Mn as Api$1, Sr as Json, er as FlowState, fr as Answer, rr as RouteStep, tr as JournalEntry } from "./types-BHgJ1F6f.mjs";
 
 //#region src/plugins/flow/headless.d.ts
 /**

package/dist/{index-DedbED3T.d.mts → index-w2uyRKkj.d.mts}

@@ -1,6 +1,6 @@
-import { An as defineFlow, Ar as Api$5, Bn as DefineNode, Br as Require, Bt as Config$8, C as State$7, Cn as EmitterIdOf, Dn as State$3, Dr as PauseReason, E as Config$6, Er as Events, Et as NineSliceValue, Fn as FeatureDescription, Fr as ThermalReading, H as FrameRing, Ht as State$9, In as FeaturePlugin, It as TransformValue, Jn as Descriptor, Kn as SceneIdOf, Ln as FeatureTree, Lt as sprite, N as State$6, Nr as RateChange, Nt as SpriteOptions, On as TextStylesOf, Or as State$4, Ot as OverlayValue, Pr as State$8, Pt as SpriteValue, Qn as Hint, Rr as Config$9, S as ScenesApi, Sn as Config$3, Sr as RngApi, T as Api$4, Tn as HudKeysOf, Tr as Config$4, V as FrameRecord, Xn as EffectOptions, Xt as ComponentValue, Yn as Effect, Yt as ComponentType, Zn as GuideOptions, _ as DefineScene, a as Config$1, an as SystemFor, ar as State$2, b as SceneDefinition, bn as Api$2, bt as ViewportSize, c as LoadBundles, cn as DescriptionNode, cr as Config$5, dr as Root, en as Mut, er as Answer, f as State$1, fr as State$5, g as AnySceneProjection, gn as ReducedMotion, hn as ProjectionSpec, i as BundleSpec, in as SystemDefinition, jr as Config$7, jt as ShapeValue, l as LoadReason, ln as Ease, mn as ProjectionMotion, mr as Patch, nn as QueryTerm, o as DefineBundles, on as TagType, p as Tier, pn as NumericFields, qt as ComponentHandle, r as BundleMap, rn as ResourceType, rr as Config$2, t as Api, tn as Narrowed, tr as Api$1, u as LoadResult, ur as Json, wn as GameTypes, wr as Api$3, wt as HudPartValue, x as SceneSpec, xn as BundlesOf, xr as StoreApi, y as LayerMap, zr as Events$1, zt as Api$6 } from "./types-BGcda5Le.mjs";
-import { A as GlowValue, B as Target, C as BlurValue, D as FilterComponent, F as AnimPlayerValue, H as HapticKind, I as Config$10, K as defineAnimation, L as FramesValue, M as OutlineValue, N as UniformDeclaration, O as FilterSpec, P as AnimApi, Q as play, R as MotionKeyframe, S as AlphaValue, T as DisplacementValue, U as SfxDescriptor, W as Step, _ as State$12, a as AudioApi, b as EmitterDefinition, c as MusicDescriptor, ct as OverlayApi, d as State$11, f as VolumesFor, h as EffectsApi, j as NoiseValue, k as FilterValueOf, l as MusicOptions, m as Config$12, n as State$13, r as UiApi, s as Config$11, t as Config$13, w as ColorMatrixValue, x as EmitterValue, y as EmitterConfig, z as State$10 } from "./types-GHE4J5Uf.mjs";
-import { A as Config$15, B as State$14, C as TextBind, D as TextValue, E as TextStyles, F as Config$14, G as IsFlags, H as TextKey, I as I18nApi, K as ResolvedStyle, L as IntlKit, M as State$15, P as Argument, R as Message, S as TextApi, T as TextStyleInput, U as TypedTr, Y as WhenFlags, _ as BindOptions, b as Point, g as BindField, j as InputApi, k as defineComponent, m as IntrinsicElementsFor, p as defineTokens, q as Style, s as PopupComponent, v as Config$16, x as State$16, y as CountdownValue, z as Part } from "./types-7GXcXxxv.mjs";
+import { $ as PassKind, Bn as TextStylesOf, Br as State$4, Bt as OverlayValue, C as State$7, Cr as Root, Dn as ProjectionSpec, E as Config$6, En as ProjectionMotion, Er as Patch, Fn as EmitterIdOf, Gr as RateChange, Gt as SpriteOptions, H as FrameRecord, Hn as defineFlow, Hr as Api$5, In as GameTypes, Ir as Api$3, It as HudPartValue, Jn as FeaturePlugin, Jt as TransformValue, Kr as State$8, Kt as SpriteValue, Ln as HudKeysOf, Lr as Config$4, Mn as Api$2, Mt as ViewportSize, N as State$6, Nn as BundlesOf, Nr as StoreApi, On as ReducedMotion, Pn as Config$3, Pr as RngApi, Qn as DefineNode, Qr as Require, Qt as Config$8, Rr as Events, Rt as NineSliceValue, S as ScenesApi, Sr as Json, T as Api$4, Tn as NumericFields, U as FrameRing, Ur as Config$7, Ut as ShapeValue, Xr as Config$9, Yn as FeatureTree, Yt as sprite, Zr as Events$1, Zt as Api$6, _ as DefineScene, _n as SystemFor, _r as State$2, a as Config$1, an as ComponentHandle, b as SceneDefinition, bn as DescriptionNode, br as Config$5, c as LoadBundles, cn as ComponentValue, cr as EffectOptions, en as State$9, f as State$1, fn as Mut, fr as Answer, g as AnySceneProjection, gn as SystemDefinition, hn as ResourceType, hr as Config$2, i as BundleSpec, ir as SceneIdOf, l as LoadReason, lr as GuideOptions, mn as QueryTerm, o as DefineBundles, or as Descriptor, p as Tier, pn as Narrowed, pr as Api$1, qn as FeatureDescription, qr as ThermalReading, r as BundleMap, sn as ComponentType, sr as Effect, t as Api, u as LoadResult, ur as Hint, vn as TagType, wr as State$5, x as SceneSpec, xn as Ease, y as LayerMap, zn as State$3, zr as PauseReason } from "./types-BHgJ1F6f.mjs";
+import { A as GlowValue, B as Target, C as BlurValue, D as FilterComponent, F as AnimPlayerValue, H as HapticKind, I as Config$10, K as defineAnimation, L as FramesValue, M as OutlineValue, N as UniformDeclaration, O as FilterSpec, P as AnimApi, Q as play, R as MotionKeyframe, S as AlphaValue, T as DisplacementValue, U as SfxDescriptor, W as Step, _ as State$12, a as AudioApi, b as EmitterDefinition, c as MusicDescriptor, ct as OverlayApi, d as State$11, f as VolumesFor, h as EffectsApi, j as NoiseValue, k as FilterValueOf, l as MusicOptions, m as Config$12, n as State$13, r as UiApi, s as Config$11, t as Config$13, w as ColorMatrixValue, x as EmitterValue, y as EmitterConfig, z as State$10 } from "./types-fpFKYm6E.mjs";
+import { A as Config$15, B as State$14, C as TextBind, D as TextValue, E as TextStyles, F as Config$14, G as IsFlags, H as TextKey, I as I18nApi, K as ResolvedStyle, L as IntlKit, M as State$15, P as Argument, R as Message, S as TextApi, T as TextStyleInput, U as TypedTr, Y as WhenFlags, _ as BindOptions, b as Point, g as BindField, j as InputApi, k as defineComponent, m as IntrinsicElementsFor, p as defineTokens, q as Style, s as PopupComponent, v as Config$16, x as State$16, y as CountdownValue, z as Part } from "./types-Bm7DVtA_.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -977,6 +977,18 @@ declare const Now: ResourceType<{
 }>;
 //#endregion
 //#region src/plugins/renderer/monitor/ring.d.ts
+/**
+ * The pass kinds by their index in the pass ring's `kind` column: 0 the canvas, 1 a texture, 2 a filter. A root export,
+ * so a reader of the ring names a pass's kind without building a record.
+ *
+ * @example
+ * ```ts
+ * // The editor's pass strip names the newest pass of a debug build from the ring.
+ * const { passes } = app.renderer.monitor.frames();
+ * PASS_KINDS[passes.kind[passes.newest] ?? 0]; // "filter"
+ * ```
+ */
+declare const PASS_KINDS: readonly PassKind[];
 /**
  * One slot of the ring as a plain record, `age` 0 the newest frame; `undefined` beyond the frames held. Allocates: for
  * tests and tools, never per frame. A root export.
@@ -1918,4 +1930,4 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
   };
 }> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$16, State$16, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$13, State$13, UiApi, {}> & Record<never, never>];
 //#endregion
-export { guide as $, Held as A, label as At, Traced as B, Animation as C, assetsPlugin as Ct, load as D, Text as Dt, defineBundles as E, Countdown as Et, Pressed as F, Order as G, Exiting as H, Swipeable as I, mut as J, Tree as K, Tappable as L, Pointer as M, PointerOver as N, Draggable as O, bind as Ot, Pressable as P, defineEffect as Q, Touchable as R, AnimPlayer as S, audioPlugin as St, defineScene as T, projection as Tt, Layer as U, frameAt as V, Now as W, system as X, resource as Y, tag as Z, defineStyle as _, i18nPlugin as _t, defineEmitter as a, uiPlugin as at, messageDuration as b, debugPlugin as bt, Alpha as c, scenesPlugin as ct, Displacement as d, BackResult as dt, hint as et, Glow as f, PlatformProvider as ft, resolve as g, inputPlugin as gt, music as h, lifecyclePlugin as ht, screen as i, worldPlugin as it, Hovered as j, DropTarget as k, defineTextStyles as kt, Blur as l, rendererPlugin as lt, Outline as m, modelPlugin as mt, createPlugin as n, defineFeature as nt, Emitter as o, timePlugin as ot, Noise as p, types_d_exports as pt, component as q, defineGame as r, flattenFeatures as rt, defineFilter as s, textPlugin as st, createApp as t, schedule as tt, ColorMatrix as u, platformPlugin as ut, tr as v, flowPlugin as vt, Frames as w, animPlugin as wt, defineMotion as x, clockPlugin as xt, messageArgument as y, effectsPlugin as yt, Traceable as z };
+export { defineEffect as $, Held as A, defineTextStyles as At, Traced as B, Animation as C, audioPlugin as Ct, load as D, Countdown as Dt, defineBundles as E, projection as Et, Pressed as F, Now as G, frameAt as H, Swipeable as I, component as J, Order as K, Tappable as L, Pointer as M, PointerOver as N, Draggable as O, Text as Ot, Pressable as P, tag as Q, Touchable as R, AnimPlayer as S, clockPlugin as St, defineScene as T, animPlugin as Tt, Exiting as U, PASS_KINDS as V, Layer as W, resource as X, mut as Y, system as Z, defineStyle as _, inputPlugin as _t, defineEmitter as a, worldPlugin as at, messageDuration as b, effectsPlugin as bt, Alpha as c, textPlugin as ct, Displacement as d, platformPlugin as dt, guide as et, Glow as f, BackResult as ft, resolve as g, lifecyclePlugin as gt, music as h, modelPlugin as ht, screen as i, flattenFeatures as it, Hovered as j, label as jt, DropTarget as k, bind as kt, Blur as l, scenesPlugin as lt, Outline as m, types_d_exports as mt, createPlugin as n, schedule as nt, Emitter as o, uiPlugin as ot, Noise as p, PlatformProvider as pt, Tree as q, defineGame as r, defineFeature as rt, defineFilter as s, timePlugin as st, createApp as t, hint as tt, ColorMatrix as u, rendererPlugin as ut, tr as v, i18nPlugin as vt, Frames as w, assetsPlugin as wt, defineMotion as x, debugPlugin as xt, messageArgument as y, flowPlugin as yt, Traceable as z };