@moku-labs/game 0.10.0 → 0.12.0

package/README.md

@@ -167,6 +167,7 @@ The engine bin `moku-game` serves, builds and packs a game folder. A game writes
 | `moku-game native doctor`, `native clean` | Checks or removes the native project |
 | `moku-game keys [--check]` | Writes `generated/assets.ts`, the strings and `manifest.json` |
 | `moku-game pack [--no-cache]` | Packs the assets into `dist/assets` |
+| `moku-game visual [--update] [--only <name>] [--no-pixels]` | Runs the visual tests of `tests/visual/index.ts` against `tests/visual/baselines/`. The pixel leg runs on a Mac, on a page served for the run. Exit 1 when a checkpoint differs |
 
 Every command takes `--root <dir>`, `--preload <path>` and `--serve-plugin <path>`.
 

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-DLghaGEy.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 { ct as PlatformProvider } from "../index-rnOYAriI.mjs";
+import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-DLghaGEy.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-DLghaGEy.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 { Ct as effectsPlugin, H as platformPlugin, Nt as audioPlugin, i as screen, t as createApp } from "./src-SmT-XxVf.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
 //#region src/app/define.ts

package/dist/{assets-BHwTLVta.mjs → assets-DYiKxPBX.mjs}

@@ -1059,21 +1059,30 @@ function copyLoose(bundle, file, bytes) {
 const LOOSE_SIDE = 512;
 /** The last segment of a key that names a particle texture starts with this. */
 const FX_PREFIX = "fx-";
+/** A folder of particle textures: every texture below it is one. */
+const FX_FOLDER = "fx";
 /** The groups in the order a bundle packs them. */
 const GROUP_ORDER = ["fx", "main"];
 /**
-* Picks the atlas group of one texture. A key whose last segment starts with `fx-` goes to `fx`
-* whatever its size; any other texture goes to `main` when no side is above 512 px.
+* Picks the atlas group of one texture. A key whose last segment starts with `fx-`, or with a
+* folder segment `fx` between the bundle name and the stem, goes to `fx` whatever its size: the
+* frames of an animation in `fx/` too. Any other texture goes to `main` when no side is above
+* 512 px.
 *
 * @param texture - The key and the size of the texture.
 * @returns The group, or `undefined` when the texture stays loose by its size.
 * @example
 * ```ts
 * groupOf({ key: "ui.fx-rays", width: 504, height: 512 }); // "fx"
+* groupOf({ key: "ui.fx.leaf", width: 64, height: 64 }); // "fx", from assets/fx/leaf.webp of ui
+* groupOf({ key: "ui.fx", width: 64, height: 64 }); // "main": a stem, no folder
 * ```
 */
 function groupOf(texture) {
-	if (texture.key.slice(texture.key.lastIndexOf(".") + 1).startsWith(FX_PREFIX)) return "fx";
+	const segments = texture.key.split(".");
+	const name = segments.at(-1) ?? "";
+	const folders = segments.slice(1, -1);
+	if (name.startsWith(FX_PREFIX) || folders.includes(FX_FOLDER)) return "fx";
 	return texture.width <= LOOSE_SIDE && texture.height <= LOOSE_SIDE ? "main" : void 0;
 }
 /**
@@ -3080,65 +3089,23 @@ async function runCli(argv, strings, ui = createBrandConsole()) {
 */
 /** How every generated file starts. */
 const HEADER = "// generated by @moku-labs/game/assets, do not edit";
-/** The TypeScript cast keyword, kept apart so this file writes one and holds none. */
-const CAST$1 = "as";
+/** The engine root a generated module imports its types and helpers from, quoted. */
+const ENGINE = "\"@moku-labs/game\"";
 /** How a key with no parameters is typed, so `tr` takes it with no second argument. */
 const NO_PARAMS = "Record<string, never>";
 /** The name of the union a plain argument is typed by. */
 const ARGUMENT = "Argument";
 /**
-* The helper a compiled message calls for a plain argument: an element node keeps its place, a
-* list and a number go through `Intl`, everything else is read as text.
+* The import of the helpers the messages of a module call, by the names the message bodies use:
+* `messageArgument` as `argument` for a plain argument, `messageDuration` as `duration` for a
+* duration. None when no message calls one.
 *
-* @returns The helper as source.
+* @param entries - The keys of the locale.
+* @returns The import line, or `undefined`.
 */
-function argumentHelper() {
-	return [
-		"/** One plain argument: an element stays an element, a list and a number go through Intl. */",
-		"function argument(value: unknown, intl: I18n.IntlKit): I18n.Part {",
-		"  if (Array.isArray(value)) {",
-		`    return { kind: "text", text: intl.list().format(value ${CAST$1} readonly string[]) };`,
-		"  }",
-		"",
-		"  if (typeof value === \"number\") return { kind: \"text\", text: intl.number().format(value) };",
-		"",
-		"  if (",
-		"    typeof value === \"object\" &&",
-		"    value !== null &&",
-		"    \"type\" in value &&",
-		"    \"props\" in value &&",
-		"    \"children\" in value",
-		"  ) {",
-		`    return { kind: "element", node: value ${CAST$1} I18n.ElementNode };`,
-		"  }",
-		"",
-		"  return { kind: \"text\", text: String(value) };",
-		"}"
-	].join("\n");
-}
-/**
-* The helper a compiled `duration` calls: milliseconds into the record `Intl.DurationFormat`
-* reads. The same split as `durationInput` of the plugin: whole seconds rounded up, a negative or
-* non-finite value as zero, hours and minutes when above zero, seconds always.
-*
-* @returns The helper as source.
-*/
-function durationHelper() {
-	return [
-		"/** Milliseconds as Intl.DurationFormat reads them: whole seconds rounded up, seconds always. */",
-		"function duration(ms: number): Partial<Record<Intl.DurationFormatUnit, number>> {",
-		"  const total = Number.isFinite(ms) ? Math.max(0, Math.ceil(ms / 1000)) : 0;",
-		"  const hours = Math.floor(total / 3600);",
-		"  const minutes = Math.floor((total % 3600) / 60);",
-		"  const input: Partial<Record<Intl.DurationFormatUnit, number>> = {};",
-		"",
-		"  if (hours > 0) input.hours = hours;",
-		"  if (minutes > 0) input.minutes = minutes;",
-		"  input.seconds = total % 60;",
-		"",
-		"  return input;",
-		"}"
-	].join("\n");
+function helperImport(entries) {
+	const helpers = [...entries.some((entry) => entry.compiled.usesArgument) ? ["messageArgument as argument"] : [], ...entries.some((entry) => entry.compiled.usesDuration) ? ["messageDuration as duration"] : []];
+	return helpers.length === 0 ? void 0 : `import { ${helpers.join(", ")} } from ${ENGINE};`;
 }
 /**
 * Compares two keys, so every list the compiler writes has one order.
@@ -3152,8 +3119,8 @@ function byName(left, right) {
 	return left < right ? -1 : 1;
 }
 /**
-* Writes `generated/strings.<locale>.ts`: one arrow per key, keys sorted, each helper only when a
-* message needs it.
+* Writes `generated/strings.<locale>.ts`: one arrow per key, keys sorted, and the import of each
+* engine helper only when a message calls it.
 *
 * @param entries - The keys of the locale, in any order.
 * @returns The text of the module.
@@ -3166,11 +3133,8 @@ function byName(left, right) {
 function emitLocale(entries) {
 	const sorted = [...entries].toSorted((left, right) => byName(left.key, right.key));
 	const rows = sorted.map((entry) => `  ${JSON.stringify(entry.key)}: ${entry.compiled.source}`);
-	const blocks = [`${HEADER}\nimport type { I18n } from "@moku-labs/game";`];
-	if (sorted.some((entry) => entry.compiled.usesArgument)) blocks.push(argumentHelper());
-	if (sorted.some((entry) => entry.compiled.usesDuration)) blocks.push(durationHelper());
-	blocks.push(`export default {\n${rows.join(",\n")}\n} satisfies I18n.CompiledMessages;`);
-	return `${blocks.join("\n\n")}\n`;
+	const imports = [`import type { I18n } from ${ENGINE};`, helperImport(sorted)].filter((line) => line !== void 0);
+	return [`${HEADER}\n${imports.join("\n")}`, `export default {\n${rows.join(",\n")}\n} satisfies I18n.CompiledMessages;\n`].join("\n\n");
 }
 /**
 * Writes the type of one parameter.
@@ -3230,7 +3194,7 @@ function paramsOf(params) {
 function emitTypes(entries) {
 	const sorted = [...entries].toSorted((left, right) => byName(left.key, right.key));
 	const rows = sorted.map((entry) => `  ${JSON.stringify(entry.key)}: ${paramsOf(entry.params)};`);
-	const blocks = sorted.some((entry) => Object.values(entry.params).some((entry) => entry.kind === "argument")) ? [`${HEADER}\nimport type { DescriptionNode } from "@moku-labs/game";`, `type ${ARGUMENT} = string | number | readonly string[] | DescriptionNode;`] : [HEADER];
+	const blocks = sorted.some((entry) => Object.values(entry.params).some((entry) => entry.kind === "argument")) ? [`${HEADER}\nimport type { DescriptionNode } from ${ENGINE};`, `type ${ARGUMENT} = string | number | readonly string[] | DescriptionNode;`] : [HEADER];
 	blocks.push(`export type Strings = {\n${rows.join("\n")}\n};`, "export type StringKey = keyof Strings;");
 	return `${blocks.join("\n\n")}\n`;
 }

package/dist/assets.mjs

@@ -1,2 +1,2 @@
-import { a as runCli, c as emitKeys, i as compileStrings, l as emitManifest, n as importStrings, o as scanAssets, r as checkStrings, s as packAssets, t as exportStrings } from "./assets-BHwTLVta.mjs";
+import { a as runCli, c as emitKeys, i as compileStrings, l as emitManifest, n as importStrings, o as scanAssets, r as checkStrings, s as packAssets, t as exportStrings } from "./assets-DYiKxPBX.mjs";
 export { checkStrings, compileStrings, emitKeys, emitManifest, exportStrings, importStrings, packAssets, runCli, scanAssets };

package/dist/cli.d.mts

@@ -33,8 +33,8 @@ type PreparedPage = {
 };
 /**
  * Runs one `moku-game` command line in this process: `dev`, `build`, `native <verb>`, `keys`,
- * `pack` or `help`, with `--root`, `--preload` and `--serve-plugin` before or after the command
- * word. Every line goes through the branded console; nothing exits the process.
+ * `pack`, `visual` or `help`, with `--root`, `--preload` and `--serve-plugin` before or after the
+ * command word. Every line goes through the branded console; nothing exits the process.
  *
  * @param argv - The arguments after the bin.
  * @returns The exit code.
@@ -42,6 +42,7 @@ type PreparedPage = {
  * ```ts
  * // bin/moku-game.mjs in a game folder:
  * await runCli(["dev", "--port", "0"]); // 0 after Ctrl+C; stdout had "http://localhost:<port>/"
+ * await runCli(["visual", "--no-pixels"]); // 0 when every checkpoint of tests/visual/index.ts is the same
  * await runCli(["help"]); // 0
  * ```
  */