@futdevpro/fsm-dynamo 1.16.29 → 1.16.31

package/build/_modules/game/_models/seeded-random.control-model.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_SeededRandom = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * Determinisztikus, **seed-elt** veletlenszam-generator mentheto allapottal.
+ *
+ * **Miert letezik:** a `DyFM_Random` `Math.random()`-ra epul — gyors es kenyelmes, de
+ * NEM reprodukalhato es nincs allapota. A flotta harom jateka ezert epitett maganak sajat
+ * PRNG-t (`sm-random.service.ts`, `random-seed.service.ts`, Portalhold `worldSeed`).
+ * Ez az osztaly az egysegesitett valtozat.
+ *
+ * **Algoritmus:** sfc32 (Small Fast Counting) — 128 bites allapot (4x32 bit), kivalo
+ * statisztikai minoseg, gyors, es az allapota trivialisan serializalhato. A string-seedet
+ * cyrb128 hash-eli 4x32 bitre, tehat `'my-world-seed'` es `42` egyarant ervenyes seed.
+ *
+ * **Mire jo (a jatekon tul):**
+ * - reprodukalhato vilag-generalas es mentheto RNG-allapot,
+ * - **determinisztikus e2e/QA** — ugyanaz a seed ugyanazt a jatekmenetet adja,
+ * - perf-osszemeres azonos bemeneten,
+ * - mock-adat es teszt-fixture stabil generalasa.
+ *
+ * **Hasznalat:**
+ * ```typescript
+ * const rng = DyFM_SeededRandom.fromSeed('world-42');
+ * const damage: number = rng.nextInt(5, 15);
+ * const loot = rng.getRandomWeighted([
+ *   { chance: 0.7, result: 'common' },
+ *   { chance: 0.3, result: 'rare' },
+ * ]);
+ *
+ * // mentes
+ * save.rngState = rng.getState();
+ *
+ * // betoltes — a sorozat ott folytatodik, ahol abbamaradt
+ * const restored = DyFM_SeededRandom.fromState(save.rngState);
+ * ```
+ *
+ * **Fontos:** ket kulon instance NEM befolyasolja egymast; ha determinisztikus alrendszereket
+ * akarsz (pl. vilag-generalas kulon a harci dobasoktol), adj mindegyiknek sajat instance-ot.
+ */
+class DyFM_SeededRandom {
+    /** 2^32 — a 32 bites egeszek normalizalasahoz. */
+    static uint32Range = 4294967296;
+    /** sfc32 allapot-szo #1. */
+    a;
+    /** sfc32 allapot-szo #2. */
+    b;
+    /** sfc32 allapot-szo #3. */
+    c;
+    /** sfc32 counter-szo. */
+    d;
+    /**
+     * Kozvetlen allapotbol epit. A tipikus belepesi pont a `fromSeed()` / `fromState()`
+     * statikus factory.
+     */
+    constructor(state) {
+        if (!state || typeof state.a !== 'number' || typeof state.b !== 'number'
+            || typeof state.c !== 'number' || typeof state.d !== 'number') {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-SEEDED-RANDOM-001',
+                message: 'DyFM_SeededRandom: invalid state — all four state words must be numbers',
+                additionalContent: { state: state },
+            });
+        }
+        this.a = state.a | 0;
+        this.b = state.b | 0;
+        this.c = state.c | 0;
+        this.d = state.d | 0;
+    }
+    /**
+     * Generator letrehozasa seed-bol. A seed lehet string (pl. mentett `worldSeed`) vagy szam.
+     * Ugyanaz a seed MINDIG ugyanazt a sorozatot adja.
+     */
+    static fromSeed(seed) {
+        if (typeof seed !== 'string' && typeof seed !== 'number') {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-SEEDED-RANDOM-002',
+                message: 'DyFM_SeededRandom.fromSeed: seed must be a string or a number',
+                additionalContent: { seed: seed },
+            });
+        }
+        return new DyFM_SeededRandom(this.hashSeed(String(seed)));
+    }
+    /** Generator letrehozasa korabban elmentett allapotbol (save-betoltes). */
+    static fromState(state) {
+        return new DyFM_SeededRandom(state);
+    }
+    /**
+     * String seed -> 4x32 bites allapot (cyrb128). Determinisztikus es jol szoro:
+     * a `'a'` es `'b'` seed teljesen kulonbozo sorozatot ad.
+     */
+    static hashSeed(seed) {
+        let h1 = 1779033703;
+        let h2 = 3144134277;
+        let h3 = 1013904242;
+        let h4 = 2773480762;
+        for (let i = 0; i < seed.length; i++) {
+            const k = seed.charCodeAt(i);
+            h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+            h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+            h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+            h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+        }
+        h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);
+        h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);
+        h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);
+        h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
+        // a 0-allapot degeneralt lenne (az sfc32 megallna) — ezert biztositjuk hogy ne legyen csupa 0
+        return {
+            a: ((h1 ^ h2 ^ h3 ^ h4) >>> 0) || 1,
+            b: ((h2 ^ h1) >>> 0) || 2,
+            c: ((h3 ^ h1) >>> 0) || 3,
+            d: ((h4 ^ h1) >>> 0) || 4,
+        };
+    }
+    /** A generator teljes allapotanak masolata — ezt kell a save-payloadba tenni. */
+    getState() {
+        return { a: this.a, b: this.b, c: this.c, d: this.d };
+    }
+    /** Allapot visszatoltese — a sorozat innentol az elmentett ponton folytatodik. */
+    setState(state) {
+        if (!state || typeof state.a !== 'number' || typeof state.b !== 'number'
+            || typeof state.c !== 'number' || typeof state.d !== 'number') {
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'DYFM-SEEDED-RANDOM-003',
+                message: 'DyFM_SeededRandom.setState: invalid state — all four state words must be numbers',
+                additionalContent: { state: state },
+            });
+        }
+        this.a = state.a | 0;
+        this.b = state.b | 0;
+        this.c = state.c | 0;
+        this.d = state.d | 0;
+    }
+    /**
+     * Fuggetlen masolat az AKTUALIS allapotrol — a klon ugyanazt a sorozatot folytatja,
+     * de a ket instance tovabbiakban nem befolyasolja egymast.
+     *
+     * Tipikus hasznalat: „mi lenne, ha" elore-szimulacio a fo-jatekmenet elrontasa nelkul.
+     */
+    clone() {
+        return new DyFM_SeededRandom(this.getState());
+    }
+    /**
+     * A kovetkezo veletlen lebegopontos szam a `[0, 1)` tartomanybol (sfc32 mag).
+     * Minden mas metodus erre epul.
+     */
+    nextFloat() {
+        this.a |= 0;
+        this.b |= 0;
+        this.c |= 0;
+        this.d |= 0;
+        const t = (((this.a + this.b) | 0) + this.d) | 0;
+        this.d = (this.d + 1) | 0;
+        this.a = this.b ^ (this.b >>> 9);
+        this.b = (this.c + (this.c << 3)) | 0;
+        this.c = (this.c << 21) | (this.c >>> 11);
+        this.c = (this.c + t) | 0;
+        return (t >>> 0) / DyFM_SeededRandom.uint32Range;
+    }
+    /**
+     * Veletlen egesz a `[min, max]` tartomanybol (mindket veg ZART) — a `DyFM_Random.getRandomInt`
+     * seedelt parja. Ha `max < min`, a ket erteket felcsereli.
+     */
+    nextInt(min, max) {
+        const low = Math.min(min, max);
+        const high = Math.max(min, max);
+        return low + Math.floor(this.nextFloat() * (high - low + 1));
+    }
+    /** A `DyFM_Random.getRandomInt` API-paritas alias — l. `nextInt`. */
+    getRandomInt(min, max) {
+        return this.nextInt(min, max);
+    }
+    /** Veletlen lebegopontos szam a `[min, max)` tartomanybol. */
+    nextRange(min, max) {
+        const low = Math.min(min, max);
+        const high = Math.max(min, max);
+        return low + this.nextFloat() * (high - low);
+    }
+    /**
+     * Veletlen logikai ertek. A `chance` a `true` valoszinusege (0..1; default 0.5).
+     */
+    nextBool(chance = 0.5) {
+        return this.nextFloat() < chance;
+    }
+    /**
+     * Veletlen elem a listabol (`null`, ha a lista ures) — a `DyFM_Random.getRandomListElement`
+     * seedelt parja.
+     */
+    getRandomListElement(list) {
+        if (!list?.length) {
+            return null;
+        }
+        return list[this.nextInt(0, list.length - 1)];
+    }
+    /**
+     * Sulyozott veletlen elem (`null`, ha a lista ures) — a `DyFM_Random.getRandomWeighted`
+     * seedelt parja.
+     *
+     * **Elteres a `DyFM_Random`-tol:** ez a valtozat NEM mutalja a bemeneti tombot
+     * (a statikus verzio helyben rendez es atirja a `chance` ertekeket).
+     */
+    getRandomWeighted(weights) {
+        if (!weights?.length) {
+            return null;
+        }
+        let chanceSum = 0;
+        weights.forEach((weight) => { chanceSum += weight.chance; });
+        if (chanceSum <= 0) {
+            return this.getRandomListElement(weights.map((weight) => weight.result));
+        }
+        const roll = this.nextFloat() * chanceSum;
+        let cumulated = 0;
+        for (let i = 0; i < weights.length; i++) {
+            cumulated += weights[i].chance;
+            if (roll < cumulated) {
+                return weights[i].result;
+            }
+        }
+        // lebegopontos kerekitesi maradek eseten az utolso elem a nyertes
+        return weights[weights.length - 1].result;
+    }
+    /**
+     * Sulyozott veletlen egesz — a `DyFM_Random.getRandomWeightedInt` seedelt parja.
+     * Ha a sulyozas nem ad talalatot, `nextInt(min, max)`-ra esik vissza.
+     */
+    getRandomWeightedInt(min, max, weights) {
+        const weighted = this.getRandomWeighted(weights);
+        if (weighted === null) {
+            return this.nextInt(min, max);
+        }
+        return weighted;
+    }
+    /**
+     * Fisher-Yates keveres — UJ tombot ad vissza, a bemenetet nem mutalja.
+     */
+    shuffle(list) {
+        if (!list?.length) {
+            return [];
+        }
+        const result = list.slice();
+        for (let i = result.length - 1; 0 < i; i--) {
+            const j = this.nextInt(0, i);
+            const swap = result[i];
+            result[i] = result[j];
+            result[j] = swap;
+        }
+        return result;
+    }
+    /**
+     * `count` darab KULONBOZO elem kivalasztasa a listabol (sorrendje veletlen).
+     * Ha `count` nagyobb a lista hosszanal, a teljes (megkevert) listat adja vissza.
+     */
+    pick(list, count) {
+        if (!list?.length || count <= 0) {
+            return [];
+        }
+        return this.shuffle(list).slice(0, Math.min(count, list.length));
+    }
+}
+exports.DyFM_SeededRandom = DyFM_SeededRandom;
+//# sourceMappingURL=seeded-random.control-model.js.map

