@futdevpro/fsm-dynamo 1.16.39 → 1.16.40

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

@@ -1,114 +1,114 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_AudioMixer_Util = void 0;
-const audio_channel_enum_1 = require("../_enums/audio-channel.enum");
-/**
- * Statikus util a jatek-audio mixer beallitasaihoz.
- *
- * Rendereles-agnosztikus es platform-fuggetlen: NINCS benne DOM, Web Audio, Angular vagy Node
- * fuggoseg — a tenyleges lejatszast az `@futdevpro/ngx-dynamo` game-modulja (vagy a projekt sajat
- * motorja) vegzi, ez csak a **modell + szamitas**.
- *
- * **Hasznalat:**
- * ```typescript
- * const settings: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(loadedFromSave);
- * const volume: number = DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.music);
- * audioElement.volume = volume;
- * ```
- */
-class DyFM_AudioMixer_Util {
-    /** Alapertelmezett hangero minden csatornara (0..1). */
-    static defaultVolume = 0.8;
-    /**
-     * Az alapertelmezett mixer-beallitas. Minden hivas UJ objektumot ad vissza, hogy a
-     * hivo szabadon mutalhassa (nincs megosztott referencia).
-     */
-    static getDefaults() {
-        return {
-            master: this.defaultVolume,
-            music: this.defaultVolume,
-            ambience: this.defaultVolume,
-            effects: this.defaultVolume,
-            muted: false,
-        };
-    }
-    /**
-     * Egy hangero-erteket a 0..1 tartomanyba szorit. A nem-szamokat (NaN, undefined, null,
-     * nem-szam tipus) a `fallback`-re cseréli — igy egy serult save-payload sem tud NaN-t
-     * juttatni a lejatszoba (a `HTMLAudioElement.volume = NaN` dobna).
-     */
-    static clamp(value, fallback = DyFM_AudioMixer_Util.defaultVolume) {
-        if (typeof value !== 'number' || Number.isNaN(value)) {
-            return fallback;
-        }
-        if (value < 0) {
-            return 0;
-        }
-        if (1 < value) {
-            return 1;
-        }
-        return value;
-    }
-    /**
-     * Reszleges (vagy hianyzo) beallitas-objektumbol teljes, ervenyes settingset allit elo:
-     * a hianyzo mezoket a defaultbol veszi, a meglevoket 0..1-re szoritja.
-     *
-     * **Ez a migracios biztositek:** egy regi save-payload, ami meg nem ismerte az `ambience`
-     * csatornat, igy is betoltheto marad.
-     */
-    static merge(partial) {
-        const defaults = this.getDefaults();
-        if (!partial) {
-            return defaults;
-        }
-        return {
-            master: this.clamp(partial.master ?? defaults.master, defaults.master),
-            music: this.clamp(partial.music ?? defaults.music, defaults.music),
-            ambience: this.clamp(partial.ambience ?? defaults.ambience, defaults.ambience),
-            effects: this.clamp(partial.effects ?? defaults.effects, defaults.effects),
-            muted: partial.muted === true,
-        };
-    }
-    /**
-     * Egy csatorna EFFEKTIV hangereje: a csatorna sajat erteke szorozva a master-rel.
-     * Nemitas (`muted`) eseten mindig 0. A `master` csatornara a sajat erteket adja vissza
-     * (nem negyzetre emelve).
-     */
-    static getEffectiveVolume(settings, channel) {
-        const safe = this.merge(settings);
-        if (safe.muted) {
-            return 0;
-        }
-        if (channel === audio_channel_enum_1.DyFM_AudioChannel.master) {
-            return safe.master;
-        }
-        return this.clamp(safe[channel] * safe.master);
-    }
-    /**
-     * Egy csatorna hangerejenek beallitasa — UJ settings-objektumot ad vissza (immutable update),
-     * hogy signal-/state-alapu tarolokban is biztonsagos legyen.
-     */
-    static withChannelVolume(settings, channel, volume) {
-        const next = this.merge(settings);
-        next[channel] = this.clamp(volume);
-        return next;
-    }
-    /** Nemitas beallitasa — UJ settings-objektumot ad vissza (immutable update). */
-    static withMuted(settings, muted) {
-        const next = this.merge(settings);
-        next.muted = muted === true;
-        return next;
-    }
-    /** Ket beallitas ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
-    static isEqual(a, b) {
-        const left = this.merge(a);
-        const right = this.merge(b);
-        return left.master === right.master
-            && left.music === right.music
-            && left.ambience === right.ambience
-            && left.effects === right.effects
-            && left.muted === right.muted;
-    }
-}
-exports.DyFM_AudioMixer_Util = DyFM_AudioMixer_Util;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioMixer_Util = void 0;
+const audio_channel_enum_1 = require("../_enums/audio-channel.enum");
+/**
+ * Statikus util a jatek-audio mixer beallitasaihoz.
+ *
+ * Rendereles-agnosztikus es platform-fuggetlen: NINCS benne DOM, Web Audio, Angular vagy Node
+ * fuggoseg — a tenyleges lejatszast az `@futdevpro/ngx-dynamo` game-modulja (vagy a projekt sajat
+ * motorja) vegzi, ez csak a **modell + szamitas**.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const settings: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(loadedFromSave);
+ * const volume: number = DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.music);
+ * audioElement.volume = volume;
+ * ```
+ */
+class DyFM_AudioMixer_Util {
+    /** Alapertelmezett hangero minden csatornara (0..1). */
+    static defaultVolume = 0.8;
+    /**
+     * Az alapertelmezett mixer-beallitas. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa (nincs megosztott referencia).
+     */
+    static getDefaults() {
+        return {
+            master: this.defaultVolume,
+            music: this.defaultVolume,
+            ambience: this.defaultVolume,
+            effects: this.defaultVolume,
+            muted: false,
+        };
+    }
+    /**
+     * Egy hangero-erteket a 0..1 tartomanyba szorit. A nem-szamokat (NaN, undefined, null,
+     * nem-szam tipus) a `fallback`-re cseréli — igy egy serult save-payload sem tud NaN-t
+     * juttatni a lejatszoba (a `HTMLAudioElement.volume = NaN` dobna).
+     */
+    static clamp(value, fallback = DyFM_AudioMixer_Util.defaultVolume) {
+        if (typeof value !== 'number' || Number.isNaN(value)) {
+            return fallback;
+        }
+        if (value < 0) {
+            return 0;
+        }
+        if (1 < value) {
+            return 1;
+        }
+        return value;
+    }
+    /**
+     * Reszleges (vagy hianyzo) beallitas-objektumbol teljes, ervenyes settingset allit elo:
+     * a hianyzo mezoket a defaultbol veszi, a meglevoket 0..1-re szoritja.
+     *
+     * **Ez a migracios biztositek:** egy regi save-payload, ami meg nem ismerte az `ambience`
+     * csatornat, igy is betoltheto marad.
+     */
+    static merge(partial) {
+        const defaults = this.getDefaults();
+        if (!partial) {
+            return defaults;
+        }
+        return {
+            master: this.clamp(partial.master ?? defaults.master, defaults.master),
+            music: this.clamp(partial.music ?? defaults.music, defaults.music),
+            ambience: this.clamp(partial.ambience ?? defaults.ambience, defaults.ambience),
+            effects: this.clamp(partial.effects ?? defaults.effects, defaults.effects),
+            muted: partial.muted === true,
+        };
+    }
+    /**
+     * Egy csatorna EFFEKTIV hangereje: a csatorna sajat erteke szorozva a master-rel.
+     * Nemitas (`muted`) eseten mindig 0. A `master` csatornara a sajat erteket adja vissza
+     * (nem negyzetre emelve).
+     */
+    static getEffectiveVolume(settings, channel) {
+        const safe = this.merge(settings);
+        if (safe.muted) {
+            return 0;
+        }
+        if (channel === audio_channel_enum_1.DyFM_AudioChannel.master) {
+            return safe.master;
+        }
+        return this.clamp(safe[channel] * safe.master);
+    }
+    /**
+     * Egy csatorna hangerejenek beallitasa — UJ settings-objektumot ad vissza (immutable update),
+     * hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    static withChannelVolume(settings, channel, volume) {
+        const next = this.merge(settings);
+        next[channel] = this.clamp(volume);
+        return next;
+    }
+    /** Nemitas beallitasa — UJ settings-objektumot ad vissza (immutable update). */
+    static withMuted(settings, muted) {
+        const next = this.merge(settings);
+        next.muted = muted === true;
+        return next;
+    }
+    /** Ket beallitas ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    static isEqual(a, b) {
+        const left = this.merge(a);
+        const right = this.merge(b);
+        return left.master === right.master
+            && left.music === right.music
+            && left.ambience === right.ambience
+            && left.effects === right.effects
+            && left.muted === right.muted;
+    }
+}
+exports.DyFM_AudioMixer_Util = DyFM_AudioMixer_Util;
 //# sourceMappingURL=audio-mixer.util.js.map

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

@@ -1,57 +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;
-}
+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.js

@@ -1,105 +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;
+"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/_enums/audio-channel.enum.d.ts

@@ -1,21 +1,21 @@
-/**
- * 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 declare 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 declare enum DyFM_AudioChannel {
+    master = "master",
+    music = "music",
+    ambience = "ambience",
+    effects = "effects"
+}
 //# sourceMappingURL=audio-channel.enum.d.ts.map

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

@@ -1,25 +1,25 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_AudioChannel = void 0;
-/**
- * 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`).
- */
-var DyFM_AudioChannel;
-(function (DyFM_AudioChannel) {
-    DyFM_AudioChannel["master"] = "master";
-    DyFM_AudioChannel["music"] = "music";
-    DyFM_AudioChannel["ambience"] = "ambience";
-    DyFM_AudioChannel["effects"] = "effects";
-})(DyFM_AudioChannel || (exports.DyFM_AudioChannel = DyFM_AudioChannel = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioChannel = void 0;
+/**
+ * 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`).
+ */
+var DyFM_AudioChannel;
+(function (DyFM_AudioChannel) {
+    DyFM_AudioChannel["master"] = "master";
+    DyFM_AudioChannel["music"] = "music";
+    DyFM_AudioChannel["ambience"] = "ambience";
+    DyFM_AudioChannel["effects"] = "effects";
+})(DyFM_AudioChannel || (exports.DyFM_AudioChannel = DyFM_AudioChannel = {}));
 //# sourceMappingURL=audio-channel.enum.js.map