@ibiz-template-plugin/ai-chat 0.0.123 → 0.0.125

package/dist/types/components/chat-net-disk/chat-net-disk.d.ts

@@ -1,6 +1,11 @@
 import { FileSystemController } from '../../controller';
 
 interface ChatNetDiskProps {
+    /**
+     * @description 控制器
+     * @type {FileSystemController}
+     * @memberof ChatNetDiskProps
+     */
     controller: FileSystemController;
 }
 export declare const ChatNetDisk: (props: ChatNetDiskProps) => import("preact").JSX.Element;

package/dist/types/components/chat-net-disk/file-move-panel/file-move-panel.d.ts

@@ -1,5 +1,5 @@
 import { FileSystemController } from '../../../controller';
-import { LazyTreeNode } from '../../common';
+import { ITreeNode } from '../../../interface';
 
 interface FileMovePanelProps {
     /**
@@ -7,7 +7,7 @@ interface FileMovePanelProps {
      * @type {IFile}
      * @memberof FileMovePanelProps
      */
-    data: LazyTreeNode;
+    data: ITreeNode;
     /**
      * @description 系统文件控制器
      * @type {FileSystemController}

package/dist/types/components/common/actions/actions.d.ts

@@ -2,10 +2,12 @@ import { VNode } from 'preact';
 
 export interface IAction {
     id: string;
-    icon: VNode;
+    icon?: VNode;
     caption: string;
-    visible?: (data?: any) => boolean | boolean;
+    visible?: boolean | ((data?: any) => boolean);
+    disabled?: boolean | ((data?: any) => boolean);
     onClick?: (event: MouseEvent, data?: any) => void;
+    clickClose?: boolean;
 }
 interface ActionsProps {
     /**

package/dist/types/components/common/context-menu/context-menu.d.ts

@@ -1,7 +1,6 @@
 import { IAction } from '../actions/actions';
 
 export interface IContextMenuAction extends IAction {
-    clickClose?: boolean;
 }
 interface ContextMenuProps {
     /**

package/dist/types/components/common/lazy-level-list/lazy-level-list.d.ts

@@ -1,37 +1,38 @@
-import { INodeEditInfo, LazyTreeNode } from '../lazy-tree/lazy-tree';
+import { INodeEditInfo } from '../lazy-tree/lazy-tree';
 import { IAction } from '../actions/actions';
+import { ITreeNode } from '../../../interface';
 
 export type LazyLevelListMode = 'list' | 'card';
 interface LazyLevelListProps {
     /**
-     * 根节点数据
+     * 节点数据
      */
-    nodes: LazyTreeNode[];
+    nodes: ITreeNode[];
     /**
      * 异步加载子节点方法
      * 返回子节点数组
      */
-    lazyLoad?: (node: LazyTreeNode) => Promise<LazyTreeNode[]>;
+    lazyLoad?: (node: ITreeNode) => Promise<ITreeNode[]>;
     /**
      * 节点选中回调
      */
-    onNodeCheck?: (node: LazyTreeNode, checked: boolean) => void;
+    onNodeCheck?: (node: ITreeNode, checked: boolean) => void;
     /**
      * 节点点击回调
      */
-    onNodeClick?: (node: LazyTreeNode, event: MouseEvent) => void;
+    onNodeClick?: (event: MouseEvent, node: ITreeNode) => void;
     /**
      * 节点展开回调
      */
-    onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    onNodeExpand?: (node: ITreeNode, expanded: boolean) => void;
     /**
      * 路径变化回调，用于父组件同步面包屑
      */
-    onPathChange?: (path: LazyTreeNode[]) => void;
+    onPathChange?: (path: ITreeNode[]) => void;
     /**
      * 受控路径（根 -> 当前层），由父组件传入
      */
-    path?: LazyTreeNode[];
+    path?: ITreeNode[];
     /**
      * 是否显示搜索框
      * @default true
@@ -46,11 +47,6 @@ interface LazyLevelListProps {
      * @default true
      */
     highlight?: boolean;
-    /**
-     * 标识分隔符
-     * @default '/'
-     */
-    separator?: string;
     /**
      * 过滤值
      */
@@ -84,6 +80,12 @@ interface LazyLevelListProps {
      * @default 'list'
      */
     mode?: LazyLevelListMode;
+    /**
+     * 节点过滤
+     * @param node
+     * @returns
+     */
+    filterNodeMethod?: (node: ITreeNode) => boolean;
 }
 export interface LazyLevelListRef {
     /**
@@ -91,7 +93,7 @@ export interface LazyLevelListRef {
      * @param
      * @returns
      */
-    overloadNode: (node: LazyTreeNode) => Promise<void>;
+    overloadNode: (node: ITreeNode) => Promise<void>;
 }
 export declare const LazyLevelList: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<LazyLevelListProps> & {
     ref?: import('preact').Ref<LazyLevelListRef> | undefined;

package/dist/types/components/common/lazy-tree/lazy-tree.d.ts

@@ -1,64 +1,7 @@
 import { VNode } from 'preact';
 import { IAction } from '../actions/actions';
+import { ITreeNode } from '../../../interface';
 
-export interface LazyTreeNode {
-    /**
-     * 节点唯一标识
-     */
-    id: string;
-    /**
-     * 节点显示文本
-     */
-    label: string;
-    /**
-     * 是否叶子节点
-     */
-    isLeaf: boolean;
-    /**
-     * 子节点
-     */
-    children?: LazyTreeNode[];
-    /**
-     * 是否已加载子节点
-     */
-    loaded?: boolean;
-    /**
-     * 是否展开
-     */
-    expanded?: boolean;
-    /**
-     * 是否正在加载
-     */
-    loading?: boolean;
-    /**
-     * 父节点标识
-     */
-    parentId?: string;
-    /**
-     * 节点深度
-     */
-    depth?: number;
-    /**
-     * 自定义图标
-     */
-    icon?: string;
-    /**
-     * 原始数据
-     */
-    data: Record<string, any>;
-    /**
-     * 根节点标识
-     */
-    rootId: string;
-    /**
-     * 根节点
-     */
-    isRoot?: boolean;
-    /**
-     * 是否显示
-     */
-    visible?: boolean;
-}
 export interface INodeEditInfo {
     /**
      * @description 图标
@@ -86,41 +29,41 @@ export interface INodeEditInfo {
     type: 'draft' | 'edit';
     /**
      * @description 草稿的父节点 | 编辑节点
-     * @type {LazyTreeNode}
+     * @type {ITreeNode}
      * @memberof INodeEditInfo
      */
-    node: LazyTreeNode;
+    node: ITreeNode;
 }
 interface LazyTreeProps {
     /**
      * 根节点数据
      */
-    nodes: LazyTreeNode[];
+    nodes: ITreeNode[];
     /**
      * 异步加载子节点方法
      * 返回子节点数组
      */
-    lazyLoad?: (node: LazyTreeNode) => Promise<LazyTreeNode[]>;
+    lazyLoad?: (node: ITreeNode) => Promise<ITreeNode[]>;
     /**
      * 节点点击回调
      */
-    onNodeClick?: (node: LazyTreeNode, event: MouseEvent) => void;
+    onNodeClick?: (event: MouseEvent, node: ITreeNode) => void;
     /**
      * 节点选中回调
      */
-    onNodeCheck?: (node: LazyTreeNode, checked: boolean) => void;
+    onNodeCheck?: (node: ITreeNode, checked: boolean) => void;
     /**
      * 节点展开回调
      */
-    onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    onNodeExpand?: (node: ITreeNode, expanded: boolean) => void;
     /**
      * 当前活动路径变化回调（用户最后点击/展开的路径）
      */
-    onActivePathChange?: (path: LazyTreeNode[]) => void;
+    onActivePathChange?: (path: ITreeNode[]) => void;
     /**
      * 当前激活路径
      */
-    activePath?: LazyTreeNode[];
+    activePath?: ITreeNode[];
     /**
      * 是否显示搜索框
      * @default true
@@ -145,11 +88,6 @@ interface LazyTreeProps {
      * @default true
      */
     expandOnClickNode?: boolean;
-    /**
-     * 标识分隔符
-     * @default '/'
-     */
-    separator?: string;
     /**
      * 过滤值
      */
@@ -178,15 +116,21 @@ interface LazyTreeProps {
      * @returns
      */
     onCancel?: () => void;
+    /**
+     * 节点过滤
+     * @param node
+     * @returns
+     */
+    filterNodeMethod?: (node: ITreeNode) => boolean;
 }
 export interface LazyTreeRef {
     /**
      * @description 重载节点
-     * @param {LazyTreeNode} node 需要重载的节点
+     * @param {ITreeNode} node 需要重载的节点
      * @param {boolean} isParent 是否重载父节点，默认为false
      * @memberof LazyTreeRef
      */
-    overloadNode: (node: LazyTreeNode, isParent?: boolean) => Promise<void>;
+    overloadNode: (node: ITreeNode, isParent?: boolean) => Promise<void>;
 }
 /**
  * 懒加载树组件

package/dist/types/components/popup/popup.d.ts

@@ -1,20 +1,24 @@
-import { VNode } from 'preact';
+import { ComponentChildren } from 'preact';
+import { IAction } from '../common/actions/actions';
 
 type Position = 'top' | 'bottom' | 'left' | 'right' | 'top-left';
-interface ActionItem {
-    id: string;
-    caption: string;
-    icon?: VNode;
+interface IActionItem extends IAction {
+    position?: Position;
+    children?: IActionItem[];
+    triggerMode?: 'click' | 'hover';
+    content?: ComponentChildren;
+    popupClassName?: string;
 }
-export declare const Popup: ({ triggerMode, children, actions, content, disabled, position, isOpen: isOpenProp, onToggleOpen, popupClassName, onAction, }: {
+export declare const Popup: ({ data, triggerMode, children, actions, content, disabled, position, isOpen: isOpenProp, onToggleOpen, popupClassName, onAction, }: {
     triggerMode: "click" | "hover";
-    children: import('preact').ComponentChildren;
-    actions?: ActionItem[];
-    content?: import('preact').ComponentChildren;
+    children: ComponentChildren;
+    actions?: IActionItem[];
+    content?: ComponentChildren;
     position?: Position;
     isOpen?: boolean;
     popupClassName?: string;
     disabled?: boolean;
+    data?: any;
     onToggleOpen?: (isOpen: boolean) => void;
     onAction?: (actionId: string, event: MouseEvent) => void;
 }) => import("preact").JSX.Element;

package/dist/types/controller/file-system/file-system.controller.d.ts

@@ -1,4 +1,4 @@
-import { IFile, IFileItem, IMessageUtil, IConfirmUtil, IFileItemParams, IFileUploadPrams, IFileSystemOptions, FileUploaderOptions } from '../../interface';
+import { IFile, IFileItem, ITreeNode, IMessageUtil, IConfirmUtil, IFileItemParams, IFileUploadPrams, IFileSystemOptions, FileUploaderOptions } from '../../interface';
 import { AiChatController } from '../ai-chat/ai-chat.controller';
 
 /**
@@ -9,7 +9,7 @@ import { AiChatController } from '../ai-chat/ai-chat.controller';
 export declare class FileSystemController {
     private opts;
     private uploader;
-    private aiChat;
+    aiChat: AiChatController;
     /**
      * Creates an instance of FileSystemController.
      * @param {IFileSystemOptions} opts
@@ -48,9 +48,10 @@ export declare class FileSystemController {
     /**
      * @description 文件预览模式
      * @readonly
+     * @type {("DEFAULT" | "CUSTOM" | undefined)}
      * @memberof FileSystemController
      */
-    get filePreviewMode(): "DEFAULT" | "CUSTOM" | undefined;
+    get filePreviewMode(): 'DEFAULT' | 'CUSTOM' | undefined;
     /**
      * @description 绑定函数this指向
      * @private
@@ -172,4 +173,12 @@ export declare class FileSystemController {
      * @memberof FileSystemController
      */
     uploadFileToSystem(file_path: string, file: File): Promise<boolean>;
+    /**
+     * @description 加载文件树节点
+     * @param {ITreeNode} [parent] 父节点
+     * @param {IFileItemParams} [params] 参数
+     * @returns {*}  {Promise<ITreeNode[]>}
+     * @memberof FileSystemController
+     */
+    loadFileTreeNodes(parent?: ITreeNode, params?: IFileItemParams): Promise<ITreeNode[]>;
 }

package/dist/types/interface/i-chat-toolbar-item/i-chat-toolbar-item.d.ts

@@ -20,7 +20,7 @@ export interface IChatToolbarItem {
      *
      * @memberof IChatToolbarItem
      */
-    label?: string | VNode | ((h: Function) => VNode);
+    label?: string;
     /**
      * 提示信息
      *

package/dist/types/interface/i-tree-node/i-tree-node.d.ts

@@ -0,0 +1,54 @@
+export interface ITreeNode {
+    /**
+     * 根节点标识
+     */
+    rootId: string;
+    /**
+     * 节点唯一标识
+     */
+    id: string;
+    /**
+     * 节点显示文本
+     */
+    label: string;
+    /**
+     * 是否叶子节点
+     */
+    isLeaf: boolean;
+    /**
+     * 节点深度
+     */
+    depth: number;
+    /**
+     * 子节点
+     */
+    children?: ITreeNode[];
+    /**
+     * 是否已加载子节点
+     */
+    loaded?: boolean;
+    /**
+     * 是否展开
+     */
+    expanded?: boolean;
+    /**
+     * 是否正在加载
+     */
+    loading?: boolean;
+    /**
+     * 父节点标识
+     */
+    parentId?: string;
+    /**
+     * 自定义图标
+     */
+    icon?: string;
+    /**
+     * 原始数据
+     */
+    data: Record<string, any>;
+    /**
+     * 根节点
+     */
+    isRoot?: boolean;
+}

package/dist/types/interface/index.d.ts

@@ -29,3 +29,4 @@ export type { IFile, IFileItem, IFileItemParams, IFileUploadPrams, } from './i-f
 export type { IFileSystemOptions } from './i-file-system-options/i-file-system-options';
 export { TipTapNodeType, type ITipTapDropData, type TipTapNodeConfig, } from './i-tiptap/i-tiptap';
 export * from './deep-research';
+export type { ITreeNode } from './i-tree-node/i-tree-node';

package/dist/types/locale/en/index.d.ts

@@ -182,4 +182,6 @@ export declare const EN: {
     clear: string;
     backPrevious: string;
     fileExists: string;
+    moveToGroup: string;
+    moveToDir: string;
 };

package/dist/types/locale/zh-CN/index.d.ts

@@ -182,4 +182,6 @@ export declare const ZH_CN: {
     clear: string;
     backPrevious: string;
     fileExists: string;
+    moveToGroup: string;
+    moveToDir: string;
 };

package/dist/types/utils/index.d.ts

@@ -11,5 +11,6 @@ export { ChatToolCallParser } from './util/chat-tool-call-parser';
 export { ChatStepParser } from './util/chat-step-parser';
 export { ChatUIActionParser } from './util/chat-ui-action-parser';
 export { ContentProtector } from './util/content-protector';
+export { MarkdownPreview } from './markdown-preview';
 export { TextUtil } from './util/util';
 export { FileIcon, FolderIcon } from './util/system-file';

package/dist/types/utils/markdown-preview.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 消息 markdown 预览渲染器
+ *
+ * ## 为什么不直接用 `new Cherry({ defaultModel: 'previewOnly' })` + setMarkdown
+ * previewOnly 模式的 Cherry 仍会创建 CodeMirror、工具栏、内部 ResizeObserver 等完整
+ * 编辑器 DOM,而 cherry 0.8.58 的 destroy() 仅移除容器与清空事件总线,不销毁编辑器、
+ * 不断开内部观察器;消息列表滚出视口→卸载、滚回→重建的机制下,被销毁实例的整棵 DOM
+ * 会持续滞留在堆上(内存泄露)。消息预览只需要 markdown→HTML。
+ *
+ * ## 为什么主入口 Cherry 还要「无 el」实例化
+ * 主入口 default 导出的是完整编辑器类 Cherry(引擎类 CherryEngine 仅在
+ * dist/cherry-markdown.engine.core.esm.js 子路径导出,无法被宿主 external 复用)。
+ * Cherry 不传 el 且不强制挂载(forceAppend 默认 false)时,init() 在创建编辑区/
+ * 工具栏之前即返回,不产生任何编辑器 DOM;此时仅借用实例内部的 Engine 完成
+ * markdown→HTML(Engine 构造与 makeHtml 均不依赖编辑器 DOM)。
+ */
+export interface IMarkdownPreviewTheme {
+    /**
+     * 主题（cherry themeSettings.mainTheme），默认 light
+     */
+    mainTheme?: string;
+    /**
+     * 代码块主题（cherry themeSettings.codeBlockTheme），默认 default
+     */
+    codeBlockTheme?: string;
+}
+/**
+ * markdown 预览渲染器实例：每个消息组件持有一个，
+ * render 可反复调用（流式更新），容器被卸载重建后会自动重建骨架
+ */
+export declare class MarkdownPreview {
+    private wrapper;
+    private previewer;
+    /**
+     * 渲染 markdown 到容器：首次构建 cherry 预览骨架（class/主题属性与
+     * cherry previewOnly 结构一致，保证样式不变），后续调用仅更新内容
+     */
+    render(container: HTMLElement, md: string, theme?: IMarkdownPreviewTheme): void;
+    /**
+     * 预览内容容器（如外部 ResizeObserver 需要测量内容高度）
+     */
+    getPreviewerDom(): HTMLDivElement | null;
+    /**
+     * 卸载骨架（无实例资源，仅移除 DOM）
+     */
+    destroy(): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template-plugin/ai-chat",
-  "version": "0.0.123",
+  "version": "0.0.125",
   "description": "iBiz AI交互框插件",
   "type": "module",
   "main": "dist/index.es.js",