texas-poker-core 1.4.23 → 1.4.26

package/README.md

@@ -598,5 +598,14 @@ fix: 修复结算金额分配异常
 
 增加外部设置玩家手牌&结算信息的方法
 
-## 1.4.23
-bugfix
+## 1.4.24
+
+- `HandEnded` / `HandSettlement` 快照增加 `bestRankSignature`，与桌上最强 `bestPokes[0]` 对齐
+- 导出 `rankSignatureToDisplayGroups`；顺子 wheel 在 `rankSignatureToRanks` 中 A 置于末位
+
+## 1.4.25
+
+- 导出 `createStandardDeckPokes`，生成标准 52 张牌（与 `Deck` 建牌顺序一致）
+
+## 1.4.26
+export new functiono 

package/dist/Controller/HandSettlement.js

@@ -38,7 +38,8 @@ var HandSettlement = exports.HandSettlement = /*#__PURE__*/function () {
     _classPrivateFieldInitSpec(this, _snapshot, {
       rankCategory: undefined,
       pokes: [],
-      rankStrength: 0
+      rankStrength: 0,
+      rankSignature: undefined
     });
     _classPrivateFieldInitSpec(this, _evalByUserId, new Map());
   }
@@ -63,7 +64,8 @@ var HandSettlement = exports.HandSettlement = /*#__PURE__*/function () {
       _classPrivateFieldSet(_snapshot, this, {
         rankCategory: undefined,
         pokes: [],
-        rankStrength: 0
+        rankStrength: 0,
+        rankSignature: undefined
       });
       _classPrivateFieldGet(_evalByUserId, this).clear();
     }
