@omnitronix/happy-panda-game-engine 0.5.1

package/dist/__tests__/fixtures/cpp-parity-vectors.json

@@ -0,0 +1,457 @@
+{
+    "description": "Test vectors for win evaluation matching C++ CherryMaster_A_2 math model (xlsx-derived values).",
+    "version": "3.0.0",
+    "generatedFrom": "CherryMaster_A_2.cpp and xlsx (exact C++ values)",
+    "testCases": [
+        {
+            "id": "paid-spin-no-win-001",
+            "description": "Basic paid spin with no wins",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "rngSequence": [45, 67, 23, 89, 12, 56, 78, 34, 90, 11, 22, 33]
+            },
+            "expected": {
+                "grid": [
+                    [7, 5, 8],
+                    [8, 6, 7],
+                    [5, 7, 6]
+                ],
+                "gridSymbols": ["PRUNE", "MELON", "ORANGE", "ORANGE", "BELL", "PRUNE", "MELON", "PRUNE", "BELL"],
+                "totalPayout": 0,
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "lineWinCount": 0
+            }
+        },
+        {
+            "id": "paid-spin-cherry-x1-002",
+            "description": "Paid spin with single cherry on line",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "rngSequence": [95, 67, 23, 89, 12, 56, 78, 34, 90, 11, 22, 33]
+            },
+            "expected": {
+                "grid": [
+                    [9, 5, 8],
+                    [8, 6, 7],
+                    [5, 7, 6]
+                ],
+                "gridSymbols": ["CHERRY", "MELON", "ORANGE", "ORANGE", "BELL", "PRUNE", "MELON", "PRUNE", "BELL"],
+                "totalPayout": 2,
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "lineWinCount": 1,
+                "lineWins": [
+                    {
+                        "lineIndex": 0,
+                        "symbol": 9,
+                        "matchLength": 1,
+                        "payout": 2
+                    }
+                ]
+            }
+        },
+        {
+            "id": "paid-spin-bar3-line-003",
+            "description": "Paid spin with 3x BAR3 on line",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [2, 5, 8],
+                    [2, 6, 7],
+                    [2, 7, 6]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [2, 5, 8],
+                    [2, 6, 7],
+                    [2, 7, 6]
+                ],
+                "totalPayout": 80,
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "lineWinCount": 1,
+                "lineWins": [
+                    {
+                        "lineIndex": 0,
+                        "symbol": 2,
+                        "matchLength": 3,
+                        "payout": 80
+                    }
+                ]
+            }
+        },
+        {
+            "id": "wall-win-bar3-004",
+            "description": "Full screen BAR3 wall win",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [2, 2, 2],
+                    [2, 2, 2],
+                    [2, 2, 2]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [2, 2, 2],
+                    [2, 2, 2],
+                    [2, 2, 2]
+                ],
+                "totalPayout": 4640,
+                "hasWallWin": true,
+                "wallWinType": 2,
+                "wallPayout": 4000,
+                "hasScatterWin": false,
+                "lineWinCount": 8,
+                "comment": "C++ pays both wall AND line wins: wall (500×8=4000) + lines (80×8=640) = 4640"
+            }
+        },
+        {
+            "id": "wall-win-cherry-mix-005",
+            "description": "Cherry wall win with mixed CH/CH_S",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [9, 10, 9],
+                    [10, 9, 10],
+                    [9, 9, 10]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [9, 10, 9],
+                    [10, 9, 10],
+                    [9, 9, 10]
+                ],
+                "totalPayout": 3200,
+                "hasWallWin": true,
+                "wallWinType": 9,
+                "wallPayout": 3200,
+                "hasScatterWin": false,
+                "lineWinCount": 0,
+                "comment": "Cherry wall = 400 × 8 = 3200"
+            }
+        },
+        {
+            "id": "scatter-win-3x-seven-006",
+            "description": "3x Seven scatter win + line win (C++ pays both)",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [1, 5, 8],
+                    [6, 1, 7],
+                    [5, 7, 1]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [1, 5, 8],
+                    [6, 1, 7],
+                    [5, 7, 1]
+                ],
+                "totalPayout": 140,
+                "hasWallWin": false,
+                "hasScatterWin": true,
+                "scatterSymbol": 1,
+                "scatterCount": 3,
+                "scatterPayout": 40,
+                "lineWinCount": 1,
+                "lineWins": [
+                    {
+                        "lineIndex": 6,
+                        "symbol": 1,
+                        "matchLength": 3,
+                        "payout": 100
+                    }
+                ],
+                "comment": "C++ pays BOTH: 3x Seven line (100) + 3x Seven scatter (40) = 140"
+            }
+        },
+        {
+            "id": "scatter-win-3x-super-seven-doubled-007",
+            "description": "3x Super Seven scatter + line win (C++ pays both)",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [0, 5, 8],
+                    [6, 0, 7],
+                    [5, 7, 0]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [0, 5, 8],
+                    [6, 0, 7],
+                    [5, 7, 0]
+                ],
+                "totalPayout": 230,
+                "hasWallWin": false,
+                "hasScatterWin": true,
+                "scatterSymbol": 0,
+                "scatterCount": 3,
+                "scatterPayout": 80,
+                "isSuperSevenOnly": true,
+                "lineWinCount": 1,
+                "lineWins": [
+                    {
+                        "lineIndex": 6,
+                        "symbol": 0,
+                        "matchLength": 3,
+                        "payout": 150
+                    }
+                ],
+                "comment": "C++ pays BOTH: 3x Super Seven line (150) + scatter doubled (80) = 230"
+            }
+        },
+        {
+            "id": "any-bar-wall-008",
+            "description": "Any Bar wall win (mixed BAR3/BAR2/BAR1)",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [2, 3, 4],
+                    [4, 2, 3],
+                    [3, 4, 2]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [2, 3, 4],
+                    [4, 2, 3],
+                    [3, 4, 2]
+                ],
+                "totalPayout": 400,
+                "hasWallWin": true,
+                "wallWinType": 10,
+                "wallPayout": 400,
+                "hasScatterWin": false,
+                "lineWinCount": 0,
+                "comment": "Any Bar wall = 50 × 8 = 400"
+            }
+        },
+        {
+            "id": "fruit-wall-009",
+            "description": "All Fruits wall win",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [5, 7, 8],
+                    [9, 10, 5],
+                    [7, 8, 9]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [5, 7, 8],
+                    [9, 10, 5],
+                    [7, 8, 9]
+                ],
+                "totalPayout": 120,
+                "hasWallWin": true,
+                "wallWinType": 11,
+                "wallPayout": 120,
+                "hasScatterWin": false,
+                "lineWinCount": 0,
+                "comment": "All Fruits wall = 15 × 8 = 120"
+            }
+        },
+        {
+            "id": "bar-mix-line-010",
+            "description": "Any Bar line win (BAR3+BAR2+BAR1)",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [2, 5, 8],
+                    [3, 6, 7],
+                    [4, 7, 6]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [2, 5, 8],
+                    [3, 6, 7],
+                    [4, 7, 6]
+                ],
+                "totalPayout": 10,
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "lineWinCount": 1,
+                "lineWins": [
+                    {
+                        "lineIndex": 0,
+                        "symbol": 25,
+                        "matchLength": 3,
+                        "payout": 10
+                    }
+                ],
+                "comment": "Symbol 25 = BAR_ANY for mixed bar line (10 × 1 = 10)"
+            }
+        },
+        {
+            "id": "16-line-mode-011",
+            "description": "16-line mode with both direction wins",
+            "input": {
+                "spinType": 0,
+                "gameDirection": 1,
+                "betStake": 1,
+                "betGame": 16,
+                "forcedGrid": [
+                    [6, 5, 8],
+                    [6, 6, 7],
+                    [6, 7, 6]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [6, 5, 8],
+                    [6, 6, 7],
+                    [6, 7, 6]
+                ],
+                "totalPayout": 72,
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "lineWinCount": 4,
+                "comment": "Bell on line 0 (top row), line 6 (diagonal), line 8 (reverse top row), line 14 (reverse diagonal) = 4 x 18 = 72"
+            }
+        },
+        {
+            "id": "bonus-bell-scatter-012",
+            "description": "Bell Bonus with bell scatter wins",
+            "input": {
+                "spinType": 3,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [6, 5, 6],
+                    [7, 6, 7],
+                    [6, 7, 6]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [6, 5, 6],
+                    [7, 6, 7],
+                    [6, 7, 6]
+                ],
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "specialWinCount": 1,
+                "specialWins": [
+                    {
+                        "winType": 14,
+                        "count": 5,
+                        "payout": 50
+                    }
+                ],
+                "comment": "Bell Bonus: each bell pays as scatter (5 bells × 10 × 1 = 50)"
+            }
+        },
+        {
+            "id": "bonus-bar1-super-bar-013",
+            "description": "Bar1 Bonus with super bar scatter wins",
+            "input": {
+                "spinType": 4,
+                "gameDirection": 0,
+                "betStake": 1,
+                "betGame": 8,
+                "forcedGrid": [
+                    [11, 5, 11],
+                    [7, 11, 7],
+                    [5, 7, 11]
+                ]
+            },
+            "expected": {
+                "grid": [
+                    [11, 5, 11],
+                    [7, 11, 7],
+                    [5, 7, 11]
+                ],
+                "hasWallWin": false,
+                "hasScatterWin": false,
+                "specialWinCount": 1,
+                "specialWins": [
+                    {
+                        "winType": 15,
+                        "count": 4,
+                        "payout": 40
+                    }
+                ],
+                "comment": "Bar1 Bonus: each super bar pays as scatter (4 × 10 × 1 = 40)"
+            }
+        }
+    ],
+    "multiplierTests": {
+        "description": "Verify multiplier values match C++ xlsx-derived values exactly",
+        "lineMultipliers": {
+            "SUPER_SEVEN_x3": 150,
+            "SEVEN_x3": 100,
+            "BAR3_x3": 80,
+            "BAR2_x3": 50,
+            "BAR1_x3": 30,
+            "MELON_x3": 20,
+            "BELL_x3": 18,
+            "PRUNE_x3": 14,
+            "ORANGE_x3": 10,
+            "CHERRY_x1": 2,
+            "CHERRY_x2": 5,
+            "CHERRY_x3": 10,
+            "ANY_BAR_x3": 10
+        },
+        "wallMultipliers": {
+            "BAR3": 500,
+            "BAR2": 400,
+            "BAR1": 300,
+            "MELON": 300,
+            "BELL": 200,
+            "PRUNE": 100,
+            "ORANGE": 50,
+            "CHERRY": 400,
+            "ANY_BAR": 50,
+            "ALL_FRUITS": 15,
+            "ALL_COLORS": 50
+        },
+        "scatterMultipliers": {
+            "SEVEN_x9": 1000,
+            "SEVEN_x8": 400,
+            "SEVEN_x7": 200,
+            "SEVEN_x6": 100,
+            "SEVEN_x5": 50,
+            "SEVEN_x4": 20,
+            "SEVEN_x3": 5,
+            "SEVEN_x2": 2
+        }
+    }
+}

package/dist/__tests__/gdd-validation-1000.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * GDD Validation Test - 1000 Paid Spins
+ *
+ * Validates that after the Symbol/ScreenWinType rename, all responses
+ * still match GDD expectations:
+ * - Response shapes match SpinResponse interface
+ * - All symbols are from the renamed GDD enum
+ * - Bonus triggers use correct GDD SpinType strings
+ * - Win evaluations are structurally correct
+ * - State transitions are valid
+ * - RTP is within a plausible range for 1000 spins
+ */
+export {};
+//# sourceMappingURL=gdd-validation-1000.test.d.ts.map

package/dist/__tests__/gdd-validation-1000.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdd-validation-1000.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gdd-validation-1000.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}