@lizardon386/game-sdk 0.0.0-stage → 0.3.0

package/src/kit/client/scoreboard.ts

@@ -0,0 +1,333 @@
+import type { RoomPhase, SeatView } from '@lizardon386/core-abi';
+import { seatColor } from '../palette.js';
+
+export interface ScoreboardRow {
+  seatId: string;
+  values: Record<string, unknown>;
+}
+
+export interface ScoreboardColumn {
+  key: string;
+  label: string;
+  value?: string | ((row: ScoreboardRow) => unknown);
+  format?: (value: unknown, row: ScoreboardRow) => string;
+  /** 自定义单元格节点；返回 null 时退回 format。 */
+  render?: (value: unknown, row: ScoreboardRow) => Node | null;
+  sortValue?: (row: ScoreboardRow) => number | string;
+  sortable?: boolean;
+  align?: 'left' | 'center' | 'right';
+  width?: string | number;
+}
+
+export interface ScoreboardRoom {
+  code: string;
+  phase: RoomPhase | 'none';
+  seats: SeatView[];
+}
+
+export interface ScoreboardSort {
+  key: string;
+  dir: 'asc' | 'desc';
+}
+
+export interface ScoreboardPanelOptions {
+  mount?: HTMLElement;
+  columns: readonly ScoreboardColumn[];
+  rows?: readonly ScoreboardRow[];
+  seats?: readonly SeatView[];
+  showTeam?: boolean;
+  showConnection?: boolean;
+  showHost?: boolean;
+  emptyText?: string;
+  sort?: ScoreboardSort;
+  /** 是否监听 window 的 bp:room；有 mount 时默认开。 */
+  listen?: boolean;
+}
+
+export function normalizeScoreboardRows(rows: readonly unknown[]): ScoreboardRow[] {
+  const out: ScoreboardRow[] = [];
+  for (const value of rows) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;
+    const raw = value as Record<string, unknown>;
+    if (typeof raw.seatId !== 'string' || raw.seatId.length === 0) continue;
+    const values = raw.values;
+    if (values !== undefined && (typeof values !== 'object' || values === null || Array.isArray(values))) continue;
+    out.push({ seatId: raw.seatId, values: (values as Record<string, unknown> | undefined) ?? {} });
+  }
+  return out;
+}
+
+export function resolveColumnValue(column: ScoreboardColumn, row: ScoreboardRow): unknown {
+  if (typeof column.value === 'function') return column.value(row);
+  if (typeof column.value === 'string') return row.values[column.value];
+  return row.values[column.key];
+}
+
+export function formatColumnValue(column: ScoreboardColumn, row: ScoreboardRow): string {
+  const value = resolveColumnValue(column, row);
+  if (column.format) return column.format(value, row);
+  return value === null || value === undefined ? '—' : String(value);
+}
+
+function compareValues(a: unknown, b: unknown): number {
+  if (a === b) return 0;
+  if (a === null || a === undefined) return 1;
+  if (b === null || b === undefined) return -1;
+  if (typeof a === 'number' && typeof b === 'number') return a - b;
+  return String(a).localeCompare(String(b), 'zh-CN');
+}
+
+export function sortScoreboardRows(
+  rows: readonly ScoreboardRow[],
+  columns: readonly ScoreboardColumn[],
+  sort: ScoreboardSort | undefined,
+): ScoreboardRow[] {
+  if (!sort) return [...rows];
+  const column = columns.find((item) => item.key === sort.key);
+  if (!column) return [...rows];
+  const direction = sort.dir === 'desc' ? -1 : 1;
+  return [...rows].sort((a, b) => {
+    const left = column.sortValue ? column.sortValue(a) : resolveColumnValue(column, a);
+    const right = column.sortValue ? column.sortValue(b) : resolveColumnValue(column, b);
+    const leftMissing = left === null || left === undefined;
+    const rightMissing = right === null || right === undefined;
+    if (leftMissing || rightMissing) return leftMissing === rightMissing ? 0 : leftMissing ? 1 : -1;
+    return compareValues(left, right) * direction;
+  });
+}
+
+/** 座位表是主列表：没有游戏行的玩家也显示；有行但没座位的排在后面。 */
+export function buildScoreboardRows(
+  rows: readonly ScoreboardRow[],
+  seats: readonly SeatView[],
+): ScoreboardRow[] {
+  const bySeat = new Map(rows.map((row) => [row.seatId, row]));
+  const out: ScoreboardRow[] = [];
+  for (const seat of [...seats].sort((a, b) => a.slot - b.slot)) {
+    out.push(bySeat.get(seat.seatId) ?? { seatId: seat.seatId, values: {} });
+    bySeat.delete(seat.seatId);
+  }
+  for (const row of rows) {
+    if (bySeat.has(row.seatId)) out.push(row);
+    bySeat.delete(row.seatId);
+  }
+  return out;
+}
+
+function teamText(team: string | number | null): string {
+  return team === null || team === undefined ? '—' : String(team);
+}
+
+export function connectionLabel(seat: SeatView | undefined): string {
+  if (!seat) return '—';
+  if (seat.role === 'ai') return '电脑';
+  if (seat.role === 'spectator') return '观战';
+  return seat.connected ? '在线' : '离线';
+}
+
+function styleCell(cell: HTMLTableCellElement, align: 'left' | 'center' | 'right' | undefined, width: string | number | undefined): void {
+  cell.style.padding = '6px 8px';
+  cell.style.borderTop = '1px solid rgba(127,127,127,.22)';
+  cell.style.textAlign = align ?? 'left';
+  if (width !== undefined) cell.style.width = typeof width === 'number' ? `${width}px` : width;
+}
+
+/** 记分板只提供壳：列和值完全由游戏定义，平台只补座位元数据。 */
+export class ScoreboardPanel {
+  private readonly options: ScoreboardPanelOptions;
+  private readonly columns: ScoreboardColumn[];
+  private readonly root: HTMLDivElement | null = null;
+  private readonly head: HTMLTableSectionElement | null = null;
+  private readonly body: HTMLTableSectionElement | null = null;
+  private readonly onRoom: ((event: Event) => void) | null = null;
+  private rows: ScoreboardRow[] = [];
+  private seats: SeatView[] = [];
+  private sort: ScoreboardSort | undefined;
+
+  constructor(options: ScoreboardPanelOptions) {
+    this.options = options;
+    this.columns = options.columns.filter((column) => typeof column.key === 'string' && column.key.length > 0);
+    this.rows = normalizeScoreboardRows(options.rows ?? []);
+    this.seats = [...(options.seats ?? [])];
+    this.sort = options.sort;
+    if (options.mount) {
+      const doc = options.mount.ownerDocument;
+      const root = doc.createElement('div');
+      root.className = 'bp-scoreboard';
+      root.style.cssText = 'overflow-x:auto;font:13px/1.5 system-ui, "Microsoft YaHei UI", "Microsoft YaHei", sans-serif';
+      const table = doc.createElement('table');
+      table.className = 'bp-scoreboard-table';
+      table.setAttribute('aria-label', '记分板');
+      table.style.cssText = 'width:100%;border-collapse:collapse;min-width:360px';
+      const head = doc.createElement('thead');
+      const body = doc.createElement('tbody');
+      table.append(head, body);
+      root.append(table);
+      options.mount.replaceChildren(root);
+      this.root = root;
+      this.head = head;
+      this.body = body;
+    }
+    if (options.listen ?? Boolean(options.mount)) {
+      if (typeof window !== 'undefined') {
+        this.onRoom = (event: Event) => {
+          const room = (event as CustomEvent).detail as ScoreboardRoom | null;
+          this.seats = room && Array.isArray(room.seats) ? [...room.seats] : [];
+          this.render();
+        };
+        window.addEventListener('bp:room', this.onRoom);
+      }
+    }
+    this.render();
+  }
+
+  setRows(rows: readonly ScoreboardRow[]): void {
+    this.rows = normalizeScoreboardRows(rows);
+    this.render();
+  }
+
+  setSeats(seats: readonly SeatView[]): void {
+    this.seats = [...seats];
+    this.render();
+  }
+
+  setRoom(room: ScoreboardRoom | null): void {
+    this.setSeats(room?.seats ?? []);
+  }
+
+  setSort(sort: ScoreboardSort | undefined): void {
+    this.sort = sort;
+    this.render();
+  }
+
+  clear(): void {
+    this.rows = [];
+    this.seats = [];
+    this.render();
+  }
+
+  destroy(): void {
+    if (typeof window !== 'undefined' && this.onRoom) window.removeEventListener('bp:room', this.onRoom);
+    this.options.mount?.replaceChildren();
+    this.rows = [];
+    this.seats = [];
+  }
+
+  private toggleSort(key: string): void {
+    const current = this.sort;
+    this.sort = current?.key === key
+      ? { key, dir: current.dir === 'asc' ? 'desc' : 'asc' }
+      : { key, dir: 'asc' };
+    this.render();
+  }
+
+  private render(): void {
+    const head = this.head;
+    const body = this.body;
+    if (!head || !body || !this.root) return;
+    const doc = this.root.ownerDocument;
+    const seats = new Map(this.seats.map((seat) => [seat.seatId, seat]));
+    const rows = sortScoreboardRows(buildScoreboardRows(this.rows, this.seats), this.columns, this.sort);
+    head.replaceChildren();
+    body.replaceChildren();
+
+    const headerRow = doc.createElement('tr');
+    const playerTh = doc.createElement('th');
+    playerTh.scope = 'col';
+    playerTh.textContent = '玩家';
+    styleCell(playerTh, 'left', undefined);
+    playerTh.style.textAlign = 'left';
+    headerRow.append(playerTh);
+    if (this.options.showTeam ?? true) {
+      const th = doc.createElement('th');
+      th.scope = 'col';
+      th.textContent = '队伍';
+      styleCell(th, 'left', undefined);
+      headerRow.append(th);
+    }
+    if (this.options.showConnection ?? true) {
+      const th = doc.createElement('th');
+      th.scope = 'col';
+      th.textContent = '连接';
+      styleCell(th, 'left', undefined);
+      headerRow.append(th);
+    }
+    for (const column of this.columns) {
+      const th = doc.createElement('th');
+      th.scope = 'col';
+      if (column.sortable !== false) {
+        const button = doc.createElement('button');
+        button.type = 'button';
+        button.className = 'bp-scoreboard-sort';
+        button.style.cssText = 'all:unset;cursor:pointer;font-weight:600';
+        const active = this.sort?.key === column.key;
+        button.textContent = `${column.label}${active ? (this.sort?.dir === 'asc' ? ' ↑' : ' ↓') : ''}`;
+        button.addEventListener('click', () => this.toggleSort(column.key));
+        th.append(button);
+      } else {
+        th.textContent = column.label;
+      }
+      th.style.fontWeight = '600';
+      styleCell(th, column.align, column.width);
+      headerRow.append(th);
+    }
+    head.append(headerRow);
+
+    if (rows.length === 0) {
+      const row = doc.createElement('tr');
+      const cell = doc.createElement('td');
+      cell.colSpan = 1 + (this.options.showTeam ?? true ? 1 : 0) + (this.options.showConnection ?? true ? 1 : 0) + this.columns.length;
+      cell.textContent = this.options.emptyText ?? '暂无数据';
+      cell.style.cssText = 'padding:12px 8px;opacity:.6;text-align:center';
+      row.append(cell);
+      body.append(row);
+      return;
+    }
+
+    for (const row of rows) {
+      const seat = seats.get(row.seatId);
+      const tr = doc.createElement('tr');
+      tr.dataset.seatId = row.seatId;
+
+      const player = doc.createElement('td');
+      const dot = doc.createElement('span');
+      dot.className = 'bp-scoreboard-color';
+      dot.style.cssText = `display:inline-block;width:8px;height:8px;border-radius:50%;margin-right:6px;background:${seatColor({ seatId: row.seatId, slot: seat?.slot, team: seat?.team }).value}`;
+      const name = doc.createElement('span');
+      name.textContent = seat?.name ?? row.seatId;
+      player.append(dot, name);
+      if (seat?.isHost && (this.options.showHost ?? true)) {
+        const host = doc.createElement('span');
+        host.className = 'bp-scoreboard-host';
+        host.textContent = '房主';
+        host.style.cssText = 'margin-left:6px;padding:0 4px;border:1px solid currentColor;border-radius:4px;font-size:11px;opacity:.75';
+        player.append(host);
+      }
+      styleCell(player, 'left', undefined);
+      tr.append(player);
+
+      if (this.options.showTeam ?? true) {
+        const team = doc.createElement('td');
+        team.textContent = teamText(seat?.team ?? null);
+        styleCell(team, 'left', undefined);
+        tr.append(team);
+      }
+      if (this.options.showConnection ?? true) {
+        const connection = doc.createElement('td');
+        connection.textContent = connectionLabel(seat);
+        connection.style.opacity = seat && (seat.role === 'ai' || seat.connected) ? '1' : '0.6';
+        styleCell(connection, 'left', undefined);
+        tr.append(connection);
+      }
+      for (const column of this.columns) {
+        const cell = doc.createElement('td');
+        const rendered = column.render?.(resolveColumnValue(column, row), row) ?? null;
+        if (rendered && typeof rendered.nodeType === 'number') cell.append(rendered);
+        else cell.textContent = formatColumnValue(column, row);
+        styleCell(cell, column.align, column.width);
+        tr.append(cell);
+      }
+      body.append(tr);
+    }
+  }
+}

