@moku-labs/game 0.15.4 → 0.15.6

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
-import { Jn as FeaturePlugin, Sr as Json, Xn as AnyFlow, dr as NodeFx, gr as FakeClock, mr as ClockSource, nr as NodeTable, or as Descriptor, ur as Hint } from "./types-vjWgmPqS.mjs";
-import { t as createApp } from "./index-Cv5r0M9Y.mjs";
-import { b as saveOf, v as WithGameState, y as memory } from "./types-VNoG7shY.mjs";
-import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-oykCMFBV.mjs";
+import { Jn as FeaturePlugin, Sr as Json, Xn as AnyFlow, dr as NodeFx, gr as FakeClock, mr as ClockSource, nr as NodeTable, or as Descriptor, ur as Hint } from "./types-DnttyLeu.mjs";
+import { t as createApp } from "./index-DytzVJFz.mjs";
+import { b as saveOf, v as WithGameState, y as memory } from "./types-CRgEt4wq.mjs";
+import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-DDkRwLnJ.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/clock/fake.d.ts

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-import { an as exit, cn as type, in as refuseStart, m as flattenFeatures, t as createApp } from "./src-tkKl-oCn.mjs";
+import { an as exit, cn as type, in as refuseStart, m as flattenFeatures, t as createApp } from "./src-DWJabPi4.mjs";
 import { n as saveOf, t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-6mazmHK3.mjs";
 import { i as stepFrames, r as runRepro, t as createHeadless } from "./headless-BA6ffzqD.mjs";

package/dist/{types-CiTr21gu.d.mts → types-C2LZJIxH.d.mts}

@@ -1,5 +1,5 @@
-import { A as PixiSprite, An as TrackSegment, Hr as Api$1, Mn as Api$2, Nt as FilterCache, O as PixiFilter, On as ReducedMotion, Ot as FilterSlot, Qr as Require, Rr as Events$5, Sr as Json, T as Api$4, Tn as NumericFields, Zr as Events$2, Zt as Api$3, an as ComponentHandle, ar as TypeTag, in as AnyComponentValue, j as PixiTexture, jt as Point, k as PixiModule, kn as TrackOptions, kt as FilterSlotInputs, ln as Entity, nn as AnyComponent, or as Descriptor, s as Events$1, sn as ComponentType, t as Api$5, v as Events$4, wn as MotionHandle, xn as Ease, xr as Events$3, yr as Api$6 } from "./types-vjWgmPqS.mjs";
-import { I as I18nApi, J as StylesState, S as TextApi, c as UiNode, i as Finding, j as InputApi, n as ElementChange, o as JsxState, r as ElementMotion } from "./types-B6YgPkY8.mjs";
+import { A as PixiSprite, An as TrackSegment, Hr as Api$1, Mn as Api$2, Nt as FilterCache, O as PixiFilter, On as ReducedMotion, Ot as FilterSlot, Qr as Require, Rr as Events$5, Sr as Json, T as Api$4, Tn as NumericFields, Zr as Events$2, Zt as Api$3, an as ComponentHandle, ar as TypeTag, in as AnyComponentValue, j as PixiTexture, jt as Point, k as PixiModule, kn as TrackOptions, kt as FilterSlotInputs, ln as Entity, nn as AnyComponent, or as Descriptor, s as Events$1, sn as ComponentType, t as Api$5, v as Events$4, wn as MotionHandle, xn as Ease, xr as Events$3, yr as Api$6 } from "./types-DnttyLeu.mjs";
+import { I as I18nApi, J as StylesState, S as TextApi, c as UiNode, i as Finding, j as InputApi, n as ElementChange, o as JsxState, r as ElementMotion } from "./types-CWSMo70I.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 import { Node, Yoga } from "yoga-layout/load";
@@ -1408,6 +1408,13 @@ type FilterSpec<Uniforms extends Record<string, UniformDeclaration>> = {
    * only when the value changed.
    */
   readonly area?: (value: Readonly<FilterValueOf<Uniforms>>) => FilterArea | undefined;
+  /**
+   * The texels per CSS px the view and its filters are drawn at under this filter, from 0 to 4; `0` (the default) for
+   * the resolution of the canvas. Pixi draws all the filters of a view at the smallest resolution among them, so a
+   * resolution below the canvas's lowers the others on the same view too. A stage of an input ignores it: its step's
+   * `scale` sizes it.
+   */
+  readonly resolution?: number;
 };
 /**
  * How one uniform travels to the GPU: its name, its WGSL type and the form it was declared in.
@@ -1452,7 +1459,8 @@ type FilterDefinition = {
    * `undefined` for any other body.
    */
   readonly origin: UniformSpec | undefined; /** The rectangle outside of which the filter draws nothing, from the value; present only when the spec gave one. */
-  readonly area?: (value: Readonly<FilterFields>) => FilterArea | undefined;
+  readonly area?: (value: Readonly<FilterFields>) => FilterArea | undefined; /** The texels per CSS px it draws at; 0 for the resolution of the canvas. */
+  readonly resolution: number;
 };
 /**
  * A filter a chain may draw: any component `defineFilter` made. Listed in an input's `stages` and named by its steps.
@@ -1685,15 +1693,22 @@ type DisplacementValue = {
   order: number;
 };
 /**
- * `Alpha`: Pixi's alpha over the whole subtree, as one layer.
+ * `Alpha`: Pixi's alpha over the whole subtree, as one layer. `resolution` is the texels per CSS px the subtree is drawn
+ * at, at most 4, `0` for the resolution of the canvas; Pixi draws all the filters of a view at the smallest resolution
+ * among them, so `Alpha({ resolution: 0.5 })` beside a `Glow` draws the glow at 0.5 too. At `alpha: 1` and
+ * `resolution: 0` the filter would copy the subtree unchanged through a pass of its own: it is switched off, at once
+ * when it is built so, otherwise after 8 frames at rest there (a keyframe that touches 1 switches nothing), and the
+ * subtree draws as if the Alpha were not there.
  *
  * @example
  * ```ts
- * const value: AlphaValue = { alpha: 0.5, enabled: true, order: 0 };
+ * // The fog of a memory screen, opaque, drawn at half a texel per CSS px through the Alpha's one pass.
+ * const value: AlphaValue = { alpha: 1, resolution: 0.5, enabled: true, order: 0 };
  * ```
  */
 type AlphaValue = {
   alpha: number;
+  resolution: number;
   enabled: boolean;
   order: number;
 };
