@opentiny/tiny-robot 0.5.0 → 0.5.1-alpha.1

package/dist/sender/components/layouts/MultiLineLayout.vue.d.ts

@@ -0,0 +1,43 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        prefix?(_: {}): any;
+        content?(_: {
+            editor: import('vue').Ref<import('@tiptap/vue-3').Editor | undefined, import('@tiptap/vue-3').Editor | undefined>;
+        }): any;
+        footer?(_: {
+            editor: import('@tiptap/core').Editor | undefined;
+            focus: () => void;
+            blur: () => void;
+            insert: (content: string) => void;
+            append: (content: string) => void;
+            replace: (content: string) => void;
+            disabled: boolean;
+            loading: boolean;
+            hasContent: boolean;
+        }): any;
+        'footer-right'?(_: {
+            editor: import('@tiptap/core').Editor | undefined;
+            focus: () => void;
+            blur: () => void;
+            insert: (content: string) => void;
+            append: (content: string) => void;
+            replace: (content: string) => void;
+            disabled: boolean;
+            loading: boolean;
+            hasContent: boolean;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/sender/components/layouts/SingleLineLayout.vue.d.ts

@@ -0,0 +1,32 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        prefix?(_: {}): any;
+        content?(_: {
+            editor: import('@tiptap/vue-3').Editor | undefined;
+        }): any;
+        'actions-inline'?(_: {
+            editor: import('@tiptap/core').Editor | undefined;
+            focus: () => void;
+            blur: () => void;
+            insert: (content: string) => void;
+            append: (content: string) => void;
+            replace: (content: string) => void;
+            disabled: boolean;
+            loading: boolean;
+            hasContent: boolean;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/sender/composables/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Composables 统一导出
+ */
+export { useEditor } from './useEditor';
+export { useAutoSize } from './useAutoSize';
+export { useModeSwitch } from './useModeSwitch';
+export type { UseEditorReturn } from '../index.type';

package/dist/sender/composables/useAutoSize.d.ts

@@ -0,0 +1,5 @@
+import { Ref } from 'vue';
+import { InputMode, AutoSize } from '../index.type';
+export declare function useAutoSize(currentMode: Ref<InputMode>, editorRef: Ref<HTMLElement | null>, autoSize?: AutoSize): {
+    updateHeight: () => void;
+};

package/dist/sender/composables/useEditor.d.ts

@@ -0,0 +1,13 @@
+import { SenderEmits, UseEditorReturn } from '../index.type';
+import { SenderPropsWithDefaults } from '../index.vue';
+/**
+ * 编辑器 Hook
+ *
+ * 职责：
+ * - 初始化编辑器
+ * - 管理编辑器状态
+ * - 处理编辑器事件
+ * - 提供编辑器实例
+ *
+ */
+export declare function useEditor(props: SenderPropsWithDefaults, emit: SenderEmits): UseEditorReturn;

package/dist/sender/composables/useKeyboardShortcuts.d.ts

@@ -0,0 +1,7 @@
+import { UseKeyboardShortcutsParams, UseKeyboardShortcutsReturn } from '../index.type';
+/**
+ * 键盘快捷键 Hook
+ *
+ * 提供统一的键盘快捷键逻辑
+ */
+export declare function useKeyboardShortcuts(params: UseKeyboardShortcutsParams): UseKeyboardShortcutsReturn;

package/dist/sender/composables/useModeSwitch.d.ts

@@ -0,0 +1,4 @@
+import { Ref } from 'vue';
+import { Editor } from '@tiptap/vue-3';
+import { SenderProps, UseModeSwitchReturn } from '../index.type';
+export declare function useModeSwitch(props: SenderProps, editor: Ref<Editor | undefined>, editorRef: Ref<HTMLElement | null>): UseModeSwitchReturn;

package/dist/sender/composables/useSenderCore.d.ts

@@ -0,0 +1,31 @@
+import { SenderEmits } from '../index.type';
+import { SenderPropsWithDefaults } from '../index.vue';
+import { SenderContext } from '../types/context';
+/**
+ * useSenderCore 返回类型
+ */
+export interface UseSenderCoreReturn {
+    /**
+     * Context 对象（用于 provide）
+     */
+    context: SenderContext;
+    /**
+     * 需要暴露给父组件的方法（用于 defineExpose）
+     */
+    expose: {
+        submit: () => void;
+        clear: () => void;
+        cancel: () => void;
+        focus: () => void;
+        blur: () => void;
+        setContent: (content: string) => void;
+        getContent: () => string;
+        editor: SenderContext['editor'];
+    };
+}
+/**
+ * Sender 核心逻辑 Hook
+ *
+ * 一键获取完整的 context 和 expose 对象
+ */
+export declare function useSenderCore(props: SenderPropsWithDefaults, emit: SenderEmits): UseSenderCoreReturn;

package/dist/sender/composables/useSlotScope.d.ts

@@ -0,0 +1,10 @@
+import { ComputedRef } from 'vue';
+import { SenderSlotScope } from '../types/slots';
+/**
+ * 使用插槽作用域
+ *
+ * 为增强按钮提供便捷的操作方法和常用状态
+ *
+ * @returns SenderSlotScope computed 对象
+ */
+export declare function useSlotScope(): ComputedRef<SenderSlotScope>;

package/dist/sender/context/index.d.ts

@@ -0,0 +1,6 @@
+import { SenderContext } from './types';
+/**
+ * 获取 Sender Context
+ */
+export declare function useSenderContext(): SenderContext;
+export * from './types';

package/dist/sender/context/types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Context 相关类型定义
+ *
+ * 注意：SenderContext 类型定义在 index.type.ts 中
+ * 这里只做类型导出，避免重复定义
+ */
+export type { SenderContext } from '../index.type';

package/dist/sender/extensions/constants.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 扩展名称常量
+ *
+ * 用于 TipTap 扩展定义中的 name 属性
+ * 这些是注册到编辑器的扩展名称
+ */
+export declare const EXTENSION_NAMES: {
+    /** Template 扩展（包含 TemplateBlock 和 TemplateSelect 子扩展） */
+    readonly TEMPLATE: "template";
+    /** Mention 扩展 */
+    readonly MENTION: "mention";
+    /** Suggestion 扩展 */
+    readonly SUGGESTION: "suggestion";
+};
+/**
+ * ProseMirror 节点类型名称常量
+ *
+ * 用于 node.type.name 检查和节点创建
+ * 这些是 ProseMirror Schema 中注册的节点类型名称
+ */
+export declare const NODE_TYPE_NAMES: {
+    /** TemplateBlock 节点类型（可编辑块） */
+    readonly TEMPLATE_BLOCK: "templateBlock";
+    /** TemplateSelect 节点类型（下拉选择） */
+    readonly TEMPLATE_SELECT: "templateSelect";
+    /** Mention 节点类型 */
+    readonly MENTION: "mention";
+    /** Paragraph 节点类型（ProseMirror 内置） */
+    readonly PARAGRAPH: "paragraph";
+    /** Text 节点类型（ProseMirror 内置） */
+    readonly TEXT: "text";
+};
+/**
+ * ProseMirror 插件 Key 名称常量
+ */
+export declare const PLUGIN_KEY_NAMES: {
+    /** Mention 插件 */
+    readonly MENTION: "mention";
+    /** Suggestion 插件 */
+    readonly SUGGESTION: "suggestion";
+    /** Template Select 下拉菜单插件 */
+    readonly TEMPLATE_SELECT_DROPDOWN: "templateSelectDropdown";
+    /** Template Select 零宽字符插件 */
+    readonly TEMPLATE_SELECT_ZERO_WIDTH: "templateSelectZeroWidth";
+    /** Template Select 键盘导航插件 */
+    readonly TEMPLATE_SELECT_KEYBOARD: "templateSelectKeyboard";
+    /** Template Block 零宽字符插件 */
+    readonly TEMPLATE_BLOCK_ZERO_WIDTH: "templateBlockZeroWidth";
+    /** Template Block 键盘导航插件 */
+    readonly TEMPLATE_BLOCK_KEYBOARD: "templateBlockKeyboard";
+    /** Template Block 粘贴处理插件 */
+    readonly TEMPLATE_BLOCK_PASTE: "templateBlockPaste";
+};
+/**
+ * 用户 API 类型常量
+ *
+ * 用于 TemplateItem 等用户 API 中的 type 字段
+ * 这些是暴露给用户的类型名称，与内部节点类型可能不同
+ */
+export declare const USER_API_TYPES: {
+    /** 文本类型 */
+    readonly TEXT: "text";
+    /** 模板块类型（对应内部的 TemplateBlock 节点） */
+    readonly BLOCK: "block";
+    /** 选择器类型（对应内部的 TemplateSelect 节点） */
+    readonly SELECT: "select";
+    /** Mention 类型 */
+    readonly MENTION: "mention";
+};
+/**
+ * 键盘按键常量
+ */
+export declare const KEYBOARD_KEYS: {
+    /** Enter 键 */
+    readonly ENTER: "Enter";
+    /** Escape 键 */
+    readonly ESCAPE: "Escape";
+    /** Tab 键 */
+    readonly TAB: "Tab";
+    /** Backspace 键 */
+    readonly BACKSPACE: "Backspace";
+    /** Delete 键 */
+    readonly DELETE: "Delete";
+    /** 上箭头键 */
+    readonly ARROW_UP: "ArrowUp";
+    /** 下箭头键 */
+    readonly ARROW_DOWN: "ArrowDown";
+    /** 左箭头键 */
+    readonly ARROW_LEFT: "ArrowLeft";
+    /** 右箭头键 */
+    readonly ARROW_RIGHT: "ArrowRight";
+    /** 空格键 */
+    readonly SPACE: " ";
+};

package/dist/sender/extensions/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tiptap 扩展统一导出
+ */
+export { Mention, mention, MentionPluginKey } from './mention';
+export { getMentions, getTextWithMentions, getMentionStructuredData } from './mention';
+export type { MentionAttrs, MentionOptions, MentionItem, MentionStructuredItem } from './mention';
+export { Suggestion, suggestion, SuggestionPluginKey } from './suggestion';
+export { syncAutoComplete, processHighlights, highlightSuggestionText } from './suggestion';
+export type { SenderSuggestionItem, SuggestionOptions, SuggestionState, SuggestionTextPart, HighlightFunction, } from './suggestion';
+export { Template, template } from './template';
+export { getTemplateStructuredData, getTextWithTemplates, TemplateSelectDropdownPluginKey } from './template';
+export type { TemplateAttrs, TemplateOptions } from './template';

package/dist/sender/extensions/mention/commands.d.ts

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/core';
+import { MentionAttrs } from './types';
+/**
+ * Mention 命令集合
+ */
+export declare const mentionCommands: {
+    /**
+     * 插入 mention 节点
+     */
+    insertMention: (attrs: Partial<MentionAttrs>) => ({ commands }: {
+        commands: Editor["commands"];
+    }) => boolean;
+    /**
+     * 删除 mention 节点
+     */
+    deleteMention: (id: string) => ({ tr, state }: {
+        tr: Editor["state"]["tr"];
+        state: Editor["state"];
+    }) => boolean;
+};

package/dist/sender/extensions/mention/components/mention-list.vue.d.ts

@@ -0,0 +1,18 @@
+import { MentionItem } from '../types';
+interface Props {
+    items: MentionItem[];
+    command: (props: {
+        id?: string;
+        label: string;
+        value?: string;
+    }) => void;
+}
+declare function onKeyDown({ event }: {
+    event: KeyboardEvent;
+}): boolean;
+declare const _default: import('vue').DefineComponent<Props, {
+    onKeyDown: typeof onKeyDown;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    listRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/sender/extensions/mention/components/mention-view.vue.d.ts

@@ -0,0 +1,19 @@
+interface NodeAttrs {
+    id: string;
+    label: string;
+    value?: string;
+    [key: string]: unknown;
+}
+interface Props {
+    node: {
+        attrs: NodeAttrs;
+        [key: string]: unknown;
+    };
+    extension: {
+        options: {
+            char: string;
+        };
+    };
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/sender/extensions/mention/extension.d.ts

@@ -0,0 +1,6 @@
+import { Node } from '@tiptap/core';
+import { MentionOptions } from './types';
+/**
+ * Mention 扩展定义
+ */
+export declare const Mention: Node<MentionOptions, any>;

package/dist/sender/extensions/mention/index.d.ts

@@ -0,0 +1,22 @@
+import { Ref } from 'vue';
+import { MentionItem, MentionOptions } from './types';
+export { Mention } from './extension';
+export { MentionPluginKey } from './plugin';
+export { mentionCommands } from './commands';
+export * from './types';
+export * from './utils';
+/**
+ * 创建 Mention 扩展的便捷函数
+ *
+ * @param items - 提及项列表
+ * @param char - 触发字符，默认 '@'
+ * @param options - 其他配置项
+ *
+ * @example
+ * ```typescript
+ * const extensions = [mention(items)]
+ * const extensions = [mention(items, '#')]
+ * const extensions = [mention(items, '@', { allowSpaces: true })]
+ * ```
+ */
+export declare function mention(items: MentionItem[] | Ref<MentionItem[]>, char?: string, options?: Partial<Omit<MentionOptions, 'items' | 'char'>>): import('@tiptap/core').Node<MentionOptions, any>;

package/dist/sender/extensions/mention/plugin.d.ts

@@ -0,0 +1,16 @@
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Editor } from '@tiptap/core';
+import { Ref } from 'vue';
+import { MentionItem, MentionSuggestionState } from './types';
+export declare const MentionPluginKey: PluginKey<MentionSuggestionState>;
+interface PluginOptions {
+    editor: Editor;
+    char: string;
+    items: MentionItem[] | Ref<MentionItem[]>;
+    allowSpaces: boolean;
+}
+/**
+ * 创建 Suggestion 插件
+ */
+export declare function createSuggestionPlugin(options: PluginOptions): Plugin;
+export {};

package/dist/sender/extensions/mention/types.d.ts

@@ -0,0 +1,126 @@
+import { Ref } from 'vue';
+/**
+ * 提及项数据结构（用户侧）
+ *
+ * 用户传入的数据格式，id 可选，插件会自动生成
+ */
+export interface MentionItem {
+    /**
+     * 唯一标识（可选）
+     *
+     * 如果不提供，插件会自动生成
+     */
+    id?: string;
+    /**
+     * 显示名称，如 "小小画家"（必传）
+     */
+    label: string;
+    /**
+     * 关联值（必传）
+     *
+     * 可以是任意字符串值，如 AI 提示词、用户 ID、标签内容等
+     */
+    value: string;
+    /**
+     * 图标（可选）
+     */
+    icon?: string;
+}
+/**
+ * 结构化数据项（提交时返回）
+ *
+ * 用于表示文本和 mention 的混合结构
+ */
+export type MentionStructuredItem = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'mention';
+    content: string;
+    value: string;
+};
+/**
+ * Mention 节点属性（内部使用）
+ *
+ * ProseMirror 节点的属性，id 必填（由插件保证）
+ */
+export interface MentionAttrs {
+    /**
+     * 唯一标识（必填）
+     *
+     * 由插件自动生成或使用用户提供的值
+     */
+    id: string;
+    /**
+     * 显示名称
+     */
+    label: string;
+    /**
+     * 关联值（可选）
+     */
+    value?: string;
+}
+/**
+ * Mention 配置选项
+ */
+export interface MentionOptions {
+    /**
+     * 提及项列表
+     */
+    items: MentionItem[] | Ref<MentionItem[]>;
+    /**
+     * 触发字符，默认 '@'
+     */
+    char: string;
+    /**
+     * 是否允许空格，默认 false
+     */
+    allowSpaces?: boolean;
+    /**
+     * HTML 属性
+     */
+    HTMLAttributes?: Record<string, unknown>;
+}
+/**
+ * Mention Suggestion 插件状态
+ */
+export interface MentionSuggestionState {
+    /**
+     * 是否激活
+     */
+    active: boolean;
+    /**
+     * 触发范围
+     */
+    range: {
+        from: number;
+        to: number;
+    } | null;
+    /**
+     * 查询文本
+     */
+    query: string;
+    /**
+     * 过滤后的提及项列表
+     */
+    filteredItems: MentionItem[];
+}
+/**
+ * 扩展 Tiptap Commands 接口
+ *
+ * 使 TypeScript 能够识别自定义命令
+ */
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        mention: {
+            /**
+             * 插入 mention 节点
+             */
+            insertMention: (attrs: Partial<MentionAttrs>) => ReturnType;
+            /**
+             * 删除 mention 节点
+             */
+            deleteMention: (id: string) => ReturnType;
+        };
+    }
+}

package/dist/sender/extensions/mention/utils.d.ts

@@ -0,0 +1,34 @@
+import { Editor } from '@tiptap/core';
+import { MentionItem, MentionStructuredItem } from './types';
+/**
+ * 获取所有 mention 节点（辅助函数）
+ *
+ * 返回文档中所有的 mention 节点数据
+ */
+export declare function getMentions(editor: Editor): MentionItem[];
+/**
+ * 获取包含 mention 标签的完整文本
+ *
+ * 自动从编辑器中获取 mention 扩展的 char 配置
+ *
+ * @param editor - 编辑器实例
+ *
+ * @example
+ * getTextWithMentions(editor) // @代码分析 hello world @文本分析 12315
+ * // 如果配置了 char: '#'，则返回：#代码分析 hello world #文本分析 12315
+ */
+export declare function getTextWithMentions(editor: Editor): string;
+/**
+ * 获取结构化数据（包含文本和 mention 的混合结构）
+ *
+ * 返回按顺序排列的文本和 mention 节点，用于确认内容和顺序
+ *
+ * @example
+ * 输入：帮我分析 @张三 的周报（或 #标签 等，取决于 char 配置）
+ * 返回：[
+ *   { type: 'text', content: '帮我分析 ' },
+ *   { type: 'mention', content: '张三', value: '...' },
+ *   { type: 'text', content: ' 的周报' }
+ * ]
+ */
+export declare function getMentionStructuredData(editor: Editor): MentionStructuredItem[];

package/dist/sender/extensions/suggestion/extension.d.ts

@@ -0,0 +1,8 @@
+import { Extension } from '@tiptap/core';
+import { SuggestionOptions } from './types';
+/**
+ * Suggestion 扩展定义
+ *
+ * 支持全局匹配模式的智能联想功能
+ */
+export declare const Suggestion: Extension<SuggestionOptions, any>;

package/dist/sender/extensions/suggestion/index.d.ts

@@ -0,0 +1,20 @@
+import { Ref } from 'vue';
+import { SenderSuggestionItem, SuggestionOptions } from './types';
+export { Suggestion } from './extension';
+export { SuggestionPluginKey } from './plugin';
+export * from './types';
+export { syncAutoComplete } from './utils/filter';
+export { processHighlights, highlightSuggestionText, convertHighlightsArrayToTextParts } from './utils/highlight';
+/**
+ * 创建 Suggestion 扩展的便捷函数
+ *
+ * @param items - 建议项列表
+ * @param options - 其他配置项
+ *
+ * @example
+ * ```typescript
+ * const extensions = [suggestion(suggestions)]
+ * const extensions = [suggestion(suggestions, { popupWidth: 500 })]
+ * ```
+ */
+export declare function suggestion(items: SenderSuggestionItem[] | Ref<SenderSuggestionItem[]>, options?: Partial<Omit<SuggestionOptions, 'items'>>): import('@tiptap/core').Extension<SuggestionOptions, any>;

package/dist/sender/extensions/suggestion/plugin.d.ts

@@ -0,0 +1,21 @@
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Editor } from '@tiptap/core';
+import { SuggestionOptions, SuggestionState } from './types';
+/**
+ * 插件 Key，用于访问插件状态
+ */
+export declare const SuggestionPluginKey: PluginKey<SuggestionState>;
+/**
+ * 插件配置接口
+ */
+interface PluginOptions extends SuggestionOptions {
+    editor: Editor;
+}
+/**
+ * 创建 Suggestion 插件
+ *
+ * @param options - 插件配置
+ * @returns ProseMirror 插件
+ */
+export declare function createSuggestionPlugin(options: PluginOptions): Plugin;
+export {};

package/dist/sender/extensions/suggestion/suggestion-list.vue.d.ts

@@ -0,0 +1,46 @@
+import { SenderSuggestionItem } from './types';
+/**
+ * 建议列表组件 Props
+ */
+export interface Props {
+    /**
+     * 是否显示
+     */
+    show: boolean;
+    /**
+     * 建议项列表
+     */
+    suggestions: SenderSuggestionItem[];
+    /**
+     * 弹窗样式
+     */
+    popupStyle: Record<string, string | number>;
+    /**
+     * 键盘选中的索引
+     */
+    activeKeyboardIndex: number;
+    /**
+     * 鼠标悬停的索引
+     */
+    activeMouseIndex: number;
+    /**
+     * 用户输入的文本
+     */
+    inputValue: string;
+    /**
+     * 选择回调函数
+     */
+    onSelect?: (item: SenderSuggestionItem) => void;
+    /**
+     * 鼠标进入回调函数
+     */
+    onMouseEnter?: (index: number) => void;
+    /**
+     * 鼠标离开回调函数
+     */
+    onMouseLeave?: () => void;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    suggestionsListRef: HTMLDivElement;
+}, any>;
+export default _default;