@moku-labs/game 0.4.5 → 0.5.0

package/dist/{types-Dy1xB68L.d.mts → types-BMEn0tSC.d.mts}

@@ -27,9 +27,21 @@ type Config$8 = {
   referenceLong: number;
 };
 /**
- * Global events. Empty: every event belongs to a plugin.
+ * Global events: the few that cross plugins with no `depends` edge. Every other event belongs to a
+ * plugin.
+ *
+ * @example
+ * ```ts
+ * // ui, after a dev save of features/board/effects.ts; effects hooks it with no depends on ui.
+ * ctx.emit("ui:hot-swap", { file: "features/board/effects.ts", module: { starsBurst } });
+ * ```
  */
-type Events$6 = Record<never, never>;
+type Events$6 = {
+  /** A dev hot swap was applied: the saved module's new exports. `ui` emits it, `effects` replaces its emitters on it. */"ui:hot-swap": {
+    file: string;
+    module: Readonly<Record<string, unknown>>;
+  };
+};
 /**
  * Public API type of a plugin instance, read from its phantom carrier.
  * Mirrors the kernel's non-exported `ExtractPluginApi`.
@@ -2141,6 +2153,11 @@ type Bookmark = {
   session: Json;
   rng: RngState;
   graph: string;
+  /**
+   * The scene mounted when the bookmark was taken. Written by the `game.bookmark` door, read by
+   * `game.restore`; `flow.restore` ignores it.
+   */
+  scene?: string;
 };
 /**
  * What `onEnter` callbacks learn about the node being entered.
@@ -3432,6 +3449,23 @@ type ProjectionApi = {
    * ```
    */
   register(spec: AnyProjectionSpec): void;
+  /**
+   * Swaps the stored spec of a registered projection. A mounted one has its layers checked against
+   * the current scene and runs the new `view` for every item on the next frame, directly. An
+   * unmounted one is only stored; its next `mount` uses it. Nothing changes when the call throws.
+   *
+   * @param spec - The new projection, under the name it was registered with.
+   * @throws {Error} When no projection of that name is registered, or when a mounted one names a
+   * `layer` or `lift` the scene does not declare.
+   * @example
+   * ```ts
+   * // The dev hot swap in `ui`: the saved `view.ts` exports a new `boardItems`.
+   * const world = ctx.require(worldPlugin);
+   * world.projection.replace(boardItems); // the next frame draws every item with the new view
+   * world.projection.replace(shopItems); // throws: Projection "shop.items" is not registered
+   * ```
+   */
+  replace(spec: AnyProjectionSpec): void;
   /**
    * Stores the layer list of the scene. The order of the list is draw order; every call stores a
    * new frozen array.
@@ -3696,9 +3730,10 @@ type ProjectionApi = {
    *
    * @example
    * ```ts
-   * // `i18n` switched the locale: every label has to be projected again.
+   * // The ui hot swap replaced the saved `hud` projection: every mounted view runs `view` again.
    * const world = ctx.require(worldPlugin);
-   * world.projection.rerunAll(); // the next frame writes the new strings with no motion
+   * world.projection.replace(hud);
+   * world.projection.rerunAll(); // the next frame draws the new view, with no motion
    * ```
    */
   rerunAll(): void;

package/dist/{types-VErbiEXy.d.mts → types-BaUUcIaN.d.mts}