@@ -1789,6 +1804,11 @@ type FilterBody = {
   readonly applied: Record<string, FilterField>; /** The keys of `applied`, listed once: a compare walks them by index, with no `Object.keys` per frame. */
   readonly fields: readonly string[];
   passes: number;
+  /**
+   * Syncs in a row its value drew the view unchanged (at 1, at the canvas's resolution) while its filter was on;
+   * the filter is switched off at `CALM_AFTER` and the count starts over.
+   */
+  calm: number;
 };
 /**
  * A probe of the warm-up (spec 27 F4): the Pixi filter handed to `renderer.sync.filters.warm`, and its teardown.

package/dist/{types-VNoG7shY.d.mts → types-CRgEt4wq.d.mts}

@@ -1,7 +1,7 @@
-import { At as Orientation, Dr as PlayerStateProvider, E as Config$2, Jn as FeaturePlugin, Mr as SnapshotOf, Or as ProviderCall, Pn as Config$1, Sr as Json, Xn as AnyFlow, a as Config$3, ar as TypeTag, br as Config, d as Manifest, gr as FakeClock, k as PixiModule, kr as SaveDoc, mr as ClockSource, n as AssetsIo } from "./types-vjWgmPqS.mjs";
-import { o as AudioContextLike, s as Config$4 } from "./types-CiTr21gu.mjs";
-import { H as TextKey, I as I18nApi, V as StringTable } from "./types-B6YgPkY8.mjs";
-import { ft as platformPlugin, i as screen, mt as PlatformProvider, t as createApp, wt as audioPlugin, xt as effectsPlugin } from "./index-Cv5r0M9Y.mjs";
+import { At as Orientation, Dr as PlayerStateProvider, E as Config$2, Jn as FeaturePlugin, Mr as SnapshotOf, Or as ProviderCall, Pn as Config$1, Sr as Json, Xn as AnyFlow, a as Config$3, ar as TypeTag, br as Config, d as Manifest, gr as FakeClock, k as PixiModule, kr as SaveDoc, mr as ClockSource, n as AssetsIo } from "./types-DnttyLeu.mjs";
+import { o as AudioContextLike, s as Config$4 } from "./types-C2LZJIxH.mjs";
+import { H as TextKey, I as I18nApi, V as StringTable } from "./types-CWSMo70I.mjs";
+import { ft as platformPlugin, i as screen, mt as PlatformProvider, t as createApp, wt as audioPlugin, xt as effectsPlugin } from "./index-DytzVJFz.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/model/store/providers/memory.d.ts

package/dist/{types-B6YgPkY8.d.mts → types-CWSMo70I.d.mts}

@@ -1,4 +1,4 @@
-import { Cn as MotionCause, En as ProjectionMotion, Hr as Api, Jt as TransformValue, Mn as Api$1, Mt as ViewportSize, Qr as Require, Sn as Motion, Sr as Json, T as Api$3, Tn as NumericFields, Zt as Api$2, fr as Answer, in as AnyComponentValue, jn as ViewHandle, ln as Entity, nn as AnyComponent, or as Descriptor, pr as Api$5, rn as AnyComponentType, s as Events$1, sn as ComponentType, t as Api$4, ur as Hint, vn as TagType, wn as MotionHandle, yn as ChangeHook } from "./types-vjWgmPqS.mjs";
+import { Cn as MotionCause, En as ProjectionMotion, Hr as Api, Jt as TransformValue, Mn as Api$1, Mt as ViewportSize, Qr as Require, Sn as Motion, Sr as Json, T as Api$3, Tn as NumericFields, Zt as Api$2, fr as Answer, in as AnyComponentValue, jn as ViewHandle, ln as Entity, nn as AnyComponent, or as Descriptor, pr as Api$5, rn as AnyComponentType, s as Events$1, sn as ComponentType, t as Api$4, ur as Hint, vn as TagType, wn as MotionHandle, yn as ChangeHook } from "./types-DnttyLeu.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -1694,12 +1694,23 @@ type State = {
   cache: Map<string, TextLayout>; /** What every live label container was last filled from, by container. */
   drawn: WeakMap<object, DrawnLabel>; /** Entities to re-resolve in the next layout phase. */
   dirty: Set<Entity>;
