@futdevpro/fsm-dynamo 1.16.39 → 1.20.2

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

@@ -1,18 +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;
-}
+/**
+ * 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.js

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

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

@@ -1,17 +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;
-}
+/**
+ * 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.js

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

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

@@ -1,125 +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[];
-}
+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