@futdevpro/fsm-dynamo 1.16.38 → 1.16.40

package/src/_modules/game/_collections/audio-scale.util.ts

@@ -1,129 +1,129 @@
-
-
-import { DyFM_AudioScale } from '../_models/audio-scale.interface';
-
-
-/**
- * Skala-konverziok az audio-mixerhez: a projekt sajat szamabrazolasa (pl. `0-100` egesz)
- * es a lejatszo API-k altal vart `0..1` kozott.
- *
- * **Miert statikus util:** nincs allapota — tiszta fuggvenyek, a `DyFM_Math` mintajara.
- *
- * **Hasznalat:**
- * ```typescript
- * const percent = DyFM_AudioScale_Util.getPercentScale();
- * DyFM_AudioScale_Util.toUnit(72, percent);      // 0.72  -> ezt varja a HTMLAudio / GainNode
- * DyFM_AudioScale_Util.fromUnit(0.725, percent); // 73    -> ezt tarolja / mutatja a projekt
- * ```
- */
-export class DyFM_AudioScale_Util {
-
-  /** Alapertelmezett hangero-arany (a skala maximumanak hanyada), ha nincs jobb ertek. */
-  static readonly defaultRatio: number = 0.8;
-
-  /**
-   * A `0..1` lebegopontos skala — a Prototyper prototipusai (es a round-1
-   * `DyFM_AudioMixer_Settings`) ezt hasznaljak. Minden hivas UJ objektumot ad vissza, hogy a
-   * hivo szabadon mutalhassa.
-   */
-  static getUnitScale(): DyFM_AudioScale {
-    return {
-      max: 1,
-      integer: false,
-    };
-  }
-
-  /**
-   * A `0-100` egesz skala — a Hero Coordinator ezt tarolja a localStorage-ban
-   * (`clampVolume` = `Math.round`). Minden hivas UJ objektumot ad vissza.
-   */
-  static getPercentScale(): DyFM_AudioScale {
-    return {
-      max: 100,
-      integer: true,
-    };
-  }
-
-  /**
-   * Sajat skalan levo erteket `0..1`-re normalizal, es a tartomanyba szorit.
-   * Ervenytelen bemenet (NaN, nem-szam, null/undefined) eseten a `fallbackUnit`-ot adja —
-   * igy egy serult save-payload sem tud NaN-t juttatni a lejatszoba
-   * (`HTMLAudioElement.volume = NaN` dobna, a `GainNode.gain.value = NaN` elnemitana).
-   */
-  static toUnit(
-    value: number,
-    scale: DyFM_AudioScale,
-    fallbackUnit: number = DyFM_AudioScale_Util.defaultRatio,
-  ): number {
-    const max: number = this.getSafeMax(scale);
-
-    if (typeof value !== 'number' || Number.isNaN(value)) {
-      return this.clampUnit(fallbackUnit);
-    }
-
-    return this.clampUnit(value / max);
-  }
-
-  /**
-   * `0..1` erteket a sajat skalara alakit vissza. Egesz skalanal (`integer: true`) kerekit,
-   * igy a `0-100`-as UI-nak nem kell tortszamokkal dolgoznia.
-   */
-  static fromUnit(unit: number, scale: DyFM_AudioScale): number {
-    const max: number = this.getSafeMax(scale);
-    const safeUnit: number = typeof unit !== 'number' || Number.isNaN(unit)
-      ? 0
-      : this.clampUnit(unit);
-    const scaled: number = safeUnit * max;
-
-    return scale && scale.integer === true ? Math.round(scaled) : scaled;
-  }
-
-  /**
-   * Egy erteket a sajat skala `0..max` tartomanyaba szorit (egesz skalanal kerekit is).
-   *
-   * Ervenytelen bemenetre (NaN, nem-szam) a `fallbackScaleValue`-t adja — **a sajat skalan**.
-   * Alapertelmezesben `0`; a mixer viszont a csatorna DEFAULT-jat adja at, mert egy serult
-   * mentesbol jobb a hallhato alapertek, mint a nema 0 (a felhasznalo eszre sem venne).
-   */
-  static clampToScale(
-    value: number,
-    scale: DyFM_AudioScale,
-    fallbackScaleValue: number = 0,
-  ): number {
-    if (typeof value !== 'number' || Number.isNaN(value)) {
-      const safeFallback: number = typeof fallbackScaleValue === 'number'
-        && !Number.isNaN(fallbackScaleValue)
-        ? fallbackScaleValue
-        : 0;
-
-      return this.fromUnit(this.toUnit(safeFallback, scale, 0), scale);
-    }
-
-    return this.fromUnit(this.toUnit(value, scale, 0), scale);
-  }
-
-  /** Egy `0..1` erteket a tartomanyba szorit. */
-  static clampUnit(value: number): number {
-    if (typeof value !== 'number' || Number.isNaN(value)) {
-      return 0;
-    }
-
-    if (value < 0) {
-      return 0;
-    }
-
-    return 1 < value ? 1 : value;
-  }
-
-  /**
-   * A skala maximuma vedve: a hianyzo / nem-pozitiv / NaN maximumot `1`-re cseréli, hogy a
-   * nullaval valo osztas es a NaN-terjedes kizart legyen.
-   */
-  private static getSafeMax(scale: DyFM_AudioScale): number {
-    if (!scale || typeof scale.max !== 'number' || Number.isNaN(scale.max) || scale.max <= 0) {
-      return 1;
-    }
-
-    return scale.max;
-  }
-}
+
+
+import { DyFM_AudioScale } from '../_models/audio-scale.interface';
+
+
+/**
+ * Skala-konverziok az audio-mixerhez: a projekt sajat szamabrazolasa (pl. `0-100` egesz)
+ * es a lejatszo API-k altal vart `0..1` kozott.
+ *
+ * **Miert statikus util:** nincs allapota — tiszta fuggvenyek, a `DyFM_Math` mintajara.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const percent = DyFM_AudioScale_Util.getPercentScale();
+ * DyFM_AudioScale_Util.toUnit(72, percent);      // 0.72  -> ezt varja a HTMLAudio / GainNode
+ * DyFM_AudioScale_Util.fromUnit(0.725, percent); // 73    -> ezt tarolja / mutatja a projekt
+ * ```
+ */
+export class DyFM_AudioScale_Util {
+
+  /** Alapertelmezett hangero-arany (a skala maximumanak hanyada), ha nincs jobb ertek. */
+  static readonly defaultRatio: number = 0.8;
+
+  /**
+   * A `0..1` lebegopontos skala — a Prototyper prototipusai (es a round-1
+   * `DyFM_AudioMixer_Settings`) ezt hasznaljak. Minden hivas UJ objektumot ad vissza, hogy a
+   * hivo szabadon mutalhassa.
+   */
+  static getUnitScale(): DyFM_AudioScale {
+    return {
+      max: 1,
+      integer: false,
+    };
+  }
+
+  /**
+   * A `0-100` egesz skala — a Hero Coordinator ezt tarolja a localStorage-ban
+   * (`clampVolume` = `Math.round`). Minden hivas UJ objektumot ad vissza.
+   */
+  static getPercentScale(): DyFM_AudioScale {
+    return {
+      max: 100,
+      integer: true,
+    };
+  }
+
+  /**
+   * Sajat skalan levo erteket `0..1`-re normalizal, es a tartomanyba szorit.
+   * Ervenytelen bemenet (NaN, nem-szam, null/undefined) eseten a `fallbackUnit`-ot adja —
+   * igy egy serult save-payload sem tud NaN-t juttatni a lejatszoba
+   * (`HTMLAudioElement.volume = NaN` dobna, a `GainNode.gain.value = NaN` elnemitana).
+   */
+  static toUnit(
+    value: number,
+    scale: DyFM_AudioScale,
+    fallbackUnit: number = DyFM_AudioScale_Util.defaultRatio,
+  ): number {
+    const max: number = this.getSafeMax(scale);
+
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+      return this.clampUnit(fallbackUnit);
+    }
+
+    return this.clampUnit(value / max);
+  }
+
+  /**
+   * `0..1` erteket a sajat skalara alakit vissza. Egesz skalanal (`integer: true`) kerekit,
+   * igy a `0-100`-as UI-nak nem kell tortszamokkal dolgoznia.
+   */
+  static fromUnit(unit: number, scale: DyFM_AudioScale): number {
+    const max: number = this.getSafeMax(scale);
+    const safeUnit: number = typeof unit !== 'number' || Number.isNaN(unit)
+      ? 0
+      : this.clampUnit(unit);
+    const scaled: number = safeUnit * max;
+
+    return scale && scale.integer === true ? Math.round(scaled) : scaled;
+  }
+
+  /**
+   * Egy erteket a sajat skala `0..max` tartomanyaba szorit (egesz skalanal kerekit is).
+   *
+   * Ervenytelen bemenetre (NaN, nem-szam) a `fallbackScaleValue`-t adja — **a sajat skalan**.
+   * Alapertelmezesben `0`; a mixer viszont a csatorna DEFAULT-jat adja at, mert egy serult
+   * mentesbol jobb a hallhato alapertek, mint a nema 0 (a felhasznalo eszre sem venne).
+   */
+  static clampToScale(
+    value: number,
+    scale: DyFM_AudioScale,
+    fallbackScaleValue: number = 0,
+  ): number {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+      const safeFallback: number = typeof fallbackScaleValue === 'number'
+        && !Number.isNaN(fallbackScaleValue)
+        ? fallbackScaleValue
+        : 0;
+
+      return this.fromUnit(this.toUnit(safeFallback, scale, 0), scale);
+    }
+
+    return this.fromUnit(this.toUnit(value, scale, 0), scale);
+  }
+
+  /** Egy `0..1` erteket a tartomanyba szorit. */
+  static clampUnit(value: number): number {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+      return 0;
+    }
+
+    if (value < 0) {
+      return 0;
+    }
+
+    return 1 < value ? 1 : value;
+  }
+
+  /**
+   * A skala maximuma vedve: a hianyzo / nem-pozitiv / NaN maximumot `1`-re cseréli, hogy a
+   * nullaval valo osztas es a NaN-terjedes kizart legyen.
+   */
+  private static getSafeMax(scale: DyFM_AudioScale): number {
+    if (!scale || typeof scale.max !== 'number' || Number.isNaN(scale.max) || scale.max <= 0) {
+      return 1;
+    }
+
+    return scale.max;
+  }
+}

