@futdevpro/fsm-dynamo 1.16.31 → 1.16.33

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

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioMixer_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+const audio_scale_util_1 = require("../_collections/audio-scale.util");
+/**
+ * **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);
+ * ```
+ */
+class DyFM_AudioMixer_ControlModel {
+    /** A `master` fenntartott nev — nem lehet sima csatorna, mert minden csatornara szorzodik. */
+    static masterChannel = 'master';
+    /** A validalt, sajat peldany-config (a hivo altal atadott objektumtol fuggetlen masolat). */
+    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) {
+        if (!config || !Array.isArray(config.channels) || !config.channels.length) {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-AUDIO-MIXER-001',
+                message: 'DyFM_AudioMixer_ControlModel: config.channels must be a non-empty string array',
+                additionalContent: { config: config },
+            });
+        }
+        const seen = [];
+        for (const channel of config.channels) {
+            if (typeof channel !== 'string' || !channel.length) {
+                throw new error_control_model_1.DyFM_Error({
+                    errorCode: 'DYFM-AUDIO-MIXER-002',
+                    message: 'DyFM_AudioMixer_ControlModel: every channel name must be a non-empty string',
+                    additionalContent: { channels: config.channels },
+                });
+            }
+            if (channel === DyFM_AudioMixer_ControlModel.masterChannel) {
+                throw new error_control_model_1.DyFM_Error({
+                    errorCode: 'DYFM-AUDIO-MIXER-003',
+                    message: 'DyFM_AudioMixer_ControlModel: "master" is reserved and must not be listed in channels',
+                    additionalContent: { channels: config.channels },
+                });
+            }
+            if (seen.includes(channel)) {
+                throw new error_control_model_1.DyFM_Error({
+                    errorCode: 'DYFM-AUDIO-MIXER-004',
+                    message: 'DyFM_AudioMixer_ControlModel: duplicate channel name',
+                    additionalContent: { channel: channel, channels: config.channels },
+                });
+            }
+            seen.push(channel);
+        }
+        const scale = config.scale && typeof config.scale.max === 'number'
+            ? { max: config.scale.max, integer: config.scale.integer === true }
+            : audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale();
+        this.config = {
+            channels: [...config.channels],
+            scale: scale,
+            defaults: config.defaults ? { ...config.defaults } : {},
+            defaultMaster: config.defaultMaster,
+            defaultChannelVolume: config.defaultChannelVolume,
+        };
+    }
+    /**
+     * A round-1 `DyFM_AudioMixer_Settings` alakjaval egyenerteku mixer (`music` / `ambience` /
+     * `effects`, `0..1` skala, 0.8 default). A Prototyper-stilusu fogyasztoknak.
+     */
+    static createClassic() {
+        return new DyFM_AudioMixer_ControlModel({
+            channels: ['music', 'ambience', 'effects'],
+            scale: audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale(),
+            defaultMaster: audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio,
+            defaultChannelVolume: audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio,
+        });
+    }
+    /**
+     * `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, defaults, defaultMaster) {
+        return new DyFM_AudioMixer_ControlModel({
+            channels: channels,
+            scale: audio_scale_util_1.DyFM_AudioScale_Util.getPercentScale(),
+            defaults: defaults,
+            defaultMaster: defaultMaster,
+        });
+    }
+    /** A round-1 fix alakot atalakitja a nyitott allapot-alakra (migracios hid). */
+    static fromClassicSettings(settings) {
+        const safe = settings ?? {};
+        const scale = audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale();
+        return {
+            master: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, scale),
+            channels: {
+                music: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.music, scale),
+                ambience: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.ambience, scale),
+                effects: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.effects, scale),
+            },
+            muted: safe.muted === true,
+        };
+    }
+    /**
+     * 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) {
+        const safe = this.merge(state);
+        const scale = this.config.scale;
+        return {
+            master: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, scale),
+            music: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['music'], scale),
+            ambience: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['ambience'], scale),
+            effects: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['effects'], scale),
+            muted: safe.muted === true,
+        };
+    }
+    /** A peldany configja (masolat — a mutalasa nem hat vissza a modellre). */
+    getConfig() {
+        return {
+            channels: [...this.config.channels],
+            scale: { max: this.config.scale.max, integer: this.config.scale.integer },
+            defaults: { ...this.config.defaults },
+            defaultMaster: this.config.defaultMaster,
+            defaultChannelVolume: this.config.defaultChannelVolume,
+        };
+    }
+    /** A deklaralt csatorna-nevek (a `master` nelkul). */
+    getChannels() {
+        return [...this.config.channels];
+    }
+    /** Igaz, ha a nev a deklaralt csatornak kozott van (a `master` NEM az). */
+    hasChannel(channel) {
+        return this.config.channels.includes(channel);
+    }
+    /**
+     * Alapertelmezett allapot a **sajat skalan**. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa.
+     */
+    getDefaults() {
+        const channels = {};
+        for (const channel of this.config.channels) {
+            channels[channel] = this.getDefaultChannelVolume(channel);
+        }
+        return {
+            master: this.getDefaultMaster(),
+            channels: channels,
+            muted: false,
+        };
+    }
+    /**
+     * 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) {
+        const defaults = this.getDefaults();
+        if (!partial) {
+            return defaults;
+        }
+        const source = partial.channels ?? {};
+        const channels = {};
+        for (const channel of this.config.channels) {
+            const raw = source[channel];
+            channels[channel] = raw === undefined || raw === null
+                ? defaults.channels[channel]
+                : audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(raw, this.config.scale, defaults.channels[channel]);
+        }
+        const master = partial.master === undefined || partial.master === null
+            ? defaults.master
+            : audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(partial.master, this.config.scale, defaults.master);
+        return {
+            master: master,
+            channels: channels,
+            muted: partial.muted === true,
+        };
+    }
+    /**
+     * 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, channel) {
+        if (channel !== DyFM_AudioMixer_ControlModel.masterChannel && !this.hasChannel(channel)) {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-AUDIO-MIXER-005',
+                message: 'DyFM_AudioMixer_ControlModel.getEffectiveVolume: unknown channel',
+                additionalContent: { channel: channel, declaredChannels: this.config.channels },
+            });
+        }
+        const safe = this.merge(state);
+        if (safe.muted) {
+            return 0;
+        }
+        const masterUnit = audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, this.config.scale);
+        if (channel === DyFM_AudioMixer_ControlModel.masterChannel) {
+            return masterUnit;
+        }
+        const channelUnit = audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels[channel], this.config.scale);
+        return audio_scale_util_1.DyFM_AudioScale_Util.clampUnit(channelUnit * masterUnit);
+    }
+    /**
+     * Egy csatorna hangerejenek beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza
+     * (immutable update), hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    withChannelVolume(state, channel, volume) {
+        if (!this.hasChannel(channel)) {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-AUDIO-MIXER-006',
+                message: 'DyFM_AudioMixer_ControlModel.withChannelVolume: unknown channel',
+                additionalContent: { channel: channel, declaredChannels: this.config.channels },
+            });
+        }
+        const next = this.merge(state);
+        next.channels[channel] = audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(volume, this.config.scale);
+        return next;
+    }
+    /** A master beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza. */
+    withMasterVolume(state, volume) {
+        const next = this.merge(state);
+        next.master = audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(volume, this.config.scale);
+        return next;
+    }
+    /** Nemitas beallitasa — UJ allapot-objektumot ad vissza. */
+    withMuted(state, muted) {
+        const next = this.merge(state);
+        next.muted = muted === true;
+        return next;
+    }
+    /** Ket allapot ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    isEqual(a, b) {
+        const left = this.merge(a);
+        const right = this.merge(b);
+        if (left.master !== right.master || left.muted !== right.muted) {
+            return false;
+        }
+        for (const channel of this.config.channels) {
+            if (left.channels[channel] !== right.channels[channel]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /** A master alapertelmezese a sajat skalan (config, kulonben a maximum 80%-a). */
+    getDefaultMaster() {
+        if (typeof this.config.defaultMaster === 'number' && !Number.isNaN(this.config.defaultMaster)) {
+            return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(this.config.defaultMaster, this.config.scale);
+        }
+        return audio_scale_util_1.DyFM_AudioScale_Util.fromUnit(audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio, this.config.scale);
+    }
+    /** Egy csatorna alapertelmezese a sajat skalan (per-csatorna, kulonben kozos, kulonben 80%). */
+    getDefaultChannelVolume(channel) {
+        const perChannel = (this.config.defaults ?? {})[channel];
+        if (typeof perChannel === 'number' && !Number.isNaN(perChannel)) {
+            return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(perChannel, this.config.scale);
+        }
+        if (typeof this.config.defaultChannelVolume === 'number'
+            && !Number.isNaN(this.config.defaultChannelVolume)) {
+            return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(this.config.defaultChannelVolume, this.config.scale);
+        }
+        return audio_scale_util_1.DyFM_AudioScale_Util.fromUnit(audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio, this.config.scale);
+    }
+}
+exports.DyFM_AudioMixer_ControlModel = DyFM_AudioMixer_ControlModel;
+//# sourceMappingURL=audio-mixer.control-model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer.control-model.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+/**
+ * Egy audio-mixer csatorna-ertekeinek **skalaja** — a projekt sajat szamabrazolasa.
+ *
+ * **Miert kell:** a flotta ket kulonbozo skalat hasznal. A Prototyper prototipusai `0..1`
+ * lebegopontos erteket tarolnak, a Hero Coordinator viszont `0-100` egeszet (`Math.round`-dal
+ * clampelve, igy is van elmentve a localStorage-ban). Ha a bedrock egyetlen skalat kenyszeritene,
+ * az egyik oldalnak **adatot kellene migralnia** — ezt kerulik el ezek a leirok.
+ *
+ * A modell befele mindig `0..1`-re normalizal (a lejatszo API-k ezt varjak), kifele viszont a
+ * projekt sajat skalajan tarol es ad vissza.
+ */
+export interface DyFM_AudioScale {
+    /** A csatorna-ertek maximuma a projekt sajat skalajan (pl. `1` vagy `100`). */
+    max: number;
+    /** Ha `true`, a sajat skalara visszaalakitott ertek egeszre kerekitodik (0-100 UI-hoz). */
+    integer: boolean;
+}
+//# sourceMappingURL=audio-scale.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-scale.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-scale.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAE9B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IAEZ,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/build/_modules/game/_models/audio-scale.interface.js

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

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

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