@@ -94,7 +96,8 @@ function _snapshotFromShowdownPlayers(stillIn) {
     return {
       rankCategory: undefined,
       pokes: [],
-      rankStrength: 0
+      rankStrength: 0,
+      rankSignature: undefined
     };
   }
   var maxStrength = Math.max.apply(Math, _toConsumableArray(stillIn.map(function (p) {
@@ -110,7 +113,8 @@ function _snapshotFromShowdownPlayers(stillIn) {
     return {
       rankCategory: undefined,
       pokes: [],
-      rankStrength: 0
+      rankStrength: 0,
+      rankSignature: undefined
     };
   }
   return {
@@ -118,6 +122,7 @@ function _snapshotFromShowdownPlayers(stillIn) {
     pokes: tiedAtTop.map(function (p) {
       return _this2.getPlayerEval(p.id).bestFiveCards;
     }),
-    rankStrength: maxStrength
+    rankStrength: maxStrength,
+    rankSignature: topEval.rankSignature
   };
 }

package/dist/Controller/index.js

@@ -655,7 +655,8 @@ function _emitShowdownHandEnded() {
   var _classPrivateFieldGet5 = _classPrivateFieldGet(_hand, this).settlement.snapshot,
     rankCategory = _classPrivateFieldGet5.rankCategory,
     pokes = _classPrivateFieldGet5.pokes,
-    rankStrength = _classPrivateFieldGet5.rankStrength;
+    rankStrength = _classPrivateFieldGet5.rankStrength,
+    rankSignature = _classPrivateFieldGet5.rankSignature;
   var endStage = _classPrivateFieldGet(_hand, this).stage;
   var pokesRevealed = this.getRevealedPokes();
   _classPrivateFieldGet(_handEvents, this).push({
@@ -667,6 +668,7 @@ function _emitShowdownHandEnded() {
       showHandPokes: true,
       bestPokes: pokes,
       bestRankCategory: rankCategory,
+      bestRankSignature: rankSignature,
       bestRankStrength: rankStrength
     })
   });

package/dist/Deck/core.js

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "compareRankSignature", {
     return _handCompare.compareRankSignature;
   }
 });
+Object.defineProperty(exports, "createStandardDeckPokes", {
+  enumerable: true,
+  get: function get() {
+    return _standardDeck.createStandardDeckPokes;
+  }
+});
 Object.defineProperty(exports, "formatterPoke", {
   enumerable: true,
   get: function get() {
@@ -69,6 +75,19 @@ Object.defineProperty(exports, "isStraight", {
     return _handEvaluation.isStraight;
   }
 });
+Object.defineProperty(exports, "rankSignatureToDisplayGroups", {
+  enumerable: true,
+  get: function get() {
+    return _handCompare.rankSignatureToDisplayGroups;
+  }
+});
+Object.defineProperty(exports, "rankSignatureToRanks", {
+  enumerable: true,
+  get: function get() {
+    return _handCompare.rankSignatureToRanks;
+  }
+});
+var _standardDeck = require("./standardDeck");
 var _format = require("./format");
 var _handEvaluation = require("./handEvaluation");
 var _handCompare = require("./handCompare");

package/dist/Deck/handCompare.js

@@ -6,7 +6,176 @@ Object.defineProperty(exports, "__esModule", {
 exports.compareRankSignature = exports.compareFn = void 0;
 exports.getFiveCardsStrength = getFiveCardsStrength;
 exports.getStrengthFromRankSignature = getStrengthFromRankSignature;
+exports.rankSignatureToDisplayGroups = rankSignatureToDisplayGroups;
+exports.rankSignatureToRanks = rankSignatureToRanks;
 var _handEvaluation = require("./handEvaluation");
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+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; }
+var NUMERIC_TO_RANK = {
+  2: '2',
+  3: '3',
+  4: '4',
+  5: '5',
+  6: '6',
+  7: '7',
+  8: '8',
+  9: '9',
+  10: 't',
+  11: 'j',
+  12: 'q',
+  13: 'k',
+  14: 'a'
+};
+function numericRankToRank(v) {
+  var r = NUMERIC_TO_RANK[v];
+  if (r === undefined) {
+    throw new Error("rankSignatureToRanks: \u975E\u6CD5\u70B9\u6570 ".concat(v, "\uFF08\u987B\u4E3A 2\u201314\uFF09"));
+  }
+  return r;
+}
+
+/**
+ * 与 `isStraight` / 签名中 `u`/`y` 的 `max` 一致：五张顺子点数顺序。
+ * 仅 Broadway（A-K-Q-J-T，`max === 14`）A 作高牌；其余含 A 的顺子仅为 wheel，A 视为 1 排在末位。
+ */
+function straightRanksFromMax(max) {
+  if (max === 5) {
+    return ['5', '4', '3', '2', 'a'];
+  }
+  return [max, max - 1, max - 2, max - 3, max - 4].map(numericRankToRank);
+}
+
+/**
+ * 将 `RankSignature` 展开为五张牌的点数（`Rank`），与 `getFiveCardsRankSignature` 编码对称。
+ * 顺子 wheel（`u5`/`y5`）为 5→A 展示顺序，A 在末位；Broadway 仍为 A→T。
+ * `x`（四条）当前签名仅含四条点数，踢脚未编码，第五位为 `null`。
+ */
+function rankSignatureToRanks(rankSignature) {
+  var category = rankSignature[0];
+  var nums = parseRankNumbersFromRankSignature(rankSignature);
+  switch (category) {
+    case 'z':
+      return ['a', 'k', 'q', 'j', 't'];
+    case 'y':
+    case 'u':
+      {
+        if (nums.length !== 1) {
+          throw new Error("rankSignatureToRanks: ".concat(category, " \u578B\u7B7E\u540D\u987B\u542B 1 \u4E2A max \u6BB5\uFF0C\u5B9E\u9645 ").concat(nums.length));
+        }
+        return straightRanksFromMax(nums[0]);
+      }
+    case 'q':
+    case 'v':
+      {
+        if (nums.length !== 5) {
+          throw new Error("rankSignatureToRanks: ".concat(category, " \u578B\u7B7E\u540D\u987B\u542B 5 \u4E2A\u70B9\u6570\u6BB5\uFF0C\u5B9E\u9645 ").concat(nums.length));
+        }
+        return nums.map(numericRankToRank);
+      }
+    case 'r':
+      {
+        if (nums.length !== 4) {
+          throw new Error("rankSignatureToRanks: r \u578B\u7B7E\u540D\u987B\u4E3A\u300C\u5BF9\u5B50+3 \u8E22\u811A\u300D\u5171 4 \u6BB5\uFF0C\u5B9E\u9645 ".concat(nums.length));
+        }
+        var p = nums[0],
+          kick = nums.slice(1);
+        var pr = numericRankToRank(p);
+        return [pr, pr].concat(_toConsumableArray(kick.map(numericRankToRank)));
+      }
+    case 's':
+      {
+        if (nums.length !== 3) {
+          throw new Error("rankSignatureToRanks: s \u578B\u7B7E\u540D\u987B\u4E3A\u300C\u9AD8\u5BF9+\u4F4E\u5BF9+\u8E22\u811A\u300D\u5171 3 \u6BB5\uFF0C\u5B9E\u9645 ".concat(nums.length));
+        }
+        var _nums$map = nums.map(numericRankToRank),
+          _nums$map2 = _slicedToArray(_nums$map, 3),
+          hi = _nums$map2[0],
+          lo = _nums$map2[1],
+          k = _nums$map2[2];
+        return [hi, hi, lo, lo, k];
+      }
+    case 't':
+      {
+        if (nums.length !== 3) {
+          throw new Error("rankSignatureToRanks: t \u578B\u7B7E\u540D\u987B\u4E3A\u300C\u4E09\u6761+2 \u8E22\u811A\u300D\u5171 3 \u6BB5\uFF0C\u5B9E\u9645 ".concat(nums.length));
+        }
+        var _nums$map3 = nums.map(numericRankToRank),
+          _nums$map4 = _slicedToArray(_nums$map3, 3),
+          tr = _nums$map4[0],
+          k1 = _nums$map4[1],
+          k2 = _nums$map4[2];
+        return [tr, tr, tr, k1, k2];
+      }
+    case 'w':
+      {
+        if (nums.length !== 2) {
+          throw new Error("rankSignatureToRanks: w \u578B\u7B7E\u540D\u987B\u4E3A\u300C\u4E09\u6761+\u5BF9\u5B50\u300D\u5171 2 \u6BB5\uFF0C\u5B9E\u9645 ".concat(nums.length));
+        }
+        var _nums$map5 = nums.map(numericRankToRank),
+          _nums$map6 = _slicedToArray(_nums$map5, 2),
+          _tr = _nums$map6[0],
+          _pr = _nums$map6[1];
+        return [_tr, _tr, _tr, _pr, _pr];
+      }
+    case 'x':
+      {
+        if (nums.length !== 1) {
+          throw new Error("rankSignatureToRanks: x \u578B\u7B7E\u540D\u987B\u542B 1 \u4E2A\u70B9\u6570\u6BB5\uFF0C\u5B9E\u9645 ".concat(nums.length));
+        }
+        var q = numericRankToRank(nums[0]);
+        return [q, q, q, q, null];
+      }
+    default:
+      throw new Error("rankSignatureToRanks: \u672A\u77E5\u724C\u578B\u524D\u7F00 ".concat(category));
+  }
+}
+
+/** 供 UI 分组渲染：每组 `ranks` 为从左到右、已合并同点的连续张（与 `rankSignatureToRanks` 顺序一致）。 */
+
+var FLAT_DISPLAY_CATEGORIES = new Set(['q', 'v', 'u', 'y', 'z']);
+
+/**
+ * 将牌力签名映射为展示用分组（间距与样式由应用层决定）。
+ * - `q`/`v`/`u`/`y`/`z`：每张一组；顺子 wheel 时 A 已在末位（见 `straightRanksFromMax`）。
+ * - `r`/`s`/`t`/`w`/`x`：连续同点合并为一组。
+ */
+function rankSignatureToDisplayGroups(rankSignature) {
+  var category = rankSignature[0];
+  var expanded = rankSignatureToRanks(rankSignature);
+  if (FLAT_DISPLAY_CATEGORIES.has(category)) {
+    var _ranks = expanded.filter(function (r) {
+      return r !== null;
+    });
+    return _ranks.map(function (r) {
+      return {
+        ranks: [r]
+      };
+    });
+  }
+  var ranks = expanded.filter(function (r) {
+    return r !== null;
+  });
+  var groups = [];
+  var i = 0;
+  while (i < ranks.length) {
+    var j = i + 1;
+    while (j < ranks.length && ranks[j] === ranks[i]) j++;
+    groups.push({
+      ranks: ranks.slice(i, j)
+    });
+    i = j;
+  }
+  return groups;
+}
+
 /**
  * RankSignature 解析、两副五张牌比较、可排序强度（与具体组合枚举无关）。
  */

package/dist/Deck/index.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _constant = require("./constant");
+var _standardDeck = require("./standardDeck");
 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; } }
@@ -83,10 +83,7 @@ var Deck = /*#__PURE__*/function () {
   }]);
 }();
 function _createDeck() {
-  var pokes = new Array(_constant.suits.length * _constant.ranks.length).fill(0).map(function (_, i) {
-    return "".concat(_constant.suits[Math.floor(i / _constant.ranks.length)]).concat(_constant.ranks[i % _constant.ranks.length]);
-  });
-  _classPrivateFieldSet(_deck, this, pokes);
+  _classPrivateFieldSet(_deck, this, (0, _standardDeck.createStandardDeckPokes)());
 }
 function _shuffle() {
   for (var i = _classPrivateFieldGet(_deck, this).length - 1; i > 0; i--) {

package/dist/Deck/standardDeck.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createStandardDeckPokes = createStandardDeckPokes;
+var _constant = require("./constant");
+/**
+ * 生成标准 52 张牌（无洗牌）。
+ * 顺序与 `Deck` 内部建牌一致：按 `suits` 顺序，每种花色内 `ranks` 从 2 到 a（如 `h2`…`ha`，再 `s2`…）。
+ */
+function createStandardDeckPokes() {
+  var n = _constant.suits.length * _constant.ranks.length;
+  var out = new Array(n);
+  for (var i = 0; i < n; i++) {
+    out[i] = "".concat(_constant.suits[Math.floor(i / _constant.ranks.length)]).concat(_constant.ranks[i % _constant.ranks.length]);
+  }
+  return out;
+}

package/dist/engine/domainEventReadModel.js

@@ -215,7 +215,11 @@ function reduceLastHandEndedFromDomainEvents(events) {
           outcome: p.outcome,
           pokesRevealed: p.pokesRevealed,
           endStage: p.endStage,
-          showHandPokes: p.showHandPokes
+          showHandPokes: p.showHandPokes,
+          bestPokes: p.bestPokes,
+          bestRankCategory: p.bestRankCategory,
+          bestRankSignature: p.bestRankSignature,
+          bestRankStrength: p.bestRankStrength
         };
       }
     }

