@moku-labs/game 0.15.36 → 0.15.37

package/dist/app/page.d.mts

@@ -1,4 +1,4 @@
-import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-Dh2cyp0H.mjs";
+import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-B4G8sOED.mjs";
 
 //#region src/app/page.d.ts
 /**

package/dist/app/system.d.mts

@@ -1,6 +1,6 @@
-import { Mr as PlayerStateProvider } from "../types-K3qfyTu0.mjs";
-import { ht as PlatformProvider } from "../index-Cs4qaPMq.mjs";
-import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-Dh2cyp0H.mjs";
+import { Mr as PlayerStateProvider } from "../types-BCI9vUA6.mjs";
+import { ht as PlatformProvider } from "../index-BMpWPXvo.mjs";
+import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-B4G8sOED.mjs";
 import { Back, Haptics, KeepAwake, Lifecycle, Store } from "@moku-labs/system";
 
 //#region src/app/system.d.ts

package/dist/app.d.mts

@@ -1,6 +1,6 @@
-import { Dr as Json } from "./types-K3qfyTu0.mjs";
-import { U as StringTable } from "./types-BAv5qOZX.mjs";
-import { a as GameHandle, c as MemoryProvider, d as SaveKind, f as Scenario, g as SystemName, i as GameDefinition, l as PageAgent, n as GameApp, o as GamePluginConfigs, p as ScreenSeams, r as GameConfig, s as HeadlessSeams, v as WithGameState } from "./types-Dh2cyp0H.mjs";
+import { Dr as Json } from "./types-BCI9vUA6.mjs";
+import { U as StringTable } from "./types-k5szXqU1.mjs";
+import { a as GameHandle, c as MemoryProvider, d as SaveKind, f as Scenario, g as SystemName, i as GameDefinition, l as PageAgent, n as GameApp, o as GamePluginConfigs, p as ScreenSeams, r as GameConfig, s as HeadlessSeams, v as WithGameState } from "./types-B4G8sOED.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/app/define.d.ts

package/dist/app.mjs

@@ -1,4 +1,4 @@
-import { Ft as audioPlugin, H as platformPlugin, i as screen, m as flattenFeatures, t as createApp, wt as effectsPlugin } from "./src-BPEIEsWH.mjs";
+import { Ft as audioPlugin, H as platformPlugin, i as screen, m as flattenFeatures, t as createApp, wt as effectsPlugin } from "./src-ChniuNDc.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { n as fakeClock, r as isFakeClock } from "./fake-hnJcJeYf.mjs";
 //#region src/app/define.ts

package/dist/assets.d.mts

@@ -1,4 +1,4 @@
-import { d as Manifest } from "./types-K3qfyTu0.mjs";
+import { d as Manifest } from "./types-BCI9vUA6.mjs";
 
 //#region src/plugins/assets/scan/cli.d.ts
 /**

package/dist/{commands-BGrtxBga.d.mts → commands-BZPrVtJT.d.mts}

@@ -1,8 +1,8 @@
-import { $r as Time, D as DebugSwitches, Ir as Snapshot, Rr as StoreApi, Vr as Api, Y as Api$1, Yr as FrameRate, ar as FlowState, nn as Api$2, nr as Bookmark, ot as Captured, w as ScenesApi } from "./types-K3qfyTu0.mjs";
-import { P as AnimApi, a as AudioApi, h as EffectsApi, r as UiApi } from "./types-B1W2CPUu.mjs";
-import { N as InputApi } from "./types-BAv5qOZX.mjs";
-import { t as HeadlessApp } from "./headless-BFI7EXHo.mjs";
-import { n as Command, r as ControlApp } from "./types-D52biu5v.mjs";
+import { $r as Time, D as DebugSwitches, Ir as Snapshot, Rr as StoreApi, Vr as Api, Y as Api$1, Yr as FrameRate, ar as FlowState, nn as Api$2, nr as Bookmark, ot as Captured, w as ScenesApi } from "./types-BCI9vUA6.mjs";
+import { P as AnimApi, a as AudioApi, h as EffectsApi, r as UiApi } from "./types-BVSmbgJB.mjs";
+import { N as InputApi } from "./types-k5szXqU1.mjs";
+import { t as HeadlessApp } from "./headless-Bx3WG3fZ.mjs";
+import { n as Command, r as ControlApp } from "./types-B6fvpFoz.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**

package/dist/control.d.mts

@@ -1,7 +1,7 @@
-import { t as HeadlessApp } from "./headless-BFI7EXHo.mjs";
-import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-D52biu5v.mjs";
-import { t as commands } from "./commands-BGrtxBga.mjs";
-import { t as defineCommand } from "./define-0af8h-Ro.mjs";
+import { t as HeadlessApp } from "./headless-Bx3WG3fZ.mjs";
+import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-B6fvpFoz.mjs";
+import { t as commands } from "./commands-BZPrVtJT.mjs";
+import { t as defineCommand } from "./define-T-WIPEkg.mjs";
 
 //#region src/plugins/flow/doors/dev.d.ts
 /**

package/dist/{define-0af8h-Ro.d.mts → define-T-WIPEkg.d.mts}

@@ -1,5 +1,5 @@
-import { t as HeadlessApp } from "./headless-BFI7EXHo.mjs";
-import { c as Source, n as Command, o as InputSchema } from "./types-D52biu5v.mjs";
+import { t as HeadlessApp } from "./headless-Bx3WG3fZ.mjs";
+import { c as Source, n as Command, o as InputSchema } from "./types-B6fvpFoz.mjs";
 
 //#region src/plugins/flow/doors/define.d.ts
 /**

package/dist/{headless-BFI7EXHo.d.mts → headless-Bx3WG3fZ.d.mts}

@@ -1,4 +1,4 @@
-import { Br as RngState, Dr as Json, Ln as Api$1, _r as Answer, ar as FlowState, cr as RouteStep, or as JournalEntry, qr as Api } from "./types-K3qfyTu0.mjs";
+import { Br as RngState, Dr as Json, Ln as Api$1, _r as Answer, ar as FlowState, cr as RouteStep, or as JournalEntry, qr as Api } from "./types-BCI9vUA6.mjs";
 
 //#region src/plugins/flow/headless.d.ts
 /**

package/dist/{index-Cs4qaPMq.d.mts → index-BMpWPXvo.d.mts}

@@ -1,6 +1,6 @@
-import { $n as FeaturePlugin, An as NumericFields, B as ShapeValue, Bn as EmitterIdOf, C as SceneSpec, Cn as TagType, Dr as Json, Dt as PassKind, En as Ease, F as NineSliceValue, Gn as TextStylesOf, Gr as State$4, Hn as HudKeysOf, Hr as Config$4, Jr as Config$8, K as TransformValue, L as OverlayValue, Ln as Api$2, Mn as ProjectionSpec, N as HudPartValue, Nn as ReducedMotion, Or as Root, Qn as FeatureDescription, Qr as ThermalReading, Rn as BundlesOf, Rr as StoreApi, S as SceneDefinition, Sn as SystemFor, Sr as State$2, T as State$7, Tn as DescriptionNode, Tr as Config$5, U as SpriteOptions, Ur as Events, Vn as GameTypes, Vr as Api$3, W as SpriteValue, Wn as State$3, Wr as PauseReason, X as Config$6, Xr as RateChange, Y as Api$4, Zr as State$8, _ as AnySceneProjection, _n as Mut, _r as Answer, _t as FrameRing, a as Config$1, an as State$9, bn as ResourceType, br as Config$2, c as LoadBundles, dr as Descriptor, dt as ViewportSize, er as FeatureTree, f as ReadyBundles, fn as ComponentType, fr as Effect, gt as FrameRecord, hr as Hint, i as BundleSpec, jn as ProjectionMotion, jr as Patch, kr as State$5, l as LoadReason, lr as SceneIdOf, m as Tier, mr as GuideOptions, ni as Events$1, nn as Api$6, o as DefineBundles, p as State$1, pn as ComponentValue, pr as EffectOptions, q as sprite, qn as defineFlow, qr as Api$5, r as BundleMap, ri as Require, rn as Config$9, rr as DefineNode, rt as State$6, t as Api, ti as Config$10, u as LoadResult, un as ComponentHandle, v as Config$7, vn as Narrowed, vr as Api$1, w as ScenesApi, x as LayerMap, xn as SystemDefinition, y as DefineScene, yn as QueryTerm, zn as Config$3, zr as RngApi } from "./types-K3qfyTu0.mjs";
-import { A as GlowValue, B as Target, C as BlurValue, D as FilterComponent, F as AnimPlayerValue, H as HapticKind, I as Config$11, K as defineAnimation, L as FramesValue, M as OutlineValue, N as UniformDeclaration, O as FilterSpec, P as AnimApi, Q as play, R as MotionKeyframe, S as AlphaValue, T as DisplacementValue, U as SfxDescriptor, W as Step, _ as State$12, a as AudioApi, b as EmitterDefinition, c as MusicDescriptor, d as State$11, f as VolumesFor, h as EffectsApi, j as NoiseValue, k as FilterValueOf, l as MusicOptions, lt as OverlayApi, m as Config$13, n as State$13, r as UiApi, s as Config$12, t as Config$14, w as ColorMatrixValue, x as EmitterValue, y as EmitterConfig, z as State$10 } from "./types-B1W2CPUu.mjs";
-import { B as Message, C as State$16, D as TextStyleInput, G as TypedTr, H as State$14, I as Argument, J as ResolvedStyle, L as Config$15, M as Config$16, N as InputApi, O as TextStyles, P as State$15, R as I18nApi, S as Point, T as TextBind, V as Part, W as TextKey, Y as Style, Z as WhenFlags, b as Config$17, g as IntrinsicElementsFor, h as defineTokens, j as defineComponent, k as TextValue, q as IsFlags, s as PopupComponent, v as BindField, w as TextApi, x as CountdownValue, y as BindOptions, z as IntlKit } from "./types-BAv5qOZX.mjs";
+import { $n as FeaturePlugin, An as NumericFields, B as ShapeValue, Bn as EmitterIdOf, C as SceneSpec, Cn as TagType, Dr as Json, Dt as PassKind, En as Ease, F as NineSliceValue, Gn as TextStylesOf, Gr as State$4, Hn as HudKeysOf, Hr as Config$4, Jr as Config$8, K as TransformValue, L as OverlayValue, Ln as Api$2, Mn as ProjectionSpec, N as HudPartValue, Nn as ReducedMotion, Or as Root, Qn as FeatureDescription, Qr as ThermalReading, Rn as BundlesOf, Rr as StoreApi, S as SceneDefinition, Sn as SystemFor, Sr as State$2, T as State$7, Tn as DescriptionNode, Tr as Config$5, U as SpriteOptions, Ur as Events, Vn as GameTypes, Vr as Api$3, W as SpriteValue, Wn as State$3, Wr as PauseReason, X as Config$6, Xr as RateChange, Y as Api$4, Zr as State$8, _ as AnySceneProjection, _n as Mut, _r as Answer, _t as FrameRing, a as Config$1, an as State$9, bn as ResourceType, br as Config$2, c as LoadBundles, dr as Descriptor, dt as ViewportSize, er as FeatureTree, f as ReadyBundles, fn as ComponentType, fr as Effect, gt as FrameRecord, hr as Hint, i as BundleSpec, jn as ProjectionMotion, jr as Patch, kr as State$5, l as LoadReason, lr as SceneIdOf, m as Tier, mr as GuideOptions, ni as Events$1, nn as Api$6, o as DefineBundles, p as State$1, pn as ComponentValue, pr as EffectOptions, q as sprite, qn as defineFlow, qr as Api$5, r as BundleMap, ri as Require, rn as Config$9, rr as DefineNode, rt as State$6, t as Api, ti as Config$10, u as LoadResult, un as ComponentHandle, v as Config$7, vn as Narrowed, vr as Api$1, w as ScenesApi, x as LayerMap, xn as SystemDefinition, y as DefineScene, yn as QueryTerm, zn as Config$3, zr as RngApi } from "./types-BCI9vUA6.mjs";
+import { A as GlowValue, B as Target, C as BlurValue, D as FilterComponent, F as AnimPlayerValue, H as HapticKind, I as Config$11, K as defineAnimation, L as FramesValue, M as OutlineValue, N as UniformDeclaration, O as FilterSpec, P as AnimApi, Q as play, R as MotionKeyframe, S as AlphaValue, T as DisplacementValue, U as SfxDescriptor, W as Step, _ as State$12, a as AudioApi, b as EmitterDefinition, c as MusicDescriptor, d as State$11, f as VolumesFor, h as EffectsApi, j as NoiseValue, k as FilterValueOf, l as MusicOptions, lt as OverlayApi, m as Config$13, n as State$13, r as UiApi, s as Config$12, t as Config$14, w as ColorMatrixValue, x as EmitterValue, y as EmitterConfig, z as State$10 } from "./types-BVSmbgJB.mjs";
+import { B as Message, C as State$16, D as TextStyleInput, G as TypedTr, H as State$14, I as Argument, J as ResolvedStyle, L as Config$15, M as Config$16, N as InputApi, O as TextStyles, P as State$15, R as I18nApi, S as Point, T as TextBind, V as Part, W as TextKey, Y as Style, Z as WhenFlags, b as Config$17, g as IntrinsicElementsFor, h as defineTokens, j as defineComponent, k as TextValue, q as IsFlags, s as PopupComponent, v as BindField, w as TextApi, x as CountdownValue, y as BindOptions, z as IntlKit } from "./types-k5szXqU1.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -102,9 +102,11 @@ declare function defineTextStyles(map: Record<string, TextStyleInput>): TextStyl
 /**
  * Types a projection: keyed items of the model turned into entities. `Item` is inferred from the
  * return of `from` and reaches `key`, `view` and every motion hook; `layer` and `lift` stay
- * literal, so `defineScene` can check them against the layers of the scene.
+ * literal, so `defineScene` can check them against the layers of the scene. Each pair of
+ * `initialOnly` has its field names checked against its own component.
  *
- * @param spec - Name, layer, optional lift layer, `from`, `key`, `view` and the motion hooks.
+ * @param spec - Name, layer, optional lift layer, `from`, `key`, `view`, the motion hooks and
+ *   the `initialOnly` fields.
  * @returns The same spec, typed.
  * @example
  * ```ts
@@ -118,7 +120,7 @@ declare function defineTextStyles(map: Record<string, TextStyleInput>): TextStyl
  * boardItems.layer; // "items", the literal type, not string
  * ```
  */
