@opentiny/tiny-robot 0.4.2-alpha.9 → 0.5.1-alpha.1

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

@@ -0,0 +1,100 @@
+import { Ref } from 'vue';
+import { TemplateItem, SelectOption } from '../../index.type';
+export type { TemplateItem, SelectOption };
+/**
+ * TemplateSelect 节点属性
+ */
+export interface TemplateSelectAttrs {
+    /**
+     * 唯一标识
+     */
+    id: string;
+    /**
+     * 占位文字（未选择时显示）
+     */
+    placeholder: string;
+    /**
+     * 选项列表
+     */
+    options: SelectOption[];
+    /**
+     * 当前选中的值（可选）
+     */
+    value?: string;
+}
+/**
+ * Template 节点属性
+ */
+export interface TemplateAttrs {
+    /**
+     * 模板块 ID
+     */
+    id: string;
+    /**
+     * 模板块内容
+     */
+    content: string;
+}
+/**
+ * Template 配置选项
+ */
+export interface TemplateOptions {
+    /**
+     * 模板数据列表（推荐使用 ref 实现响应式）
+     *
+     * 支持两种配置方式：
+     * 1. 传入 ref（推荐）：自动双向绑定，解决时序问题
+     * 2. 传入数组：仅用于静态初始化
+     *
+     * @example 响应式配置（推荐）
+     * ```typescript
+     * const items = ref<TemplateItem[]>([
+     *   { type: 'text', content: '帮我分析' },
+     *   { type: 'template', content: '' }
+     * ])
+     * Template.configure({ items })  // 传入 ref，自动双向绑定
+     * ```
+     *
+     * @example 静态配置
+     * ```typescript
+     * Template.configure({
+     *   items: [
+     *     { type: 'text', content: '帮我分析' },
+     *     { type: 'template', content: '' }
+     *   ]
+     * })
+     * ```
+     */
+    items?: TemplateItem[] | Ref<TemplateItem[]>;
+    /**
+     * HTML 属性
+     */
+    HTMLAttributes?: Record<string, unknown>;
+}
+/**
+ * 扩展 Tiptap Commands 接口
+ *
+ * 使 TypeScript 能够识别自定义命令
+ */
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        template: {
+            /**
+             * 设置模板数据（批量）
+             */
+            setTemplateData: (items: TemplateItem[]) => ReturnType;
+            /**
+             * 插入模板块
+             */
+            insertTemplate: (attrs: Partial<TemplateAttrs>) => ReturnType;
+            /**
+             * 聚焦到第一个模板块
+             */
+            focusFirstTemplate: () => ReturnType;
+            /**
+             * 插入选择器
+             */
+            insertTemplateSelect: (attrs: Partial<TemplateSelectAttrs>) => ReturnType;
+        };
+    }
+}

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

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/core';
+import { TemplateItem } from '../../index.type';
+/**
+ * 零宽字符常量
+ * Unicode: U+200B (Zero Width Space)
+ * HTML Entity: ​
+ */
+export declare const ZERO_WIDTH_CHAR = "\u200B";
+/**
+ * 获取包含 template 的完整文本
+ *
+ * 例如：请帮我分析 [模板内容1] 和 [模板内容2]
+ */
+export declare function getTextWithTemplates(editor: Editor): string;
+/**
+ * 获取结构化数据（辅助函数）
+ *
+ * 返回包含文本和模板块的结构化数组
+ */
+export declare function getTemplateStructuredData(editor: Editor): TemplateItem[];

package/dist/sender/extensions/utils/id-generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 生成唯一 ID
+ *
+ * 用于所有扩展生成唯一标识符
+ */
+/**
+ * 生成唯一 ID
+ *
+ * @param prefix - ID 前缀
+ * @returns 唯一 ID 字符串
+ *
+ * @example
+ * generateId('mention') // mention_1701234567890_abc123def
+ * generateId('template') // template_1701234567890_xyz789uvw
+ */
+export declare function generateId(prefix: string): string;

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

