@moku-labs/game 0.15.11 → 0.15.12

package/dist/app/page.mjs

@@ -1,7 +1,7 @@
 import { r as systemSource, t as memory } from "../memory-CWlqhS7l.mjs";
 import { t as applyTo } from "../drafts-BawpSaVp.mjs";
 import { i as isControl } from "../dev-BNndV-hU.mjs";
-import { n as read, r as watch, t as sources } from "../sources-CJgUypyC.mjs";
+import { n as read, r as watch, t as sources } from "../sources-Fbq_PFVH.mjs";
 import { t as resolveConfig } from "../config-B87aFTW-.mjs";
 //#region src/app/save.ts
 /**

package/dist/app.mjs

@@ -1,4 +1,4 @@
-import { Bt as audioPlugin, J as platformPlugin, i as screen, kt as effectsPlugin, m as flattenFeatures, t as createApp } from "./src-0m2mjRDI.mjs";
+import { Nt as audioPlugin, St as effectsPlugin, V as platformPlugin, i as screen, m as flattenFeatures, t as createApp } from "./src-FIcYaXro.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { n as isFakeClock, t as fakeClock } from "./fake-6mazmHK3.mjs";
 //#region src/app/define.ts

package/dist/component-DGg5DqKK.mjs

@@ -0,0 +1,44 @@
+//#region src/plugins/ui/jsx/component.ts
+/** The local state a component that declares none starts every instance with. */
+const noLocal = {};
+/**
+* Tells a component definition from a plain function component, which JSX calls at build time.
+*
+* @param type - What stood in the tag position.
+* @returns True when `defineComponent` built it.
+* @example
+* ```ts
+* isComponentDefinition(() => ({ type: "row", props: {}, children: [] })); // false
+* ```
+*/
+function isComponentDefinition(type) {
+	return typeof type === "function" && type.isUiComponent === true;
+}
+/**
+* The one implementation behind the two overloads.
+*
+* @param name - Component name.
+* @param spec - What the game declared.
+* @returns The callable definition.
+*/
+function defineComponent(name, spec) {
+	const local = spec.local ?? noLocal;
+	const call = (props) => ({
+		type: name,
+		props,
+		children: []
+	});
+	const definition = Object.assign(call, {
+		outcomes: spec.outcomes,
+		local,
+		view: spec.view,
+		isUiComponent: true
+	});
+	Object.defineProperty(definition, "name", {
+		value: name,
+		configurable: true
+	});
+	return definition;
+}
+//#endregion
+export { isComponentDefinition as n, defineComponent as t };

package/dist/{flatten-BkXuscAV.mjs → flatten-nUX9PpGo.mjs}

@@ -1,46 +1,3 @@
-//#region src/plugins/ui/jsx/component.ts
-/** The local state a component that declares none starts every instance with. */
-const noLocal = {};
-/**
-* Tells a component definition from a plain function component, which JSX calls at build time.
-*
-* @param type - What stood in the tag position.
-* @returns True when `defineComponent` built it.
-* @example
-* ```ts
-* isComponentDefinition(() => ({ type: "row", props: {}, children: [] })); // false
-* ```
-*/
-function isComponentDefinition(type) {
-	return typeof type === "function" && type.isUiComponent === true;
-}
-/**
-* The one implementation behind the two overloads.
-*
-* @param name - Component name.
-* @param spec - What the game declared.
-* @returns The callable definition.
-*/
-function defineComponent(name, spec) {
-	const local = spec.local ?? noLocal;
-	const call = (props) => ({
-		type: name,
-		props,
-		children: []
-	});
-	const definition = Object.assign(call, {
-		outcomes: spec.outcomes,
-		local,
-		view: spec.view,
-		isUiComponent: true
-	});
-	Object.defineProperty(definition, "name", {
-		value: name,
-		configurable: true
-	});
-	return definition;
-}
-//#endregion
 //#region src/plugins/ui/jsx/flatten.ts
 /** The type of the node `Fragment` builds. It never reaches a reconcile: `flatten` lifts it. */
 const FRAGMENT = "#fragment";
@@ -97,4 +54,4 @@ function flatten(child) {
 	return [child];
 }
 //#endregion
