@composy/chat-core 0.0.1 → 0.0.2

package/esm/core/chat-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-manager.js","names":[],"sources":["../../src/core/chat-manager.ts"],"sourcesContent":["/**\n * 聊天管理器 - 消息增删改查、状态管理\n */\n\nimport type { ChatMessage } from '../types';\nimport { EventEmitter } from './event-emitter';\n\n/**\n * ChatManager - Chat Manager class\n */\nexport class ChatManager {\n  private messages: ChatMessage[] = [];\n  private emitter: EventEmitter;\n\n  constructor(emitter: EventEmitter, initialMessages?: ChatMessage[]) {\n    this.emitter = emitter;\n    if (initialMessages?.length) {\n      this.messages = [...initialMessages];\n    }\n  }\n\n  /** 获取所有消息 */\n  getMessages(): ChatMessage[] {\n    return [...this.messages];\n  }\n\n  /** 根据 ID 获取消息 */\n  getMessage(id: string): ChatMessage | undefined {\n    return this.messages.find((m) => m.id === id);\n  }\n\n  /** 添加消息（末尾追加） */\n  addMessage(message: ChatMessage): void {\n    this.messages.push(message);\n    this.emitter.emit('message-added', message);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 在顶部批量插入消息（用于加载更多） */\n  prependMessages(messages: ChatMessage[]): void {\n    this.messages.unshift(...messages);\n    this.emitter.emit('messages-prepended', messages);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 更新消息 */\n  updateMessage(id: string, updates: Partial<ChatMessage>): void {\n    const index = this.messages.findIndex((m) => m.id === id);\n    if (index === -1) return;\n\n    this.messages[index] = { ...this.messages[index], ...updates };\n    this.emitter.emit('message-updated', this.messages[index]);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 删除消息 */\n  removeMessage(id: string): void {\n    const index = this.messages.findIndex((m) => m.id === id);\n    if (index === -1) return;\n\n    const removed = this.messages.splice(index, 1)[0];\n    this.emitter.emit('message-removed', removed);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 替换全部消息 */\n  setMessages(messages: ChatMessage[]): void {\n    this.messages = [...messages];\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 清空所有消息 */\n  clearMessages(): void {\n    this.messages = [];\n    this.emitter.emit('messages-changed', []);\n  }\n\n  /** 追加流式消息内容 */\n  appendMessageContent(id: string, chunk: string): void {\n    const index = this.messages.findIndex((m) => m.id === id);\n    if (index === -1) return;\n\n    const msg = this.messages[index];\n    this.messages[index] = {\n      ...msg,\n      content: (msg.content ?? '') + chunk,\n    };\n    this.emitter.emit('message-content-appended', id, this.messages[index].content);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n\n  /** 完成流式消息 */\n  finishStreaming(id: string): void {\n    const index = this.messages.findIndex((m) => m.id === id);\n    if (index === -1) return;\n\n    this.messages[index] = { ...this.messages[index], streaming: false };\n    this.emitter.emit('message-updated', this.messages[index]);\n    this.emitter.emit('messages-changed', this.getMessages());\n  }\n}\n"],"mappings":";;;;;;;;;;AAUO,IAAM,cAAN,MAAkB;CAIvB,YAAY,SAAuB,iBAAiC;EAHpE,KAAQ,WAA0B,CAAC;EAIjC,KAAK,UAAU;EACf,IAAI,iBAAiB,QACnB,KAAK,WAAW,CAAC,GAAG,eAAe;CAEvC;;CAGA,cAA6B;EAC3B,OAAO,CAAC,GAAG,KAAK,QAAQ;CAC1B;;CAGA,WAAW,IAAqC;EAC9C,OAAO,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE;CAC9C;;CAGA,WAAW,SAA4B;EACrC,KAAK,SAAS,KAAK,OAAO;EAC1B,KAAK,QAAQ,KAAK,iBAAiB,OAAO;EAC1C,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,gBAAgB,UAA+B;EAC7C,KAAK,SAAS,QAAQ,GAAG,QAAQ;EACjC,KAAK,QAAQ,KAAK,sBAAsB,QAAQ;EAChD,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,cAAc,IAAY,SAAqC;EAC7D,MAAM,QAAQ,KAAK,SAAS,WAAW,MAAM,EAAE,OAAO,EAAE;EACxD,IAAI,UAAU,IAAI;EAElB,KAAK,SAAS,SAAS;GAAE,GAAG,KAAK,SAAS;GAAQ,GAAG;EAAQ;EAC7D,KAAK,QAAQ,KAAK,mBAAmB,KAAK,SAAS,MAAM;EACzD,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,cAAc,IAAkB;EAC9B,MAAM,QAAQ,KAAK,SAAS,WAAW,MAAM,EAAE,OAAO,EAAE;EACxD,IAAI,UAAU,IAAI;EAElB,MAAM,UAAU,KAAK,SAAS,OAAO,OAAO,CAAC,CAAA,CAAE;EAC/C,KAAK,QAAQ,KAAK,mBAAmB,OAAO;EAC5C,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,YAAY,UAA+B;EACzC,KAAK,WAAW,CAAC,GAAG,QAAQ;EAC5B,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,gBAAsB;EACpB,KAAK,WAAW,CAAC;EACjB,KAAK,QAAQ,KAAK,oBAAoB,CAAC,CAAC;CAC1C;;CAGA,qBAAqB,IAAY,OAAqB;EACpD,MAAM,QAAQ,KAAK,SAAS,WAAW,MAAM,EAAE,OAAO,EAAE;EACxD,IAAI,UAAU,IAAI;EAElB,MAAM,MAAM,KAAK,SAAS;EAC1B,KAAK,SAAS,SAAS;GACrB,GAAG;GACH,UAAU,IAAI,WAAW,MAAM;EACjC;EACA,KAAK,QAAQ,KAAK,4BAA4B,IAAI,KAAK,SAAS,MAAK,CAAE,OAAO;EAC9E,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;;CAGA,gBAAgB,IAAkB;EAChC,MAAM,QAAQ,KAAK,SAAS,WAAW,MAAM,EAAE,OAAO,EAAE;EACxD,IAAI,UAAU,IAAI;EAElB,KAAK,SAAS,SAAS;GAAE,GAAG,KAAK,SAAS;GAAQ,WAAW;EAAM;EACnE,KAAK,QAAQ,KAAK,mBAAmB,KAAK,SAAS,MAAM;EACzD,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;AACF"}
+{"version":3,"file":"chat-manager.js","names":["message"],"sources":["../../src/core/chat-manager.ts"],"sourcesContent":["import type { ChatMessage, MessageStatus } from '../types'\nimport type { EventEmitter } from './event-emitter'\nimport {\n  cloneChatMessage,\n  normalizeChatMessage,\n  normalizeChatMessages,\n} from './message-schema'\n\nexport type MessageMergeResult = 'added' | 'updated' | 'ignored'\n\nexport interface MessageMergeOptions {\n  sequence?: number\n  source?: 'local' | 'remote'\n}\n\nexport interface StreamAppendOptions {\n  generation?: string\n  sequence?: number\n}\n\ninterface StreamState {\n  generation: string\n  lastSequence: number\n}\n\n/** ChatManager - 聊天消息状态、幂等合并和流式 generation 管理。 */\nexport class ChatManager {\n  private messages: ChatMessage[] = []\n  private readonly emitter: EventEmitter\n  private readonly streams = new Map<string, StreamState>()\n\n  constructor(emitter: EventEmitter, initialMessages?: ChatMessage[]) {\n    this.emitter = emitter\n    if (initialMessages?.length) {\n      this.messages = normalizeChatMessages(initialMessages)\n    }\n  }\n\n  getMessages(): ChatMessage[] {\n    return this.messages.map(cloneChatMessage)\n  }\n\n  getMessage(id: string): ChatMessage | undefined {\n    const message = this.messages.find(item => item.id === id)\n    return message ? cloneChatMessage(message) : undefined\n  }\n\n  getMessageIdByClientMessageId(clientMessageId: string): string | undefined {\n    return this.messages.find(\n      message => message.clientMessageId === clientMessageId\n    )?.id\n  }\n\n  addMessage(message: ChatMessage): void {\n    const storedMessage = normalizeChatMessage(message)\n    this.assertUniqueIds([storedMessage])\n    this.messages.push(storedMessage)\n    this.emitAdded(storedMessage)\n  }\n\n  prependMessages(messages: ChatMessage[]): void {\n    const storedMessages = normalizeChatMessages(messages)\n    this.assertUniqueIds(storedMessages)\n    this.messages.unshift(...storedMessages)\n    this.emitter.emit(\n      'messages-prepended',\n      storedMessages.map(cloneChatMessage)\n    )\n    this.emitChanged()\n  }\n\n  /** 合并本地 ack 或远端推送，按 id/clientMessageId 去重并拒绝旧 sequence。 */\n  upsertMessage(\n    message: ChatMessage,\n    options: MessageMergeOptions = {}\n  ): MessageMergeResult {\n    const normalized = normalizeChatMessage({\n      ...message,\n      ...(options.sequence !== undefined && { sequence: options.sequence }),\n    })\n    const index = this.findMessageIndex(normalized)\n\n    if (index < 0) {\n      this.messages.push(normalized)\n      this.emitAdded(normalized)\n      return 'added'\n    }\n\n    const current = this.messages[index]\n    if (\n      Number.isFinite(normalized.sequence) &&\n      Number.isFinite(current.sequence) &&\n      (normalized.sequence as number) <= (current.sequence as number)\n    ) {\n      return 'ignored'\n    }\n\n    const merged = normalizeChatMessage({\n      ...current,\n      ...normalized,\n      id: current.id,\n      clientMessageId: normalized.clientMessageId ?? current.clientMessageId,\n      sequence: normalized.sequence ?? current.sequence,\n    })\n    this.messages[index] = merged\n    this.emitter.emit('message-updated', cloneChatMessage(merged))\n    this.emitChanged()\n    return 'updated'\n  }\n\n  mergeMessages(\n    messages: ChatMessage[],\n    options: MessageMergeOptions = {}\n  ): { added: number; updated: number; ignored: number } {\n    const result = { added: 0, updated: 0, ignored: 0 }\n    for (const message of messages) {\n      const outcome = this.upsertMessage(message, options)\n      result[outcome] += 1\n    }\n    return result\n  }\n\n  updateMessage(id: string, updates: Partial<ChatMessage>): void {\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return\n    if (updates.id !== undefined && updates.id !== id) {\n      throw new Error('Chat message IDs are immutable.')\n    }\n\n    const next = normalizeChatMessage({\n      ...this.messages[index],\n      ...updates,\n      id,\n    })\n    this.assertUniqueClientMessageId(next, id)\n    this.messages[index] = next\n    this.emitter.emit('message-updated', cloneChatMessage(next))\n    this.emitChanged()\n  }\n\n  markMessageStatus(id: string, status: MessageStatus): void {\n    this.updateMessage(id, { status })\n  }\n\n  removeMessage(id: string): void {\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return\n\n    const [removed] = this.messages.splice(index, 1)\n    this.streams.delete(id)\n    this.emitter.emit('message-removed', cloneChatMessage(removed))\n    this.emitChanged()\n  }\n\n  setMessages(messages: ChatMessage[]): void {\n    this.messages = normalizeChatMessages(messages)\n    this.streams.clear()\n    this.emitChanged()\n  }\n\n  clearMessages(): void {\n    this.messages = []\n    this.streams.clear()\n    this.emitChanged()\n  }\n\n  beginStreaming(id: string, generation = createGeneration()): string | null {\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return null\n    this.streams.set(id, { generation, lastSequence: -1 })\n    this.messages[index] = normalizeChatMessage({\n      ...this.messages[index],\n      streaming: true,\n    })\n    this.emitter.emit('message-updated', cloneChatMessage(this.messages[index]))\n    this.emitChanged()\n    return generation\n  }\n\n  appendMessageContent(\n    id: string,\n    chunk: string,\n    options: StreamAppendOptions = {}\n  ): boolean {\n    const stream = this.streams.get(id)\n    if (options.generation) {\n      if (!stream || stream.generation !== options.generation) return false\n      const sequence = options.sequence\n      if (\n        sequence !== undefined &&\n        Number.isFinite(sequence) &&\n        sequence <= stream.lastSequence\n      ) {\n        return false\n      }\n      if (sequence !== undefined && Number.isFinite(sequence)) {\n        stream.lastSequence = sequence\n      }\n    }\n\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return false\n    const message = this.messages[index]\n    this.messages[index] = normalizeChatMessage({\n      ...message,\n      content: (message.content ?? '') + chunk,\n      streaming: options.generation ? true : message.streaming,\n    })\n    this.emitter.emit(\n      'message-content-appended',\n      id,\n      this.messages[index].content,\n      options.generation,\n      options.sequence\n    )\n    this.emitChanged()\n    return true\n  }\n\n  finishStreaming(id: string, generation?: string): boolean {\n    const stream = this.streams.get(id)\n    if (generation && (!stream || stream.generation !== generation)) {\n      return false\n    }\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return false\n    this.messages[index] = normalizeChatMessage({\n      ...this.messages[index],\n      streaming: false,\n    })\n    this.streams.delete(id)\n    this.emitter.emit('message-updated', cloneChatMessage(this.messages[index]))\n    this.emitChanged()\n    return true\n  }\n\n  cancelStreaming(id: string, generation?: string): boolean {\n    const stream = this.streams.get(id)\n    if (generation && (!stream || stream.generation !== generation)) {\n      return false\n    }\n    const index = this.messages.findIndex(message => message.id === id)\n    if (index === -1) return false\n    this.streams.delete(id)\n    this.messages[index] = normalizeChatMessage({\n      ...this.messages[index],\n      streaming: false,\n    })\n    this.emitter.emit(\n      'stream-cancelled',\n      cloneChatMessage(this.messages[index])\n    )\n    this.emitter.emit('message-updated', cloneChatMessage(this.messages[index]))\n    this.emitChanged()\n    return true\n  }\n\n  getStreamGeneration(id: string): string | undefined {\n    return this.streams.get(id)?.generation\n  }\n\n  private findMessageIndex(message: ChatMessage): number {\n    const byId = this.messages.findIndex(item => item.id === message.id)\n    if (byId >= 0) return byId\n    if (!message.clientMessageId) return -1\n    return this.messages.findIndex(\n      item => item.clientMessageId === message.clientMessageId\n    )\n  }\n\n  private assertUniqueIds(messages: ChatMessage[]): void {\n    const ids = new Set(this.messages.map(message => message.id))\n    const clientIds = new Set(\n      this.messages.flatMap(message =>\n        message.clientMessageId ? [message.clientMessageId] : []\n      )\n    )\n    for (const message of messages) {\n      if (!message.id || ids.has(message.id)) {\n        throw new Error(\n          `Chat message ID must be non-empty and unique: ${message.id}`\n        )\n      }\n      if (message.clientMessageId && clientIds.has(message.clientMessageId)) {\n        throw new Error(\n          `Chat client message ID must be unique: ${message.clientMessageId}`\n        )\n      }\n      ids.add(message.id)\n      if (message.clientMessageId) clientIds.add(message.clientMessageId)\n    }\n  }\n\n  private assertUniqueClientMessageId(message: ChatMessage, ownId: string) {\n    if (\n      message.clientMessageId &&\n      this.messages.some(\n        item =>\n          item.id !== ownId && item.clientMessageId === message.clientMessageId\n      )\n    ) {\n      throw new Error(\n        `Chat client message ID must be unique: ${message.clientMessageId}`\n      )\n    }\n  }\n\n  private emitAdded(message: ChatMessage): void {\n    this.emitter.emit('message-added', cloneChatMessage(message))\n    this.emitChanged()\n  }\n\n  private emitChanged(): void {\n    this.emitter.emit('messages-changed', this.getMessages())\n  }\n}\n\nfunction createGeneration(): string {\n  const cryptoObject = globalThis.crypto\n  if (cryptoObject?.randomUUID) return cryptoObject.randomUUID()\n  return `stream-${Date.now()}-${Math.random().toString(36).slice(2)}`\n}\n"],"mappings":";;;;;;;;;;;AA0BO,IAAM,cAAN,MAAkB;CAKvB,YAAY,SAAuB,iBAAiC;EAJpE,KAAQ,WAA0B,CAAC;EAEnC,KAAiB,0BAAU,IAAI,IAAyB;EAGtD,KAAK,UAAU;EACf,IAAI,iBAAiB,QACnB,KAAK,WAAW,sBAAsB,eAAe;CAEzD;CAEA,cAA6B;EAC3B,OAAO,KAAK,SAAS,IAAI,gBAAgB;CAC3C;CAEA,WAAW,IAAqC;EAC9C,MAAM,UAAU,KAAK,SAAS,MAAK,SAAQ,KAAK,OAAO,EAAE;EACzD,OAAO,UAAU,iBAAiB,OAAO,IAAI,KAAA;CAC/C;CAEA,8BAA8B,iBAA6C;EACzE,OAAO,KAAK,SAAS,MACnB,YAAW,QAAQ,oBAAoB,eACzC,CAAA,EAAG;CACL;CAEA,WAAW,SAA4B;EACrC,MAAM,gBAAgB,qBAAqB,OAAO;EAClD,KAAK,gBAAgB,CAAC,aAAa,CAAC;EACpC,KAAK,SAAS,KAAK,aAAa;EAChC,KAAK,UAAU,aAAa;CAC9B;CAEA,gBAAgB,UAA+B;EAC7C,MAAM,iBAAiB,sBAAsB,QAAQ;EACrD,KAAK,gBAAgB,cAAc;EACnC,KAAK,SAAS,QAAQ,GAAG,cAAc;EACvC,KAAK,QAAQ,KACX,sBACA,eAAe,IAAI,gBAAgB,CACrC;EACA,KAAK,YAAY;CACnB;;CAGA,cACE,SACA,UAA+B,CAAC,GACZ;EACpB,MAAM,aAAa,qBAAqB;GACtC,GAAG;GACH,GAAI,QAAQ,aAAa,KAAA,KAAa,EAAE,UAAU,QAAQ,SAAS;EACrE,CAAC;EACD,MAAM,QAAQ,KAAK,iBAAiB,UAAU;EAE9C,IAAI,QAAQ,GAAG;GACb,KAAK,SAAS,KAAK,UAAU;GAC7B,KAAK,UAAU,UAAU;GACzB,OAAO;EACT;EAEA,MAAM,UAAU,KAAK,SAAS;EAC9B,IACE,OAAO,SAAS,WAAW,QAAQ,KACnC,OAAO,SAAS,QAAQ,QAAQ,KAC/B,WAAW,YAAwB,QAAQ,UAE5C,OAAO;EAGT,MAAM,SAAS,qBAAqB;GAClC,GAAG;GACH,GAAG;GACH,IAAI,QAAQ;GACZ,iBAAiB,WAAW,mBAAmB,QAAQ;GACvD,UAAU,WAAW,YAAY,QAAQ;EAC3C,CAAC;EACD,KAAK,SAAS,SAAS;EACvB,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,MAAM,CAAC;EAC7D,KAAK,YAAY;EACjB,OAAO;CACT;CAEA,cACE,UACA,UAA+B,CAAC,GACqB;EACrD,MAAM,SAAS;GAAE,OAAO;GAAG,SAAS;GAAG,SAAS;EAAE;EAClD,KAAA,MAAW,WAAW,UAAU;GAC9B,MAAM,UAAU,KAAK,cAAc,SAAS,OAAO;GACnD,OAAO,YAAY;EACrB;EACA,OAAO;CACT;CAEA,cAAc,IAAY,SAAqC;EAC7D,MAAM,QAAQ,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI;EAClB,IAAI,QAAQ,OAAO,KAAA,KAAa,QAAQ,OAAO,IAC7C,MAAM,IAAI,MAAM,iCAAiC;EAGnD,MAAM,OAAO,qBAAqB;GAChC,GAAG,KAAK,SAAS;GACjB,GAAG;GACH;EACF,CAAC;EACD,KAAK,4BAA4B,MAAM,EAAE;EACzC,KAAK,SAAS,SAAS;EACvB,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,IAAI,CAAC;EAC3D,KAAK,YAAY;CACnB;CAEA,kBAAkB,IAAY,QAA6B;EACzD,KAAK,cAAc,IAAI,EAAE,OAAO,CAAC;CACnC;CAEA,cAAc,IAAkB;EAC9B,MAAM,QAAQ,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI;EAElB,MAAM,CAAC,WAAW,KAAK,SAAS,OAAO,OAAO,CAAC;EAC/C,KAAK,QAAQ,OAAO,EAAE;EACtB,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,OAAO,CAAC;EAC9D,KAAK,YAAY;CACnB;CAEA,YAAY,UAA+B;EACzC,KAAK,WAAW,sBAAsB,QAAQ;EAC9C,KAAK,QAAQ,MAAM;EACnB,KAAK,YAAY;CACnB;CAEA,gBAAsB;EACpB,KAAK,WAAW,CAAC;EACjB,KAAK,QAAQ,MAAM;EACnB,KAAK,YAAY;CACnB;CAEA,eAAe,IAAY,aAAa,iBAAiB,GAAkB;EACzE,MAAM,QAAQ,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI,OAAO;EACzB,KAAK,QAAQ,IAAI,IAAI;GAAE;GAAY,cAAc;EAAG,CAAC;EACrD,KAAK,SAAS,SAAS,qBAAqB;GAC1C,GAAG,KAAK,SAAS;GACjB,WAAW;EACb,CAAC;EACD,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,KAAK,SAAS,MAAM,CAAC;EAC3E,KAAK,YAAY;EACjB,OAAO;CACT;CAEA,qBACE,IACA,OACA,UAA+B,CAAC,GACvB;EACT,MAAM,SAAS,KAAK,QAAQ,IAAI,EAAE;EAClC,IAAI,QAAQ,YAAY;GACtB,IAAI,CAAC,UAAU,OAAO,eAAe,QAAQ,YAAY,OAAO;GAChE,MAAM,WAAW,QAAQ;GACzB,IACE,aAAa,KAAA,KACb,OAAO,SAAS,QAAQ,KACxB,YAAY,OAAO,cAEnB,OAAO;GAET,IAAI,aAAa,KAAA,KAAa,OAAO,SAAS,QAAQ,GACpD,OAAO,eAAe;EAE1B;EAEA,MAAM,QAAQ,KAAK,SAAS,WAAUA,aAAWA,SAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI,OAAO;EACzB,MAAM,UAAU,KAAK,SAAS;EAC9B,KAAK,SAAS,SAAS,qBAAqB;GAC1C,GAAG;GACH,UAAU,QAAQ,WAAW,MAAM;GACnC,WAAW,QAAQ,aAAa,OAAO,QAAQ;EACjD,CAAC;EACD,KAAK,QAAQ,KACX,4BACA,IACA,KAAK,SAAS,MAAK,CAAE,SACrB,QAAQ,YACR,QAAQ,QACV;EACA,KAAK,YAAY;EACjB,OAAO;CACT;CAEA,gBAAgB,IAAY,YAA8B;EACxD,MAAM,SAAS,KAAK,QAAQ,IAAI,EAAE;EAClC,IAAI,eAAe,CAAC,UAAU,OAAO,eAAe,aAClD,OAAO;EAET,MAAM,QAAQ,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI,OAAO;EACzB,KAAK,SAAS,SAAS,qBAAqB;GAC1C,GAAG,KAAK,SAAS;GACjB,WAAW;EACb,CAAC;EACD,KAAK,QAAQ,OAAO,EAAE;EACtB,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,KAAK,SAAS,MAAM,CAAC;EAC3E,KAAK,YAAY;EACjB,OAAO;CACT;CAEA,gBAAgB,IAAY,YAA8B;EACxD,MAAM,SAAS,KAAK,QAAQ,IAAI,EAAE;EAClC,IAAI,eAAe,CAAC,UAAU,OAAO,eAAe,aAClD,OAAO;EAET,MAAM,QAAQ,KAAK,SAAS,WAAU,YAAW,QAAQ,OAAO,EAAE;EAClE,IAAI,UAAU,IAAI,OAAO;EACzB,KAAK,QAAQ,OAAO,EAAE;EACtB,KAAK,SAAS,SAAS,qBAAqB;GAC1C,GAAG,KAAK,SAAS;GACjB,WAAW;EACb,CAAC;EACD,KAAK,QAAQ,KACX,oBACA,iBAAiB,KAAK,SAAS,MAAM,CACvC;EACA,KAAK,QAAQ,KAAK,mBAAmB,iBAAiB,KAAK,SAAS,MAAM,CAAC;EAC3E,KAAK,YAAY;EACjB,OAAO;CACT;CAEA,oBAAoB,IAAgC;EAClD,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAA,EAAG;CAC/B;CAEQ,iBAAiB,SAA8B;EACrD,MAAM,OAAO,KAAK,SAAS,WAAU,SAAQ,KAAK,OAAO,QAAQ,EAAE;EACnE,IAAI,QAAQ,GAAG,OAAO;EACtB,IAAI,CAAC,QAAQ,iBAAiB,OAAO;EACrC,OAAO,KAAK,SAAS,WACnB,SAAQ,KAAK,oBAAoB,QAAQ,eAC3C;CACF;CAEQ,gBAAgB,UAA+B;EACrD,MAAM,MAAM,IAAI,IAAI,KAAK,SAAS,KAAI,YAAW,QAAQ,EAAE,CAAC;EAC5D,MAAM,YAAY,IAAI,IACpB,KAAK,SAAS,SAAQ,YACpB,QAAQ,kBAAkB,CAAC,QAAQ,eAAe,IAAI,CAAC,CACzD,CACF;EACA,KAAA,MAAW,WAAW,UAAU;GAC9B,IAAI,CAAC,QAAQ,MAAM,IAAI,IAAI,QAAQ,EAAE,GACnC,MAAM,IAAI,MACR,iDAAiD,QAAQ,IAC3D;GAEF,IAAI,QAAQ,mBAAmB,UAAU,IAAI,QAAQ,eAAe,GAClE,MAAM,IAAI,MACR,0CAA0C,QAAQ,iBACpD;GAEF,IAAI,IAAI,QAAQ,EAAE;GAClB,IAAI,QAAQ,iBAAiB,UAAU,IAAI,QAAQ,eAAe;EACpE;CACF;CAEQ,4BAA4B,SAAsB,OAAe;EACvE,IACE,QAAQ,mBACR,KAAK,SAAS,MACZ,SACE,KAAK,OAAO,SAAS,KAAK,oBAAoB,QAAQ,eAC1D,GAEA,MAAM,IAAI,MACR,0CAA0C,QAAQ,iBACpD;CAEJ;CAEQ,UAAU,SAA4B;EAC5C,KAAK,QAAQ,KAAK,iBAAiB,iBAAiB,OAAO,CAAC;EAC5D,KAAK,YAAY;CACnB;CAEQ,cAAoB;EAC1B,KAAK,QAAQ,KAAK,oBAAoB,KAAK,YAAY,CAAC;CAC1D;AACF;AAEA,SAAS,mBAA2B;CAClC,MAAM,eAAe,WAAW;CAChC,IAAI,cAAc,YAAY,OAAO,aAAa,WAAW;CAC7D,OAAO,UAAU,KAAK,IAAI,EAAC,GAAI,KAAK,OAAO,CAAA,CAAE,SAAS,EAAE,CAAA,CAAE,MAAM,CAAC;AACnE"}

package/esm/core/event-emitter.d.ts

@@ -45,4 +45,3 @@ export declare class EventEmitter {
     removeAll(event?: string): void;
 }
 export {};
-//# sourceMappingURL=event-emitter.d.ts.map

package/esm/core/event-emitter.js

@@ -1,8 +1,8 @@
 /*!
 * ***********************************
-* @composy/chat-core v0.0.1       *
+* @composy/chat-core v0.0.2       *
 * Built with rollup               *
-* Build time: 2024-08-17 11:30:32 *
+* Build time: 2024-10-12 21:52:18 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
@@ -19,8 +19,12 @@ var EventEmitter = class {
 	* @returns 返回一个取消订阅的函数，调用即可移除该监听器
 	*/
 	on(event, handler) {
-		if (!this.listeners.has(event)) this.listeners.set(event, /* @__PURE__ */ new Set());
-		this.listeners.get(event).add(handler);
+		let handlers = this.listeners.get(event);
+		if (!handlers) {
+			handlers = /* @__PURE__ */ new Set();
+			this.listeners.set(event, handlers);
+		}
+		handlers.add(handler);
 		return () => this.off(event, handler);
 	}
 	/**
@@ -29,7 +33,10 @@ var EventEmitter = class {
 	* @param handler - 要移除的处理函数引用（必须与注册时为同一函数引用）
 	*/
 	off(event, handler) {
-		this.listeners.get(event)?.delete(handler);
+		const handlers = this.listeners.get(event);
+		if (!handlers) return;
+		handlers.delete(handler);
+		if (handlers.size === 0) this.listeners.delete(event);
 	}
 	/**
 	* 触发（发射）指定事件，依次调用所有已注册的监听器
@@ -37,7 +44,7 @@ var EventEmitter = class {
 	* @param args - 传递给监听器函数的参数列表（剩余参数语法）
 	*/
 	emit(event, ...args) {
-		this.listeners.get(event)?.forEach((handler) => {
+		[...this.listeners.get(event) ?? []].forEach((handler) => {
 			try {
 				handler(...args);
 			} catch (err) {
@@ -65,7 +72,7 @@ var EventEmitter = class {
 	*   - 若不传参数，则清空所有事件的所有监听器
 	*/
 	removeAll(event) {
-		if (event) this.listeners.delete(event);
+		if (event !== void 0) this.listeners.delete(event);
 		else this.listeners.clear();
 	}
 };

package/esm/core/event-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-emitter.js","names":[],"sources":["../../src/core/event-emitter.ts"],"sourcesContent":["/**\n * 轻量事件总线\n * 提供发布/订阅模式的事件管理功能，支持事件的注册、注销、触发等操作\n */\n\n// 定义事件处理函数的类型签名：接收任意数量的未知类型参数，无返回值\ntype Handler = (...args: unknown[]) => void;\n\n/**\n * EventEmitter - 事件发射器类\n * 实现了经典的发布/订阅（Pub/Sub）模式，用于模块间的解耦通信\n * 支持：一次性监听、批量移除、自动清理等功能\n */\nexport class EventEmitter {\n  // 使用 Map 存储事件名到处理函数集合的映射关系\n  // 键为事件名称（字符串），值为该事件对应的处理函数 Set 集合\n  // 使用 Set 而非数组，可自动去重同一处理函数的重复注册\n  private listeners = new Map<string, Set<Handler>>();\n\n  /**\n   * 注册事件监听器\n   * @param event - 要监听的事件名称\n   * @param handler - 事件触发时执行的回调函数\n   * @returns 返回一个取消订阅的函数，调用即可移除该监听器\n   */\n  on(event: string, handler: Handler): () => void {\n    // 如果该事件还没有任何监听器，则创建一个新的 Set 集合\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    // 将处理函数添加到该事件的监听器集合中\n    // 使用非空断言（!）因为上方已确认该事件集合存在\n    this.listeners.get(event)!.add(handler);\n    // 返回一个取消订阅函数，方便调用者链式调用后自行移除\n    return () => this.off(event, handler);\n  }\n\n  /**\n   * 移除指定事件的某个监听器\n   * @param event - 事件名称\n   * @param handler - 要移除的处理函数引用（必须与注册时为同一函数引用）\n   */\n  off(event: string, handler: Handler): void {\n    // 可选链调用：如果该事件存在监听器集合，则从中删除指定处理函数\n    // 若事件不存在则安全跳过，不会抛出异常\n    this.listeners.get(event)?.delete(handler);\n  }\n\n  /**\n   * 触发（发射）指定事件，依次调用所有已注册的监听器\n   * @param event - 要触发的事件名称\n   * @param args - 传递给监听器函数的参数列表（剩余参数语法）\n   */\n  emit(event: string, ...args: unknown[]): void {\n    // 获取该事件的监听器集合，若存在则遍历调用每个处理函数\n    this.listeners.get(event)?.forEach((handler) => {\n      try {\n        // 使用展开运算符将参数数组传递给处理函数\n        handler(...args);\n      } catch (err) {\n        // 捕获单个处理函数的异常，避免影响其他监听器的执行\n        // 同时输出错误日志便于调试，标注所属模块为 [Chat]\n        console.error(`[Chat] Event handler error for \"${event}\":`, err);\n      }\n    });\n  }\n\n  /**\n   * 注册一次性事件监听器（触发一次后自动移除）\n   * @param event - 要监听的事件名称\n   * @param handler - 事件触发时执行的回调函数\n   * @returns 返回取消订阅的函数，可在触发前手动取消\n   */\n  once(event: string, handler: Handler): () => void {\n    // 创建包装函数：先移除自身，再调用原始处理函数\n    // 这样保证该监听器只执行一次\n    const wrapper = (...args: unknown[]) => {\n      // 先从事件中移除包装函数自身，防止重复触发\n      this.off(event, wrapper);\n      // 再执行用户注册的原始处理函数\n      handler(...args);\n    };\n    // 将包装函数注册为普通监听器，复用 on() 的逻辑\n    return this.on(event, wrapper);\n  }\n\n  /**\n   * 批量移除事件监听器\n   * @param event - 可选的事件名称\n   *   - 若传入事件名，则只移除该事件的所有监听器\n   *   - 若不传参数，则清空所有事件的所有监听器\n   */\n  removeAll(event?: string): void {\n    if (event) {\n      // 移除指定事件的全部监听器（直接删除整个事件条目）\n      this.listeners.delete(event);\n    } else {\n      // 不传参数时，清空整个监听器映射表，移除所有事件\n      this.listeners.clear();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAaO,IAAM,eAAN,MAAmB;CAAnB,cAAA;EAIL,KAAQ,4BAAY,IAAI,IAA0B;CAAA;;;;;;;CAQlD,GAAG,OAAe,SAA8B;EAE9C,IAAI,CAAC,KAAK,UAAU,IAAI,KAAK,GAC3B,KAAK,UAAU,IAAI,uBAAO,IAAI,IAAI,CAAC;EAIrC,KAAK,UAAU,IAAI,KAAK,CAAA,CAAG,IAAI,OAAO;EAEtC,aAAa,KAAK,IAAI,OAAO,OAAO;CACtC;;;;;;CAOA,IAAI,OAAe,SAAwB;EAGzC,KAAK,UAAU,IAAI,KAAK,CAAA,EAAG,OAAO,OAAO;CAC3C;;;;;;CAOA,KAAK,OAAA,GAAkB,MAAuB;EAE5C,KAAK,UAAU,IAAI,KAAK,CAAA,EAAG,SAAS,YAAY;GAC9C,IAAI;IAEF,QAAQ,GAAG,IAAI;GACjB,SAAS,KAAK;IAGZ,QAAQ,MAAM,mCAAmC,MAAK,KAAM,GAAG;GACjE;EACF,CAAC;CACH;;;;;;;CAQA,KAAK,OAAe,SAA8B;EAGhD,MAAM,WAAU,GAAI,SAAoB;GAEtC,KAAK,IAAI,OAAO,OAAO;GAEvB,QAAQ,GAAG,IAAI;EACjB;EAEA,OAAO,KAAK,GAAG,OAAO,OAAO;CAC/B;;;;;;;CAQA,UAAU,OAAsB;EAC9B,IAAI,OAEF,KAAK,UAAU,OAAO,KAAK;OAG3B,KAAK,UAAU,MAAM;CAEzB;AACF"}
+{"version":3,"file":"event-emitter.js","names":[],"sources":["../../src/core/event-emitter.ts"],"sourcesContent":["/**\r\n * 轻量事件总线\r\n * 提供发布/订阅模式的事件管理功能，支持事件的注册、注销、触发等操作\r\n */\r\n\r\n// 定义事件处理函数的类型签名：接收任意数量的未知类型参数，无返回值\r\ntype Handler = (...args: unknown[]) => void\r\n\r\n/**\r\n * EventEmitter - 事件发射器类\r\n * 实现了经典的发布/订阅（Pub/Sub）模式，用于模块间的解耦通信\r\n * 支持：一次性监听、批量移除、自动清理等功能\r\n */\r\nexport class EventEmitter {\r\n  // 使用 Map 存储事件名到处理函数集合的映射关系\r\n  // 键为事件名称（字符串），值为该事件对应的处理函数 Set 集合\r\n  // 使用 Set 而非数组，可自动去重同一处理函数的重复注册\r\n  private listeners = new Map<string, Set<Handler>>()\r\n\r\n  /**\r\n   * 注册事件监听器\r\n   * @param event - 要监听的事件名称\r\n   * @param handler - 事件触发时执行的回调函数\r\n   * @returns 返回一个取消订阅的函数，调用即可移除该监听器\r\n   */\r\n  on(event: string, handler: Handler): () => void {\r\n    let handlers = this.listeners.get(event)\r\n    if (!handlers) {\r\n      handlers = new Set()\r\n      this.listeners.set(event, handlers)\r\n    }\r\n    handlers.add(handler)\r\n    // 返回一个取消订阅函数，方便调用者链式调用后自行移除\r\n    return () => this.off(event, handler)\r\n  }\r\n\r\n  /**\r\n   * 移除指定事件的某个监听器\r\n   * @param event - 事件名称\r\n   * @param handler - 要移除的处理函数引用（必须与注册时为同一函数引用）\r\n   */\r\n  off(event: string, handler: Handler): void {\r\n    // 可选链调用：如果该事件存在监听器集合，则从中删除指定处理函数\r\n    // 若事件不存在则安全跳过，不会抛出异常\r\n    const handlers = this.listeners.get(event)\r\n    if (!handlers) return\r\n    handlers.delete(handler)\r\n    if (handlers.size === 0) this.listeners.delete(event)\r\n  }\r\n\r\n  /**\r\n   * 触发（发射）指定事件，依次调用所有已注册的监听器\r\n   * @param event - 要触发的事件名称\r\n   * @param args - 传递给监听器函数的参数列表（剩余参数语法）\r\n   */\r\n  emit(event: string, ...args: unknown[]): void {\r\n    // 获取该事件的监听器集合，若存在则遍历调用每个处理函数\r\n    ;[...(this.listeners.get(event) ?? [])].forEach(handler => {\r\n      try {\r\n        // 使用展开运算符将参数数组传递给处理函数\r\n        handler(...args)\r\n      } catch (err) {\r\n        // 捕获单个处理函数的异常，避免影响其他监听器的执行\r\n        // 同时输出错误日志便于调试，标注所属模块为 [Chat]\r\n        console.error(`[Chat] Event handler error for \"${event}\":`, err)\r\n      }\r\n    })\r\n  }\r\n\r\n  /**\r\n   * 注册一次性事件监听器（触发一次后自动移除）\r\n   * @param event - 要监听的事件名称\r\n   * @param handler - 事件触发时执行的回调函数\r\n   * @returns 返回取消订阅的函数，可在触发前手动取消\r\n   */\r\n  once(event: string, handler: Handler): () => void {\r\n    // 创建包装函数：先移除自身，再调用原始处理函数\r\n    // 这样保证该监听器只执行一次\r\n    const wrapper = (...args: unknown[]) => {\r\n      // 先从事件中移除包装函数自身，防止重复触发\r\n      this.off(event, wrapper)\r\n      // 再执行用户注册的原始处理函数\r\n      handler(...args)\r\n    }\r\n    // 将包装函数注册为普通监听器，复用 on() 的逻辑\r\n    return this.on(event, wrapper)\r\n  }\r\n\r\n  /**\r\n   * 批量移除事件监听器\r\n   * @param event - 可选的事件名称\r\n   *   - 若传入事件名，则只移除该事件的所有监听器\r\n   *   - 若不传参数，则清空所有事件的所有监听器\r\n   */\r\n  removeAll(event?: string): void {\r\n    if (event !== undefined) {\r\n      // 移除指定事件的全部监听器（直接删除整个事件条目）\r\n      this.listeners.delete(event)\r\n    } else {\r\n      // 不传参数时，清空整个监听器映射表，移除所有事件\r\n      this.listeners.clear()\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AAaO,IAAM,eAAN,MAAmB;CAAnB,cAAA;EAIL,KAAQ,4BAAY,IAAI,IAA0B;CAAA;;;;;;;CAQlD,GAAG,OAAe,SAA8B;EAC9C,IAAI,WAAW,KAAK,UAAU,IAAI,KAAK;EACvC,IAAI,CAAC,UAAU;GACb,2BAAW,IAAI,IAAI;GACnB,KAAK,UAAU,IAAI,OAAO,QAAQ;EACpC;EACA,SAAS,IAAI,OAAO;EAEpB,aAAa,KAAK,IAAI,OAAO,OAAO;CACtC;;;;;;CAOA,IAAI,OAAe,SAAwB;EAGzC,MAAM,WAAW,KAAK,UAAU,IAAI,KAAK;EACzC,IAAI,CAAC,UAAU;EACf,SAAS,OAAO,OAAO;EACvB,IAAI,SAAS,SAAS,GAAG,KAAK,UAAU,OAAO,KAAK;CACtD;;;;;;CAOA,KAAK,OAAA,GAAkB,MAAuB;EAE3C,CAAC,GAAI,KAAK,UAAU,IAAI,KAAK,KAAK,CAAC,CAAE,CAAA,CAAE,SAAQ,YAAW;GACzD,IAAI;IAEF,QAAQ,GAAG,IAAI;GACjB,SAAS,KAAK;IAGZ,QAAQ,MAAM,mCAAmC,MAAK,KAAM,GAAG;GACjE;EACF,CAAC;CACH;;;;;;;CAQA,KAAK,OAAe,SAA8B;EAGhD,MAAM,WAAU,GAAI,SAAoB;GAEtC,KAAK,IAAI,OAAO,OAAO;GAEvB,QAAQ,GAAG,IAAI;EACjB;EAEA,OAAO,KAAK,GAAG,OAAO,OAAO;CAC/B;;;;;;;CAQA,UAAU,OAAsB;EAC9B,IAAI,UAAU,KAAA,GAEZ,KAAK,UAAU,OAAO,KAAK;OAG3B,KAAK,UAAU,MAAM;CAEzB;AACF"}

package/esm/core/mention-engine.d.ts

@@ -3,7 +3,7 @@
  * @description mention-engine 模块
  */
 import type { MentionItem } from '../types';
-import { EventEmitter } from './event-emitter';
+import type { EventEmitter } from './event-emitter';
 /**
  * MentionState interface
  */
@@ -38,4 +38,3 @@ export declare class MentionEngine {
     private filter;
     private escapeRegex;
 }
-//# sourceMappingURL=mention-engine.d.ts.map

package/esm/core/mention-engine.js

@@ -1,8 +1,8 @@
 /*!
 * ***********************************
-* @composy/chat-core v0.0.1       *
+* @composy/chat-core v0.0.2       *
 * Built with rollup               *
-* Build time: 2024-08-17 11:30:32 *
+* Build time: 2024-10-12 21:52:18 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
@@ -20,7 +20,7 @@ var MentionEngine = class {
 		};
 		this.selectedMentions = [];
 		this.emitter = emitter;
-		if (members) this.members = [...members];
+		if (members) this.members = members.map((member) => ({ ...member }));
 	}
 	getState() {
 		return {
@@ -29,10 +29,10 @@ var MentionEngine = class {
 		};
 	}
 	getSelectedMentions() {
-		return [...this.selectedMentions];
+		return this.selectedMentions.map((member) => ({ ...member }));
 	}
 	setMembers(members) {
-		this.members = [...members];
+		this.members = members.map((member) => ({ ...member }));
 		if (this.state.active) this.filter(this.state.query);
 	}
 	handleInput(text, cursorPos) {
@@ -47,7 +47,7 @@ var MentionEngine = class {
 			return;
 		}
 		const query = beforeCursor.slice(atIndex + 1);
-		if (/[^\S\r\n]/.test(query)) {
+		if (/\s/.test(query)) {
 			this.deactivate();
 			return;
 		}
@@ -72,7 +72,7 @@ var MentionEngine = class {
 	select(index) {
 		if (index < 0 || index >= this.state.filtered.length) return null;
 		const member = this.state.filtered[index];
-		if (!this.selectedMentions.find((m) => m.id === member.id)) this.selectedMentions.push(member);
+		if (!this.selectedMentions.some((m) => m.id === member.id)) this.selectedMentions.push(member);
 		this.emitter.emit("mention-select", member);
 		this.deactivate();
 		return member;
@@ -91,7 +91,7 @@ var MentionEngine = class {
 	parseMentions(text) {
 		const mentions = [];
 		const sortedMembers = [...this.members].sort((a, b) => b.name.length - a.name.length);
-		for (const member of sortedMembers) if (new RegExp(`(^|\\s)@${this.escapeRegex(member.name)}(?=\\s|$|[\uFF0C\u3002\uFF01\uFF1F,.!?])`, "u").test(text) && !mentions.find((m) => m.id === member.id)) mentions.push(member);
+		for (const member of sortedMembers) if (new RegExp(`(^|\\s)@${this.escapeRegex(member.name)}(?=\\s|$|[\uFF0C\u3002\uFF01\uFF1F,.!?])`, "u").test(text) && !mentions.some((m) => m.id === member.id)) mentions.push({ ...member });
 		return mentions;
 	}
 	resetSelected() {
@@ -103,7 +103,7 @@ var MentionEngine = class {
 	filter(query) {
 		const normalizedQuery = query.trim().toLowerCase();
 		this.state.query = query;
-		this.state.filtered = this.members.filter((member) => member.name.toLowerCase().includes(normalizedQuery) || member.id.toLowerCase().includes(normalizedQuery));
+		this.state.filtered = this.members.filter((member) => member.name.toLowerCase().includes(normalizedQuery) || member.id.toLowerCase().includes(normalizedQuery)).map((member) => ({ ...member }));
 		this.state.activeIndex = 0;
 		this.emitter.emit("mention-filter", this.getState());
 	}

package/esm/core/mention-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention-engine.js","names":[],"sources":["../../src/core/mention-engine.ts"],"sourcesContent":["/**\n * @file mention-engine.ts\n * @description mention-engine 模块\n */\n\nimport type { MentionItem } from '../types';\nimport { EventEmitter } from './event-emitter';\n\n/**\n * MentionState interface\n */\nexport interface MentionState {\n  active: boolean;\n  query: string;\n  filtered: MentionItem[];\n  activeIndex: number;\n  triggerPosition: number;\n}\n\n/**\n * MentionEngine 类\n */\nexport class MentionEngine {\n  private members: MentionItem[] = [];\n  private emitter: EventEmitter;\n  private state: MentionState = {\n    active: false,\n    query: '',\n    filtered: [],\n    activeIndex: 0,\n    triggerPosition: -1,\n  };\n  private selectedMentions: MentionItem[] = [];\n\n  constructor(emitter: EventEmitter, members?: MentionItem[]) {\n    this.emitter = emitter;\n    if (members) this.members = [...members];\n  }\n\n  getState(): MentionState {\n    return {\n      ...this.state,\n      filtered: [...this.state.filtered],\n    };\n  }\n\n  getSelectedMentions(): MentionItem[] {\n    return [...this.selectedMentions];\n  }\n\n  setMembers(members: MentionItem[]): void {\n    this.members = [...members];\n    if (this.state.active) {\n      this.filter(this.state.query);\n    }\n  }\n\n  handleInput(text: string, cursorPos: number): void {\n    const beforeCursor = text.slice(0, cursorPos);\n    const atIndex = beforeCursor.lastIndexOf('@');\n\n    if (atIndex === -1) {\n      this.deactivate();\n      return;\n    }\n\n    if (atIndex > 0 && !/\\s/.test(beforeCursor[atIndex - 1])) {\n      this.deactivate();\n      return;\n    }\n\n    const query = beforeCursor.slice(atIndex + 1);\n    if (/[^\\S\\r\\n]/.test(query)) {\n      this.deactivate();\n      return;\n    }\n\n    this.state.active = true;\n    this.state.triggerPosition = atIndex;\n    this.filter(query);\n  }\n\n  moveUp(): void {\n    if (!this.state.active || this.state.filtered.length === 0) return;\n    this.state.activeIndex =\n      (this.state.activeIndex - 1 + this.state.filtered.length) %\n      this.state.filtered.length;\n    this.emitter.emit('mention-active-change', this.state.activeIndex);\n  }\n\n  moveDown(): void {\n    if (!this.state.active || this.state.filtered.length === 0) return;\n    this.state.activeIndex =\n      (this.state.activeIndex + 1) % this.state.filtered.length;\n    this.emitter.emit('mention-active-change', this.state.activeIndex);\n  }\n\n  selectCurrent(): MentionItem | null {\n    if (!this.state.active || this.state.filtered.length === 0) return null;\n    return this.select(this.state.activeIndex);\n  }\n\n  select(index: number): MentionItem | null {\n    if (index < 0 || index >= this.state.filtered.length) return null;\n    const member = this.state.filtered[index];\n    if (!this.selectedMentions.find((m) => m.id === member.id)) {\n      this.selectedMentions.push(member);\n    }\n    this.emitter.emit('mention-select', member);\n    this.deactivate();\n    return member;\n  }\n\n  deactivate(): void {\n    if (!this.state.active) return;\n    this.state = {\n      active: false,\n      query: '',\n      filtered: [],\n      activeIndex: 0,\n      triggerPosition: -1,\n    };\n    this.emitter.emit('mention-deactivate');\n  }\n\n  parseMentions(text: string): MentionItem[] {\n    const mentions: MentionItem[] = [];\n    const sortedMembers = [...this.members].sort((a, b) => b.name.length - a.name.length);\n\n    for (const member of sortedMembers) {\n      const pattern = new RegExp(`(^|\\\\s)@${this.escapeRegex(member.name)}(?=\\\\s|$|[，。！？,.!?])`, 'u');\n      if (pattern.test(text) && !mentions.find((m) => m.id === member.id)) {\n        mentions.push(member);\n      }\n    }\n\n    return mentions;\n  }\n\n  resetSelected(): void {\n    this.selectedMentions = [];\n  }\n\n  getInsertText(member: MentionItem): string {\n    return `@${member.name} `;\n  }\n\n  private filter(query: string): void {\n    const normalizedQuery = query.trim().toLowerCase();\n    this.state.query = query;\n    this.state.filtered = this.members.filter((member) =>\n      member.name.toLowerCase().includes(normalizedQuery) ||\n      member.id.toLowerCase().includes(normalizedQuery),\n    );\n    this.state.activeIndex = 0;\n    this.emitter.emit('mention-filter', this.getState());\n  }\n\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"mention-engine.js","names":[],"sources":["../../src/core/mention-engine.ts"],"sourcesContent":["/**\r\n * @file mention-engine.ts\r\n * @description mention-engine 模块\r\n */\r\n\r\nimport type { MentionItem } from '../types'\r\nimport type { EventEmitter } from './event-emitter'\r\n\r\n/**\r\n * MentionState interface\r\n */\r\nexport interface MentionState {\r\n  active: boolean\r\n  query: string\r\n  filtered: MentionItem[]\r\n  activeIndex: number\r\n  triggerPosition: number\r\n}\r\n\r\n/**\r\n * MentionEngine 类\r\n */\r\nexport class MentionEngine {\r\n  private members: MentionItem[] = []\r\n  private emitter: EventEmitter\r\n  private state: MentionState = {\r\n    active: false,\r\n    query: '',\r\n    filtered: [],\r\n    activeIndex: 0,\r\n    triggerPosition: -1,\r\n  }\r\n  private selectedMentions: MentionItem[] = []\r\n\r\n  constructor(emitter: EventEmitter, members?: MentionItem[]) {\r\n    this.emitter = emitter\r\n    if (members) this.members = members.map(member => ({ ...member }))\r\n  }\r\n\r\n  getState(): MentionState {\r\n    return {\r\n      ...this.state,\r\n      filtered: [...this.state.filtered],\r\n    }\r\n  }\r\n\r\n  getSelectedMentions(): MentionItem[] {\r\n    return this.selectedMentions.map(member => ({ ...member }))\r\n  }\r\n\r\n  setMembers(members: MentionItem[]): void {\r\n    this.members = members.map(member => ({ ...member }))\r\n    if (this.state.active) {\r\n      this.filter(this.state.query)\r\n    }\r\n  }\r\n\r\n  handleInput(text: string, cursorPos: number): void {\r\n    const beforeCursor = text.slice(0, cursorPos)\r\n    const atIndex = beforeCursor.lastIndexOf('@')\r\n\r\n    if (atIndex === -1) {\r\n      this.deactivate()\r\n      return\r\n    }\r\n\r\n    if (atIndex > 0 && !/\\s/.test(beforeCursor[atIndex - 1])) {\r\n      this.deactivate()\r\n      return\r\n    }\r\n\r\n    const query = beforeCursor.slice(atIndex + 1)\r\n    if (/\\s/.test(query)) {\r\n      this.deactivate()\r\n      return\r\n    }\r\n\r\n    this.state.active = true\r\n    this.state.triggerPosition = atIndex\r\n    this.filter(query)\r\n  }\r\n\r\n  moveUp(): void {\r\n    if (!this.state.active || this.state.filtered.length === 0) return\r\n    this.state.activeIndex =\r\n      (this.state.activeIndex - 1 + this.state.filtered.length) %\r\n      this.state.filtered.length\r\n    this.emitter.emit('mention-active-change', this.state.activeIndex)\r\n  }\r\n\r\n  moveDown(): void {\r\n    if (!this.state.active || this.state.filtered.length === 0) return\r\n    this.state.activeIndex =\r\n      (this.state.activeIndex + 1) % this.state.filtered.length\r\n    this.emitter.emit('mention-active-change', this.state.activeIndex)\r\n  }\r\n\r\n  selectCurrent(): MentionItem | null {\r\n    if (!this.state.active || this.state.filtered.length === 0) return null\r\n    return this.select(this.state.activeIndex)\r\n  }\r\n\r\n  select(index: number): MentionItem | null {\r\n    if (index < 0 || index >= this.state.filtered.length) return null\r\n    const member = this.state.filtered[index]\r\n    if (!this.selectedMentions.some(m => m.id === member.id)) {\r\n      this.selectedMentions.push(member)\r\n    }\r\n    this.emitter.emit('mention-select', member)\r\n    this.deactivate()\r\n    return member\r\n  }\r\n\r\n  deactivate(): void {\r\n    if (!this.state.active) return\r\n    this.state = {\r\n      active: false,\r\n      query: '',\r\n      filtered: [],\r\n      activeIndex: 0,\r\n      triggerPosition: -1,\r\n    }\r\n    this.emitter.emit('mention-deactivate')\r\n  }\r\n\r\n  parseMentions(text: string): MentionItem[] {\r\n    const mentions: MentionItem[] = []\r\n    const sortedMembers = [...this.members].sort(\r\n      (a, b) => b.name.length - a.name.length\r\n    )\r\n\r\n    for (const member of sortedMembers) {\r\n      const pattern = new RegExp(\r\n        `(^|\\\\s)@${this.escapeRegex(member.name)}(?=\\\\s|$|[，。！？,.!?])`,\r\n        'u'\r\n      )\r\n      if (pattern.test(text) && !mentions.some(m => m.id === member.id)) {\r\n        mentions.push({ ...member })\r\n      }\r\n    }\r\n\r\n    return mentions\r\n  }\r\n\r\n  resetSelected(): void {\r\n    this.selectedMentions = []\r\n  }\r\n\r\n  getInsertText(member: MentionItem): string {\r\n    return `@${member.name} `\r\n  }\r\n\r\n  private filter(query: string): void {\r\n    const normalizedQuery = query.trim().toLowerCase()\r\n    this.state.query = query\r\n    this.state.filtered = this.members\r\n      .filter(\r\n        member =>\r\n          member.name.toLowerCase().includes(normalizedQuery) ||\r\n          member.id.toLowerCase().includes(normalizedQuery)\r\n      )\r\n      .map(member => ({ ...member }))\r\n    this.state.activeIndex = 0\r\n    this.emitter.emit('mention-filter', this.getState())\r\n  }\r\n\r\n  private escapeRegex(str: string): string {\r\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/core/message-schema.d.ts

@@ -0,0 +1,19 @@
+import type { ChatContentBlock, ChatMessage } from '../types';
+/**
+ * 归一化消息并复制所有可变字段。
+ *
+ * 该函数是 transport、outbox、ChatManager 共享的边界：外部数据先经过
+ * schema/version 校验，再进入内存状态，避免调用方继续修改内部消息。
+ */
+export declare function normalizeChatMessage(message: ChatMessage): ChatMessage;
+/**
+ * 对来自网络/持久化的 content block 做运行时白名单归一化。
+ * 不认识的块优先使用 fallback 文本，否则丢弃，避免将任意对象带入渲染器。
+ */
+export declare function normalizeChatContentBlocks(blocks: unknown[]): ChatContentBlock[];
+/** 归一化消息集合，并在进入状态层前拒绝重复的消息 ID/client ID。 */
+export declare function normalizeChatMessages(messages: ChatMessage[]): ChatMessage[];
+/** 复制消息，用于事件 payload、outbox 与公开读取，避免可变引用泄漏。 */
+export declare function cloneChatMessage(message: ChatMessage): ChatMessage;
+/** 根据服务端 sequence/timestamp 给出稳定排序值。 */
+export declare function compareChatMessages(left: ChatMessage, right: ChatMessage): number;

package/esm/core/message-schema.js

@@ -0,0 +1,197 @@
+/*!
+* ***********************************
+* @composy/chat-core v0.0.2       *
+* Built with rollup               *
+* Build time: 2024-10-12 21:52:18 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import "../types/index.js";
+//#region src/core/message-schema.ts
+function normalizeChatMessage(message) {
+	if (!message || typeof message !== "object") throw new TypeError("Chat message must be an object.");
+	if (typeof message.id !== "string" || !message.id.trim()) throw new TypeError("Chat message ID must be a non-empty string.");
+	if (!Number.isFinite(message.timestamp)) throw new TypeError("Chat message timestamp must be finite.");
+	const schemaVersion = message.schemaVersion ?? 1;
+	if (schemaVersion > 1) throw new Error(`Unsupported chat message schema version: ${schemaVersion}.`);
+	return cloneChatMessage({
+		...message,
+		schemaVersion: 1,
+		...message.contentBlocks && { contentBlocks: normalizeChatContentBlocks(message.contentBlocks) }
+	});
+}
+function normalizeChatContentBlocks(blocks) {
+	const normalized = [];
+	for (const value of blocks) {
+		const block = normalizeContentBlock(value);
+		if (block) normalized.push(block);
+	}
+	return normalized;
+}
+function normalizeChatMessages(messages) {
+	const result = [];
+	const ids = /* @__PURE__ */ new Set();
+	const clientIds = /* @__PURE__ */ new Set();
+	for (const message of messages) {
+		const normalized = normalizeChatMessage(message);
+		if (ids.has(normalized.id)) throw new Error(`Duplicate chat message ID: ${normalized.id}`);
+		if (normalized.clientMessageId && clientIds.has(normalized.clientMessageId)) throw new Error(`Duplicate chat client message ID: ${normalized.clientMessageId}`);
+		ids.add(normalized.id);
+		if (normalized.clientMessageId) clientIds.add(normalized.clientMessageId);
+		result.push(normalized);
+	}
+	return result;
+}
+function cloneChatMessage(message) {
+	return {
+		...message,
+		sender: cloneUser(message.sender),
+		...message.image && { image: cloneImage(message.image) },
+		...message.file && { file: cloneFile(message.file) },
+		...message.mentions && { mentions: message.mentions.map(cloneMention) },
+		...message.contentBlocks && { contentBlocks: message.contentBlocks.map(cloneContentBlock) },
+		...message.customData && { customData: cloneRecord(message.customData) }
+	};
+}
+function compareChatMessages(left, right) {
+	if (Number.isFinite(left.sequence) && Number.isFinite(right.sequence) && left.sequence !== right.sequence) return left.sequence - right.sequence;
+	if (left.timestamp !== right.timestamp) return left.timestamp - right.timestamp;
+	return left.id.localeCompare(right.id);
+}
+function cloneContentBlock(block) {
+	switch (block.type) {
+		case "text": return {
+			type: "text",
+			text: block.text
+		};
+		case "mention": return {
+			type: "mention",
+			id: block.id,
+			label: block.label
+		};
+		case "link": return {
+			type: "link",
+			url: block.url,
+			...block.label && { label: block.label }
+		};
+		case "code": return {
+			type: "code",
+			code: block.code,
+			...block.language && { language: block.language }
+		};
+		case "image": return {
+			type: "image",
+			src: block.src,
+			...block.alt && { alt: block.alt },
+			...block.width !== void 0 && { width: block.width },
+			...block.height !== void 0 && { height: block.height }
+		};
+		case "file": return {
+			type: "file",
+			url: block.url,
+			name: block.name,
+			...block.size !== void 0 && { size: block.size },
+			...block.mimeType && { mimeType: block.mimeType }
+		};
+		case "break": return { type: "break" };
+		case "custom": return {
+			type: "custom",
+			kind: block.kind,
+			data: cloneRecord(block.data),
+			...block.fallback && { fallback: block.fallback }
+		};
+	}
+}
+function normalizeContentBlock(value) {
+	if (!isRecord(value) || typeof value.type !== "string") return null;
+	switch (value.type) {
+		case "text": return typeof value.text === "string" ? {
+			type: "text",
+			text: value.text
+		} : null;
+		case "mention": return typeof value.id === "string" && typeof value.label === "string" ? {
+			type: "mention",
+			id: value.id,
+			label: value.label
+		} : null;
+		case "link": return typeof value.url === "string" ? {
+			type: "link",
+			url: value.url,
+			...typeof value.label === "string" && { label: value.label }
+		} : null;
+		case "code": return typeof value.code === "string" ? {
+			type: "code",
+			code: value.code,
+			...typeof value.language === "string" && { language: value.language }
+		} : null;
+		case "image": return typeof value.src === "string" ? {
+			type: "image",
+			src: value.src,
+			...typeof value.alt === "string" && { alt: value.alt },
+			...isPositiveNumber(value.width) && { width: value.width },
+			...isPositiveNumber(value.height) && { height: value.height }
+		} : null;
+		case "file": return typeof value.url === "string" && typeof value.name === "string" ? {
+			type: "file",
+			url: value.url,
+			name: value.name,
+			...isPositiveNumber(value.size) && { size: value.size },
+			...typeof value.mimeType === "string" && { mimeType: value.mimeType }
+		} : null;
+		case "break": return { type: "break" };
+		case "custom": return typeof value.kind === "string" && isRecord(value.data) ? {
+			type: "custom",
+			kind: value.kind,
+			data: cloneRecord(value.data),
+			...typeof value.fallback === "string" && { fallback: value.fallback }
+		} : fallbackBlock(value);
+		default: return fallbackBlock(value);
+	}
+}
+function fallbackBlock(value) {
+	return typeof value.fallback === "string" ? {
+		type: "text",
+		text: value.fallback
+	} : null;
+}
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isPositiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function cloneUser(user) {
+	return { ...user };
+}
+function cloneMention(mention) {
+	return { ...mention };
+}
+function cloneImage(image) {
+	return { ...image };
+}
+function cloneFile(file) {
+	return { ...file };
+}
+function cloneRecord(value, seen = /* @__PURE__ */ new WeakMap()) {
+	if (!value || typeof value !== "object") return value;
+	if (seen.has(value)) return seen.get(value);
+	if (Array.isArray(value)) {
+		const clone2 = [];
+		seen.set(value, clone2);
+		value.forEach((item) => clone2.push(cloneRecord(item, seen)));
+		return clone2;
+	}
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) return value;
+	const clone = {};
+	seen.set(value, clone);
+	Object.entries(value).forEach(([key, item]) => {
+		clone[key] = cloneRecord(item, seen);
+	});
+	return clone;
+}
+//#endregion
+export { cloneChatMessage, compareChatMessages, normalizeChatContentBlocks, normalizeChatMessage, normalizeChatMessages };
+/*! End of @composy/chat-core | Powered by @composy/builder */
+//# sourceMappingURL=message-schema.js.map

package/esm/core/message-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-schema.js","names":["clone"],"sources":["../../src/core/message-schema.ts"],"sourcesContent":["import type {\n  ChatContentBlock,\n  ChatMessage,\n  ChatUser,\n  FileAttachment,\n  ImageAttachment,\n  MentionItem,\n} from '../types'\nimport { CHAT_MESSAGE_SCHEMA_VERSION } from '../types'\n\n/**\n * 归一化消息并复制所有可变字段。\n *\n * 该函数是 transport、outbox、ChatManager 共享的边界：外部数据先经过\n * schema/version 校验，再进入内存状态，避免调用方继续修改内部消息。\n */\nexport function normalizeChatMessage(message: ChatMessage): ChatMessage {\n  if (!message || typeof message !== 'object') {\n    throw new TypeError('Chat message must be an object.')\n  }\n  if (typeof message.id !== 'string' || !message.id.trim()) {\n    throw new TypeError('Chat message ID must be a non-empty string.')\n  }\n  if (!Number.isFinite(message.timestamp)) {\n    throw new TypeError('Chat message timestamp must be finite.')\n  }\n  const schemaVersion = message.schemaVersion ?? CHAT_MESSAGE_SCHEMA_VERSION\n  if (schemaVersion > CHAT_MESSAGE_SCHEMA_VERSION) {\n    throw new Error(\n      `Unsupported chat message schema version: ${schemaVersion}.`\n    )\n  }\n\n  return cloneChatMessage({\n    ...message,\n    schemaVersion: CHAT_MESSAGE_SCHEMA_VERSION,\n    ...(message.contentBlocks && {\n      contentBlocks: normalizeChatContentBlocks(message.contentBlocks),\n    }),\n  })\n}\n\n/**\n * 对来自网络/持久化的 content block 做运行时白名单归一化。\n * 不认识的块优先使用 fallback 文本，否则丢弃，避免将任意对象带入渲染器。\n */\nexport function normalizeChatContentBlocks(\n  blocks: unknown[]\n): ChatContentBlock[] {\n  const normalized: ChatContentBlock[] = []\n  for (const value of blocks) {\n    const block = normalizeContentBlock(value)\n    if (block) normalized.push(block)\n  }\n  return normalized\n}\n\n/** 归一化消息集合，并在进入状态层前拒绝重复的消息 ID/client ID。 */\nexport function normalizeChatMessages(messages: ChatMessage[]): ChatMessage[] {\n  const result: ChatMessage[] = []\n  const ids = new Set<string>()\n  const clientIds = new Set<string>()\n  for (const message of messages) {\n    const normalized = normalizeChatMessage(message)\n    if (ids.has(normalized.id)) {\n      throw new Error(`Duplicate chat message ID: ${normalized.id}`)\n    }\n    if (\n      normalized.clientMessageId &&\n      clientIds.has(normalized.clientMessageId)\n    ) {\n      throw new Error(\n        `Duplicate chat client message ID: ${normalized.clientMessageId}`\n      )\n    }\n    ids.add(normalized.id)\n    if (normalized.clientMessageId) clientIds.add(normalized.clientMessageId)\n    result.push(normalized)\n  }\n  return result\n}\n\n/** 复制消息，用于事件 payload、outbox 与公开读取，避免可变引用泄漏。 */\nexport function cloneChatMessage(message: ChatMessage): ChatMessage {\n  return {\n    ...message,\n    sender: cloneUser(message.sender),\n    ...(message.image && { image: cloneImage(message.image) }),\n    ...(message.file && { file: cloneFile(message.file) }),\n    ...(message.mentions && {\n      mentions: message.mentions.map(cloneMention),\n    }),\n    ...(message.contentBlocks && {\n      contentBlocks: message.contentBlocks.map(cloneContentBlock),\n    }),\n    ...(message.customData && {\n      customData: cloneRecord(message.customData),\n    }),\n  }\n}\n\n/** 根据服务端 sequence/timestamp 给出稳定排序值。 */\nexport function compareChatMessages(left: ChatMessage, right: ChatMessage) {\n  if (\n    Number.isFinite(left.sequence) &&\n    Number.isFinite(right.sequence) &&\n    left.sequence !== right.sequence\n  ) {\n    return (left.sequence as number) - (right.sequence as number)\n  }\n  if (left.timestamp !== right.timestamp)\n    return left.timestamp - right.timestamp\n  return left.id.localeCompare(right.id)\n}\n\nfunction cloneContentBlock(block: ChatContentBlock): ChatContentBlock {\n  switch (block.type) {\n    case 'text':\n      return { type: 'text', text: block.text }\n    case 'mention':\n      return { type: 'mention', id: block.id, label: block.label }\n    case 'link':\n      return {\n        type: 'link',\n        url: block.url,\n        ...(block.label && { label: block.label }),\n      }\n    case 'code':\n      return {\n        type: 'code',\n        code: block.code,\n        ...(block.language && { language: block.language }),\n      }\n    case 'image':\n      return {\n        type: 'image',\n        src: block.src,\n        ...(block.alt && { alt: block.alt }),\n        ...(block.width !== undefined && { width: block.width }),\n        ...(block.height !== undefined && { height: block.height }),\n      }\n    case 'file':\n      return {\n        type: 'file',\n        url: block.url,\n        name: block.name,\n        ...(block.size !== undefined && { size: block.size }),\n        ...(block.mimeType && { mimeType: block.mimeType }),\n      }\n    case 'break':\n      return { type: 'break' }\n    case 'custom':\n      return {\n        type: 'custom',\n        kind: block.kind,\n        data: cloneRecord(block.data),\n        ...(block.fallback && { fallback: block.fallback }),\n      }\n  }\n}\n\nfunction normalizeContentBlock(value: unknown): ChatContentBlock | null {\n  if (!isRecord(value) || typeof value.type !== 'string') return null\n  switch (value.type) {\n    case 'text':\n      return typeof value.text === 'string'\n        ? { type: 'text', text: value.text }\n        : null\n    case 'mention':\n      return typeof value.id === 'string' && typeof value.label === 'string'\n        ? { type: 'mention', id: value.id, label: value.label }\n        : null\n    case 'link':\n      return typeof value.url === 'string'\n        ? {\n            type: 'link',\n            url: value.url,\n            ...(typeof value.label === 'string' && { label: value.label }),\n          }\n        : null\n    case 'code':\n      return typeof value.code === 'string'\n        ? {\n            type: 'code',\n            code: value.code,\n            ...(typeof value.language === 'string' && {\n              language: value.language,\n            }),\n          }\n        : null\n    case 'image':\n      return typeof value.src === 'string'\n        ? {\n            type: 'image',\n            src: value.src,\n            ...(typeof value.alt === 'string' && { alt: value.alt }),\n            ...(isPositiveNumber(value.width) && { width: value.width }),\n            ...(isPositiveNumber(value.height) && { height: value.height }),\n          }\n        : null\n    case 'file':\n      return typeof value.url === 'string' && typeof value.name === 'string'\n        ? {\n            type: 'file',\n            url: value.url,\n            name: value.name,\n            ...(isPositiveNumber(value.size) && { size: value.size }),\n            ...(typeof value.mimeType === 'string' && {\n              mimeType: value.mimeType,\n            }),\n          }\n        : null\n    case 'break':\n      return { type: 'break' }\n    case 'custom':\n      return typeof value.kind === 'string' && isRecord(value.data)\n        ? {\n            type: 'custom',\n            kind: value.kind,\n            data: cloneRecord(value.data),\n            ...(typeof value.fallback === 'string' && {\n              fallback: value.fallback,\n            }),\n          }\n        : fallbackBlock(value)\n    default:\n      return fallbackBlock(value)\n  }\n}\n\nfunction fallbackBlock(\n  value: Record<string, unknown>\n): ChatContentBlock | null {\n  return typeof value.fallback === 'string'\n    ? { type: 'text', text: value.fallback }\n    : null\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction isPositiveNumber(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value) && value > 0\n}\n\nfunction cloneUser(user: ChatUser): ChatUser {\n  return { ...user }\n}\n\nfunction cloneMention(mention: MentionItem): MentionItem {\n  return { ...mention }\n}\n\nfunction cloneImage(image: ImageAttachment): ImageAttachment {\n  return { ...image }\n}\n\nfunction cloneFile(file: FileAttachment): FileAttachment {\n  return { ...file }\n}\n\nfunction cloneRecord<T>(value: T, seen = new WeakMap<object, unknown>()): T {\n  if (!value || typeof value !== 'object') return value\n  if (seen.has(value)) return seen.get(value) as T\n  if (Array.isArray(value)) {\n    const clone: unknown[] = []\n    seen.set(value, clone)\n    value.forEach(item => clone.push(cloneRecord(item, seen)))\n    return clone as T\n  }\n\n  const prototype = Object.getPrototypeOf(value)\n  if (prototype !== Object.prototype && prototype !== null) return value\n  const clone: Record<string, unknown> = {}\n  seen.set(value, clone)\n  Object.entries(value).forEach(([key, item]) => {\n    clone[key] = cloneRecord(item, seen)\n  })\n  return clone as T\n}\n"],"mappings":"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"}

package/esm/core/outbox.d.ts

@@ -0,0 +1,63 @@
+import type { ChatMessage } from '../types';
+/** 离线 outbox 中的一条待发送消息。 */
+export interface ChatOutboxEntry {
+    id: string;
+    message: ChatMessage;
+    enqueuedAt: number;
+    attempts: number;
+    state: 'pending' | 'failed';
+    lastError?: string;
+}
+/** outbox 持久化适配器；可接 IndexedDB、SQLite bridge 或业务缓存。 */
+export interface ChatOutboxStorage {
+    load: () => ChatOutboxEntry[] | Promise<ChatOutboxEntry[]>;
+    save: (entries: ChatOutboxEntry[]) => void | Promise<void>;
+}
+/** 内存适配器，适合默认运行和单元测试。 */
+export declare class MemoryChatOutboxStorage implements ChatOutboxStorage {
+    private entries;
+    load(): ChatOutboxEntry[];
+    save(entries: ChatOutboxEntry[]): void;
+}
+export interface ChatOutboxOptions {
+    storage?: ChatOutboxStorage;
+    now?: () => number;
+}
+export interface ChatOutboxFlushOptions {
+    signal?: AbortSignal;
+    maxAttempts?: number;
+    concurrency?: number;
+}
+export interface ChatOutboxFlushResult {
+    sent: string[];
+    failed: Array<{
+        id: string;
+        error: unknown;
+    }>;
+    remaining: ChatOutboxEntry[];
+}
+/**
+ * 幂等离线队列。
+ *
+ * 队列只负责保存和重试，不假设网络协议；发送函数由 ChatTransportController
+ * 或业务层注入。每条消息以 clientMessageId 优先作为幂等键，重复 enqueue 不会产生重复项。
+ */
+export declare class ChatOutbox {
+    private readonly storage;
+    private readonly now;
+    private entries;
+    private hydrated;
+    private writePromise;
+    constructor(options?: ChatOutboxOptions);
+    hydrate(): Promise<ChatOutboxEntry[]>;
+    list(): ChatOutboxEntry[];
+    enqueue(message: ChatMessage): Promise<ChatOutboxEntry>;
+    remove(id: string): Promise<boolean>;
+    retry(id?: string): Promise<void>;
+    clear(): Promise<void>;
+    flush(send: (message: ChatMessage, options: {
+        signal?: AbortSignal;
+        clientMessageId: string;
+    }) => Promise<unknown>, options?: ChatOutboxFlushOptions): Promise<ChatOutboxFlushResult>;
+    private persist;
+}