@futdevpro/fsm-dynamo 1.16.39 → 1.20.2

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

@@ -1,44 +1,44 @@
-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;
-    /**
-     * Szoljon-e a hang alapbol akkor is, ha a tab/ablak nem aktiv. **Default: `false`**
-     * (owner-direktiva — a hatter-hang opt-in, sosem opt-out).
-     *
-     * Csak nagyon indokolt esetben allitsd `true`-ra (pl. tisztan audio-jatek).
-     */
-    defaultPlayWhenUnfocused?: boolean;
-}
+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;
+    /**
+     * Szoljon-e a hang alapbol akkor is, ha a tab/ablak nem aktiv. **Default: `false`**
+     * (owner-direktiva — a hatter-hang opt-in, sosem opt-out).
+     *
+     * Csak nagyon indokolt esetben allitsd `true`-ra (pl. tisztan audio-jatek).
+     */
+    defaultPlayWhenUnfocused?: boolean;
+}
 //# sourceMappingURL=audio-mixer-config.interface.d.ts.map

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

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

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

@@ -1,32 +1,32 @@
-/**
- * A jatek-audio mixer beallitasai — csatornankent 0..1 hangero + globalis nemitas.
- *
- * **Miert bedrock:** ez az interfesz a flottaban NEGY helyen elt egymastol fuggetlenul,
- * karakterre azonos alakban (`pcr-audio-settings.interface.ts`, `pcs-audio-settings.interface.ts`,
- * `pg-audio-settings.interface.ts` + a Hero Coordinator sajat audio-service-e). Ez a kanonikus alak.
- *
- * **Mentheto:** tisztan JSON-serializalhato, tehat a jatek save-payload resze lehet.
- * Reszleges/legacy payload-bol a `DyFM_AudioMixer_Util.merge()` allit elo teljes settingset.
- */
-export interface DyFM_AudioMixer_Settings {
-    /** Fo-hangero (0..1) — minden csatornara szorzodik. */
-    master: number;
-    /** Zene-csatorna hangereje (0..1). */
-    music: number;
-    /** Kornyezeti hangok (ambience) csatorna hangereje (0..1). */
-    ambience: number;
-    /** Effekt-hangok csatorna hangereje (0..1). */
-    effects: number;
-    /** Globalis nemitas — ha true, minden effektiv hangero 0. */
-    muted: boolean;
-    /**
-     * Szoljon-e a hang, ha a tab/ablak nem aktiv. **Default: `false`.**
-     *
-     * **OPCIONALIS** — szandekosan, hogy a mezo bevezetese ne legyen torо valtozas a round-1
-     * alakot mar hasznalo projekteknek. A letezese viszont azt biztositja, hogy a klasszikus
-     * oda-vissza konverzio (`toClassicSettings` -> `fromClassicSettings`) NE veszitse el a
-     * kapcsolot.
-     */
-    playWhenUnfocused?: boolean;
-}
+/**
+ * A jatek-audio mixer beallitasai — csatornankent 0..1 hangero + globalis nemitas.
+ *
+ * **Miert bedrock:** ez az interfesz a flottaban NEGY helyen elt egymastol fuggetlenul,
+ * karakterre azonos alakban (`pcr-audio-settings.interface.ts`, `pcs-audio-settings.interface.ts`,
+ * `pg-audio-settings.interface.ts` + a Hero Coordinator sajat audio-service-e). Ez a kanonikus alak.
+ *
+ * **Mentheto:** tisztan JSON-serializalhato, tehat a jatek save-payload resze lehet.
+ * Reszleges/legacy payload-bol a `DyFM_AudioMixer_Util.merge()` allit elo teljes settingset.
+ */
+export interface DyFM_AudioMixer_Settings {
+    /** Fo-hangero (0..1) — minden csatornara szorzodik. */
+    master: number;
+    /** Zene-csatorna hangereje (0..1). */
+    music: number;
+    /** Kornyezeti hangok (ambience) csatorna hangereje (0..1). */
+    ambience: number;
+    /** Effekt-hangok csatorna hangereje (0..1). */
+    effects: number;
+    /** Globalis nemitas — ha true, minden effektiv hangero 0. */
+    muted: boolean;
+    /**
+     * Szoljon-e a hang, ha a tab/ablak nem aktiv. **Default: `false`.**
+     *
+     * **OPCIONALIS** — szandekosan, hogy a mezo bevezetese ne legyen torо valtozas a round-1
+     * alakot mar hasznalo projekteknek. A letezese viszont azt biztositja, hogy a klasszikus
+     * oda-vissza konverzio (`toClassicSettings` -> `fromClassicSettings`) NE veszitse el a
+     * kapcsolot.
+     */
+    playWhenUnfocused?: boolean;
+}
 //# sourceMappingURL=audio-mixer-settings.interface.d.ts.map

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

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

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