+  /**
+   * The labels whose `Text` came while the world was live since the layout system last ran. The
+   * flush of phase `layout` brings the ones `ui` adds in its solve, and they are resolved right
+   * after it.
+   */
+  added: Entity[];
+  /**
+   * The labels the step after the last layout flush resolved. The next system run writes their
+   * `Text` once more, so `ui` measures the string they show.
+   */
+  rewrite: Entity[];
   /**
    * Counts the dev hot swaps that replaced a font or an inline icon of a live label. A label
    * container drawn under an older count is built again on its next update.
    */
   generation: number; /** Warning keys already written, so a style, a tag, a glyph or a font warns once. */
-  warned: Set<string>; /** The system, the two world hooks and the display adapter. */
+  warned: Set<string>; /** The system, the step after the layout flush, the two world hooks and the display adapter. */
   removers: Array<() => void>;
 };
 /**

package/dist/{types-DY_wOvUF.d.mts → types-DFoxDq-g.d.mts}

@@ -1,5 +1,5 @@
-import { Sr as Json, jr as Snapshot } from "./types-vjWgmPqS.mjs";
-import { t as HeadlessApp } from "./headless-oykCMFBV.mjs";
+import { Sr as Json, jr as Snapshot } from "./types-DnttyLeu.mjs";
+import { t as HeadlessApp } from "./headless-DDkRwLnJ.mjs";
 import { Log } from "@moku-labs/common/browser";
 
 //#region src/plugins/flow/doors/types.d.ts

package/dist/{types-vjWgmPqS.d.mts → types-DnttyLeu.d.mts}

@@ -4299,8 +4299,8 @@ type View$1 = {
   cause: MotionCause;
 };
 /**
- * One mounted projection: its owner, the live views by key, the despawn queue and the items of
- * the last reconcile.
+ * One mounted projection: its owner, the live views by key, the despawn queue, the items of the
+ * last reconcile, its place in the list of its scene and the layer list of that scene.
  *
  * @example
  * ```ts
@@ -4309,7 +4309,8 @@ type View$1 = {
  *   live: new Map(),
  *   queue: [],
  *   items: new Map(),
- *   order: -1
+ *   order: -1,
+ *   layers: Object.freeze([{ name: "items", sort: "y" }])
  * };
  * ```
  */
