@omnitronix/happy-panda-game-engine 0.5.1

package/dist/rng/rng-client.factory.d.ts

@@ -0,0 +1,33 @@
+/**
+ * RNG Client Factory
+ *
+ * Factory pattern for creating RNG clients based on environment configuration.
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ *
+ * Environment Variables:
+ * - RNG_CLIENT_MODE: 'local' (DummyRngClient) or 'external' (production RngClient)
+ * - RNG_CLIENT_URL: HTTP endpoint for external RNG service
+ * - RNG_CLIENT_GRPC_URL: gRPC endpoint for external RNG service
+ * - RNG_CLIENT_METHOD: 'grpc' or 'rest'
+ * - RNG_CLIENT_POOL_SIZE: Ring buffer pool size (default: 2000)
+ */
+import { IRngClient } from './rng-client.interface';
+export interface RngClientConfig {
+    serverUrl?: string;
+    grpcUrl?: string;
+    clientMethod?: 'grpc' | 'rest';
+    poolingSize?: number;
+    metrics?: unknown;
+}
+export declare class RngClientFactory {
+    /**
+     * Create an RNG client based on environment configuration.
+     *
+     * @param config Optional configuration overrides
+     * @returns IRngClient instance (DummyRngClient for local, external client for production)
+     */
+    static create(config?: {
+        metrics?: unknown;
+    }): IRngClient;
+}
+//# sourceMappingURL=rng-client.factory.d.ts.map

package/dist/rng/rng-client.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-client.factory.d.ts","sourceRoot":"","sources":["../../src/rng/rng-client.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,UAAU;CAqC9D"}

package/dist/rng/rng-client.factory.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * RNG Client Factory
+ *
+ * Factory pattern for creating RNG clients based on environment configuration.
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ *
+ * Environment Variables:
+ * - RNG_CLIENT_MODE: 'local' (DummyRngClient) or 'external' (production RngClient)
+ * - RNG_CLIENT_URL: HTTP endpoint for external RNG service
+ * - RNG_CLIENT_GRPC_URL: gRPC endpoint for external RNG service
+ * - RNG_CLIENT_METHOD: 'grpc' or 'rest'
+ * - RNG_CLIENT_POOL_SIZE: Ring buffer pool size (default: 2000)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RngClientFactory = void 0;
+const dummy_rng_client_1 = require("./dummy-rng-client");
+class RngClientFactory {
+    /**
+     * Create an RNG client based on environment configuration.
+     *
+     * @param config Optional configuration overrides
+     * @returns IRngClient instance (DummyRngClient for local, external client for production)
+     */
+    static create(config = {}) {
+        const mode = process.env.RNG_CLIENT_MODE || 'external';
+        if (mode === 'local') {
+            console.log('[RngClientFactory] Creating DummyRngClient (local mode)');
+            return new dummy_rng_client_1.DummyRngClient();
+        }
+        // For external mode, we would use @omnitronix/rng-client-core
+        // For now, fall back to DummyRngClient if external client not available
+        console.log('[RngClientFactory] External RNG mode requested');
+        const rngClientConfig = {
+            serverUrl: process.env.RNG_CLIENT_URL,
+            grpcUrl: process.env.RNG_CLIENT_GRPC_URL,
+            clientMethod: process.env.RNG_CLIENT_METHOD,
+            poolingSize: parseInt(process.env.RNG_CLIENT_POOL_SIZE || '2000'),
+            metrics: config.metrics,
+        };
+        // Try to load external RNG client
+        try {
+            // Dynamic import to avoid hard dependency
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { RngClient } = require('@omnitronix/rng-client-core');
+            console.log('[RngClientFactory] Creating external RngClient');
+            return new RngClient(rngClientConfig);
+        }
+        catch (error) {
+            console.warn('[RngClientFactory] @omnitronix/rng-client-core not available, falling back to DummyRngClient');
+            console.warn('[RngClientFactory] Install @omnitronix/rng-client-core for production use');
+            return new dummy_rng_client_1.DummyRngClient();
+        }
+    }
+}
+exports.RngClientFactory = RngClientFactory;
+//# sourceMappingURL=rng-client.factory.js.map