@@ -1,31 +1,31 @@
-/**
- * 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;
-    /**
-     * Szoljon-e a hang akkor is, ha a **tab / ablak NEM aktiv** (hattervben van).
-     *
-     * **Alapertelmezes: `false`** — owner-direktiva. Egy hattervbe tett jatek alapbol NE szoljon
-     * bele a felhasznalo mas munkajaba; aki ezt akarja, az kapcsolja be. Ez a mezo CSAK a
-     * szandekot hordozza — a tenyleges szuneteltetest a lejatszo-reteg vegzi (bongeszo-fuggo
-     * `visibilitychange` / `blur`), mert a modell-reteg szandekosan DOM-fuggetlen.
-     *
-     * **Migracio:** a mezo nelkuli (regi) mentesek a `merge()`-ben a config alapertelmezeset
-     * kapjak, tehat egy regi save betoltese nem kapcsolja be veletlenul a hatter-hangot.
-     */
-    playWhenUnfocused: boolean;
-}
+/**
+ * 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;
+    /**
+     * Szoljon-e a hang akkor is, ha a **tab / ablak NEM aktiv** (hattervben van).
+     *
+     * **Alapertelmezes: `false`** — owner-direktiva. Egy hattervbe tett jatek alapbol NE szoljon
+     * bele a felhasznalo mas munkajaba; aki ezt akarja, az kapcsolja be. Ez a mezo CSAK a
+     * szandekot hordozza — a tenyleges szuneteltetest a lejatszo-reteg vegzi (bongeszo-fuggo
+     * `visibilitychange` / `blur`), mert a modell-reteg szandekosan DOM-fuggetlen.
+     *
+     * **Migracio:** a mezo nelkuli (regi) mentesek a `merge()`-ben a config alapertelmezeset
+     * kapjak, tehat egy regi save betoltese nem kapcsolja be veletlenul a hatter-hangot.
+     */
+    playWhenUnfocused: boolean;
+}
 //# sourceMappingURL=audio-mixer-state.interface.d.ts.map

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

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

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

@@ -1,130 +1,130 @@
-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;
-    /**
-     * A "szoljon-e hattervben" kapcsolo beallitasa — UJ allapot-objektumot ad vissza.
-     *
-     * A modell csak a SZANDEKOT tarolja; a tenyleges szuneteltetes a lejatszo-reteg dolga
-     * (`visibilitychange` / `blur`), mert ez a reteg DOM-fuggetlen.
-     */
-    withPlayWhenUnfocused(state: DyFM_AudioMixer_State, playWhenUnfocused: 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;
-}
+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;
+    /**
+     * A "szoljon-e hattervben" kapcsolo beallitasa — UJ allapot-objektumot ad vissza.
+     *
+     * A modell csak a SZANDEKOT tarolja; a tenyleges szuneteltetes a lejatszo-reteg dolga
+     * (`visibilitychange` / `blur`), mert ez a reteg DOM-fuggetlen.
+     */
+    withPlayWhenUnfocused(state: DyFM_AudioMixer_State, playWhenUnfocused: 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