@moku-labs/game 0.7.1 → 0.9.0

package/dist/{input-CK4nxBO1.mjs → input-z_35Jwfn.mjs}

@@ -24,7 +24,7 @@ function checkId(kind, id) {
 * ```ts
 * // A game's .dev module: the orders on the board, re-read after every edge.
 * export const orders = defineSource({
-*   id: "timber.orders",
+*   id: "mini.orders",
 *   title: "Orders",
 *   input: {},
 *   changes: "edge",
@@ -49,7 +49,7 @@ function defineSource(source) {
 * ```ts
 * // A game's .dev module: open the shop from anywhere, through the graph.
 * export const openShop = defineCommand({
-*   id: "timber.openShop",
+*   id: "mini.openShop",
 *   title: "Open the shop",
 *   input: {},
 *   effect: "route",

package/dist/inspect.d.mts

@@ -1,9 +1,10 @@
-import { At as JournalEntry, H as EntitySnapshot, Ot as FlowGraph, R as ComponentSchema, U as FrameDiff, Ut as Api, f as Usage, gt as Position, j as Explained, k as Api$1, m as Api$2, t as Api$3, tn as Snapshot, w as RenderStats, x as Under } from "./types-BMEn0tSC.mjs";
-import { a as InputOf, c as Source, d as HeadlessApp, i as InputArguments, l as WatchApp, o as InputSchema, t as CheatEntry, u as WatchInput } from "./types-CYYKjvLn.mjs";
-import { c as UiNode } from "./types-BaUUcIaN.mjs";
-import { a as SoundEntry, t as AudioApi, v as UiApi } from "./types-CXyipKhE.mjs";
-import { n as defineSource } from "./define-BbgXv4cy.mjs";
-import { n as EffectsApi, r as EffectsStats } from "./types-ClF8say0.mjs";
+import { Gt as Api, H as EntitySnapshot, R as ComponentSchema, U as FrameDiff, f as Usage, gt as Position, j as Explained, jt as JournalEntry, k as Api$1, kt as FlowGraph, m as Api$2, rn as Snapshot, t as Api$3, w as RenderStats, x as Under } from "./types-B0v5VVa3.mjs";
+import { t as HeadlessApp } from "./headless-SCQXJxQf.mjs";
+import { a as InputOf, c as Source, i as InputArguments, l as WatchApp, o as InputSchema, t as CheatEntry, u as WatchInput } from "./types-DUMoYPYe.mjs";
+import { c as UiNode } from "./types-xXfyk56Q.mjs";
+import { a as SoundEntry, t as AudioApi, v as UiApi } from "./types-VZVWwqCg.mjs";
+import { n as defineSource } from "./define-B6pHpdBi.mjs";
+import { n as EffectsApi, r as EffectsStats } from "./types-CQueODzo.mjs";
 
 //#region src/plugins/flow/doors/read.d.ts
 /**

package/dist/inspect.mjs

@@ -1,3 +1,3 @@
-import { c as defineSource } from "./input-CK4nxBO1.mjs";
-import { n as read, r as watch, t as sources } from "./sources-DVWJ8nfr.mjs";
+import { c as defineSource } from "./input-z_35Jwfn.mjs";
+import { n as read, r as watch, t as sources } from "./sources-DNnzyCYf.mjs";
 export { defineSource, read, sources, watch };

package/dist/jsx-dev-runtime.d.mts

@@ -1,2 +1,2 @@
-import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-HTlmRb81.mjs";
+import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-CdNJ0UBm.mjs";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.d.mts

@@ -1,2 +1,2 @@
-import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-HTlmRb81.mjs";
+import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-CdNJ0UBm.mjs";
 export { Fragment, type JSX, jsx, jsxs };

package/dist/lint.d.mts

@@ -1,9 +1,41 @@
 //#region src/lint.d.ts
-/** The options every rule takes: which files it checks. A key given replaces the rule's default. */
+/**
+ * The options every rule takes: which files it checks. A key given replaces the rule's default.
+ *
+ * @example
+ * ```json
+ * "moku-game/determinism": ["error", { "files": ["src/logic/**"], "ignores": ["src/logic/*.dev.ts"] }]
+ * ```
+ */
 type GameLintOptions = {
   /** Globs of the files the rule checks, relative to the directory oxlint runs in. */files?: string[]; /** Globs of the files the rule skips, even when `files` matches them. */
   ignores?: string[];
 };
+/**
+ * The options of the layout rules `layer-imports`, `feature-door` and `rules-siblings`: the files,
+ * where the layers sit and which tsconfig names the aliases.
+ *
+ * @example
+ * ```json
+ * "moku-game/layer-imports": ["error", { "root": "src", "tsconfig": "tsconfig.game.json" }]
+ * ```
+ */
+type GameLintLayoutOptions = GameLintOptions & {
+  /** The folder of `core/`, `shared/`, `features/`, `plugins/` and `game.ts`, relative to the directory oxlint runs in. Default `.`. */root?: string; /** The tsconfig whose `paths` name the aliases, relative to the directory oxlint runs in. Default `tsconfig.json`. */
+  tsconfig?: string;
+};
+/**
+ * The options of `test-suffix`: the files, the game root and the suffix of each test kind folder.
+ *
+ * @example
+ * ```json
+ * "moku-game/test-suffix": ["error", { "root": "src", "suffixes": { "tests/e2e/": ".spec.ts" } }]
+ * ```
+ */
+type GameLintSuffixOptions = GameLintOptions & {
+  /** The folder whose test files the rule reads, relative to the directory oxlint runs in. Default `.`. */root?: string; /** Kind folder to the suffix of its files, as `{ "tests/e2e/": ".e2e.ts" }`. Replaces the default table. */
+  suffixes?: Record<string, string>;
+};
 /** The part of an ESTree node the rules read. oxlint and ESLint hand over full nodes. */
 type GameLintNode = {
   readonly type: string; /** A string on an `Identifier`; the `JSXIdentifier` node on a `JSXAttribute`. */
@@ -67,7 +99,7 @@ type GameLintRule = {
   };
   create(context: GameLintContext): GameLintListeners;
 };
-/** The plugin object: `moku-game` and its seven rules. */
+/** The plugin object: `moku-game` and its ten rules. */
 type GameLintPlugin = {
   readonly meta: {
     readonly name: "moku-game";
@@ -75,7 +107,7 @@ type GameLintPlugin = {
   readonly rules: Readonly<Record<GameLintRuleName, GameLintRule>>;
 };
 /** The rule names, without the `moku-game/` prefix. */
-type GameLintRuleName = "lazy-imports" | "native-imports" | "dev-imports" | "no-module-state" | "determinism" | "rules-siblings" | "static-keys";
+type GameLintRuleName = "lazy-imports" | "native-imports" | "dev-imports" | "no-module-state" | "determinism" | "rules-siblings" | "static-keys" | "layer-imports" | "feature-door" | "test-suffix";
 /**
  * Turn a glob into an anchored regular expression: `**`, `*`, `?` and one level of `{a,b}`.
  *
@@ -87,6 +119,25 @@ type GameLintRuleName = "lazy-imports" | "native-imports" | "dev-imports" | "no-
  * ```
  */
 declare function globToRegExp(glob: string): RegExp;
+/**
+ * The files a module specifier names through the aliases the layout rules read: the nearest
+ * `paths` of the tsconfig and the configs it extends by relative path, else the v15 aliases under
+ * the game root. A specifier is matched as TypeScript matches it; `@moku-labs/game` is a package
+ * even when the paths map it. The project index maps a specifier the same way, and a unit test
+ * keeps the two in step.
+ *
+ * @param tsconfig - The absolute path of the tsconfig.
+ * @param root - The absolute folder of the layers; the v15 aliases resolve against it.
+ * @param specifier - The module specifier as written.
+ * @returns The absolute targets in the order of the tsconfig; `[]` for a relative specifier, the
+ *   engine and a package.
+ * @example
+ * ```ts
+ * // A game without a tsconfig reads the v15 aliases.
+ * aliasTargetsOf("/game/tsconfig.json", "/game", "@features/orders"); // ["/game/features/orders/index.ts"]
+ * ```
+ */
+declare function aliasTargetsOf(tsconfig: string, root: string, specifier: string): string[];
 /**
  * The `moku-game` oxlint plugin. A game loads it by package name and turns its rules on.
  *
@@ -97,4 +148,4 @@ declare function globToRegExp(glob: string): RegExp;
  */
 declare const plugin: GameLintPlugin;
 //#endregion
-export { GameLintContext, GameLintDefinition, GameLintListeners, GameLintNode, GameLintOptions, GameLintPlugin, GameLintRule, GameLintRuleName, GameLintScope, plugin as default, globToRegExp };
+export { GameLintContext, GameLintDefinition, GameLintLayoutOptions, GameLintListeners, GameLintNode, GameLintOptions, GameLintPlugin, GameLintRule, GameLintRuleName, GameLintScope, GameLintSuffixOptions, aliasTargetsOf, plugin as default, globToRegExp };