texas-poker-core 1.4.21 → 1.4.22

package/README.md

@@ -591,4 +591,6 @@ fix: 修复结算金额分配异常
 修复 player reset 字段遗漏
 
 ## 1.4.21
-引入领域事件&增加回放功能
+引入领域事件&增加回放功能
+## 1.4.22
+增加外部设置玩家手牌&结算信息的方法

package/dist/Controller/HandSettlement.js

@@ -52,6 +52,11 @@ var HandSettlement = exports.HandSettlement = /*#__PURE__*/function () {
     value: function getPlayerEval(userId) {
       return _classPrivateFieldGet(_evalByUserId, this).get(userId);
     }
+  }, {
+    key: "setPlayerEval",
+    value: function setPlayerEval(userId, evalData) {
+      _classPrivateFieldGet(_evalByUserId, this).set(userId, evalData);
+    }
   }, {
     key: "reset",
     value: function reset() {

package/dist/Controller/index.js

@@ -166,6 +166,11 @@ var Controller = /*#__PURE__*/function () {
     value: function getShowdownEvalForPlayer(player) {
       return _classPrivateFieldGet(_hand, this).settlement.getPlayerEval(player.id);
     }
+  }, {
+    key: "setShowdownEvalForPlayer",
+    value: function setShowdownEvalForPlayer(player, evalData) {
+      _classPrivateFieldGet(_hand, this).settlement.setPlayerEval(player.id, evalData);
+    }
   }, {
     key: "activePlayer",
     get: function get() {

package/dist/Dealer/DealerService.js

@@ -110,6 +110,17 @@ var DealerService = exports.DealerService = /*#__PURE__*/function () {
       }, _classPrivateFieldGet(_table, this).button.getNextPlayer());
       return hole;
     }
+  }, {
+    key: "setHoleCardsForPlayer",
+    value: function setHoleCardsForPlayer(player, pokes) {
+      if (!_classPrivateFieldGet(_table, this).button) return;
+      var seatIndex = -1;
+      _classPrivateFieldGet(_table, this).loop(function (p, i) {
+        if (p === player) seatIndex = i;
+      }, _classPrivateFieldGet(_table, this).button.getNextPlayer());
+      if (seatIndex < 0) return;
+      _classPrivateFieldGet(_dealtBoard, this).setHoleCardsAt(seatIndex, pokes);
+    }
   }, {
     key: "addAction",
     value: function addAction(player) {

package/dist/Dealer/index.js

@@ -103,6 +103,11 @@ var Dealer = /*#__PURE__*/function () {
     value: function getHoleCardsForPlayer(player) {
       return _classPrivateFieldGet(_service, this).getHoleCardsForPlayer(player);
     }
+  }, {
+    key: "setHoleCardsForPlayer",
+    value: function setHoleCardsForPlayer(player, pokes) {
+      _classPrivateFieldGet(_service, this).setHoleCardsForPlayer(player, pokes);
+    }
   }, {
     key: "players",
     get: function get() {

package/dist/Deck/DealtBoard.js

@@ -5,6 +5,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.DealtBoard = void 0;
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
 function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
@@ -46,5 +52,12 @@ var DealtBoard = exports.DealtBoard = /*#__PURE__*/function () {
         commonPokes: _classPrivateFieldGet(_commonPokes, this)
       };
     }
+  }, {
+    key: "setHoleCardsAt",
+    value: function setHoleCardsAt(index, pokes) {
+      if (!Number.isInteger(index) || index < 0) return;
+      while (_classPrivateFieldGet(_handPokes, this).length <= index) _classPrivateFieldGet(_handPokes, this).push([]);
+      _classPrivateFieldGet(_handPokes, this)[index] = _toConsumableArray(pokes);
+    }
   }]);
 }();

package/dist/Player/index.js