package/src/_modules/game/_enums/audio-channel.enum.ts

@@ -1,22 +1,22 @@
-
-
-/**
- * A jatek-audio mixer **klasszikus** csatorna-keszlete.
- *
- * A Prototyper HAROM prototipusa (Room Cats / Cell Stage / Portalhold) egymastol fuggetlenul
- * ugyanezt a negy csatornat vezette be — ez az enum az o kanonikus nevezektanuk.
- *
- * **FIGYELEM (2026-08-06 helyesbites):** ez NEM flotta-univerzalis. A **Hero Coordinator**
- * csatornai `master` / `music` / **`dialog`** / **`interface`**, es `0-100` egeszet tarol.
- * Ha a projekted csatorna-keszlete elter, NE ezt az enumot hasznald, hanem a
- * `DyFM_AudioMixer_ControlModel`-t sajat config-gal (csatorna- es skala-agnosztikus).
- *
- * A `master` NEM onallo hangsav: minden csatorna effektiv hangereje a sajat erteke
- * SZOROZVA a master-rel (lasd `DyFM_AudioMixer_Util.getEffectiveVolume`).
- */
-export enum DyFM_AudioChannel {
-  master = 'master',
-  music = 'music',
-  ambience = 'ambience',
-  effects = 'effects',
-}
+
+
+/**
+ * A jatek-audio mixer **klasszikus** csatorna-keszlete.
+ *
+ * A Prototyper HAROM prototipusa (Room Cats / Cell Stage / Portalhold) egymastol fuggetlenul
+ * ugyanezt a negy csatornat vezette be — ez az enum az o kanonikus nevezektanuk.
+ *
+ * **FIGYELEM (2026-08-06 helyesbites):** ez NEM flotta-univerzalis. A **Hero Coordinator**
+ * csatornai `master` / `music` / **`dialog`** / **`interface`**, es `0-100` egeszet tarol.
+ * Ha a projekted csatorna-keszlete elter, NE ezt az enumot hasznald, hanem a
+ * `DyFM_AudioMixer_ControlModel`-t sajat config-gal (csatorna- es skala-agnosztikus).
+ *
+ * A `master` NEM onallo hangsav: minden csatorna effektiv hangereje a sajat erteke
+ * SZOROZVA a master-rel (lasd `DyFM_AudioMixer_Util.getEffectiveVolume`).
+ */
+export enum DyFM_AudioChannel {
+  master = 'master',
+  music = 'music',
+  ambience = 'ambience',
+  effects = 'effects',
+}

