@lizardon386/game-sdk 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,41 @@
+import type { Effect, ViewerId } from '@lizardon386/core-abi';
+import { type FeedEntry, type FeedVisibility } from '../shared.js';
+export interface FeedSeat {
+    seatId: string;
+    team: string | number | null;
+}
+export interface FeedLogOptions {
+    max?: number;
+    maxText?: number;
+    now?: () => number;
+    /** team 可见性用；返回当前所有座位及其队伍。 */
+    seatTeams?: () => ReadonlyArray<FeedSeat>;
+}
+export interface FeedEmitInput {
+    type: string;
+    text: string;
+    actor?: string;
+    target?: string;
+    data?: Record<string, unknown>;
+    visibility?: FeedVisibility;
+    at?: number;
+}
+/** 服务端事件流水：生成序号/时间、按可见性发 Effect、保留最近 N 条。 */
+export declare class FeedLog {
+    private readonly max;
+    private readonly maxText;
+    private readonly now;
+    private readonly seatTeams;
+    private entries;
+    private nextSeq;
+    private pending;
+    constructor(options?: FeedLogOptions);
+    emit(input: FeedEmitInput): FeedEntry;
+    /** 按视角裁剪历史；viewer 为 null 时只返回全员事件。 */
+    viewFor(viewer: ViewerId): FeedEntry[];
+    drainEffects(): Effect[];
+    clear(): void;
+    snapshot(): unknown;
+    restore(value: unknown): void;
+}
+//# sourceMappingURL=feed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../../src/kit/server/feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAyB,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE1F,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AA8ED,6CAA6C;AAC7C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,OAAO,GAAE,cAAmB;IAOxC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS;IAiDrC,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE;IActC,YAAY,IAAI,MAAM,EAAE;IAMxB,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,OAAO;IAQnB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAiB9B"}

package/dist/kit/server/feed.js