package/dist/index.js

@@ -8,11 +8,14 @@ var _exportNames = {
   Texas: true,
   Deck: true,
   formatterPoke: true,
+  createStandardDeckPokes: true,
   getBestPokesRankSignature: true,
   compareRankSignature: true,
   getFiveCardsStrength: true,
   getStrengthFromRankSignature: true,
   getFiveCardCombinationIndices: true,
+  rankSignatureToRanks: true,
+  rankSignatureToDisplayGroups: true,
   TableStakes: true,
   CurrentHand: true,
   stageMap: true,
@@ -367,6 +370,12 @@ Object.defineProperty(exports, "createInMemoryDomainEventStore", {
     return _replay.createInMemoryDomainEventStore;
   }
 });
+Object.defineProperty(exports, "createStandardDeckPokes", {
+  enumerable: true,
+  get: function get() {
+    return _core.createStandardDeckPokes;
+  }
+});
 Object.defineProperty(exports, "defaultPipelineOrdered", {
   enumerable: true,
   get: function get() {
@@ -517,6 +526,18 @@ Object.defineProperty(exports, "projectCompositeReadModel", {
     return _replay.projectCompositeReadModel;
   }
 });
+Object.defineProperty(exports, "rankSignatureToDisplayGroups", {
+  enumerable: true,
+  get: function get() {
+    return _core.rankSignatureToDisplayGroups;
+  }
+});
+Object.defineProperty(exports, "rankSignatureToRanks", {
+  enumerable: true,
+  get: function get() {
+    return _core.rankSignatureToRanks;
+  }
+});
 Object.defineProperty(exports, "reduceCanonicalSessionToTableStateV1", {
   enumerable: true,
   get: function get() {

package/package.json

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

package/types/Controller/HandSettlement.d.ts

@@ -4,6 +4,8 @@ export type RankSettlementSnapshot = {
     rankCategory?: RankCategory;
     pokes: Poke[][];
     rankStrength: number;
+    /** 与 `pokes[0]` 一致的最强牌签名（多人平分牌型时各赢家 bestFive 的签名相同）。 */
+    rankSignature?: RankSignature;
 };
 /** 单座摊牌评估（唯一数据源；`Player` 经 `Controller.getShowdownEvalForPlayer` 只读） */
 export type ShowdownPlayerEval = {

package/types/Deck/core.d.ts

@@ -1,7 +1,9 @@
 /**
  * 牌力相关入口：按职责拆分为 `format` / `handEvaluation` / `handCompare` / `handCombinations`，本文件保持向后兼容的聚合导出。
  */
+export { createStandardDeckPokes } from './standardDeck';
 export { formatterPoke } from './format';
 export { isStraight, getFiveCardCombinationIndices, allFiveCardHandsFromPool, getFiveCardsRankSignature } from './handEvaluation';
-export { compareFn, compareRankSignature, getStrengthFromRankSignature, getFiveCardsStrength } from './handCompare';
+export { compareFn, compareRankSignature, getStrengthFromRankSignature, getFiveCardsStrength, rankSignatureToRanks, rankSignatureToDisplayGroups } from './handCompare';
+export type { RankSignatureDisplayGroup } from './handCompare';
 export { getBestFiveCards, getBestPokesRankSignature } from './handCombinations';

package/types/Deck/handCompare.d.ts

@@ -1,4 +1,20 @@
-import { Poke, RankSignature } from './constant';
+import { Poke, Rank, RankSignature } from './constant';
+/**
+ * 将 `RankSignature` 展开为五张牌的点数（`Rank`），与 `getFiveCardsRankSignature` 编码对称。
+ * 顺子 wheel（`u5`/`y5`）为 5→A 展示顺序，A 在末位；Broadway 仍为 A→T。
+ * `x`（四条）当前签名仅含四条点数，踢脚未编码，第五位为 `null`。
+ */
+export declare function rankSignatureToRanks(rankSignature: RankSignature): (Rank | null)[];
+/** 供 UI 分组渲染：每组 `ranks` 为从左到右、已合并同点的连续张（与 `rankSignatureToRanks` 顺序一致）。 */
+export type RankSignatureDisplayGroup = {
+    ranks: Rank[];
+};
+/**
+ * 将牌力签名映射为展示用分组（间距与样式由应用层决定）。
+ * - `q`/`v`/`u`/`y`/`z`：每张一组；顺子 wheel 时 A 已在末位（见 `straightRanksFromMax`）。
+ * - `r`/`s`/`t`/`w`/`x`：连续同点合并为一组。
+ */
+export declare function rankSignatureToDisplayGroups(rankSignature: RankSignature): RankSignatureDisplayGroup[];
 export declare const compareFn: (a: Poke[], b: Poke[]) => number;
 export declare const compareRankSignature: (p1: string, p2: string) => number;
 export declare function getStrengthFromRankSignature(rankSignature: RankSignature): number;

package/types/Deck/standardDeck.d.ts

@@ -0,0 +1,6 @@
+import { type Poke } from './constant';
+/**
+ * 生成标准 52 张牌（无洗牌）。
+ * 顺序与 `Deck` 内部建牌一致：按 `suits` 顺序，每种花色内 `ranks` 从 2 到 a（如 `h2`…`ha`，再 `s2`…）。
+ */
+export declare function createStandardDeckPokes(): Poke[];

package/types/Deck/standardDeck.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/domain/handDomainEvents.d.ts

@@ -1,7 +1,7 @@
 import type { Role } from '../Player/constant';
 import type { Stage } from '../Controller/stage';
 import type { ActionTypeEnum } from '../Player/constant';
-import type { Poke, RankCategory } from '../Deck/constant';
+import type { Poke, RankCategory, RankSignature } from '../Deck/constant';
 /**
  * 思考权结束原因（计时由业务层负责时，`timeout` 在收到超时 Command 后由 Core 标记；
  * `leave`：`FoldDueToLeave` 且为本席思考窗内离场时标记）。
@@ -125,6 +125,8 @@ export type HandDomainEvent = {
         showHandPokes: boolean;
         bestPokes?: Poke[][];
         bestRankCategory?: RankCategory;
+        /** 与 `bestPokes[0]` 对应的牌力签名；摊牌时由引擎写入，供 WS `game-end` / 回放磁带一致下发。 */
+        bestRankSignature?: RankSignature;
         bestRankStrength?: number;
     };
 };

package/types/engine/domainEventReadModel.d.ts

@@ -1,7 +1,7 @@
-import type { Poke } from '../Deck/constant';
 import type { Role } from '../Player/constant';
 import type { Stage } from '../Controller/stage';
 import type { ActionTypeEnum } from '../Player/constant';
+import type { Poke, RankCategory, RankSignature } from '../Deck/constant';
 import type { TurnEndedReason, TexasDomainEvent } from '../domain/handDomainEvents';
 /** 将多段事件批（如 `dispatchCommand` + 若干 `flush*`）按顺序拼成一条磁带（新数组）。 */
 export declare function flatConcatDomainEvents(parts: readonly (readonly TexasDomainEvent[])[]): TexasDomainEvent[];
@@ -50,6 +50,10 @@ export type HandEndedReadModel = Readonly<{
     pokesRevealed: readonly Poke[];
     endStage: Stage;
     showHandPokes: boolean;
+    bestPokes?: readonly (readonly Poke[])[];
+    bestRankCategory?: RankCategory;
+    bestRankSignature?: RankSignature;
+    bestRankStrength?: number;
 }>;
 export declare function reduceLastHandEndedFromDomainEvents(events: readonly TexasDomainEvent[]): HandEndedReadModel | null;
 /** 本批中**最后一条** `PotAwarded`（结算分配快照）。 */

package/types/index.d.ts

@@ -15,7 +15,8 @@ import Controller, { Stage, StageEnum, HandLifecycle, type PendingFlowOp, type P
 import { User, Role, Action, RoleEnum, ActionType, ActionTypeEnum, type PlayerStatus, default as Player, resolveAllowedActions, type AllowedActionsContext, isPlayerEligibleForStreetBetting } from './Player';
 import TexasError, { texasErrorMap, TexasCoreErrorCode, texasErrorCategory, type TexasErrorCode, getTexasErrorSeverity, isFatalTexasErrorCode, type TexasErrorPayload, type TexasErrorSeverity, formatTexasErrorMessage, type TexasErrorCodeLegacy } from './TexasError';
 export * from './Deck/constant';
-export { getBestPokesRankSignature, compareRankSignature, getFiveCardsStrength, getStrengthFromRankSignature, getFiveCardCombinationIndices } from './Deck/core';
+export { createStandardDeckPokes, getBestPokesRankSignature, compareRankSignature, getFiveCardsStrength, getStrengthFromRankSignature, getFiveCardCombinationIndices, rankSignatureToRanks, rankSignatureToDisplayGroups } from './Deck/core';
+export type { RankSignatureDisplayGroup } from './Deck/core';
 export { Player, User, ActionType, ActionTypeEnum, Role, RoleEnum, Action, roleMap, ActionTypeMap, Stage, StageEnum, HandLifecycle, type ShowdownPlayerEval, type PendingFlowOp, type PendingFlowOpKind, TableStakes, type PlayerDealerRing, type PlayerHandSession, type PlayerStreetBetLedger, type StreetPotSink, StreetBetLedger, stageMap, Controller, Dealer, Table, DealerService, Deck, DealtBoard, type DealSnapshot, Room, RoomStatus, PlayerSeatStatus, type RoomCreateOptions, type RoomMemberCounts, formatterPoke, TexasError, TexasErrorCode, TexasErrorPayload, TexasErrorSeverity, TexasCoreErrorCode, formatTexasErrorMessage, getTexasErrorSeverity, isFatalTexasErrorCode, texasErrorMap, texasErrorCategory, TexasEngineContext, Texas, type PlayerStatus, type AllowedActionsContext, resolveAllowedActions, isPlayerEligibleForStreetBetting, type TexasEngineGlobalOptions, type TexasSimulationFlags, 
 /** @deprecated 旧版宽泛 code 类型，请逐步迁移到 TexasErrorCode */
 type TexasErrorCodeLegacy, CurrentHand };