@@ -0,0 +1,7 @@
+/**
+ * 共享工具函数统一导出
+ */
+export { generateId } from './id-generator';
+export { findTextRange } from './position';
+export { isKey, isAnyKey, isArrowKey, isDeleteKey } from './keyboard';
+export type { KeyboardKey } from './keyboard';

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

@@ -0,0 +1,49 @@
+import { KEYBOARD_KEYS } from '../constants';
+/**
+ * 键盘按键类型
+ */
+export type KeyboardKey = keyof typeof KEYBOARD_KEYS;
+/**
+ * 检查是否按下指定按键
+ *
+ * @param event - 键盘事件
+ * @param key - 按键名称
+ * @returns 是否按下指定按键
+ *
+ * @example
+ * if (isKey(event, 'ENTER')) { ... }
+ * if (isKey(event, 'ARROW_UP')) { ... }
+ */
+export declare const isKey: (event: KeyboardEvent, key: KeyboardKey) => boolean;
+/**
+ * 检查是否按下多个按键中的任意一个
+ *
+ * @param event - 键盘事件
+ * @param keys - 按键名称数组
+ * @returns 是否按下指定按键之一
+ *
+ * @example
+ * if (isAnyKey(event, ['ARROW_UP', 'ARROW_DOWN'])) { ... }
+ * if (isAnyKey(event, ['ENTER', 'TAB'])) { ... }
+ */
+export declare const isAnyKey: (event: KeyboardEvent, keys: KeyboardKey[]) => boolean;
+/**
+ * 检查是否按下方向键
+ *
+ * @param event - 键盘事件
+ * @returns 是否按下方向键
+ *
+ * @example
+ * if (isArrowKey(event)) { ... }
+ */
+export declare const isArrowKey: (event: KeyboardEvent) => boolean;
+/**
+ * 检查是否按下删除键（Backspace 或 Delete）
+ *
+ * @param event - 键盘事件
+ * @returns 是否按下删除键
+ *
+ * @example
+ * if (isDeleteKey(event)) { ... }
+ */
+export declare const isDeleteKey: (event: KeyboardEvent) => boolean;

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

@@ -0,0 +1,25 @@
+import { Selection } from '@tiptap/pm/state';
+/**
+ * 查找触发字符的位置和查询文本
+ *
+ * 用于 mention 和 suggestion 扩展
+ *
+ * @param selection - 当前光标位置
+ * @param char - 触发字符
+ * @param allowSpaces - 是否允许空格
+ * @returns 触发范围和查询文本，未找到返回 null
+ *
+ * @example
+ * const result = findTextRange(selection, '@', false)
+ * if (result) {
+ *   console.log(result.range) // { from: 10, to: 20 }
+ *   console.log(result.query) // 'user'
+ * }
+ */
+export declare function findTextRange(selection: Selection, char: string, allowSpaces?: boolean): {
+    range: {
+        from: number;
+        to: number;
+    };
+    query: string;
+} | null;

package/dist/sender/index.d.ts

