@omnitronix/happy-panda-game-engine 0.5.1

package/dist/logic/handlers/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Logic handlers exports
+ */
+__exportStar(require("./spin-handler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/logic/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logic/handlers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,iDAA+B"}

package/dist/logic/handlers/spin-handler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Spin Handler
+ *
+ * Coordinates the entire spin flow:
+ * 1. Determine spin type
+ * 2. Generate grid
+ * 3. Evaluate wins
+ * 4. Update counters
+ * 5. Update jackpots
+ * 6. Determine next spin type
+ * 7. Build response
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, GameState, SpinWinResult, RngProvider } from '../../domain/types';
+export interface SpinResult {
+    /** Resulting screen (3x3 grid) */
+    screen: Grid;
+    /** Win evaluation results */
+    wins: SpinWinResult;
+    /** Updated game state */
+    state: GameState;
+    /** The spin type that was actually executed this spin */
+    executedSpinType: SpinType;
+    /** Progressive jackpot won (if any) */
+    jackpotWon: number;
+    /** Pool jackpot won (if any) */
+    poolJackpotWon: number;
+    /** Bonus type triggered this spin */
+    bonusTriggered: SpinType | null;
+    /** Is this the final spin of bonus sequence */
+    isBonusComplete: boolean;
+    /** Total player winning (required by RGS for balance crediting) */
+    playerWinning: number;
+}
+/**
+ * Execute a single spin.
+ */
+export declare function executeSpin(state: GameState, rng: RngProvider): Promise<SpinResult>;
+/** Minimum bet stake */
+export declare const MIN_BET_STAKE = 1;
+/** Maximum bet stake (reasonable upper bound) */
+export declare const MAX_BET_STAKE = 100;
+/**
+ * Validate bet parameters.
+ * @throws Error if parameters are invalid
+ */
+export declare function validateBetParams(gameDirection: GameDirection, betStake: number): void;
+/**
+ * Create initial game state.
+ * @throws Error if parameters are invalid
+ */
+export declare function createInitialState(gameDirection: GameDirection, betStake: number): GameState;
+/**
+ * Update state for new bet.
+ * @throws Error if parameters are invalid
+ */
+export declare function updateBet(state: GameState, gameDirection: GameDirection, betStake: number): GameState;
+//# sourceMappingURL=spin-handler.d.ts.map

package/dist/logic/handlers/spin-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spin-handler.d.ts","sourceRoot":"","sources":["../../../src/logic/handlers/spin-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,QAAQ,EAET,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAoB5B,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,MAAM,EAAE,IAAI,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,yDAAyD;IACzD,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;CACvB;AAqBD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAsLrB;AAMD,wBAAwB;AACxB,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,iDAAiD;AACjD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUtF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,SAAS,CAsCX;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,SAAS,CAiBX"}

