@composy/chat-core 0.0.1 → 0.0.2

package/lib/core/chat-manager.d.cts

@@ -0,0 +1,45 @@
+import type { ChatMessage, MessageStatus } from '../types';
+import type { EventEmitter } from './event-emitter';
+export type MessageMergeResult = 'added' | 'updated' | 'ignored';
+export interface MessageMergeOptions {
+    sequence?: number;
+    source?: 'local' | 'remote';
+}
+export interface StreamAppendOptions {
+    generation?: string;
+    sequence?: number;
+}
+/** ChatManager - 聊天消息状态、幂等合并和流式 generation 管理。 */
+export declare class ChatManager {
+    private messages;
+    private readonly emitter;
+    private readonly streams;
+    constructor(emitter: EventEmitter, initialMessages?: ChatMessage[]);
+    getMessages(): ChatMessage[];
+    getMessage(id: string): ChatMessage | undefined;
+    getMessageIdByClientMessageId(clientMessageId: string): string | undefined;
+    addMessage(message: ChatMessage): void;
+    prependMessages(messages: ChatMessage[]): void;
+    /** 合并本地 ack 或远端推送，按 id/clientMessageId 去重并拒绝旧 sequence。 */
+    upsertMessage(message: ChatMessage, options?: MessageMergeOptions): MessageMergeResult;
+    mergeMessages(messages: ChatMessage[], options?: MessageMergeOptions): {
+        added: number;
+        updated: number;
+        ignored: number;
+    };
+    updateMessage(id: string, updates: Partial<ChatMessage>): void;
+    markMessageStatus(id: string, status: MessageStatus): void;
+    removeMessage(id: string): void;
+    setMessages(messages: ChatMessage[]): void;
+    clearMessages(): void;
+    beginStreaming(id: string, generation?: string): string | null;
+    appendMessageContent(id: string, chunk: string, options?: StreamAppendOptions): boolean;
+    finishStreaming(id: string, generation?: string): boolean;
+    cancelStreaming(id: string, generation?: string): boolean;
+    getStreamGeneration(id: string): string | undefined;
+    private findMessageIndex;
+    private assertUniqueIds;
+    private assertUniqueClientMessageId;
+    private emitAdded;
+    private emitChanged;
+}

package/lib/core/chat-manager.d.ts

@@ -1,34 +1,45 @@
-/**
- * 聊天管理器 - 消息增删改查、状态管理
- */
-import type { ChatMessage } from '../types';
-import { EventEmitter } from './event-emitter';
-/**
- * ChatManager - Chat Manager class
- */
+import type { ChatMessage, MessageStatus } from '../types';
+import type { EventEmitter } from './event-emitter';
+export type MessageMergeResult = 'added' | 'updated' | 'ignored';
+export interface MessageMergeOptions {
+    sequence?: number;
+    source?: 'local' | 'remote';
+}
+export interface StreamAppendOptions {
+    generation?: string;
+    sequence?: number;
+}
+/** ChatManager - 聊天消息状态、幂等合并和流式 generation 管理。 */
 export declare class ChatManager {
     private messages;
-    private emitter;
+    private readonly emitter;
+    private readonly streams;
     constructor(emitter: EventEmitter, initialMessages?: ChatMessage[]);
-    /** 获取所有消息 */
     getMessages(): ChatMessage[];
-    /** 根据 ID 获取消息 */
     getMessage(id: string): ChatMessage | undefined;
-    /** 添加消息（末尾追加） */
+    getMessageIdByClientMessageId(clientMessageId: string): string | undefined;
     addMessage(message: ChatMessage): void;
-    /** 在顶部批量插入消息（用于加载更多） */
     prependMessages(messages: ChatMessage[]): void;
-    /** 更新消息 */
+    /** 合并本地 ack 或远端推送，按 id/clientMessageId 去重并拒绝旧 sequence。 */
+    upsertMessage(message: ChatMessage, options?: MessageMergeOptions): MessageMergeResult;
+    mergeMessages(messages: ChatMessage[], options?: MessageMergeOptions): {
+        added: number;
+        updated: number;
+        ignored: number;
+    };
     updateMessage(id: string, updates: Partial<ChatMessage>): void;
-    /** 删除消息 */
+    markMessageStatus(id: string, status: MessageStatus): void;
     removeMessage(id: string): void;
-    /** 替换全部消息 */
     setMessages(messages: ChatMessage[]): void;
-    /** 清空所有消息 */
     clearMessages(): void;
-    /** 追加流式消息内容 */
-    appendMessageContent(id: string, chunk: string): void;
-    /** 完成流式消息 */
-    finishStreaming(id: string): void;
+    beginStreaming(id: string, generation?: string): string | null;
+    appendMessageContent(id: string, chunk: string, options?: StreamAppendOptions): boolean;
+    finishStreaming(id: string, generation?: string): boolean;
+    cancelStreaming(id: string, generation?: string): boolean;
+    getStreamGeneration(id: string): string | undefined;
+    private findMessageIndex;
+    private assertUniqueIds;
+    private assertUniqueClientMessageId;
+    private emitAdded;
+    private emitChanged;
 }
-//# sourceMappingURL=chat-manager.d.ts.map