package/src/_modules/game/_models/audio-mixer-config.interface.ts

@@ -1,53 +1,53 @@
-
-
-import { DyFM_AudioScale } from './audio-scale.interface';
-
-
-/**
- * Egy jatek audio-mixerenek **deklaracioja**: milyen csatornai vannak, milyen skalan, es mik
- * az alapertelmezesek.
- *
- * **Miert nem fix csatorna-keszlet:** a `DyFM_AudioMixer_Settings` (round-1) negy fix mezot ad
- * (`music` / `ambience` / `effects`), ami a Prototyper harom prototipusara igaz — de a Hero
- * Coordinator csatornai `music` / `dialog` / `interface`. Egy fix alak ott csatorna-vesztessel
- * jarna. A config-alapu modell mindkettot kiszolgalja, es a projekt sajat csatorna-enumja
- * marad a nevek forrasa.
- *
- * **A `master` nem szerepel a `channels` listaban** — kulon kezelt, mert minden csatornara
- * szorzodik.
- *
- * **Hasznalat:**
- * ```typescript
- * const mixer = new DyFM_AudioMixer_ControlModel({
- *   channels: ['music', 'dialog', 'interface'],
- *   scale: DyFM_AudioScale_Util.getPercentScale(),
- *   defaults: { music: 36, dialog: 84, interface: 68 },
- *   defaultMaster: 72,
- * });
- * ```
- */
-export interface DyFM_AudioMixer_Config {
-
-  /** A projekt sajat csatorna-nevei. A `master` NEM tartozik ide (kulon kezelt). */
-  channels: string[];
-
-  /** A csatorna-ertekek skalaja (`unit` = 0..1, `percent` = 0-100 egesz). */
-  scale: DyFM_AudioScale;
-
-  /** Alapertelmezett csatorna-ertekek a **sajat skalan**. A fel nem soroltak a `defaultChannelVolume`-ot kapjak. */
-  defaults?: Record<string, number>;
-
-  /** Alapertelmezett master-ertek a **sajat skalan**. Default: a skala maximumanak 80%-a. */
-  defaultMaster?: number;
-
-  /** Alapertelmezes a `defaults`-ban fel nem sorolt csatornakra (**sajat skala**). Default: a maximum 80%-a. */
-  defaultChannelVolume?: number;
-
-  /**
-   * Szoljon-e a hang alapbol akkor is, ha a tab/ablak nem aktiv. **Default: `false`**
-   * (owner-direktiva — a hatter-hang opt-in, sosem opt-out).
-   *
-   * Csak nagyon indokolt esetben allitsd `true`-ra (pl. tisztan audio-jatek).
-   */
-  defaultPlayWhenUnfocused?: boolean;
-}
+
+
+import { DyFM_AudioScale } from './audio-scale.interface';
+
+
+/**
+ * Egy jatek audio-mixerenek **deklaracioja**: milyen csatornai vannak, milyen skalan, es mik
+ * az alapertelmezesek.
+ *
+ * **Miert nem fix csatorna-keszlet:** a `DyFM_AudioMixer_Settings` (round-1) negy fix mezot ad
+ * (`music` / `ambience` / `effects`), ami a Prototyper harom prototipusara igaz — de a Hero
+ * Coordinator csatornai `music` / `dialog` / `interface`. Egy fix alak ott csatorna-vesztessel
+ * jarna. A config-alapu modell mindkettot kiszolgalja, es a projekt sajat csatorna-enumja
+ * marad a nevek forrasa.
+ *
+ * **A `master` nem szerepel a `channels` listaban** — kulon kezelt, mert minden csatornara
+ * szorzodik.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const mixer = new DyFM_AudioMixer_ControlModel({
+ *   channels: ['music', 'dialog', 'interface'],
+ *   scale: DyFM_AudioScale_Util.getPercentScale(),
+ *   defaults: { music: 36, dialog: 84, interface: 68 },
+ *   defaultMaster: 72,
+ * });
+ * ```
+ */
+export interface DyFM_AudioMixer_Config {
+
+  /** A projekt sajat csatorna-nevei. A `master` NEM tartozik ide (kulon kezelt). */
+  channels: string[];
+
+  /** A csatorna-ertekek skalaja (`unit` = 0..1, `percent` = 0-100 egesz). */
+  scale: DyFM_AudioScale;
+
+  /** Alapertelmezett csatorna-ertekek a **sajat skalan**. A fel nem soroltak a `defaultChannelVolume`-ot kapjak. */
+  defaults?: Record<string, number>;
+
+  /** Alapertelmezett master-ertek a **sajat skalan**. Default: a skala maximumanak 80%-a. */
+  defaultMaster?: number;
+
+  /** Alapertelmezes a `defaults`-ban fel nem sorolt csatornakra (**sajat skala**). Default: a maximum 80%-a. */
+  defaultChannelVolume?: number;
+
+  /**
+   * Szoljon-e a hang alapbol akkor is, ha a tab/ablak nem aktiv. **Default: `false`**
+   * (owner-direktiva — a hatter-hang opt-in, sosem opt-out).
+   *
+   * Csak nagyon indokolt esetben allitsd `true`-ra (pl. tisztan audio-jatek).
+   */
+  defaultPlayWhenUnfocused?: boolean;
+}

