@slot-engine/core 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -545,6 +545,7 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
     getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -557,11 +558,19 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
      * Removes the symbol at the specified reel and row index.
      */
     removeSymbol(reelIndex: number, rowIndex: number): void;
+    /**
+     * Updates properties of the symbol at the specified reel and row index.
+     */
+    updateSymbol(reelIndex: number, rowIndex: number, properties: Record<string, any>): void;
     private resetReels;
     /**
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */
@@ -1549,7 +1558,9 @@ declare class ManywaysWinType extends WinType {
      * Calculates wins based on the defined paylines and provided board state.\
      * Retrieve the results using `getWins()` after.
      */
-    evaluateWins(board: Reels): this;
+    evaluateWins(board: Reels, opts?: {
+        jumpGaps?: boolean;
+    }): this;
     private getWayLength;
 }
 interface ManywaysWinTypeOpts extends WinTypeOpts {
@@ -1729,6 +1740,8 @@ declare class StandaloneBoard {
     getBoardReels(): Reels;
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
+    getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -1741,11 +1754,19 @@ declare class StandaloneBoard {
      * Removes the symbol at the specified reel and row index.
      */
     removeSymbol(reelIndex: number, rowIndex: number): void;
+    /**
+     * Updates properties of the symbol at the specified reel and row index.
+     */
+    updateSymbol(reelIndex: number, rowIndex: number, properties: Record<string, any>): void;
     private resetReels;
     /**
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */

package/dist/index.d.ts

@@ -545,6 +545,7 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
     getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -557,11 +558,19 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
      * Removes the symbol at the specified reel and row index.
      */
     removeSymbol(reelIndex: number, rowIndex: number): void;
+    /**
+     * Updates properties of the symbol at the specified reel and row index.
+     */
+    updateSymbol(reelIndex: number, rowIndex: number, properties: Record<string, any>): void;
     private resetReels;
     /**
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */
@@ -1549,7 +1558,9 @@ declare class ManywaysWinType extends WinType {
      * Calculates wins based on the defined paylines and provided board state.\
      * Retrieve the results using `getWins()` after.
      */
-    evaluateWins(board: Reels): this;
+    evaluateWins(board: Reels, opts?: {
+        jumpGaps?: boolean;
+    }): this;
     private getWayLength;
 }
 interface ManywaysWinTypeOpts extends WinTypeOpts {
@@ -1729,6 +1740,8 @@ declare class StandaloneBoard {
     getBoardReels(): Reels;
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
+    getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -1741,11 +1754,19 @@ declare class StandaloneBoard {
      * Removes the symbol at the specified reel and row index.
      */
     removeSymbol(reelIndex: number, rowIndex: number): void;
+    /**
+     * Updates properties of the symbol at the specified reel and row index.
+     */
+    updateSymbol(reelIndex: number, rowIndex: number, properties: Record<string, any>): void;
     private resetReels;
     /**
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */

package/dist/index.js

@@ -477,8 +477,18 @@ var Board = class {
    * Used for triggering anticipation effects.
    */
   anticipation;
+  /**
+   * The most recent stop positions for the reels.
+   */
   lastDrawnReelStops;
+  /**
+   * The reel set used in the most recent draw.
+   */
   lastUsedReels;
+  /**
+   * Indicates whether each reel is locked or not.
+   */
+  reelsLocked;
   constructor() {
     this.reels = [];
     this.paddingTop = [];
@@ -486,6 +496,7 @@ var Board = class {
     this.anticipation = [];
     this.lastDrawnReelStops = [];
     this.lastUsedReels = [];
+    this.reelsLocked = [];
   }
   getSymbol(reelIndex, rowIndex) {
     return this.reels[reelIndex]?.[rowIndex];
@@ -499,6 +510,14 @@ var Board = class {
       this.reels[reelIndex].splice(rowIndex, 1);
     }
   }
+  updateSymbol(reelIndex, rowIndex, properties) {
+    const symbol = this.getSymbol(reelIndex, rowIndex);
+    if (symbol) {
+      for (const [key, value] of Object.entries(properties)) {
+        symbol.properties.set(key, value);
+      }
+    }
+  }
   makeEmptyReels(opts) {
     const length = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
     (0, import_assert3.default)(length, "Cannot make empty reels without context or reelsAmount.");
@@ -633,14 +652,19 @@ var Board = class {
     return reelSet;
   }
   resetReels(opts) {
-    const length = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
+    const { ctx, reelsAmount, reelsLocked } = opts;
+    const length = reelsAmount ?? ctx.services.game.getCurrentGameMode().reelsAmount;
     this.reels = this.makeEmptyReels(opts);
     this.anticipation = Array.from({ length }, () => false);
+    this.reelsLocked = reelsLocked ?? Array.from({ length }, () => false);
     this.paddingTop = this.makeEmptyReels(opts);
     this.paddingBottom = this.makeEmptyReels(opts);
   }
   drawBoardMixed(opts) {
-    this.resetReels(opts);
+    this.resetReels({
+      ...opts,
+      ...this.reelsLocked.length && { reelsLocked: this.reelsLocked }
+    });
     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;
@@ -669,6 +693,18 @@ var Board = class {
         );
       }
     }
+    if (this.reelsLocked.some((locked) => locked) && this.lastDrawnReelStops.length == 0) {
+      throw new Error(
+        "Cannot draw board with locked reels before drawing it at least once."
+      );
+    }
+    if (this.reelsLocked.some((locked) => locked)) {
+      for (let ridx = 0; ridx < reelsAmount; ridx++) {
+        if (this.reelsLocked[ridx]) {
+          finalReelStops[ridx] = this.lastDrawnReelStops[ridx];
+        }
+      }
+    }
     this.lastDrawnReelStops = finalReelStops.map((pos) => pos);
     this.lastUsedReels = opts.reels;
     for (let ridx = 0; ridx < reelsAmount; ridx++) {
@@ -830,6 +866,9 @@ var BoardService = class extends AbstractService {
   getAnticipation() {
     return this.board.anticipation;
   }
+  getLockedReels() {
+    return this.board.reelsLocked;
+  }
   /**
    * Gets the symbol at the specified reel and row index.
    */
@@ -848,6 +887,12 @@ var BoardService = class extends AbstractService {
   removeSymbol(reelIndex, rowIndex) {
     this.board.removeSymbol(reelIndex, rowIndex);
   }
+  /**
+   * Updates properties of the symbol at the specified reel and row index.
+   */
+  updateSymbol(reelIndex, rowIndex, properties) {
+    this.board.updateSymbol(reelIndex, rowIndex, properties);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx()
@@ -859,6 +904,12 @@ var BoardService = class extends AbstractService {
   setAnticipationForReel(reelIndex, value) {
     this.board.anticipation[reelIndex] = value;
   }
+  /**
+   * Sets the locked state for a specific reel.
+   */
+  setReelLocked(reelIndex, value) {
+    this.board.reelsLocked[reelIndex] = value;
+  }
   /**
    * Counts how many symbols matching the criteria are on a specific reel.
    */
@@ -4067,27 +4118,36 @@ var ManywaysWinType = class extends WinType {
    * Calculates wins based on the defined paylines and provided board state.\
    * Retrieve the results using `getWins()` after.
    */
-  evaluateWins(board) {
+  evaluateWins(board, opts = {}) {
     this.validateConfig();
+    const { jumpGaps = false } = opts;
     const waysWins = [];
     const reels = board;
     const possibleWaysWins = /* @__PURE__ */ new Map();
     const candidateSymbols = /* @__PURE__ */ new Map();
-    let searchReelIdx = 0;
-    let searchActive = true;
-    while (searchActive && searchReelIdx < reels.length) {
-      const reel = reels[searchReelIdx];
-      let hasWild = false;
-      for (const symbol of reel) {
-        candidateSymbols.set(symbol.id, symbol);
-        if (this.isWild(symbol)) {
-          hasWild = true;
+    if (jumpGaps) {
+      for (const reel of reels) {
+        for (const symbol of reel) {
+          candidateSymbols.set(symbol.id, symbol);
         }
       }
-      if (!hasWild) {
-        searchActive = false;
+    } else {
+      let searchReelIdx = 0;
+      let searchActive = true;
+      while (searchActive && searchReelIdx < reels.length) {
+        const reel = reels[searchReelIdx];
+        let hasWild = false;
+        for (const symbol of reel) {
+          candidateSymbols.set(symbol.id, symbol);
+          if (this.isWild(symbol)) {
+            hasWild = true;
+          }
+        }
+        if (!hasWild) {
+          searchActive = false;
+        }
+        searchReelIdx++;
       }
-      searchReelIdx++;
     }
     for (const baseSymbol of candidateSymbols.values()) {
       let symbolList = {};
@@ -4103,7 +4163,7 @@ var ManywaysWinType = class extends WinType {
             symbolList[ridx].push({ reel: ridx, row: sidx, symbol });
           }
         }
-        if (!symbolList[ridx]) {
+        if (!symbolList[ridx] && !jumpGaps) {
           isInterrupted = true;
           break;
         }
@@ -4119,7 +4179,7 @@ var ManywaysWinType = class extends WinType {
     for (const [baseSymbolId, symbolList] of possibleWaysWins.entries()) {
       const wayLength = this.getWayLength(symbolList);
       let baseSymbol = Object.values(symbolList).flatMap((l) => l.map((s) => s)).find((s) => !this.isWild(s.symbol))?.symbol;
-      if (!baseSymbol) baseSymbol = symbolList[0][0].symbol;
+      if (!baseSymbol) baseSymbol = symbolList[Object.keys(symbolList)[0]][0].symbol;
       const singleWayPayout = this.getSymbolPayout(baseSymbol, wayLength);
       const totalWays = Object.values(symbolList).reduce(
         (ways, syms) => ways * syms.length,
@@ -4153,7 +4213,7 @@ var ManywaysWinType = class extends WinType {
     return this;
   }
   getWayLength(symbolList) {
-    return Math.max(...Object.keys(symbolList).map((k) => parseInt(k, 10))) + 1;
+    return Object.keys(symbolList).length;
   }
 };
 
@@ -4591,6 +4651,12 @@ var StandaloneBoard = class {
   getPaddingBottom() {
     return this.board.paddingBottom;
   }
+  getAnticipation() {
+    return this.board.anticipation;
+  }
+  getLockedReels() {
+    return this.board.reelsLocked;
+  }
   /**
    * Gets the symbol at the specified reel and row index.
    */
@@ -4609,6 +4675,12 @@ var StandaloneBoard = class {
   removeSymbol(reelIndex, rowIndex) {
     this.board.removeSymbol(reelIndex, rowIndex);
   }
+  /**
+   * Updates properties of the symbol at the specified reel and row index.
+   */
+  updateSymbol(reelIndex, rowIndex, properties) {
+    this.board.updateSymbol(reelIndex, rowIndex, properties);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx
@@ -4620,6 +4692,12 @@ var StandaloneBoard = class {
   setAnticipationForReel(reelIndex, value) {
     this.board.anticipation[reelIndex] = value;
   }
+  /**
+   * Sets the locked state for a specific reel.
+   */
+  setReelLocked(reelIndex, value) {
+    this.board.reelsLocked[reelIndex] = value;
+  }
   /**
    * Counts how many symbols matching the criteria are on a specific reel.
    */