package/src/kit/palette.ts

@@ -0,0 +1,44 @@
+import type { SeatLike } from './shared.js';
+
+export interface SeatColor {
+  index: number;
+  name: string;
+  value: string;
+}
+
+const PALETTE: ReadonlyArray<{ name: string; value: string }> = [
+  { name: 'red', value: '#e05d5d' },
+  { name: 'blue', value: '#5d9ce0' },
+  { name: 'green', value: '#5dbe7a' },
+  { name: 'yellow', value: '#d6b85d' },
+  { name: 'purple', value: '#a98ae0' },
+  { name: 'teal', value: '#5dc9c9' },
+  { name: 'orange', value: '#e09a5d' },
+  { name: 'pink', value: '#d98ab8' },
+];
+
+function mod(value: number): number {
+  return ((value % PALETTE.length) + PALETTE.length) % PALETTE.length;
+}
+
+function hashTeam(team: string): number {
+  let hash = 0;
+  for (let i = 0; i < team.length; i += 1) hash = (hash * 31 + team.charCodeAt(i)) | 0;
+  return hash;
+}
+
+/** 队伍优先，其次座位号；同一输入永远得到同一种颜色。 */
+export function seatColor(seat: SeatLike): SeatColor {
+  let index: number;
+  if (typeof seat.team === 'number' && Number.isFinite(seat.team)) {
+    index = mod(Math.trunc(seat.team) - 1);
+  } else if (typeof seat.team === 'string' && seat.team.length > 0) {
+    index = mod(hashTeam(seat.team));
+  } else if (typeof seat.slot === 'number' && Number.isFinite(seat.slot)) {
+    index = mod(Math.trunc(seat.slot) - 1);
+  } else {
+    index = 0;
+  }
+  const color = PALETTE[index]!;
+  return { index, ...color };
+}