package/dist/logic/handlers/spin-handler.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Spin Handler
+ *
+ * Coordinates the entire spin flow:
+ * 1. Determine spin type
+ * 2. Generate grid
+ * 3. Evaluate wins
+ * 4. Update counters
+ * 5. Update jackpots
+ * 6. Determine next spin type
+ * 7. Build response
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_BET_STAKE = exports.MIN_BET_STAKE = void 0;
+exports.executeSpin = executeSpin;
+exports.validateBetParams = validateBetParams;
+exports.createInitialState = createInitialState;
+exports.updateBet = updateBet;
+const happy_panda_config_1 = require("../../config/happy-panda.config");
+const types_1 = require("../../domain/types");
+const spin_generator_1 = require("../../rng/spin-generator");
+const win_evaluator_1 = require("../services/win-evaluator");
+const counter_manager_1 = require("../services/counter-manager");
+const jackpot_manager_1 = require("../services/jackpot-manager");
+// =============================================================================
+// SPIN TYPE TO BONUS TYPE MAPPING
+// =============================================================================
+function bonusTypeToSpinType(bonusType) {
+    switch (bonusType) {
+        case 'bambooTriplets': return happy_panda_config_1.SpinType.BONUS_BAMBOO_TRIPLETS;
+        case 'bambooTwins': return happy_panda_config_1.SpinType.BONUS_BAMBOO_TWINS;
+        case 'camera': return happy_panda_config_1.SpinType.BONUS_CAMERA;
+        case 'fireworks': return happy_panda_config_1.SpinType.BONUS_FIREWORKS;
+        case 'centerBamboo': return happy_panda_config_1.SpinType.RESPIN_CENTER_BAMBOO;
+        default: return happy_panda_config_1.SpinType.BASE_GAME_SPIN;
+    }
+}
+// =============================================================================
+// MAIN SPIN EXECUTION
+// =============================================================================
+/**
+ * Execute a single spin.
+ */
+async function executeSpin(state, rng) {
+    const { gameDirection, betStake, betGame, currentSpinType, spinsRemaining, counters, pendingBonuses, jackpots, centerBambooSymbol, } = state;
+    // Step 1: Generate grid based on spin type
+    // For RESPIN_CENTER_BAMBOO, pass the previous grid (state.screen) so edge positions
+    // can be preserved from the triggering paid_spin, matching C++ ScreenRespinCherry() behavior
+    const isRespin = currentSpinType === happy_panda_config_1.SpinType.RESPIN_CENTER_BAMBOO;
+    const grid = await (0, spin_generator_1.generateGrid)(currentSpinType, gameDirection, rng, isRespin ? centerBambooSymbol ?? undefined : undefined, isRespin ? state.screen : undefined);
+    // Step 2: Evaluate wins
+    const wins = (0, win_evaluator_1.evaluateSpin)(grid, gameDirection, betStake, betGame, currentSpinType);
+    // Step 3: Handle special jackpot bonus logic
+    let jackpotWon = 0;
+    let poolJackpotWon = 0;
+    let updatedJackpots = { ...jackpots };
+    if (currentSpinType === happy_panda_config_1.SpinType.BONUS_BAMBOO_TRIPLETS) {
+        // Every bamboo triplets bonus spin gets the ADD_WIN bonus (C++ Main Logic line 59)
+        // "please note scenario: each screen gets such winning, independent on pieces panda wins"
+        jackpotWon = happy_panda_config_1.BONUS_BAMBOO_TRIPLETS.ADD_WIN * betGame;
+        // Full panda piece = ALSO triggers progressive jackpot payout
+        if ((0, spin_generator_1.isCompletePandaPiece)(grid)) {
+            const { payout, newValue } = (0, jackpot_manager_1.payProgressiveJackpot)(jackpots.bonusJackpotValue, betGame);
+            jackpotWon += payout;
+            updatedJackpots.bonusJackpotValue = newValue;
+        }
+    }
+    // Step 4: Update counters (only on paid spin and respin)
+    let updatedCounters = { ...counters };
+    let updatedPending = { ...pendingBonuses };
+    let bonusTriggered = null;
+    if (currentSpinType === happy_panda_config_1.SpinType.BASE_GAME_SPIN || currentSpinType === happy_panda_config_1.SpinType.RESPIN_CENTER_BAMBOO) {
+        const counterResult = await (0, counter_manager_1.updateCounters)(counters, pendingBonuses, wins.lineWins, grid, gameDirection, currentSpinType, wins.totalPayout, rng);
+        updatedCounters = counterResult.counters;
+        updatedPending = counterResult.pendingBonuses;
+        // Determine triggered bonus (for animation/display)
+        if (counterResult.triggeredBambooTriplets) {
+            bonusTriggered = happy_panda_config_1.SpinType.BONUS_BAMBOO_TRIPLETS;
+        }
+        else if (counterResult.triggeredBambooTwins) {
+            bonusTriggered = happy_panda_config_1.SpinType.BONUS_BAMBOO_TWINS;
+        }
+        else if (counterResult.triggeredCamera) {
+            bonusTriggered = happy_panda_config_1.SpinType.BONUS_CAMERA;
+            // Camera bonus also pays pool jackpot
+            const poolResult = (0, jackpot_manager_1.payPoolJackpot)(jackpots.poolJackpotValue, betGame);
+            poolJackpotWon = poolResult.payout;
+            updatedJackpots.poolJackpotValue = poolResult.newValue;
+        }
+        else if (counterResult.triggeredFireworks) {
+            bonusTriggered = happy_panda_config_1.SpinType.BONUS_FIREWORKS;
+        }
+        else if (counterResult.triggeredRespin > 0) {
+            bonusTriggered = happy_panda_config_1.SpinType.RESPIN_CENTER_BAMBOO;
+        }
+    }
+    // Step 5: Update jackpots (progressive and pool on paid spins)
+    if (currentSpinType === happy_panda_config_1.SpinType.BASE_GAME_SPIN) {
+        const jackpotUpdate = await (0, jackpot_manager_1.updateJackpots)(updatedJackpots, grid, gameDirection, betGame, betStake, currentSpinType, wins.totalPayout, rng);
+        updatedJackpots = jackpotUpdate.jackpots;
+    }
+    // Step 6: Determine next spin type and remaining spins
+    let nextSpinType = happy_panda_config_1.SpinType.BASE_GAME_SPIN;
+    let nextSpinsRemaining = 0;
+    let newAccumulatedBonusWins = state.accumulatedBonusWins;
+    let newCenterBambooSymbol = state.centerBambooSymbol;
+    let isBonusComplete = false;
+    // Handle ongoing bonus spins
+    if (currentSpinType !== happy_panda_config_1.SpinType.BASE_GAME_SPIN && spinsRemaining > 1) {
+        // Continue current bonus
+        nextSpinType = currentSpinType;
+        nextSpinsRemaining = spinsRemaining - 1;
+        newAccumulatedBonusWins += wins.totalPayout + jackpotWon + poolJackpotWon;
+    }
+    else if (currentSpinType !== happy_panda_config_1.SpinType.BASE_GAME_SPIN && spinsRemaining === 1) {
+        // Bonus sequence ending, check for more pending bonuses
+        newAccumulatedBonusWins += wins.totalPayout + jackpotWon + poolJackpotWon;
+        const nextBonusType = (0, counter_manager_1.getNextBonusType)(updatedPending);
+        if (nextBonusType) {
+            // Start next bonus
+            const { pending: newPending, spins } = (0, counter_manager_1.consumeBonus)(updatedPending, nextBonusType);
+            updatedPending = newPending;
+            nextSpinType = bonusTypeToSpinType(nextBonusType);
+            nextSpinsRemaining = spins;
+            // Set center bamboo symbol if starting respin
+            if (nextBonusType === 'centerBamboo') {
+                newCenterBambooSymbol = grid[1][1];
+            }
+        }
+        else {
+            // All bonuses complete, return to paid spin
+            nextSpinType = happy_panda_config_1.SpinType.BASE_GAME_SPIN;
+            nextSpinsRemaining = 0;
+            isBonusComplete = true;
+            newAccumulatedBonusWins = 0; // Reset for next bonus sequence
+            newCenterBambooSymbol = null;
+            // Reset bambooTriplets counter to ready state (#16)
+            updatedCounters.bambooTriplets = happy_panda_config_1.BONUS_BAMBOO_TRIPLETS.COUNTER_INIT;
+        }
+    }
+    else if (currentSpinType === happy_panda_config_1.SpinType.BASE_GAME_SPIN) {
+        // Check if any bonuses were triggered
+        const nextBonusType = (0, counter_manager_1.getNextBonusType)(updatedPending);
+        if (nextBonusType) {
+            const { pending: newPending, spins } = (0, counter_manager_1.consumeBonus)(updatedPending, nextBonusType);
+            updatedPending = newPending;
+            nextSpinType = bonusTypeToSpinType(nextBonusType);
+            nextSpinsRemaining = spins;
+            // Set center bamboo symbol if starting respin
+            if (nextBonusType === 'centerBamboo') {
+                newCenterBambooSymbol = grid[1][1];
+            }
+        }
+    }
+    // Build updated state
+    const updatedState = {
+        ...state,
+        currentSpinType: nextSpinType,
+        nextSpinType,
+        spinsRemaining: nextSpinsRemaining,
+        counters: updatedCounters,
+        pendingBonuses: updatedPending,
+        jackpots: updatedJackpots,
+        screen: grid,
+        accumulatedBonusWins: newAccumulatedBonusWins,
+        centerBambooSymbol: newCenterBambooSymbol,
+    };
+    // Calculate total player winning for RGS compatibility
+    const playerWinning = wins.totalPayout + jackpotWon + poolJackpotWon;
+    return {
+        screen: grid,
+        wins,
+        state: updatedState,
+        executedSpinType: currentSpinType,
+        jackpotWon,
+        poolJackpotWon,
+        bonusTriggered,
+        isBonusComplete,
+        playerWinning, // Required by RGS for win crediting
+    };
+}
+// =============================================================================
+// STATE INITIALIZATION
+// =============================================================================
+/** Minimum bet stake */
+exports.MIN_BET_STAKE = 1;
+/** Maximum bet stake (reasonable upper bound) */
+exports.MAX_BET_STAKE = 100;
+/**
+ * Validate bet parameters.
+ * @throws Error if parameters are invalid
+ */
+function validateBetParams(gameDirection, betStake) {
+    if (gameDirection !== types_1.GameDirection.SINGLE && gameDirection !== types_1.GameDirection.BOTH) {
+        throw new Error(`Invalid game direction: ${gameDirection}. Must be 0 (8 lines) or 1 (16 lines)`);
+    }
+    if (!Number.isInteger(betStake)) {
+        throw new Error(`Bet stake must be an integer, got: ${betStake}`);
+    }
+    if (betStake < exports.MIN_BET_STAKE || betStake > exports.MAX_BET_STAKE) {
+        throw new Error(`Bet stake must be between ${exports.MIN_BET_STAKE} and ${exports.MAX_BET_STAKE}, got: ${betStake}`);
+    }
+}
+/**
+ * Create initial game state.
+ * @throws Error if parameters are invalid
+ */
+function createInitialState(gameDirection, betStake) {
+    validateBetParams(gameDirection, betStake);
+    const baseBet = gameDirection === types_1.GameDirection.SINGLE ? 8 : 16;
+    const betGame = baseBet * betStake;
+    return {
+        gameDirection,
+        betStake,
+        betGame,
+        currentSpinType: happy_panda_config_1.SpinType.BASE_GAME_SPIN,
+        nextSpinType: happy_panda_config_1.SpinType.BASE_GAME_SPIN,
+        spinsRemaining: 0,
+        counters: {
+            bambooTriplets: 1,
+            bambooTwins: 9, // Will be randomized on first trigger
+            camera: 5, // Will be randomized on first trigger
+            fireworks: 1,
+        },
+        pendingBonuses: {
+            bambooTriplets: 0,
+            bambooTwins: 0,
+            camera: 0,
+            fireworks: 0,
+            centerBamboo: 0,
+        },
+        jackpots: {
+            bonusJackpotValue: 100 * betGame,
+            poolJackpotValue: 0,
+        },
+        screen: [
+            [happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE],
+            [happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE],
+            [happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE, happy_panda_config_1.Symbol.NONE],
+        ],
+        accumulatedBonusWins: 0,
+        centerBambooSymbol: null,
+    };
+}
+/**
+ * Update state for new bet.
+ * @throws Error if parameters are invalid
+ */
+function updateBet(state, gameDirection, betStake) {
+    validateBetParams(gameDirection, betStake);
+    // Can only change bet during paid spin with no pending bonuses
+    if (state.currentSpinType !== happy_panda_config_1.SpinType.BASE_GAME_SPIN || (0, counter_manager_1.hasPendingBonus)(state.pendingBonuses)) {
+        throw new Error('Cannot change bet during bonus or with pending bonuses');
+    }
+    const baseBet = gameDirection === types_1.GameDirection.SINGLE ? 8 : 16;
+    const betGame = baseBet * betStake;
+    return {
+        ...state,
+        gameDirection,
+        betStake,
+        betGame,
+    };
+}
+//# sourceMappingURL=spin-handler.js.map

