@moku-labs/game 0.4.2 → 0.4.4

package/dist/{commands-DYO22lzi.d.mts → commands-C83eQ5B9.d.mts}

@@ -1,7 +1,7 @@
 import { C as Captured, Et as Bookmark, T as DebugSwitches, Vt as Time, an as Api, k as Api$2, kt as FlowState, m as Api$1 } from "./types-Dy1xB68L.mjs";
 import { d as HeadlessApp, n as Command, r as ControlApp } from "./types-DtmFVCHf.mjs";
 import { H as InputApi } from "./types-VErbiEXy.mjs";
-import { A as UiApi, t as AnimApi } from "./types-CVUHPvMB.mjs";
+import { G as UiApi, g as AnimApi, t as AudioApi } from "./types-C-4f2jD_.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**
@@ -104,6 +104,13 @@ declare const commands: Readonly<{
   timeScale: Command<{
     scale: "number";
   }, Readonly<Time>, ControlApp>;
+  mute: Command<{
+    muted: "boolean";
+  }, boolean, HeadlessApp & {
+    readonly log: import("@moku-labs/common/browser").LogApi;
+  } & {
+    readonly audio?: AudioApi;
+  }>;
   trace: Command<{
     path: "json";
   }, boolean, HeadlessApp & {

package/dist/control.d.mts

@@ -1,5 +1,5 @@
 import { d as HeadlessApp, i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-DtmFVCHf.mjs";
-import { t as commands } from "./commands-DYO22lzi.mjs";
+import { t as commands } from "./commands-C83eQ5B9.mjs";
 import { t as defineCommand } from "./define-BKWjWgyQ.mjs";
 
 //#region src/plugins/flow/doors/dev.d.ts

package/dist/control.mjs

@@ -1,4 +1,4 @@
-import { t as controlRefused } from "./dev-B5p9_3fz.mjs";
-import { n as commands, t as run } from "./run-C7O77UQR.mjs";
+import { t as controlRefused } from "./dev-wKLgOw7c.mjs";
+import { n as commands, t as run } from "./run-D_R0oJ6g.mjs";
 import { s as defineCommand } from "./input-CK4nxBO1.mjs";
 export { commands, controlRefused, defineCommand, run };

package/dist/{dev-B5p9_3fz.mjs → dev-wKLgOw7c.mjs}

@@ -27,18 +27,21 @@ function controlRefused() {
 	return /* @__PURE__ */ new Error("[game] Control commands run in dev builds only.\n  Define __MOKU_GAME_DEV__ as true in the dev build.");
 }
 /**
-* Builds the error a door source throws when the opt-in plugin it reads is not installed.
+* Builds the error a door source or command throws when the opt-in plugin it uses is not
+* installed.
 *
-* @param id - The id of the source.
-* @param plugin - The export name of the plugin it reads.
+* @param id - The id of the source or the command.
+* @param plugin - The export name of the plugin it uses.
+* @param kind - What the door descriptor is. A source by default.
 * @returns The error, ready to throw.
 * @example
 * ```ts
 * notInstalled("game.sounds", "audioPlugin").message; // "[game] The source game.sounds needs audioPlugin.\n  Add audioPlugin to createApp({ plugins })."
+* notInstalled("game.mute", "audioPlugin", "command").message; // "[game] The command game.mute needs audioPlugin.\n  Add audioPlugin to createApp({ plugins })."
 * ```
 */
-function notInstalled(id, plugin) {
-	return /* @__PURE__ */ new Error(`[game] The source ${id} needs ${plugin}.\n  Add ${plugin} to createApp({ plugins }).`);
+function notInstalled(id, plugin, kind = "source") {
+	return /* @__PURE__ */ new Error(`[game] The ${kind} ${id} needs ${plugin}.\n  Add ${plugin} to createApp({ plugins }).`);
 }
 //#endregion
 export { isDev as n, notInstalled as r, controlRefused as t };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { $ as Ease, A as Config$8, B as ComponentValue, Bt as State$7, Ct as to, Dt as DefineNode, Ft as GuideOptions, G as Narrowed, Ht as types_d_exports$14, It as Hint, J as ResourceType, Jt as State$5, Kt as Json, L as ComponentHandle, M as State$8, Mt as SceneIdOf, N as types_d_exports$16, O as ViewportSize, Pt as Descriptor, Q as DescriptionNode, Rt as Api$5, S as types_d_exports$11, St as slot, Tt as FeatureDescription, W as Mut, Wt as Config$5, X as TagType, Xt as Patch, Y as SystemDefinition, Yt as types_d_exports$9, _n as Events$1, _t as State$3, a as DefineBundles, an as Api$3, at as ProjectionMotion, b as State$6, bt as defineFlow, c as LoadReason, cn as PauseReason, d as Tier, dn as Api$1, dt as BundlesOf, en as SaveUnreadableError, fn as Config$2, ft as Config$3, gn as Config$9, h as Config$6, hn as types_d_exports$3, ht as GameTypes, i as Config$1, it as NumericFields, k as Api$6, ln as State$4, m as Api$4, mn as State$2, mt as FeaturePlugin, n as BundleMap, nn as StoreApi, on as Config$4, ot as ProjectionSpec, p as types_d_exports$1, pt as EmitterIdOf, q as QueryTerm, qt as Root, r as BundleSpec, rn as RngApi, s as LoadBundles, sn as Events, t as Api, u as State$1, un as types_d_exports$8, ut as Api$2, vn as Require, vt as TextStylesOf, wt as type, xt as exit, yt as types_d_exports$5, z as ComponentType, zt as Config$7 } from "./types-Dy1xB68L.mjs";
 import { $ as SpriteValue, A as TextStyleInput, B as types_d_exports$6, C as Config$12, D as TextApi, E as State$11, F as Config$10, G as Display, H as InputApi, I as I18nApi, J as Parent, K as NineSlice, L as Message, M as TextValue, N as types_d_exports$13, O as TextBind, P as Argument, Q as SpriteOptions, R as State$9, S as BindOptions, T as Point, U as State$10, V as Config$11, W as types_d_exports$7, X as ShapeValue, Y as Shape, Z as Sprite, _ as Style, b as defineComponent, d as popup, et as Transform, f as defineTokens, g as ResolvedStyle, h as IsFlags, j as TextStyles, k as TextFormat, l as Box, nt as sprite, p as IntrinsicElementsFor, q as NineSliceValue, s as PopupComponent, tt as TransformValue, u as LocalWrite, w as CountdownValue, x as BindField, y as WhenFlags, z as TypedTr } from "./types-VErbiEXy.mjs";
-import { A as UiApi, C as spawned, D as wait, E as use, O as Config$14, S as spawn, T as tween, _ as parallel, a as State$12, b as set, c as HapticKind, d as HAPTIC_KINDS, f as defineAnimation, g as mark, h as haptic, i as MotionKeyframe, j as types_d_exports$15, k as State$13, l as SfxDescriptor, m as frames, n as Config$13, o as Target, p as external, r as FramesValue, s as types_d_exports, t as AnimApi, u as Step, v as play, w as stagger, x as sfx, y as sequence } from "./types-CVUHPvMB.mjs";
-import { A as FilterValueOf, C as EmitterValue, D as DisplacementValue, E as ColorMatrixValue, M as NoiseValue, N as OutlineValue, O as FilterComponent, P as UniformDeclaration, S as EmitterDefinition, T as BlurValue, _ as EffectsApi, b as types_d_exports$4, c as AnySceneProjection, d as SceneDefinition, f as SceneSpec, g as Config$16, h as types_d_exports$12, i as MusicOptions, j as GlowValue, k as FilterSpec, l as DefineScene, m as State$16, n as Config$15, o as State$14, p as ScenesApi, r as MusicDescriptor, s as types_d_exports$2, t as AudioApi, u as LayerMap, w as AlphaValue, x as EmitterConfig, y as State$15 } from "./types-BnWH-75b.mjs";
+import { A as haptic, B as tween, C as HapticKind, D as defineAnimation, E as HAPTIC_KINDS, F as set, G as UiApi, H as wait, I as sfx, K as types_d_exports$15, L as spawn, M as parallel, N as play, O as external, P as sequence, R as spawned, S as types_d_exports, T as Step, U as Config$15, V as use, W as State$15, _ as Config$13, b as State$12, c as AnySceneProjection, d as SceneDefinition, f as SceneSpec, g as AnimApi, h as types_d_exports$12, i as MusicOptions, j as mark, k as frames, l as DefineScene, m as State$14, n as Config$14, o as State$13, p as ScenesApi, r as MusicDescriptor, s as types_d_exports$2, t as AudioApi, u as LayerMap, v as FramesValue, w as SfxDescriptor, x as Target, y as MotionKeyframe, z as stagger } from "./types-C-4f2jD_.mjs";
+import { _ as NoiseValue, a as types_d_exports$4, c as EmitterValue, d as ColorMatrixValue, f as DisplacementValue, g as GlowValue, h as FilterValueOf, i as State$16, l as AlphaValue, m as FilterSpec, n as EffectsApi, o as EmitterConfig, p as FilterComponent, s as EmitterDefinition, t as Config$16, u as BlurValue, v as OutlineValue, y as UniformDeclaration } from "./types-w646dMeA.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -212,7 +212,7 @@ declare const assetsPlugin: import("@moku-labs/core").PluginInstance<"assets", C
  * });
  * ```
  */
-declare const audioPlugin: import("@moku-labs/core").PluginInstance<"audio", Config$15, State$14, AudioApi, {}> & Record<never, never>;
+declare const audioPlugin: import("@moku-labs/core").PluginInstance<"audio", Config$14, State$13, AudioApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/clock/index.d.ts
 /**
@@ -244,7 +244,7 @@ declare const clockPlugin: import("@moku-labs/core").PluginInstance<"clock", Con
  * app.effects.stats(); // { particles: 0, emitters: 0, filters: 0, renderPasses: 0 }: nothing runs before start
  * ```
  */
-declare const effectsPlugin: import("@moku-labs/core").PluginInstance<"effects", Config$16, State$15, EffectsApi, {}> & Record<never, never>;
+declare const effectsPlugin: import("@moku-labs/core").PluginInstance<"effects", Config$16, State$16, EffectsApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/flow/index.d.ts
 /**
@@ -552,7 +552,7 @@ declare const rendererPlugin: import("@moku-labs/core").PluginInstance<"renderer
  * export const awaitIntent = defineNode({ scene: "board", rest: true, outcomes: { merge: type() } });
  * ```
  */
-declare const scenesPlugin: import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$16, ScenesApi, {
+declare const scenesPlugin: import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$14, ScenesApi, {
   "scenes:changed": {
     from: string | undefined;
     to: string;
@@ -609,7 +609,7 @@ declare const timePlugin: import("@moku-labs/core").PluginInstance<"time", Confi
  * app.input.tap(app.ui.find("claim") ?? 0);
  * ```
  */
-declare const uiPlugin: import("@moku-labs/core").PluginInstance<"ui", Config$14, State$13, UiApi, {}> & Record<never, never>;
+declare const uiPlugin: import("@moku-labs/core").PluginInstance<"ui", Config$15, State$15, UiApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/world/index.d.ts
 /**
@@ -1396,7 +1396,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     rolledBackTo: string;
     retry: boolean;
   };
-}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>> | undefined) => import("@moku-labs/core").App<Config$9, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$7, State$7, Api$5, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$4, State$4, Api$3, {
+}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>, import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi> | import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>> | undefined) => import("@moku-labs/core").App<Config$9, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$7, State$7, Api$5, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$4, State$4, Api$3, {
   "lifecycle:changed": {
     reason: PauseReason;
     action: "push" | "pop";
@@ -1573,7 +1573,7 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     reason: "budget" | "request";
     keys: readonly string[];
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$16, ScenesApi, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$14, ScenesApi, {
   "scenes:changed": {
     from: string | undefined;
     to: string;
@@ -1591,6 +1591,6 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
   "i18n:locale-changed": {
     locale: string;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$14, State$13, UiApi, {}> & Record<never, never>];
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$15, State$15, UiApi, {}> & Record<never, never>];
 //#endregion
 export { Alpha, types_d_exports as Anim, 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, type DescriptionNode, Displacement, Display, Draggable, DropTarget, types_d_exports$4 as Effects, Emitter, Exiting, types_d_exports$5 as Flow, Frames, Glow, HAPTIC_KINDS, type HapticKind, Held, Hovered, types_d_exports$6 as I18n, types_d_exports$7 as Input, Layer, types_d_exports$8 as Lifecycle, LocalWrite, types_d_exports$9 as Model, NineSlice, Noise, Order, Outline, Parent, types_d_exports$10 as Platform, type PlatformProvider, Pointer, PointerOver, Pressable, Pressed, types_d_exports$11 as Renderer, SaveUnreadableError, types_d_exports$12 as Scenes, Shape, Sprite, Swipeable, Tappable, Text, type TextFormat, types_d_exports$13 as TextTypes, types_d_exports$14 as Time, Touchable, Traceable, Traced, Transform, Tree, types_d_exports$15 as Ui, types_d_exports$16 as World, animPlugin, assetsPlugin, audioPlugin, bind, clockPlugin, component, createApp, createPlugin, defineAnimation, defineBundles, defineComponent, defineEmitter, defineFeature, defineFilter, defineGame, defineMotion, defineScene, defineStyle, defineTextStyles, defineTokens, effectsPlugin, exit, external, flowPlugin, frames, guide, haptic, hint, i18nPlugin, inputPlugin, label, lifecyclePlugin, load, mark, 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/index.mjs

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
 import { a as enableDraftPatches, i as dropDrafts, o as finishDrafts, r as deepFreeze, s as openDrafts, t as memory } from "./memory-CvgdnsQO.mjs";
 import { c as findNode, d as slotNames, f as compact, i as servePaused, l as framePath, n as captureFrame, o as collectFlows, p as pushEntry, r as serveCaptures, s as describeGraph, t as cancelCaptures, u as graphHash } from "./capture-fpd83Mi5.mjs";
 import { A as system, C as Exiting, D as component, E as Tree, O as mut, S as sprite, T as Order, _ as Parent, a as visualOf$1, b as Transform, c as Text, d as defineTextStyles, f as label, g as NineSlice, h as Display, j as tag, k as resource, l as bind, m as textFor, n as fitScaleOf, o as visualRectOf, p as readStyle, r as samePose, s as Countdown, t as CONTENT, u as builtInStyles, v as Shape, w as Layer, x as componentsFor, y as Sprite } from "./visual-DUvvPPCt.mjs";
-import { n as isDev } from "./dev-B5p9_3fz.mjs";
+import { n as isDev } from "./dev-wKLgOw7c.mjs";
 import { n as flatten, r as defineComponent } from "./flatten-BkXuscAV.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common/browser";
 import { createCoreConfig } from "@moku-labs/core";
@@ -17033,6 +17033,7 @@ function createAudioApi(ctx) {
 			state.buses[checked].muted = on;
 			applyGain(state, checked);
 		},
+		muted: (bus) => state.buses[busOf(state, bus)].muted,
 		unlocked: () => state.unlocked,
 		journal: () => state.journal
 	};

package/dist/inspect.d.mts

@@ -1,9 +1,9 @@
 import { At as JournalEntry, H as EntitySnapshot, Ot as FlowGraph, R as ComponentSchema, U as FrameDiff, Ut as Api, f as Usage, gt as Position, j as Explained, k as Api$1, m as Api$2, t as Api$3, tn as Snapshot, w as RenderStats, x as Under } from "./types-Dy1xB68L.mjs";
 import { a as InputOf, c as Source, d as HeadlessApp, i as InputArguments, l as WatchApp, o as InputSchema, t as CheatEntry, u as WatchInput } from "./types-DtmFVCHf.mjs";
 import { c as UiNode } from "./types-VErbiEXy.mjs";
-import { A as UiApi } from "./types-CVUHPvMB.mjs";
+import { G as UiApi, a as SoundEntry, t as AudioApi } from "./types-C-4f2jD_.mjs";
 import { n as defineSource } from "./define-BKWjWgyQ.mjs";
-import { _ as EffectsApi, a as SoundEntry, t as AudioApi, v as EffectsStats } from "./types-BnWH-75b.mjs";
+import { n as EffectsApi, r as EffectsStats } from "./types-w646dMeA.mjs";
 
 //#region src/plugins/flow/doors/read.d.ts
 /**
@@ -97,6 +97,9 @@ declare const sources: Readonly<{
   }, readonly SoundEntry[], HeadlessApp & {
     readonly audio?: AudioApi;
   }>;
+  audioMuted: Source<{}, boolean, HeadlessApp & {
+    readonly audio?: AudioApi;
+  }>;
   effects: Source<{}, EffectsStats, HeadlessApp & {
     readonly effects?: EffectsApi;
   }>;

package/dist/inspect.mjs

@@ -1,3 +1,3 @@
 import { c as defineSource } from "./input-CK4nxBO1.mjs";
-import { n as read, r as watch, t as sources } from "./sources-CTGuY3Fe.mjs";
+import { n as read, r as watch, t as sources } from "./sources-DVWJ8nfr.mjs";
 export { defineSource, read, sources, watch };

package/dist/{run-C7O77UQR.mjs → run-D_R0oJ6g.mjs}

@@ -1,5 +1,5 @@
 import { a as sheetAlone, u as graphHash } from "./capture-fpd83Mi5.mjs";
-import { n as isDev, t as controlRefused } from "./dev-B5p9_3fz.mjs";
+import { n as isDev, r as notInstalled, t as controlRefused } from "./dev-wKLgOw7c.mjs";
 import { a as isProjectionTarget, i as recordCheat, o as readTarget, r as isTainted, s as defineCommand, t as inputOrEmpty } from "./input-CK4nxBO1.mjs";
 //#region src/plugins/flow/headless.ts
 const noPayload = null;
@@ -217,6 +217,40 @@ const reducedMotionCommand = defineCommand({
 	}
 });
 //#endregion
+//#region src/plugins/audio/control.ts
+/**
+* @file audio plugin — the audio command of the `/control` door: mute the whole game. Dev builds
+* only: the body starts with the inline dev guard, so a bundler `define` of `false` drops it, and
+* logs the `moku:dev` marker.
+*/
+/**
+* Mutes or unmutes the `master` bus, so music and sfx both go silent; the stored volumes stay.
+* Answers the flag as it is afterwards.
+*
+* @throws {Error} `[game] The command game.mute needs audioPlugin.` when the app has no `audioPlugin`.
+* @example
+* ```ts
+* // The editor's Sound switch silences the game while a level is checked.
+* (await run(app, commands.mute, { muted: true })).value; // true
+* ```
+*/
+const muteCommand = defineCommand({
+	id: "game.mute",
+	title: "Mute",
+	input: { muted: "boolean" },
+	effect: "cosmetic",
+	run: (app, { muted }) => {
+		if (typeof __MOKU_GAME_DEV__ === "undefined" || !__MOKU_GAME_DEV__) throw controlRefused();
+		if (app.audio === void 0) throw notInstalled("game.mute", "audioPlugin", "command");
+		app.log.debug("moku:dev", {
+			command: "game.mute",
+			muted
+		});
+		app.audio.mute("master", muted);
+		return app.audio.muted("master");
+	}
+});
+//#endregion
 //#region src/plugins/input/control.ts
 /**
 * @file input plugin — the input commands of the `/control` door: a drag from one view onto
@@ -1173,6 +1207,7 @@ const commands = Object.freeze({
 	reducedMotion: reducedMotionCommand,
 	fill: fillCommand,
 	timeScale: timeScaleCommand,
+	mute: muteCommand,
 	trace: traceCommand
 });
 //#endregion

package/dist/{sources-CTGuY3Fe.mjs → sources-DVWJ8nfr.mjs}

@@ -1,5 +1,5 @@
 import { i as scaleByFits, w as Layer } from "./visual-DUvvPPCt.mjs";
-import { r as notInstalled } from "./dev-B5p9_3fz.mjs";
+import { r as notInstalled } from "./dev-wKLgOw7c.mjs";
 import { c as defineSource, n as cheatsOf, o as readTarget, r as isTainted, t as inputOrEmpty } from "./input-CK4nxBO1.mjs";
 //#region src/plugins/flow/doors/read.ts
 /**
@@ -99,8 +99,8 @@ const assetsSource = defineSource({
 //#endregion
 //#region src/plugins/audio/inspect.ts
 /**
-* @file audio plugin — the audio source of the `/inspect` door: the journal of started sounds.
-* Production-safe: it only reads.
+* @file audio plugin — the audio sources of the `/inspect` door: the journal of started sounds
+* and the mute flag of the master bus. Production-safe: they only read.
 */
 /**
 * The sounds that started, oldest first: every sfx played and every music track begun, all of
@@ -125,6 +125,28 @@ const soundsSource = defineSource({
 		return last === void 0 ? entries : entries.slice(Math.max(0, entries.length - last));
 	}
 });
+/**
+* Whether the whole game is muted: the mute flag of the `master` bus. The `game.mute` command
+* writes it.
+*
+* @throws {Error} `[game] The source game.audioMuted needs audioPlugin.` when the app has no `audioPlugin`.
+* @example
+* ```ts
+* // The editor muted the game, and an e2e script checks the switch took.
+* await run(app, commands.mute, { muted: true });
+* read(app, sources.audioMuted); // true
+* ```
+*/
+const audioMutedSource = defineSource({
+	id: "game.audioMuted",
+	title: "Audio muted",
+	input: {},
+	changes: "frame",
+	read: (app) => {
+		if (app.audio === void 0) throw notInstalled("game.audioMuted", "audioPlugin");
+		return app.audio.muted("master");
+	}
+});
 //#endregion
 //#region src/plugins/effects/inspect.ts
 /**
@@ -717,6 +739,7 @@ const sources = Object.freeze({
 	locate: locateSource,
 	render: renderSource,
 	sounds: soundsSource,
+	audioMuted: audioMutedSource,
 	effects: effectsSource,
 	assets: assetsSource,
 	log: logSource,

package/dist/testing.d.mts

@@ -1,8 +1,8 @@
 import { $t as SaveDoc, Kt as Json, Qt as ProviderCall, Ut as Api$2, Zt as PlayerStateProvider, an as Api$3, k as Api$1, m as Api, pn as FakeClock } from "./types-Dy1xB68L.mjs";
 import { _ as stepFrames, a as InputOf, d as HeadlessApp, f as HeadlessGame, g as runRepro, h as createHeadless, m as ReproResult, p as Repro, r as ControlApp } from "./types-DtmFVCHf.mjs";
 import { H as InputApi } from "./types-VErbiEXy.mjs";
-import { A as UiApi, t as AnimApi } from "./types-CVUHPvMB.mjs";
-import { t as commands } from "./commands-DYO22lzi.mjs";
+import { G as UiApi, g as AnimApi } from "./types-C-4f2jD_.mjs";
+import { t as commands } from "./commands-C83eQ5B9.mjs";
 
 //#region src/plugins/clock/fake.d.ts
 /**

package/dist/testing.mjs

@@ -1,6 +1,6 @@
 import { n as saveOf, t as memory } from "./memory-CvgdnsQO.mjs";
-import { a as stepFrames, i as runRepro, n as commands, r as createHeadless, t as run } from "./run-C7O77UQR.mjs";
-import { n as read, t as sources } from "./sources-CTGuY3Fe.mjs";
+import { a as stepFrames, i as runRepro, n as commands, r as createHeadless, t as run } from "./run-D_R0oJ6g.mjs";
+import { n as read, t as sources } from "./sources-DVWJ8nfr.mjs";
 import { createBrandConsole } from "@moku-labs/common/cli";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";