@@ -0,0 +1,139 @@
+import { App } from 'vue';
+import { mention, suggestion, template } from './extensions';
+declare const Sender: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.type').SenderProps> & Readonly<{
+        onClear?: (() => any) | undefined;
+        onInput?: ((value: string) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        onSubmit?: ((textContent: string, structuredData?: import('./index.type').StructuredData | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    }>, {
+        submit: () => void;
+        clear: () => void;
+        cancel: () => void;
+        focus: () => void;
+        blur: () => void;
+        setContent: (content: string) => void;
+        getContent: () => string;
+        editor: import('./index.type').SenderContext["editor"];
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        clear: () => any;
+        input: (value: string) => any;
+        blur: (event: FocusEvent) => any;
+        cancel: () => any;
+        focus: (event: FocusEvent) => any;
+        submit: (textContent: string, structuredData?: import('./index.type').StructuredData | undefined) => any;
+        "update:modelValue": (value: string) => any;
+    }, import('vue').PublicProps, {
+        size: "normal" | "small";
+        placeholder: string;
+        mode: import('./index.type').InputMode;
+        enterkeyhint: import('./index.type').EnterKeyHint;
+        autoSize: import('./index.type').AutoSize;
+        hasExternalContent: boolean;
+        extensions: import('@tiptap/core').Extension[] | any[];
+        submitType: import('./index.type').SubmitTrigger;
+    }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('./index.type').SenderProps> & Readonly<{
+        onClear?: (() => any) | undefined;
+        onInput?: ((value: string) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        onSubmit?: ((textContent: string, structuredData?: import('./index.type').StructuredData | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    }>, {
+        submit: () => void;
+        clear: () => void;
+        cancel: () => void;
+        focus: () => void;
+        blur: () => void;
+        setContent: (content: string) => void;
+        getContent: () => string;
+        editor: import('./index.type').SenderContext["editor"];
+    }, {}, {}, {}, {
+        size: "normal" | "small";
+        placeholder: string;
+        mode: import('./index.type').InputMode;
+        enterkeyhint: import('./index.type').EnterKeyHint;
+        autoSize: import('./index.type').AutoSize;
+        hasExternalContent: boolean;
+        extensions: import('@tiptap/core').Extension[] | any[];
+        submitType: import('./index.type').SubmitTrigger;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('./index.type').SenderProps> & Readonly<{
+    onClear?: (() => any) | undefined;
+    onInput?: ((value: string) => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    onSubmit?: ((textContent: string, structuredData?: import('./index.type').StructuredData | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    submit: () => void;
+    clear: () => void;
+    cancel: () => void;
+    focus: () => void;
+    blur: () => void;
+    setContent: (content: string) => void;
+    getContent: () => string;
+    editor: import('./index.type').SenderContext["editor"];
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    input: (value: string) => any;
+    blur: (event: FocusEvent) => any;
+    cancel: () => any;
+    focus: (event: FocusEvent) => any;
+    submit: (textContent: string, structuredData?: import('./index.type').StructuredData | undefined) => any;
+    "update:modelValue": (value: string) => any;
+}, string, {
+    size: "normal" | "small";
+    placeholder: string;
+    mode: import('./index.type').InputMode;
+    enterkeyhint: import('./index.type').EnterKeyHint;
+    autoSize: import('./index.type').AutoSize;
+    hasExternalContent: boolean;
+    extensions: import('@tiptap/core').Extension[] | any[];
+    submitType: import('./index.type').SubmitTrigger;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        header?(_: {}): any;
+        header?(_: {}): any;
+        prefix?(_: {}): any;
+        prefix?(_: {}): any;
+        content?(_: {
+            editor: import('@tiptap/vue-3').Editor | undefined;
+        }): any;
+        content?(_: {
+            editor: import('vue').Ref<import('@tiptap/vue-3').Editor | undefined, import('@tiptap/vue-3').Editor | undefined>;
+        }): any;
+        'actions-inline'?(_: {}): any;
+        footer?(_: {}): any;
+        'footer-right'?(_: {}): any;
+    };
+}) & {
+    install: <T>(app: App<T>) => void;
+    Mention: import('@tiptap/core').Node<import('./extensions').MentionOptions, any>;
+    Suggestion: import('@tiptap/core').Extension<import('./index.type').SuggestionOptions, any>;
+    Template: import('@tiptap/core').Extension<import('./extensions').TemplateOptions, any>;
+    mention: typeof mention;
+    suggestion: typeof suggestion;
+    template: typeof template;
+};
+export default Sender;
+export type { SenderProps, SenderEmits, SenderSlots, SenderContext, UseEditorReturn, UseModeSwitchReturn, UseSuggestionReturn, UseKeyboardShortcutsReturn, TemplateItem, MentionItem, DefaultActions, } from './index.type';
+export { useSenderContext } from './context';
+export type { TemplateAttrs, TemplateOptions } from './extensions/template';
+export type { MentionAttrs, MentionOptions } from './extensions/mention';
+export type { SenderSuggestionItem, SuggestionOptions, SuggestionState, SuggestionTextPart, HighlightFunction, } from './extensions/suggestion';