@lizardon386/game-sdk 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 3178-battle-platform contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# @lizardon386/game-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+3178 对战平台的游戏接入 SDK。游戏工程只需要安装这个包（构建/打包再加 `@lizardon386/sdk-tools`）。
+
+导出路径：
+
+- `@lizardon386/game-sdk`：游戏 ABI、版本常量、`reject` / `isReject` / `stableDigest`
+- `@lizardon386/game-sdk/client`：客户端契约类型
+- `@lizardon386/game-sdk/node`：`.bpmap` 读写（re-export `@lizardon386/pack-format`）
+- `@lizardon386/game-sdk/kit`：ChatPanel / FeedPanel / ScoreboardPanel / seatColor
+- `@lizardon386/game-sdk/kit/server`：FeedLog
+
+接入文档：[INTEGRATION_GUIDE.md](https://github.com/Lizardon386/3178-battle-platform/blob/master/INTEGRATION_GUIDE.md)
+
+License: MIT

package/dist/contract/client.d.ts

@@ -0,0 +1,2 @@
+export type { GameActions, GameClientContract } from '@lizardon386/core-abi';
+//# sourceMappingURL=client.d.ts.map

package/dist/contract/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/contract/client.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/contract/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/contract/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/contract/client.ts"],"names":[],"mappings":""}

package/dist/contract/module-api.d.ts

@@ -0,0 +1,104 @@
+import type { GameManifest, GameUiOptions, NoticeCode, PlatformCode, RoomPhase, SeatRole } from '@bp/protocol';
+/**
+ * 平台与游戏模块之间的唯一契约。
+ * 三条硬规矩：
+ *  1. 游戏状态不进平台对象——平台只搬 opaque blob。
+ *  2. 游戏不许直接碰 socket——一切对外投递都通过返回 Effect[]。
+ *  3. 游戏不许改房间相位、座位表或房主权限——那要经过平台（Ready 闸、TTL、审计都在平台）。
+ */
+export type ViewerId = string | null;
+export type Effect = {
+    kind: 'broadcast';
+    name: string;
+    payload?: unknown;
+} | {
+    kind: 'toSeat';
+    seatId: string;
+    name: string;
+    payload?: unknown;
+} | {
+    kind: 'notice';
+    code: NoticeCode;
+    text?: string;
+} | {
+    kind: 'system';
+    text: string;
+} | {
+    kind: 'end';
+    reason?: string;
+} | {
+    kind: 'kick';
+    seatId: string;
+    reason?: string;
+};
+export interface Reject {
+    reject: string;
+    code?: PlatformCode;
+}
+export type Outcome = Effect[] | Reject;
+export declare function isReject(value: Outcome): value is Reject;
+export declare function reject(message: string, code?: PlatformCode): Reject;
+export interface GameAction {
+    name: string;
+    payload?: unknown;
+}
+/** 传给游戏模块的座位信息：不含 socket、不含票据，游戏拿不到传输细节。 */
+export interface GameSeatInfo {
+    seatId: string;
+    slot: number;
+    name: string;
+    role: SeatRole;
+    team: string | number | null;
+    ready: boolean;
+    connected: boolean;
+}
+export interface GameContext {
+    readonly roomCode: string;
+    readonly config: Record<string, unknown>;
+    /** 注入时钟与随机源，让规则测试可确定性推进。 */
+    now(): number;
+    random(): number;
+    seats(): GameSeatInfo[];
+    seat(seatId: string): GameSeatInfo | undefined;
+}
+export interface GameInstance {
+    /** 按视角裁剪后的状态；`null` 表示观战视角。 */
+    serialize(viewer: ViewerId): unknown;
+    handle(action: GameAction, by: string): Outcome;
+    /** 开局。平台已确认发话人是房主且所有人类玩家都 Ready。 */
+    begin(): Outcome;
+    snapshot(): unknown;
+    /** 心跳：规则计时窗口在这里推进（旧项目心跳里的玩法部分）。 */
+    tick?(now: number): Effect[];
+    onSeatJoin?(seat: GameSeatInfo): Effect[];
+    onSeatLeave?(seat: GameSeatInfo, phase: RoomPhase): Effect[];
+    /** 座位超时。托管与罚则属于游戏，不属于平台。 */
+    onTimeout?(seat: GameSeatInfo): Effect[];
+    dispose?(): void;
+}
+export interface GameModule {
+    id: string;
+    name: string;
+    version: string;
+    entry: string;
+    seats: {
+        min: number;
+        max: number;
+    };
+    allowSpectate: boolean;
+    soloFill: boolean;
+    roles: SeatRole[];
+    /** 把房主原始设置规范化；返回的形状决定 rulesHash 与 create 的输入。 */
+    normalizeConfig(raw: Record<string, unknown> | undefined): Record<string, unknown>;
+    /** 只摘要真正影响对局的字段，避免"改了房间名也算房规不同"。 */
+    rulesHashOf(config: Record<string, unknown>): string;
+    create(config: Record<string, unknown>, ctx: GameContext): GameInstance;
+    resume(snapshot: unknown, ctx: GameContext): GameInstance;
+    /** 落盘快照的兼容性闸；返回 false 则平台丢弃快照并报错给房主。 */
+    acceptsSnapshot?(snapshot: unknown): boolean;
+    /** 可选 UI 声明；例如让游戏自己的聊天面板替代平台聊天卡。 */
+    ui?: GameUiOptions;
+}
+/** 平台侧组装 manifest。rulesHash 由模块从规范化 config 算出，平台不参与玩法判断。 */
+export declare function manifestOf(module: GameModule, config: Record<string, unknown>): GameManifest;
+//# sourceMappingURL=module-api.d.ts.map

package/dist/contract/module-api.d.ts.map

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

package/dist/contract/module-api.js

@@ -0,0 +1,22 @@
+export function isReject(value) {
+    return !Array.isArray(value) && typeof value?.reject === 'string';
+}
+export function reject(message, code) {
+    return code ? { reject: message, code } : { reject: message };
+}
+/** 平台侧组装 manifest。rulesHash 由模块从规范化 config 算出，平台不参与玩法判断。 */
+export function manifestOf(module, config) {
+    return {
+        id: module.id,
+        name: module.name,
+        version: module.version,
+        rulesHash: module.rulesHashOf(config),
+        seats: module.seats,
+        allowSpectate: module.allowSpectate,
+        soloFill: module.soloFill,
+        roles: module.roles,
+        entry: module.entry,
+        ...(module.ui ? { ui: { ...module.ui } } : {}),
+    };
+}
+//# sourceMappingURL=module-api.js.map

package/dist/contract/module-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-api.js","sourceRoot":"","sources":["../../src/contract/module-api.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAQ,KAAgB,EAAE,MAAM,KAAK,QAAQ,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,IAAmB;IACzD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAiED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,MAA+B;IAC5E,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Effect, GameAction, GameAsset, GameContext, GameInstance, GameManifest, GameMode, GameModule, GameSeatInfo, GameUiOptions, NoticeCode, Outcome, PlatformCode, Reject, RoomPhase, SeatRole, SeatView, ViewerId, } from '@lizardon386/core-abi';
+export { API_VERSION, DEFAULT_MODE, GAME_MODES, SUPPORTED_API_VERSIONS, SUPPORTED_MODES, isReject, reject, stableDigest, } from '@lizardon386/core-abi';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,OAAO,EACP,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,YAAY,GACb,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { API_VERSION, DEFAULT_MODE, GAME_MODES, SUPPORTED_API_VERSIONS, SUPPORTED_MODES, isReject, reject, stableDigest, } from '@lizardon386/core-abi';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,YAAY,GACb,MAAM,uBAAuB,CAAC"}