package/lib/core/event-emitter.cjs

@@ -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,8 +20,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);
 	}
 	/**
@@ -30,7 +34,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);
 	}
 	/**
 	* 触发（发射）指定事件，依次调用所有已注册的监听器
@@ -38,7 +45,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) {
@@ -66,7 +73,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/lib/core/event-emitter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-emitter.cjs","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.cjs","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/lib/core/event-emitter.d.cts

@@ -0,0 +1,47 @@
+/**
+ * 轻量事件总线
+ * 提供发布/订阅模式的事件管理功能，支持事件的注册、注销、触发等操作
+ */
+type Handler = (...args: unknown[]) => void;
+/**
+ * EventEmitter - 事件发射器类
+ * 实现了经典的发布/订阅（Pub/Sub）模式，用于模块间的解耦通信
+ * 支持：一次性监听、批量移除、自动清理等功能
+ */
+export declare class EventEmitter {
+    private listeners;
+    /**
+     * 注册事件监听器
+     * @param event - 要监听的事件名称
+     * @param handler - 事件触发时执行的回调函数
+     * @returns 返回一个取消订阅的函数，调用即可移除该监听器
+     */
+    on(event: string, handler: Handler): () => void;
+    /**
+     * 移除指定事件的某个监听器
+     * @param event - 事件名称
+     * @param handler - 要移除的处理函数引用（必须与注册时为同一函数引用）
+     */
+    off(event: string, handler: Handler): void;
+    /**
+     * 触发（发射）指定事件，依次调用所有已注册的监听器
+     * @param event - 要触发的事件名称
+     * @param args - 传递给监听器函数的参数列表（剩余参数语法）
+     */
+    emit(event: string, ...args: unknown[]): void;
+    /**
+     * 注册一次性事件监听器（触发一次后自动移除）
+     * @param event - 要监听的事件名称
+     * @param handler - 事件触发时执行的回调函数
+     * @returns 返回取消订阅的函数，可在触发前手动取消
+     */
+    once(event: string, handler: Handler): () => void;
+    /**
+     * 批量移除事件监听器
+     * @param event - 可选的事件名称
+     *   - 若传入事件名，则只移除该事件的所有监听器
+     *   - 若不传参数，则清空所有事件的所有监听器
+     */
+    removeAll(event?: string): void;
+}
+export {};

package/lib/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/lib/core/mention-engine.cjs

@@ -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                    *
 * ***********************************
@@ -21,7 +21,7 @@ var MentionEngine = class {
 		};
 		this.selectedMentions = [];
 		this.emitter = emitter;
-		if (members) this.members = [...members];
+		if (members) this.members = members.map((member) => ({ ...member }));
 	}
 	getState() {
 		return {
@@ -30,10 +30,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) {
@@ -48,7 +48,7 @@ var MentionEngine = class {
 			return;
 		}
 		const query = beforeCursor.slice(atIndex + 1);
-		if (/[^\S\r\n]/.test(query)) {
+		if (/\s/.test(query)) {
 			this.deactivate();
 			return;
 		}
@@ -73,7 +73,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;
@@ -92,7 +92,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() {
@@ -104,7 +104,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/lib/core/mention-engine.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mention-engine.cjs","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.cjs","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/lib/core/mention-engine.d.cts

@@ -0,0 +1,40 @@
+/**
+ * @file mention-engine.ts
+ * @description mention-engine 模块
+ */
+import type { MentionItem } from '../types';
+import type { EventEmitter } from './event-emitter';
+/**
+ * MentionState interface
+ */
+export interface MentionState {
+    active: boolean;
+    query: string;
+    filtered: MentionItem[];
+    activeIndex: number;
+    triggerPosition: number;
+}
+/**
+ * MentionEngine 类
+ */
+export declare class MentionEngine {
+    private members;
+    private emitter;
+    private state;
+    private selectedMentions;
+    constructor(emitter: EventEmitter, members?: MentionItem[]);
+    getState(): MentionState;
+    getSelectedMentions(): MentionItem[];
+    setMembers(members: MentionItem[]): void;
+    handleInput(text: string, cursorPos: number): void;
+    moveUp(): void;
+    moveDown(): void;
+    selectCurrent(): MentionItem | null;
+    select(index: number): MentionItem | null;
+    deactivate(): void;
+    parseMentions(text: string): MentionItem[];
+    resetSelected(): void;
+    getInsertText(member: MentionItem): string;
+    private filter;
+    private escapeRegex;
+}

package/lib/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/lib/core/message-schema.cjs

@@ -0,0 +1,202 @@
+/*!
+* ***********************************
+* @composy/chat-core v0.0.2       *
+* Built with rollup               *
+* Build time: 2024-10-12 21:52:18 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../types/index.cjs");
+//#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
+exports.cloneChatMessage = cloneChatMessage;
+exports.compareChatMessages = compareChatMessages;
+exports.normalizeChatContentBlocks = normalizeChatContentBlocks;
+exports.normalizeChatMessage = normalizeChatMessage;
+exports.normalizeChatMessages = normalizeChatMessages;
+/*! End of @composy/chat-core | Powered by @composy/builder */
+//# sourceMappingURL=message-schema.cjs.map