-declare function projection<const LayerName extends string, const LiftName extends string, Item, Player = Json, Session = Json>(spec: ProjectionSpec<Item, LayerName, LiftName, Player, Session>): ProjectionSpec<Item, LayerName, LiftName, Player, Session>;
+declare function projection<const LayerName extends string, const LiftName extends string, Item, Player = Json, Session = Json, const Values extends readonly object[] = []>(spec: ProjectionSpec<Item, LayerName, LiftName, Player, Session, Values>): ProjectionSpec<Item, LayerName, LiftName, Player, Session, Values>;
 /**
  * The projection helper bound to one game's `player` and `session`.
  *
@@ -127,7 +129,7 @@ declare function projection<const LayerName extends string, const LiftName exten
  * const bound: ProjectionFor<{ coins: number }, {}> = projection;
  * ```
  */
-type ProjectionFor<Player, Session> = <const LayerName extends string, const LiftName extends string, Item>(spec: ProjectionSpec<Item, LayerName, LiftName, Player, Session>) => ProjectionSpec<Item, LayerName, LiftName, Player, Session>;
+type ProjectionFor<Player, Session> = <const LayerName extends string, const LiftName extends string, Item, const Values extends readonly object[] = []>(spec: ProjectionSpec<Item, LayerName, LiftName, Player, Session, Values>) => ProjectionSpec<Item, LayerName, LiftName, Player, Session, Values>;
 //#endregion
 //#region src/plugins/anim/index.d.ts
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $t as ShaderWhat, Ar as types_d_exports$10, At as PerfChange, Bt as PerfLongFrameLine, Cr as types_d_exports$3, Ct as PERF_CAUSES, Dt as PassKind, E as types_d_exports$13, Et as PROBLEM_RULES, Fr as SaveUnreadableError, Ft as PerfEventLine, G as Transform, Gt as PerfStartupLine, H as SpriteBlend, Ht as PerfMeasured, I as Overlay, It as PerfEventName, J as AdaptiveScale, Jn as exit, Jt as PoolTrimDetail, Kn as types_d_exports$6, Kr as types_d_exports$9, Kt as PerfTelemetryLine, L as OverlayValue, Lt as PerfGapLine, M as HudPart, Mt as PerfCollectorLine, N as HudPartValue, Nt as PerfCounts, Ot as PassRecord, P as NineSlice, Pt as PerfDisplay, Qt as ShaderEventDetail, R as Parent, Rt as PerfHeaderLine, St as OverlayWhat, Tn as DescriptionNode, Tt as PERF_LOG_VERSION, Ut as PerfSampleLine, V as Sprite, Vt as PerfMarkLine, Wt as PerfSpikeLine, Xn as to, Xt as ProblemRule, Yn as slot, Yt as ProblemEventDetail, Z as MonitorConfig, Zn as type, Zt as SHADER_WHATS, _t as FrameRing, at as types_d_exports$12, bt as MonitorSections, ei as types_d_exports$15, en as WarmDetail, g as types_d_exports$1, gt as FrameRecord, ht as FrameReadout, j as Display, jt as PerfChangeEntry, kt as PerfCause, mt as FrameReadResult, nt as PoolTrim, on as types_d_exports$17, pt as FrameColumns, q as sprite, qt as PerfThermalLine, st as MonitorCounts, tn as DEMAND_REASONS, vt as LongFrameEntry, wt as PERF_GAP_BUCKETS, xt as OverlayEventDetail, yt as MONITOR_SECTIONS, z as Shape, zt as PerfLogLine } from "./types-K3qfyTu0.mjs";
-import { $ as sequence, E as FilterArea, G as HAPTIC_KINDS, H as HapticKind, J as frames, K as defineAnimation, Q as play, V as types_d_exports, X as mark, Y as haptic, Z as parallel, at as stopSfx, ct as wait, et as set, i as types_d_exports$16, it as stagger, nt as spawn, ot as tween, p as types_d_exports$2, q as external, rt as spawned, st as use, tt as sfx, ut as types_d_exports$4, v as types_d_exports$5 } from "./types-B1W2CPUu.mjs";
-import { A as types_d_exports$14, E as TextFormat, F as types_d_exports$8, K as types_d_exports$7, d as DebugTrigger, f as LocalWrite, h as defineTokens, j as defineComponent, m as popup, p as ScrollState, u as Box, x as CountdownValue, y as BindOptions } from "./types-BAv5qOZX.mjs";
-import { $ as system, A as Draggable, At as Text, B as Touchable, C as AnimPlayer, Ct as debugPlugin, D as defineBundles, Dt as animPlugin, E as defineScene, Et as assetsPlugin, F as PointerOver, G as Exiting, H as Traced, I as Pressable, J as Order, K as Layer, L as Pressed, M as Held, Mt as defineTextStyles, N as Hovered, Nt as label, O as load, Ot as projection, P as Pointer, Q as resource, R as Swipeable, S as defineMotion, St as effectsPlugin, T as Frames, Tt as audioPlugin, U as PASS_KINDS, V as Traceable, W as frameAt, X as component, Y as Tree, Z as mut, _ as defineStyle, _t as modelPlugin, a as defineEmitter, at as defineFeature, b as messageDuration, bt as i18nPlugin, c as Alpha, ct as uiPlugin, d as Displacement, dt as scenesPlugin, et as tag, f as Glow, ft as rendererPlugin, g as resolve, gt as types_d_exports$11, h as music, ht as PlatformProvider, i as screen, it as schedule, j as DropTarget, jt as bind, k as ready, kt as Countdown, l as Blur, lt as timePlugin, m as Outline, mt as BackResult, n as createPlugin, nt as guide, o as Emitter, ot as flattenFeatures, p as Noise, pt as platformPlugin, q as Now, r as defineGame, rt as hint, s as defineFilter, st as worldPlugin, t as createApp, tt as defineEffect, u as ColorMatrix, ut as textPlugin, v as tr, vt as lifecyclePlugin, w as Animation, wt as clockPlugin, x as cubicBezier, xt as flowPlugin, y as messageArgument, yt as inputPlugin, z as Tappable } from "./index-Cs4qaPMq.mjs";
+import { $t as ShaderWhat, Ar as types_d_exports$10, At as PerfChange, Bt as PerfLongFrameLine, Cr as types_d_exports$3, Ct as PERF_CAUSES, Dt as PassKind, E as types_d_exports$13, Et as PROBLEM_RULES, Fr as SaveUnreadableError, Ft as PerfEventLine, G as Transform, Gt as PerfStartupLine, H as SpriteBlend, Ht as PerfMeasured, I as Overlay, It as PerfEventName, J as AdaptiveScale, Jn as exit, Jt as PoolTrimDetail, Kn as types_d_exports$6, Kr as types_d_exports$9, Kt as PerfTelemetryLine, L as OverlayValue, Lt as PerfGapLine, M as HudPart, Mt as PerfCollectorLine, N as HudPartValue, Nt as PerfCounts, Ot as PassRecord, P as NineSlice, Pt as PerfDisplay, Qt as ShaderEventDetail, R as Parent, Rt as PerfHeaderLine, St as OverlayWhat, Tn as DescriptionNode, Tt as PERF_LOG_VERSION, Ut as PerfSampleLine, V as Sprite, Vt as PerfMarkLine, Wt as PerfSpikeLine, Xn as to, Xt as ProblemRule, Yn as slot, Yt as ProblemEventDetail, Z as MonitorConfig, Zn as type, Zt as SHADER_WHATS, _t as FrameRing, at as types_d_exports$12, bt as MonitorSections, ei as types_d_exports$15, en as WarmDetail, g as types_d_exports$1, gt as FrameRecord, ht as FrameReadout, j as Display, jt as PerfChangeEntry, kt as PerfCause, mt as FrameReadResult, nt as PoolTrim, on as types_d_exports$17, pt as FrameColumns, q as sprite, qt as PerfThermalLine, st as MonitorCounts, tn as DEMAND_REASONS, vt as LongFrameEntry, wt as PERF_GAP_BUCKETS, xt as OverlayEventDetail, yt as MONITOR_SECTIONS, z as Shape, zt as PerfLogLine } from "./types-BCI9vUA6.mjs";
+import { $ as sequence, E as FilterArea, G as HAPTIC_KINDS, H as HapticKind, J as frames, K as defineAnimation, Q as play, V as types_d_exports, X as mark, Y as haptic, Z as parallel, at as stopSfx, ct as wait, et as set, i as types_d_exports$16, it as stagger, nt as spawn, ot as tween, p as types_d_exports$2, q as external, rt as spawned, st as use, tt as sfx, ut as types_d_exports$4, v as types_d_exports$5 } from "./types-BVSmbgJB.mjs";
+import { A as types_d_exports$14, E as TextFormat, F as types_d_exports$8, K as types_d_exports$7, d as DebugTrigger, f as LocalWrite, h as defineTokens, j as defineComponent, m as popup, p as ScrollState, u as Box, x as CountdownValue, y as BindOptions } from "./types-k5szXqU1.mjs";
+import { $ as system, A as Draggable, At as Text, B as Touchable, C as AnimPlayer, Ct as debugPlugin, D as defineBundles, Dt as animPlugin, E as defineScene, Et as assetsPlugin, F as PointerOver, G as Exiting, H as Traced, I as Pressable, J as Order, K as Layer, L as Pressed, M as Held, Mt as defineTextStyles, N as Hovered, Nt as label, O as load, Ot as projection, P as Pointer, Q as resource, R as Swipeable, S as defineMotion, St as effectsPlugin, T as Frames, Tt as audioPlugin, U as PASS_KINDS, V as Traceable, W as frameAt, X as component, Y as Tree, Z as mut, _ as defineStyle, _t as modelPlugin, a as defineEmitter, at as defineFeature, b as messageDuration, bt as i18nPlugin, c as Alpha, ct as uiPlugin, d as Displacement, dt as scenesPlugin, et as tag, f as Glow, ft as rendererPlugin, g as resolve, gt as types_d_exports$11, h as music, ht as PlatformProvider, i as screen, it as schedule, j as DropTarget, jt as bind, k as ready, kt as Countdown, l as Blur, lt as timePlugin, m as Outline, mt as BackResult, n as createPlugin, nt as guide, o as Emitter, ot as flattenFeatures, p as Noise, pt as platformPlugin, q as Now, r as defineGame, rt as hint, s as defineFilter, st as worldPlugin, t as createApp, tt as defineEffect, u as ColorMatrix, ut as textPlugin, v as tr, vt as lifecyclePlugin, w as Animation, wt as clockPlugin, x as cubicBezier, xt as flowPlugin, y as messageArgument, yt as inputPlugin, z as Tappable } from "./index-BMpWPXvo.mjs";
 export { type AdaptiveScale, Alpha, types_d_exports as Anim, AnimPlayer, Animation, types_d_exports$1 as Assets, types_d_exports$2 as Audio, type BackResult, type BindOptions, Blur, Box, types_d_exports$3 as Clock, ColorMatrix, Countdown, type CountdownValue, DEMAND_REASONS, types_d_exports$4 as Debug, DebugTrigger, type DescriptionNode, Displacement, Display, Draggable, DropTarget, types_d_exports$5 as Effects, Emitter, Exiting, type FilterArea, types_d_exports$6 as Flow, type FrameColumns, type FrameReadResult, type FrameReadout, type FrameRecord, type FrameRing, Frames, Glow, HAPTIC_KINDS, type HapticKind, Held, Hovered, HudPart, type HudPartValue, types_d_exports$7 as I18n, types_d_exports$8 as Input, Layer, types_d_exports$9 as Lifecycle, LocalWrite, type LongFrameEntry, MONITOR_SECTIONS, types_d_exports$10 as Model, type MonitorConfig, type MonitorCounts, type MonitorSections, NineSlice, Noise, Now, Order, Outline, Overlay, type OverlayEventDetail, type OverlayValue, type OverlayWhat, PASS_KINDS, PERF_CAUSES, PERF_GAP_BUCKETS, PERF_LOG_VERSION, PROBLEM_RULES, Parent, type PassKind, type PassRecord, type PerfCause, type PerfChange, type PerfChangeEntry, type PerfCollectorLine, type PerfCounts, type PerfDisplay, type PerfEventLine, type PerfEventName, type PerfGapLine, type PerfHeaderLine, type PerfLogLine, type PerfLongFrameLine, type PerfMarkLine, type PerfMeasured, type PerfSampleLine, type PerfSpikeLine, type PerfStartupLine, type PerfTelemetryLine, type PerfThermalLine, types_d_exports$11 as Platform, type PlatformProvider, Pointer, PointerOver, type PoolTrim, type PoolTrimDetail, Pressable, Pressed, type ProblemEventDetail, type ProblemRule, types_d_exports$12 as Renderer, SHADER_WHATS, SaveUnreadableError, types_d_exports$13 as Scenes, ScrollState, type ShaderEventDetail, type ShaderWhat, Shape, Sprite, type SpriteBlend, Swipeable, Tappable, Text, type TextFormat, types_d_exports$14 as TextTypes, types_d_exports$15 as Time, Touchable, Traceable, Traced, Transform, Tree, types_d_exports$16 as Ui, type WarmDetail, types_d_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, ready, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, stopSfx, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as sfx, $t as flowPlugin, A as types_exports$7, At as Glow, B as defineMotion, Bt as Animation, C as types_exports$14, Ct as messageDuration, D as types_exports$10, Dt as Blur, E as types_exports$11, Et as Alpha, F as types_exports$2, Ft as audioPlugin, G as external, Gt as MONITOR_SECTIONS, H as platformPlugin, Ht as rendererPlugin, I as types_exports$1, It as scenesPlugin, J as mark, Jt as PERF_LOG_VERSION, K as frames, Kt as PERF_CAUSES, L as types_exports, Lt as assetsPlugin, M as types_exports$5, Mt as Outline, N as types_exports$4, Nt as defineFilter, O as types_exports$9, Ot as ColorMatrix, P as types_exports$3, Pt as debugPlugin, Q as set, Qt as worldPlugin, R as uiPlugin, Rt as animPlugin, S as types_exports$15, St as messageArgument, T as types_exports$12, Tt as Emitter, U as HAPTIC_KINDS, Ut as PASS_KINDS, V as textPlugin, Vt as Frames, W as defineAnimation, Wt as frameAt, X as play, Xt as SHADER_WHATS, Y as parallel, Yt as PROBLEM_RULES, Z as sequence, Zt as DEMAND_REASONS, _ as defineBundles, _t as Tappable, a as cubicBezier, an as modelPlugin, at as use, b as types_exports$17, bt as Traced, c as hint, cn as timePlugin, ct as Draggable, d as defineScene, dt as Hovered, et as spawn, f as tr, ft as Pointer, g as music, gt as Swipeable, h as defineEmitter, ht as Pressed, i as screen, in as type, it as tween, j as types_exports$6, jt as Noise, k as types_exports$8, kt as Displacement, l as schedule, ln as clockPlugin, lt as DropTarget, m as flattenFeatures, mt as Pressable, n as createPlugin, nn as slot, nt as stagger, o as defineEffect, on as SaveUnreadableError, ot as wait, p as defineFeature, pt as PointerOver, q as haptic, qt as PERF_GAP_BUCKETS, r as defineGame, rn as to, rt as stopSfx, s as guide, sn as lifecyclePlugin, st as inputPlugin, t as createApp, tn as exit, tt as spawned, u as projection, ut as Held, v as load, vt as Touchable, w as types_exports$13, wt as effectsPlugin, x as types_exports$16, xt as i18nPlugin, y as ready, yt as Traceable, z as resolve, zt as AnimPlayer } from "./src-BPEIEsWH.mjs";