package/build/_modules/game/_models/seeded-random.control-model.js.map

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

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

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

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

@@ -0,0 +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"}

package/build/_modules/game/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/audio-channel.enum"), exports);
+// MODELS
+tslib_1.__exportStar(require("./_models/audio-mixer-settings.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);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.16.29",
+  "version": "01.16.31",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -195,6 +195,12 @@
       "module": "./build/_modules/ngx-models/index.js",
       "types": "./build/_modules/ngx-models/index.d.ts",
       "typings": "./build/_modules/ngx-models/index.d.ts"
+    },
+    "./game": {
+      "default": "./build/_modules/game/index.js",
+      "module": "./build/_modules/game/index.js",
+      "types": "./build/_modules/game/index.d.ts",
+      "typings": "./build/_modules/game/index.d.ts"
     }
   },
   "typesVersions": {
@@ -261,6 +267,9 @@
       ],
       "ngx-models": [
         "build/_modules/ngx-models/index.d.ts"
+      ],
+      "game": [
+        "build/_modules/game/index.d.ts"
       ]
     }
   },
@@ -269,6 +278,7 @@
   },
   "dependencies": {
     "@types/node": "~24.1.0",
+    "crypto-js": "~4.2.0",
     "socket.io": "~4.8.1",
     "socket.io-client": "~4.8.1",
     "ts-node": "~10.9.1",
@@ -277,7 +287,7 @@
     "uuid": "11.1.0"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "1.15.21",
+    "@futdevpro/dynamo-eslint": "1.15.22",
     "@types/jasmine": "~4.3.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",
@@ -290,7 +300,6 @@
     "jasmine": "5.10.0",
     "jasmine-spec-reporter": "^7.0.0",
     "prettier": "^3.3.0",
-    "crypto-js": "~4.2.0",
     "openai": "~5.23.2",
     "husky": "^9.1.7"
   }

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

