@yyyu-star/arcade-kit 0.10.2 → 0.11.1

package/dist/table-fun.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 牌桌互动组件（0.11.0，仓库根 docs/table-fun.md 第 0 节）：头像菜单、互动面板、表情菜单、首次提示、冷却和护盾、连击和回敬、
+ * 电脑的反应、名场面横幅。几个牌桌游戏共用一套，外观、位置规则、动画、声音完全一样；游戏只做接线：
+ * 告诉组件每个座位的头像在屏幕上的矩形、名字、是不是电脑和互动性格，哪些地方不能盖（手牌、操作按钮），怎么把东西发出去，
+ * 再把收到的（好友房经房间转发的，单机自己的）交给 receive、把公开的名场面交给 moment。
+ *
+ * - DOM 实现：头像上盖一块透明的热区接点按和长按（画布游戏把世界坐标换成屏幕矩形传进来就行），菜单和面板是普通的 DOM，点按区 ≥ 44px；
+ *   效果（表情、道具、污渍）走 fun.ts 的图层，点击穿透。这个文件只在调用时碰 DOM，import 时不碰（房间、测试里 import 没事）。
+ * - 动画只动 transform、opacity；量位置（getBoundingClientRect）只在开菜单、给冒烟报控件时。
+ * - 公平：人人一样、免费；只是画面和声音，不停计时、不改规则；电脑的出牌不读这些。电脑的反应只在画面层（单机）或房间的互动钩子里算。
+ * - kit 不认识任何游戏：短语表、名场面的映射、电脑人物都由游戏给。
+ */
+import { type FunLayer, type FunPhase, type PropId, type RectLike } from './fun.js';
+import { type BotReactConfig, type FunEvent, type FunMood, type FunTemper } from './fun-logic.js';
+export * from './fun-logic.js';
+export type { RectLike };
+/** 一个座位此刻的样子（每次用到时现问，座位换人、头像挪了都跟得上） */
+export interface FunSeat {
+    /** 头像的屏幕矩形（CSS 像素，getBoundingClientRect 的结果能直接传） */
+    rect: RectLike;
+    name: string;
+    /** 是我自己（点了出表情菜单，长按发上次那个表情） */
+    me?: boolean;
+    /** 是电脑（单机时组件替它反应；首次提示冒在电脑头像上） */
+    bot?: boolean;
+    /** 电脑的互动性格，默认 normal */
+    temper?: FunTemper;
+}
+export interface TableFunOptions {
+    /** 游戏 id：首次提示、屏蔽名单的存储 key 前缀（`<id>.hint.fun`、`<id>.fun.blocked`） */
+    storageKey: string;
+    /** 本游戏的短语表（编号 0..P-1，见 fun-logic 的 funItem） */
+    phrases: readonly string[];
+    /** 头像菜单里那 3 句点名短语（短语表的下标），默认前 3 句 */
+    named?: readonly number[];
+    /** 座位：下标就是发送、收到时用的座位号；空座位给 null */
+    seats(): readonly (FunSeat | null)[];
+    /** 菜单、面板不能盖的地方（手牌、操作按钮），屏幕矩形 */
+    avoid?(): readonly RectLike[];
+    /** "互动"按钮放哪（屏幕矩形，组件画按钮）；null 就不画（比如没坐下） */
+    button?(): RectLike | null;
+    /** 发出去：好友房走 kit emote，单机直接回给 receive */
+    send(id: number, to?: number): void;
+    /** 现在能不能发（好友房：坐下了才能），默认能 */
+    canSend?(): boolean;
+    /** 设置里"互动：开 / 不看"，关了别人的一律不播，单机电脑也不反应；默认开 */
+    enabled?(): boolean;
+    /** 屏蔽名单按这个分开（房间码；单机一个固定值），默认 'solo' */
+    scope?(): string;
+    /** 单机：电脑的反应由组件按 botReact 算、在本地播（好友房的电脑在房间里算，这里别开） */
+    localBots?: boolean;
+    /** 各种情绪时电脑气泡说的话；不给就用 kit 的默认（不提任何游戏） */
+    moodLines?: Partial<Record<FunMood, readonly string[]>>;
+    /** 道具声音：起飞、引信、命中时调，游戏用自己的音频（跟着静音开关）放 playFunSound */
+    sound?(prop: PropId, phase: FunPhase): void;
+    /** 命中那一刻：游戏让被扔的头像抖一下 */
+    onHit?(seat: number, prop: PropId): void;
+    /** 冒烟、调试看的流水：`道具 0>1:tomato ×2 回敬`、`表情 0:smug`、`短语 2:3`、`护盾 1`、`提示 头像` */
+    log?(line: string): void;
+    /** 效果图层的 z-index，菜单和热区在它上面一层；默认 50 */
+    zIndex?: number;
+    /** 电脑反应的参数，默认规范的数字 */
+    react?: BotReactConfig;
+    /** 测试、复现用 */
+    rand?(): number;
+    now?(): number;
+}
+type Tab = 'phrase' | 'sticker' | 'prop';
+export declare class TableFun {
+    readonly layer: FunLayer;
+    private readonly ui;
+    private readonly doc;
+    private readonly o;
+    private readonly P;
+    private readonly cool;
+    private readonly tally;
+    private readonly bots;
+    private hots;
+    private btn;
+    private open;
+    private tab;
+    private target;
+    private lastProp;
+    private lastSticker;
+    private timers;
+    private dead;
+    private readonly onResize;
+    constructor(opts: TableFunOptions);
+    private now;
+    private rand;
+    private later;
+    private seat;
+    private meSeat;
+    private canSend;
+    private enabled;
+    /** 头像挪了、窗口变了、座位换人：重新摆热区和按钮（游戏重排画面后调；窗口 resize 自己会调） */
+    refresh(): void;
+    /** 头像热区：点一下开菜单（别人）或表情菜单（自己）；按住 longPressMs 直接扔上次的道具 / 发上次的表情 */
+    private makeHot;
+    private tapSeat;
+    /** 长按：别人 → 扔上次那个道具；自己 → 发上次那个表情 */
+    private quick;
+    private pick;
+    private box;
+    private el;
+    private chip;
+    private cell;
+    /** 点别人头像：第一排 8 个道具（第一格是上次扔的那个），第二排 3 句点名短语，最后"屏蔽他" */
+    private openMenu;
+    /** 点自己头像：12 个表情 */
+    private openStickers;
+    /** "互动"按钮：短语 / 表情 / 道具三个页签；道具页先选人再选道具 */
+    openPanel(tab?: Tab): void;
+    closeAll(): void;
+    /** 有菜单或面板开着（游戏可以据此暂停自己的快捷键） */
+    isOpen(): boolean;
+    private blockKey;
+    private blockedNames;
+    isBlocked(seat: number): boolean;
+    setBlocked(seat: number, on: boolean): void;
+    /** 有人发了东西（好友房房间转发来的、单机自己的、电脑的）：按种类播；别人的东西在关了互动、被屏蔽时不播 */
+    receive(from: number, id: number, to?: number): void;
+    private play;
+    /** 名场面（游戏把自己的公开事件映射过来）：单机里电脑按性格起哄；横幅另由 banner 播 */
+    moment(ev: Extract<FunEvent, {
+        kind: 'moment';
+    }>): void;
+    private react;
+    /** 电脑的反应一定看得见：表情加一句话的气泡同时出；回敬再让道具飞过去 */
+    private perform;
+    private line;
+    /** 头像旁的一句话：朝屏幕中间那侧冒，2.4 秒后淡出 */
+    bubble(seat: number, text: string, ms?: number): void;
+    /** 头像上方冒一个字（×N、回敬！、护盾）：放大弹一下再飘走 */
+    private flash;
+    /** 名场面横幅：屏幕上方居中一条红底金边，1.8 秒 */
+    banner(text: string, sub?: string): void;
+    /** 首次进牌桌：在一个电脑（没有就别人）头像旁说一句怎么玩，3 秒后收起，只出一次 */
+    private hint;
+    /** 游戏开自己的弹窗时藏起来（正在播的不中断），关掉后 show */
+    hide(): void;
+    show(): void;
+    /** 冒烟用：按钮、头像热区、开着的菜单里每一项的屏幕中心和大小（查点按区 ≥ 44） */
+    controls(): Record<string, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    destroy(): void;
+}
+//# sourceMappingURL=table-fun.d.ts.map

package/dist/table-fun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-fun.d.ts","sourceRoot":"","sources":["../src/table-fun.ts"],"names":[],"mappings":"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"}