package/dist/rng/rng-client.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-client.factory.js","sourceRoot":"","sources":["../../src/rng/rng-client.factory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAGH,yDAAoD;AAUpD,MAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,SAAgC,EAAE;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC;QAEvD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;YACvE,OAAO,IAAI,iCAAc,EAAE,CAAC;QAC9B,CAAC;QAED,8DAA8D;QAC9D,wEAAwE;QACxE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAE9D,MAAM,eAAe,GAAoB;YACvC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YACxC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAoC;YAC9D,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,MAAM,CAAC;YACjE,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;QAEF,kCAAkC;QAClC,IAAI,CAAC;YACH,0CAA0C;YAC1C,8DAA8D;YAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,8FAA8F,CAC/F,CAAC;YACF,OAAO,CAAC,IAAI,CACV,2EAA2E,CAC5E,CAAC;YACF,OAAO,IAAI,iCAAc,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AA5CD,4CA4CC"}

package/dist/rng/rng-client.interface.d.ts

@@ -0,0 +1,51 @@
+/**
+ * RNG Client Interface
+ *
+ * Contract for all RNG clients (local and external).
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ */
+export interface RngSingleResponse {
+    value: number;
+    seed: number;
+}
+export interface RngBatchResponse {
+    values: number[];
+    seeds: number[];
+}
+/**
+ * RNG Client Interface
+ *
+ * All RNG clients must implement this interface to ensure
+ * consistent behavior between local (testing) and external (production) clients.
+ */
+export interface IRngClient {
+    /**
+     * Generate a single random integer in range [min, max]
+     */
+    getSingleNumber(min: number, max: number, seed?: number): Promise<RngSingleResponse>;
+    /**
+     * Generate multiple random integers in range [min, max]
+     */
+    getBatchNumbers(min: number, max: number, count: number, seed?: number): Promise<number[]>;
+    /**
+     * Generate multiple random integers with individual seeds
+     */
+    getBatchNumbersWithSeeds(min: number, max: number, count: number, seed?: number): Promise<RngSingleResponse[]>;
+    /**
+     * Generate a single random float in range [0, 1)
+     */
+    getSingleFloat(seed?: number): Promise<RngSingleResponse>;
+    /**
+     * Generate multiple random floats in range [0, 1)
+     */
+    getBatchFloats(count: number, seed?: number): Promise<RngBatchResponse>;
+    /**
+     * Alternative method for single random number
+     */
+    getRandomNumber(min: number, max: number, seed?: number): Promise<RngSingleResponse>;
+    /**
+     * Alternative method for single random float
+     */
+    getRandomFloat(seed?: number): Promise<RngSingleResponse>;
+}
+//# sourceMappingURL=rng-client.interface.d.ts.map

package/dist/rng/rng-client.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-client.interface.d.ts","sourceRoot":"","sources":["../../src/rng/rng-client.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,wBAAwB,CACtB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1D;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAExE;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;OAEG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D"}

package/dist/rng/rng-client.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * RNG Client Interface
+ *
+ * Contract for all RNG clients (local and external).
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rng-client.interface.js.map

package/dist/rng/rng-client.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-client.interface.js","sourceRoot":"","sources":["../../src/rng/rng-client.interface.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/rng/rng-service.d.ts

