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

package/dist/types/components/chat-action-panel/chat-action-panel.d.ts

@@ -0,0 +1,19 @@
+import { h } from 'preact';
+import { AiActionPanelController } from '../../controller/ai-action-panel/ai-action-panel.controller';
+
+export interface ChatActionPanelProps {
+    /**
+     * 操作区面板控制器
+     */
+    controller: AiActionPanelController;
+}
+/**
+ * 聊天容器右侧操作区面板
+ * - 头部：左侧标题、右侧关闭图标，高度与容器头部(60px)保持一致
+ * - 内容区：占满剩余高度，渲染打开操作区时传入的内容组件
+ * - 自身不管理宽度（宽度由外层容器裁切）
+ *
+ * @export
+ * @class ChatActionPanel
+ */
+export declare const ChatActionPanel: ({ controller }: ChatActionPanelProps) => h.JSX.Element;

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

@@ -1,6 +1,6 @@
 import { Component, JSX } from 'preact';
 import { Namespace } from '../../utils';
-import { AiChatController, AiTopicController } from '../../controller';
+import { AiActionPanelController, AiChatController, AiTopicController } from '../../controller';
 import { IAutoClose, IChatToolbarItem, IChatContainerOptions } from '../../interface';
 
 export interface ChatContainerProps {
@@ -101,6 +101,13 @@ export interface ChatContainerProps {
      * 是否加载中
      */
     isLoading: boolean;
+    /**
+     * 操作区面板控制器
+     *
+     * @type {AiActionPanelController}
+     * @memberof ChatContainerProps
+     */
+    actionPanel?: AiActionPanelController;
 }
 /**
  * 容器状态
@@ -152,6 +159,13 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 已绑定事件监听的聊天控制器实例（用于切换 aiChat 时重绑）
      */
     private listenedAIChat?;
+    /**
+     * @description 拖拽实例
+     * @private
+     * @type {(Interactable | undefined)}
+     * @memberof ChatContainer
+     */
+    private interactable;
     /**
      * 消息完成事件回调
      */
@@ -162,6 +176,38 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     private onMinimizeChangeHandler;
     listener(): void;
     componentDidUpdate(): void;
+    /**
+     *
+     * 同步操作区面板状态（visible 边沿触发窗口宽度增减与位置适配，展开收起动画由 CSS 过渡完成）
+     *
+     * @memberof ChatContainer
+     */
+    syncPanelState(): void;
+    /**
+     * 打开操作区面板：窗口增宽面板占用（面板 + 分隔条），右边界不够时压缩面板宽度，仍不够则窗口左移补足
+     *
+     * @param {AiActionPanelController} panel
+     * @memberof ChatContainer
+     */
+    handlePanelOpen(panel: AiActionPanelController): void;
+    /**
+     * 关闭操作区面板：窗口宽度回落面板占用（面板 + 分隔条），并回退打开时的窗口左移量
+     *
+     * @memberof ChatContainer
+     */
+    handlePanelClose(): void;
+    /**
+     * 恢复面板打开期间为适配右边界所做的窗口左移量
+     */
+    restorePanelShift(): void;
+    /**
+     * 面板打开后适配屏幕右边界（全屏时窗口铺满屏幕无需适配）
+     * - 先压缩面板宽度（窗口总宽同步回落），仍溢出则窗口左移补足
+     *
+     * @param {AiActionPanelController} panel
+     * @memberof ChatContainer
+     */
+    fitPanelToViewport(panel: AiActionPanelController): void;
     ns: Namespace;
     containerRef: import('preact').RefObject<HTMLDivElement>;
     dragHandle: import('preact').RefObject<HTMLDivElement>;
@@ -176,16 +222,16 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      */
     data: {
         side: {
+            x: number;
             y: number;
-            height: number;
             width: number;
-            x: number;
+            height: number;
         };
         window: {
+            x: number;
             y: number;
             width: number;
             height: number;
-            x: number;
         };
         minWidth: number;
         minHeight: number;
@@ -224,6 +270,18 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 输入区高度拖动时其父容器高度(px)
      */
     inputDragContainerHeight: number;
+    /**
+     * 操作区面板上一帧显示状态（用于 componentDidUpdate 边沿检测）
+     */
+    private panelVisiblePrev;
+    /**
+     * 操作区面板打开导致的窗口左移量(px)，关闭面板时恢复（不持久化）
+     */
+    private panelShiftPx;
+    /**
+     * 操作区面板宽度拖动起始值(px)
+     */
+    private panelDragStartWidth;
     /**
      * 容器上下文
      *
@@ -232,6 +290,13 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * @type {ContainerContext}
      */
     containerContext: ContainerContext;
+    /**
+     * 同步 props 到容器上下文（引用仅在值变化时替换，保证消费者按需重渲染）
+     *
+     * @return {*}
+     * @memberof ChatContainer
+     */
+    syncContainerContext(): void;
     /**
      * 计算AI窗口样式
      *
@@ -249,6 +314,7 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     };
     /**
      * 计算靠边模式样式
+     * - 贴右模式下面板打开时窗口整体左移，保证右边缘不超出屏幕
      *
      * @param {('left' | 'right')} side
      * @memberof ChatContainer
@@ -348,7 +414,7 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      */
     handleSidebarResizeEnd: () => void;
     /**
-     * 将侧栏宽度校正到合理区间 [200, 容器宽度/2, 右侧最小宽]
+     * 将侧栏宽度校正到合理区间 [200, 容器宽度/3, 容器宽度-右侧最小宽]
      */
     clampSidebarWidth(width: number): number;
     /**
@@ -393,6 +459,24 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 提交拖动边框后的输入区高度（持久化到状态与本地缓存）
      */
     commitInputHeight: () => void;
+    /**
+     * 操作区面板宽度拖动开始
+     */
+    handlePanelResizeStart: () => void;
+    /**
+     * 操作区面板宽度拖动中
+     * - 向左拖：主内容区变窄、面板变宽；向右拖反之
+     */
+    handlePanelResizeMove: (delta: number) => void;
+    /**
+     * 操作区面板宽度拖动结束（持久化）
+     */
+    handlePanelResizeEnd: () => void;
+    /**
+     * 绘制右侧操作区（含分隔条）
+     * - DOM 常驻，宽度随 visible 切换由 CSS 过渡展开/收起
+     */
+    renderActionRegion(): JSX.Element | null;
     render(): JSX.Element;
 }
 export {};

package/dist/types/components/chat-editor/node/mention-node.d.ts

@@ -0,0 +1,3 @@
+import { Node } from '@tiptap/core';
+
+export declare const MentionNode: Node<any, any>;

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

@@ -0,0 +1,18 @@
+import { FileSystemController } from '../../controller';
+
+interface ChatFilePreviewProps {
+    /**
+     * @description 文件路径
+     * @type {IFile}
+     * @memberof ChatFilePreviewProps
+     */
+    filePath?: string;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof ChatFilePreviewProps
+     */
+    controller: FileSystemController;
+}
+export declare const ChatFilePreview: (props: ChatFilePreviewProps) => import("preact").JSX.Element;
+export {};

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

@@ -0,0 +1,7 @@
+import { FileSystemController } from '../../controller';
+
+interface ChatNetDiskProps {
+    controller: FileSystemController;
+}
+export declare const ChatNetDisk: (props: ChatNetDiskProps) => import("preact").JSX.Element;
+export {};

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

@@ -0,0 +1,23 @@
+
+interface BreadcrumbProps {
+    /**
+     * 当前路径（非根 -> 当前层）
+     */
+    path: {
+        id: string;
+        label: string;
+    }[];
+    /**
+     * 根节点
+     */
+    root?: {
+        id: string;
+        label: string;
+    };
+    /**
+     * 点击某一层跳转，-1 表示回到根
+     */
+    onJump: (index: number) => void;
+}
+export declare const Breadcrumb: (props: BreadcrumbProps) => import("preact").JSX.Element;
+export {};

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

@@ -0,0 +1,28 @@
+import { h } from 'preact';
+
+interface DrawerProps {
+    /** 抽屉内容组件（函数组件 / 类组件） */
+    content: any;
+    /** 传递给内容组件的参数（onClose 会被自动注入） */
+    contentProps?: Record<string, any>;
+    /** 弹出方向 */
+    placement?: 'left' | 'right' | 'top' | 'bottom';
+    /** 宽（左右）/ 高（上下），number(px) 或 字符串(如 '50%') */
+    size?: number | string;
+    /** 指定容器（DOM 元素），不传则默认 body */
+    container?: HTMLElement;
+    /** 关闭回调（由 DrawerManager 注入） */
+    onClose?: () => void;
+    /** 是否显示遮罩，默认 true */
+    mask?: boolean;
+    /** 是否显示右上角关闭按钮，默认 true */
+    showClose?: boolean;
+    /** 点击遮罩是否关闭，默认 true */
+    maskClosable?: boolean;
+    /** 外部扩展类名 */
+    className?: string;
+    /** 标题 */
+    title?: string;
+}
+export declare const Drawer: (props: DrawerProps) => h.JSX.Element;
+export {};

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

@@ -0,0 +1,69 @@
+import { LazyTreeNode } from '../lazy-tree/lazy-tree';
+
+interface LazyListTreeProps {
+    /**
+     * 根节点数据
+     */
+    nodes: LazyTreeNode[];
+    /**
+     * 异步加载子节点方法
+     * 返回子节点数组
+     */
+    lazyLoad?: (node: LazyTreeNode) => Promise<LazyTreeNode[]>;
+    /**
+     * 节点选中回调
+     */
+    onNodeCheck?: (node: LazyTreeNode, checked: boolean) => void;
+    /**
+     * 节点点击回调
+     */
+    onNodeClick?: (node: LazyTreeNode, event: MouseEvent) => void;
+    /**
+     * 节点展开回调
+     */
+    onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    /**
+     * 路径变化回调，用于父组件同步面包屑
+     */
+    onPathChange?: (path: LazyTreeNode[]) => void;
+    /**
+     * 受控路径（根 -> 当前层），由父组件传入
+     */
+    path?: LazyTreeNode[];
+    /**
+     * 是否显示搜索框
+     */
+    showSearch?: boolean;
+    /**
+     * 默认选中keys
+     */
+    defaultCheckedKeys?: string[];
+    /**
+     * 高亮选中
+     */
+    highlight?: boolean;
+    /**
+     * 标识分隔符
+     */
+    separator?: string;
+    /**
+     * 过滤值
+     */
+    filter?: string;
+    /**
+     * 是否可拖拽
+     */
+    draggable?: boolean;
+}
+export interface LazyListTreeRef {
+    /**
+     * 重载节点
+     * @param node
+     * @returns
+     */
+    overloadNode: (node: LazyTreeNode) => Promise<void>;
+}
+export declare const LazyListTree: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<LazyListTreeProps> & {
+    ref?: import('preact').Ref<LazyListTreeRef> | undefined;
+}>;
+export {};

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

@@ -40,8 +40,18 @@ export interface LazyTreeNode {
      * 自定义图标
      */
     icon?: string;
+    /**
+     * 原始数据
+     */
+    data: Record<string, any>;
+    /**
+     * @description 根节点标识
+     * @type {string}
+     * @memberof LazyTreeNode
+     */
+    rootId: string;
 }
-export interface LazyTreeProps {
+interface LazyTreeProps {
     /**
      * 根节点数据
      */
@@ -63,6 +73,14 @@ export interface LazyTreeProps {
      * 节点展开回调
      */
     onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    /**
+     * 当前活动路径变化回调（用户最后点击/展开的路径）
+     */
+    onActivePathChange?: (path: LazyTreeNode[]) => void;
+    /**
+     * 当前激活路径
+     */
+    activePath?: LazyTreeNode[];
     /**
      * 是否显示搜索框
      */
@@ -75,6 +93,10 @@ export interface LazyTreeProps {
      * 高亮选中
      */
     highlight?: boolean;
+    /**
+     * 高亮选中父节点
+     */
+    highlightParent?: boolean;
     /**
      * 是否在点击节点的时候展开或者收缩节点
      */
@@ -83,6 +105,14 @@ export interface LazyTreeProps {
      * 标识分隔符
      */
     separator?: string;
+    /**
+     * 过滤值
+     */
+    filter?: string;
+    /**
+     * 是否可拖拽
+     */
+    draggable?: boolean;
 }
 /**
  * 懒加载树组件
@@ -90,3 +120,4 @@ export interface LazyTreeProps {
  * 具有懒加载、搜索、展开折叠等功能
  */
 export declare const LazyTree: (props: LazyTreeProps) => import("preact").JSX.Element;
+export {};

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

@@ -1,6 +1,7 @@
 import { Component, RefObject, JSX } from 'preact';
 import { Namespace } from '../../utils';
 import { AiChatController, AiTopicController } from '../../controller';
+import { AiActionPanelController } from '../../controller/ai-action-panel/ai-action-panel.controller';
 import { IChatToolbarItem, IExtensionOptions } from '../../interface';
 
 export interface FlatChatContainerProps {
@@ -54,10 +55,17 @@ export interface FlatChatContainerProps {
      * @memberof FlatChatContainerProps
      */
     extension?: IExtensionOptions;
+    /**
+     * @description 操作区面板控制器
+     * @type {AiActionPanelController}
+     * @memberof FlatChatContainerProps
+     */
+    actionPanel?: AiActionPanelController;
 }
 interface FlatContainerContext {
     enableBackFill: boolean;
 }
+export declare const DEFAULT_FLAT_CONTAINER_CONTEXT: FlatContainerContext;
 export declare const FlatContainerContext: import('preact').Context<FlatContainerContext>;
 /**
  * 平铺聊天容器，无拖拽/缩放/全屏/最小化，铺满外部容器
@@ -92,6 +100,14 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * 输入区高度拖动时其父容器高度(px)
      */
     inputDragContainerHeight: number;
+    /**
+     * 操作区面板上一帧显示状态（用于 componentDidUpdate 边沿检测）
+     */
+    private panelVisiblePrev;
+    /**
+     * 操作区面板宽度拖动起始值(px)
+     */
+    private panelDragStartWidth;
     state: {
         mountedSlots: Record<string, boolean>;
         inputHeight: number | null;
@@ -116,6 +132,11 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * @memberof FlatChatContainer
      */
     componentDidUpdate(prevProps: FlatChatContainerProps): void;
+    /**
+     * @description 同步操作区面板状态（展开收起动画由 CSS 过渡完成）
+     * @memberof FlatChatContainer
+     */
+    syncPanelState(): void;
     /**
      * @description 异步挂载扩展插槽
      * @private
@@ -153,6 +174,19 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * 侧栏宽度拖动结束
      */
     handleSidebarResizeEnd: () => void;
+    /**
+     * 操作区面板宽度拖动开始
+     */
+    handlePanelResizeStart: () => void;
+    /**
+     * 操作区面板宽度拖动中
+     * - 向左拖：主内容区变窄、面板变宽；向右拖反之
+     */
+    handlePanelResizeMove: (delta: number) => void;
+    /**
+     * 操作区面板宽度拖动结束（持久化）
+     */
+    handlePanelResizeEnd: () => void;
     /**
      * @description 获取输入区高度缓存key
      * @returns {string}
@@ -189,6 +223,12 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * @memberof FlatChatContainer
      */
     renderHeader(): JSX.Element;
+    /**
+     * @description 绘制右侧操作区（含分隔条）
+     * - DOM 常驻，宽度随 visible 切换由 CSS 过渡展开/收起
+     * @memberof FlatChatContainer
+     */
+    renderActionRegion(): JSX.Element | null;
     render(): JSX.Element;
 }
 export {};

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

@@ -1,4 +1,5 @@
 export { ChatContainer } from './chat-container/chat-container';
 export { FlatChatContainer } from './flat-chat-container/flat-chat-container';
+export { ChatActionPanel } from './chat-action-panel/chat-action-panel';
 export { SimpleChatContainer } from './simple-chat-container/simple-chat-container';
 export { ChatQuesition } from './chat-quesition/chat-quesition';

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

@@ -18,6 +18,14 @@ export declare enum AIChatConst {
      * 聊天输入区高度缓存
      */
     INPUT_HEIGHT = "ai-chat-input-height",
+    /**
+     * 操作区面板宽度缓存
+     */
+    ACTION_PANEL_WIDTH = "ai-chat-action-panel-width",
+    /**
+     * 操作区面板默认宽度(px)
+     */
+    ACTION_PANEL_DEFAULT_WIDTH = 380,
     /**
      * 数据库名称
      */

package/dist/types/controller/ai-action-panel/ai-action-panel.controller.d.ts

@@ -0,0 +1,119 @@
+import { Signal } from '@preact/signals';
+import { TActionPanelComponent } from '../../interface';
+
+/**
+ * 将操作区面板宽度校正到合理区间 [最小宽度, 容器宽度/3]
+ *
+ * @param {number} width 目标宽度
+ * @param {number} containerWidth 容器整体宽度
+ * @returns {*} {number}
+ */
+export declare function clampPanelWidth(width: number, containerWidth: number): number;
+/**
+ * 操作区面板控制器
+ * - 面板为容器级单例，挂在 ChatBaseController 上，切话题不重建
+ * - 展开收起动画由容器 CSS 过渡完成，控制器不参与
+ *
+ * @export
+ * @class AiActionPanelController
+ */
+export declare class AiActionPanelController {
+    /**
+     * 面板是否显示
+     */
+    readonly visible: Signal<boolean>;
+    /**
+     * 面板当前宽度(px)
+     */
+    readonly width: Signal<number>;
+    /**
+     * 面板标题
+     */
+    readonly caption: Signal<string>;
+    /**
+     * 面板内容组件
+     */
+    readonly component: Signal<TActionPanelComponent | undefined>;
+    /**
+     * 内容组件额外参数
+     */
+    readonly params: Signal<Record<string, any> | undefined>;
+    /**
+     * 当前业务域key（渲染内容组件时作为key传入，不同业务域切换时强制重挂载）
+     */
+    readonly key: Signal<string>;
+    /**
+     * 组件外层容器id（用于宽度缓存隔离）
+     */
+    private compWrapperId;
+    /**
+     * 打开操作区面板
+     * - 已打开时仅替换标题、内容组件与额外参数
+     * - 首次打开时从缓存恢复面板宽度（无缓存则沿用当前值）
+     *
+     * @param {string} caption 标题
+     * @param {TActionPanelComponent} component 内容组件
+     * @param {Record<string, any>} [params] 额外参数（作为内容组件props传入）
+     * @param {string} [key] 业务域key（内容组件渲染key，不同业务域切换时强制重挂载）
+     * @memberof AiActionPanelController
+     */
+    open(caption: string, component: TActionPanelComponent, params?: Record<string, any>, key?: string): void;
+    /**
+     * 刷新面板内容（会话切换时调用）
+     * - 面板未打开时不做处理（下次 open 会生成全新参数）
+     * - 新旧 key 一致时跳过刷新（同一业务域无需重挂载）
+     * - params 中包含 controller 时替换为激活会话的控制器
+     * - 重置 key 强制内容组件重挂载并重新加载数据
+     *
+     * @param {string} [key] 业务域key（未传时生成 uuid 强制刷新）
+     * @param {unknown} [controller] 激活会话的聊天控制器
+     * @memberof AiActionPanelController
+     */
+    refresh(key?: string, controller?: unknown): void;
+    /**
+     * 关闭操作区面板（收起动画由容器 CSS 过渡完成）
+     *
+     * @memberof AiActionPanelController
+     */
+    close(): void;
+    /**
+     * 更新面板宽度
+     *
+     * @param {number} px 宽度(px)
+     * @memberof AiActionPanelController
+     */
+    updateWidth(px: number): void;
+    /**
+     * 提交当前宽度（持久化）
+     *
+     * @memberof AiActionPanelController
+     */
+    commitWidth(): void;
+    /**
+     * 注入组件外层容器id
+     *
+     * @param {string} id
+     * @memberof AiActionPanelController
+     */
+    injectCompWrapperId(id: string): void;
+    /**
+     * 读取宽度缓存
+     *
+     * @returns {*} {(number | undefined)}
+     * @memberof AiActionPanelController
+     */
+    readWidthCache(): number | undefined;
+    /**
+     * 重置全部状态（整个聊天窗口关闭时调用）
+     *
+     * @memberof AiActionPanelController
+     */
+    reset(): void;
+    /**
+     * 获取宽度缓存key
+     *
+     * @returns {string}
+     * @memberof AiActionPanelController
+     */
+    private getCacheKey;
+}