package/dist/kit/client/chat.d.ts

@@ -0,0 +1,46 @@
+export interface ChatLine {
+    seatId: string;
+    name: string;
+    text: string;
+    at: number;
+    kind: 'say' | 'system';
+}
+export interface ChatPanelOptions {
+    mount?: HTMLElement;
+    max?: number;
+    maxText?: number;
+    showSystem?: boolean;
+    placeholder?: string;
+    sendLabel?: string;
+    /** 覆盖默认发送方式；不填时在 iframe 里 parent.postMessage。 */
+    onSend?: (text: string) => void;
+    /** 新到的消息回调；初始历史不会触发。 */
+    onLine?: (line: ChatLine) => void;
+    /** 是否监听 window 的 bp:chat-history / bp:chat；有 mount 时默认开。 */
+    listen?: boolean;
+}
+export declare function chatText(value: string): string | null;
+export declare function chatLineKey(line: ChatLine): string;
+export declare function normalizeChatLine(value: unknown): ChatLine | null;
+export declare function mergeChatLines(current: readonly ChatLine[], incoming: readonly ChatLine[], max: number): ChatLine[];
+/** 房间聊天面板：历史以平台推送的 bp:chat-history 为准，发送只发纯文本。 */
+export declare class ChatPanel {
+    private readonly options;
+    private readonly max;
+    private readonly maxText;
+    private readonly root;
+    private readonly log;
+    private readonly input;
+    private readonly form;
+    private readonly onChatHistory;
+    private readonly onChatLine;
+    private lines;
+    constructor(options?: ChatPanelOptions);
+    setLines(lines: readonly ChatLine[]): void;
+    append(line: ChatLine): void;
+    send(): void;
+    clear(): void;
+    destroy(): void;
+    private render;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/kit/client/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/kit/client/chat.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,wBAAwB;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CASjE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAKnH;AAED,kDAAkD;AAClD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiC;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,KAAK,CAAkB;gBAEnB,OAAO,GAAE,gBAAqB;IAyD1C,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI;IAM1C,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAS5B,IAAI,IAAI,IAAI;IAaZ,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,MAAM;CA4Bf"}

package/dist/kit/client/chat.js

@@ -0,0 +1,183 @@
+const MAX_CHAT_TEXT = 300;
+function clamp(value, min, max, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+export function chatText(value) {
+    const text = value.trim();
+    if (text.length < 1 || text.length > MAX_CHAT_TEXT)
+        return null;
+    return text;
+}
+export function chatLineKey(line) {
+    return `${line.at}|${line.seatId}|${line.kind}|${line.text}`;
+}
+export function normalizeChatLine(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const raw = value;
+    if (typeof raw.seatId !== 'string' || typeof raw.name !== 'string')
+        return null;
+    if (typeof raw.text !== 'string' || typeof raw.at !== 'number' || !Number.isFinite(raw.at))
+        return null;
+    if (raw.kind !== 'say' && raw.kind !== 'system')
+        return null;
+    const text = raw.text.trim();
+    if (!text || text.length > MAX_CHAT_TEXT)
+        return null;
+    return { seatId: raw.seatId, name: raw.name, text, at: raw.at, kind: raw.kind };
+}
+export function mergeChatLines(current, incoming, max) {
+    const byKey = new Map();
+    for (const line of current)
+        byKey.set(chatLineKey(line), line);
+    for (const line of incoming)
+        byKey.set(chatLineKey(line), line);
+    return [...byKey.values()].sort((a, b) => a.at - b.at).slice(-Math.max(1, max));
+}
+/** 房间聊天面板：历史以平台推送的 bp:chat-history 为准，发送只发纯文本。 */
+export class ChatPanel {
+    options;
+    max;
+    maxText;
+    root = null;
+    log = null;
+    input = null;
+    form = null;
+    onChatHistory = null;
+    onChatLine = null;
+    lines = [];
+    constructor(options = {}) {
+        this.options = options;
+        this.max = clamp(options.max, 1, 500, 200);
+        this.maxText = clamp(options.maxText, 1, MAX_CHAT_TEXT, MAX_CHAT_TEXT);
+        if (options.mount) {
+            const doc = options.mount.ownerDocument;
+            const root = doc.createElement('div');
+            root.className = 'bp-chat';
+            root.style.cssText = 'display:flex;flex-direction:column;min-height:0;font:13px/1.5 system-ui, "Microsoft YaHei UI", "Microsoft YaHei", sans-serif';
+            const log = doc.createElement('ol');
+            log.className = 'bp-chat-log';
+            log.setAttribute('role', 'log');
+            log.setAttribute('aria-live', 'polite');
+            log.style.cssText = 'margin:0;padding:4px 8px;list-style:none;overflow-y:auto;flex:1 1 auto;min-height:120px;max-height:260px';
+            const form = doc.createElement('form');
+            form.className = 'bp-chat-form';
+            form.style.cssText = 'display:flex;gap:6px;padding:6px 0 0';
+            const input = doc.createElement('input');
+            input.className = 'bp-chat-input';
+            input.type = 'text';
+            input.maxLength = MAX_CHAT_TEXT;
+            input.autocomplete = 'off';
+            input.placeholder = options.placeholder ?? '说点什么';
+            input.style.cssText = 'flex:1 1 auto;min-width:0;padding:4px 6px';
+            const button = doc.createElement('button');
+            button.className = 'bp-chat-send';
+            button.type = 'submit';
+            button.textContent = options.sendLabel ?? '发送';
+            button.style.cssText = 'flex:none;padding:4px 10px';
+            form.append(input, button);
+            root.append(log, form);
+            options.mount.replaceChildren(root);
+            this.root = root;
+            this.log = log;
+            this.input = input;
+            this.form = form;
+            form.addEventListener('submit', (event) => {
+                event.preventDefault();
+                this.send();
+            });
+        }
+        if (options.listen ?? Boolean(options.mount)) {
+            if (typeof window !== 'undefined') {
+                this.onChatHistory = (event) => {
+                    const lines = event.detail;
+                    if (Array.isArray(lines))
+                        this.setLines(lines);
+                };
+                this.onChatLine = (event) => {
+                    this.append(event.detail);
+                };
+                window.addEventListener('bp:chat-history', this.onChatHistory);
+                window.addEventListener('bp:chat', this.onChatLine);
+            }
+        }
+    }
+    setLines(lines) {
+        const normalized = lines.map(normalizeChatLine).filter((line) => line !== null);
+        this.lines = mergeChatLines([], normalized, this.max);
+        this.render();
+    }
+    append(line) {
+        const normalized = normalizeChatLine(line);
+        if (!normalized)
+            return;
+        if (this.lines.some((item) => chatLineKey(item) === chatLineKey(normalized)))
+            return;
+        this.lines = mergeChatLines(this.lines, [normalized], this.max);
+        this.render();
+        this.options.onLine?.(normalized);
+    }
+    send() {
+        const input = this.input;
+        if (!input)
+            return;
+        const text = chatText(input.value);
+        if (!text)
+            return;
+        if (this.options.onSend) {
+            this.options.onSend(text);
+        }
+        else if (typeof parent !== 'undefined' && parent !== window) {
+            parent.postMessage({ type: 'chat', text }, '*');
+        }
+        input.value = '';
+    }
+    clear() {
+        this.lines = [];
+        this.render();
+    }
+    destroy() {
+        if (typeof window !== 'undefined') {
+            if (this.onChatHistory)
+                window.removeEventListener('bp:chat-history', this.onChatHistory);
+            if (this.onChatLine)
+                window.removeEventListener('bp:chat', this.onChatLine);
+        }
+        this.options.mount?.replaceChildren();
+        this.lines = [];
+    }
+    render() {
+        const log = this.log;
+        if (!log)
+            return;
+        const nearBottom = log.scrollHeight - log.scrollTop - log.clientHeight < 8;
+        const allowed = this.options.showSystem === false ? this.lines.filter((line) => line.kind !== 'system') : this.lines;
+        log.replaceChildren();
+        for (const line of allowed) {
+            const item = log.ownerDocument.createElement('li');
+            item.className = `bp-chat-line bp-chat-${line.kind}`;
+            item.dataset.seatId = line.seatId;
+            item.style.cssText = 'padding:1px 0;overflow-wrap:anywhere';
+            if (line.kind === 'system') {
+                item.style.opacity = '0.65';
+                item.textContent = line.text.length > this.maxText ? `${line.text.slice(0, this.maxText)}…` : line.text;
+            }
+            else {
+                const name = log.ownerDocument.createElement('span');
+                name.className = 'bp-chat-name';
+                name.textContent = `${line.name}：`;
+                name.style.cssText = 'font-weight:600;margin-right:2px';
+                const text = log.ownerDocument.createElement('span');
+                text.className = 'bp-chat-text';
+                text.textContent = line.text.length > this.maxText ? `${line.text.slice(0, this.maxText)}…` : line.text;
+                item.append(name, text);
+            }
+            log.append(item);
+        }
+        if (nearBottom)
+            log.scrollTop = log.scrollHeight;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/kit/client/chat.js.map

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

package/dist/kit/client/feed.d.ts

@@ -0,0 +1,39 @@
+import { type FeedEntry } from '../shared.js';
+export interface FeedEvent {
+    name: string;
+    payload?: unknown;
+}
+export interface FeedPanelOptions {
+    mount?: HTMLElement;
+    max?: number;
+    /** 只显示这些 type；不填表示全部。 */
+    types?: readonly string[];
+    maxText?: number;
+    emptyText?: string;
+    timeFormat?: (at: number) => string;
+    /** 给 actor 上色；不填则用默认文本色。 */
+    colorOf?: (seatId: string) => string | null;
+    /** 只给新到的事件回调；初始历史不会触发。 */
+    onEntry?: (entry: FeedEntry) => void;
+}
+export declare function formatFeedTime(at: number): string;
+export declare function normalizeFeedEntry(value: unknown): FeedEntry | null;
+/** 按 seq 合并，保留最近的 max 条；重复帧不会重复显示。 */
+export declare function mergeFeedEntries(current: readonly FeedEntry[], incoming: readonly FeedEntry[], max: number): FeedEntry[];
+/** 渲染无关的事件流面板；不挂 mount 时只跑回调和状态。 */
+export declare class FeedPanel {
+    private readonly options;
+    private readonly max;
+    private readonly maxText;
+    private readonly list;
+    private entries;
+    constructor(options?: FeedPanelOptions);
+    setEntries(entries: readonly FeedEntry[]): void;
+    append(entry: FeedEntry): void;
+    /** 直接接 GameClient.onEvent；不是 bp.feed 时返回 false。 */
+    handleEvent(event: FeedEvent): boolean;
+    clear(): void;
+    destroy(): void;
+    private render;
+}
+//# sourceMappingURL=feed.d.ts.map

package/dist/kit/client/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../../src/kit/client/feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAOD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAsBnE;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,GAAG,EAAE,MAAM,GACV,SAAS,EAAE,CAKb;AAED,oCAAoC;AACpC,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,GAAE,gBAAqB;IAuB1C,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI;IAM/C,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQ9B,mDAAmD;IACnD,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAOtC,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,MAAM;CAsCf"}