@ibiz-template-plugin/ai-chat 0.0.117 → 0.0.119

package/dist/types/components/chat-back-bottom/chat-back-bottom.d.ts

@@ -1,3 +1,4 @@
+import { RefObject } from 'preact';
 
 export interface ChatBackBottomProps {
     /**
@@ -13,11 +14,12 @@ export interface ChatBackBottomProps {
      */
     bottom: number;
     /**
-     * @description 滚动目标
-     * @type {string}
+     * @description 滚动目标（元素 ref 或选择器；多实例场景应传 ref，
+     * 选择器经 document.querySelector 只会命中首个匹配实例）
+     * @type {RefObject<HTMLElement> | string}
      * @memberof ChatBackBottomProps
      */
-    target: string;
+    target: RefObject<HTMLElement> | string;
     /**
      * @description 滚动高度达到此参数值才出现
      * @type {number}

package/dist/types/components/chat-file-preview/components/custom-chat-file-preview/custom-chat-file-preview.d.ts

@@ -0,0 +1,19 @@
+import { FileSystemController } from '../../../../controller';
+import { IFile } from '../../../../interface';
+
+interface CustomChatFilePreviewProps {
+    /**
+     * @description 文件
+     * @type {IFile}
+     * @memberof CustomChatFilePreviewProps
+     */
+    file?: IFile;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof CustomChatFilePreviewProps
+     */
+    controller: FileSystemController;
+}
+export declare const CustomChatFilePreview: (props: CustomChatFilePreviewProps) => import("preact").JSX.Element;
+export {};

package/dist/types/components/chat-file-preview/components/default-chat-file-preview/default-chat-file-preview.d.ts

@@ -0,0 +1,19 @@
+import { FileSystemController } from '../../../../controller';
+import { IFile } from '../../../../interface';
+
+interface DefaultChatFilePreviewProps {
+    /**
+     * @description 文件
+     * @type {IFile}
+     * @memberof DefaultChatFilePreviewProps
+     */
+    file?: IFile;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof DefaultChatFilePreviewProps
+     */
+    controller: FileSystemController;
+}
+export declare const DefaultChatFilePreview: (props: DefaultChatFilePreviewProps) => import("preact").JSX.Element;
+export {};

package/dist/types/components/chat-messages/chat-messages.d.ts