package/build/_modules/game/index.d.ts

@@ -1,6 +1,11 @@
 export * from './_enums/audio-channel.enum';
+export * from './_models/audio-mixer-config.interface';
 export * from './_models/audio-mixer-settings.interface';
+export * from './_models/audio-mixer-state.interface';
+export * from './_models/audio-mixer.control-model';
+export * from './_models/audio-scale.interface';
 export * from './_models/seeded-random-state.interface';
 export * from './_models/seeded-random.control-model';
 export * from './_collections/audio-mixer.util';
+export * from './_collections/audio-scale.util';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/game/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC"}

package/build/_modules/game/index.js

@@ -4,9 +4,14 @@ const tslib_1 = require("tslib");
 // ENUMS
 tslib_1.__exportStar(require("./_enums/audio-channel.enum"), exports);
 // MODELS
+tslib_1.__exportStar(require("./_models/audio-mixer-config.interface"), exports);
 tslib_1.__exportStar(require("./_models/audio-mixer-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/audio-mixer-state.interface"), exports);
+tslib_1.__exportStar(require("./_models/audio-mixer.control-model"), exports);
+tslib_1.__exportStar(require("./_models/audio-scale.interface"), exports);
 tslib_1.__exportStar(require("./_models/seeded-random-state.interface"), exports);
 tslib_1.__exportStar(require("./_models/seeded-random.control-model"), exports);
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/audio-mixer.util"), exports);
+tslib_1.__exportStar(require("./_collections/audio-scale.util"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/game/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,mFAAyD;AACzD,kFAAwD;AACxD,gFAAsD;AAEtD,cAAc;AACd,0EAAgD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,iFAAuD;AACvD,mFAAyD;AACzD,gFAAsD;AACtD,8EAAoD;AACpD,0EAAgD;AAChD,kFAAwD;AACxD,gFAAsD;AAEtD,cAAc;AACd,0EAAgD;AAChD,0EAAgD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.16.31",
+  "version": "01.16.33",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",

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

@@ -0,0 +1,140 @@
+
+import { DyFM_AudioScale } from '../_models/audio-scale.interface';
+
+import { DyFM_AudioScale_Util } from './audio-scale.util';
+
+
+describe('DyFM_AudioScale_Util', (): void => {
+
+  describe('getUnitScale / getPercentScale', (): void => {
+
+    it('a unit-skala 0..1, nem egesz', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getUnitScale();
+
+      expect(scale.max).toBe(1);
+      expect(scale.integer).toBe(false);
+    });
+
+    it('a percent-skala 0-100, egesz', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(scale.max).toBe(100);
+      expect(scale.integer).toBe(true);
+    });
+
+    it('minden hivas UJ objektumot ad (nincs megosztott referencia)', (): void => {
+      const first: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+      const second: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      first.max = 7;
+
+      expect(second.max).toBe(100);
+    });
+  });
+
+  describe('toUnit', (): void => {
+
+    it('percent skalarol 0..1-re normalizal', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.toUnit(0, scale)).toBe(0);
+      expect(DyFM_AudioScale_Util.toUnit(72, scale)).toBeCloseTo(0.72, 10);
+      expect(DyFM_AudioScale_Util.toUnit(100, scale)).toBe(1);
+    });
+
+    it('unit skalan valtozatlanul hagy', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getUnitScale();
+
+      expect(DyFM_AudioScale_Util.toUnit(0.35, scale)).toBeCloseTo(0.35, 10);
+    });
+
+    it('a tartomanyon kivuli erteket beszoritja', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.toUnit(-40, scale)).toBe(0);
+      expect(DyFM_AudioScale_Util.toUnit(400, scale)).toBe(1);
+    });
+
+    it('ervenytelen bemenetre a fallback-et adja (NaN nem szivaroghat a lejatszoba)', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.toUnit(NaN, scale, 0.5)).toBe(0.5);
+      expect(DyFM_AudioScale_Util.toUnit(undefined as unknown as number, scale, 0.5)).toBe(0.5);
+      expect(DyFM_AudioScale_Util.toUnit('80' as unknown as number, scale, 0.5)).toBe(0.5);
+    });
+
+    it('serult skalaval sem oszt nullaval es nem ad NaN-t', (): void => {
+      const broken: DyFM_AudioScale = { max: 0, integer: false };
+
+      expect(DyFM_AudioScale_Util.toUnit(0.5, broken)).toBe(0.5);
+      expect(Number.isNaN(DyFM_AudioScale_Util.toUnit(1, broken))).toBe(false);
+    });
+  });
+
+  describe('fromUnit', (): void => {
+
+    it('percent skalara egeszre kerekit', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.fromUnit(0.725, scale)).toBe(73);
+      expect(DyFM_AudioScale_Util.fromUnit(0, scale)).toBe(0);
+      expect(DyFM_AudioScale_Util.fromUnit(1, scale)).toBe(100);
+    });
+
+    it('unit skalan NEM kerekit', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getUnitScale();
+
+      expect(DyFM_AudioScale_Util.fromUnit(0.725, scale)).toBeCloseTo(0.725, 10);
+    });
+
+    it('ervenytelen bemenetre 0-t ad', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.fromUnit(NaN, scale)).toBe(0);
+    });
+  });
+
+  describe('oda-vissza konverzio', (): void => {
+
+    it('percent egesz erteket VALTOZATLANUL ad vissza (nincs adat-drift a HC mentesen)', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+      const values: number[] = [0, 1, 36, 68, 72, 84, 99, 100];
+
+      for (const value of values) {
+        const roundTrip: number = DyFM_AudioScale_Util.fromUnit(
+          DyFM_AudioScale_Util.toUnit(value, scale),
+          scale,
+        );
+
+        expect(roundTrip).toBe(value);
+      }
+    });
+  });
+
+  describe('clampToScale', (): void => {
+
+    it('a sajat skala tartomanyaba szorit es egesz skalan kerekit', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.clampToScale(-5, scale)).toBe(0);
+      expect(DyFM_AudioScale_Util.clampToScale(150, scale)).toBe(100);
+      expect(DyFM_AudioScale_Util.clampToScale(72.4, scale)).toBe(72);
+    });
+
+    it('ervenytelen erteket 0-ra visz (nem a fallback-re)', (): void => {
+      const scale: DyFM_AudioScale = DyFM_AudioScale_Util.getPercentScale();
+
+      expect(DyFM_AudioScale_Util.clampToScale(NaN, scale)).toBe(0);
+    });
+  });
+
+  describe('clampUnit', (): void => {
+
+    it('0..1 koze szorit, NaN-ra 0', (): void => {
+      expect(DyFM_AudioScale_Util.clampUnit(-1)).toBe(0);
+      expect(DyFM_AudioScale_Util.clampUnit(2)).toBe(1);
+      expect(DyFM_AudioScale_Util.clampUnit(0.42)).toBe(0.42);
+      expect(DyFM_AudioScale_Util.clampUnit(NaN)).toBe(0);
+    });
+  });
+});