@slot-engine/core 0.1.7 → 0.1.8

package/dist/index.mjs

@@ -471,6 +471,11 @@ var Board = class {
     this.reels[reelIndex] = this.reels[reelIndex] || [];
     this.reels[reelIndex][rowIndex] = symbol;
   }
+  removeSymbol(reelIndex, rowIndex) {
+    if (this.reels[reelIndex]) {
+      this.reels[reelIndex].splice(rowIndex, 1);
+    }
+  }
   makeEmptyReels(opts) {
     const length = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
     assert3(length, "Cannot make empty reels without context or reelsAmount.");
@@ -660,18 +665,35 @@ var Board = class {
         this.reels[ridx][row] = symbol;
       }
     }
+    return {
+      stopPositions: this.lastDrawnReelStops
+    };
   }
   tumbleBoard(opts) {
     assert3(this.lastDrawnReelStops.length > 0, "Cannot tumble board before drawing it.");
     const reelsAmount = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
     const symbolsPerReel = opts.symbolsPerReel ?? opts.ctx.services.game.getCurrentGameMode().symbolsPerReel;
     const padSymbols = opts.padSymbols ?? opts.ctx.config.padSymbols;
+    if (opts.startingStops) {
+      assert3(
+        opts.startingStops.length === reelsAmount,
+        "Starting stops length does not match reels amount."
+      );
+      assert3(opts.reels, "Reels must be provided when using startingStops.");
+    }
+    if (opts.reels) {
+      assert3(opts.startingStops, "Starting stops must be provided when using reels.");
+    }
     if (!opts.ctx && !reelsAmount && !symbolsPerReel) {
       throw new Error(
         "If ctx is not provided, reelsAmount and symbolsPerReel must be given."
       );
     }
-    const reels = this.lastUsedReels;
+    const reels = opts.reels || this.lastUsedReels;
+    assert3(
+      reels.length === reelsAmount,
+      "Given reels length does not match reels amount."
+    );
     const sortedDeletions = [...opts.symbolsToDelete].sort((a, b) => b.rowIdx - a.rowIdx);
     sortedDeletions.forEach(({ reelIdx, rowIdx }) => {
       this.reels[reelIdx].splice(rowIdx, 1);
@@ -681,7 +703,7 @@ var Board = class {
     const newPaddingTopSymbols = {};
     for (let ridx = 0; ridx < reelsAmount; ridx++) {
       while (this.reels[ridx].length < symbolsPerReel[ridx]) {
-        const padSymbol = this.paddingTop[ridx].pop();
+        const padSymbol = this.paddingTop[ridx]?.pop();
         if (padSymbol) {
           this.reels[ridx].unshift(padSymbol);
           if (!newBoardSymbols[ridx]) {
@@ -697,7 +719,16 @@ var Board = class {
       const symbolsNeeded = symbolsPerReel[ridx] - this.reels[ridx].length;
       for (let s = 0; s < symbolsNeeded; s++) {
         const symbolPos = (stopBeforePad - s + reels[ridx].length) % reels[ridx].length;
-        const newSymbol = reels[ridx][symbolPos];
+        let newSymbol = reels[ridx][symbolPos];
+        const startStops = opts.startingStops;
+        if (startStops) {
+          const forcedSym = reels[ridx][startStops?.[ridx]];
+          assert3(
+            forcedSym,
+            `Failed to get forced symbol for tumbling. Tried to get symbol for position ${startStops?.[ridx]} on reel ${ridx}.`
+          );
+          newSymbol = forcedSym;
+        }
         assert3(newSymbol, "Failed to get new symbol for tumbling.");
         this.reels[ridx].unshift(newSymbol);
         newFirstSymbolPositions[ridx] = symbolPos;
@@ -721,9 +752,11 @@ var Board = class {
         newPaddingTopSymbols[ridx].unshift(padSymbol);
       }
     }
-    this.lastDrawnReelStops = this.lastDrawnReelStops.map((stop, ridx) => {
-      return newFirstSymbolPositions[ridx] ?? stop;
-    });
+    if (!opts.reels && !opts.startingStops) {
+      this.lastDrawnReelStops = this.lastDrawnReelStops.map((stop, ridx) => {
+        return newFirstSymbolPositions[ridx] ?? stop;
+      });
+    }
     return {
       newBoardSymbols,
       newPaddingTopSymbols
@@ -786,6 +819,12 @@ var BoardService = class extends AbstractService {
   setSymbol(reelIndex, rowIndex, symbol) {
     this.board.setSymbol(reelIndex, rowIndex, symbol);
   }
+  /**
+   * Removes the symbol at the specified reel and row index.
+   */
+  removeSymbol(reelIndex, rowIndex) {
+    this.board.removeSymbol(reelIndex, rowIndex);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx()
@@ -861,16 +900,16 @@ var BoardService = class extends AbstractService {
    * Draws a board using specified reel stops.
    */
   drawBoardWithForcedStops(opts) {
-    this.drawBoardMixed(opts.reels, opts.forcedStops, opts.randomOffset);
+    return this.drawBoardMixed(opts.reels, opts.forcedStops, opts.randomOffset);
   }
   /**
    * Draws a board using random reel stops.
    */
   drawBoardWithRandomStops(reels) {
-    this.drawBoardMixed(reels);
+    return this.drawBoardMixed(reels);
   }
   drawBoardMixed(reels, forcedStops, forcedStopsOffset) {
-    this.board.drawBoardMixed({
+    return this.board.drawBoardMixed({
       ctx: this.ctx(),
       reels,
       forcedStops,
@@ -886,6 +925,21 @@ var BoardService = class extends AbstractService {
       symbolsToDelete
     });
   }
+  /**
+   * **Experimental - May be changed or replaced in the future**
+   *
+   * Tumbles the board normally like `tumbleBoard`, but allows specifying a different reel set to get symbols from.\
+   * Also requires specifying the starting stops from where the symbols will be tumbled.\
+   * **This method does not remember the last tumbled position. Use this if you need to do a singular one-off tumble.**
+   */
+  tumbleBoardAndForget(opts) {
+    return this.board.tumbleBoard({
+      ctx: this.ctx(),
+      symbolsToDelete: opts.symbolsToDelete,
+      reels: opts.reels,
+      startingStops: opts.forcedStops
+    });
+  }
   /**
    * Dedupes win symbols for tumble.\
    * Returns a list of symbols to remove from the board based on the given win combinations.
@@ -896,6 +950,26 @@ var BoardService = class extends AbstractService {
   dedupeWinSymbolsForTumble(winCombinations) {
     return this.board.dedupeWinSymbolsForTumble(winCombinations);
   }
+  /**
+   * Sets the symbolsPerReel for the current game mode.
+   *
+   * The value will be reset to the original value as set in the game mode config in the next simulation.
+   */
+  setSymbolsPerReel(symbolsPerReel) {
+    this.ctx().config.gameModes[this.ctx().state.currentGameMode]._setSymbolsPerReel(
+      symbolsPerReel
+    );
+  }
+  /**
+   * Sets the reelsAmount for the current game mode.
+   *
+   * The value will be reset to the original value as set in the game mode config in the next simulation.
+   */
+  setReelsAmount(reelsAmount) {
+    this.ctx().config.gameModes[this.ctx().state.currentGameMode]._setReelsAmount(
+      reelsAmount
+    );
+  }
 };
 
 // src/service/data.ts
@@ -1800,6 +1874,9 @@ ${error.stack}
         criteria: ctx.state.currentResultSet.criteria
       })
     );
+    Object.values(ctx.config.gameModes).forEach((mode) => {
+      mode._resetTempValues();
+    });
   }
   resetState(ctx) {
     ctx.services.rng.setSeedIfDifferent(ctx.state.currentSimulationId);
@@ -2748,6 +2825,8 @@ var defineGameModes = (gameModes) => gameModes;
 import assert10 from "assert";
 var GameMode = class {
   name;
+  _reelsAmount;
+  _symbolsPerReel;
   reelsAmount;
   symbolsPerReel;
   cost;
@@ -2757,7 +2836,9 @@ var GameMode = class {
   isBonusBuy;
   constructor(opts) {
     this.name = opts.name;
+    this._reelsAmount = opts.reelsAmount;
     this.reelsAmount = opts.reelsAmount;
+    this._symbolsPerReel = opts.symbolsPerReel;
     this.symbolsPerReel = opts.symbolsPerReel;
     this.cost = opts.cost;
     this.rtp = opts.rtp;
@@ -2771,6 +2852,29 @@ var GameMode = class {
     );
     assert10(this.reelSets.length > 0, "GameMode must have at least one ReelSet defined.");
   }
+  /**
+   * Intended for internal use only.
+   */
+  _resetTempValues() {
+    this.reelsAmount = this._reelsAmount;
+    this.symbolsPerReel = this._symbolsPerReel;
+  }
+  /**
+   * Intended for internal use only.
+   */
+  _setSymbolsPerReel(symbolsPerReel) {
+    assert10(
+      symbolsPerReel.length === this._reelsAmount,
+      "symbolsPerReel length must match reelsAmount."
+    );
+    this.symbolsPerReel = symbolsPerReel;
+  }
+  /**
+   * Intended for internal use only.
+   */
+  _setReelsAmount(reelsAmount) {
+    this.reelsAmount = reelsAmount;
+  }
 };
 
 // src/win-types/index.ts
@@ -3653,6 +3757,12 @@ var StandaloneBoard = class {
   setSymbol(reelIndex, rowIndex, symbol) {
     this.board.setSymbol(reelIndex, rowIndex, symbol);
   }
+  /**
+   * Removes the symbol at the specified reel and row index.
+   */
+  removeSymbol(reelIndex, rowIndex) {
+    this.board.removeSymbol(reelIndex, rowIndex);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx
@@ -3729,16 +3839,16 @@ var StandaloneBoard = class {
    * Draws a board using specified reel stops.
    */
   drawBoardWithForcedStops(opts) {
-    this.drawBoardMixed(opts.reels, opts.forcedStops, opts.randomOffset);
+    return this.drawBoardMixed(opts.reels, opts.forcedStops, opts.randomOffset);
   }
   /**
    * Draws a board using random reel stops.
    */
   drawBoardWithRandomStops(reels) {
-    this.drawBoardMixed(reels);
+    return this.drawBoardMixed(reels);
   }
   drawBoardMixed(reels, forcedStops, forcedStopsOffset) {
-    this.board.drawBoardMixed({
+    return this.board.drawBoardMixed({
       ctx: this.ctx,
       reels,
       forcedStops,
@@ -3760,16 +3870,46 @@ var StandaloneBoard = class {
       padSymbols: this.padSymbols
     });
   }
+  /**
+   * **Experimental - May be changed or replaced in the future**
+   * 
+   * Tumbles the board normally like `tumbleBoard`, but allows specifying a different reel set to get symbols from.\
+   * Also requires specifying the starting stops from where the symbols will be tumbled.\
+   * **This method does not remember the last tumbled position. Use this if you need to do a singular one-off tumble.**
+   */
+  tumbleBoardAndForget(opts) {
+    return this.board.tumbleBoard({
+      ctx: this.ctx,
+      symbolsToDelete: opts.symbolsToDelete,
+      reelsAmount: this.reelsAmount,
+      symbolsPerReel: this.symbolsPerReel,
+      padSymbols: this.padSymbols,
+      reels: opts.reels,
+      startingStops: opts.forcedStops
+    });
+  }
   /**
    * Dedupes win symbols for tumble.\
    * Returns a list of symbols to remove from the board based on the given win combinations.
-   * 
+   *
    * Since it may be possible that multiple win combinations include the same symbol (e.g. Wilds),\
    * this method ensures that each symbol is only listed once for removal. Otherwise tumbling may break.
    */
   dedupeWinSymbolsForTumble(winCombinations) {
     return this.board.dedupeWinSymbolsForTumble(winCombinations);
   }
+  /**
+   * Sets symbolsPerReel.
+   */
+  setSymbolsPerReel(symbolsPerReel) {
+    this.symbolsPerReel = symbolsPerReel;
+  }
+  /**
+   * Sets the reelsAmount.
+   */
+  setReelsAmount(reelsAmount) {
+    this.reelsAmount = reelsAmount;
+  }
 };
 export {
   ClusterWinType,