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

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

@@ -0,0 +1,122 @@
+import { Ref } from 'vue';
+import { Editor } from '@tiptap/vue-3';
+import { InputMode, SubmitTrigger } from './base';
+/**
+ * 键盘处理器接口
+ */
+export interface KeyboardHandlers {
+    checkSubmitShortcut: (event: KeyboardEvent) => boolean;
+    checkNewlineShortcut: (event: KeyboardEvent) => boolean;
+    submit: () => void;
+}
+/**
+ * useKeyboardShortcuts Hook 参数
+ */
+export interface UseKeyboardShortcutsParams {
+    submitType: Ref<SubmitTrigger>;
+    canSubmit: Ref<boolean>;
+    mode: Ref<InputMode>;
+    submit: () => void;
+    setMode: (mode: InputMode) => void;
+}
+/**
+ * useKeyboardShortcuts Hook 返回值
+ */
+export interface UseKeyboardShortcutsReturn {
+    checkSubmitShortcut: (event: KeyboardEvent) => boolean;
+    checkNewlineShortcut: (event: KeyboardEvent) => boolean;
+}
+/**
+ * useEditor 返回类型
+ */
+export interface UseEditorReturn {
+    /**
+     * 编辑器实例
+     * 注意:Tiptap 的 useEditor 返回 ShallowRef<Editor | undefined>
+     */
+    editor: Ref<Editor | undefined>;
+    /**
+     * 编辑器 DOM 引用
+     */
+    editorRef: Ref<HTMLElement | null>;
+}
+/**
+ * useModeSwitch 返回类型
+ */
+export interface UseModeSwitchReturn {
+    /**
+     * 当前模式
+     */
+    currentMode: Ref<InputMode>;
+    /**
+     * 是否正在自动切换
+     */
+    isAutoSwitching: Ref<boolean>;
+    /**
+     * 设置模式
+     *
+     * @param mode - 输入模式
+     */
+    setMode: (mode: InputMode) => void;
+    /**
+     * 检查内容溢出
+     *
+     * 用于自动切换模式
+     */
+    checkOverflow: () => void;
+}
+/**
+ * useSuggestion 返回类型
+ */
+export interface UseSuggestionReturn {
+    /**
+     * 弹窗是否可见
+     */
+    isPopupVisible: Ref<boolean>;
+    /**
+     * 当前激活的建议
+     */
+    activeSuggestion: Ref<string>;
+    /**
+     * 键盘导航的激活索引
+     */
+    activeKeyboardIndex: Ref<number>;
+    /**
+     * 鼠标悬停的激活索引
+     */
+    activeMouseIndex: Ref<number>;
+    /**
+     * 自动补全文本
+     */
+    autoCompleteText: Ref<string>;
+    /**
+     * 是否显示 Tab 提示器
+     */
+    showTabIndicator: Ref<boolean>;
+    /**
+     * 应用建议
+     *
+     * @param suggestion - 建议内容
+     */
+    applySuggestion: (suggestion: string) => void;
+    /**
+     * 键盘导航
+     *
+     * @param direction - 方向（上/下）
+     */
+    navigateWithKeyboard: (direction: 'up' | 'down') => void;
+    /**
+     * 鼠标进入
+     *
+     * @param index - 建议项索引
+     */
+    handleMouseEnter: (index: number) => void;
+    /**
+     * 鼠标离开
+     */
+    handleMouseLeave: () => void;
+    /**
+     * 关闭弹窗
+     */
+    closePopup: () => void;
+}

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

