dsh-blackjack 0.1.2 → 0.1.3

package/dist/api.d.ts

@@ -40,6 +40,11 @@ export interface MeView {
     exchangeThresholdChips: number;
     baseBetChips: number;
     githubLogin: string | null;
+    /**
+     * 加注上限。**可选**：插件发到 npm 后可能连到任何一版服务端，比这个字段更早的
+     * 服务端不会返回它。缺失时图形牌桌只隐藏自定义注额输入，预设按钮照常可用。
+     */
+    maxRaiseBetChips?: number;
 }
 /** Every failure this client surfaces: HTTP status plus the server's error code. */
 export declare class ApiError extends Error {

package/dist/client/Table.d.ts

@@ -24,7 +24,22 @@ export interface BlackjackTableProps {
     state: BlackjackApiState;
     onAction: (action: string) => void;
     onDeal: (betChips?: number) => void;
+    /** 玩家收起已结算的牌局，回到空闲态。 */
+    onDismiss: () => void;
     /** Brief inline notice for a failed action/deal call (container-owned; cleared on the next successful one). */
     error?: string;
 }
-export declare function BlackjackTable({ state, onAction, onDeal, error }: BlackjackTableProps): JSX.Element;
+/**
+ * 动作要额外掏多少 CHIP。镜像服务端 `game.ts` 的 INCREMENT：双倍/分牌各再出
+ * 一份注额，保险出一半。抽成导出的纯函数，好让"余额不足时必须置灰"能被断言。
+ */
+export declare function actionCostChips(action: string, betChips: number): number;
+/**
+ * 注额校验。抽成导出的纯函数，好让边界（0、小数、超余额、超服务端上限）
+ * 能被直接断言，而不是只能靠驱动输入框间接覆盖。
+ */
+export declare function betError(chips: number, opts: {
+    balanceChips: number;
+    maxChips: number;
+}): string | null;
+export declare function BlackjackTable({ state, onAction, onDeal, onDismiss, error }: BlackjackTableProps): JSX.Element;

package/dist/client/Table.js

@@ -1,4 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { stakeLine, outcomeLine } from '../copy.js';
 const SUITS = { S: '♠', H: '♥', D: '♦', C: '♣' };
 const RED_SUITS = new Set(['H', 'D']);
 const n = (v) => v.toLocaleString('en-US');
@@ -24,7 +26,17 @@ const CSS = `
   font: inherit; padding: 6px 14px; border-radius: 6px; border: 1px solid var(--bj-line);
   background: rgba(255,255,255,.08); color: inherit; cursor: pointer;
 }
-.bj-actions button:hover { background: rgba(255,255,255,.16); }
+.bj-actions button:hover:not(:disabled) { background: rgba(255,255,255,.16); }
+.bj-actions button:disabled { opacity: .4; cursor: not-allowed; }
+.bj-custom { display: flex; gap: 8px; align-items: center; margin-top: 8px; flex-wrap: wrap; }
+.bj-custom input {
+  font: inherit; width: 9em; padding: 5px 8px; border-radius: 6px;
+  border: 1px solid var(--bj-line); background: rgba(255,255,255,.06); color: inherit;
+}
+.bj-hint { opacity: .7; font-size: 12px; }
+.bj-group { margin-top: 12px; }
+.bj-group-title { font-weight: 600; margin-bottom: 2px; }
+.bj-note { opacity: .75; font-size: 12px; margin-bottom: 6px; }
 .bj-meta { opacity: .85; margin-bottom: 8px; }
 .bj-error {
   color: #c0392b; border: 1px solid rgba(192,57,43,.4); border-radius: 6px;
@@ -53,22 +65,81 @@ function MeHeader({ me }) {
     return (_jsxs("div", { className: "bj-meta", children: ["\u4F59\u989D\uFF1A", n(me.chips), " CHIP\u3000\u4ECA\u65E5\u5269\u4F59\u514D\u8D39\u624B\uFF1A", me.freeHandsRemaining, me.points > 0 ? `　积分：${n(me.points)}` : '', me.poolEmpty ? '（本期奖池已发完，现在赢牌将发放积分）' : '', me.sponsorText ? _jsx("div", { children: me.sponsorText }) : null] }));
 }
 function RoundFooter({ round }) {
-    if (round.phase !== 'settled')
-        return null;
-    const payout = round.payoutChips ?? 0;
-    return (_jsxs("div", { className: "bj-meta", children: [payout > 0 ? `本手赢得 ${n(payout)} CHIP。` : '本手没有收获，明天再来。', round.pointsGranted ? _jsxs("div", { children: ["\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u6539\u4E3A\u53D1\u653E ", n(round.pointsGranted), " \u79EF\u5206\u3002"] }) : null] }));
+    return (_jsxs("div", { className: "bj-meta", children: [round.phase === 'settled' ? outcomeLine(round) : stakeLine(round), round.pointsGranted ? _jsxs("div", { children: ["\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u6539\u4E3A\u53D1\u653E ", n(round.pointsGranted), " \u79EF\u5206\u3002"] }) : null] }));
 }
-function ActionBar({ round, onAction }) {
+/**
+ * 动作要额外掏多少 CHIP。镜像服务端 `game.ts` 的 INCREMENT：双倍/分牌各再出
+ * 一份注额，保险出一半。抽成导出的纯函数，好让"余额不足时必须置灰"能被断言。
+ */
+export function actionCostChips(action, betChips) {
+    if (action === 'double' || action === 'split')
+        return betChips;
+    if (action === 'insure')
+        return Math.ceil(betChips / 2);
+    return 0;
+}
+function ActionBar({ round, me, onAction }) {
     if (round.actions.length === 0)
         return null;
-    return (_jsx("div", { className: "bj-actions", children: round.actions.map((action) => (_jsx("button", { type: "button", onClick: () => onAction(action), children: ACTION_LABELS[action] ?? action }, action))) }));
+    const chips = me?.chips ?? 0;
+    return (_jsx("div", { className: "bj-actions", children: round.actions.map((action) => {
+            // 服务端只按牌面给可选动作，不看余额；余额不够时点下去必然 402，
+            // 只换来一句笼统的失败提示。这里替玩家先拦住并说明原因。
+            const cost = actionCostChips(action, round.betChips);
+            const short = cost > chips;
+            return (_jsxs("button", { type: "button", disabled: short, title: short ? `还要再出 ${n(cost)} CHIP，余额不足` : undefined, onClick: () => onAction(action), children: [ACTION_LABELS[action] ?? action, cost > 0 ? `（${n(cost)}）` : ''] }, action));
+        }) }));
+}
+/**
+ * 注额校验。抽成导出的纯函数，好让边界（0、小数、超余额、超服务端上限）
+ * 能被直接断言，而不是只能靠驱动输入框间接覆盖。
+ */
+export function betError(chips, opts) {
+    if (!Number.isInteger(chips) || chips < 1)
+        return '注额要填正整数。';
+    if (chips > opts.maxChips)
+        return `单局最多 ${n(opts.maxChips)} CHIP。`;
+    if (chips > opts.balanceChips)
+        return '余额不足以下这个注。';
+    return null;
+}
+function DealButtons({ me, onDeal, freeLabel }) {
+    const freeLeft = me?.freeHandsRemaining ?? 0;
+    const presets = me ? [me.baseBetChips, me.baseBetChips * 2] : [];
+    return (_jsxs("div", { className: "bj-actions", children: [_jsxs("button", { type: "button", disabled: freeLeft <= 0, onClick: () => onDeal(), children: [freeLabel, me ? `·剩 ${freeLeft} 手` : ''] }), presets.map((amount) => (_jsxs("button", { type: "button", disabled: (me?.chips ?? 0) < amount, onClick: () => onDeal(amount), children: [n(amount), " CHIP"] }, amount)))] }));
+}
+/**
+ * 自定义注额。**只在服务端给出了 `maxRaiseBetChips` 时出现**——插件可能连到
+ * 比这个字段更早的服务端，那时没有可信上界，宁可退化成只有预设按钮，也不要
+ * 让玩家填一个必定被服务端 400 掉的数字。
+ */
+function CustomBet({ me, onDeal }) {
+    const max = me.maxRaiseBetChips;
+    const [open, setOpen] = useState(false);
+    const [text, setText] = useState('');
+    if (max === undefined)
+        return null;
+    const chips = Number(text);
+    const err = text.trim() === '' ? '请输入注额。' : betError(chips, { balanceChips: me.chips, maxChips: max });
+    return (_jsxs("div", { children: [_jsx("div", { className: "bj-actions", children: _jsx("button", { type: "button", onClick: () => setOpen(!open), children: "\u81EA\u5B9A\u4E49\u6CE8\u989D" }) }), open ? (_jsxs("div", { className: "bj-custom", children: [_jsx("input", { type: "number", min: 1, max: max, value: text, onChange: (e) => setText(e.target.value), "aria-label": "\u81EA\u5B9A\u4E49\u6CE8\u989D" }), _jsx("button", { type: "button", disabled: err !== null, onClick: () => onDeal(chips), children: "\u5F00\u59CB" }), _jsx("span", { className: "bj-hint", children: err ?? `1 ～ ${n(max)} CHIP` })] })) : null] }));
+}
+function IdleTable({ me, onDeal }) {
+    const freeLeft = me?.freeHandsRemaining ?? 0;
+    const base = me?.baseBetChips ?? 0;
+    const presets = me ? [base, base * 2] : [];
+    const affordable = me ? presets.some((a) => me.chips >= a) : false;
+    return (_jsxs("div", { children: [_jsx("div", { className: "bj-meta", children: "\u5F53\u524D\u6CA1\u6709\u8FDB\u884C\u4E2D\u7684\u724C\u5C40\u3002" }), _jsxs("div", { className: "bj-group", children: [_jsxs("div", { className: "bj-group-title", children: ["\u514D\u8D39\u624B \u00B7 ", freeLeft > 0 ? `今日剩 ${freeLeft} 手` : '今日已用完，明天再来'] }), me ? (_jsxs("div", { className: "bj-note", children: ["\u4E0D\u7528\u51FA CHIP\uFF1B\u8D62\u4E86\u62FF ", n(base), " CHIP\uFF08\u5929\u751F 21 \u70B9 ", n(Math.floor(base * 1.5)), "\uFF09\uFF0C\u8F93\u4E86\u4E0D\u635F\u5931\u4EFB\u4F55\u4E1C\u897F\u3002"] })) : null, _jsx("div", { className: "bj-actions", children: _jsx("button", { type: "button", disabled: freeLeft <= 0, onClick: () => onDeal(), children: "\u5F00\u59CB\u514D\u8D39\u7684\u4E00\u5C40" }) })] }), me ? (_jsxs("div", { className: "bj-group", children: [_jsxs("div", { className: "bj-group-title", children: ["\u7528\u4F59\u989D\u52A0\u6CE8", affordable ? '' : ' · 余额不足'] }), _jsx("div", { className: "bj-note", children: "\u52A0\u6CE8\u7684 CHIP \u4ECE\u4F60\u7684\u4F59\u989D\u91CC\u51FA\uFF0C\u8D62\u4E86\u7FFB\u500D\uFF0C\u8F93\u4E86\u6536\u4E0D\u56DE\u3002" }), _jsx("div", { className: "bj-actions", children: presets.map((amount) => (_jsxs("button", { type: "button", disabled: me.chips < amount, onClick: () => onDeal(amount), children: [n(amount), " CHIP"] }, amount))) }), _jsx(CustomBet, { me: me, onDeal: onDeal })] })) : null] }));
 }
-function NoRound({ me, onDeal }) {
-    return (_jsxs("div", { children: [_jsx("div", { className: "bj-meta", children: "\u5F53\u524D\u6CA1\u6709\u8FDB\u884C\u4E2D\u7684\u724C\u5C40\u3002" }), _jsxs("div", { className: "bj-actions", children: [_jsx("button", { type: "button", onClick: () => onDeal(), children: "\u5F00\u59CB\u4E00\u5C40\uFF08\u9650\u514D\uFF09" }), me ? (_jsxs("button", { type: "button", onClick: () => onDeal(me.baseBetChips), children: ["\u5F00\u59CB\u4E00\u5C40\uFF08", n(me.baseBetChips), " CHIP\uFF09"] })) : null] })] }));
+/**
+ * 结算后的出口。牌局结算不再让画面直接跳回空闲态——完整牌面与结果留在原地，
+ * 由玩家决定再来一局还是收起（0.1.2 之前这里什么都没有，爆牌瞬间就被冲掉了）。
+ */
+function SettledBar({ me, onDeal, onDismiss }) {
+    return (_jsxs("div", { children: [_jsx(DealButtons, { me: me, onDeal: onDeal, freeLabel: "\u518D\u6765\u4E00\u5C40\uFF08\u514D\u8D39" }), _jsx("div", { className: "bj-actions", children: _jsx("button", { type: "button", onClick: onDismiss, children: "\u6536\u8D77" }) })] }));
 }
-export function BlackjackTable({ state, onAction, onDeal, error }) {
+export function BlackjackTable({ state, onAction, onDeal, onDismiss, error }) {
     if (!state.consented)
         return _jsx(ConsentPrompt, {});
     const { me, round } = state;
-    return (_jsxs("div", { className: "bj-table", children: [_jsx("style", { children: CSS }), error ? _jsx("div", { className: "bj-error", children: error }) : null, me ? _jsx(MeHeader, { me: me }) : null, round ? (_jsxs("div", { children: [round.hands.map((hand, i) => (_jsx(HandRow, { hand: hand, label: round.hands.length > 1 ? `你的第 ${i + 1} 手` : '你的牌' }, i))), _jsx(DealerRow, { dealer: round.dealer }), _jsx(RoundFooter, { round: round }), _jsx(ActionBar, { round: round, onAction: onAction })] })) : (_jsx(NoRound, { me: me, onDeal: onDeal }))] }));
+    return (_jsxs("div", { className: "bj-table", children: [_jsx("style", { children: CSS }), error ? _jsx("div", { className: "bj-error", children: error }) : null, me ? _jsx(MeHeader, { me: me }) : null, round ? (_jsxs("div", { children: [round.hands.map((hand, i) => (_jsx(HandRow, { hand: hand, label: round.hands.length > 1 ? `你的第 ${i + 1} 手` : '你的牌' }, i))), _jsx(DealerRow, { dealer: round.dealer }), _jsx(RoundFooter, { round: round }), _jsx(ActionBar, { round: round, me: me, onAction: onAction }), round.phase === 'settled' ? _jsx(SettledBar, { me: me, onDeal: onDeal, onDismiss: onDismiss }) : null] })) : (_jsx(IdleTable, { me: me, onDeal: onDeal }))] }));
 }

package/dist/client/index.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useState } from 'react';
 import { BlackjackTable } from './Table.js';
+import { reduce } from './state.js';
 /**
  * Client module entry: registers the graphical table into the KEYED
  * `conversation.chat.commandview` slot under `key: 'blackjack'`, so every
@@ -23,41 +24,54 @@ async function getJson(path, init) {
 }
 /** Brief, vocabulary-safe notice shown when an action/deal call fails; never echoes the raw server error text. */
 const ACTION_FAILED_NOTICE = '上一次操作没有成功，已为你刷新到最新状态。';
-/** Container: owns data fetching. Refetches state after every action — no polling timer. */
+/**
+ * Container: owns data fetching. 牌局以发牌/动作的**返回值**为准，只有玩家点
+ * "收起"才清空；余额刷新单独走，绝不碰牌局。0.1.2 之前这里把动作返回值整个
+ * 丢掉、再拉一次 /api/state，而那个端点只报进行中的牌局——于是玩家一爆牌，
+ * 画面就跳回"当前没有进行中的牌局"，从头到尾看不见自己怎么输的。
+ */
 function BlackjackTableContainer() {
     const [state, setState] = useState(null);
     const [actionError, setActionError] = useState(null);
-    const refresh = useCallback(() => {
+    /** 整份同步：挂载时，以及动作失败后状态存疑时。 */
+    const sync = useCallback(() => {
         getJson('/blackjack/api/state')
-            .then(setState)
+            .then((payload) => setState((s) => reduce(s ?? { consented: false }, { type: 'synced', payload })))
             .catch(() => setState({ consented: false }));
     }, []);
+    /** 只取 me：动作之后余额与免费手会变，但牌局必须留着。 */
+    const refreshMe = useCallback(() => {
+        getJson('/blackjack/api/state')
+            .then((payload) => setState((s) => (s ? reduce(s, { type: 'meRefreshed', me: payload.me }) : s)))
+            .catch(() => { });
+    }, []);
     useEffect(() => {
-        refresh();
-    }, [refresh]);
-    const runAction = useCallback((path, body) => {
+        sync();
+    }, [sync]);
+    const post = useCallback((path, body) => {
         getJson(path, {
             method: 'POST',
             headers: { 'content-type': 'application/json' },
             body: JSON.stringify(body),
         })
-            .then(() => {
+            .then((round) => {
             setActionError(null);
-            refresh();
+            setState((s) => (s ? reduce(s, { type: 'round', round }) : s));
+            refreshMe();
         })
             .catch(() => {
-            // A failed action (including the 404 "no active round" case) still
-            // resyncs state so the UI never shows a stale action bar, but the
-            // notice stays up until the next successful action clears it.
+            // 失败（含 404 "no active round"）后牌局状态存疑，整份重同步，
+            // 免得动作栏停在一个已经不存在的牌局上。
             setActionError(ACTION_FAILED_NOTICE);
-            refresh();
+            sync();
         });
-    }, [refresh]);
-    const onDeal = useCallback((betChips) => runAction('/blackjack/api/deal', betChips === undefined ? {} : { betChips }), [runAction]);
-    const onAction = useCallback((action) => runAction('/blackjack/api/action', { action }), [runAction]);
+    }, [refreshMe, sync]);
+    const onDeal = useCallback((betChips) => post('/blackjack/api/deal', betChips === undefined ? {} : { betChips }), [post]);
+    const onAction = useCallback((action) => post('/blackjack/api/action', { action }), [post]);
+    const onDismiss = useCallback(() => setState((s) => (s ? reduce(s, { type: 'dismissed' }) : s)), []);
     if (state === null)
         return null;
-    return _jsx(BlackjackTable, { state: state, onAction: onAction, onDeal: onDeal, error: actionError ?? undefined });
+    return (_jsx(BlackjackTable, { state: state, onAction: onAction, onDeal: onDeal, onDismiss: onDismiss, error: actionError ?? undefined }));
 }
 export function apply(ctx) {
     ctx.slots.inject('conversation.chat.commandview', () => ctx.slots.register({

package/dist/client/state.d.ts

@@ -0,0 +1,39 @@
+import type { MeView, RoundView } from '../api.js';
+/**
+ * 图形牌桌的状态迁移。抽成纯函数是为了让"结算后的牌局必须留在屏幕上"这条
+ * 能被直接断言——它原先埋在 React 容器里，没有 DOM 环境就测不到，于是
+ * 0.1.2 带着这个缺陷发了出去。
+ *
+ * 关键不变式：**只有 `dismissed` 能清掉 `round`。** 余额刷新绝不碰它。
+ * @module dsh-blackjack/client/state
+ */
+export interface TableState {
+    consented: boolean;
+    me?: MeView;
+    round?: RoundView;
+}
+export type TableEvent = 
+/** 挂载时的一次性同步：整份状态以服务端为准（含"当前没有进行中的牌局"）。 */
+{
+    type: 'synced';
+    payload: {
+        consented: boolean;
+        me?: MeView;
+        round?: RoundView;
+    };
+}
+/** 发牌/动作的返回值。牌局以它为准——包括结算态，那正是要留在屏幕上的东西。 */
+ | {
+    type: 'round';
+    round: RoundView;
+}
+/** 动作之后余额与免费手会变，只更新 me。 */
+ | {
+    type: 'meRefreshed';
+    me?: MeView;
+}
+/** 玩家点了"收起"，回到空闲态。 */
+ | {
+    type: 'dismissed';
+};
+export declare function reduce(state: TableState, event: TableEvent): TableState;

package/dist/client/state.js

@@ -0,0 +1,12 @@
+export function reduce(state, event) {
+    switch (event.type) {
+        case 'synced':
+            return { consented: event.payload.consented, me: event.payload.me, round: event.payload.round };
+        case 'round':
+            return { ...state, round: event.round };
+        case 'meRefreshed':
+            return { ...state, me: event.me };
+        case 'dismissed':
+            return { ...state, round: undefined };
+    }
+}

package/dist/client.js

@@ -3,7 +3,7 @@ window.__ModuleLoader__.load({
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
-"use strict";var b=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var h=(e,n)=>{for(var a in n)b(e,a,{get:n[a],enumerable:!0})},S=(e,n,a,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of j(n))!x.call(e,o)&&o!==a&&b(e,o,{get:()=>n[o],enumerable:!(i=v(n,o))||i.enumerable});return e};var w=e=>S(b({},"__esModule",{value:!0}),e);var $={};h($,{apply:()=>P,inject:()=>I});module.exports=w($);var s=require("react");var t=require("react/jsx-runtime"),y={S:"\u2660",H:"\u2665",D:"\u2666",C:"\u2663"},C=new Set(["H","D"]),d=e=>e.toLocaleString("en-US"),N={hit:"\u8981\u724C",stand:"\u505C\u724C",double:"\u53CC\u500D",split:"\u5206\u724C",insure:"\u4E70\u4FDD\u9669",decline:"\u4E0D\u4E70\u4FDD\u9669"},E=`
+"use strict";var h=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var H=(e,n)=>{for(var i in n)h(e,i,{get:n[i],enumerable:!0})},E=(e,n,i,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of T(n))!V.call(e,o)&&o!==i&&h(e,o,{get:()=>n[o],enumerable:!(a=R(n,o))||a.enumerable});return e};var I=e=>E(h({},"__esModule",{value:!0}),e);var Z={};H(Z,{apply:()=>Y,inject:()=>K});module.exports=I(Z);var c=require("react");var j=require("react");var b=e=>e.toLocaleString("en-US");function y(e){return e.mode==="free"?`\u8FD9\u662F\u514D\u8D39\u7684\u4E00\u5C40\uFF1A\u8D62\u4E86\u62FF ${b(e.betChips)} CHIP\uFF0C\u8F93\u4E86\u4E0D\u635F\u5931\u4EFB\u4F55\u4E1C\u897F\u3002`:`\u672C\u5C40\u5DF2\u52A0\u6CE8 ${b(e.betChips)} CHIP\uFF0C\u4ECE\u4F60\u7684\u4F59\u989D\u91CC\u51FA\u3002`}function C(e){let n=e.payoutChips??0,i=e.betChips;return e.hands.length>0&&e.hands.every(a=>a.outcome==="push")?e.mode==="free"?"\u5E73\u5C40\u3002\u8FD9\u624B\u4E0D\u635F\u5931\u4E5F\u4E0D\u83B7\u5F97\u3002":`\u5E73\u5C40\u3002\u52A0\u6CE8\u7684 ${b(i)} CHIP \u539F\u6837\u9000\u56DE\u3002`:n>0?e.mode==="free"?`\u8D62\u4E86\uFF0C\u62FF\u5230 ${b(n)} CHIP\u3002`:`\u8D62\u4E86\uFF0C\u62FF\u56DE ${b(n)} CHIP\uFF08\u52A0\u6CE8 ${b(i)}\uFF09\u3002`:e.mode==="free"?"\u8FD9\u624B\u8F93\u4E86\u3002\u514D\u8D39\u624B\u4E0D\u635F\u5931\u4EFB\u4F55\u4E1C\u897F\u3002":`\u8FD9\u624B\u8F93\u4E86\uFF0C\u52A0\u6CE8\u7684 ${b(i)} CHIP \u6536\u4E0D\u56DE\u3002`}var t=require("react/jsx-runtime"),P={S:"\u2660",H:"\u2665",D:"\u2666",C:"\u2663"},$=new Set(["H","D"]),l=e=>e.toLocaleString("en-US"),D={hit:"\u8981\u724C",stand:"\u505C\u724C",double:"\u53CC\u500D",split:"\u5206\u724C",insure:"\u4E70\u4FDD\u9669",decline:"\u4E0D\u4E70\u4FDD\u9669"},M=`
 .bj-table { --bj-felt: #0f3d2e; --bj-line: rgba(255,255,255,.18); font-size: 14px; }
 .bj-hand { display: flex; gap: 6px; flex-wrap: wrap; align-items: center; margin: 4px 0; }
 .bj-card {
@@ -22,13 +22,23 @@ window.__ModuleLoader__.load({
   font: inherit; padding: 6px 14px; border-radius: 6px; border: 1px solid var(--bj-line);
   background: rgba(255,255,255,.08); color: inherit; cursor: pointer;
 }
-.bj-actions button:hover { background: rgba(255,255,255,.16); }
+.bj-actions button:hover:not(:disabled) { background: rgba(255,255,255,.16); }
+.bj-actions button:disabled { opacity: .4; cursor: not-allowed; }
+.bj-custom { display: flex; gap: 8px; align-items: center; margin-top: 8px; flex-wrap: wrap; }
+.bj-custom input {
+  font: inherit; width: 9em; padding: 5px 8px; border-radius: 6px;
+  border: 1px solid var(--bj-line); background: rgba(255,255,255,.06); color: inherit;
+}
+.bj-hint { opacity: .7; font-size: 12px; }
+.bj-group { margin-top: 12px; }
+.bj-group-title { font-weight: 600; margin-bottom: 2px; }
+.bj-note { opacity: .75; font-size: 12px; margin-bottom: 6px; }
 .bj-meta { opacity: .85; margin-bottom: 8px; }
 .bj-error {
   color: #c0392b; border: 1px solid rgba(192,57,43,.4); border-radius: 6px;
   padding: 4px 8px; margin-bottom: 8px;
 }
-`;function u({card:e}){if("hidden"in e)return(0,t.jsx)("div",{className:"bj-card bj-card-back","aria-label":"\u6697\u724C"});let n=y[e.suit]??e.suit,a=C.has(e.suit)?"bj-card-red":"bj-card-black";return(0,t.jsx)("div",{className:`bj-card ${a}`,children:`${e.rank}${n}`})}function A({hand:e,label:n}){let a=e.soft?"\u8F6F":"";return(0,t.jsxs)("div",{children:[(0,t.jsxs)("div",{className:"bj-meta",children:[n,"\uFF08",a,e.total,"\uFF09",e.doubled?" [\u53CC\u500D]":""]}),(0,t.jsx)("div",{className:"bj-hand",children:e.cards.map((i,o)=>(0,t.jsx)(u,{card:i},o))})]})}function T({dealer:e}){return(0,t.jsxs)("div",{children:[(0,t.jsxs)("div",{className:"bj-meta",children:["\u5E84\u5BB6",e.total!==void 0?`\uFF08${e.total}\uFF09`:""]}),(0,t.jsx)("div",{className:"bj-hand",children:e.cards.map((n,a)=>(0,t.jsx)(u,{card:n},a))})]})}function B(){return(0,t.jsx)("div",{className:"bj-table",children:(0,t.jsxs)("p",{children:["\u8BF7\u5148\u5728\u547D\u4EE4\u884C\u8F93\u5165 ",(0,t.jsx)("code",{children:"/blackjack agree"}),"\uFF0C\u9605\u8BFB\u5E76\u540C\u610F\u89C4\u5219\u540E\u624D\u80FD\u5F00\u59CB\u3002"]})})}function R({me:e}){return(0,t.jsxs)("div",{className:"bj-meta",children:["\u4F59\u989D\uFF1A",d(e.chips)," CHIP\u3000\u4ECA\u65E5\u5269\u4F59\u514D\u8D39\u624B\uFF1A",e.freeHandsRemaining,e.points>0?`\u3000\u79EF\u5206\uFF1A${d(e.points)}`:"",e.poolEmpty?"\uFF08\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u73B0\u5728\u8D62\u724C\u5C06\u53D1\u653E\u79EF\u5206\uFF09":"",e.sponsorText?(0,t.jsx)("div",{children:e.sponsorText}):null]})}function J({round:e}){if(e.phase!=="settled")return null;let n=e.payoutChips??0;return(0,t.jsxs)("div",{className:"bj-meta",children:[n>0?`\u672C\u624B\u8D62\u5F97 ${d(n)} CHIP\u3002`:"\u672C\u624B\u6CA1\u6709\u6536\u83B7\uFF0C\u660E\u5929\u518D\u6765\u3002",e.pointsGranted?(0,t.jsxs)("div",{children:["\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u6539\u4E3A\u53D1\u653E ",d(e.pointsGranted)," \u79EF\u5206\u3002"]}):null]})}function H({round:e,onAction:n}){return e.actions.length===0?null:(0,t.jsx)("div",{className:"bj-actions",children:e.actions.map(a=>(0,t.jsx)("button",{type:"button",onClick:()=>n(a),children:N[a]??a},a))})}function V({me:e,onDeal:n}){return(0,t.jsxs)("div",{children:[(0,t.jsx)("div",{className:"bj-meta",children:"\u5F53\u524D\u6CA1\u6709\u8FDB\u884C\u4E2D\u7684\u724C\u5C40\u3002"}),(0,t.jsxs)("div",{className:"bj-actions",children:[(0,t.jsx)("button",{type:"button",onClick:()=>n(),children:"\u5F00\u59CB\u4E00\u5C40\uFF08\u9650\u514D\uFF09"}),e?(0,t.jsxs)("button",{type:"button",onClick:()=>n(e.baseBetChips),children:["\u5F00\u59CB\u4E00\u5C40\uFF08",d(e.baseBetChips)," CHIP\uFF09"]}):null]})]})}function m({state:e,onAction:n,onDeal:a,error:i}){if(!e.consented)return(0,t.jsx)(B,{});let{me:o,round:r}=e;return(0,t.jsxs)("div",{className:"bj-table",children:[(0,t.jsx)("style",{children:E}),i?(0,t.jsx)("div",{className:"bj-error",children:i}):null,o?(0,t.jsx)(R,{me:o}):null,r?(0,t.jsxs)("div",{children:[r.hands.map((p,l)=>(0,t.jsx)(A,{hand:p,label:r.hands.length>1?`\u4F60\u7684\u7B2C ${l+1} \u624B`:"\u4F60\u7684\u724C"},l)),(0,t.jsx)(T,{dealer:r.dealer}),(0,t.jsx)(J,{round:r}),(0,t.jsx)(H,{round:r,onAction:n})]}):(0,t.jsx)(V,{me:o,onDeal:a})]})}var f=require("react/jsx-runtime"),I=["slots"];async function k(e,n){let a=await fetch(e,n),i=await a.text(),o=i.length>0?JSON.parse(i):{};if(!a.ok){let r=typeof o?.error=="string"?o.error:`${a.status}`;throw new Error(r)}return o}var X="\u4E0A\u4E00\u6B21\u64CD\u4F5C\u6CA1\u6709\u6210\u529F\uFF0C\u5DF2\u4E3A\u4F60\u5237\u65B0\u5230\u6700\u65B0\u72B6\u6001\u3002";function D(){let[e,n]=(0,s.useState)(null),[a,i]=(0,s.useState)(null),o=(0,s.useCallback)(()=>{k("/blackjack/api/state").then(n).catch(()=>n({consented:!1}))},[]);(0,s.useEffect)(()=>{o()},[o]);let r=(0,s.useCallback)((c,g)=>{k(c,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(g)}).then(()=>{i(null),o()}).catch(()=>{i(X),o()})},[o]),p=(0,s.useCallback)(c=>r("/blackjack/api/deal",c===void 0?{}:{betChips:c}),[r]),l=(0,s.useCallback)(c=>r("/blackjack/api/action",{action:c}),[r]);return e===null?null:(0,f.jsx)(m,{state:e,onAction:l,onDeal:p,error:a??void 0})}function P(e){e.slots.inject("conversation.chat.commandview",()=>e.slots.register({name:"conversation.chat.commandview",key:"blackjack",inject:()=>({})},D))}
+`;function k({card:e}){if("hidden"in e)return(0,t.jsx)("div",{className:"bj-card bj-card-back","aria-label":"\u6697\u724C"});let n=P[e.suit]??e.suit,i=$.has(e.suit)?"bj-card-red":"bj-card-black";return(0,t.jsx)("div",{className:`bj-card ${i}`,children:`${e.rank}${n}`})}function B({hand:e,label:n}){let i=e.soft?"\u8F6F":"";return(0,t.jsxs)("div",{children:[(0,t.jsxs)("div",{className:"bj-meta",children:[n,"\uFF08",i,e.total,"\uFF09",e.doubled?" [\u53CC\u500D]":""]}),(0,t.jsx)("div",{className:"bj-hand",children:e.cards.map((a,o)=>(0,t.jsx)(k,{card:a},o))})]})}function J({dealer:e}){return(0,t.jsxs)("div",{children:[(0,t.jsxs)("div",{className:"bj-meta",children:["\u5E84\u5BB6",e.total!==void 0?`\uFF08${e.total}\uFF09`:""]}),(0,t.jsx)("div",{className:"bj-hand",children:e.cards.map((n,i)=>(0,t.jsx)(k,{card:n},i))})]})}function L(){return(0,t.jsx)("div",{className:"bj-table",children:(0,t.jsxs)("p",{children:["\u8BF7\u5148\u5728\u547D\u4EE4\u884C\u8F93\u5165 ",(0,t.jsx)("code",{children:"/blackjack agree"}),"\uFF0C\u9605\u8BFB\u5E76\u540C\u610F\u89C4\u5219\u540E\u624D\u80FD\u5F00\u59CB\u3002"]})})}function A({me:e}){return(0,t.jsxs)("div",{className:"bj-meta",children:["\u4F59\u989D\uFF1A",l(e.chips)," CHIP\u3000\u4ECA\u65E5\u5269\u4F59\u514D\u8D39\u624B\uFF1A",e.freeHandsRemaining,e.points>0?`\u3000\u79EF\u5206\uFF1A${l(e.points)}`:"",e.poolEmpty?"\uFF08\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u73B0\u5728\u8D62\u724C\u5C06\u53D1\u653E\u79EF\u5206\uFF09":"",e.sponsorText?(0,t.jsx)("div",{children:e.sponsorText}):null]})}function X({round:e}){return(0,t.jsxs)("div",{className:"bj-meta",children:[e.phase==="settled"?C(e):y(e),e.pointsGranted?(0,t.jsxs)("div",{children:["\u672C\u671F\u5956\u6C60\u5DF2\u53D1\u5B8C\uFF0C\u6539\u4E3A\u53D1\u653E ",l(e.pointsGranted)," \u79EF\u5206\u3002"]}):null]})}function O(e,n){return e==="double"||e==="split"?n:e==="insure"?Math.ceil(n/2):0}function z({round:e,me:n,onAction:i}){if(e.actions.length===0)return null;let a=n?.chips??0;return(0,t.jsx)("div",{className:"bj-actions",children:e.actions.map(o=>{let r=O(o,e.betChips),s=r>a;return(0,t.jsxs)("button",{type:"button",disabled:s,title:s?`\u8FD8\u8981\u518D\u51FA ${l(r)} CHIP\uFF0C\u4F59\u989D\u4E0D\u8DB3`:void 0,onClick:()=>i(o),children:[D[o]??o,r>0?`\uFF08${l(r)}\uFF09`:""]},o)})})}function U(e,n){return!Number.isInteger(e)||e<1?"\u6CE8\u989D\u8981\u586B\u6B63\u6574\u6570\u3002":e>n.maxChips?`\u5355\u5C40\u6700\u591A ${l(n.maxChips)} CHIP\u3002`:e>n.balanceChips?"\u4F59\u989D\u4E0D\u8DB3\u4EE5\u4E0B\u8FD9\u4E2A\u6CE8\u3002":null}function _({me:e,onDeal:n,freeLabel:i}){let a=e?.freeHandsRemaining??0,o=e?[e.baseBetChips,e.baseBetChips*2]:[];return(0,t.jsxs)("div",{className:"bj-actions",children:[(0,t.jsxs)("button",{type:"button",disabled:a<=0,onClick:()=>n(),children:[i,e?`\xB7\u5269 ${a} \u624B`:""]}),o.map(r=>(0,t.jsxs)("button",{type:"button",disabled:(e?.chips??0)<r,onClick:()=>n(r),children:[l(r)," CHIP"]},r))]})}function F({me:e,onDeal:n}){let i=e.maxRaiseBetChips,[a,o]=(0,j.useState)(!1),[r,s]=(0,j.useState)("");if(i===void 0)return null;let m=Number(r),p=r.trim()===""?"\u8BF7\u8F93\u5165\u6CE8\u989D\u3002":U(m,{balanceChips:e.chips,maxChips:i});return(0,t.jsxs)("div",{children:[(0,t.jsx)("div",{className:"bj-actions",children:(0,t.jsx)("button",{type:"button",onClick:()=>o(!a),children:"\u81EA\u5B9A\u4E49\u6CE8\u989D"})}),a?(0,t.jsxs)("div",{className:"bj-custom",children:[(0,t.jsx)("input",{type:"number",min:1,max:i,value:r,onChange:v=>s(v.target.value),"aria-label":"\u81EA\u5B9A\u4E49\u6CE8\u989D"}),(0,t.jsx)("button",{type:"button",disabled:p!==null,onClick:()=>n(m),children:"\u5F00\u59CB"}),(0,t.jsx)("span",{className:"bj-hint",children:p??`1 \uFF5E ${l(i)} CHIP`})]}):null]})}function G({me:e,onDeal:n}){let i=e?.freeHandsRemaining??0,a=e?.baseBetChips??0,o=e?[a,a*2]:[],r=e?o.some(s=>e.chips>=s):!1;return(0,t.jsxs)("div",{children:[(0,t.jsx)("div",{className:"bj-meta",children:"\u5F53\u524D\u6CA1\u6709\u8FDB\u884C\u4E2D\u7684\u724C\u5C40\u3002"}),(0,t.jsxs)("div",{className:"bj-group",children:[(0,t.jsxs)("div",{className:"bj-group-title",children:["\u514D\u8D39\u624B \xB7 ",i>0?`\u4ECA\u65E5\u5269 ${i} \u624B`:"\u4ECA\u65E5\u5DF2\u7528\u5B8C\uFF0C\u660E\u5929\u518D\u6765"]}),e?(0,t.jsxs)("div",{className:"bj-note",children:["\u4E0D\u7528\u51FA CHIP\uFF1B\u8D62\u4E86\u62FF ",l(a)," CHIP\uFF08\u5929\u751F 21 \u70B9 ",l(Math.floor(a*1.5)),"\uFF09\uFF0C\u8F93\u4E86\u4E0D\u635F\u5931\u4EFB\u4F55\u4E1C\u897F\u3002"]}):null,(0,t.jsx)("div",{className:"bj-actions",children:(0,t.jsx)("button",{type:"button",disabled:i<=0,onClick:()=>n(),children:"\u5F00\u59CB\u514D\u8D39\u7684\u4E00\u5C40"})})]}),e?(0,t.jsxs)("div",{className:"bj-group",children:[(0,t.jsxs)("div",{className:"bj-group-title",children:["\u7528\u4F59\u989D\u52A0\u6CE8",r?"":" \xB7 \u4F59\u989D\u4E0D\u8DB3"]}),(0,t.jsx)("div",{className:"bj-note",children:"\u52A0\u6CE8\u7684 CHIP \u4ECE\u4F60\u7684\u4F59\u989D\u91CC\u51FA\uFF0C\u8D62\u4E86\u7FFB\u500D\uFF0C\u8F93\u4E86\u6536\u4E0D\u56DE\u3002"}),(0,t.jsx)("div",{className:"bj-actions",children:o.map(s=>(0,t.jsxs)("button",{type:"button",disabled:e.chips<s,onClick:()=>n(s),children:[l(s)," CHIP"]},s))}),(0,t.jsx)(F,{me:e,onDeal:n})]}):null]})}function q({me:e,onDeal:n,onDismiss:i}){return(0,t.jsxs)("div",{children:[(0,t.jsx)(_,{me:e,onDeal:n,freeLabel:"\u518D\u6765\u4E00\u5C40\uFF08\u514D\u8D39"}),(0,t.jsx)("div",{className:"bj-actions",children:(0,t.jsx)("button",{type:"button",onClick:i,children:"\u6536\u8D77"})})]})}function w({state:e,onAction:n,onDeal:i,onDismiss:a,error:o}){if(!e.consented)return(0,t.jsx)(L,{});let{me:r,round:s}=e;return(0,t.jsxs)("div",{className:"bj-table",children:[(0,t.jsx)("style",{children:M}),o?(0,t.jsx)("div",{className:"bj-error",children:o}):null,r?(0,t.jsx)(A,{me:r}):null,s?(0,t.jsxs)("div",{children:[s.hands.map((m,p)=>(0,t.jsx)(B,{hand:m,label:s.hands.length>1?`\u4F60\u7684\u7B2C ${p+1} \u624B`:"\u4F60\u7684\u724C"},p)),(0,t.jsx)(J,{dealer:s.dealer}),(0,t.jsx)(X,{round:s}),(0,t.jsx)(z,{round:s,me:r,onAction:n}),s.phase==="settled"?(0,t.jsx)(q,{me:r,onDeal:i,onDismiss:a}):null]}):(0,t.jsx)(G,{me:r,onDeal:i})]})}function f(e,n){switch(n.type){case"synced":return{consented:n.payload.consented,me:n.payload.me,round:n.payload.round};case"round":return{...e,round:n.round};case"meRefreshed":return{...e,me:n.me};case"dismissed":return{...e,round:void 0}}}var S=require("react/jsx-runtime"),K=["slots"];async function x(e,n){let i=await fetch(e,n),a=await i.text(),o=a.length>0?JSON.parse(a):{};if(!i.ok){let r=typeof o?.error=="string"?o.error:`${i.status}`;throw new Error(r)}return o}var Q="\u4E0A\u4E00\u6B21\u64CD\u4F5C\u6CA1\u6709\u6210\u529F\uFF0C\u5DF2\u4E3A\u4F60\u5237\u65B0\u5230\u6700\u65B0\u72B6\u6001\u3002";function W(){let[e,n]=(0,c.useState)(null),[i,a]=(0,c.useState)(null),o=(0,c.useCallback)(()=>{x("/blackjack/api/state").then(d=>n(u=>f(u??{consented:!1},{type:"synced",payload:d}))).catch(()=>n({consented:!1}))},[]),r=(0,c.useCallback)(()=>{x("/blackjack/api/state").then(d=>n(u=>u&&f(u,{type:"meRefreshed",me:d.me}))).catch(()=>{})},[]);(0,c.useEffect)(()=>{o()},[o]);let s=(0,c.useCallback)((d,u)=>{x(d,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(u)}).then(N=>{a(null),n(g=>g&&f(g,{type:"round",round:N})),r()}).catch(()=>{a(Q),o()})},[r,o]),m=(0,c.useCallback)(d=>s("/blackjack/api/deal",d===void 0?{}:{betChips:d}),[s]),p=(0,c.useCallback)(d=>s("/blackjack/api/action",{action:d}),[s]),v=(0,c.useCallback)(()=>n(d=>d&&f(d,{type:"dismissed"})),[]);return e===null?null:(0,S.jsx)(w,{state:e,onAction:p,onDeal:m,onDismiss:v,error:i??void 0})}function Y(e){e.slots.inject("conversation.chat.commandview",()=>e.slots.register({name:"conversation.chat.commandview",key:"blackjack",inject:()=>({})},W))}
 		return module.exports;
 	}
 });

package/dist/copy.d.ts

@@ -0,0 +1,8 @@
+import type { RoundView } from './api.js';
+/** 这一局的性质与代价。进行中时显示，让玩家随时知道自己在打哪种局。 */
+export declare function stakeLine(round: RoundView): string;
+/**
+ * 结算结果。分模式措辞——原先两种局共用一句「本手没有收获，明天再来」，
+ * 而加注局只要有余额马上就能再来，那句话是错的。
+ */
+export declare function outcomeLine(round: RoundView): string;

package/dist/copy.js

@@ -0,0 +1,37 @@
+/**
+ * 牌局文案的单一来源。命令面（render.ts）与图形牌桌（client/Table.tsx）共用
+ * 这里的字符串，否则两边会各说各话——而运营者第一次自己上手时，正是因为
+ * 界面没讲清楚"免费手"和"加注"的区别而看不懂在玩什么。
+ *
+ * 红线（见 render.ts 的 BANNED）：单位一律 CHIP，不用「筹码」；不出现赌博词汇。
+ * @module dsh-blackjack/copy
+ */
+const n = (v) => v.toLocaleString('en-US');
+/** 这一局的性质与代价。进行中时显示，让玩家随时知道自己在打哪种局。 */
+export function stakeLine(round) {
+    return round.mode === 'free'
+        ? `这是免费的一局：赢了拿 ${n(round.betChips)} CHIP，输了不损失任何东西。`
+        : `本局已加注 ${n(round.betChips)} CHIP，从你的余额里出。`;
+}
+/**
+ * 结算结果。分模式措辞——原先两种局共用一句「本手没有收获，明天再来」，
+ * 而加注局只要有余额马上就能再来，那句话是错的。
+ */
+export function outcomeLine(round) {
+    const payout = round.payoutChips ?? 0;
+    const bet = round.betChips;
+    // 加注局平局会原样退回本金，payout > 0 —— 先判平局，否则会被说成赢了。
+    if (round.hands.length > 0 && round.hands.every((h) => h.outcome === 'push')) {
+        return round.mode === 'free'
+            ? '平局。这手不损失也不获得。'
+            : `平局。加注的 ${n(bet)} CHIP 原样退回。`;
+    }
+    if (payout > 0) {
+        return round.mode === 'free'
+            ? `赢了，拿到 ${n(payout)} CHIP。`
+            : `赢了，拿回 ${n(payout)} CHIP（加注 ${n(bet)}）。`;
+    }
+    return round.mode === 'free'
+        ? '这手输了。免费手不损失任何东西。'
+        : `这手输了，加注的 ${n(bet)} CHIP 收不回。`;
+}

package/dist/render.js

@@ -1,3 +1,4 @@
+import { stakeLine, outcomeLine } from './copy.js';
 const SUITS = { S: '♠', H: '♥', D: '♦', C: '♣' };
 /**
  * Regex of vocabulary this project's copy must never contain (parent spec §2
@@ -37,13 +38,14 @@ export function renderRound(view) {
     lines.push(`庄家：${dealer}${view.dealer.total !== undefined ? `（${view.dealer.total}）` : ''}`);
     if (view.phase === 'settled') {
         const won = view.payoutChips ?? 0;
-        lines.push(won > 0 ? `本手赢得 ${n(won)} CHIP。` : '本手没有收获，明天再来。');
+        lines.push(outcomeLine(view));
         if (view.pointsGranted)
             lines.push(`本期奖池已发完，改为发放 ${n(view.pointsGranted)} 积分。`);
         if (won > 0)
             lines.push('（已获得的 CHIP 有效期至本赛季末）');
     }
     else {
+        lines.push(stakeLine(view));
         const map = {
             hit: '/bj-hit 要牌', stand: '/bj-stand 停牌', double: '/bj-double 双倍',
             split: '/bj-split 分牌', insure: '/bj-insure 买保险', decline: '/bj-decline 不买保险',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-blackjack",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "社区福利小游戏插件：在 dsh 里玩 21 点赢取可消费的模型额度",
   "license": "MIT",
   "keywords": [