@futdevpro/fsm-dynamo 1.16.29 → 1.16.31

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

@@ -0,0 +1,55 @@
+import { DyFM_AudioChannel } from '../_enums/audio-channel.enum';
+import { DyFM_AudioMixer_Settings } from '../_models/audio-mixer-settings.interface';
+/**
+ * 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;
+ * ```
+ */
+export declare class DyFM_AudioMixer_Util {
+    /** Alapertelmezett hangero minden csatornara (0..1). */
+    private static readonly defaultVolume;
+    /**
+     * Az alapertelmezett mixer-beallitas. Minden hivas UJ objektumot ad vissza, hogy a
+     * hivo szabadon mutalhassa (nincs megosztott referencia).
+     */
+    static getDefaults(): DyFM_AudioMixer_Settings;
+    /**
+     * 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: number, fallback?: number): number;
+    /**
+     * 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?: Partial<DyFM_AudioMixer_Settings> | null): DyFM_AudioMixer_Settings;
+    /**
+     * 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: DyFM_AudioMixer_Settings, channel: DyFM_AudioChannel): number;
+    /**
+     * Egy csatorna hangerejenek beallitasa — UJ settings-objektumot ad vissza (immutable update),
+     * hogy signal-/state-alapu tarolokban is biztonsagos legyen.
+     */
+    static withChannelVolume(settings: DyFM_AudioMixer_Settings, channel: DyFM_AudioChannel, volume: number): DyFM_AudioMixer_Settings;
+    /** Nemitas beallitasa — UJ settings-objektumot ad vissza (immutable update). */
+    static withMuted(settings: DyFM_AudioMixer_Settings, muted: boolean): DyFM_AudioMixer_Settings;
+    /** Ket beallitas ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
+    static isEqual(a: DyFM_AudioMixer_Settings, b: DyFM_AudioMixer_Settings): boolean;
+}
+//# sourceMappingURL=audio-mixer.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_collections/audio-mixer.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAoB;IAE/B,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAe;IAEpD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAU9C;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA2C,GAAG,MAAM;IAgB1F;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,GAAG,wBAAwB;IAgB1F;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,GACzB,MAAM;IAcT;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACb,wBAAwB;IAO3B,gFAAgF;IAChF,MAAM,CAAC,SAAS,CACd,QAAQ,EAAE,wBAAwB,EAClC,KAAK,EAAE,OAAO,GACb,wBAAwB;IAO3B,4FAA4F;IAC5F,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,wBAAwB,GAAG,OAAO;CAUlF"}

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

@@ -0,0 +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;
+//# sourceMappingURL=audio-mixer.util.js.map

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

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

package/build/_modules/game/_enums/audio-channel.enum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A jatek-audio mixer csatornai.
+ *
+ * A flotta NEGY jateka egymastol fuggetlenul ugyanezt a negy csatornat vezette be
+ * (Prototyper: Room Cats / Cell Stage / Portalhold, plusz a Hero Coordinator) — ez az
+ * enum a kanonikus nevezektan, amire mindegyik ratert.
+ *
+ * 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-channel.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB"}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AudioChannel = void 0;
+/**
+ * A jatek-audio mixer csatornai.
+ *
+ * A flotta NEGY jateka egymastol fuggetlenul ugyanezt a negy csatornat vezette be
+ * (Prototyper: Room Cats / Cell Stage / Portalhold, plusz a Hero Coordinator) — ez az
+ * enum a kanonikus nevezektan, amire mindegyik ratert.
+ *
+ * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-channel.enum.js","sourceRoot":"","sources":["../../../../src/_modules/game/_enums/audio-channel.enum.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;GASG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;AACrB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

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

@@ -0,0 +1,23 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=audio-mixer-settings.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mixer-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer-settings.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;CAChB"}

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

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

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

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

package/build/_modules/game/_models/seeded-random-state.interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A `DyFM_SeededRandom` teljes belso allapota — 4 db 32-bites egesz (sfc32).
+ *
+ * Tisztan JSON-serializalhato, tehat **a jatek save-payload resze lehet**: a mentes utan
+ * visszatoltve a veletlen-sorozat PONTOSAN ott folytatodik, ahol abbamaradt.
+ */
+export interface DyFM_SeededRandom_State {
+    /** sfc32 allapot-szo #1. */
+    a: number;
+    /** sfc32 allapot-szo #2. */
+    b: number;
+    /** sfc32 allapot-szo #3. */
+    c: number;
+    /** sfc32 counter-szo. */
+    d: number;
+}
+//# sourceMappingURL=seeded-random-state.interface.d.ts.map

package/build/_modules/game/_models/seeded-random-state.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeded-random-state.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/seeded-random-state.interface.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;CACX"}

package/build/_modules/game/_models/seeded-random-state.interface.js

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

package/build/_modules/game/_models/seeded-random-state.interface.js.map

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

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

@@ -0,0 +1,125 @@
+import { DyFM_RandomWeight } from '../../../_models/interfaces/random-weight.interface';
+import { DyFM_SeededRandom_State } from './seeded-random-state.interface';
+/**
+ * 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.
+ */
+export declare class DyFM_SeededRandom {
+    /** 2^32 — a 32 bites egeszek normalizalasahoz. */
+    private static readonly uint32Range;
+    /** sfc32 allapot-szo #1. */
+    private a;
+    /** sfc32 allapot-szo #2. */
+    private b;
+    /** sfc32 allapot-szo #3. */
+    private c;
+    /** sfc32 counter-szo. */
+    private d;
+    /**
+     * Kozvetlen allapotbol epit. A tipikus belepesi pont a `fromSeed()` / `fromState()`
+     * statikus factory.
+     */
+    constructor(state: DyFM_SeededRandom_State);
+    /**
+     * Generator letrehozasa seed-bol. A seed lehet string (pl. mentett `worldSeed`) vagy szam.
+     * Ugyanaz a seed MINDIG ugyanazt a sorozatot adja.
+     */
+    static fromSeed(seed: string | number): DyFM_SeededRandom;
+    /** Generator letrehozasa korabban elmentett allapotbol (save-betoltes). */
+    static fromState(state: DyFM_SeededRandom_State): DyFM_SeededRandom;
+    /**
+     * String seed -> 4x32 bites allapot (cyrb128). Determinisztikus es jol szoro:
+     * a `'a'` es `'b'` seed teljesen kulonbozo sorozatot ad.
+     */
+    private static hashSeed;
+    /** A generator teljes allapotanak masolata — ezt kell a save-payloadba tenni. */
+    getState(): DyFM_SeededRandom_State;
+    /** Allapot visszatoltese — a sorozat innentol az elmentett ponton folytatodik. */
+    setState(state: DyFM_SeededRandom_State): void;
+    /**
+     * 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(): DyFM_SeededRandom;
+    /**
+     * A kovetkezo veletlen lebegopontos szam a `[0, 1)` tartomanybol (sfc32 mag).
+     * Minden mas metodus erre epul.
+     */
+    nextFloat(): number;
+    /**
+     * Veletlen egesz a `[min, max]` tartomanybol (mindket veg ZART) — a `DyFM_Random.getRandomInt`
+     * seedelt parja. Ha `max < min`, a ket erteket felcsereli.
+     */
+    nextInt(min: number, max: number): number;
+    /** A `DyFM_Random.getRandomInt` API-paritas alias — l. `nextInt`. */
+    getRandomInt(min: number, max: number): number;
+    /** Veletlen lebegopontos szam a `[min, max)` tartomanybol. */
+    nextRange(min: number, max: number): number;
+    /**
+     * Veletlen logikai ertek. A `chance` a `true` valoszinusege (0..1; default 0.5).
+     */
+    nextBool(chance?: number): boolean;
+    /**
+     * Veletlen elem a listabol (`null`, ha a lista ures) — a `DyFM_Random.getRandomListElement`
+     * seedelt parja.
+     */
+    getRandomListElement<T>(list: T[]): T | null;
+    /**
+     * 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<T>(weights: DyFM_RandomWeight<T>[]): T | null;
+    /**
+     * Sulyozott veletlen egesz — a `DyFM_Random.getRandomWeightedInt` seedelt parja.
+     * Ha a sulyozas nem ad talalatot, `nextInt(min, max)`-ra esik vissza.
+     */
+    getRandomWeightedInt(min: number, max: number, weights: DyFM_RandomWeight<number>[]): number;
+    /**
+     * Fisher-Yates keveres — UJ tombot ad vissza, a bemenetet nem mutalja.
+     */
+    shuffle<T>(list: T[]): T[];
+    /**
+     * `count` darab KULONBOZO elem kivalasztasa a listabol (sorrendje veletlen).
+     * Ha `count` nagyobb a lista hosszanal, a teljes (megkevert) listat adja vissza.
+     */
+    pick<T>(list: T[], count: number): T[];
+}
+//# sourceMappingURL=seeded-random.control-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeded-random.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/seeded-random.control-model.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAExF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,iBAAiB;IAE5B,kDAAkD;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAEzD,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,yBAAyB;IACzB,OAAO,CAAC,CAAC,CAAS;IAElB;;;OAGG;gBACS,KAAK,EAAE,uBAAuB;IAgB1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB;IAYzD,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,iBAAiB;IAInE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IA4BvB,iFAAiF;IACjF,QAAQ,IAAI,uBAAuB;IAInC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAgB9C;;;;;OAKG;IACH,KAAK,IAAI,iBAAiB;IAI1B;;;OAGG;IACH,SAAS,IAAI,MAAM;IAiBnB;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzC,qEAAqE;IACrE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAI9C,8DAA8D;IAC9D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAO3C;;OAEG;IACH,QAAQ,CAAC,MAAM,GAAE,MAAY,GAAG,OAAO;IAIvC;;;OAGG;IACH,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IAQ5C;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IA2B/D;;;OAGG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM;IAU5F;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAiB1B;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;CAOvC"}