-export { isComponentDefinition as i, flatten as n, defineComponent as r, FRAGMENT as t };
+export { flatten as n, FRAGMENT as t };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as haptic, $t as PERF_LOG_VERSION, A as types_exports$6, At as Emitter, B as Box, Bt as audioPlugin, C as types_exports$13, Ct as Touchable, D as types_exports$9, Dt as messageArgument, E as types_exports$10, Et as i18nPlugin, F as types_exports$1, Ft as Glow, G as defineTokens, Gt as Animation, H as LocalWrite, Ht as assetsPlugin, I as types_exports, It as Noise, J as platformPlugin, Jt as PASS_KINDS, K as defineStyle, Kt as Frames, L as uiPlugin, Lt as Outline, M as types_exports$4, Mt as Blur, N as types_exports$3, Nt as ColorMatrix, O as types_exports$8, Ot as messageDuration, P as types_exports$2, Pt as Displacement, Q as frames, Qt as PERF_GAP_BUCKETS, R as resolve, Rt as defineFilter, S as types_exports$14, St as Tappable, T as types_exports$11, Tt as Traced, U as ScrollState, Ut as animPlugin, V as DebugTrigger, Vt as scenesPlugin, W as popup, Wt as AnimPlayer, X as defineAnimation, Xt as MONITOR_SECTIONS, Y as HAPTIC_KINDS, Yt as frameAt, Z as external, Zt as PERF_CAUSES, _ as defineBundles, _t as Pointer, a as cubicBezier, at as sfx, b as types_exports$16, bt as Pressed, c as hint, cn as to, ct as stagger, d as defineScene, dn as SaveUnreadableError, dt as wait, en as PROBLEM_RULES, et as mark, f as tr, fn as lifecyclePlugin, ft as inputPlugin, g as music, gt as Hovered, h as defineEmitter, ht as Held, i as screen, in as flowPlugin, it as set, j as types_exports$5, jt as Alpha, k as types_exports$7, kt as effectsPlugin, l as schedule, ln as type, lt as tween, m as flattenFeatures, mn as clockPlugin, mt as DropTarget, n as createPlugin, nn as DEMAND_REASONS, nt as play, o as defineEffect, on as exit, ot as spawn, p as defineFeature, pn as timePlugin, pt as Draggable, q as textPlugin, qt as rendererPlugin, r as defineGame, rn as worldPlugin, rt as sequence, s as guide, sn as slot, st as spawned, t as createApp, tn as SHADER_WHATS, tt as parallel, u as projection, un as modelPlugin, ut as use, v as load, vt as PointerOver, w as types_exports$12, wt as Traceable, x as types_exports$15, xt as Swipeable, y as types_exports$17, yt as Pressable, z as defineMotion, zt as debugPlugin } from "./src-0m2mjRDI.mjs";
-import { A as Now, C as Sprite, D as sprite, F as resource, I as system, M as Tree, N as component, O as Exiting, P as mut, R as tag, S as Shape, _ as HudPart, c as Countdown, f as defineTextStyles, g as Display, j as Order, k as Layer, l as Text, p as label, u as bind, v as NineSlice, w as Transform, x as Parent, y as Overlay } from "./visual-Dwfy9wDb.mjs";
-import { r as defineComponent } from "./flatten-BkXuscAV.mjs";
+import { $ as spawn, $t as exit, A as types_exports$6, At as Outline, B as textPlugin, Bt as rendererPlugin, C as types_exports$13, Ct as Emitter, D as types_exports$9, Dt as Displacement, E as types_exports$10, Et as ColorMatrix, F as types_exports$1, Ft as assetsPlugin, G as frames, Gt as PERF_GAP_BUCKETS, H as HAPTIC_KINDS, Ht as frameAt, I as types_exports, It as animPlugin, J as parallel, Jt as SHADER_WHATS, K as haptic, Kt as PERF_LOG_VERSION, L as uiPlugin, Lt as AnimPlayer, M as types_exports$4, Mt as debugPlugin, N as types_exports$3, Nt as audioPlugin, O as types_exports$8, Ot as Glow, P as types_exports$2, Pt as scenesPlugin, Q as sfx, R as resolve, Rt as Animation, S as types_exports$14, St as effectsPlugin, T as types_exports$11, Tt as Blur, U as defineAnimation, Ut as MONITOR_SECTIONS, V as platformPlugin, Vt as PASS_KINDS, W as external, Wt as PERF_CAUSES, X as sequence, Xt as worldPlugin, Y as play, Yt as DEMAND_REASONS, Z as set, Zt as flowPlugin, _ as defineBundles, _t as Traceable, a as cubicBezier, an as lifecyclePlugin, at as inputPlugin, b as types_exports$16, bt as messageArgument, c as hint, ct as Held, d as defineScene, dt as PointerOver, en as slot, et as spawned, f as tr, ft as Pressable, g as music, gt as Touchable, h as defineEmitter, ht as Tappable, i as screen, in as SaveUnreadableError, it as wait, j as types_exports$5, jt as defineFilter, k as types_exports$7, kt as Noise, l as schedule, lt as Hovered, m as flattenFeatures, mt as Swipeable, n as createPlugin, nn as type, nt as tween, o as defineEffect, on as timePlugin, ot as Draggable, p as defineFeature, pt as Pressed, q as mark, qt as PROBLEM_RULES, r as defineGame, rn as modelPlugin, rt as use, s as guide, sn as clockPlugin, st as DropTarget, t as createApp, tn as to, tt as stagger, u as projection, ut as Pointer, v as load, vt as Traced, w as types_exports$12, wt as Alpha, x as types_exports$15, xt as messageDuration, y as types_exports$17, yt as i18nPlugin, z as defineMotion, zt as Frames } from "./src-FIcYaXro.mjs";
+import { $ as component, H as Shape, I as Display, J as Exiting, L as HudPart, Q as Tree, R as NineSlice, S as bind, T as label, U as Sprite, V as Parent, W as Transform, X as Now, Y as Layer, Z as Order, b as Countdown, d as LocalWrite, et as mut, g as popup, it as tag, l as DebugTrigger, nt as system, p as ScrollState, q as sprite, s as Box, tt as resource, v as defineTokens, w as defineTextStyles, x as Text, y as defineStyle, z as Overlay } from "./visual-CbGKzlj0.mjs";
+import { t as defineComponent } from "./component-DGg5DqKK.mjs";
 export { Alpha, types_exports as Anim, AnimPlayer, Animation, types_exports$1 as Assets, types_exports$2 as Audio, Blur, Box, types_exports$3 as Clock, ColorMatrix, Countdown, DEMAND_REASONS, types_exports$4 as Debug, DebugTrigger, Displacement, Display, Draggable, DropTarget, types_exports$5 as Effects, Emitter, Exiting, types_exports$6 as Flow, Frames, Glow, HAPTIC_KINDS, Held, Hovered, HudPart, types_exports$7 as I18n, types_exports$8 as Input, Layer, types_exports$9 as Lifecycle, LocalWrite, MONITOR_SECTIONS, types_exports$10 as Model, NineSlice, Noise, Now, Order, Outline, Overlay, PASS_KINDS, PERF_CAUSES, PERF_GAP_BUCKETS, PERF_LOG_VERSION, PROBLEM_RULES, Parent, types_exports$11 as Platform, Pointer, PointerOver, Pressable, Pressed, types_exports$12 as Renderer, SHADER_WHATS, SaveUnreadableError, types_exports$13 as Scenes, ScrollState, Shape, Sprite, Swipeable, Tappable, Text, types_exports$14 as TextTypes, types_exports$15 as Time, Touchable, Traceable, Traced, Transform, Tree, types_exports$16 as Ui, types_exports$17 as World, animPlugin, assetsPlugin, audioPlugin, bind, clockPlugin, component, createApp, createPlugin, cubicBezier, debugPlugin, defineAnimation, defineBundles, defineComponent, defineEffect, defineEmitter, defineFeature, defineFilter, defineGame, defineMotion, defineScene, defineStyle, defineTextStyles, defineTokens, effectsPlugin, exit, external, flattenFeatures, flowPlugin, frameAt, frames, guide, haptic, hint, i18nPlugin, inputPlugin, label, lifecyclePlugin, load, mark, messageArgument, messageDuration, modelPlugin, music, mut, parallel, platformPlugin, play, popup, projection, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/inspect.d.mts

@@ -86,7 +86,6 @@ declare const sources: Readonly<{
   } | undefined, HeadlessApp & {
     readonly ui: UiApi;
     readonly renderer: Api$2;
-  } & {
     readonly world: Api$1;
   }>;
   render: Source<{}, RenderStats, HeadlessApp & {

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
 import { c as defineSource } from "./session-CeKgO2hy.mjs";
-import { n as read, r as watch, t as sources } from "./sources-CJgUypyC.mjs";
+import { n as read, r as watch, t as sources } from "./sources-Fbq_PFVH.mjs";
 import "./inspect-la_KkjCS.mjs";
 export { defineSource, read, sources, watch };

package/dist/jsx-dev-runtime.mjs

@@ -1,2 +1,2 @@
-import { i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./runtime-CBZgWgzx.mjs";
+import { i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./runtime-DnM9i73o.mjs";
 export { Fragment, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.mjs

@@ -1,2 +1,2 @@
-import { i as jsxs, n as jsx, t as Fragment } from "./runtime-CBZgWgzx.mjs";
+import { i as jsxs, n as jsx, t as Fragment } from "./runtime-DnM9i73o.mjs";
 export { Fragment, jsx, jsxs };

package/dist/{runtime-CBZgWgzx.mjs → runtime-DnM9i73o.mjs}

@@ -1,4 +1,5 @@
-import { i as isComponentDefinition, n as flatten, t as FRAGMENT } from "./flatten-BkXuscAV.mjs";
+import { n as isComponentDefinition } from "./component-DGg5DqKK.mjs";
+import { n as flatten, t as FRAGMENT } from "./flatten-nUX9PpGo.mjs";
 //#region src/plugins/ui/jsx/runtime.ts
 /**
 * @file ui/jsx — the JSX runtime itself: the three factories a TypeScript build calls, the

package/dist/{sources-CJgUypyC.mjs → sources-Fbq_PFVH.mjs}

@@ -1,4 +1,4 @@
-import { a as scaleByFits, k as Layer } from "./visual-Dwfy9wDb.mjs";
+import { F as rootPoseOf, H as Shape, R as NineSlice, Y as Layer, j as parentOf, n as drawnRect, s as Box } from "./visual-CbGKzlj0.mjs";
 import { o as notInstalled } from "./dev-BNndV-hU.mjs";
 import { a as readTarget, c as defineSource, n as isTainted, o as inputOrEmpty, t as cheatsOf } from "./session-CeKgO2hy.mjs";
 //#region src/plugins/flow/doors/read.ts
@@ -304,36 +304,80 @@ const atSource = defineSource({
 * @file ui plugin — the ui sources of the `/inspect` door: the live screen as data, and where an
 * element or a view is on the page. Production-safe: every one only reads.
 */
+/** How deep a parent chain is followed for clips; deeper is treated as a loop. */
+const MAX_DEPTH = 32;
+/**
+* Where a box of an entity's own space lands in root space: `0, 0, w, h` through its root pose,
+* which composes every `Transform` up its `Parent` chain (a scroll's offset, a fit, a slot, a
+* motion). The rotation is left out, as the guide does.
+*
+* @param ecs - The world read.
+* @param entity - The entity.
+* @param w - The width of the box in the entity's own units.
+* @param h - The height of the box.
+* @returns The rect in root coordinates.
+*/
+function rootBoxOf(ecs, entity, w, h) {
+	return drawnRect(rootPoseOf(ecs, entity), {
+		x: 0,
+		y: 0,
+		w,
+		h
+	});
+}
 /**
-* Finds a keyed node and the nodes above it.
+* The box an entity clips its children to, the way the renderer masks them: the `width × height`
+* of a clipping `NineSlice`, the `w × h` of a clipping `Shape`, in root coordinates.
 *
-* @param node - Where the search starts.
-* @param key - The key of the element.
-* @returns The node and its ancestors, nearest first, or `undefined` when no node has the key.
+* @param ecs - The world read.
+* @param entity - The entity.
+* @returns The clip in root coordinates, or `undefined` when the entity clips nothing.
 */
-function chainTo(node, key) {
-	if (node.key === key) return [node];
-	for (const child of node.children) {
-		const chain = chainTo(child, key);
-		if (chain !== void 0) {
-			chain.push(node);
-			return chain;
-		}
-	}
+function clipOf(ecs, entity) {
+	const panel = ecs.get(entity, NineSlice);
+	if (panel?.clip === true) return rootBoxOf(ecs, entity, panel.width, panel.height);
+	const shape = ecs.get(entity, Shape);
+	return shape?.clip === true ? rootBoxOf(ecs, entity, shape.w, shape.h) : void 0;
 }
 /**
-* Where an element is drawn at rest, in root coordinates. Its rect in the snapshot is natural,
-* so every fitted node on the way up, the element itself included, scales it about its centre,
-* the way ui draws a `fit: "contain"`.
-*
-* @param chain - The element and its ancestors, nearest first.
-* @returns The drawn rect.
-*/
-function drawnRect(chain) {
-	return scaleByFits(chain[0].rect, chain.map((node) => ({
-		rect: node.rect,
-		fit: node.fitScale ?? 1
-	})));
+* The part of a rect inside another.
+*
+* @param rect - The rect to cut.
+* @param clip - The rect it is cut to.
+* @returns The overlap, or `undefined` when they do not overlap.
+*/
+function intersect(rect, clip) {
+	const x = Math.max(rect.x, clip.x);
+	const y = Math.max(rect.y, clip.y);
+	const right = Math.min(rect.x + rect.w, clip.x + clip.w);
+	const bottom = Math.min(rect.y + rect.h, clip.y + clip.h);
+	return right > x && bottom > y ? {
+		x,
+		y,
+		w: right - x,
+		h: bottom - y
+	} : void 0;
+}
+/**
+* Where an element is drawn, in root coordinates: its `Box` size through its root pose, cut by
+* every clipping entity above it (a `scroll`, an `overflow: "hidden"`), as the renderer masks it.
+* Its own clip masks only its children, so it never cuts the element itself.
+*
+* @param ecs - The world read.
+* @param entity - The element's entity.
+* @returns The drawn rect, or `undefined` when no part of it shows: cut away by a clip, or drawn
+*   at no size (an element entering from scale 0), as `renderer.sync.boundsOf` answers a view.
+*/
+function drawnRectOf(ecs, entity) {
+	const box = ecs.get(entity, Box);
+	if (box === void 0) return void 0;
+	const own = rootBoxOf(ecs, entity, box.w, box.h);
+	let drawn = own.w > 0 && own.h > 0 ? own : void 0;
+	for (let above = parentOf(ecs, entity), depth = 0; above !== 0 && drawn !== void 0 && depth < MAX_DEPTH; above = parentOf(ecs, above), depth += 1) {
+		const clip = clipOf(ecs, above);
+		if (clip !== void 0) drawn = intersect(drawn, clip);
+	}
+	return drawn;
 }
 /**
 * Maps a rect in reference units to CSS px of the page through both of its corners.
@@ -359,16 +403,19 @@ function onPage(renderer, rect) {
 	};
 }
 /**
-* Where a live ui element is on the page: its layout box, scaled by every fitted element above
-* it, through the viewport.
+* Where a live ui element is on the page: where it is drawn (its layout box through its root pose,
+* so a scroll's offset, a fit and a slot move it), cut by every clipping element above it,
+* through the viewport.
 *
-* @param app - The app with ui and renderer.
+* @param app - The app with ui, renderer and world.
 * @param key - The `key` prop of the element.
-* @returns The rect in CSS px, or `undefined` when no live element has the key.
+* @returns The rect in CSS px, or `undefined` when no live element has the key or a clip above
+*   hides all of it.
 */
 function locateKey(app, key) {
-	const chain = app.ui.find(key) !== void 0 ? chainTo(app.ui.tree(), key) : void 0;
-	return chain === void 0 ? void 0 : onPage(app.renderer, drawnRect(chain));
+	const entity = app.ui.find(key);
+	const drawn = entity === void 0 ? void 0 : drawnRectOf(app.world.ecs, entity);
+	return drawn === void 0 ? void 0 : onPage(app.renderer, drawn);
 }
 /**
 * Where a view is on the page: the box the renderer draws for the entity of its projection key,
@@ -408,9 +455,9 @@ const uiSource = defineSource({
 });
 /**
 * Where something is on the page, in CSS px, by either of the two addresses the doors use: a ui
-* element by its `key` (its layout box, scaled by every fitted element above it, so a bare button
-* with no fill has one), or a view by its `target` projection key (the box the renderer draws for
-* it). Both go through the viewport, so the numbers are what Playwright clicks. In reference units
+* element by its `key` (its layout box through its drawn pose, so a scroll's offset and a fit move
+* it and a bare button with no fill has one, cut by every clip above it), or a view by its `target`
+* projection key (the box the renderer draws for it). Both go through the viewport, so the numbers are what Playwright clicks. In reference units
 * while the renderer is inert; a view has no drawn box then.
 *
 * @example

package/dist/{src-0m2mjRDI.mjs → src-FIcYaXro.mjs}

@@ -2,9 +2,10 @@ import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
 import { r as systemSource, t as memory } from "./memory-CWlqhS7l.mjs";
 import { a as finishDrafts, i as enableDraftPatches, n as deepFreeze$1, o as openDrafts, r as dropDrafts } from "./drafts-BawpSaVp.mjs";
 import { d as graphHash, f as isRestCheckpoint, h as pushEntry, i as servePaused, l as findNode, m as compact, n as captureFrame, o as collectFlows, p as slotNames, r as serveCaptures, s as describeGraph, t as cancelCaptures, u as framePath } from "./capture-D7XvoHdH.mjs";
-import { A as Now, C as Sprite, E as componentsFor, F as resource, I as system, L as systemsFor, M as Tree, N as component, O as Exiting, R as tag, S as Shape, T as arcDefaults, _ as HudPart, b as OverlayLevel, c as Countdown, d as builtInStyles, g as Display, h as textFor, i as samePose, j as Order, k as Layer, l as Text, m as readStyle, n as drawnRect, o as visualOf$1, r as fitScaleOf, s as visualRectOf, t as CONTENT$1, v as NineSlice, w as Transform, x as Parent, y as Overlay } from "./visual-Dwfy9wDb.mjs";
+import { $ as component, A as localPoseOf, B as OverlayLevel, C as builtInStyles, D as textFor, E as readStyle, F as rootPoseOf, G as arcDefaults, H as Shape, I as Display, J as Exiting, K as componentsFor, L as HudPart, M as poseUnder, N as rootPointOf, O as applyPose, P as rootPoseInto, Q as Tree, R as NineSlice, U as Sprite, V as Parent, W as Transform, X as Now, Y as Layer, Z as Order, _ as uiFor, a as visualOf$1, b as Countdown, c as Covered, d as LocalWrite, f as Scroll, h as UiCounters, i as samePose, it as tag, j as parentOf$1, k as isLeaving, l as DebugTrigger, m as UI_OWNER, n as drawnRect, nt as system, o as visualRectOf, p as ScrollState, r as fitScaleOf, rt as systemsFor, s as Box, t as CONTENT$1, tt as resource, u as Escapable, x as Text, z as Overlay } from "./visual-CbGKzlj0.mjs";
 import { a as isDev } from "./dev-BNndV-hU.mjs";
-import { i as isComponentDefinition, n as flatten, r as defineComponent } from "./flatten-BkXuscAV.mjs";
+import { n as isComponentDefinition } from "./component-DGg5DqKK.mjs";
+import { n as flatten } from "./flatten-nUX9PpGo.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common/browser";
 import { createCoreConfig } from "@moku-labs/core";
 /**
@@ -24379,250 +24380,6 @@ function destroyPools(state) {
 	state.pooled = 0;
 }
 //#endregion
-//#region src/plugins/renderer/sync/pose.ts
-/**
-* @file renderer/sync — the pose helpers: where an entity really is, in root (reference) space,
-* and the local pose that puts it there under a parent. Pure component math over `world.ecs.get`,
-* the same math the renderer draws with: `position` is where the `pivot` lands, and the pivot is
-* the local point the view turns and scales around.
-*
-* Engine-internal, not a root export. `input`, `anim` and `ui` import `rootPoseOf` and
-* `localPoseOf` from this module path (`../renderer/sync/pose`) and never walk the `Parent` chain
-* themselves; a per-frame reader (`effects`' following emitters) writes the root pose into its own
-* object with `rootPoseInto`, which allocates nothing; `input` places a carried view under the last pose of a despawned held view with
-* `poseUnder`; `sync` places a box with `rootPointOf`. `input` places the drop lookup of an aimed
-* view with `applyPose`.
-*/
-/** How deep a parent chain is followed; deeper is treated as a loop. */
-const MAX_DEPTH$6 = 32;
-/**
-* The parent an entity moves with.
-*
-* @param ecs - The world read.
-* @param entity - The entity.
-* @returns The parent entity, or `0` when it has none or names itself.
-*/
-function parentOf$1(ecs, entity) {
-	const parent = ecs.get(entity, Parent)?.entity ?? 0;
-	return parent === entity ? 0 : parent;
-}
-/**
-* Tells whether an entity is on its way out: it or an ancestor of its `Parent` chain carries `Exiting` (a ui element
-* whose exit plays, a world view in its exit queue). Its despawn is coming; nothing else of the teardown is owed.
-*
-* @param ecs - The world read.
-* @param entity - The entity.
-* @returns True while it, or what it hangs under, leaves.
-*/
-function isLeaving(ecs, entity) {
-	let current = entity;
-	for (let depth = 0; depth < MAX_DEPTH$6 && current !== 0; depth += 1) {
-		if (ecs.has(current, Exiting)) return true;
-		current = parentOf$1(ecs, current);
-	}
-	return false;
-}
-/**
-* A fresh copy of a pose, so a caller may change what it got without touching the world.
-*
-* @param pose - The pose to copy.
-* @returns The same numbers in new objects.
-* @example
-* ```ts
-* copyPose({ x: 1, y: 2, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }).pivot.x; // 0
-* ```
-*/
-function copyPose(pose) {
-	return {
-		x: pose.x,
-		y: pose.y,
-		rotation: pose.rotation,
-		scale: pose.scale,
-		pivot: {
-			x: pose.pivot.x,
-			y: pose.pivot.y
-		}
-	};
-}
-/**
-* Moves a point out of the local space of a pose, into the space the pose sits in.
-*
-* @param pose - The pose whose local space the point is in.
-* @param point - The local point.
-* @returns The point one space higher.
-* @example
-* ```ts
-* applyPose({ x: 10, y: 0, rotation: 0, scale: 2, pivot: { x: 5, y: 0 } }, { x: 5, y: 1 });
-* // { x: 10, y: 2 }
-* ```
-*/
-function applyPose(pose, point) {
-	const cos = Math.cos(pose.rotation);
-	const sin = Math.sin(pose.rotation);
-	const dx = point.x - pose.pivot.x;
-	const dy = point.y - pose.pivot.y;
-	return {
-		x: pose.x + pose.scale * (dx * cos - dy * sin),
-		y: pose.y + pose.scale * (dx * sin + dy * cos)
-	};
-}
-/**
-* Places a local pose under a parent pose: the pose in the space the parent sits in. The step
-* `rootPoseOf` takes once per parent: the position through the parent's pivot, rotation, scale
-* and position, the rotations added and the scales multiplied.
-*
-* @param above - The parent pose.
-* @param local - The pose under it.
-* @returns The composed pose; it keeps the local pivot.
-* @example
-* ```ts
-* poseUnder(
-*   { x: 400, y: 300, rotation: 0, scale: 2, pivot: { x: 0, y: 0 } },
-*   { x: 0, y: 30, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }
-* ); // { x: 400, y: 360, rotation: 0, scale: 2, pivot: { x: 0, y: 0 } }
-* ```
-*/
-function poseUnder(above, local) {
-	const landed = applyPose(above, local);
-	return {
-		x: landed.x,
-		y: landed.y,
-		rotation: local.rotation + above.rotation,
-		scale: local.scale * above.scale,
-		pivot: {
-			x: local.pivot.x,
-			y: local.pivot.y
-		}
-	};
-}
-/**
-* Where an entity really is, written into the caller's pose: its `Transform` composed through the `Parent` chain,
-* every pivot on the way applied, the numbers of `rootPoseOf` (the same steps in the same order). The answer keeps the
-* entity's own pivot. Allocates nothing: a reader that asks every frame passes the same object.
-*
-* @param ecs - The world read, `world.ecs`.
-* @param entity - The entity to place.
-* @param out - The pose to write, its `pivot` object included; it may be `own`.
-* @param own - A pose to use in place of the entity's own `Transform`, such as its rest pose.
-* @returns `out`, in root space. An entity without a `Transform` sits at the identity pose.
-* @example
-* ```ts
-* // `effects` follows a host every frame: the slot sits at (40, 60) scaled 0.5, the host at (100, 200) inside it.
-* const pose = { x: 0, y: 0, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } };
-* rootPoseInto(ctx.require(worldPlugin).ecs, host, pose);
-* // pose is { x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 } }
-* ```
-*/
-function rootPoseInto(ecs, entity, out, own) {
-	const start = own ?? ecs.get(entity, Transform) ?? Transform.defaults;
-	out.x = start.x;
-	out.y = start.y;
-	out.rotation = start.rotation;
-	out.scale = start.scale;
-	out.pivot.x = start.pivot.x;
-	out.pivot.y = start.pivot.y;
-	let current = entity;
-	for (let depth = 0; depth < MAX_DEPTH$6; depth += 1) {
-		const parent = parentOf$1(ecs, current);
-		if (parent === 0) break;
-		const above = ecs.get(parent, Transform) ?? Transform.defaults;
-		const cos = Math.cos(above.rotation);
-		const sin = Math.sin(above.rotation);
-		const dx = out.x - above.pivot.x;
-		const dy = out.y - above.pivot.y;
-		out.x = above.x + above.scale * (dx * cos - dy * sin);
-		out.y = above.y + above.scale * (dx * sin + dy * cos);
-		out.rotation = out.rotation + above.rotation;
-		out.scale = out.scale * above.scale;
-		current = parent;
-	}
-	return out;
-}
-/**
-* Where an entity really is: its `Transform` composed through the `Parent` chain, every pivot on
-* the way applied. The answer keeps the entity's own pivot, so it can be written straight into the
-* `Transform` of an entity without a parent and the view does not move.
-*
-* @param ecs - The world read, `world.ecs`.
-* @param entity - The entity to place.
-* @param own - A pose to use in place of the entity's own `Transform`, such as its rest pose.
-* @returns The pose in root space, a fresh object. An entity without a `Transform` sits at the identity pose.
-* @example
-* ```ts
-* // `input` lifts a board cell out of its slot: the slot sits at (40, 60) scaled 0.5,
-* // the cell at (100, 200) inside it.
-* rootPoseOf(ctx.require(worldPlugin).ecs, cell);
-* // { x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 } }
-* ```
-*/
-function rootPoseOf(ecs, entity, own) {
-	return rootPoseInto(ecs, entity, {
-		x: 0,
-		y: 0,
-		rotation: 0,
-		scale: 1,
-		pivot: {
-			x: 0,
-			y: 0
-		}
-	}, own);
-}
-/**
-* The inverse of `rootPoseOf`: the local pose under `parent` that puts an entity at a root pose.
-* The pivot is kept, as it is a local point of the entity itself.
-*
-* @param ecs - The world read, `world.ecs`.
-* @param parent - The entity to hang under; `0` for none, which answers the root pose itself.
-* @param root - The pose in root space.
-* @returns The local pose. A parent collapsed to scale 0 counts as scale 1, so the answer stays
-*   finite.
-* @example
-* ```ts
-* // `input` drops the cell back into the slot at (40, 60) scaled 0.5, where the finger left it.
-* localPoseOf(ctx.require(worldPlugin).ecs, slot, {
-*   x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 }
-* });
-* // { x: 100, y: 200, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }
-* ```
-*/
-function localPoseOf(ecs, parent, root) {
-	if (parent === 0) return copyPose(root);
-	const above = rootPoseOf(ecs, parent);
-	const scale = above.scale === 0 ? 1 : above.scale;
-	const cos = Math.cos(-above.rotation);
-	const sin = Math.sin(-above.rotation);
-	const dx = root.x - above.x;
-	const dy = root.y - above.y;
-	return {
-		x: above.pivot.x + (dx * cos - dy * sin) / scale,
-		y: above.pivot.y + (dx * sin + dy * cos) / scale,
-		rotation: root.rotation - above.rotation,
-		scale: root.scale / scale,
-		pivot: {
-			x: root.pivot.x,
-			y: root.pivot.y
-		}
-	};
-}
-/**
-* Where a local point of an entity lands in root (reference) space: the point posed through the
-* entity's own `Transform` and its whole `Parent` chain, the forward walk of the hit test's
-* `localPoseOf`. The scale is the real one, so a view collapsed to scale 0 lands on one point.
-*
-* @param ecs - The world read, `world.ecs`.
-* @param entity - The entity whose local space the point is in.
-* @param point - The local point.
-* @returns The point in root space, a fresh object.
-* @example
-* ```ts
-* // The corner of a 64 x 64 cell at (100, 200) inside a slot at (40, 60) scaled 0.5.
-* rootPointOf(ctx.require(worldPlugin).ecs, cell, { x: -32, y: -32 }); // { x: 74, y: 144 }
-* ```
-*/
-function rootPointOf(ecs, entity, point) {
-	return applyPose(rootPoseOf(ecs, entity), point);
-}
-//#endregion
 //#region src/plugins/renderer/sync/layers.ts
 /**
 * @file renderer/sync — the layers. `scenes` declares them through `world.projection.setLayers`;
@@ -32186,13 +31943,14 @@ function localTargetOf(ecs, entity, component, to) {
 	const parent = parentOf$1(ecs, entity);
 	if (component !== asComponent(Transform) || parent === 0) return local;
 	const now = rootPoseOf(ecs, entity);
-	const landed = localPoseOf(ecs, parent, {
+	const root = {
 		x: to.x ?? now.x,
 		y: to.y ?? now.y,
 		rotation: to.rotation ?? now.rotation,
 		scale: to.scale ?? now.scale,
 		pivot: now.pivot
-	});
+	};
+	const landed = localPoseOf(ecs, parent, root);
 	for (const field of POSE_FIELDS) if (to[field] !== void 0) local[field] = landed[field];
 	return local;
 }
@@ -50454,204 +50212,6 @@ const textPlugin = /*#__PURE__*/ createPlugin$1("text", {
 	onStop: ({ state }) => stopText(state)
 });
 //#endregion
-//#region src/plugins/ui/styles/define.ts
-/**
-* Declares one style. The work is the type: a field outside the vocabulary, or a value outside
-* its union, is an error where the style is written, not where it is used.
-*
-* @param style - The style, with its `is` and `when` variants.
-* @returns The same object, frozen.
-* @example
-* ```ts
-* defineStyle({ direction: "row", gap: 12 }).gap; // 12
-* ```
-*/
-function defineStyle(style) {
-	return Object.freeze(style);
-}
-//#endregion
-//#region src/plugins/ui/styles/tokens.ts
-/**
-* Declares the design tokens of a game: spaces, colours, radii and font keys, flat and plain.
-*
-* @param tokens - The four groups; every key inside them is the game's own.
-* @returns The same object, frozen.
-* @example
-* ```ts
-* defineTokens({ space: { md: 16 } }).space.md; // 16
-* ```
-*/
-function defineTokens(tokens) {
-	return Object.freeze(tokens);
-}
-//#endregion
-//#region src/plugins/ui/components.ts
-/**
-* Who owns every entity `ui` spawns. The projection module checks it before it hands out a view
-* handle, so only `ui` may move a ui element.
-*/
-const UI_OWNER = {
-	kind: "plugin",
-	name: "ui"
-};
-/** Fresh defaults for the patch, so no two buttons share one object. */
-const localWriteDefaults = { patch: {} };
-/**
-* The rect of a ui element in root coordinates. Written by the solve, read by `tree()`, `lint()`
-* and the hit test of `guide`.
-*/
-const Box = /*#__PURE__*/ component("Box", {
-	x: 0,
-	y: 0,
-	w: 0,
-	h: 0
-});
-/**
-* On a button that writes local state instead of naming an intent. `input.onTap` reports the tap
-* and `ui` merges the patch into the nearest component instance.
-*/
-const LocalWrite = /*#__PURE__*/ component("LocalWrite", localWriteDefaults);
-/**
-* On a scroll container. Internal to `ui`: not exported from the package root.
-*/
-const Scroll = /*#__PURE__*/ component("Scroll", {
-	axis: "y",
-	offset: 0,
-	min: 0
-});
-/**
-* On every scroll container: where it stands and whether it moves, for a game system and the
-* read door. `ui` writes it in a frame where the offset or `max` changed, and once more with
-* `moving: false` when it stops; a game reads it and never writes it.
-*
-* @example
-* ```ts
-* // A board system dims the events of the order strip while it rests on the orders.
-* export const stripMist = system({
-*   name: "board.stripMist",
-*   phase: "animate",
-*   query: [ScrollState, OrderStrip],
-*   run: entities => {
-*     for (const [entity, scroll] of entities) {
-*       // scroll: { offset: 318, max: 390, moving: false }
-*     }
-*   }
-* });
-* ```
-*/
-const ScrollState = /*#__PURE__*/ component("ScrollState", {
-	offset: 0,
-	max: 0,
-	moving: false
-});
-/**
-* On the root entity of a popup kept beneath another popup (`popup(..., { over })`). Internal to
-* `ui`: not exported from the package root. Every element of that root resolves `is.covered`.
-*/
-const Covered = /*#__PURE__*/ tag("Covered");
-/**
-* On a button with the `escape` prop: the control the Escape key taps while its root is the top
-* one, meant for the close button or the backdrop of a dismissable popup. Internal to `ui`: the
-* game writes the prop, never the tag.
-*/
-const Escapable = /*#__PURE__*/ tag("Escapable");
-/**
-* On the view a player taps five times within three seconds to open the editor's overlay on a debug build: the
-* version line of the settings, usually. One helper on top of `app.debug.overlay.open()`; a game that wants another
-* gesture calls that itself. The view must take a press (a `button`, or any element with `Touchable`); a `button`
-* that names no intent is the plain choice. Without the agent flag the tag does nothing.
-*
-* @example
-* ```tsx
-* // The version line of the settings sheet. Five taps open the overlay of `moku-game build --debug` on the phone.
-* <button key="versionLine" style={versionLineStyle} components={[DebugTrigger()]}>
-*   <text key="version" style="settings.version" content={tr("settings.version", { version: "1.4.0" })} />
-* </button>
-* ```
-*/
-const DebugTrigger = /*#__PURE__*/ tag("DebugTrigger");
-/**
-* The three Yoga counters, the reconcile count of the frame, the range re-renders of the windowed
-* lists, and the style and write passes of the reconcile. Written by the two systems of `ui`, read
-* by the acceptance tests. Not part of `app.ui`.
-*/
-const UiCounters = /*#__PURE__*/ resource("UiCounters", {
-	solves: 0,
-	nodes: 0,
-	measured: 0,
-	reconciles: 0,
-	windowRenders: 0,
-	styled: 0,
-	written: 0
-});
-/**
-* Builds the effect a node awaits to show a popup. The gate opens for the outcomes of the
-* component, so the node resolves with the intent one of its buttons answered. `over` names the
-* component of a popup that stays mounted beneath this one, drawn covered, until this one is gone.
-*
-* @param component - A component declared with `outcomes`.
-* @param props - What its view is called with.
-* @param options - How the popup stands to the others.
-* @param options.over - The component name of the popup kept beneath this one.
-* @returns The descriptor `fx()` takes.
-* @example
-* ```ts
-* const Reward = defineComponent("Reward", {
-*   outcomes: { claim: {} },
-*   view: () => ({ type: "panel", props: {}, children: [] })
-* });
-* popup(Reward, { gold: 5 });
-* // { kind: "popup", payload: { component: "Reward", props: { gold: 5 } }, answers: ["claim"] }
-* await fx(popup(Reward, { gold: 5 })); // Answer<"claim">: { intent: "claim" }
-* ```
-* @example
-* ```ts
-* // The settings node asks before a reset; the settings stay beneath, covered.
-* const Confirm = defineComponent("Confirm", {
-*   outcomes: { reset: {}, cancel: {} },
-*   view: () => ({ type: "panel", props: {}, children: [] })
-* });
-* popup(Confirm, {}, { over: "Settings" });
-* // { kind: "popup", payload: { component: "Confirm", props: {}, over: "Settings" },
-* //   answers: ["reset", "cancel"] }
-* ```
-*/
-function popup(component, props, options) {
-	const over = options?.over;
-	return {
-		kind: "popup",
-		payload: over === void 0 ? {
-			component: component.name,
-			props
-		} : {
-			component: component.name,
-			props,
-			over
-		},
-		answers: Object.keys(component.outcomes)
-	};
-}
-/**
-* Binds the four ui helpers to one game. Type-only: the same four functions, plus the intrinsic
-* table this game's tags are checked against.
-*
-* @returns The helpers and the intrinsic type carrier.
-* @example
-* ```ts
-* const { defineStyle } = uiFor<"ui.coin", "digits", "hud.coins">();
-* defineStyle({ gap: 8 }).gap; // 8
-* ```
-*/
-function uiFor() {
-	return {
-		defineComponent,
-		defineStyle,
-		defineTokens,
-		popup,
-		intrinsics: {}
-	};
-}
-//#endregion
 //#region src/plugins/ui/jsx/field-layout.ts
 /**
 * The four edges of a resolved padding.
@@ -61349,4 +60909,4 @@ const screen = [
 	uiPlugin
 ];
 //#endregion
-export { haptic as $, PERF_LOG_VERSION as $t, types_exports$11 as A, Emitter as At, Box as B, audioPlugin as Bt, types_exports$4 as C, Touchable as Ct, types_exports$8 as D, messageArgument as Dt, types_exports$7 as E, i18nPlugin as Et, types_exports$16 as F, Glow as Ft, defineTokens as G, Animation as Gt, LocalWrite as H, assetsPlugin as Ht, types_exports$17 as I, Noise as It, platformPlugin as J, PASS_KINDS as Jt, defineStyle as K, Frames as Kt, uiPlugin as L, Outline as Lt, types_exports$13 as M, Blur as Mt, types_exports$14 as N, ColorMatrix as Nt, types_exports$9 as O, messageDuration as Ot, types_exports$15 as P, Displacement as Pt, frames as Q, PERF_GAP_BUCKETS as Qt, resolve as R, defineFilter as Rt, types_exports$3 as S, Tappable as St, types_exports$6 as T, Traced as Tt, ScrollState as U, animPlugin as Ut, DebugTrigger as V, scenesPlugin as Vt, popup as W, AnimPlayer as Wt, defineAnimation as X, MONITOR_SECTIONS as Xt, HAPTIC_KINDS as Y, frameAt as Yt, external as Z, PERF_CAUSES as Zt, defineBundles as _, Pointer as _t, cubicBezier as a, refuseStart as an, sfx as at, types_exports$1 as b, Pressed as bt, hint as c, to as cn, stagger as ct, defineScene as d, SaveUnreadableError as dn, wait as dt, PROBLEM_RULES as en, mark as et, tr as f, lifecyclePlugin as fn, inputPlugin as ft, music as g, Hovered as gt, defineEmitter as h, Held as ht, screen as i, flowPlugin as in, set as it, types_exports$12 as j, Alpha as jt, types_exports$10 as k, effectsPlugin as kt, schedule as l, type as ln, tween as lt, flattenFeatures as m, clockPlugin as mn, DropTarget as mt, createPlugin as n, DEMAND_REASONS as nn, play$1 as nt, defineEffect as o, exit as on, spawn as ot, defineFeature as p, timePlugin as pn, Draggable as pt, textPlugin as q, rendererPlugin as qt, defineGame as r, worldPlugin as rn, sequence as rt, guide as s, slot as sn, spawned as st, createApp as t, SHADER_WHATS as tn, parallel as tt, projection as u, modelPlugin as un, use as ut, load as v, PointerOver as vt, types_exports$5 as w, Traceable as wt, types_exports$2 as x, Swipeable as xt, types_exports as y, Pressable as yt, defineMotion as z, debugPlugin as zt };
+export { spawn as $, exit as $t, types_exports$11 as A, Outline as At, textPlugin as B, rendererPlugin as Bt, types_exports$4 as C, Emitter as Ct, types_exports$8 as D, Displacement as Dt, types_exports$7 as E, ColorMatrix as Et, types_exports$16 as F, assetsPlugin as Ft, frames as G, PERF_GAP_BUCKETS as Gt, HAPTIC_KINDS as H, frameAt as Ht, types_exports$17 as I, animPlugin as It, parallel as J, SHADER_WHATS as Jt, haptic as K, PERF_LOG_VERSION as Kt, uiPlugin as L, AnimPlayer as Lt, types_exports$13 as M, debugPlugin as Mt, types_exports$14 as N, audioPlugin as Nt, types_exports$9 as O, Glow as Ot, types_exports$15 as P, scenesPlugin as Pt, sfx as Q, refuseStart as Qt, resolve as R, Animation as Rt, types_exports$3 as S, effectsPlugin as St, types_exports$6 as T, Blur as Tt, defineAnimation as U, MONITOR_SECTIONS as Ut, platformPlugin as V, PASS_KINDS as Vt, external as W, PERF_CAUSES as Wt, sequence as X, worldPlugin as Xt, play$1 as Y, DEMAND_REASONS as Yt, set as Z, flowPlugin as Zt, defineBundles as _, Traceable as _t, cubicBezier as a, lifecyclePlugin as an, inputPlugin as at, types_exports$1 as b, messageArgument as bt, hint as c, Held as ct, defineScene as d, PointerOver as dt, slot as en, spawned as et, tr as f, Pressable as ft, music as g, Touchable as gt, defineEmitter as h, Tappable as ht, screen as i, SaveUnreadableError as in, wait as it, types_exports$12 as j, defineFilter as jt, types_exports$10 as k, Noise as kt, schedule as l, Hovered as lt, flattenFeatures as m, Swipeable as mt, createPlugin as n, type as nn, tween as nt, defineEffect as o, timePlugin as on, Draggable as ot, defineFeature as p, Pressed as pt, mark as q, PROBLEM_RULES as qt, defineGame as r, modelPlugin as rn, use as rt, guide as s, clockPlugin as sn, DropTarget as st, createApp as t, to as tn, stagger as tt, projection as u, Pointer as ut, load as v, Traced as vt, types_exports$5 as w, Alpha as wt, types_exports$2 as x, messageDuration as xt, types_exports as y, i18nPlugin as yt, defineMotion as z, Frames as zt };

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-import { an as refuseStart, ln as type, m as flattenFeatures, on as exit, t as createApp } from "./src-0m2mjRDI.mjs";
+import { $t as exit, Qt as refuseStart, m as flattenFeatures, nn as type, t as createApp } from "./src-FIcYaXro.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/{visual-Dwfy9wDb.mjs → visual-CbGKzlj0.mjs}

@@ -1,3 +1,4 @@
+import { t as defineComponent } from "./component-DGg5DqKK.mjs";
 //#region src/plugins/world/ecs/define.ts
 /**
 * Declares a component type. The defaults give the TypeScript type, the JSON shape and the
@@ -369,6 +370,250 @@ function componentsFor() {
 		HudPart
 	};
 }
+//#endregion
+//#region src/plugins/renderer/sync/pose.ts
+/**
+* @file renderer/sync — the pose helpers: where an entity really is, in root (reference) space,
+* and the local pose that puts it there under a parent. Pure component math over `world.ecs.get`,
+* the same math the renderer draws with: `position` is where the `pivot` lands, and the pivot is
+* the local point the view turns and scales around.
+*
+* Engine-internal, not a root export. `input`, `anim` and `ui` import `rootPoseOf` and
+* `localPoseOf` from this module path (`../renderer/sync/pose`) and never walk the `Parent` chain
+* themselves; a per-frame reader (`effects`' following emitters) writes the root pose into its own
+* object with `rootPoseInto`, which allocates nothing; `input` places a carried view under the last pose of a despawned held view with
+* `poseUnder`; `sync` places a box with `rootPointOf`. `input` places the drop lookup of an aimed
+* view with `applyPose`.
+*/
+/** How deep a parent chain is followed; deeper is treated as a loop. */
+const MAX_DEPTH = 32;
+/**
+* The parent an entity moves with.
+*
+* @param ecs - The world read.
+* @param entity - The entity.
+* @returns The parent entity, or `0` when it has none or names itself.
+*/
+function parentOf(ecs, entity) {
+	const parent = ecs.get(entity, Parent)?.entity ?? 0;
+	return parent === entity ? 0 : parent;
+}
+/**
+* Tells whether an entity is on its way out: it or an ancestor of its `Parent` chain carries `Exiting` (a ui element
+* whose exit plays, a world view in its exit queue). Its despawn is coming; nothing else of the teardown is owed.
+*
+* @param ecs - The world read.
+* @param entity - The entity.
+* @returns True while it, or what it hangs under, leaves.
+*/
+function isLeaving(ecs, entity) {
+	let current = entity;
+	for (let depth = 0; depth < MAX_DEPTH && current !== 0; depth += 1) {
+		if (ecs.has(current, Exiting)) return true;
+		current = parentOf(ecs, current);
+	}
+	return false;
+}
+/**
+* A fresh copy of a pose, so a caller may change what it got without touching the world.
+*
+* @param pose - The pose to copy.
+* @returns The same numbers in new objects.
+* @example
+* ```ts
+* copyPose({ x: 1, y: 2, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }).pivot.x; // 0
+* ```
+*/
+function copyPose(pose) {
+	return {
+		x: pose.x,
+		y: pose.y,
+		rotation: pose.rotation,
+		scale: pose.scale,
+		pivot: {
+			x: pose.pivot.x,
+			y: pose.pivot.y
+		}
+	};
+}
+/**
+* Moves a point out of the local space of a pose, into the space the pose sits in.
+*
+* @param pose - The pose whose local space the point is in.
+* @param point - The local point.
+* @returns The point one space higher.
+* @example
+* ```ts
+* applyPose({ x: 10, y: 0, rotation: 0, scale: 2, pivot: { x: 5, y: 0 } }, { x: 5, y: 1 });
+* // { x: 10, y: 2 }
+* ```
+*/
+function applyPose(pose, point) {
+	const cos = Math.cos(pose.rotation);
+	const sin = Math.sin(pose.rotation);
+	const dx = point.x - pose.pivot.x;
+	const dy = point.y - pose.pivot.y;
+	return {
+		x: pose.x + pose.scale * (dx * cos - dy * sin),
+		y: pose.y + pose.scale * (dx * sin + dy * cos)
+	};
+}
+/**
+* Places a local pose under a parent pose: the pose in the space the parent sits in. The step
+* `rootPoseOf` takes once per parent: the position through the parent's pivot, rotation, scale
+* and position, the rotations added and the scales multiplied.
+*
+* @param above - The parent pose.
+* @param local - The pose under it.
+* @returns The composed pose; it keeps the local pivot.
+* @example
+* ```ts
+* poseUnder(
+*   { x: 400, y: 300, rotation: 0, scale: 2, pivot: { x: 0, y: 0 } },
+*   { x: 0, y: 30, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }
+* ); // { x: 400, y: 360, rotation: 0, scale: 2, pivot: { x: 0, y: 0 } }
+* ```
+*/
+function poseUnder(above, local) {
+	const landed = applyPose(above, local);
+	return {
+		x: landed.x,
+		y: landed.y,
+		rotation: local.rotation + above.rotation,
+		scale: local.scale * above.scale,
+		pivot: {
+			x: local.pivot.x,
+			y: local.pivot.y
+		}
+	};
+}
+/**
+* Where an entity really is, written into the caller's pose: its `Transform` composed through the `Parent` chain,
+* every pivot on the way applied, the numbers of `rootPoseOf` (the same steps in the same order). The answer keeps the
+* entity's own pivot. Allocates nothing: a reader that asks every frame passes the same object.
+*
+* @param ecs - The world read, `world.ecs`.
+* @param entity - The entity to place.
+* @param out - The pose to write, its `pivot` object included; it may be `own`.
+* @param own - A pose to use in place of the entity's own `Transform`, such as its rest pose.
+* @returns `out`, in root space. An entity without a `Transform` sits at the identity pose.
+* @example
+* ```ts
+* // `effects` follows a host every frame: the slot sits at (40, 60) scaled 0.5, the host at (100, 200) inside it.
+* const pose = { x: 0, y: 0, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } };
+* rootPoseInto(ctx.require(worldPlugin).ecs, host, pose);
+* // pose is { x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 } }
+* ```
+*/
+function rootPoseInto(ecs, entity, out, own) {
+	const start = own ?? ecs.get(entity, Transform) ?? Transform.defaults;
+	out.x = start.x;
+	out.y = start.y;
+	out.rotation = start.rotation;
+	out.scale = start.scale;
+	out.pivot.x = start.pivot.x;
+	out.pivot.y = start.pivot.y;
+	let current = entity;
+	for (let depth = 0; depth < MAX_DEPTH; depth += 1) {
+		const parent = parentOf(ecs, current);
+		if (parent === 0) break;
+		const above = ecs.get(parent, Transform) ?? Transform.defaults;
+		const cos = Math.cos(above.rotation);
+		const sin = Math.sin(above.rotation);
+		const dx = out.x - above.pivot.x;
+		const dy = out.y - above.pivot.y;
+		out.x = above.x + above.scale * (dx * cos - dy * sin);
+		out.y = above.y + above.scale * (dx * sin + dy * cos);
+		out.rotation = out.rotation + above.rotation;
+		out.scale = out.scale * above.scale;
+		current = parent;
+	}
+	return out;
+}
+/**
+* Where an entity really is: its `Transform` composed through the `Parent` chain, every pivot on
+* the way applied. The answer keeps the entity's own pivot, so it can be written straight into the
+* `Transform` of an entity without a parent and the view does not move.
+*
+* @param ecs - The world read, `world.ecs`.
+* @param entity - The entity to place.
+* @param own - A pose to use in place of the entity's own `Transform`, such as its rest pose.
+* @returns The pose in root space, a fresh object. An entity without a `Transform` sits at the identity pose.
+* @example
+* ```ts
+* // `input` lifts a board cell out of its slot: the slot sits at (40, 60) scaled 0.5,
+* // the cell at (100, 200) inside it.
+* rootPoseOf(ctx.require(worldPlugin).ecs, cell);
+* // { x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 } }
+* ```
+*/
+function rootPoseOf(ecs, entity, own) {
+	return rootPoseInto(ecs, entity, {
+		x: 0,
+		y: 0,
+		rotation: 0,
+		scale: 1,
+		pivot: {
+			x: 0,
+			y: 0
+		}
+	}, own);
+}
+/**
+* The inverse of `rootPoseOf`: the local pose under `parent` that puts an entity at a root pose.
+* The pivot is kept, as it is a local point of the entity itself.
+*
+* @param ecs - The world read, `world.ecs`.
+* @param parent - The entity to hang under; `0` for none, which answers the root pose itself.
+* @param root - The pose in root space.
+* @returns The local pose. A parent collapsed to scale 0 counts as scale 1, so the answer stays
+*   finite.
+* @example
+* ```ts
+* // `input` drops the cell back into the slot at (40, 60) scaled 0.5, where the finger left it.
+* localPoseOf(ctx.require(worldPlugin).ecs, slot, {
+*   x: 90, y: 160, rotation: 0, scale: 0.5, pivot: { x: 0, y: 0 }
+* });
+* // { x: 100, y: 200, rotation: 0, scale: 1, pivot: { x: 0, y: 0 } }
+* ```
+*/
+function localPoseOf(ecs, parent, root) {
+	if (parent === 0) return copyPose(root);
+	const above = rootPoseOf(ecs, parent);
+	const scale = above.scale === 0 ? 1 : above.scale;
+	const cos = Math.cos(-above.rotation);
+	const sin = Math.sin(-above.rotation);
+	const dx = root.x - above.x;
+	const dy = root.y - above.y;
+	return {
+		x: above.pivot.x + (dx * cos - dy * sin) / scale,
+		y: above.pivot.y + (dx * sin + dy * cos) / scale,
+		rotation: root.rotation - above.rotation,
+		scale: root.scale / scale,
+		pivot: {
+			x: root.pivot.x,
+			y: root.pivot.y
+		}
+	};
+}
+/**
+* Where a local point of an entity lands in root (reference) space: the point posed through the
+* entity's own `Transform` and its whole `Parent` chain, the forward walk of the hit test's
+* `localPoseOf`. The scale is the real one, so a view collapsed to scale 0 lands on one point.
+*
+* @param ecs - The world read, `world.ecs`.
+* @param entity - The entity whose local space the point is in.
+* @param point - The local point.
+* @returns The point in root space, a fresh object.
+* @example
+* ```ts
+* // The corner of a 64 x 64 cell at (100, 200) inside a slot at (40, 60) scaled 0.5.
+* rootPointOf(ctx.require(worldPlugin).ecs, cell, { x: -32, y: -32 }); // { x: 74, y: 144 }
+* ```
+*/
+function rootPointOf(ecs, entity, point) {
+	return applyPose(rootPoseOf(ecs, entity), point);
+}
 /**
 * Words on the screen: a string or a message, the style it is drawn in, and the string `text`
 * resolved out of it. A game writes `content`, `style`, `bind`, `anchor` and `alpha`; `resolved`
@@ -666,6 +911,204 @@ function textFor() {
 	};
 }
 //#endregion
+//#region src/plugins/ui/styles/define.ts
+/**
+* Declares one style. The work is the type: a field outside the vocabulary, or a value outside
+* its union, is an error where the style is written, not where it is used.
+*
+* @param style - The style, with its `is` and `when` variants.
+* @returns The same object, frozen.
+* @example
+* ```ts
+* defineStyle({ direction: "row", gap: 12 }).gap; // 12
+* ```
+*/
+function defineStyle(style) {
+	return Object.freeze(style);
+}
+//#endregion
+//#region src/plugins/ui/styles/tokens.ts
+/**
+* Declares the design tokens of a game: spaces, colours, radii and font keys, flat and plain.
+*
+* @param tokens - The four groups; every key inside them is the game's own.
+* @returns The same object, frozen.
+* @example
+* ```ts
+* defineTokens({ space: { md: 16 } }).space.md; // 16
+* ```
+*/
+function defineTokens(tokens) {
+	return Object.freeze(tokens);
+}
+//#endregion
+//#region src/plugins/ui/components.ts
+/**
+* Who owns every entity `ui` spawns. The projection module checks it before it hands out a view
+* handle, so only `ui` may move a ui element.
+*/
+const UI_OWNER = {
+	kind: "plugin",
+	name: "ui"
+};
+/** Fresh defaults for the patch, so no two buttons share one object. */
+const localWriteDefaults = { patch: {} };
+/**
+* The rect of a ui element in root coordinates. Written by the solve, read by `tree()`, `lint()`
+* and the hit test of `guide`.
+*/
+const Box = /*#__PURE__*/ component("Box", {
+	x: 0,
+	y: 0,
+	w: 0,
+	h: 0
+});
+/**
+* On a button that writes local state instead of naming an intent. `input.onTap` reports the tap
+* and `ui` merges the patch into the nearest component instance.
+*/
+const LocalWrite = /*#__PURE__*/ component("LocalWrite", localWriteDefaults);
+/**
+* On a scroll container. Internal to `ui`: not exported from the package root.
+*/
+const Scroll = /*#__PURE__*/ component("Scroll", {
+	axis: "y",
+	offset: 0,
+	min: 0
+});
+/**
+* On every scroll container: where it stands and whether it moves, for a game system and the
+* read door. `ui` writes it in a frame where the offset or `max` changed, and once more with
+* `moving: false` when it stops; a game reads it and never writes it.
+*
+* @example
+* ```ts
+* // A board system dims the events of the order strip while it rests on the orders.
+* export const stripMist = system({
+*   name: "board.stripMist",
+*   phase: "animate",
+*   query: [ScrollState, OrderStrip],
+*   run: entities => {
+*     for (const [entity, scroll] of entities) {
+*       // scroll: { offset: 318, max: 390, moving: false }
+*     }
+*   }
+* });
+* ```
+*/
+const ScrollState = /*#__PURE__*/ component("ScrollState", {
+	offset: 0,
+	max: 0,
+	moving: false
+});
+/**
+* On the root entity of a popup kept beneath another popup (`popup(..., { over })`). Internal to
+* `ui`: not exported from the package root. Every element of that root resolves `is.covered`.
+*/
+const Covered = /*#__PURE__*/ tag("Covered");
+/**
+* On a button with the `escape` prop: the control the Escape key taps while its root is the top
+* one, meant for the close button or the backdrop of a dismissable popup. Internal to `ui`: the
+* game writes the prop, never the tag.
+*/
+const Escapable = /*#__PURE__*/ tag("Escapable");
+/**
+* On the view a player taps five times within three seconds to open the editor's overlay on a debug build: the
+* version line of the settings, usually. One helper on top of `app.debug.overlay.open()`; a game that wants another
+* gesture calls that itself. The view must take a press (a `button`, or any element with `Touchable`); a `button`
+* that names no intent is the plain choice. Without the agent flag the tag does nothing.
+*
+* @example
+* ```tsx
+* // The version line of the settings sheet. Five taps open the overlay of `moku-game build --debug` on the phone.
+* <button key="versionLine" style={versionLineStyle} components={[DebugTrigger()]}>
+*   <text key="version" style="settings.version" content={tr("settings.version", { version: "1.4.0" })} />
+* </button>
+* ```
+*/
+const DebugTrigger = /*#__PURE__*/ tag("DebugTrigger");
+/**
+* The three Yoga counters, the reconcile count of the frame, the range re-renders of the windowed
+* lists, and the style and write passes of the reconcile. Written by the two systems of `ui`, read
+* by the acceptance tests. Not part of `app.ui`.
+*/
+const UiCounters = /*#__PURE__*/ resource("UiCounters", {
+	solves: 0,
+	nodes: 0,
+	measured: 0,
+	reconciles: 0,
+	windowRenders: 0,
+	styled: 0,
+	written: 0
+});
+/**
+* Builds the effect a node awaits to show a popup. The gate opens for the outcomes of the
+* component, so the node resolves with the intent one of its buttons answered. `over` names the
+* component of a popup that stays mounted beneath this one, drawn covered, until this one is gone.
+*
+* @param component - A component declared with `outcomes`.
+* @param props - What its view is called with.
+* @param options - How the popup stands to the others.
+* @param options.over - The component name of the popup kept beneath this one.
+* @returns The descriptor `fx()` takes.
+* @example
+* ```ts
+* const Reward = defineComponent("Reward", {
+*   outcomes: { claim: {} },
+*   view: () => ({ type: "panel", props: {}, children: [] })
+* });
+* popup(Reward, { gold: 5 });
+* // { kind: "popup", payload: { component: "Reward", props: { gold: 5 } }, answers: ["claim"] }
+* await fx(popup(Reward, { gold: 5 })); // Answer<"claim">: { intent: "claim" }
+* ```
+* @example
+* ```ts
+* // The settings node asks before a reset; the settings stay beneath, covered.
+* const Confirm = defineComponent("Confirm", {
+*   outcomes: { reset: {}, cancel: {} },
+*   view: () => ({ type: "panel", props: {}, children: [] })
+* });
+* popup(Confirm, {}, { over: "Settings" });
+* // { kind: "popup", payload: { component: "Confirm", props: {}, over: "Settings" },
+* //   answers: ["reset", "cancel"] }
+* ```
+*/
+function popup(component, props, options) {
+	const over = options?.over;
+	return {
+		kind: "popup",
+		payload: over === void 0 ? {
+			component: component.name,
+			props
+		} : {
+			component: component.name,
+			props,
+			over
+		},
+		answers: Object.keys(component.outcomes)
+	};
+}
+/**
+* Binds the four ui helpers to one game. Type-only: the same four functions, plus the intrinsic
+* table this game's tags are checked against.
+*
+* @returns The helpers and the intrinsic type carrier.
+* @example
+* ```ts
+* const { defineStyle } = uiFor<"ui.coin", "digits", "hud.coins">();
+* defineStyle({ gap: 8 }).gap; // 8
+* ```
+*/
+function uiFor() {
+	return {
+		defineComponent,
+		defineStyle,
+		defineTokens,
+		popup,
+		intrinsics: {}
+	};
+}
+//#endregion
 //#region src/plugins/ui/visual.ts
 /**
 * @file ui plugin — the look of an element: the visual component it is drawn with, and where a
@@ -919,4 +1362,4 @@ function drawnRect(pose, local) {
 	};
 }
 //#endregion
-export { Now as A, Sprite as C, sprite as D, componentsFor as E, resource as F, system as I, systemsFor as L, Tree as M, component as N, Exiting as O, mut as P, tag as R, Shape as S, arcDefaults as T, HudPart as _, scaleByFits as a, OverlayLevel as b, Countdown as c, builtInStyles as d, defineTextStyles as f, Display as g, textFor as h, samePose as i, Order as j, Layer as k, Text as l, readStyle as m, drawnRect as n, visualOf as o, label as p, fitScaleOf as r, visualRectOf as s, CONTENT as t, bind as u, NineSlice as v, Transform as w, Parent as x, Overlay as y };
+export { component as $, localPoseOf as A, OverlayLevel as B, builtInStyles as C, textFor as D, readStyle as E, rootPoseOf as F, arcDefaults as G, Shape as H, Display as I, Exiting as J, componentsFor as K, HudPart as L, poseUnder as M, rootPointOf as N, applyPose as O, rootPoseInto as P, Tree as Q, NineSlice as R, bind as S, label as T, Sprite as U, Parent as V, Transform as W, Now as X, Layer as Y, Order as Z, uiFor as _, visualOf as a, Countdown as b, Covered as c, LocalWrite as d, mut as et, Scroll as f, popup as g, UiCounters as h, samePose as i, tag as it, parentOf as j, isLeaving as k, DebugTrigger as l, UI_OWNER as m, drawnRect as n, system as nt, visualRectOf as o, ScrollState as p, sprite as q, fitScaleOf as r, systemsFor as rt, Box as s, CONTENT as t, resource as tt, Escapable as u, defineTokens as v, defineTextStyles as w, Text as x, defineStyle as y, Overlay as z };

package/dist/visual.mjs

@@ -1,4 +1,4 @@
-import { n as read, t as sources } from "./sources-CJgUypyC.mjs";
+import { n as read, t as sources } from "./sources-Fbq_PFVH.mjs";
 import { n as commands, t as run } from "./run-BqYmcNo7.mjs";
 import path from "node:path";
 import { createBrandConsole } from "@moku-labs/common/cli";

package/package.json

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