@icen.ai/ui 0.8.1 → 0.10.0

package/dist/behaviors/kb-chunks.d.mts

@@ -0,0 +1,31 @@
+import { KbChunk } from './kb-core.js';
+import './ai-core.js';
+
+/** 搜索输入契约 */
+type KbChunkSearchMode = 'text' | 'vector';
+/** renderKbChunks 选项 */
+interface KbChunksOpts {
+    /** 新增 chunk 归属的文档（add 事件 detail）；缺省取首个 chunk 的 documentId */
+    documentId?: string;
+    /** 搜索条模式初值（缺省 'text' 全文） */
+    searchMode?: KbChunkSearchMode;
+    /** 搜索条初值（同时用于本地过滤） */
+    query?: string;
+    /** 搜索框占位文案 */
+    placeholder?: string;
+    /** 空态文案 */
+    emptyText?: string;
+}
+/**
+ * 渲染 chunk 编辑器（快照：整树重建后返回挂载容器 el）。
+ * chunks 经 kb-core normalizeChunk 宽进严出；空数组给空态。SSR（无 document）下原样返回 el。
+ */
+declare function renderKbChunks(el: HTMLElement, chunks: KbChunk[], opts?: KbChunksOpts): HTMLElement;
+/**
+ * 接线 chunk 行内编辑 / 启停 / 关键词 / 增删 / 搜索（scope 级事件委托，重复调用幂等）。
+ * root 缺省 document：页面一次 init 即接管后续插入的 chunk 列表。
+ * 返回销毁函数：摘除全部委托并复位幂等标记，销毁后可重新 initKbChunks。SSR 下 no-op。
+ */
+declare function initKbChunks(root?: ParentNode): () => void;
+
+export { type KbChunkSearchMode, type KbChunksOpts, initKbChunks, renderKbChunks };