@futdevpro/fsm-dynamo 1.16.37 → 1.16.39

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

@@ -1,198 +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);
-    });
-  });
-});
+
+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);
+    });
+  });
+});