+import { $ as sfx, $t as flowPlugin, A as types_exports$7, At as Glow, B as defineMotion, Bt as Animation, C as types_exports$14, Ct as messageDuration, D as types_exports$10, Dt as Blur, E as types_exports$11, Et as Alpha, F as types_exports$2, Ft as audioPlugin, G as external, Gt as MONITOR_SECTIONS, H as platformPlugin, Ht as rendererPlugin, I as types_exports$1, It as scenesPlugin, J as mark, Jt as PERF_LOG_VERSION, K as frames, Kt as PERF_CAUSES, L as types_exports, Lt as assetsPlugin, M as types_exports$5, Mt as Outline, N as types_exports$4, Nt as defineFilter, O as types_exports$9, Ot as ColorMatrix, P as types_exports$3, Pt as debugPlugin, Q as set, Qt as worldPlugin, R as uiPlugin, Rt as animPlugin, S as types_exports$15, St as messageArgument, T as types_exports$12, Tt as Emitter, U as HAPTIC_KINDS, Ut as PASS_KINDS, V as textPlugin, Vt as Frames, W as defineAnimation, Wt as frameAt, X as play, Xt as SHADER_WHATS, Y as parallel, Yt as PROBLEM_RULES, Z as sequence, Zt as DEMAND_REASONS, _ as defineBundles, _t as Tappable, a as cubicBezier, an as modelPlugin, at as use, b as types_exports$17, bt as Traced, c as hint, cn as timePlugin, ct as Draggable, d as defineScene, dt as Hovered, et as spawn, f as tr, ft as Pointer, g as music, gt as Swipeable, h as defineEmitter, ht as Pressed, i as screen, in as type, it as tween, j as types_exports$6, jt as Noise, k as types_exports$8, kt as Displacement, l as schedule, ln as clockPlugin, lt as DropTarget, m as flattenFeatures, mt as Pressable, n as createPlugin, nn as slot, nt as stagger, o as defineEffect, on as SaveUnreadableError, ot as wait, p as defineFeature, pt as PointerOver, q as haptic, qt as PERF_GAP_BUCKETS, r as defineGame, rn as to, rt as stopSfx, s as guide, sn as lifecyclePlugin, st as inputPlugin, t as createApp, tn as exit, tt as spawned, u as projection, ut as Held, v as load, vt as Touchable, w as types_exports$13, wt as effectsPlugin, x as types_exports$16, xt as i18nPlugin, y as ready, yt as Traceable, z as resolve, zt as AnimPlayer } from "./src-ChniuNDc.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-ClVRMUAi.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, ready, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, stopSfx, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/inspect.d.mts