@@ -0,0 +1,138 @@
+import { Ref } from 'vue';
+import { Editor } from '@tiptap/vue-3';
+import { InputMode, DefaultActions, SubmitTrigger } from './base';
+/**
+ * Sender Context
+ *
+ * 通过 provide/inject 在组件树中共享的状态和方法
+ * 所有子组件都可以通过 inject 获取
+ */
+export interface SenderContext {
+    /**
+     * Tiptap 编辑器实例
+     * 注意：Tiptap 的 useEditor 返回 ShallowRef<Editor | undefined>
+     */
+    editor: Ref<Editor | undefined>;
+    /**
+     * 编辑器 DOM 引用
+     */
+    editorRef: Ref<HTMLElement | null>;
+    /**
+     * 当前输入模式
+     */
+    mode: Ref<InputMode>;
+    /**
+     * 是否正在自动切换模式
+     * 用于控制切换时的过渡动画
+     */
+    isAutoSwitching: Ref<boolean>;
+    /**
+     * 是否加载中
+     */
+    loading: Ref<boolean>;
+    /**
+     * 是否禁用
+     */
+    disabled: Ref<boolean>;
+    /**
+     * 是否有内容
+     */
+    hasContent: Ref<boolean>;
+    /**
+     * 编辑器内是否有文本内容
+     *
+     * 不包含附件、图片等外部内容，主要用于清空按钮等只作用于编辑器文本的场景。
+     */
+    hasEditorContent: Ref<boolean>;
+    /**
+     * 是否可以提交
+     *
+     * 综合判断：
+     * - !disabled
+     * - !loading
+     * - hasContent
+     * - !isOverLimit
+     * - !defaultActions.submit?.disabled
+     */
+    canSubmit: Ref<boolean>;
+    /**
+     * 是否超出字数限制
+     */
+    isOverLimit: Ref<boolean>;
+    /**
+     * 当前字符数
+     */
+    characterCount: Ref<number>;
+    /**
+     * 最大字符数限制
+     */
+    maxLength: Ref<number | undefined>;
+    /**
+     * 组件的尺寸
+     */
+    size: Ref<'small' | 'normal'>;
+    /**
+     * 是否显示字数限制
+     */
+    showWordLimit: Ref<boolean>;
+    /**
+     * 是否显示清空按钮
+     */
+    clearable: Ref<boolean>;
+    /**
+     * 默认操作按钮配置
+     */
+    defaultActions: Ref<DefaultActions | undefined>;
+    /**
+     * 提交触发方式
+     */
+    submitType: Ref<SubmitTrigger>;
+    /**
+     * 停止按钮文字
+     */
+    stopText: Ref<string | undefined>;
+    /**
+     * 提交内容
+     */
+    submit: () => void;
+    /**
+     * 清空内容
+     */
+    clear: () => void;
+    /**
+     * 取消操作
+     *
+     * 在 loading 状态下触发，用于取消正在进行的操作
+     */
+    cancel: () => void;
+    /**
+     * 聚焦编辑器
+     */
+    focus: () => void;
+    /**
+     * 失焦编辑器
+     */
+    blur: () => void;
+    /**
+     * 设置编辑器内容
+     *
+     * @param content - 内容（HTML 或 JSON）
+     */
+    setContent: (content: string) => void;
+    /**
+     * 获取编辑器内容
+     *
+     * @returns 内容（HTML）
+     */
+    getContent: () => string;
+}
+/**
+ * Context Key
+ *
+ * 用于 provide/inject 的 key
+ */
+export declare const SENDER_CONTEXT_KEY: unique symbol;
+/**
+ * useSenderContext 返回类型
+ */
+export type UseSenderContextReturn = SenderContext;

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

@@ -0,0 +1,67 @@
+import { Editor } from '@tiptap/core';
+/**
+ * Sender 插槽作用域
+ *
+ * 通过插槽作用域暴露给外部组件的状态和方法
+ * 主要为增强按钮（Upload、Voice 等）提供便捷的操作方法
+ */
+export interface SenderSlotScope {
+    /**
+     * Tiptap 编辑器实例
+     * 用于高级操作
+     */
+    editor: Editor | undefined;
+    /**
+     * 聚焦编辑器
+     */
+    focus: () => void;
+    /**
+     * 失焦编辑器
+     */
+    blur: () => void;
+    /**
+     * 插入内容到当前光标位置
+     *
+     * 适用场景：语音输入、快捷短语插入
+     *
+     * @param content - 要插入的内容
+     * @example
+     * ```vue
+     * <template #actions-inline="{ insert }">
+     *   <VoiceButton @speech-final="insert" />
+     * </template>
+     * ```
+     */
+    insert: (content: string) => void;
+    /**
+     * 追加内容到编辑器末尾
+     *
+     * 适用场景：连续语音输入、批量添加内容
+     *
+     * @param content - 要追加的内容
+     */
+    append: (content: string) => void;
+    /**
+     * 替换编辑器全部内容
+     *
+     * 适用场景：模板填充、内容重置
+     *
+     * @param content - 新内容
+     */
+    replace: (content: string) => void;
+    /**
+     * 是否禁用
+     * 用于控制自定义按钮状态
+     */
+    disabled: boolean;
+    /**
+     * 是否加载中
+     * 用于控制按钮加载状态和禁用
+     */
+    loading: boolean;
+    /**
+     * 是否有内容
+     * 用于控制按钮显示/隐藏
+     */
+    hasContent: boolean;
+}

package/dist/sender/utils/countGraphemes.d.ts

@@ -0,0 +1 @@
+export declare function countGraphemes(text: string): number;

package/dist/sender-actions/action-button/index.vue.d.ts