@@ -26,15 +26,16 @@ export interface ChatMessageProps {
 /**
  * 聊天消息列表组件
  *
- * ## 整体思路
- * 用虚拟列表（useVirtualList）只渲染视口内 + overscan 的消息，避免消息量大时 DOM 节点膨胀。
- * 消息数量 / 内容会随时变化，滚动位置由下面的「锚定策略」维护。
+ * ## 整体思路（真实绘制 + 按需扩展）
+ * 弃用虚拟列表（绝对定位 + spacer 存在滚动条抖动），所有消息按普通文档流真实渲染：
+ * 1. 初始只真实绘制最新的 20 条，更早的消息不进 DOM（无占位）；
+ * 2. 滚动到顶部附近时向前扩展一批（每批 10 条）真实绘制，绘制过的消息永久保留真实渲染；
+ * 3. 绘制触达已加载数据头部且服务端仍有更早历史时，才触发 loadHistoryMore 网络加载，
+ *    与「绘制扩展」（纯前端）严格分开。
  *
- * ## 锚定策略（useLayoutEffect 内）
- * 1. 末尾追加：用户自己发送的消息 → 强制贴底，跟随新消息；AI 回复 → 遵循当前贴底状态
- *    （用户上翻阅读历史时不被打断，落入下方分支 2/3 处理）；
- * 2. 贴底模式（isAutoScroll）下任何变化（流式增长、测量回填）→ 继续贴底；
- * 3. 非贴底 + 数据变化（前插历史、删除）→ 按锚点恢复位置，避免画面跳动；
- *    纯「测量回填」（totalSize 变但消息引用没变）不干预 scrollTop，避免打断手动拖动。
+ * ## 滚动位置维护
+ * - 贴底跟随由数据变化布局修正驱动：消息更新、绘制范围变化后处于贴底模式时自动贴底；
+ * - 末尾追加用户消息 → 强制贴底；前插更早历史 → 依赖浏览器 scroll anchoring 保持视口；
+ * - keep-alive 失活再激活 → 恢复失活前滚动位置。
  */
 export declare const ChatMessages: (props: ChatMessageProps) => import("preact").JSX.Element;

package/dist/types/components/chat-messages/use-message-renderer.d.ts

@@ -0,0 +1,89 @@
+import { RefObject } from 'preact';
+import { Signal } from '@preact/signals';
+import { IChatMessage } from '../../interface';
+
+export declare const INITIAL_BATCH_SIZE = 20;
+export declare const EXPAND_BATCH_SIZE = 10;
+export interface UseMessageRenderOptions {
+    /**
+     * 消息数组信号（内容/数量变化都会触发组件重渲染）
+     *
+     * @type {Signal<IChatMessage[]>}
+     */
+    messages: Signal<IChatMessage[]>;
+    /**
+     * 是否还有更早历史可加载（绘制触达数据头部时用于触发数据加载）
+     *
+     * @type {Signal<boolean>}
+     */
+    hasMoreHistory: Signal<boolean>;
+    /**
+     * 是否正在加载更早历史
+     *
+     * @type {Signal<boolean>}
+     */
+    isLoadingHistory: Signal<boolean>;
+    /**
+     * 加载更早历史（数据层，网络请求）
+     *
+     * @type {() => void}
+     */
+    loadHistoryMore: () => void;
+}
+export interface UseMessageRenderResult {
+    /**
+     * 挂到滚动容器上的 ref
+     *
+     * @type {RefObject<HTMLDivElement>}
+     */
+    containerRef: RefObject<HTMLDivElement>;
+    /**
+     * 已绘制覆盖的头部索引（实际值）：[renderStartIndex, messages.length) 为真实绘制区，
+     * [0, renderStartIndex) 的消息不进 DOM。由 rAF 循环逐帧逼近目标值
+     *
+     * @type {Signal<number>}
+     */
+    renderStartIndex: Signal<number>;
+    /**
+     * 滚动事件中调用：滚动到顶部附近时向前扩展一批绘制（EXPAND_BATCH_SIZE 条），
+     * 绘制触达数据头部且仍有更早历史时触发 loadHistoryMore
+     *
+     * @type {() => void}
+     */
+    checkExpand: () => void;
+    /**
+     * 设置绘制范围目标索引，rAF 循环逐帧逼近（初始加载/前插共用）
+     *
+     * @type {(index: number) => void}
+     */
+    setRenderTarget: (index: number) => void;
+    /**
+     * 头部前插历史数据后调用：前插的消息纳入绘制范围（用户在顶部看历史）
+     *
+     * @type {(prependedCount: number) => void}
+     */
+    adjustForPrepend: (prependedCount: number) => void;
+    /**
+     * 恢复滚动条位置（keep-alive 激活时使用）
+     *
+     * @type {() => void}
+     */
+    restoreScrollPosition: () => void;
+}
+/**
+ * 消息渐进真实绘制 Hook
+ *
+ * ## 核心思路（真实绘制 + 按需扩展 + 渲染切片，弃用虚拟列表）
+ * 不做视口裁剪、不做占位：消息按普通文档流真实渲染，分批绘制——
+ * 1. 初始只绘制最新的 20 条，更早的消息不进 DOM；
+ * 2. 滚动到顶部附近时向前扩展一批（EXPAND_BATCH_SIZE 条），绘制过的消息永久真实渲染；
+ * 3. 批次扩展不一次性放行：renderStartIndex 由 rAF 循环每帧向目标值推进
+ *    ITEMS_PER_FRAME 条，把每条消息的 Cherry 初始化/解析分摊到多帧，
+ *    避免一批消息同帧挂载导致主线程阻塞数秒。
+ *
+ * ## 与数据加载的边界
+ * 绘制扩展是纯前端行为（不动数据）；只有绘制需求触达已加载数据头部
+ * （renderTargetIndex === 0）且服务端还有更早历史时，才触发 loadHistoryMore 网络加载。
+ *
+ */
+export declare const useMessageRender: (options: UseMessageRenderOptions) => UseMessageRenderResult;

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

@@ -0,0 +1,27 @@
+import { FileSystemController } from '../../../controller';
+import { LazyTreeNode } from '../../common';
+
+interface FileMovePanelProps {
+    /**
+     * @description 当前文件数据
+     * @type {IFile}
+     * @memberof FileMovePanelProps
+     */
+    data: LazyTreeNode;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof FileMovePanelProps
+     */
+    controller: FileSystemController;
+    /**
+     * @description 关闭
+     * @memberof FileMovePanelProps
+     */
+    onClose?: (params?: {
+        ok: boolean;
+        data: any;
+    }) => void;
+}
+export declare const FileMovePanel: (props: FileMovePanelProps) => import("preact").JSX.Element;
+export {};

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

@@ -0,0 +1,27 @@
+import { FileSystemController } from '../../../controller';
+import { LazyTreeNode } from '../../common';
+
+interface FileNewPanelProps {
+    /**
+     * @description 父数据
+     * @type {IFile}
+     * @memberof FileNewPanelProps
+     */
+    parent: LazyTreeNode;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof FileNewPanelProps
+     */
+    controller: FileSystemController;
+    /**
+     * @description 关闭
+     * @memberof FileNewPanelProps
+     */
+    onClose?: (params?: {
+        ok: boolean;
+        data: LazyTreeNode;
+    }) => void;
+}
+export declare const FileNewPanel: (props: FileNewPanelProps) => import("preact").JSX.Element;
+export {};

package/dist/types/components/chat-search/chat-search.d.ts

@@ -40,5 +40,9 @@ export interface ChatSearchProps {
      * @returns
      */
     onEnter?: (value: string) => void;
+    /**
+     * 是否显示清除按钮
+     */
+    clearable?: boolean;
 }
 export declare const ChatSearch: (props: ChatSearchProps) => import("preact").JSX.Element;

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

@@ -0,0 +1,29 @@
+import { VNode } from 'preact';
+
+export interface IAction {
+    id: string;
+    icon: VNode;
+    caption: string;
+    visible?: (data?: any) => boolean | boolean;
+    onClick?: (event: MouseEvent, data?: any) => void;
+}
+interface ActionsProps {
+    /**
+     * 平铺项
+     */
+    flattenCount?: number;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 行为项数据
+     */
+    actions: IAction[];
+    /**
+     * 行为项数据
+     */
+    data?: any;
+}
+export declare const Actions: (props: ActionsProps) => import("preact").JSX.Element;
+export {};

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

@@ -1,19 +1,12 @@
 
 interface BreadcrumbProps {
     /**
-     * 当前路径（非根 -> 当前层）
+     * 当前路径（根 -> 当前层）
      */
     path: {
         id: string;
         label: string;
     }[];
-    /**
-     * 根节点
-     */
-    root?: {
-        id: string;
-        label: string;
-    };
     /**
      * 点击某一层跳转，-1 表示回到根
      */

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

@@ -0,0 +1,34 @@
+import { IAction } from '../actions/actions';
+
+export interface IContextMenuAction extends IAction {
+    clickClose?: boolean;
+}
+interface ContextMenuProps {
+    /**
+     * 行为数据
+     */
+    data?: any;
+    /**
+     * 显示状态
+     */
+    visible: boolean;
+    /**
+     * 菜单项
+     */
+    actions: IContextMenuAction[];
+    /**
+     * 菜单出现位置（视口坐标，与 MouseEvent.clientX/clientY 一致）
+     */
+    position: {
+        x: number;
+        y: number;
+    };
+    /**
+     * 切换显示
+     * @param state
+     * @returns
+     */
+    onToggleVisible: (state: boolean) => void;
+}
+export declare const ContextMenu: (props: ContextMenuProps) => import("preact").JSX.Element;
+export {};

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

@@ -11,8 +11,13 @@ interface DrawerProps {
     size?: number | string;
     /** 指定容器（DOM 元素），不传则默认 body */
     container?: HTMLElement;
+    /** 是否按 Esc 关闭，默认 true */
+    escClosable?: boolean;
     /** 关闭回调（由 DrawerManager 注入） */
-    onClose?: () => void;
+    onClose?: (params?: {
+        ok: boolean;
+        data: any;
+    }) => void;
     /** 是否显示遮罩，默认 true */
     mask?: boolean;
     /** 是否显示右上角关闭按钮，默认 true */

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

@@ -3,3 +3,12 @@ export { MultipleSelect } from './multiple-select/multiple-select';
 export { MessageToolbar } from './messsage-toolbar/messsage-toolbar';
 export { Slider } from './slider/slider';
 export { Switch } from './switch/switch';
+export { Actions, type IAction } from './actions/actions';
+export { Breadcrumb } from './breadcrumb/breadcrumb';
+export { LazyListTree, type LazyListTreeRef, type LazyListTreeMode, } from './lazy-list-tree/lazy-list-tree';
+export { ContextMenu, type IContextMenuAction, } from './context-menu/context-menu';
+export { Drawer } from './drawer/drawer';
+export { LazyTree, type LazyTreeRef, type LazyTreeNode, type INodeEditInfo, } from './lazy-tree/lazy-tree';
+export { Loading } from './loading/loading';
+export { InlineEditor } from './inline-editor/inline-editor';
+export { Modal } from './modal/modal';

package/dist/types/components/common/inline-editor/inline-editor.d.ts

@@ -0,0 +1,13 @@
+
+interface InlineEditorProps {
+    /** 初始值 */
+    value?: string;
+    /** 占位提示 */
+    placeholder?: string;
+    /** 回车/失焦确认，校验是否成功 */
+    onConfirm: (value: string) => Promise<void> | void;
+    /** Esc 或空值失焦取消 */
+    onCancel: () => void;
+}
+export declare const InlineEditor: (props: InlineEditorProps) => import("preact").JSX.Element;
+export {};

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

@@ -1,5 +1,7 @@
-import { LazyTreeNode } from '../lazy-tree/lazy-tree';
+import { INodeEditInfo, LazyTreeNode } from '../lazy-tree/lazy-tree';
+import { IAction } from '../actions/actions';
 
+export type LazyListTreeMode = 'list' | 'card';
 interface LazyListTreeProps {
     /**
      * 根节点数据
@@ -32,6 +34,7 @@ interface LazyListTreeProps {
     path?: LazyTreeNode[];
     /**
      * 是否显示搜索框
+     * @default true
      */
     showSearch?: boolean;
     /**
@@ -40,10 +43,12 @@ interface LazyListTreeProps {
     defaultCheckedKeys?: string[];
     /**
      * 高亮选中
+     * @default true
      */
     highlight?: boolean;
     /**
      * 标识分隔符
+     * @default '/'
      */
     separator?: string;
     /**
@@ -52,16 +57,41 @@ interface LazyListTreeProps {
     filter?: string;
     /**
      * 是否可拖拽
+     * @default false
      */
     draggable?: boolean;
+    /**
+     * 行为集合
+     */
+    actions?: IAction[];
+    /**
+     * 节点编辑信息
+     */
+    nodeEditInfo?: INodeEditInfo;
+    /**
+     * 确认
+     * @param name
+     * @returns
+     */
+    onConfirm?: (name: string) => Promise<void> | void;
+    /**
+     * 取消
+     * @returns
+     */
+    onCancel?: () => void;
+    /**
+     * 展示模式
+     * @default 'list'
+     */
+    mode?: LazyListTreeMode;
 }
 export interface LazyListTreeRef {
     /**
-     * 重载节点
-     * @param node
+     * 重载
+     * @param
      * @returns
      */
-    overloadNode: (node: LazyTreeNode) => Promise<void>;
+    overloadNode: () => Promise<void>;
 }
 export declare const LazyListTree: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<LazyListTreeProps> & {
     ref?: import('preact').Ref<LazyListTreeRef> | undefined;

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

@@ -1,3 +1,5 @@
+import { VNode } from 'preact';
+import { IAction } from '../actions/actions';
 
 export interface LazyTreeNode {
     /**
@@ -31,7 +33,7 @@ export interface LazyTreeNode {
     /**
      * 父节点标识
      */
-    parentId?: string | null;
+    parentId?: string;
     /**
      * 节点深度
      */
@@ -45,11 +47,45 @@ export interface LazyTreeNode {
      */
     data: Record<string, any>;
     /**
-     * @description 根节点标识
-     * @type {string}
-     * @memberof LazyTreeNode
+     * 根节点标识
      */
     rootId: string;
+    /**
+     * 根节点
+     */
+    isRoot?: boolean;
+}
+export interface INodeEditInfo {
+    /**
+     * @description 图标
+     * @type {VNode}
+     * @memberof INodeEditInfo
+     */
+    icon?: VNode;
+    /**
+     * @description 默认值
+     * @type {string}
+     * @memberof INodeEditInfo
+     */
+    value?: string;
+    /**
+     * @description 占位提示
+     * @type {string}
+     * @memberof INodeEditInfo
+     */
+    placeholder?: string;
+    /**
+     * @description 类型
+     * @type {('draft' | 'edit')} 草稿节点 | 节点编辑
+     * @memberof INodeEditInfo
+     */
+    type: 'draft' | 'edit';
+    /**
+     * @description 草稿的父节点 | 编辑节点
+     * @type {LazyTreeNode}
+     * @memberof INodeEditInfo
+     */
+    node: LazyTreeNode;
 }
 interface LazyTreeProps {
     /**
@@ -83,6 +119,7 @@ interface LazyTreeProps {
     activePath?: LazyTreeNode[];
     /**
      * 是否显示搜索框
+     * @default true
      */
     showSearch?: boolean;
     /**
@@ -91,18 +128,22 @@ interface LazyTreeProps {
     defaultCheckedKeys?: string[];
     /**
      * 高亮选中
+     * @default true
      */
     highlight?: boolean;
     /**
      * 高亮选中父节点
+     * @default true
      */
     highlightParent?: boolean;
     /**
      * 是否在点击节点的时候展开或者收缩节点
+     * @default true
      */
     expandOnClickNode?: boolean;
     /**
      * 标识分隔符
+     * @default '/'
      */
     separator?: string;
     /**
@@ -111,13 +152,44 @@ interface LazyTreeProps {
     filter?: string;
     /**
      * 是否可拖拽
+     * @default false
      */
     draggable?: boolean;
+    /**
+     * 行为集合
+     */
+    actions?: IAction[];
+    /**
+     * 节点编辑信息
+     */
+    nodeEditInfo?: INodeEditInfo;
+    /**
+     * 确认
+     * @param name
+     * @returns
+     */
+    onConfirm?: (name: string) => Promise<void> | void;
+    /**
+     * 取消
+     * @returns
+     */
+    onCancel?: () => void;
+}
+export interface LazyTreeRef {
+    /**
+     * @description 重载节点
+     * @param {LazyTreeNode} node 需要重载的节点
+     * @param {boolean} isParent 是否重载父节点，默认为false
+     * @memberof LazyTreeRef
+     */
+    overloadNode: (node: LazyTreeNode, isParent?: boolean) => Promise<void>;
 }
 /**
  * 懒加载树组件
  *
  * 具有懒加载、搜索、展开折叠等功能
  */
-export declare const LazyTree: (props: LazyTreeProps) => import("preact").JSX.Element;
+export declare const LazyTree: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<LazyTreeProps> & {
+    ref?: import('preact').Ref<LazyTreeRef> | undefined;
+}>;
 export {};

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

@@ -0,0 +1,37 @@
+import { VNode, h } from 'preact';
+
+interface ModalProps {
+    /** 头部图标 */
+    icon?: VNode;
+    /** 内容组件 */
+    content: any;
+    /** 传递给内容组件的参数（onClose 会被自动注入） */
+    contentProps?: Record<string, any>;
+    /** 指定容器，不传默认 body */
+    container?: HTMLElement;
+    /** 关闭回调（由 ModalManager 注入） */
+    onClose?: (params?: {
+        ok: boolean;
+        data: any;
+    }) => void;
+    /** 是否显示遮罩，默认 true */
+    mask?: boolean;
+    /** 是否显示右上角关闭按钮，默认 true */
+    showClose?: boolean;
+    /** 点击遮罩是否关闭，默认 true */
+    maskClosable?: boolean;
+    /** 是否按 Esc 关闭，默认 true */
+    escClosable?: boolean;
+    /** 外部扩展类名 */
+    className?: string;
+    /** 标题 */
+    title?: string;
+    /** 宽度：number(px) / 字符串('50%' / '600px')，不传默认 80% */
+    width?: number | string;
+    /** 高度：number(px) / 字符串('50%' / '600px')，不传默认 80% */
+    height?: number | string;
+    /** 垂直居中，默认 true */
+    centered?: boolean;
+}
+export declare const Modal: (props: ModalProps) => h.JSX.Element;
+export {};

package/dist/types/components/flat-chat-container/flat-chat-container.d.ts

@@ -49,6 +49,10 @@ export interface FlatChatContainerProps {
      * 是否加载中
      */
     isLoading: boolean;
+    /**
+     * 是否隐藏嵌入AI聊天框头部区域，仅嵌入AI聊天框生效
+     */
+    isEmbedAiHeaderHidden: boolean;
     /**
      * @description 扩展
      * @type {IExtensionOptions}
@@ -222,7 +226,7 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * @description 绘制头部
      * @memberof FlatChatContainer
      */
-    renderHeader(): JSX.Element;
+    renderHeader(): JSX.Element | null;
     /**
      * @description 绘制右侧操作区（含分隔条）
      * - DOM 常驻，宽度随 visible 切换由 CSS 过渡展开/收起

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

@@ -6,13 +6,14 @@ interface ActionItem {
     caption: string;
     icon?: VNode;
 }
-export declare const Popup: ({ triggerMode, children, actions, content, position, isOpen: isOpenProp, onToggleOpen, onAction, }: {
+export declare const Popup: ({ triggerMode, children, actions, content, position, isOpen: isOpenProp, onToggleOpen, popupClassName, onAction, }: {
     triggerMode: "click" | "hover";
     children: import('preact').ComponentChildren;
     actions?: ActionItem[];
     content?: import('preact').ComponentChildren;
     position?: Position;
     isOpen?: boolean;
+    popupClassName?: string;
     onToggleOpen?: (isOpen: boolean) => void;
     onAction?: (actionId: string, event: MouseEvent) => void;
 }) => import("preact").JSX.Element;