@@ -1,9 +1,9 @@
-import { Ir as Snapshot, Un as Position, Y as Api$2, ct as RenderStats, dn as ComponentSchema, gn as FrameDiff, h as Usage, hn as EntitySnapshot, in as Explained, ir as FlowGraph, it as Under, nn as Api$1, or as JournalEntry, t as Api$3, wr as Api } from "./types-K3qfyTu0.mjs";
-import { a as AudioApi, g as EffectsStats, h as EffectsApi, r as UiApi, u as SoundEntry } from "./types-B1W2CPUu.mjs";
-import { c as UiNode } from "./types-BAv5qOZX.mjs";
-import { t as HeadlessApp } from "./headless-BFI7EXHo.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-D52biu5v.mjs";
-import { n as defineSource } from "./define-0af8h-Ro.mjs";
+import { Ir as Snapshot, Un as Position, Y as Api$2, ct as RenderStats, dn as ComponentSchema, gn as FrameDiff, h as Usage, hn as EntitySnapshot, in as Explained, ir as FlowGraph, it as Under, nn as Api$1, or as JournalEntry, t as Api$3, wr as Api } from "./types-BCI9vUA6.mjs";
+import { a as AudioApi, g as EffectsStats, h as EffectsApi, r as UiApi, u as SoundEntry } from "./types-BVSmbgJB.mjs";
+import { c as UiNode } from "./types-k5szXqU1.mjs";
+import { t as HeadlessApp } from "./headless-Bx3WG3fZ.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-B6fvpFoz.mjs";
+import { n as defineSource } from "./define-T-WIPEkg.mjs";
 
 //#region src/plugins/flow/doors/read.d.ts
 /**

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-DIOe0nCH.mjs";
+import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-c0miURhi.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-DIOe0nCH.mjs";
+import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-c0miURhi.mjs";
 export { Fragment, type JSX, jsx, jsxs };

package/dist/{runtime-DIOe0nCH.d.mts → runtime-c0miURhi.d.mts}

@@ -1,4 +1,4 @@
-import { _ as UiIntrinsicElements, a as JsxChild, t as DescriptionNode } from "./types-BAv5qOZX.mjs";
+import { _ as UiIntrinsicElements, a as JsxChild, t as DescriptionNode } from "./types-k5szXqU1.mjs";
 
 //#region src/plugins/ui/jsx/runtime.d.ts
 /** What the compiler passes as props: the children plus whatever the tag declared. */

package/dist/{src-BPEIEsWH.mjs → src-ChniuNDc.mjs}