@@ -1,4 +1,4 @@
-import { B as ComponentValue, D as Point$2, F as AnyComponentType, I as AnyComponentValue, It as Hint, Kt as Json, O as ViewportSize, P as AnyComponent, Pt as Descriptor, Rt as Api, V as Entity, Z as ChangeHook, at as ProjectionMotion, dn as Api$5, it as NumericFields, k as Api$2, lt as ViewHandle, m as Api$3, nt as Motion, o as Events$1, rt as MotionHandle, t as Api$4, ut as Api$1, vn as Require, z as ComponentType } from "./types-Dy1xB68L.mjs";
+import { B as ComponentValue, D as Point$2, F as AnyComponentType, I as AnyComponentValue, It as Hint, Kt as Json, O as ViewportSize, P as AnyComponent, Pt as Descriptor, Rt as Api, V as Entity, Z as ChangeHook, at as ProjectionMotion, dn as Api$5, it as NumericFields, k as Api$2, lt as ViewHandle, m as Api$3, nt as Motion, o as Events$1, rt as MotionHandle, t as Api$4, ut as Api$1, vn as Require, z as ComponentType } from "./types-BMEn0tSC.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -834,7 +834,7 @@ type State$1 = {
  * i18n plugin events.
  */
 type Events = {
-  /** The current locale changed and its messages are loaded. */"i18n:locale-changed": {
+  /** The current locale changed, or its messages were replaced. */"i18n:locale-changed": {
     locale: string;
   };
 };
@@ -960,6 +960,24 @@ type I18nApi = {
    * ```
    */
   locales(): readonly string[];
+  /**
+   * Swaps the compiled module of one feature in a loaded locale, for the dev hot swap. The one
+   * registered module whose keys overlap `messages` takes them, the locale is merged again and
+   * every key may warn once more. When the locale is the current one or the fallback,
+   * `i18n:locale-changed` is emitted with the current locale, so `text` re-resolves every label.
+   * A locale not loaded yet is left alone: its loader imports the new module later.
+   *
+   * @param locale - The locale of the saved `generated/strings.<locale>.ts`.
+   * @param messages - The `default` export of the new module.
+   * @throws {Error} When no registered module, or more than one, shares a key with `messages`.
+   * @example
+   * ```ts
+   * // ui's hot swap: generated/strings.ru.ts was written again with "hud.orders" as "3 заказа!".
+   * ctx.require(i18nPlugin).replace("ru", next.default); // emits i18n:locale-changed
+   * app.i18n.plain(tr("hud.orders", { n: 3 })); // "3 заказа!": text redraws the label
+   * ```
+   */
+  replace(locale: string, messages: CompiledMessages): void;
 };
 /**
  * What the kernel context offers this plugin.
@@ -1407,7 +1425,8 @@ type State = {
 };
 /**
  * text plugin API, `app.text`. Two questions: how big a piece of text is, and which styles the
- * game registered. Everything else happens in the frame.
+ * game registered; and one order, the dev hot swap of a styles file. Everything else happens in
+ * the frame.
  *
  * @example
  * ```ts
@@ -1464,6 +1483,26 @@ type TextApi = {
    * ```
    */
   styles(): readonly string[];
+  /**
+   * The dev hot swap of a styles file: writes every style of the map over the table. A known
+   * name keeps the feature that owns it, a new name is added and usable at once. The fonts the
+   * styles name are read, the measured layouts are dropped, and every label is laid out again
+   * on the next frame and redrawn with the new style, even when its text and its style name did
+   * not change. The game loop is woken for that frame.
+   *
+   * @param styles - What `defineTextStyles` returned in the saved module.
+   * @example
+   * ```ts
+   * // `ui` hot swaps a saved `hud/styles.ts`: the "hud.title" labels redraw at 64 px.
+   * const uiStyles = defineTextStyles({
+   *   "hud.title": { font: "ui.font-body", size: 64, fill: 0xff0000 }
+   * });
+   *
+   * ctx.require(textPlugin).replaceStyles(uiStyles);
+   * ctx.require(textPlugin).measure("12", "hud.title").height; // 76.8 on the 0.6 em fallback
+   * ```
+   */
+  replaceStyles(styles: TextStyles): void;
 };
 /**
  * Resolved dependency APIs.
@@ -2646,9 +2685,10 @@ type JsxState = {
 /**
  * One node of the snapshot `tree()` answers with. `rect` is natural: under a `fit` ancestor it
  * is the rect before that ancestor's scale. An element with `fit: "contain"` adds `fitScale`,
- * the scale it is drawn at. An `input` adds `value`: the text being typed while it is edited,
- * else the local field it writes. A windowed `scroll` adds `window`: the rows that exist, which
- * are the children of its content, and how many the list has.
+ * the scale it is drawn at. A `text` adds `content`: the words it draws. An `input` adds `value`:
+ * the text being typed while it is edited, else the local field it writes. A windowed `scroll`
+ * adds `window`: the rows that exist, which are the children of its content, and how many the
+ * list has.
  *
  * @example
  * ```ts
@@ -2673,6 +2713,19 @@ type UiNode = {
   state: IsFlags;
   local?: Record<string, unknown>;
   fitScale?: number;
+  /**
+   * The words a `text` draws, as one plain string: the string `text` resolved after `tr()` and
+   * `bind`, its tags and icons left out, else its `content` prop while that is a plain string.
+   * Absent on any other tag and on a text that draws nothing.
+   *
+   * @example
+   * ```ts
+   * // Home in Russian: `<text key="title" content={tr("home.title")} />` under the root row.
+   * const title = app.ui.tree().children.find(node => node.key === "title");
+   * title?.content; // "Лесной городок"
+   * ```
+   */
+  content?: string;
   value?: string;
   /**
    * The rows of a windowed scroll that exist and how many the list has.