@@ -494,6 +494,16 @@ var Player = exports.Player = /*#__PURE__*/function () {
     value: function getHandPokes() {
       return _toConsumableArray(_classPrivateFieldGet(_dealerRing, this).getHoleCardsForPlayer(this));
     }
+  }, {
+    key: "setHandPokes",
+    value: function setHandPokes(pokes) {
+      _classPrivateFieldGet(_dealerRing, this).setHoleCardsForPlayer(this, pokes);
+    }
+  }, {
+    key: "setShowdownEval",
+    value: function setShowdownEval(evalData) {
+      _classPrivateFieldGet(_handSession, this).setShowdownEvalForPlayer(this, evalData);
+    }
   }, {
     key: "earn",
     value: function earn(money) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "texas-poker-core",
-  "version": "1.4.21",
+  "version": "1.4.22",
   "description": "德州扑克核心功能",
   "main": "dist/index.js",
   "types": "types/index.d.ts",

package/types/Controller/HandSettlement.d.ts

@@ -20,6 +20,7 @@ export declare class HandSettlement {
     #private;
     get snapshot(): RankSettlementSnapshot;
     getPlayerEval(userId: number): ShowdownPlayerEval | undefined;
+    setPlayerEval(userId: number, evalData: ShowdownPlayerEval): void;
     reset(): void;
     settleFromCommonBoard(allSeatedPlayers: Player[], playersStillInShowdown: Player[], commonPokes: Poke[]): void;
 }

package/types/Controller/index.d.ts

@@ -55,6 +55,7 @@ declare class Controller implements GameComponent, PlayerHandSession<Player> {
     }[];
     get stage(): StageEnum;
     getShowdownEvalForPlayer(player: Player): ShowdownPlayerEval | undefined;
+    setShowdownEvalForPlayer(player: Player, evalData: ShowdownPlayerEval): void;
     get activePlayer(): Player | null;
     recordPlayerAction(player: Player, options: {
         emitPot: boolean;

package/types/Dealer/DealerService.d.ts

@@ -24,6 +24,7 @@ export declare class DealerService implements GameComponent {
      * 手牌唯一数据源为 {@link DealtBoard}；下标与发牌顺序一致（从庄家下家起绕桌一圈）。
      */
     getHoleCardsForPlayer(player: Player): Poke[];
+    setHoleCardsForPlayer(player: Player, pokes: readonly Poke[]): void;
     addAction(player: Player): void;
     initialRoles(buttonPlayer?: Player): undefined;
     reArrangeRoles(): undefined;

package/types/Dealer/index.d.ts

@@ -1,3 +1,4 @@
+import type { Poke } from '../Deck/constant';
 import type { PlayerDealerRing } from '../playerSessionPorts';
 import type { GameComponent, TexasErrorCallback } from '../gameContracts';
 import Deck from '../Deck';
@@ -29,6 +30,7 @@ declare class Dealer implements GameComponent, PlayerDealerRing<Player> {
     getPokes(): import("..").DealSnapshot;
     /** 该玩家在 {@link DealtBoard} 中对应座位的手牌（Player 不再私有缓存） */
     getHoleCardsForPlayer(player: Player): ("hj" | "h2" | "h3" | "h4" | "h5" | "h6" | "h7" | "h8" | "h9" | "ht" | "hq" | "hk" | "ha" | "s2" | "s3" | "s4" | "s5" | "s6" | "s7" | "s8" | "s9" | "st" | "sj" | "sq" | "sk" | "sa" | "d2" | "d3" | "d4" | "d5" | "d6" | "d7" | "d8" | "d9" | "dt" | "dj" | "dq" | "dk" | "da" | "c2" | "c3" | "c4" | "c5" | "c6" | "c7" | "c8" | "c9" | "ct" | "cj" | "cq" | "ck" | "ca")[];
+    setHoleCardsForPlayer(player: Player, pokes: readonly Poke[]): void;
     get players(): Player[];
     get stakes(): TableStakes;
     /** 大盲注额；与 `stakes.bigBlind` 同义 */

package/types/Deck/DealtBoard.d.ts

@@ -11,4 +11,5 @@ export declare class DealtBoard {
     capture(snapshot: DealSnapshot): void;
     reset(): void;
     getPokes(): DealSnapshot;
+    setHoleCardsAt(index: number, pokes: readonly Poke[]): void;
 }

package/types/Player/index.d.ts

@@ -132,6 +132,13 @@ export declare class Player implements GameComponent {
     log(prefix?: string): void;
     /** 手牌唯一存于荷官侧快照，经 {@link Dealer.getHoleCardsForPlayer} 按座位解析 */
     getHandPokes(): Poke[];
+    setHandPokes(pokes: readonly Poke[]): void;
+    setShowdownEval(evalData: {
+        bestFiveCards: Poke[];
+        rankSignature: RankSignature;
+        rankStrength: number;
+        rankCategory: RankCategory;
+    }): void;
     earn(money: number): void;
     resetCurrentStageTotalAmount(): void;
     /**

package/types/playerSessionPorts.d.ts

@@ -14,6 +14,7 @@ export interface PlayerDealerRing<TPlayer = unknown> {
     map<R>(callback: (player: TPlayer, index: number) => R): R[];
     filter(callback: (player: TPlayer, index: number) => boolean): TPlayer[];
     getHoleCardsForPlayer(player: TPlayer): Poke[];
+    setHoleCardsForPlayer(player: TPlayer, pokes: readonly Poke[]): void;
 }
 /**
  * `Player` 需要的「本手阶段机」视图，避免依赖整个 {@link Controller}。
@@ -27,6 +28,7 @@ export interface PlayerHandSession<TPlayer = unknown> {
     /** 当前轮到行动的玩家；翻前贴盲完成前可能为 `null` */
     readonly activePlayer: TPlayer | null;
     getShowdownEvalForPlayer(player: TPlayer): ShowdownPlayerEval | undefined;
+    setShowdownEvalForPlayer(player: TPlayer, evalData: ShowdownPlayerEval): void;
     tryToEndGame(): boolean;
     /** 下注轮已结束且尚未到河牌时，可推迟进街并由业务调用 `applyPendingStageAdvance` */
     canDeferBettingRoundStageAdvance(): boolean;