@@ -9647,8 +9647,9 @@ function inertHandle() {
 	return INERT;
 }
 /**
-* The fields another writer owns on one component of one entity: the fields a running driver
-* holds, and the fields the component type gives to a plugin for good.
+* The fields another writer owns on one component of one entity: the fields a `mute()` holds and
+* the `initialOnly` fields of a view's projection (one table, `state.mutes`), and the fields the
+* component type gives to a plugin for good.
 *
 * @param pctx - Domain context of the projection module.
 * @param entity - The entity to ask about.
@@ -10803,6 +10804,221 @@ function routeHint(hints, projection, key) {
 	}
 }
 //#endregion
+//#region src/plugins/world/projection/mutes.ts
+/**
+* Tells a table `mute()` made apart from a shared `initialOnly` seed, which is frozen.
+*
+* @param table - A table of `state.mutes`.
+* @returns True when the table may be written.
+*/
+function isOwnTable(table) {
+	return !Object.isFrozen(table);
+}
+/**
+* Tells a field set `mute()` made apart from a set of a shared `initialOnly` seed, which is frozen.
+*
+* @param fields - A field set of one table.
+* @returns True when the set may be written.
+*/
+function isOwnFields(fields) {
+	return !Object.isFrozen(fields);
+}
+/**
+* The table a mute may write: the entity's own one, a copy of the seed it was born with, or a new one.
+*
+* @param stored - The table the entity has now, if any.
+* @returns A writable table.
+*/
+function ownTable(stored) {
+	if (stored === void 0) return /* @__PURE__ */ new Map();
+	return isOwnTable(stored) ? stored : new Map(stored);
+}
+/**
+* The field set a mute may write: the component's own one, a copy of its seed set, or a new one.
+*
+* @param stored - The field set the component has now, if any.
+* @returns A writable set.
+*/
+function ownFields(stored) {
+	if (stored === void 0) return /* @__PURE__ */ new Set();
+	return isOwnFields(stored) ? stored : new Set(stored);
+}
+/**
+* The `initialOnly` fields of one component of a view, from the spec of its projection.
+*
+* @param state - The projection branch of the plugin state.
+* @param entity - The entity of the view.
+* @param name - The component name.
+* @returns The seed set, or `undefined` for an entity that is no view of such a projection.
+*/
+function initialFieldsOf(state, entity, name) {
+	const projection = state.byEntity.get(entity)?.projection;
+	const spec = projection === void 0 ? void 0 : state.specs.get(projection);
+	return spec === void 0 ? void 0 : state.initialOnly.get(spec)?.get(name);
+}
+/**
+* Deletes a released field set once it is empty, and the entity's table once no component is
+* left. Only the table and the set this mute filled are touched, so a remover that runs after a
+* clear or a new birth on the same id never drops a newer mute.
+*
+* @param mutes - The mute tables of every entity.
+* @param entity - The muted entity.
+* @param table - The table the mute wrote.
+* @param name - The muted component's name.
+* @param owned - The field set the remover released from.
+*/
+function dropEmptyMute(mutes, entity, table, name, owned) {
+	if (owned.size > 0 || mutes.get(entity) !== table || table.get(name) !== owned) return;
+	table.delete(name);
+	if (table.size === 0) mutes.delete(entity);
+}
+/**
+* Hands fields of one component of one entity to another writer, until the remover runs. A view
+* born with an `initialOnly` seed gets its own copy first. The remover keeps the seed fields, asked
+* when it runs: a mute made inside the spawn came before the view was known.
+*
+* @param state - The projection branch of the plugin state.
+* @param entity - The entity.
+* @param name - The component name.
+* @param fields - The field names the caller owns.
+* @returns The remover; a no-op when called twice.
+*/
+function muteFields(state, entity, name, fields) {
+	const table = ownTable(state.mutes.get(entity));
+	const owned = ownFields(table.get(name));
+	for (const field of fields) owned.add(field);
+	forgetJoined(state, owned);
+	table.set(name, owned);
+	state.mutes.set(entity, table);
+	let released = false;
+	return () => {
+		if (released) return;
+		released = true;
+		const kept = initialFieldsOf(state, entity, name);
+		for (const field of fields) if (kept?.has(field) !== true) owned.delete(field);
+		forgetJoined(state, owned);
+		dropEmptyMute(state.mutes, entity, table, name, owned);
+	};
+}
+/**
+* Builds the frozen seed of a projection's `initialOnly` list: component name to its fields, a
+* component named twice with both lists joined.
+*
+* @param spec - The projection spec.
+* @param pairs - Its `initialOnly` list, not empty.
+* @returns The seed.
+* @throws {Error} For a pair with no field.
+*/
+function buildSeed(spec, pairs) {
+	const seed = /* @__PURE__ */ new Map();
+	for (const [component, fields] of pairs) {
+		const name = component.componentName;
+		if (fields.length === 0) throw new Error(`[game] Projection "${spec.name}" lists ${name} in initialOnly with no field.\n  Name the fields only the birth of a view writes, or drop the pair.`);
+		seed.set(name, Object.freeze(/* @__PURE__ */ new Set([...seed.get(name) ?? [], ...fields])));
+	}
+	return Object.freeze(seed);
+}
+/**
+* Checks the `initialOnly` list of a spec and keeps its seed: once per spec, since a name is
+* registered once and `replace` brings a new spec. A spec without the option, or with an empty
+* list, has none.
+*
+* @param state - The projection branch of the plugin state.
+* @param spec - The spec `register` or `replace` stores.
+* @returns The seed, or `undefined`.
+* @throws {Error} For a pair with no field; nothing is kept then.
+*/
+function learnSeed(state, spec) {
+	const pairs = spec.initialOnly;
+	if (pairs === void 0 || pairs.length === 0) return void 0;
+	const seed = buildSeed(spec, pairs);
+	state.initialOnly.set(spec, seed);
+	return seed;
+}
+/**
+* Joins a seed into a table of the entity's own, in place, so the remover of every mute that wrote
+* the table still holds its table and its sets: a component the table lacks gets the shared set
+* of the seed, the set a mute wrote gets the fields of the seed.
+*
+* @param state - The projection branch of the plugin state.
+* @param table - The entity's own table.
+* @param seed - The seed to join.
+*/
+function joinSeed(state, table, seed) {
+	for (const [name, fields] of seed) {
+		const stored = table.get(name);
+		if (stored === void 0) {
+			table.set(name, fields);
+			continue;
+		}
+		const owned = ownFields(stored);
+		for (const field of fields) owned.add(field);
+		forgetJoined(state, owned);
+		table.set(name, owned);
+	}
+}
+/**
+* Gives a view that was just born the seed of its projection, so from now on nothing of the
+* projection writes or compares those fields. The birth itself wrote them from `view`. A view a
+* listener of its spawn muted already keeps its table, and the seed joins it.
+*
+* @param state - The projection branch of the plugin state.
+* @param spec - The projection spec.
+* @param entity - The entity of the new view.
+*/
+function seedMutes(state, spec, entity) {
+	if (spec.initialOnly === void 0) return;
+	const seed = state.initialOnly.get(spec);
+	if (seed === void 0) return;
+	const stored = state.mutes.get(entity);
+	if (stored === void 0) {
+		state.mutes.set(entity, seed);
+		return;
+	}
+	const table = ownTable(stored);
+	joinSeed(state, table, seed);
+	state.mutes.set(entity, table);
+}
+/**
+* Moves a view with a table of its own from one seed to the next: a set of the old seed goes, the
+* new seed joins. A set a mute wrote keeps every field it holds, an old seed's field it copied too,
+* since the table does not say which mute named it. A table left empty goes.
+*
+* @param state - The projection branch of the plugin state.
+* @param entity - The entity of the view.
+* @param stored - The table the view has now, if any.
+* @param from - The seed of the old spec, if any.
+* @param to - The seed of the new spec, if any.
+*/
+function reseedOwn(state, entity, stored, from, to) {
+	const table = ownTable(stored);
+	for (const [name, fields] of from ?? []) if (table.get(name) === fields) table.delete(name);
+	if (to !== void 0) joinSeed(state, table, to);
+	if (table.size === 0) state.mutes.delete(entity);
+	else state.mutes.set(entity, table);
+}
+/**
+* Moves the views of a replaced projection from the seed of the old spec to the seed of the new
+* one. A view that holds the old seed, or none when the old spec had none, takes the new seed. A
+* view a `mute()` gave its own table keeps it: the sets of the old seed in it go, the new seed
+* joins it.
+*
+* @param state - The projection branch of the plugin state.
+* @param name - The projection name.
+* @param from - The seed of the old spec, if any.
+* @param to - The seed of the new spec, if any.
+*/
+function reseedViews(state, name, from, to) {
+	if (from === to) return;
+	for (const view of state.byEntity.values()) {
+		if (view.projection !== name) continue;
+		const stored = state.mutes.get(view.entity);
+		if (stored !== from) reseedOwn(state, view.entity, stored, from, to);
+		else if (to === void 0) state.mutes.delete(view.entity);
+		else state.mutes.set(view.entity, to);
+	}
+}
+//#endregion
 //#region src/plugins/world/projection/reconcile.ts
 /**
 * Creates the empty set of used hints. It lives in its own non-exported function because lint
@@ -10894,6 +11110,7 @@ function enterEntry(pctx, spec, mounted, entry) {
 	const view = createViewRecord(entity, spec.name, entry.key, entry.item, values, entry.direct ? "mount" : "change");
 	const state = pctx.ctx.state.projection;
 	const building = state.building;
+	seedMutes(state, spec, entity);
 	mounted.live.set(entry.key, view);
 	state.byEntity.set(entity, view);
 	state.membershipVersion += 1;
@@ -11739,39 +11956,6 @@ function isConvergeCause(cause) {
 	return cause === "load" || cause === "restore";
 }
 /**
-* Creates the empty mute table of one entity. It lives in its own non-exported function because
-* lint rule L5 refuses a collection built inside an exported declaration.
-*
-* @returns An empty table of component name to owned fields.
-*/
-function emptyMuteTable() {
-	return /* @__PURE__ */ new Map();
-}
-/**
-* Creates the empty field set of one muted component.
-*
-* @returns An empty set of field names.
-*/
-function emptyFieldSet() {
-	return /* @__PURE__ */ new Set();
-}
-/**
-* Deletes a released field set once it is empty, and the entity's table once no component is
-* left. Only the set and table still stored are touched, so a remover that runs after a clear
-* never drops a newer mute.
-*
-* @param mutes - The mute tables of every entity.
-* @param entity - The muted entity.
-* @param name - The muted component's name.
-* @param owned - The field set the remover released from.
-*/
-function dropEmptyMute(mutes, entity, name, owned) {
-	const byComponent = mutes.get(entity);
-	if (owned.size > 0 || byComponent?.get(name) !== owned) return;
-	byComponent.delete(name);
-	if (byComponent.size === 0) mutes.delete(entity);
-}
-/**
 * Creates the empty dirty record the next reconcile reads.
 *
 * @returns Nothing to reconcile yet.
@@ -11876,13 +12060,18 @@ function createProjectionApi(ctx, deps) {
 	return {
 		register: (spec) => {
 			if (state.specs.has(spec.name)) throw new Error(`[game] Projection "${spec.name}" is registered twice.\n  Give the second projection another name.`);
+			learnSeed(state, spec);
 			state.specs.set(spec.name, spec);
 		},
 		replace: (spec) => {
-			if (!state.specs.has(spec.name)) throw new Error(`[game] Projection "${spec.name}" is not registered.\n  Register it before replacing it.`);
+			const previous = state.specs.get(spec.name);
+			if (previous === void 0) throw new Error(`[game] Projection "${spec.name}" is not registered.\n  Register it before replacing it.`);
 			const mounted = state.mounted.has(spec.name);
 			if (mounted) checkLayers(spec, state.layers);
+			const from = state.initialOnly.get(previous);
+			const seed = learnSeed(state, spec);
 			state.specs.set(spec.name, spec);
+			reseedViews(state, spec.name, from, seed);
 			if (mounted) forceRerun();
 		},
 		setLayers: (list) => {
@@ -11915,22 +12104,7 @@ function createProjectionApi(ctx, deps) {
 			playSettle(pctx, view, spec, restingPeers(mounted), looseComponents(pctx, view));
 			dropIfStill(pctx, view);
 		},
-		mute: (entity, component, fields) => {
-			const byComponent = state.mutes.get(entity) ?? emptyMuteTable();
-			const owned = byComponent.get(component.componentName) ?? emptyFieldSet();
-			for (const field of fields) owned.add(field);
-			forgetJoined(state, owned);
-			byComponent.set(component.componentName, owned);
-			state.mutes.set(entity, byComponent);
-			let released = false;
-			return () => {
-				if (released) return;
-				released = true;
-				for (const field of fields) owned.delete(field);
-				forgetJoined(state, owned);
-				dropEmptyMute(state.mutes, entity, component.componentName, owned);
-			};
-		},
+		mute: (entity, component, fields) => muteFields(state, entity, component.componentName, fields),
 		lift: (entity, on) => {
 			const view = state.byEntity.get(entity);
 			if (view === void 0) return;
@@ -12380,6 +12554,7 @@ function createProjectionState() {
 		keys: emptyMap$9(),
 		keysByEntity: emptyMap$9(),
 		mutes: emptyMap$9(),
+		initialOnly: emptyWeakMap$2(),
 		ownedSets: emptyWeakMap$2(),
 		joinedMutes: emptyWeakMap$2(),
 		converged: [],
@@ -64225,9 +64400,11 @@ function scenesFor() {
 /**
 * Types a projection: keyed items of the model turned into entities. `Item` is inferred from the
 * return of `from` and reaches `key`, `view` and every motion hook; `layer` and `lift` stay
-* literal, so `defineScene` can check them against the layers of the scene.
+* literal, so `defineScene` can check them against the layers of the scene. Each pair of
+* `initialOnly` has its field names checked against its own component.
 *
-* @param spec - Name, layer, optional lift layer, `from`, `key`, `view` and the motion hooks.
+* @param spec - Name, layer, optional lift layer, `from`, `key`, `view`, the motion hooks and
+*   the `initialOnly` fields.
 * @returns The same spec, typed.
 * @example
 * ```ts

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
-import { $n as FeaturePlugin, Dr as Json, dr as Descriptor, gr as NodeFx, hr as Hint, sr as NodeTable, tr as AnyFlow, xr as FakeClock, yr as ClockSource } from "./types-K3qfyTu0.mjs";
-import { t as createApp } from "./index-Cs4qaPMq.mjs";
-import { b as saveOf, v as WithGameState, y as memory } from "./types-Dh2cyp0H.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-BFI7EXHo.mjs";
+import { $n as FeaturePlugin, Dr as Json, dr as Descriptor, gr as NodeFx, hr as Hint, sr as NodeTable, tr as AnyFlow, xr as FakeClock, yr as ClockSource } from "./types-BCI9vUA6.mjs";
+import { t as createApp } from "./index-BMpWPXvo.mjs";
+import { b as saveOf, v as WithGameState, y as memory } from "./types-B4G8sOED.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-Bx3WG3fZ.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/clock/fake.d.ts

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-import { en as refuseStart, in as type, m as flattenFeatures, t as createApp, tn as exit } from "./src-BPEIEsWH.mjs";
+import { en as refuseStart, in as type, m as flattenFeatures, t as createApp, tn as exit } from "./src-ChniuNDc.mjs";
 import { n as saveOf, t as memory } from "./memory-CWlqhS7l.mjs";
 import { n as fakeClock } from "./fake-hnJcJeYf.mjs";
 import { i as stepFrames, r as runRepro, t as createHeadless } from "./headless-Bxxl_mQX.mjs";

package/dist/{types-Dh2cyp0H.d.mts → types-B4G8sOED.d.mts}

@@ -1,7 +1,7 @@
-import { $ as PixiModule, $n as FeaturePlugin, Dr as Json, Lr as SnapshotOf, Mr as PlayerStateProvider, Nr as ProviderCall, Pr as SaveDoc, Tr as Config, X as Config$2, a as Config$3, d as Manifest, lt as Orientation, n as AssetsIo, tr as AnyFlow, ur as TypeTag, xr as FakeClock, yr as ClockSource, zn as Config$1 } from "./types-K3qfyTu0.mjs";
-import { o as AudioContextLike, s as Config$4 } from "./types-B1W2CPUu.mjs";
-import { R as I18nApi, U as StringTable, W as TextKey } from "./types-BAv5qOZX.mjs";
-import { St as effectsPlugin, Tt as audioPlugin, ht as PlatformProvider, i as screen, pt as platformPlugin, t as createApp } from "./index-Cs4qaPMq.mjs";
+import { $ as PixiModule, $n as FeaturePlugin, Dr as Json, Lr as SnapshotOf, Mr as PlayerStateProvider, Nr as ProviderCall, Pr as SaveDoc, Tr as Config, X as Config$2, a as Config$3, d as Manifest, lt as Orientation, n as AssetsIo, tr as AnyFlow, ur as TypeTag, xr as FakeClock, yr as ClockSource, zn as Config$1 } from "./types-BCI9vUA6.mjs";
+import { o as AudioContextLike, s as Config$4 } from "./types-BVSmbgJB.mjs";
+import { R as I18nApi, U as StringTable, W as TextKey } from "./types-k5szXqU1.mjs";
+import { St as effectsPlugin, Tt as audioPlugin, ht as PlatformProvider, i as screen, pt as platformPlugin, t as createApp } from "./index-BMpWPXvo.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/model/store/providers/memory.d.ts

package/dist/{types-D52biu5v.d.mts → types-B6fvpFoz.d.mts}

@@ -1,5 +1,5 @@
-import { Dr as Json, Ir as Snapshot } from "./types-K3qfyTu0.mjs";
-import { t as HeadlessApp } from "./headless-BFI7EXHo.mjs";
+import { Dr as Json, Ir as Snapshot } from "./types-BCI9vUA6.mjs";
+import { t as HeadlessApp } from "./headless-Bx3WG3fZ.mjs";
 import { Log } from "@moku-labs/common/browser";
 
 //#region src/plugins/flow/doors/types.d.ts

package/dist/{types-K3qfyTu0.d.mts → types-BCI9vUA6.d.mts}

@@ -4273,9 +4273,35 @@ type AnyProjectionMotion = {
   readonly change?: ChangeHooks<never>;
   settle?(view: ViewHandle<unknown>, components: readonly string[]): Motion;
 };
+/**
+ * One pair of `ProjectionSpec.initialOnly`: a component and the fields of it that `view` gives a
+ * view once, when it is born. The field names are checked against the component's own value.
+ *
+ * @example
+ * ```ts
+ * const arc: InitialOnlyPair<ShapeValue> = [Shape, ["sweep"]];
+ * ```
+ */
+type InitialOnlyPair<Value extends object> = readonly [ComponentHandle<Value>, readonly (keyof Value & string)[]];
+/**
+ * The `initialOnly` list of a projection: one pair for each value type of `Values`, each pair
+ * checked against its own component. `projection()` infers `Values` from the list, so
+ * `[[Shape, ["swep"]]]` is a type error.
+ *
+ * @example
+ * ```ts
+ * const fields: InitialOnly<[ShapeValue, TransformValue]> = [
+ *   [Shape, ["sweep", "alpha"]],
+ *   [Transform, ["rotation"]]
+ * ];
+ * ```
+ */
+type InitialOnly<Values extends readonly object[]> = { readonly [Index in keyof Values]: InitialOnlyPair<Values[Index]> };
 /**
  * One projection: keyed items of the model turned into entities. `Item` is inferred from the
  * return of `from`; `layer` and `lift` keep their literal types so a scene can check them.
+ * `Values` are the value types of the `initialOnly` pairs, inferred by `projection()`; an
+ * annotation that leaves it out accepts any field name.
  *
  * @example
  * ```ts
@@ -4289,7 +4315,7 @@ type AnyProjectionMotion = {
  * };
  * ```
  */