@@ -0,0 +1,210 @@
+import { FEED_EVENT, FeedError } from '../shared.js';
+const MAX_TYPE_LENGTH = 64;
+const MAX_DATA_JSON = 2_000;
+function clamp(value, min, max, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+function validateVisibility(value) {
+    if (value === undefined || value === 'all')
+        return 'all';
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new FeedError('事件可见性必须是 all、{ seatId } 或 { team }');
+    }
+    const keys = Object.keys(value);
+    if (keys.length !== 1)
+        throw new FeedError('事件可见性只能包含 seatId 或 team');
+    if (keys[0] === 'seatId') {
+        const seatId = value.seatId;
+        if (typeof seatId !== 'string' || seatId.length === 0)
+            throw new FeedError('事件 seatId 不合法');
+        return { seatId };
+    }
+    if (keys[0] === 'team') {
+        const team = value.team;
+        if (typeof team !== 'string' && (typeof team !== 'number' || !Number.isFinite(team))) {
+            throw new FeedError('事件 team 不合法');
+        }
+        return { team };
+    }
+    throw new FeedError('事件可见性只能包含 seatId 或 team');
+}
+function publicEntry(entry) {
+    const copy = {
+        seq: entry.seq,
+        at: entry.at,
+        type: entry.type,
+        text: entry.text,
+    };
+    if (entry.actor !== undefined)
+        copy.actor = entry.actor;
+    if (entry.target !== undefined)
+        copy.target = entry.target;
+    if (entry.data !== undefined)
+        copy.data = entry.data;
+    return copy;
+}
+function validateEntry(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const raw = value;
+    if (!Number.isSafeInteger(raw.seq) || raw.seq < 1)
+        return null;
+    if (typeof raw.at !== 'number' || !Number.isFinite(raw.at))
+        return null;
+    if (typeof raw.type !== 'string' || raw.type.trim().length === 0 || raw.type.length > MAX_TYPE_LENGTH)
+        return null;
+    if (typeof raw.text !== 'string' || raw.text.length === 0)
+        return null;
+    if (raw.actor !== undefined && typeof raw.actor !== 'string')
+        return null;
+    if (raw.target !== undefined && typeof raw.target !== 'string')
+        return null;
+    if (raw.data !== undefined && (typeof raw.data !== 'object' || raw.data === null || Array.isArray(raw.data)))
+        return null;
+    let visibility;
+    try {
+        visibility = validateVisibility(raw.visibility);
+    }
+    catch {
+        return null;
+    }
+    const entry = {
+        seq: raw.seq,
+        at: raw.at,
+        type: raw.type.trim(),
+        text: raw.text,
+        visibility,
+    };
+    if (raw.actor !== undefined)
+        entry.actor = raw.actor;
+    if (raw.target !== undefined)
+        entry.target = raw.target;
+    if (raw.data !== undefined)
+        entry.data = raw.data;
+    return entry;
+}
+/** 服务端事件流水：生成序号/时间、按可见性发 Effect、保留最近 N 条。 */
+export class FeedLog {
+    max;
+    maxText;
+    now;
+    seatTeams;
+    entries = [];
+    nextSeq = 1;
+    pending = [];
+    constructor(options = {}) {
+        this.max = clamp(options.max, 1, 500, 100);
+        this.maxText = clamp(options.maxText, 1, 2_000, 200);
+        this.now = options.now ?? (() => Date.now());
+        this.seatTeams = options.seatTeams ?? null;
+    }
+    emit(input) {
+        const type = typeof input.type === 'string' ? input.type.trim() : '';
+        const text = typeof input.text === 'string' ? input.text.trim() : '';
+        if (!type || type.length > MAX_TYPE_LENGTH)
+            throw new FeedError('事件 type 为空或过长');
+        if (!text)
+            throw new FeedError('事件 text 不能为空');
+        const visibility = validateVisibility(input.visibility);
+        let recipients = [];
+        if (typeof visibility === 'object' && 'team' in visibility) {
+            if (!this.seatTeams)
+                throw new FeedError('team 可见性需要 seatTeams 选项');
+            recipients = [...new Set(this.seatTeams()
+                    .filter((seat) => seat.team === visibility.team)
+                    .map((seat) => seat.seatId))];
+        }
+        const at = typeof input.at === 'number' && Number.isFinite(input.at) ? input.at : this.now();
+        const entry = {
+            seq: this.nextSeq,
+            at,
+            type,
+            text: text.slice(0, this.maxText),
+            visibility,
+        };
+        if (input.actor)
+            entry.actor = input.actor;
+        if (input.target)
+            entry.target = input.target;
+        if (input.data) {
+            const json = JSON.stringify(input.data);
+            if (json.length > MAX_DATA_JSON)
+                throw new FeedError('事件 data 过大');
+            entry.data = input.data;
+        }
+        this.nextSeq += 1;
+        this.entries.push(entry);
+        if (this.entries.length > this.max)
+            this.entries.splice(0, this.entries.length - this.max);
+        const payload = publicEntry(entry);
+        if (visibility === 'all') {
+            this.pending.push({ kind: 'broadcast', name: FEED_EVENT, payload });
+        }
+        else if ('seatId' in visibility) {
+            this.pending.push({ kind: 'toSeat', seatId: visibility.seatId, name: FEED_EVENT, payload });
+        }
+        else {
+            for (const seatId of recipients) {
+                this.pending.push({ kind: 'toSeat', seatId, name: FEED_EVENT, payload });
+            }
+        }
+        return payload;
+    }
+    /** 按视角裁剪历史；viewer 为 null 时只返回全员事件。 */
+    viewFor(viewer) {
+        const viewerTeam = viewer !== null && this.seatTeams
+            ? this.seatTeams().find((seat) => seat.seatId === viewer)?.team ?? null
+            : null;
+        return this.entries
+            .filter((entry) => {
+            if (entry.visibility === 'all')
+                return true;
+            if (viewer === null)
+                return false;
+            if ('seatId' in entry.visibility)
+                return entry.visibility.seatId === viewer;
+            return viewerTeam !== null && entry.visibility.team === viewerTeam;
+        })
+            .map(publicEntry);
+    }
+    drainEffects() {
+        const effects = this.pending;
+        this.pending = [];
+        return effects;
+    }
+    clear() {
+        this.entries = [];
+        this.pending = [];
+        this.nextSeq = 1;
+    }
+    snapshot() {
+        return {
+            version: 1,
+            nextSeq: this.nextSeq,
+            entries: this.entries.map((entry) => ({ ...entry, data: entry.data ? { ...entry.data } : undefined })),
+        };
+    }
+    restore(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new FeedError('事件流快照不合法');
+        const raw = value;
+        if (raw.version !== 1 || !Array.isArray(raw.entries))
+            throw new FeedError('事件流快照版本不支持');
+        const entries = [];
+        for (const item of raw.entries) {
+            const entry = validateEntry(item);
+            if (!entry)
+                throw new FeedError('事件流快照含坏记录');
+            entries.push(entry);
+        }
+        entries.sort((a, b) => a.seq - b.seq);
+        this.entries = entries.slice(-this.max);
+        const maxSeq = this.entries.reduce((max, entry) => Math.max(max, entry.seq), 0);
+        const savedNext = typeof raw.nextSeq === 'number' && Number.isSafeInteger(raw.nextSeq) ? raw.nextSeq : 1;
+        this.nextSeq = Math.max(savedNext, maxSeq + 1, 1);
+        this.pending = [];
+    }
+}
+//# sourceMappingURL=feed.js.map

package/dist/kit/server/feed.js.map

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

package/dist/kit/server/index.d.ts

@@ -0,0 +1,3 @@
+export { FeedLog, type FeedEmitInput, type FeedLogOptions, type FeedSeat } from './feed.js';
+export { FEED_EVENT, FeedError, type FeedEntry, type FeedVisibility, type SeatLike } from '../shared.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kit/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kit/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/kit/server/index.js

@@ -0,0 +1,3 @@
+export { FeedLog } from './feed.js';
+export { FEED_EVENT, FeedError } from '../shared.js';
+//# sourceMappingURL=index.js.map

package/dist/kit/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kit/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0D,MAAM,WAAW,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAsD,MAAM,cAAc,CAAC"}

package/dist/kit/shared.d.ts