package/src/_modules/game/_models/audio-mixer-settings.interface.ts

@@ -1,38 +1,38 @@
-
-
-/**
- * A jatek-audio mixer beallitasai — csatornankent 0..1 hangero + globalis nemitas.
- *
- * **Miert bedrock:** ez az interfesz a flottaban NEGY helyen elt egymastol fuggetlenul,
- * karakterre azonos alakban (`pcr-audio-settings.interface.ts`, `pcs-audio-settings.interface.ts`,
- * `pg-audio-settings.interface.ts` + a Hero Coordinator sajat audio-service-e). Ez a kanonikus alak.
- *
- * **Mentheto:** tisztan JSON-serializalhato, tehat a jatek save-payload resze lehet.
- * Reszleges/legacy payload-bol a `DyFM_AudioMixer_Util.merge()` allit elo teljes settingset.
- */
-export interface DyFM_AudioMixer_Settings {
-  /** Fo-hangero (0..1) — minden csatornara szorzodik. */
-  master: number;
-
-  /** Zene-csatorna hangereje (0..1). */
-  music: number;
-
-  /** Kornyezeti hangok (ambience) csatorna hangereje (0..1). */
-  ambience: number;
-
-  /** Effekt-hangok csatorna hangereje (0..1). */
-  effects: number;
-
-  /** Globalis nemitas — ha true, minden effektiv hangero 0. */
-  muted: boolean;
-
-  /**
-   * Szoljon-e a hang, ha a tab/ablak nem aktiv. **Default: `false`.**
-   *
-   * **OPCIONALIS** — szandekosan, hogy a mezo bevezetese ne legyen torо valtozas a round-1
-   * alakot mar hasznalo projekteknek. A letezese viszont azt biztositja, hogy a klasszikus
-   * oda-vissza konverzio (`toClassicSettings` -> `fromClassicSettings`) NE veszitse el a
-   * kapcsolot.
-   */
-  playWhenUnfocused?: boolean;
-}
+
+
+/**
+ * A jatek-audio mixer beallitasai — csatornankent 0..1 hangero + globalis nemitas.
+ *
+ * **Miert bedrock:** ez az interfesz a flottaban NEGY helyen elt egymastol fuggetlenul,
+ * karakterre azonos alakban (`pcr-audio-settings.interface.ts`, `pcs-audio-settings.interface.ts`,
+ * `pg-audio-settings.interface.ts` + a Hero Coordinator sajat audio-service-e). Ez a kanonikus alak.
+ *
+ * **Mentheto:** tisztan JSON-serializalhato, tehat a jatek save-payload resze lehet.
+ * Reszleges/legacy payload-bol a `DyFM_AudioMixer_Util.merge()` allit elo teljes settingset.
+ */
+export interface DyFM_AudioMixer_Settings {
+  /** Fo-hangero (0..1) — minden csatornara szorzodik. */
+  master: number;
+
+  /** Zene-csatorna hangereje (0..1). */
+  music: number;
+
+  /** Kornyezeti hangok (ambience) csatorna hangereje (0..1). */
+  ambience: number;
+
+  /** Effekt-hangok csatorna hangereje (0..1). */
+  effects: number;
+
+  /** Globalis nemitas — ha true, minden effektiv hangero 0. */
+  muted: boolean;
+
+  /**
+   * Szoljon-e a hang, ha a tab/ablak nem aktiv. **Default: `false`.**
+   *
+   * **OPCIONALIS** — szandekosan, hogy a mezo bevezetese ne legyen torо valtozas a round-1
+   * alakot mar hasznalo projekteknek. A letezese viszont azt biztositja, hogy a klasszikus
+   * oda-vissza konverzio (`toClassicSettings` -> `fromClassicSettings`) NE veszitse el a
+   * kapcsolot.
+   */
+  playWhenUnfocused?: boolean;
+}

