@ibiz-template-plugin/ai-chat 0.0.116 → 0.0.118

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-container/chat-container.d.ts

@@ -210,7 +210,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     fitPanelToViewport(panel: AiActionPanelController): void;
     ns: Namespace;
     containerRef: import('preact').RefObject<HTMLDivElement>;
-    dragHandle: import('preact').RefObject<HTMLDivElement>;
     /**
      * 输入区容器（用于高度分隔条）
      */
@@ -237,13 +236,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
         minHeight: number;
         showMode: string;
     };
-    /**
-     * 是否禁止拖动
-     * - 拖拽边时应禁止拖动
-     * @type {boolean}
-     * @memberof ChatContainer
-     */
-    disabled: boolean;
     /**
      * 最小化是否在拖拽中
      * - 在拖拽时不应触发点击事件
@@ -255,13 +247,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 侧栏宽度拖动起始值(px)
      */
     sidebarDragStartWidth: number;
-    /**
-     * 拖拽容器边框时的方向标记（左右=宽、上下=高）
-     */
-    resizing: {
-        width: boolean;
-        height: boolean;
-    };
     /**
      * 输入区高度拖动起始值(px)
      */
@@ -333,18 +318,12 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * @memberof ChatContainer
      */
     snapToEdge(): void;
-    /**
-     * 注册对话框拖拽
-     *
-     * @memberof ChatContainer
-     */
-    registerDragDialog(): void;
     /**
      * 注册对话框边界拖拽
      *
      * @memberof ChatContainer
      */
-    registerDragDialogBorder(): void;
+    registerDrag(): void;
     /**
      * 处理全屏改变
      *
@@ -401,6 +380,24 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 右侧聊天区宽度
      */
     getRightWidth(): string;
+    /**
+     * @description 获取宽度
+     * @returns {*}  {{
+     *     centreMinWidth: number;
+     *     leftWidth: number;
+     *     rightWidth: number;
+     *     leftMinWidth: number;
+     *     rightMinWidth: number;
+     *   }}
+     * @memberof ChatContainer
+     */
+    getWidth(): {
+        centreMinWidth: number;
+        leftWidth: number;
+        rightWidth: number;
+        leftMinWidth: number;
+        rightMinWidth: number;
+    };
     /**
      * 侧栏宽度拖动开始
      */
@@ -418,9 +415,13 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      */
     clampSidebarWidth(width: number): number;
     /**
-     * 拖动容器左右边框时实时校正侧栏宽度
+     * @description 拖动容器左右边框时实时校正侧栏宽度
+     * - 中间宽度已到最小宽度时缩小对应边的侧边栏
+     * @param {('left' | 'right')} direction
+     * @param {number} width
+     * @memberof ChatContainer
      */
-    syncSidebarWidth: () => void;
+    syncSidebarWidth: (direction: "left" | "right", width: number) => void;
     /**
      * 拖动容器左右边框结束后提交侧栏宽度
      */

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-group-topics/components/selected-mode-topic/selected-mode-topic.d.ts

@@ -0,0 +1,21 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface SelectedModeTopicProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 进入多选模式时默认选中的话题id
+     */
+    defaultSelectedTopicId?: string;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const SelectedModeTopic: (props: SelectedModeTopicProps) => import("preact").JSX.Element;

package/dist/types/components/chat-group-topics/components/show-hidden-setting/show-hidden-setting.d.ts

@@ -0,0 +1,17 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface ShowHiddenSettingProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const ShowHiddenSetting: (props: ShowHiddenSettingProps) => import("preact").JSX.Element;

package/dist/types/components/chat-group-topics/components/topic-batch-action/topic-batch-action.d.ts

@@ -0,0 +1,21 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface TopicBatchActionProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 进入批量管理时默认选中的目录key
+     */
+    defaultSelectedScopeKey?: string;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const TopicBatchAction: (props: TopicBatchActionProps) => import("preact").JSX.Element;

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/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/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, } 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, } 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,4 +1,5 @@
 import { LazyTreeNode } from '../lazy-tree/lazy-tree';
+import { IAction } from '../actions/actions';
 
 interface LazyListTreeProps {
     /**
@@ -54,14 +55,41 @@ interface LazyListTreeProps {
      * 是否可拖拽
      */
     draggable?: boolean;
+    /**
+     * 行为集合
+     */
+    actions?: IAction[];
+    /**
+     * 新建草稿：type=file/folder；null 表示无草稿
+     */
+    draft?: {
+        type: 'file' | 'folder';
+        parent: LazyTreeNode;
+    } | null;
+    /**
+     * 确认
+     * @param name
+     * @param node
+     * @returns
+     */
+    onConfirm?: (name: string, node?: LazyTreeNode) => Promise<void> | void;
+    /**
+     * 取消
+     * @returns
+     */
+    onCancel?: () => void;
+    /**
+     * 编辑的节点 id
+     */
+    editNodeId?: string | null;
 }
 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,4 @@
+import { IAction } from '../actions/actions';
 
 export interface LazyTreeNode {
     /**
@@ -31,7 +32,7 @@ export interface LazyTreeNode {
     /**
      * 父节点标识
      */
-    parentId?: string | null;
+    parentId?: string;
     /**
      * 节点深度
      */
@@ -45,11 +46,13 @@ export interface LazyTreeNode {
      */
     data: Record<string, any>;
     /**
-     * @description 根节点标识
-     * @type {string}
-     * @memberof LazyTreeNode
+     * 根节点标识
      */
     rootId: string;
+    /**
+     * 根节点
+     */
+    isRoot?: boolean;
 }
 interface LazyTreeProps {
     /**
@@ -113,11 +116,49 @@ interface LazyTreeProps {
      * 是否可拖拽
      */
     draggable?: boolean;
+    /**
+     * 行为集合
+     */
+    actions?: IAction[];
+    /**
+     * 新建草稿：type=file/folder；null 表示无草稿
+     */
+    draft?: {
+        type: 'file' | 'folder';
+        parent: LazyTreeNode;
+    } | null;
+    /**
+     * 确认
+     * @param name
+     * @param node
+     * @returns
+     */
+    onConfirm?: (name: string, node?: LazyTreeNode) => Promise<void> | void;
+    /**
+     * 取消
+     * @returns
+     */
+    onCancel?: () => void;
+    /**
+     * 编辑的节点 id
+     */
+    editNodeId?: string | null;
+}
+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 过渡展开/收起