@@ -0,0 +1,93 @@
+/**
+ * RNG Service
+ *
+ * Core RNG service with audit trail tracking for compliance.
+ * Wraps an IRngClient and tracks all RNG outcomes per command.
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ */
+import { IRngClient } from './rng-client.interface';
+/**
+ * RNG outcome record for audit trail
+ */
+export interface RngOutcomeRecord {
+    result: number;
+    seed: number;
+    min: number;
+    max: number;
+}
+/**
+ * RNG outcomes for a single command, keyed by action ID
+ */
+export type RngOutcome = {
+    [actionId: string]: RngOutcomeRecord;
+};
+/**
+ * RNG Service
+ *
+ * Provides RNG operations with full audit trail tracking.
+ * Each command ID can have multiple action IDs, allowing fine-grained tracking
+ * of all RNG calls within a single game command.
+ */
+export declare class RngService {
+    private readonly rngClient;
+    private rngOutcomes;
+    constructor(rngClient: IRngClient);
+    /**
+     * Register a command for RNG tracking.
+     * Call this at the start of command processing.
+     */
+    registerCommand(commandId: string): void;
+    /**
+     * Remove a command's RNG outcomes.
+     * Call this after command processing to clean up.
+     */
+    removeCommand(commandId: string): void;
+    /**
+     * Check if a command has RNG outcomes
+     */
+    hasCommandRngOutcome(commandId: string): boolean;
+    /**
+     * Get the count of RNG outcomes for a command
+     */
+    getRngOutcomeCountForCommand(commandId: string): number;
+    /**
+     * Store an RNG outcome for audit trail
+     */
+    private storeSeedForCommand;
+    /**
+     * Get cached seed for a command/action (for replay scenarios)
+     */
+    getSeedForCommand(commandId: string, actionId: string): number | undefined;
+    /**
+     * Get all RNG outcomes for a command
+     */
+    getRngOutcomeForCommand(commandId: string): RngOutcome;
+    /**
+     * Get all RNG outcomes across all commands
+     */
+    getAllRngOutcome(): {
+        [commandId: string]: RngOutcome;
+    };
+    /**
+     * Generate a single random integer in range [min, max]
+     * Tracks the outcome for audit trail
+     */
+    getSingleNumber(min: number, max: number, commandId: string, actionId: string): Promise<{
+        value: number;
+        seed: number;
+    }>;
+    /**
+     * Generate multiple random integers in range [min, max]
+     * Each number is tracked individually with incrementing action IDs
+     */
+    getBatchNumbers(min: number, max: number, count: number, commandId: string, actionId: string): Promise<{
+        value: number;
+        seed: number;
+    }[]>;
+    /**
+     * Generate a weighted random selection
+     * Returns the index selected based on weights
+     */
+    getWeightedRandomIndex(weights: number[], commandId: string, actionId: string): Promise<number>;
+}
+//# sourceMappingURL=rng-service.d.ts.map

package/dist/rng/rng-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-service.d.ts","sourceRoot":"","sources":["../../src/rng/rng-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAElE;;;;;;GAMG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,WAAW,CAA2C;gBAEjC,SAAS,EAAE,UAAU;IAElD;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMxC;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAKvD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1E;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAItD;;OAEG;IACH,gBAAgB,IAAI;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE;IAIvD;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB3C;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAgB7C;;;OAGG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;CAmBnB"}

