@futdevpro/fsm-dynamo 1.16.31 → 1.16.33

package/build/_modules/game/_collections/audio-scale.util.d.ts

@@ -0,0 +1,57 @@
+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 declare class DyFM_AudioScale_Util {
+    /** Alapertelmezett hangero-arany (a skala maximumanak hanyada), ha nincs jobb ertek. */
+    static readonly defaultRatio: number;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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): number;
+    /**
+     * `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;
+    /**
+     * 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): number;
+    /** Egy `0..1` erteket a tartomanyba szorit. */
+    static clampUnit(value: number): number;
+    /**
+     * 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;
+}
+//# sourceMappingURL=audio-scale.util.d.ts.map

package/build/_modules/game/_collections/audio-scale.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-scale.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_collections/audio-scale.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAE/B,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAO;IAE3C;;;;OAIG;IACH,MAAM,CAAC,YAAY,IAAI,eAAe;IAOtC;;;OAGG;IACH,MAAM,CAAC,eAAe,IAAI,eAAe;IAOzC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,YAAY,GAAE,MAA0C,GACvD,MAAM;IAUT;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM;IAU7D;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,kBAAkB,GAAE,MAAU,GAC7B,MAAM;IAaT,+CAA+C;IAC/C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAYvC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAO1B"}

package/build/_modules/game/_collections/audio-scale.util.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioScale_Util = void 0;
+/**
+ * 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
+ * ```
+ */
+class DyFM_AudioScale_Util {
+    /** Alapertelmezett hangero-arany (a skala maximumanak hanyada), ha nincs jobb ertek. */
+    static defaultRatio = 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() {
+        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() {
+        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, scale, fallbackUnit = DyFM_AudioScale_Util.defaultRatio) {
+        const max = 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, scale) {
+        const max = this.getSafeMax(scale);
+        const safeUnit = typeof unit !== 'number' || Number.isNaN(unit)
+            ? 0
+            : this.clampUnit(unit);
+        const scaled = 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, scale, fallbackScaleValue = 0) {
+        if (typeof value !== 'number' || Number.isNaN(value)) {
+            const safeFallback = 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) {
+        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.
+     */
+    static getSafeMax(scale) {
+        if (!scale || typeof scale.max !== 'number' || Number.isNaN(scale.max) || scale.max <= 0) {
+            return 1;
+        }
+        return scale.max;
+    }
+}
+exports.DyFM_AudioScale_Util = DyFM_AudioScale_Util;
+//# sourceMappingURL=audio-scale.util.js.map

package/build/_modules/game/_collections/audio-scale.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-scale.util.js","sourceRoot":"","sources":["../../../../src/_modules/game/_collections/audio-scale.util.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;GAYG;AACH,MAAa,oBAAoB;IAE/B,wFAAwF;IACxF,MAAM,CAAU,YAAY,GAAW,GAAG,CAAC;IAE3C;;;;OAIG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO;YACL,GAAG,EAAE,CAAC;YACN,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO;YACL,GAAG,EAAE,GAAG;YACR,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CACX,KAAa,EACb,KAAsB,EACtB,eAAuB,oBAAoB,CAAC,YAAY;QAExD,MAAM,GAAG,GAAW,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,KAAsB;QAClD,MAAM,GAAG,GAAW,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAW,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACrE,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,GAAW,QAAQ,GAAG,GAAG,CAAC;QAEtC,OAAO,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,KAAa,EACb,KAAsB,EACtB,qBAA6B,CAAC;QAE9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,YAAY,GAAW,OAAO,kBAAkB,KAAK,QAAQ;mBAC9D,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC;gBACpC,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,CAAC,CAAC;YAEN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,SAAS,CAAC,KAAa;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,UAAU,CAAC,KAAsB;QAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;YACzF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC;IACnB,CAAC;;AA7GH,oDA8GC"}

package/build/_modules/game/_enums/audio-channel.enum.d.ts

@@ -1,9 +1,13 @@
 /**
- * A jatek-audio mixer csatornai.
+ * A jatek-audio mixer **klasszikus** csatorna-keszlete.
  *
- * A flotta NEGY jateka egymastol fuggetlenul ugyanezt a negy csatornat vezette be
- * (Prototyper: Room Cats / Cell Stage / Portalhold, plusz a Hero Coordinator) — ez az
- * enum a kanonikus nevezektan, amire mindegyik ratert.
+ * 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`).

package/build/_modules/game/_enums/audio-channel.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-channel.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB"}
+{"version":3,"file":"audio-channel.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB"}

package/build/_modules/game/_enums/audio-channel.enum.js

@@ -2,11 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_AudioChannel = void 0;
 /**
- * A jatek-audio mixer csatornai.
+ * A jatek-audio mixer **klasszikus** csatorna-keszlete.
  *
- * A flotta NEGY jateka egymastol fuggetlenul ugyanezt a negy csatornat vezette be
- * (Prototyper: Room Cats / Cell Stage / Portalhold, plusz a Hero Coordinator) — ez az
- * enum a kanonikus nevezektan, amire mindegyik ratert.
+ * 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`).

package/build/_modules/game/_enums/audio-channel.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio-channel.enum.js","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;GASG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;AACrB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}
+{"version":3,"file":"audio-channel.enum.js","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;GAaG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;AACrB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

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

@@ -0,0 +1,37 @@
+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;
+}
+//# sourceMappingURL=audio-mixer-config.interface.d.ts.map

package/build/_modules/game/_models/audio-mixer-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer-config.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer-config.interface.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB;IAErC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,2EAA2E;IAC3E,KAAK,EAAE,eAAe,CAAC;IAEvB,kHAAkH;IAClH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8GAA8G;IAC9G,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/build/_modules/game/_models/audio-mixer-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audio-mixer-config.interface.js.map

package/build/_modules/game/_models/audio-mixer-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer-config.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer-config.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,19 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=audio-mixer-state.interface.d.ts.map

package/build/_modules/game/_models/audio-mixer-state.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer-state.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer-state.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IAEpC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/build/_modules/game/_models/audio-mixer-state.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audio-mixer-state.interface.js.map

package/build/_modules/game/_models/audio-mixer-state.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer-state.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer-state.interface.ts"],"names":[],"mappings":""}

package/build/_modules/game/_models/audio-mixer.control-model.d.ts

@@ -0,0 +1,123 @@
+import { DyFM_AudioMixer_Config } from './audio-mixer-config.interface';
+import { DyFM_AudioMixer_Settings } from './audio-mixer-settings.interface';
+import { DyFM_AudioMixer_State } from './audio-mixer-state.interface';
+/**
+ * **Csatorna- es skala-agnosztikus** jatek-audio mixer: a projekt deklaralja a sajat
+ * csatornait es szamabrazolasat, a modell pedig kezeli az allapotot es kiszamolja az
+ * effektiv hangerot.
+ *
+ * **Miert letezik a `DyFM_AudioMixer_Util` (round-1) mellett:** az a util negy FIX csatornara
+ * (`music` / `ambience` / `effects`) es `0..1` skalara epul. Ez a Prototyper harom prototipusara
+ * igaz, de a **Hero Coordinator** csatornai `music` / `dialog` / `interface`, az ertekei pedig
+ * `0-100` egeszek. A fix alak ott csatorna-vesztessel es kotelezo adat-migracioval jarna.
+ * Ez a modell mindkettot kiszolgalja; a round-1 alak `createClassic()` presetkent tovabb el.
+ *
+ * **Rendereles-agnosztikus:** NINCS DOM, Web Audio, Angular vagy Node fuggese. A tenyleges
+ * lejatszas (HTMLAudioElement, Web Audio `GainNode`, vagy barmi mas) a fogyasztoe — ez a
+ * **modell + szamitas**.
+ *
+ * **Hasznalat (Hero Coordinator-stilus, 0-100 egesz):**
+ * ```typescript
+ * const mixer = DyFM_AudioMixer_ControlModel.createPercent(['music', 'dialog', 'interface'], {
+ *   music: 36, dialog: 84, interface: 68,
+ * }, 72);
+ *
+ * let state = mixer.merge(JSON.parse(localStorage.getItem('audio') ?? 'null'));
+ * gainNode.gain.value = mixer.getEffectiveVolume(state, 'interface'); // MINDIG 0..1
+ *
+ * state = mixer.withChannelVolume(state, 'music', 40); // a sajat skalajan adjuk meg
+ * localStorage.setItem('audio', JSON.stringify(state));
+ * ```
+ *
+ * **Hasznalat (Prototyper-stilus, 0..1):**
+ * ```typescript
+ * const mixer = DyFM_AudioMixer_ControlModel.createClassic();
+ * const state = DyFM_AudioMixer_ControlModel.fromClassicSettings(legacySettings);
+ * ```
+ */
+export declare class DyFM_AudioMixer_ControlModel {
+    /** A `master` fenntartott nev — nem lehet sima csatorna, mert minden csatornara szorzodik. */
+    static readonly masterChannel: string;
+    /** A validalt, sajat peldany-config (a hivo altal atadott objektumtol fuggetlen masolat). */
+    private readonly config;
+    /**
+     * A config validalasa **konstruktor-idoben** tortenik: egy elgepelt csatorna-nev vagy hianyzo
+     * skala igy a jatek inditasakor derul ki, nem hangleajatszas kozben.
+     */
+    constructor(config: DyFM_AudioMixer_Config);
+    /**
+     * A round-1 `DyFM_AudioMixer_Settings` alakjaval egyenerteku mixer (`music` / `ambience` /
+     * `effects`, `0..1` skala, 0.8 default). A Prototyper-stilusu fogyasztoknak.
+     */
+    static createClassic(): DyFM_AudioMixer_ControlModel;
+    /**
+     * `0-100` egesz skalaju mixer tetszoleges csatorna-keszlettel — a Hero Coordinator-stilusu
+     * fogyasztoknak, akik igy **adat-migracio nelkul** vehetik hasznalatba a bedrock modellt.
+     */
+    static createPercent(channels: string[], defaults?: Record<string, number>, defaultMaster?: number): DyFM_AudioMixer_ControlModel;
+    /** A round-1 fix alakot atalakitja a nyitott allapot-alakra (migracios hid). */
+    static fromClassicSettings(settings: DyFM_AudioMixer_Settings): DyFM_AudioMixer_State;
+    /**
+     * A nyitott allapot-alakot visszaalakitja a round-1 fix alakra (migracios hid visszafele).
+     *
+     * **Peldany-metodus**, mert a helyes konverziohoz ismerni kell a peldany skalajat: egy
+     * `0-100`-as allapotot igy is `0..1`-re normalizal, ahogy a round-1 alak varja. (Statikus
+     * valtozatban ez nemaan rossz erteket adna.)
+     *
+     * A klasszikus keszleten kivuli csatornak (pl. `dialog`) **elvesznek** — ez a round-1 alak
+     * korlatja, nem a konverzioe.
+     */
+    toClassicSettings(state: DyFM_AudioMixer_State): DyFM_AudioMixer_Settings;
+    /** A peldany configja (masolat — a mutalasa nem hat vissza a modellre). */
+    getConfig(): DyFM_AudioMixer_Config;
+    /** A deklaralt csatorna-nevek (a `master` nelkul). */
+    getChannels(): string[];
+    /** Igaz, ha a nev a deklaralt csatornak kozott van (a `master` NEM az). */
+    hasChannel(channel: string): boolean;
+    /**
+     * Alapertelmezett allapot a **sajat skalan**. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa.
+     */
+    getDefaults(): DyFM_AudioMixer_State;
+    /**
+     * Reszleges / hianyzo / serult allapotbol teljes, ervenyes allapotot allit elo: a hianyzo
+     * csatornak a defaultot kapjak, az ertekek a sajat skalara szorulnak.
+     *
+     * **Ez a migracios biztositek:** egy regi payload, ami meg nem ismert egy kesobb bevezetett
+     * csatornat, igy is betoltheto marad. A **nem deklaralt** csatornak kiesnek — igy egy
+     * eltavolitott csatorna nem szivarog vissza a mentesbol. Serult (NaN / nem-szam) ertek eseten
+     * a csatorna DEFAULT-jat kapja, nem 0-t — egy hibas mentes ne nemitson el csendben.
+     *
+     * **Figyelem:** ez a nyitott (`channels` rekord) alakot varja. A round-1 LAPOS alakot
+     * (`{ master, music, ambience, effects, muted }`) eloszor a `fromClassicSettings()`-szel
+     * kell atalakitani — kulonben a csatornak a defaultot kapjak.
+     */
+    merge(partial?: Partial<DyFM_AudioMixer_State> | null): DyFM_AudioMixer_State;
+    /**
+     * Egy csatorna **effektiv** hangereje `0..1`-ben — ezt varja a `HTMLAudioElement.volume` es a
+     * Web Audio `GainNode.gain.value`, fuggetlenul attol, milyen skalan tarol a projekt.
+     *
+     * A csatorna sajat erteke szorozva a master-rel; nemitas eseten mindig 0. A `'master'` nevre
+     * a master sajat (normalizalt) erteket adja vissza, nem negyzetre emelve.
+     *
+     * **Dob**, ha a csatorna nincs deklaralva — egy elgepelt csatorna-nev igy nem nemul el
+     * csendben, hanem azonnal kiderul (`core-rich-error-handling`).
+     */
+    getEffectiveVolume(state: DyFM_AudioMixer_State, channel: string): number;
+    /**
+     * Egy csatorna hangerejenek beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza
+     * (immutable update), hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    withChannelVolume(state: DyFM_AudioMixer_State, channel: string, volume: number): DyFM_AudioMixer_State;
+    /** A master beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza. */
+    withMasterVolume(state: DyFM_AudioMixer_State, volume: number): DyFM_AudioMixer_State;
+    /** Nemitas beallitasa — UJ allapot-objektumot ad vissza. */
+    withMuted(state: DyFM_AudioMixer_State, muted: boolean): DyFM_AudioMixer_State;
+    /** Ket allapot ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    isEqual(a: DyFM_AudioMixer_State, b: DyFM_AudioMixer_State): boolean;
+    /** A master alapertelmezese a sajat skalan (config, kulonben a maximum 80%-a). */
+    private getDefaultMaster;
+    /** Egy csatorna alapertelmezese a sajat skalan (per-csatorna, kulonben kozos, kulonben 80%). */
+    private getDefaultChannelVolume;
+}
+//# sourceMappingURL=audio-mixer.control-model.d.ts.map

package/build/_modules/game/_models/audio-mixer.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer.control-model.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,4BAA4B;IAEvC,8FAA8F;IAC9F,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAY;IAEjD,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD;;;OAGG;gBACS,MAAM,EAAE,sBAAsB;IAoD1C;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,4BAA4B;IASpD;;;OAGG;IACH,MAAM,CAAC,aAAa,CAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,4BAA4B;IAS/B,gFAAgF;IAChF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,qBAAqB;IAerF;;;;;;;;;OASG;IACH,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB;IAazE,2EAA2E;IAC3E,SAAS,IAAI,sBAAsB;IAUnC,sDAAsD;IACtD,WAAW,IAAI,MAAM,EAAE;IAIvB,2EAA2E;IAC3E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACH,WAAW,IAAI,qBAAqB;IAcpC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,GAAG,qBAAqB;IA6B7E;;;;;;;;;OASG;IACH,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA0BzE;;;OAGG;IACH,iBAAiB,CACf,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,qBAAqB;IAexB,gFAAgF;IAChF,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAOrF,4DAA4D;IAC5D,SAAS,CAAC,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,GAAG,qBAAqB;IAO9E,0FAA0F;IAC1F,OAAO,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,qBAAqB,GAAG,OAAO;IAiBpE,kFAAkF;IAClF,OAAO,CAAC,gBAAgB;IAQxB,gGAAgG;IAChG,OAAO,CAAC,uBAAuB;CAchC"}