@@ -0,0 +1,198 @@
+
+import { DyFM_AudioChannel } from '../_enums/audio-channel.enum';
+import { DyFM_AudioMixer_Settings } from '../_models/audio-mixer-settings.interface';
+
+import { DyFM_AudioMixer_Util } from './audio-mixer.util';
+
+
+describe('DyFM_AudioMixer_Util', (): void => {
+
+  describe('getDefaults', (): void => {
+
+    it('minden csatornara ervenyes 0..1 erteket ad, nem nemitva', (): void => {
+      const defaults: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.getDefaults();
+
+      expect(defaults.master).toBeGreaterThan(0);
+      expect(defaults.master).toBeLessThanOrEqual(1);
+      expect(defaults.music).toBeGreaterThan(0);
+      expect(defaults.ambience).toBeGreaterThan(0);
+      expect(defaults.effects).toBeGreaterThan(0);
+      expect(defaults.muted).toBe(false);
+    });
+
+    it('minden hivas UJ objektumot ad (nincs megosztott referencia)', (): void => {
+      const first: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.getDefaults();
+      const second: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.getDefaults();
+
+      first.master = 0.1;
+
+      expect(second.master).not.toBe(0.1);
+    });
+  });
+
+  describe('clamp', (): void => {
+
+    it('a 0..1 tartomanyba szorit', (): void => {
+      expect(DyFM_AudioMixer_Util.clamp(-3)).toBe(0);
+      expect(DyFM_AudioMixer_Util.clamp(7)).toBe(1);
+      expect(DyFM_AudioMixer_Util.clamp(0.35)).toBe(0.35);
+      expect(DyFM_AudioMixer_Util.clamp(0)).toBe(0);
+      expect(DyFM_AudioMixer_Util.clamp(1)).toBe(1);
+    });
+
+    it('NaN / undefined / nem-szam eseten a fallback-et adja', (): void => {
+      expect(DyFM_AudioMixer_Util.clamp(Number.NaN, 0.5)).toBe(0.5);
+      expect(DyFM_AudioMixer_Util.clamp(undefined, 0.5)).toBe(0.5);
+      expect(DyFM_AudioMixer_Util.clamp(null, 0.5)).toBe(0.5);
+    });
+  });
+
+  describe('merge — a migracios biztositek', (): void => {
+
+    it('hianyzo bemenetre a defaultot adja', (): void => {
+      expect(DyFM_AudioMixer_Util.merge(null)).toEqual(DyFM_AudioMixer_Util.getDefaults());
+      expect(DyFM_AudioMixer_Util.merge(undefined)).toEqual(DyFM_AudioMixer_Util.getDefaults());
+    });
+
+    it('reszleges (legacy) payloadot teljesse egeszit ki', (): void => {
+      const legacy: Partial<DyFM_AudioMixer_Settings> = { master: 0.4, music: 0.2 };
+      const merged: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(legacy);
+
+      expect(merged.master).toBe(0.4);
+      expect(merged.music).toBe(0.2);
+      expect(merged.ambience).toBe(DyFM_AudioMixer_Util.getDefaults().ambience);
+      expect(merged.effects).toBe(DyFM_AudioMixer_Util.getDefaults().effects);
+      expect(merged.muted).toBe(false);
+    });
+
+    it('a tartomanyon kivuli mentett erteket beszoritja', (): void => {
+      const corrupted: Partial<DyFM_AudioMixer_Settings> = { master: 42, effects: -1 };
+      const merged: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(corrupted);
+
+      expect(merged.master).toBe(1);
+      expect(merged.effects).toBe(0);
+    });
+
+    it('a muted-ot szigoruan boolean-na alakitja', (): void => {
+      expect(DyFM_AudioMixer_Util.merge({ muted: true }).muted).toBe(true);
+      expect(DyFM_AudioMixer_Util.merge({}).muted).toBe(false);
+    });
+  });
+
+  describe('getEffectiveVolume', (): void => {
+
+    const settings: DyFM_AudioMixer_Settings = {
+      master: 0.5,
+      music: 0.4,
+      ambience: 0.6,
+      effects: 1,
+      muted: false,
+    };
+
+    it('a csatorna erteket a master-rel szorozza', (): void => {
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.music))
+        .toBeCloseTo(0.2, 10);
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.ambience))
+        .toBeCloseTo(0.3, 10);
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.effects))
+        .toBeCloseTo(0.5, 10);
+    });
+
+    it('a master csatornara a sajat erteket adja (nem negyzetre emelve)', (): void => {
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(settings, DyFM_AudioChannel.master)).toBe(0.5);
+    });
+
+    it('nemitas eseten minden csatorna 0', (): void => {
+      const muted: DyFM_AudioMixer_Settings = { ...settings, muted: true };
+
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(muted, DyFM_AudioChannel.master)).toBe(0);
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(muted, DyFM_AudioChannel.music)).toBe(0);
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(muted, DyFM_AudioChannel.ambience)).toBe(0);
+      expect(DyFM_AudioMixer_Util.getEffectiveVolume(muted, DyFM_AudioChannel.effects)).toBe(0);
+    });
+
+    it('serult settingsbol sem ad NaN-t', (): void => {
+      const corrupted: DyFM_AudioMixer_Settings = {
+        master: Number.NaN,
+        music: undefined,
+        ambience: -5,
+        effects: 99,
+        muted: false,
+      };
+
+      [
+        DyFM_AudioChannel.master,
+        DyFM_AudioChannel.music,
+        DyFM_AudioChannel.ambience,
+        DyFM_AudioChannel.effects,
+      ].forEach((channel: DyFM_AudioChannel): void => {
+        const volume: number = DyFM_AudioMixer_Util.getEffectiveVolume(corrupted, channel);
+
+        expect(Number.isNaN(volume)).toBe(false);
+        expect(volume).toBeGreaterThanOrEqual(0);
+        expect(volume).toBeLessThanOrEqual(1);
+      });
+    });
+  });
+
+  describe('immutable update-ek', (): void => {
+
+    it('a withChannelVolume UJ objektumot ad, az eredetit nem mutalja', (): void => {
+      const original: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.getDefaults();
+      const updated: DyFM_AudioMixer_Settings =
+        DyFM_AudioMixer_Util.withChannelVolume(original, DyFM_AudioChannel.music, 0.25);
+
+      expect(updated.music).toBe(0.25);
+      expect(original.music).not.toBe(0.25);
+      expect(updated).not.toBe(original);
+    });
+
+    it('a withChannelVolume beszoritja a tartomanyon kivuli erteket', (): void => {
+      const updated: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util
+        .withChannelVolume(DyFM_AudioMixer_Util.getDefaults(), DyFM_AudioChannel.effects, 5);
+
+      expect(updated.effects).toBe(1);
+    });
+
+    it('a withMuted UJ objektumot ad, az eredetit nem mutalja', (): void => {
+      const original: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.getDefaults();
+      const updated: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.withMuted(original, true);
+
+      expect(updated.muted).toBe(true);
+      expect(original.muted).toBe(false);
+    });
+  });
+
+  describe('isEqual', (): void => {
+
+    it('ertek szerint hasonlit, nem referencia szerint', (): void => {
+      expect(DyFM_AudioMixer_Util.isEqual(
+        DyFM_AudioMixer_Util.getDefaults(),
+        DyFM_AudioMixer_Util.getDefaults(),
+      )).toBe(true);
+    });
+
+    it('elteres eseten false', (): void => {
+      const changed: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util
+        .withChannelVolume(DyFM_AudioMixer_Util.getDefaults(), DyFM_AudioChannel.music, 0.1);
+
+      expect(DyFM_AudioMixer_Util.isEqual(DyFM_AudioMixer_Util.getDefaults(), changed)).toBe(false);
+    });
+  });
+
+  describe('kompatibilitas a flotta 4 meglevo interfeszevel', (): void => {
+
+    it('a PCR / PCS / PG / HC alak mezoi hianytalanul lefedve', (): void => {
+      const fromLegacyProject: DyFM_AudioMixer_Settings = {
+        master: 0.9,
+        music: 0.7,
+        ambience: 0.5,
+        effects: 0.3,
+        muted: false,
+      };
+      const merged: DyFM_AudioMixer_Settings = DyFM_AudioMixer_Util.merge(fromLegacyProject);
+
+      expect(merged).toEqual(fromLegacyProject);
+    });
+  });
+});