package/dist/rng/rng-service.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * RNG Service
+ *
+ * Core RNG service with audit trail tracking for compliance.
+ * Wraps an IRngClient and tracks all RNG outcomes per command.
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RngService = void 0;
+/**
+ * RNG Service
+ *
+ * Provides RNG operations with full audit trail tracking.
+ * Each command ID can have multiple action IDs, allowing fine-grained tracking
+ * of all RNG calls within a single game command.
+ */
+class RngService {
+    constructor(rngClient) {
+        this.rngClient = rngClient;
+        this.rngOutcomes = {};
+    }
+    /**
+     * Register a command for RNG tracking.
+     * Call this at the start of command processing.
+     */
+    registerCommand(commandId) {
+        if (!this.rngOutcomes[commandId]) {
+            this.rngOutcomes[commandId] = {};
+        }
+    }
+    /**
+     * Remove a command's RNG outcomes.
+     * Call this after command processing to clean up.
+     */
+    removeCommand(commandId) {
+        delete this.rngOutcomes[commandId];
+    }
+    /**
+     * Check if a command has RNG outcomes
+     */
+    hasCommandRngOutcome(commandId) {
+        return !!this.rngOutcomes[commandId];
+    }
+    /**
+     * Get the count of RNG outcomes for a command
+     */
+    getRngOutcomeCountForCommand(commandId) {
+        const outcomes = this.rngOutcomes[commandId];
+        return outcomes ? Object.keys(outcomes).length : 0;
+    }
+    /**
+     * Store an RNG outcome for audit trail
+     */
+    storeSeedForCommand(commandId, actionId, result, seed, min, max) {
+        this.registerCommand(commandId);
+        this.rngOutcomes[commandId][actionId] = { result, seed, min, max };
+    }
+    /**
+     * Get cached seed for a command/action (for replay scenarios)
+     */
+    getSeedForCommand(commandId, actionId) {
+        return this.rngOutcomes[commandId]?.[actionId]?.seed;
+    }
+    /**
+     * Get all RNG outcomes for a command
+     */
+    getRngOutcomeForCommand(commandId) {
+        return this.rngOutcomes[commandId] || {};
+    }
+    /**
+     * Get all RNG outcomes across all commands
+     */
+    getAllRngOutcome() {
+        return { ...this.rngOutcomes };
+    }
+    /**
+     * Generate a single random integer in range [min, max]
+     * Tracks the outcome for audit trail
+     */
+    async getSingleNumber(min, max, commandId, actionId) {
+        // Check if we already have a cached result (for replay)
+        const existingSeed = this.getSeedForCommand(commandId, actionId);
+        if (existingSeed !== undefined) {
+            const existingResult = this.rngOutcomes[commandId][actionId];
+            return { value: existingResult.result, seed: existingResult.seed };
+        }
+        // Generate new random number
+        const response = await this.rngClient.getSingleNumber(min, max);
+        // Store for audit trail
+        this.storeSeedForCommand(commandId, actionId, response.value, response.seed, min, max);
+        return response;
+    }
+    /**
+     * Generate multiple random integers in range [min, max]
+     * Each number is tracked individually with incrementing action IDs
+     */
+    async getBatchNumbers(min, max, count, commandId, actionId) {
+        const results = [];
+        for (let i = 0; i < count; i++) {
+            const result = await this.getSingleNumber(min, max, commandId, `${actionId}_${i}`);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Generate a weighted random selection
+     * Returns the index selected based on weights
+     */
+    async getWeightedRandomIndex(weights, commandId, actionId) {
+        const total = weights.reduce((acc, w) => acc + w, 0);
+        const { value: rand } = await this.getSingleNumber(0, total - 1, commandId, actionId);
+        let cumulative = 0;
+        for (let i = 0; i < weights.length; i++) {
+            cumulative += weights[i];
+            if (rand < cumulative) {
+                return i;
+            }
+        }
+        return weights.length - 1;
+    }
+}
+exports.RngService = RngService;
+//# sourceMappingURL=rng-service.js.map

package/dist/rng/rng-service.js.map

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

package/dist/rng/spin-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Spin Generator with Symbol Limitation System
+ *
+ * Generates 3x3 grids with weighted symbol distribution and limitation constraints.
+ * Each symbol type has a randomly selected maximum count (2, 4, 7, or 9).
+ */
+import { Symbol, SpinType } from '../config/happy-panda.config';
+import { Grid, GameDirection, RngProvider } from '../domain/types';
+/**
+ * Generate a grid with weighted symbols and limitation constraints.
+ *
+ * IMPORTANT: C++ logic requires limitations to be selected FIRST, then
+ * 3x3 check only happens if a symbol has limit=9 (max symbols).
+ *
+ * @param spinType Type of spin
+ * @param gameDirection Game direction
+ * @param rng RNG provider
+ * @param centerSymbol Optional fixed center symbol (for respin)
+ * @param previousGrid Optional grid from triggering spin (for RESPIN_CENTER_BAMBOO edge preservation)
+ * @returns Generated 3x3 grid
+ */
+export declare function generateGrid(spinType: SpinType, gameDirection: GameDirection, rng: RngProvider, centerSymbol?: Symbol, previousGrid?: Grid): Promise<Grid>;
+/**
+ * Generate panda piece grid for Bamboo Triplets bonus (Dancing Panda picture).
+ * Each position gets the appropriate piece symbol.
+ */
+export declare function generatePandaPieceGrid(): Grid;
+/**
+ * Check if grid is a complete panda piece (Dancing Panda picture for jackpot).
+ */
+export declare function isCompletePandaPiece(grid: Grid): boolean;
+//# sourceMappingURL=spin-generator.d.ts.map

package/dist/rng/spin-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spin-generator.d.ts","sourceRoot":"","sources":["../../src/rng/spin-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EA+BT,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqHnE;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC,CAgJf;AA8ED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAiBxD"}