package/dist/logic/handlers/spin-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spin-handler.js","sourceRoot":"","sources":["../../../src/logic/handlers/spin-handler.ts"],"names":[],"mappings":"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"}

package/dist/logic/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Logic module exports
+ */
+export * from './services';
+export * from './handlers';
+//# sourceMappingURL=index.d.ts.map

package/dist/logic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logic/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/logic/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Logic module exports
+ */
+__exportStar(require("./services"), exports);
+__exportStar(require("./handlers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/logic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logic/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,6CAA2B;AAC3B,6CAA2B"}

package/dist/logic/services/counter-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Counter Manager Service
+ *
+ * Manages bonus counters and trigger detection.
+ * Each bonus type has a counter that decrements on specific events.
+ * When a counter reaches 0, the bonus is triggered.
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, BonusCounters, PendingBonuses, LineWin, RngProvider } from '../../domain/types';
+/**
+ * Create initial bonus counters.
+ */
+export declare function createInitialCounters(): BonusCounters;
+/**
+ * Create empty pending bonuses.
+ */
+export declare function createEmptyPendingBonuses(): PendingBonuses;
+/**
+ * Randomize Bamboo Twins counter initial value (6 or 9).
+ */
+export declare function randomizeBambooTwinsCounter(gameDirection: GameDirection, rng: RngProvider): Promise<number>;
+/**
+ * Randomize Camera counter initial value (3 or 5).
+ */
+export declare function randomizeCameraCounter(gameDirection: GameDirection, rng: RngProvider): Promise<number>;
+/** Result of counter update */
+export interface CounterUpdateResult {
+    counters: BonusCounters;
+    pendingBonuses: PendingBonuses;
+    triggeredBambooTriplets: boolean;
+    triggeredBambooTwins: boolean;
+    triggeredCamera: boolean;
+    triggeredFireworks: boolean;
+    triggeredRespin: number;
+}
+/**
+ * Update counters based on spin results.
+ * Only applies during paid_spin and respin_cherry.
+ */
+export declare function updateCounters(currentCounters: BonusCounters, currentPending: PendingBonuses, lineWins: LineWin[], grid: Grid, gameDirection: GameDirection, spinType: SpinType, totalWin: number, rng: RngProvider): Promise<CounterUpdateResult>;
+/** Bonus type to consume */
+export type BonusType = 'bambooTriplets' | 'bambooTwins' | 'camera' | 'fireworks' | 'centerBamboo';
+/**
+ * Get the next bonus type to execute (priority order).
+ * Returns null if no bonuses pending.
+ */
+export declare function getNextBonusType(pending: PendingBonuses): BonusType | null;
+/**
+ * Consume one bonus from pending.
+ * Returns updated pending and number of spins for that bonus.
+ */
+export declare function consumeBonus(pending: PendingBonuses, bonusType: BonusType): {
+    pending: PendingBonuses;
+    spins: number;
+};
+/**
+ * Check if any bonus is pending.
+ */
+export declare function hasPendingBonus(pending: PendingBonuses): boolean;
+//# sourceMappingURL=counter-manager.d.ts.map

package/dist/logic/services/counter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-manager.d.ts","sourceRoot":"","sources":["../../../src/logic/services/counter-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,QAAQ,EAOT,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAO5B;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAOrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,CAQ1D;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAMD,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,uBAAuB,EAAE,OAAO,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,aAAa,EAC9B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,mBAAmB,CAAC,CA2I9B;AAMD,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,GACnB;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsC5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAQhE"}