-type ProjectionSpec<Item, LayerName extends string, LiftName extends string, Player, Session> = {
+type ProjectionSpec<Item, LayerName extends string, LiftName extends string, Player, Session, Values extends readonly object[] = readonly Record<string, unknown>[]> = {
   readonly name: string;
   readonly layer: LayerName;
   readonly lift?: LiftName;
@@ -4297,6 +4323,35 @@ type ProjectionSpec<Item, LayerName extends string, LiftName extends string, Pla
   key?(item: Item): string;
   view(item: Item): ViewOutput;
   readonly motion?: ProjectionMotion<Item>;
+  /**
+   * Fields another writer owns once a view is born. `view` gives them their first value when the
+   * view spawns; from then on nothing of the projection writes or compares them: not a changed
+   * item, not a motion or its finish, not the check at the end of a motion (no
+   * `world:view-corrected`), not a rollback, `settle(entity)`, a restore or a load. These are the
+   * rules of `mute()`, for every view of the projection and for its whole life. A `mute()` on the
+   * view adds to them, and its release keeps them. Left out, the projection writes every field.
+   *
+   * @example
+   * ```ts
+   * // The timer ring of a chest: born full, then the system `board.rings` draws its arc from `Now`.
+   * export const marks = projection({
+   *   name: "board.marks",
+   *   layer: "marks",
+   *   from: (player: Player) => player.board.timers,
+   *   key: timer => timer.id,
+   *   view: timer => [Shape({ kind: "arc", w: 28, h: 28, strokeWidth: 2.2, sweep: 1 })],
+   *   motion: {
+   *     enter: view => {
+   *       view.set(Shape, { alpha: 0 });
+   *       return view.toRest(Shape, { ms: 200 });
+   *     }
+   *   },
+   *   initialOnly: [[Shape, ["sweep"]]]
+   * });
+   * // The fade ends with the 0.42 the system wrote: no full ring, no `world:view-corrected`.
+   * ```
+   */
+  readonly initialOnly?: InitialOnly<Values>;
 };
 /**
  * A projection spec with its item and layer types erased, as the world stores it.
@@ -4319,7 +4374,8 @@ type AnyProjectionSpec = {
   from(player: Json, session: Json): unknown;
   key?(item: unknown): string;
   view(item: unknown): ViewOutput;
-  readonly motion?: AnyProjectionMotion;
+  readonly motion?: AnyProjectionMotion; /** The `initialOnly` pairs, their field names no longer tied to the component. */
+  readonly initialOnly?: readonly (readonly [ComponentHandle<object>, readonly string[]])[];
 };
 /**
  * Why a reconcile runs. Merged over the frame; the cause table decides play or direct. A
@@ -4442,6 +4498,12 @@ type Dirty = {
   roots: Set<Root>;
   force: boolean;
 };
+/**
+ * Component name to the fields another writer owns, of one entity. A frozen table, and a frozen
+ * set in one, is the `initialOnly` seed every view of one projection shares: nothing writes into
+ * it, and `mute()` copies it before it adds a field.
+ */
+type MuteTable = ReadonlyMap<string, ReadonlySet<string>>;
 /**
  * A mute's fields joined with a type's owned fields, and the owned set they were joined with.
  */
