@moku-labs/game 0.0.2 → 0.1.0

package/dist/define-CjP_4H0G.d.mts

@@ -0,0 +1,51 @@
+import { c as Source, d as HeadlessApp, n as Command, o as InputSchema } from "./types-DmhTHRVW.mjs";
+
+//#region src/plugins/flow/doors/define.d.ts
+/**
+ * Declares a source: a read-only view the editor lists, reads and watches. The types flow from
+ * the object: the input from `input`, the app from the `read` parameter, the output from its
+ * result.
+ *
+ * @param source - The descriptor.
+ * @returns The same descriptor, frozen.
+ * @throws {Error} When the id is not a dotted name such as `"game.position"`.
+ * @example
+ * ```ts
+ * // A game's .dev module: the orders on the board, re-read after every edge.
+ * export const orders = defineSource({
+ *   id: "timber.orders",
+ *   title: "Orders",
+ *   input: {},
+ *   changes: "edge",
+ *   read: app => app.flow.state().path
+ * });
+ * read(app, orders); // "board/awaitIntent"
+ * ```
+ */
+declare function defineSource<S extends InputSchema, O, App = HeadlessApp>(source: Source<S, O, App>): Source<S, O, App>;
+/**
+ * Declares a command: a dev-only action the editor lists and runs. Its body starts with the
+ * inline dev guard, so a production build drops it.
+ *
+ * @param command - The descriptor.
+ * @returns The same descriptor, frozen.
+ * @throws {Error} When the id is not a dotted name such as `"game.answer"`.
+ * @example
+ * ```ts
+ * // A game's .dev module: open the shop from anywhere, through the graph.
+ * export const openShop = defineCommand({
+ *   id: "timber.openShop",
+ *   title: "Open the shop",
+ *   input: {},
+ *   effect: "route",
+ *   run: app => {
+ *     if (typeof __MOKU_GAME_DEV__ === "undefined" || !__MOKU_GAME_DEV__) throw controlRefused();
+ *     return app.flow.walk([{ at: "home", intent: "shop" }]);
+ *   }
+ * });
+ * (await run(app, openShop)).state.path; // "shop"
+ * ```
+ */
+declare function defineCommand<S extends InputSchema, O, App = HeadlessApp>(command: Command<S, O, App>): Command<S, O, App>;
+//#endregion
+export { defineSource as n, defineCommand as t };

package/dist/{registry-DlpRCibU.mjs → dev-CcwFrwok.mjs}

@@ -381,4 +381,33 @@ function graphHash(graph) {
 	return hashText(stableJson(graph));
 }
 //#endregion
-export { graphHash as a, pushEntry as c, framePath as i, describeGraph as n, slotNames as o, findNode as r, compact as s, collectFlows as t };
+//#region src/plugins/flow/doors/dev.ts
+/**
+* Reads the dev flag at call time. Undefined means off: production is the default.
+*
+* @returns True only when `__MOKU_GAME_DEV__` is exactly `true`.
+* @example
+* ```ts
+* // The dev page set the flag in web/dev.ts before the engine started.
+* globalThis.__MOKU_GAME_DEV__ = true;
+* isDev(); // true
+* ```
+*/
+function isDev() {
+	return typeof __MOKU_GAME_DEV__ !== "undefined" && __MOKU_GAME_DEV__ === true;
+}
+/**
+* Builds the error a control command throws outside a dev build.
+*
+* @returns The error, ready to throw.
+* @example
+* ```ts
+* // A production build called a /control command.
+* controlRefused().message; // "[game] Control commands run in dev builds only.\n  Define __MOKU_GAME_DEV__ as true in the dev build."
+* ```
+*/
+function controlRefused() {
+	return /* @__PURE__ */ new Error("[game] Control commands run in dev builds only.\n  Define __MOKU_GAME_DEV__ as true in the dev build.");
+}
+//#endregion
+export { findNode as a, slotNames as c, describeGraph as i, compact as l, isDev as n, framePath as o, collectFlows as r, graphHash as s, controlRefused as t, pushEntry as u };