@@ -0,0 +1,26 @@
+/** 游戏事件流的一条公开记录：玩法文本由游戏填，平台只搬运。 */
+export interface FeedEntry {
+    seq: number;
+    at: number;
+    type: string;
+    text: string;
+    actor?: string;
+    target?: string;
+    data?: Record<string, unknown>;
+}
+/** 事件对谁可见；team 需要 FeedLog 提供 seatTeams。 */
+export type FeedVisibility = 'all' | {
+    seatId: string;
+} | {
+    team: string | number;
+};
+export declare const FEED_EVENT = "bp.feed";
+export declare class FeedError extends Error {
+    constructor(message: string);
+}
+export interface SeatLike {
+    seatId: string;
+    slot?: number;
+    team?: string | number | null;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/kit/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/kit/shared.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpF,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/kit/shared.js

@@ -0,0 +1,8 @@
+export const FEED_EVENT = 'bp.feed';
+export class FeedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FeedError';
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/kit/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/kit/shared.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/node/pack.d.ts

@@ -0,0 +1,2 @@
+export * from '@lizardon386/pack-format';
+//# sourceMappingURL=pack.d.ts.map

package/dist/node/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/node/pack.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/node/pack.js

@@ -0,0 +1,2 @@
+export * from '@lizardon386/pack-format';
+//# sourceMappingURL=pack.js.map

package/dist/node/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/node/pack.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@lizardon386/game-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "3178 游戏接入 SDK：游戏 ABI、客户端契约、单文件包和 game-kit",
+  "license": "MIT",
+  "author": "3178-battle-platform contributors",
+  "homepage": "https://github.com/Lizardon386/3178-battle-platform#readme",
+  "bugs": {
+    "url": "https://github.com/Lizardon386/3178-battle-platform/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lizardon386/3178-battle-platform.git",
+    "directory": "packages/game-sdk"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "keywords": [
+    "3178",
+    "game-platform",
+    "game-sdk",
+    "game-kit"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/contract/client.d.ts",
+      "default": "./dist/contract/client.js"
+    },
+    "./node": {
+      "types": "./dist/node/pack.d.ts",
+      "default": "./dist/node/pack.js"
+    },
+    "./kit": {
+      "types": "./dist/kit/client/index.d.ts",
+      "default": "./dist/kit/client/index.js"
+    },
+    "./kit/server": {
+      "types": "./dist/kit/server/index.d.ts",
+      "default": "./dist/kit/server/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@lizardon386/core-abi": "^0.2.0",
+    "@lizardon386/pack-format": "^0.2.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/contract/client.ts

@@ -0,0 +1 @@
+export type { GameActions, GameClientContract } from '@lizardon386/core-abi';

package/src/index.ts

@@ -0,0 +1,30 @@
+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';

package/src/kit/client/chat.ts

@@ -0,0 +1,199 @@
+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;
+}
+
+const MAX_CHAT_TEXT = 300;
+
+function clamp(value: number | undefined, min: number, max: number, fallback: number): number {
+  if (value === undefined || !Number.isFinite(value)) return fallback;
+  return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+
+export function chatText(value: string): string | null {
+  const text = value.trim();
+  if (text.length < 1 || text.length > MAX_CHAT_TEXT) return null;
+  return text;
+}
+
+export function chatLineKey(line: ChatLine): string {
+  return `${line.at}|${line.seatId}|${line.kind}|${line.text}`;
+}
+
+export function normalizeChatLine(value: unknown): ChatLine | null {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  const raw = value as Record<string, unknown>;
+  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: readonly ChatLine[], incoming: readonly ChatLine[], max: number): ChatLine[] {
+  const byKey = new Map<string, ChatLine>();
+  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 {
+  private readonly options: ChatPanelOptions;
+  private readonly max: number;
+  private readonly maxText: number;
+  private readonly root: HTMLDivElement | null = null;
+  private readonly log: HTMLOListElement | null = null;
+  private readonly input: HTMLInputElement | null = null;
+  private readonly form: HTMLFormElement | null = null;
+  private readonly onChatHistory: ((event: Event) => void) | null = null;
+  private readonly onChatLine: ((event: Event) => void) | null = null;
+  private lines: ChatLine[] = [];
+
+  constructor(options: ChatPanelOptions = {}) {
+    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: Event) => {
+          const lines = (event as CustomEvent).detail;
+          if (Array.isArray(lines)) this.setLines(lines as ChatLine[]);
+        };
+        this.onChatLine = (event: Event) => {
+          this.append((event as CustomEvent).detail as ChatLine);
+        };
+        window.addEventListener('bp:chat-history', this.onChatHistory);
+        window.addEventListener('bp:chat', this.onChatLine);
+      }
+    }
+  }
+
+  setLines(lines: readonly ChatLine[]): void {
+    const normalized = lines.map(normalizeChatLine).filter((line): line is ChatLine => line !== null);
+    this.lines = mergeChatLines([], normalized, this.max);
+    this.render();
+  }
+
+  append(line: ChatLine): void {
+    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(): void {
+    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(): void {
+    this.lines = [];
+    this.render();
+  }
+
+  destroy(): void {
+    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 = [];
+  }
+
+  private render(): void {
+    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;
+  }
+}