@@ -4323,6 +4324,11 @@ type Mounted = {
    * minus the length of that list (the roots of one scene take −n … −1, in list order).
    */
   order: number;
+  /**
+   * The layer list (`setLayers`) of the scene the projection was mounted into or kept by last, compared by
+   * identity: a `mount` under the same list is a second mount of one scene, a `mount` under a new one keeps it.
+   */
+  layers: ReadonlyArray<LayerSpec>;
 };
 /**
  * One track the projection started on the driver. The world keeps the component name and the
@@ -4496,17 +4502,30 @@ type ProjectionApi = {
   layers(): ReadonlyArray<LayerSpec>;
   /**
    * Marks projections mounted under an owner and reconciles them at once, direct: a scene brings
-   * its own transition. Nothing is mounted when the call throws.
+   * its own transition. A screen root draws at the `Order` of its place in the list, −n … −1. A
+   * projection a scene before mounted (under another layer list, `setLayers`) stays mounted when
+   * the new list declares its `layer` and `lift` alike: its views keep their entities and their
+   * motions, no hook runs, and its screen roots take the `Order` of their place in this list. One
+   * whose layer the new list declares otherwise is unmounted and mounted again. One mounted under
+   * the current layer list already is a second mount of one scene: it warns
+   * `world:already-mounted` and changes nothing. Nothing is mounted when the call throws.
    *
    * @param names - Names of the projections to mount.
    * @param owner - Who owns the entities of these projections.
    * @throws {Error} For an unknown name, or a `layer` or `lift` the scene does not declare.
    * @example
    * ```ts
-   * // `scenes` mounts the projections of the board scene it just switched to.
+   * // `scenes` mounts the board scene it just switched to: its HUD screen is listed last, at -1.
    * const world = ctx.require(worldPlugin);
-   * world.projection.mount(["board.cells", "board.items"], { kind: "plugin", name: "scenes" });
+   * world.projection.mount(["board.items", "hud"], { kind: "plugin", name: "scenes" });
    * world.projection.entityOf("board.items", "i7"); // 1048576, the picture is already there
+   *
+   * // The shop lists the HUD too and declares `ui` alike: the shop's layers, the board's items
+   * // out, the shop's list in.
+   * world.projection.setLayers([{ name: "ui", sort: "order" }]);
+   * world.projection.unmount(["board.items"]);
+   * world.projection.mount(["hud", "shop.shelf"], { kind: "plugin", name: "scenes" });
+   * world.ecs.get(world.projection.entityOf("hud", "hud") ?? 0, Order)?.value; // -2: the same entity, first of two
    * ```
    */
   mount(names: readonly string[], owner: Owner): void;

package/dist/{visual-B8ve4Qll.d.mts → visual-gTuXlmvH.d.mts}

@@ -1,9 +1,9 @@
-import { Ir as Api$3, T as Api, Zt as Api$1, yr as Api$2 } from "./types-vjWgmPqS.mjs";
-import { P as AnimApi, r as UiApi } from "./types-CiTr21gu.mjs";
-import { j as InputApi } from "./types-B6YgPkY8.mjs";
-import { r as Repro } from "./headless-oykCMFBV.mjs";
-import { a as InputOf, r as ControlApp } from "./types-DY_wOvUF.mjs";
-import { t as commands } from "./commands-CvWBaoEi.mjs";
+import { Ir as Api$3, T as Api, Zt as Api$1, yr as Api$2 } from "./types-DnttyLeu.mjs";
+import { P as AnimApi, r as UiApi } from "./types-C2LZJIxH.mjs";
+import { j as InputApi } from "./types-CWSMo70I.mjs";
+import { r as Repro } from "./headless-DDkRwLnJ.mjs";
+import { a as InputOf, r as ControlApp } from "./types-DFoxDq-g.mjs";
+import { t as commands } from "./commands-CAEwtEAy.mjs";
 
 //#region src/visual/types.d.ts
 /** The base commands of the `/control` door, keyed by their short names. */

package/dist/visual.d.mts

@@ -1,2 +1,2 @@
-import { a as VisualApp, c as VisualRenderer, d as VisualStart, f as VisualStep, h as VisualTolerance, i as CheckpointResult, l as VisualReport, m as VisualTestResult, n as runVisualTests, o as VisualOptions, p as VisualTest, r as defineVisualTest, s as VisualPage, t as parseVisualArgv, u as VisualSetup } from "./visual-B8ve4Qll.mjs";
+import { a as VisualApp, c as VisualRenderer, d as VisualStart, f as VisualStep, h as VisualTolerance, i as CheckpointResult, l as VisualReport, m as VisualTestResult, n as runVisualTests, o as VisualOptions, p as VisualTest, r as defineVisualTest, s as VisualPage, t as parseVisualArgv, u as VisualSetup } from "./visual-gTuXlmvH.mjs";
 export { type CheckpointResult, type VisualApp, type VisualOptions, type VisualPage, type VisualRenderer, type VisualReport, type VisualSetup, type VisualStart, type VisualStep, type VisualTest, type VisualTestResult, type VisualTolerance, defineVisualTest, parseVisualArgv, runVisualTests };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/game",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "description": "2D puzzle game engine on TypeScript and PixiJS, built on @moku-labs/core.",
   "type": "module",
   "sideEffects": [