package/src/kit/server/feed.ts

@@ -0,0 +1,221 @@
+import type { Effect, ViewerId } from '@lizardon386/core-abi';
+import { FEED_EVENT, FeedError, 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;
+}
+
+interface StoredEntry extends FeedEntry {
+  visibility: FeedVisibility;
+}
+
+const MAX_TYPE_LENGTH = 64;
+const MAX_DATA_JSON = 2_000;
+
+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)));
+}
+
+function validateVisibility(value: FeedVisibility | undefined): FeedVisibility {
+  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 as { seatId?: unknown }).seatId;
+    if (typeof seatId !== 'string' || seatId.length === 0) throw new FeedError('事件 seatId 不合法');
+    return { seatId };
+  }
+  if (keys[0] === 'team') {
+    const team = (value as { team?: unknown }).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: StoredEntry): FeedEntry {
+  const copy: FeedEntry = {
+    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: unknown): StoredEntry | null {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  const raw = value as Record<string, unknown>;
+  if (!Number.isSafeInteger(raw.seq) || (raw.seq as number) < 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: FeedVisibility;
+  try {
+    visibility = validateVisibility(raw.visibility as FeedVisibility | undefined);
+  } catch {
+    return null;
+  }
+  const entry: StoredEntry = {
+    seq: raw.seq as number,
+    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 as Record<string, unknown>;
+  return entry;
+}
+
+/** 服务端事件流水：生成序号/时间、按可见性发 Effect、保留最近 N 条。 */
+export class FeedLog {
+  private readonly max: number;
+  private readonly maxText: number;
+  private readonly now: () => number;
+  private readonly seatTeams: (() => ReadonlyArray<FeedSeat>) | null;
+  private entries: StoredEntry[] = [];
+  private nextSeq = 1;
+  private pending: Effect[] = [];
+
+  constructor(options: FeedLogOptions = {}) {
+    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: FeedEmitInput): FeedEntry {
+    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: string[] = [];
+    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: StoredEntry = {
+      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: ViewerId): FeedEntry[] {
+    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(): Effect[] {
+    const effects = this.pending;
+    this.pending = [];
+    return effects;
+  }
+
+  clear(): void {
+    this.entries = [];
+    this.pending = [];
+    this.nextSeq = 1;
+  }
+
+  snapshot(): unknown {
+    return {
+      version: 1,
+      nextSeq: this.nextSeq,
+      entries: this.entries.map((entry) => ({ ...entry, data: entry.data ? { ...entry.data } : undefined })),
+    };
+  }
+
+  restore(value: unknown): void {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) throw new FeedError('事件流快照不合法');
+    const raw = value as { version?: unknown; nextSeq?: unknown; entries?: unknown };
+    if (raw.version !== 1 || !Array.isArray(raw.entries)) throw new FeedError('事件流快照版本不支持');
+    const entries: StoredEntry[] = [];
+    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 = [];
+  }
+}

package/src/kit/server/index.ts

@@ -0,0 +1,2 @@
+export { FeedLog, type FeedEmitInput, type FeedLogOptions, type FeedSeat } from './feed.js';
+export { FEED_EVENT, FeedError, type FeedEntry, type FeedVisibility, type SeatLike } from '../shared.js';

package/src/kit/shared.ts

@@ -0,0 +1,28 @@
+/** 游戏事件流的一条公开记录：玩法文本由游戏填，平台只搬运。 */
+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 const FEED_EVENT = 'bp.feed';
+
+export class FeedError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'FeedError';
+  }
+}
+
+export interface SeatLike {
+  seatId: string;
+  slot?: number;
+  team?: string | number | null;
+}

package/src/node/pack.ts

@@ -0,0 +1 @@
+export * from '@lizardon386/pack-format';