@@ -4471,8 +4533,14 @@ type ProjectionState = {
    * The reverse of `keys`, so `keyOf` answers for a registered element too. The entry of an
    * entity that is gone is dropped with its rest pose, and its side of `keys` with it.
    */
-  keysByEntity: Map<Entity, ProjectionKey>; /** Entity to component name to the fields another writer owns. */
-  mutes: Map<Entity, Map<string, Set<string>>>; /** The owned fields of each component type as a set, by the type's frozen `owned` list: made once. */
+  keysByEntity: Map<Entity, ProjectionKey>;
+  /**
+   * Entity to component name to the fields another writer owns: what `mute()` handed over, and
+   * the shared `initialOnly` seed a view of such a projection is born with. A view a listener of
+   * its spawn muted keeps that table, and the seed joins it.
+   */
+  mutes: Map<Entity, MuteTable>; /** The `initialOnly` seed of each registered spec that has one, frozen, built at `register` and `replace`. */
+  initialOnly: WeakMap<AnyProjectionSpec, MuteTable>; /** The owned fields of each component type as a set, by the type's frozen `owned` list: made once. */
   ownedSets: WeakMap<readonly string[], ReadonlySet<string>>; /** The muted and the owned fields joined, by the mute's field set: dropped when `mute()` or its release changes it. */
   joinedMutes: WeakMap<ReadonlySet<string>, JoinedFields>; /** The `onConverged` listeners: the owners of elements, told after a restore or a load. */
   converged: Array<() => void>;
@@ -4646,7 +4714,9 @@ type ProjectionApi = {
    */
   settle(entity: Entity): void;
   /**
-   * Hands a set of fields to another writer. Tracks never write them, also not on `finish()`.
+   * Hands a set of fields to another writer. Tracks never write them, also not on `finish()`. On
+   * a view whose projection names `initialOnly` fields the mute adds to them, and the remover keeps
+   * them.
    *
    * @param entity - The entity of the view.
    * @param component - The component whose fields are taken over.
@@ -6421,7 +6491,7 @@ type SystemTiming = {
   ms: Float64Array;
 };
 declare namespace types_d_exports$3 {
-  export { AnyComponentType, AnyComponentValue, AnyProjectionSpec, AnySystem, Api$2 as Api, Cause, ChangeHook, ComponentHandle, ComponentSchema, ComponentType, ComponentValue, Config$3 as Config, Deps$3 as Deps, DescriptionNode, Ease, EcsApi, EcsModule, Entity, EntityDiff, EntitySnapshot, Events$3 as Events, Explained, FrameDiff, GameSystemDefinition, KernelSlice$3 as KernelSlice, LayerSort, LayerSpec, ModelCommitted, Motion, MotionCause, MotionHandle, Mut, Narrowed, NumericFields, Owner, ProjectionApi, ProjectionKey, ProjectionModule, ProjectionMotion, ProjectionSpec, QueryTerm, QueryTuple, ReducedMotion, ResourceType, RestOptions, State$3 as State, SystemContext, SystemContextOf, SystemDefinition, SystemFor, SystemTiming, TagType, TrackOptions, TrackSegment, TweenDriver, TweenOptions, ViewHandle, ViewOutput, WorldCtx, WorldMode, WorldPhase, WorldSnapshot };
+  export { AnyComponentType, AnyComponentValue, AnyProjectionSpec, AnySystem, Api$2 as Api, Cause, ChangeHook, ComponentHandle, ComponentSchema, ComponentType, ComponentValue, Config$3 as Config, Deps$3 as Deps, DescriptionNode, Ease, EcsApi, EcsModule, Entity, EntityDiff, EntitySnapshot, Events$3 as Events, Explained, FrameDiff, GameSystemDefinition, InitialOnly, InitialOnlyPair, KernelSlice$3 as KernelSlice, LayerSort, LayerSpec, ModelCommitted, Motion, MotionCause, MotionHandle, Mut, Narrowed, NumericFields, Owner, ProjectionApi, ProjectionKey, ProjectionModule, ProjectionMotion, ProjectionSpec, QueryTerm, QueryTuple, ReducedMotion, ResourceType, RestOptions, State$3 as State, SystemContext, SystemContextOf, SystemDefinition, SystemFor, SystemTiming, TagType, TrackOptions, TrackSegment, TweenDriver, TweenOptions, ViewHandle, ViewOutput, WorldCtx, WorldMode, WorldPhase, WorldSnapshot };
 }
 /**
  * world plugin events.

package/dist/{types-B1W2CPUu.d.mts → types-BVSmbgJB.d.mts}

@@ -1,5 +1,5 @@
-import { $ as PixiModule, A as SyncApi, An as NumericFields, Dr as Json, En as Ease, Er as Events$3, Fn as TrackSegment, Ln as Api$2, Nn as ReducedMotion, O as FilterSlot, Pn as TrackOptions, Q as PixiFilter, Ur as Events$5, Y as Api$4, b as Events$4, dr as Descriptor, et as PixiSprite, fn as ComponentType, ft as FilterCache, k as FilterSlotInputs, kn as MotionHandle, ln as AnyComponentValue, mn as Entity, ni as Events$2, nn as Api$3, qr as Api$1, ri as Require, s as Events$1, sn as AnyComponent, t as Api$5, tt as PixiTexture, un as ComponentHandle, ur as TypeTag, ut as Point, wr as Api$6 } from "./types-K3qfyTu0.mjs";
-import { N as InputApi, R as I18nApi, X as StylesState, c as UiNode, i as Finding, l as LayoutState, n as ElementChange, o as JsxState, r as ElementMotion, w as TextApi } from "./types-BAv5qOZX.mjs";
+import { $ as PixiModule, A as SyncApi, An as NumericFields, Dr as Json, En as Ease, Er as Events$3, Fn as TrackSegment, Ln as Api$2, Nn as ReducedMotion, O as FilterSlot, Pn as TrackOptions, Q as PixiFilter, Ur as Events$5, Y as Api$4, b as Events$4, dr as Descriptor, et as PixiSprite, fn as ComponentType, ft as FilterCache, k as FilterSlotInputs, kn as MotionHandle, ln as AnyComponentValue, mn as Entity, ni as Events$2, nn as Api$3, qr as Api$1, ri as Require, s as Events$1, sn as AnyComponent, t as Api$5, tt as PixiTexture, un as ComponentHandle, ur as TypeTag, ut as Point, wr as Api$6 } from "./types-BCI9vUA6.mjs";
+import { N as InputApi, R as I18nApi, X as StylesState, c as UiNode, i as Finding, l as LayoutState, n as ElementChange, o as JsxState, r as ElementMotion, w as TextApi } from "./types-k5szXqU1.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 

package/dist/{types-BAv5qOZX.d.mts → types-k5szXqU1.d.mts}

@@ -1,4 +1,4 @@
-import { An as NumericFields, Cn as TagType, Dn as Motion, Dr as Json, En as Ease, In as ViewHandle, K as TransformValue, Ln as Api$1, Nn as ReducedMotion, On as MotionCause, Y as Api$3, _r as Answer, cn as AnyComponentType, dr as Descriptor, dt as ViewportSize, fn as ComponentType, hr as Hint, jn as ProjectionMotion, kn as MotionHandle, ln as AnyComponentValue, mn as Entity, nn as Api$2, qr as Api, ri as Require, s as Events$1, sn as AnyComponent, t as Api$4, vr as Api$5, wn as ChangeHook } from "./types-K3qfyTu0.mjs";
+import { An as NumericFields, Cn as TagType, Dn as Motion, Dr as Json, En as Ease, In as ViewHandle, K as TransformValue, Ln as Api$1, Nn as ReducedMotion, On as MotionCause, Y as Api$3, _r as Answer, cn as AnyComponentType, dr as Descriptor, dt as ViewportSize, fn as ComponentType, hr as Hint, jn as ProjectionMotion, kn as MotionHandle, ln as AnyComponentValue, mn as Entity, nn as Api$2, qr as Api, ri as Require, s as Events$1, sn as AnyComponent, t as Api$4, vr as Api$5, wn as ChangeHook } from "./types-BCI9vUA6.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 import { Node, Yoga } from "yoga-layout/load";

package/dist/{visual-DMx0vv_3.d.mts → visual-D0cotXHi.d.mts}

@@ -1,9 +1,9 @@
-import { Vr as Api$3, Y as Api, nn as Api$1, vr as Api$4, wr as Api$2 } from "./types-K3qfyTu0.mjs";
-import { P as AnimApi, r as UiApi } from "./types-B1W2CPUu.mjs";
-import { N as InputApi } from "./types-BAv5qOZX.mjs";
-import { r as Repro } from "./headless-BFI7EXHo.mjs";
-import { a as InputOf, r as ControlApp } from "./types-D52biu5v.mjs";
-import { t as commands } from "./commands-BGrtxBga.mjs";
+import { Vr as Api$3, Y as Api, nn as Api$1, vr as Api$4, wr as Api$2 } from "./types-BCI9vUA6.mjs";
+import { P as AnimApi, r as UiApi } from "./types-BVSmbgJB.mjs";
+import { N as InputApi } from "./types-k5szXqU1.mjs";
+import { r as Repro } from "./headless-Bx3WG3fZ.mjs";
+import { a as InputOf, r as ControlApp } from "./types-B6fvpFoz.mjs";
+import { t as commands } from "./commands-BZPrVtJT.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-DMx0vv_3.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-D0cotXHi.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/llms.txt

@@ -532,6 +532,7 @@ The graph. Modules `runner`, `gate`, `inbox`, `fx`, `features`. Runner methods s
 - When a system runs: before each run the world checks it. A system with a `query` is skipped while a term of its query has no entity (the smallest store among the terms is empty): no walk, no `mut()` mark, no timing. A system without a query always runs. `system({ ..., scenes: ["board"] })` runs only while one of those scenes is mounted or leaving: `scenes` calls `app.world.ecs.setScene(id)` at every switch, and the scene before leaves until nothing carries `Exiting` (the elements of its JSX views played their exit; the next scene's entities already stand then, so a `scenes` system writes only its own scene's entities). A dev build throws at start for a name in `scenes` no feature declares: `[game] System "board.idle" runs on the scene "bord", which no feature declares.` `ctx.resumed` is true on the first run after a skip (a cache or a remembered cue starts over then). The same for every system, the engine's included; 0 B a frame. A run with no rows does not happen any more: work a system did besides its rows (a hover, a drop or a press that ends, a resource reset, something that outlives its entities) goes to a system with `query: []` and `scenes`, reading its rows with `world.query()`. From 0.15.3: delete `systemsRun` from every feature (the type refuses it), rewrite the systems that work outside their rows, add `scenes` only to a system whose entities stand on every screen; `ecs.hold` and `ecs.isActive` are gone (a test asks `app.scenes.current()` or whether the system ran). World README, "When a system runs".
 - Motion hooks are told why they play: `enter(view, item, hint, cause)` and `exit(view, item, hint, cause)` get `World.MotionCause`, `"mount"` (the view comes or goes with its screen: a mount, an unmount, a load, a restore, a paused or fast world) or `"change"` (a commit). A world projection plays them only for `"change"`; `ui` plays them for both. `app.world.projection.causeOf(entity)` answers how a view came or how it is leaving, also in a removal hook of its despawn, until the next frame.
 - `app.world.projection.replace(spec)` swaps the spec of a registered projection; a mounted one runs its new `view` on the next frame. An unknown name throws. The caller is the dev hot swap.
+- `projection({ …, initialOnly: [[Shape, ["sweep"]]] })`: `view` gives those fields once, at the birth of a view; after that they belong to another writer (a system drawing a timer arc from `Now`), and no changed item, motion, end-of-motion check (`world:view-corrected`), rollback, `settle`, restore or load writes or compares them, as with `mute()` for every view's whole life. Field names are checked per component; a pair with no field throws at register. Absent, every field is the projection's.
 - `input`: one followed pointer. A finger that has not started a gesture (pressed, inside the tap slop, no long press, no trace) gives way to the next finger that goes down, wherever it rests, and its press is cancelled; a finger that started a gesture keeps it. `Pointer.id` is the followed `pointerId` (`-1` at rest): a system that measures the finger's travel starts over when it changes.
 - `Draggable({ payload, carry?, aim? })`: `aim: { x, y }`, a point of the view in its own units, moves the hover and the drop lookup from the finger to that point of the view in the hand; `null` (default) is the finger.
 - `pluginConfigs.renderer.onDemand: true` draws a frame only when something visible changed (a written view, a filter value, a resize, a wake, a capture); `app.renderer.stats().drawn` is the frames drawn per second (`fps` without it); a game that writes into its own `Display` object calls `app.renderer.invalidate(entity)` before the write; `renderer.sync.debug.verifyFrames(true)` (dev/debug) checks skipped frames by pixels and logs `renderer:missed-frame`; a dev build warns `renderer:missed-mark` for a write without the call.

package/package.json

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