package/src/_modules/game/_models/audio-mixer-state.interface.ts

@@ -1,36 +1,36 @@
-
-
-/**
- * Egy audio-mixer **allapota** — a projekt sajat skalajan tarolva, JSON-serializalhatoan.
- *
- * A `channels` nyitott rekord: a kulcsok a `DyFM_AudioMixer_Config.channels` nevei. Igy egy
- * jatek annyi es olyan nevu csatornat hasznalhat, amennyit akar, a bedrock-modell valtoztatasa
- * nelkul.
- *
- * **Mentheto:** ez az alak kerulhet kozvetlenul a save-payloadba vagy a localStorage-ba.
- * Hianyos/regi payloadbol a `DyFM_AudioMixer_ControlModel.merge()` allit elo teljes allapotot.
- */
-export interface DyFM_AudioMixer_State {
-
-  /** Fo-hangero a **sajat skalan** — minden csatornara szorzodik. */
-  master: number;
-
-  /** Csatorna-nev -> hangero a **sajat skalan**. */
-  channels: Record<string, number>;
-
-  /** Globalis nemitas — ha `true`, minden effektiv hangero 0. */
-  muted: boolean;
-
-  /**
-   * Szoljon-e a hang akkor is, ha a **tab / ablak NEM aktiv** (hattervben van).
-   *
-   * **Alapertelmezes: `false`** — owner-direktiva. Egy hattervbe tett jatek alapbol NE szoljon
-   * bele a felhasznalo mas munkajaba; aki ezt akarja, az kapcsolja be. Ez a mezo CSAK a
-   * szandekot hordozza — a tenyleges szuneteltetest a lejatszo-reteg vegzi (bongeszo-fuggo
-   * `visibilitychange` / `blur`), mert a modell-reteg szandekosan DOM-fuggetlen.
-   *
-   * **Migracio:** a mezo nelkuli (regi) mentesek a `merge()`-ben a config alapertelmezeset
-   * kapjak, tehat egy regi save betoltese nem kapcsolja be veletlenul a hatter-hangot.
-   */
-  playWhenUnfocused: boolean;
-}
+
+
+/**
+ * Egy audio-mixer **allapota** — a projekt sajat skalajan tarolva, JSON-serializalhatoan.
+ *
+ * A `channels` nyitott rekord: a kulcsok a `DyFM_AudioMixer_Config.channels` nevei. Igy egy
+ * jatek annyi es olyan nevu csatornat hasznalhat, amennyit akar, a bedrock-modell valtoztatasa
+ * nelkul.
+ *
+ * **Mentheto:** ez az alak kerulhet kozvetlenul a save-payloadba vagy a localStorage-ba.
+ * Hianyos/regi payloadbol a `DyFM_AudioMixer_ControlModel.merge()` allit elo teljes allapotot.
+ */
+export interface DyFM_AudioMixer_State {
+
+  /** Fo-hangero a **sajat skalan** — minden csatornara szorzodik. */
+  master: number;
+
+  /** Csatorna-nev -> hangero a **sajat skalan**. */
+  channels: Record<string, number>;
+
+  /** Globalis nemitas — ha `true`, minden effektiv hangero 0. */
+  muted: boolean;
+
+  /**
+   * Szoljon-e a hang akkor is, ha a **tab / ablak NEM aktiv** (hattervben van).
+   *
+   * **Alapertelmezes: `false`** — owner-direktiva. Egy hattervbe tett jatek alapbol NE szoljon
+   * bele a felhasznalo mas munkajaba; aki ezt akarja, az kapcsolja be. Ez a mezo CSAK a
+   * szandekot hordozza — a tenyleges szuneteltetest a lejatszo-reteg vegzi (bongeszo-fuggo
+   * `visibilitychange` / `blur`), mert a modell-reteg szandekosan DOM-fuggetlen.
+   *
+   * **Migracio:** a mezo nelkuli (regi) mentesek a `merge()`-ben a config alapertelmezeset
+   * kapjak, tehat egy regi save betoltese nem kapcsolja be veletlenul a hatter-hangot.
+   */
+  playWhenUnfocused: boolean;
+}