@@ -0,0 +1,23 @@
+import { ActionButtonProps } from '../types/common';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        icon?(_: {}): any;
+        icon?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<ActionButtonProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<ActionButtonProps> & Readonly<{}>, {
+    disabled: boolean;
+    active: boolean;
+    tooltipPlacement: import('../index.type').TooltipPlacement;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+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-actions/clear-button/index.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/sender-actions/clear-button/useClearButtonState.d.ts

@@ -0,0 +1,6 @@
+export declare const useClearButtonState: () => {
+    isDisabled: import('vue').ComputedRef<boolean>;
+    tooltip: import('vue').ComputedRef<import('../index.type').TooltipContent | undefined>;
+    tooltipPlacement: import('vue').ComputedRef<import('../index.type').TooltipPlacement>;
+    show: import('vue').ComputedRef<boolean>;
+};

package/dist/sender-actions/default-actions/index.vue.d.ts

@@ -0,0 +1,17 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        prepend?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+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, {}, any>;
+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-actions/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Sender Actions 组件导出
+ *
+ * 包含所有操作按钮组件：
+ * - ActionButton: 基础按钮
+ * - SubmitButton: 提交按钮
+ * - ClearButton: 清空按钮
+ * - UploadButton: 上传按钮
+ * - VoiceButton: 语音输入按钮
+ * - WordCounter: 字数统计
+ * - DefaultActionButtons: 默认按钮组合
+ */
+export { default as ActionButton } from './action-button/index.vue';
+export { default as SubmitButton } from './submit-button/index.vue';
+export { default as ClearButton } from './clear-button/index.vue';
+export { default as UploadButton } from './upload-button/index.vue';
+export { default as VoiceButton } from './voice-button/index.vue';
+export { default as WordCounter } from './word-counter/index.vue';
+export { default as DefaultActionButtons } from './default-actions/index.vue';
+export { useSpeechHandler } from './voice-button/useSpeechHandler';
+export { WebSpeechHandler } from './voice-button/webSpeechHandler';

package/dist/sender-actions/index.type.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sender Actions 类型导出
+ */
+export type { TooltipPlacement, TooltipContent, ActionButtonProps } from './types/common';
+export type { UploadButtonProps, UploadButtonEmits } from './upload-button/index.type';
+export type { VoiceButtonProps, VoiceButtonEmits } from './voice-button/index.type';
+export type { SpeechConfig, SpeechHandler, SpeechState, SpeechCallbacks, SpeechHookOptions, SpeechHandlerResult, } from './voice-button/speech.types';

package/dist/sender-actions/submit-button/index.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/sender-actions/types/common.d.ts

@@ -0,0 +1,40 @@
+import { VNode, Component } from 'vue';
+import { TooltipContent } from './tooltip';
+export type { TooltipContent } from './tooltip';
+/**
+ * Tooltip 位置
+ *
+ * 支持 TinyTooltip 的所有位置选项
+ */
+export type TooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/**
+ * ActionButton Props
+ *
+ * 基础操作按钮的 Props
+ */
+export interface ActionButtonProps {
+    /**
+     * 按钮图标
+     */
+    icon: VNode | Component;
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * 是否激活状态
+     */
+    active?: boolean;
+    /**
+     * 工具提示
+     */
+    tooltip?: TooltipContent;
+    /**
+     * Tooltip 位置
+     */
+    tooltipPlacement?: TooltipPlacement;
+    /**
+     * 按钮大小
+     */
+    size?: string | number;
+}

package/dist/sender-actions/types/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sender Actions 类型统一导出
+ */
+export * from './tooltip';
+export * from './common';

package/dist/sender-actions/types/tooltip.d.ts

@@ -0,0 +1,7 @@
+import { VNode } from 'vue';
+/**
+ * Tooltip 内容类型
+ * - string: 简单文本
+ * - () => string | VNode: 渲染函数，支持复杂内容
+ */
+export type TooltipContent = string | (() => string | VNode);

package/dist/sender-actions/upload-button/index.type.d.ts

@@ -0,0 +1,57 @@
+import { Component } from 'vue';
+import { TooltipContent, TooltipPlacement } from '../types/common';
+export interface UploadButtonProps {
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * 接受的文件类型
+     * @default '*'
+     */
+    accept?: string;
+    /**
+     * 是否支持多选
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * 是否在选择文件后重置 input
+     * @default true
+     */
+    reset?: boolean;
+    /**
+     * 文件大小限制（MB）
+     */
+    maxSize?: number;
+    /**
+     * 最大文件数量
+     */
+    maxCount?: number;
+    /**
+     * 按钮提示文本
+     */
+    tooltip?: TooltipContent;
+    /**
+     * 按钮尺寸
+     */
+    size?: number | string;
+    /**
+     * 自定义图标
+     */
+    icon?: Component;
+    /**
+     * Tooltip 位置
+     */
+    tooltipPlacement?: TooltipPlacement;
+}
+export interface UploadButtonEmits {
+    /**
+     * 文件选择
+     */
+    (e: 'select', files: File[]): void;
+    /**
+     * 文件验证失败
+     */
+    (e: 'error', error: Error, files?: File[]): void;
+}

package/dist/sender-actions/upload-button/index.vue.d.ts

@@ -0,0 +1,16 @@
+import { UploadButtonProps } from './index.type';
+declare const _default: import('vue').DefineComponent<UploadButtonProps, {
+    open: (localOptions?: Partial<import('@vueuse/core').UseFileDialogOptions>) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    error: (error: Error, files?: File[] | undefined) => any;
+    select: (files: File[]) => any;
+}, string, import('vue').PublicProps, Readonly<UploadButtonProps> & Readonly<{
+    onError?: ((error: Error, files?: File[] | undefined) => any) | undefined;
+    onSelect?: ((files: File[]) => any) | undefined;
+}>, {
+    reset: boolean;
+    multiple: boolean;
+    tooltipPlacement: import('../index.type').TooltipPlacement;
+    accept: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/sender-actions/utils/tooltip.d.ts

@@ -0,0 +1,8 @@
+import { VNode } from 'vue';
+import { TooltipContent } from '../types/tooltip';
+/**
+ * 将 TooltipContent 转换为 TinyTooltip 的 render-content 函数
+ */
+export declare function normalizeTooltipContent(tooltip: TooltipContent | undefined): (() => VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>) | undefined;

package/dist/sender-actions/voice-button/index.type.d.ts

@@ -0,0 +1,78 @@
+import { VNode, Component } from 'vue';
+import { SpeechConfig } from './speech.types';
+import { TooltipPlacement, TooltipContent } from '../types/common';
+/**
+ * VoiceButton 组件 Props
+ */
+export interface VoiceButtonProps {
+    /**
+     * 自定义未录音状态的图标
+     *
+     * @default IconVoice
+     *
+     * @example 基础使用
+     * ```vue
+     * <VoiceButton :icon="IconMicrophone" />
+     * ```
+     */
+    icon?: VNode | Component;
+    /**
+     * 自定义录音中状态的图标
+     *
+     * @default IconRecordingWave
+     *
+     * @example 自定义录音中图标
+     * ```vue
+     * <VoiceButton :recording-icon="MyRecordingIcon" />
+     * ```
+     */
+    recordingIcon?: VNode | Component;
+    /**
+     * 是否禁用(会与 Context 的 disabled 合并)
+     */
+    disabled?: boolean;
+    /**
+     * 按钮尺寸
+     */
+    size?: 'small' | 'normal';
+    /**
+     * Tooltip 文本
+     */
+    tooltip?: TooltipContent;
+    /**
+     * Tooltip 位置
+     */
+    tooltipPlacement?: TooltipPlacement;
+    /**
+     * 语音配置
+     */
+    speechConfig?: SpeechConfig;
+    /**
+     * 是否自动插入识别结果到编辑器
+     * @default true
+     */
+    autoInsert?: boolean;
+    /**
+     * 按钮点击拦截器(用于自定义 UI)
+     */
+    onButtonClick?: (isRecording: boolean, preventDefault: () => void) => void | Promise<void>;
+}
+/**
+ * VoiceButton 组件 Emits
+ */
+export interface VoiceButtonEmits {
+    (e: 'speech-start'): void;
+    (e: 'speech-interim', transcript: string): void;
+    (e: 'speech-final', transcript: string): void;
+    (e: 'speech-end', transcript?: string): void;
+    (e: 'speech-error', error: Error): void;
+}
+/**
+ * VoiceButton 插槽作用域
+ */
+export interface VoiceButtonSlotScope {
+    /**
+     * 是否正在录音
+     */
+    isRecording: boolean;
+}

package/dist/sender-actions/voice-button/index.vue.d.ts

@@ -0,0 +1,43 @@
+import { VoiceButtonProps } from './index.type';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        icon?(_: {
+            isRecording: boolean;
+        }): any;
+        'recording-overlay'?(_: {
+            isRecording: boolean;
+            stop: () => void;
+        }): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<VoiceButtonProps, {
+    start: () => void;
+    stop: () => void;
+    speechState: import('./speech.types').SpeechState;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "speech-start": () => any;
+    "speech-interim": (transcript: string) => any;
+    "speech-final": (transcript: string) => any;
+    "speech-end": (transcript?: string | undefined) => any;
+    "speech-error": (error: Error) => any;
+}, string, import('vue').PublicProps, Readonly<VoiceButtonProps> & Readonly<{
+    "onSpeech-start"?: (() => any) | undefined;
+    "onSpeech-interim"?: ((transcript: string) => any) | undefined;
+    "onSpeech-final"?: ((transcript: string) => any) | undefined;
+    "onSpeech-end"?: ((transcript?: string | undefined) => any) | undefined;
+    "onSpeech-error"?: ((error: Error) => any) | undefined;
+}>, {
+    tooltipPlacement: import('../index.type').TooltipPlacement;
+    autoInsert: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};