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

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;
+    };
+};

package/dist/sender-actions/voice-button/speech.types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 语音识别相关类型定义
+ */
+export interface SpeechCallbacks {
+    onStart: () => void;
+    onInterim: (transcript: string) => void;
+    onFinal: (transcript: string) => void;
+    onEnd: (transcript?: string) => void;
+    onError: (error: Error) => void;
+}
+export interface SpeechHandler {
+    start: (callbacks: SpeechCallbacks) => Promise<void> | void;
+    stop: () => Promise<void> | void;
+    isSupported: () => boolean;
+}
+export interface SpeechConfig {
+    customHandler?: SpeechHandler;
+    lang?: string;
+    continuous?: boolean;
+    interimResults?: boolean;
+    autoReplace?: boolean;
+    onVoiceButtonClick?: (isRecording: boolean, preventDefault: () => void) => void | Promise<void>;
+}
+export interface SpeechState {
+    isRecording: boolean;
+    isSupported: boolean;
+    error?: Error;
+}
+export interface SpeechHookOptions extends SpeechConfig {
+    onStart?: () => void;
+    onEnd?: (transcript?: string) => void;
+    onInterim?: (transcript: string) => void;
+    onFinal?: (transcript: string) => void;
+    onError?: (error: Error) => void;
+}
+export interface SpeechHandlerResult {
+    speechState: SpeechState;
+    start: () => void;
+    stop: () => void;
+}

package/dist/sender-actions/voice-button/useSpeechHandler.d.ts

@@ -0,0 +1,10 @@
+import { SpeechHookOptions, SpeechHandlerResult } from './speech.types';
+/**
+ * 语音识别处理 Hook
+ * 支持内置 Web Speech API 和自定义语音处理器
+ * 通过 customHandler 参数切换实现，默认使用内置的 Web Speech API
+ *
+ * @param options 语音识别配置
+ * @returns 语音识别控制器
+ */
+export declare function useSpeechHandler(options: SpeechHookOptions): SpeechHandlerResult;

package/dist/sender-actions/voice-button/webSpeechHandler.d.ts

@@ -0,0 +1,40 @@
+import { SpeechCallbacks, SpeechHandler, SpeechConfig } from './speech.types';
+/**
+ * 内置 Web Speech API 处理器
+ * 基于浏览器原生 Web Speech API 实现的语音识别
+ */
+export declare class WebSpeechHandler implements SpeechHandler {
+    private recognition?;
+    private options;
+    /**
+     * 初始化语音识别实例
+     */
+    private initialize;
+    constructor(options: SpeechConfig);
+    /**
+     * 检查浏览器是否支持 Web Speech API
+     */
+    static isSupported(): boolean;
+    /**
+     * 检查浏览器是否支持 Web Speech API（实例方法）
+     */
+    isSupported(): boolean;
+    /**
+     * 设置语音识别事件处理器
+     * @param callbacks 语音识别回调函数集合
+     */
+    private setupEventHandlers;
+    /**
+     * 清理事件监听器
+     */
+    private cleanup;
+    /**
+     * 开始语音识别
+     * @param callbacks 语音识别回调函数集合
+     */
+    start(callbacks: SpeechCallbacks): void;
+    /**
+     * 停止语音识别并清理资源
+     */
+    stop(): void;
+}

package/dist/sender-actions/word-counter/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-compat/index.d.ts

@@ -0,0 +1,7 @@
+import { App } from 'vue';
+import { default as SenderCompat } from './index.vue';
+declare const install: <T>(app: App<T>) => void;
+declare const _default: typeof SenderCompat & {
+    install: typeof install;
+};
+export default _default;

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

@@ -0,0 +1,91 @@
+import { VNode, Component } from 'vue';
+import { InputMode, SubmitTrigger, AutoSize } from '../sender/types/base';
+import { SpeechConfig } from '../sender-actions/voice-button/speech.types';
+export type ThemeType = 'light' | 'dark';
+export type TooltipRender = () => VNode | string;
+export interface ControlState {
+    tooltips?: string | TooltipRender;
+    disabled?: boolean;
+    tooltipPlacement?: 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+}
+interface fileUploadConfig {
+    accept?: string;
+    multiple?: boolean;
+    reset?: boolean;
+}
+interface VoiceButtonConfig {
+    icon?: VNode | Component;
+}
+export interface ButtonGroupConfig {
+    file?: ControlState & fileUploadConfig;
+    submit?: ControlState;
+    voice?: VoiceButtonConfig;
+}
+export interface SuggestionTextPart {
+    text: string;
+    isMatch: boolean;
+}
+type HighlightFunction = (suggestionText: string, inputText: string) => SuggestionTextPart[];
+export interface ISuggestionItem {
+    content: string;
+    highlights?: string[] | HighlightFunction;
+}
+export interface SenderProps {
+    autofocus?: boolean;
+    autoSize?: AutoSize;
+    allowSpeech?: boolean;
+    allowFiles?: boolean;
+    clearable?: boolean;
+    disabled?: boolean;
+    defaultValue?: string | null;
+    loading?: boolean;
+    modelValue?: string;
+    mode?: InputMode;
+    maxLength?: number;
+    buttonGroup?: ButtonGroupConfig;
+    submitType?: SubmitTrigger;
+    speech?: boolean | SpeechConfig;
+    placeholder?: string;
+    showWordLimit?: boolean;
+    suggestions?: ISuggestionItem[];
+    suggestionPopupWidth?: string | number;
+    activeSuggestionKeys?: string[];
+    theme?: ThemeType;
+    templateData?: UserItem[];
+    stopText?: string;
+}
+export type SenderEmits = {
+    (e: 'update:modelValue', value: string): void;
+    (e: 'update:templateData', value: UserItem[]): void;
+    (e: 'submit', value: string): void;
+    (e: 'clear'): void;
+    (e: 'speech-start'): void;
+    (e: 'speech-end', transcript?: string): void;
+    (e: 'speech-interim', transcript: string): void;
+    (e: 'speech-error', error: Error): void;
+    (e: 'suggestion-select', value: string): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+    (e: 'escape-press'): void;
+    (e: 'cancel'): void;
+    (e: 'reset-template'): void;
+    (e: 'files-selected', files: File[]): void;
+};
+export interface CompatTextItem {
+    id: string;
+    type: 'text';
+    content: string;
+}
+export interface CompatTemplateItem {
+    id: string;
+    type: 'template' | 'block';
+    content: string;
+}
+export type UserTextItem = Omit<CompatTextItem, 'id'> & {
+    id?: CompatTextItem['id'];
+};
+export type UserTemplateItem = Omit<Pick<CompatTemplateItem, 'type' | 'content'>, 'id'> & {
+    id?: CompatTemplateItem['id'];
+};
+export type UserItem = UserTextItem | UserTemplateItem;
+export {};