@siact/sime-x-vue 0.0.9 → 0.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siact/sime-x-vue",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "publishConfig": {
     "access": "public"
   },
@@ -28,11 +28,12 @@
     "node": ">=14"
   },
   "dependencies": {
+    "@ai-sdk/vue": "^3.0.116",
     "@visactor/vtable": "^1.16.2",
+    "ai": "6.0.39",
     "vue": "^3.4.19",
     "vue-sonner": "^1.1.2",
-    "web-voice-kit": "^0.5.0",
-    "@siact/sime-bridge": "0.0.1"
+    "web-voice-kit": "^0.5.0"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^6.1.0",
@@ -52,11 +53,11 @@
     "prettier": "^3.6.2",
     "rimraf": "^3.0.2",
     "sass-embedded": "^1.93.2",
-    "typescript": "^4.7.4",
+    "typescript": "^5.6.3",
     "vite": "^5.0.4",
     "vite-plugin-static-copy": "^3.1.4",
     "vue-eslint-parser": "^10.2.0",
-    "vue-tsc": "^1.8.24"
+    "vue-tsc": "^2.0.0"
   },
   "files": [
     "dist",

package/types/DevApp.vue.d.ts

@@ -1,2 +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;
+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/types/components/ai-chat.vue.d.ts

@@ -0,0 +1,47 @@
+import { Chat } from '@ai-sdk/vue';
+import type { UIMessage } from 'ai';
+import type { AgentChatTransportOptions } from '../lib/agent-chat-transport';
+type __VLS_Props = {
+    /** streamInvoke endpoint URL */
+    api: string;
+    /** 项目 ID */
+    projectId?: string;
+    /** 是否只读 */
+    isReadonly?: boolean;
+    /** 欢迎标题 */
+    welcomeTitle?: string;
+    /** 欢迎描述 */
+    welcomeDescription?: string;
+    /** 快捷建议 */
+    suggestions?: string[];
+    /** 是否全宽 */
+    fullWidth?: boolean;
+    /** 自定义工具名称映射 */
+    toolNames?: Record<string, string>;
+    /** 额外 transport 配置 */
+    transportOptions?: Partial<AgentChatTransportOptions>;
+    /** 额外 headers */
+    headers?: Record<string, string>;
+    /** 额外 body */
+    body?: Record<string, unknown>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    chat: Chat<UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>;
+    sendMessage: (text: string) => Promise<void>;
+    clearMessages: () => void;
+    stop: () => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    error: (error: Error) => any;
+    finish: (message: UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: Error) => any) | undefined;
+    onFinish?: ((message: UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>) => any) | undefined;
+}>, {
+    isReadonly: boolean;
+    welcomeTitle: string;
+    welcomeDescription: string;
+    suggestions: string[];
+    fullWidth: boolean;
+    toolNames: Record<string, string>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/types/components/sime-provider.vue.d.ts

@@ -1,49 +1,26 @@
-import { VoiceConfig } from '../types';
-declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    /** 项目名称 */
-    project: string;
-    /** 项目描述 */
-    description?: string | undefined;
-    /** 是否开启调试模式 */
-    debug?: boolean | undefined;
-    /** iframeUrl */
-    chatbotUrl: string;
-    /** appId */
-    appId: string;
-    /** appToken */
-    appToken: string;
-    /** 语音配置（可选，也可直接在 voiceAssistant 组件上传入） */
-    voiceConfig?: VoiceConfig | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    /** 项目名称 */
-    project: string;
-    /** 项目描述 */
-    description?: string | undefined;
-    /** 是否开启调试模式 */
-    debug?: boolean | undefined;
-    /** iframeUrl */
-    chatbotUrl: string;
-    /** appId */
-    appId: string;
-    /** appToken */
-    appToken: string;
-    /** 语音配置（可选，也可直接在 voiceAssistant 组件上传入） */
-    voiceConfig?: VoiceConfig | undefined;
-}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
-    default?(_: {}): any;
-}>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
+type __VLS_Props = {
+    /** 项目名称 */
+    project: string;
+    /** 项目描述 */
+    description?: string;
+    /** 是否开启调试模式 */
+    debug?: boolean;
+    /** iframeUrl */
+    chatbotUrl: string;
+    /** appId */
+    appId: string;
+    /** appToken */
+    appToken: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/test.vue.d.ts

@@ -1,2 +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;
+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/types/components/tool-card.vue.d.ts

@@ -1,28 +1,12 @@
-import type { ToolState } from '../lib/data-stream-parser';
-declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    toolName: string;
-    toolCallId: string;
-    args?: any;
-    result?: any;
-    state: ToolState;
-    errorText?: string | undefined;
-    isExecuting?: boolean | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    toolName: string;
-    toolCallId: string;
-    args?: any;
-    result?: any;
-    state: ToolState;
-    errorText?: string | undefined;
-    isExecuting?: boolean | undefined;
-}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
+import type { ToolState } from '../lib/data-stream-parser';
+type __VLS_Props = {
+    toolName: string;
+    toolCallId: string;
+    args?: any;
+    result?: any;
+    state: ToolState;
+    errorText?: string;
+    isExecuting?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/types/components/voice-assistant.vue.d.ts

@@ -1,44 +1,24 @@
-import type { VoiceConfig } from '../types';
-interface XSize {
-    width: number;
-    height: number;
-}
-interface BubbleSize {
-    width?: string;
-    maxHeight?: string;
-}
-declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    xLogo?: string | undefined;
-    xTitle?: string | undefined;
-    xSize?: XSize | undefined;
-    xTheme?: "light" | "dark" | "system" | undefined;
-    wakeWords?: string[] | undefined;
-    modelPath?: string | undefined;
-    projectId?: string | undefined;
-    invokeUrl?: string | undefined;
-    voiceConfig?: VoiceConfig | undefined;
-    bubbleSize?: BubbleSize | undefined;
-    bubbleDismissDelay?: number | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    xLogo?: string | undefined;
-    xTitle?: string | undefined;
-    xSize?: XSize | undefined;
-    xTheme?: "light" | "dark" | "system" | undefined;
-    wakeWords?: string[] | undefined;
-    modelPath?: string | undefined;
-    projectId?: string | undefined;
-    invokeUrl?: string | undefined;
-    voiceConfig?: VoiceConfig | undefined;
-    bubbleSize?: BubbleSize | undefined;
-    bubbleDismissDelay?: number | undefined;
-}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
+import type { VoiceConfig } from '../types';
+interface XSize {
+    width: number;
+    height: number;
+}
+interface BubbleSize {
+    width?: string;
+    maxHeight?: string;
+}
+type __VLS_Props = {
+    xLogo?: string;
+    xTitle?: string;
+    xSize?: XSize;
+    xTheme?: 'light' | 'dark' | 'system';
+    wakeWords?: string[];
+    modelPath?: string;
+    projectId?: string;
+    invokeUrl?: string;
+    voiceConfig?: VoiceConfig;
+    bubbleSize?: BubbleSize;
+    bubbleDismissDelay?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/types/components/voice-status.vue.d.ts

@@ -1,20 +1,8 @@
-type VoiceStatus = 'wake' | 'listening' | 'standby';
-declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    status: VoiceStatus;
-    transcriptionText?: string | undefined;
-    isTranscribing?: boolean | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    status: VoiceStatus;
-    transcriptionText?: string | undefined;
-    isTranscribing?: boolean | undefined;
-}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
+type VoiceStatus = 'wake' | 'listening' | 'standby';
+type __VLS_Props = {
+    status: VoiceStatus;
+    transcriptionText?: string;
+    isTranscribing?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/types/composables/index.d.ts

@@ -1,6 +1,6 @@
-export { useTTS } from './use-tts';
-export { useBubble } from './use-bubble';
-export type { BubbleSize, UseBubbleOptions } from './use-bubble';
-export { useVoiceRecognition } from './use-voice-recognition';
-export type { VoiceStatus } from './use-voice-recognition';
-export { useAgentInvoke } from './use-agent-invoke';
+export { useTTS } from './use-tts';
+export { useBubble } from './use-bubble';
+export type { BubbleSize, UseBubbleOptions } from './use-bubble';
+export { useVoiceRecognition } from './use-voice-recognition';
+export type { VoiceStatus } from './use-voice-recognition';
+export { useAgentInvoke } from './use-agent-invoke';

package/types/composables/use-agent-invoke.d.ts

@@ -1,79 +1,79 @@
-import type { Ref } from 'vue';
-import { type ToolCallPart, type ToolResultPart } from '../lib/data-stream-parser';
-import type { AiChatbotXContext } from '../types';
-export interface UseAgentInvokeOptions {
-    endpoint: Ref<string>;
-    projectId?: string;
-    aiChatbotX: AiChatbotXContext;
-    /** TTS 控制 */
-    tts: {
-        speak: (text: string) => void;
-        feed: (delta: string) => void;
-        flush: () => void;
-        stop: () => void;
-    };
-    /** 气泡控制 */
-    bubble: {
-        open: () => void;
-        scheduleDismiss: () => void;
-        scrollToBottom: () => void;
-    };
-    /** 会话记忆超时（ms），超过此时间未发起新对话则自动清空历史，默认 120000（2分钟） */
-    sessionTimeoutMs?: number;
-    /** 最大保留历史轮数（一轮 = user + assistant），默认 10 */
-    maxHistoryTurns?: number;
-}
-/**
- * Agent 调用 composable
- *
- * 管理 Agent 调用、流式解析、工具执行、文本/工具状态。
- * 支持中断（abort）以便在唤醒时取消正在进行的调用。
- */
-export declare function useAgentInvoke(options: UseAgentInvokeOptions): {
-    isInvoking: Ref<boolean, boolean>;
-    currentTextContent: Ref<string, string>;
-    currentToolParts: Ref<({
-        type: "tool-call";
-        toolCallId: string;
-        toolName: string;
-        args: any;
-        state: import("../lib/data-stream-parser").ToolState;
-    } | {
-        type: "tool-result";
-        toolCallId: string;
-        toolName: string;
-        args: any;
-        result: any;
-        state: import("../lib/data-stream-parser").ToolState;
-    })[], (ToolCallPart | ToolResultPart)[] | ({
-        type: "tool-call";
-        toolCallId: string;
-        toolName: string;
-        args: any;
-        state: import("../lib/data-stream-parser").ToolState;
-    } | {
-        type: "tool-result";
-        toolCallId: string;
-        toolName: string;
-        args: any;
-        result: any;
-        state: import("../lib/data-stream-parser").ToolState;
-    })[]>;
-    executingTools: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
-    hasAnyContent: import("vue").ComputedRef<boolean>;
-    conversationHistory: Ref<{
-        role: 'user' | 'assistant';
-        content: string;
-    }[], {
-        role: 'user' | 'assistant';
-        content: string;
-    }[] | {
-        role: 'user' | 'assistant';
-        content: string;
-    }[]>;
-    toolDisplayName: (name: string) => string;
-    invoke: (question: string) => Promise<void>;
-    abort: () => void;
-    resetState: () => void;
-    clearHistory: () => void;
-};
+import type { Ref } from 'vue';
+import { type ToolCallPart, type ToolResultPart } from '../lib/data-stream-parser';
+import type { AiChatbotXContext } from '../types';
+export interface UseAgentInvokeOptions {
+    endpoint: Ref<string>;
+    projectId?: string;
+    aiChatbotX: AiChatbotXContext;
+    /** TTS 控制 */
+    tts: {
+        speak: (text: string) => void;
+        feed: (delta: string) => void;
+        flush: () => void;
+        stop: () => void;
+    };
+    /** 气泡控制 */
+    bubble: {
+        open: () => void;
+        scheduleDismiss: () => void;
+        scrollToBottom: () => void;
+    };
+    /** 会话记忆超时（ms），超过此时间未发起新对话则自动清空历史，默认 120000（2分钟） */
+    sessionTimeoutMs?: number;
+    /** 最大保留历史轮数（一轮 = user + assistant），默认 10 */
+    maxHistoryTurns?: number;
+}
+/**
+ * Agent 调用 composable
+ *
+ * 管理 Agent 调用、流式解析、工具执行、文本/工具状态。
+ * 支持中断（abort）以便在唤醒时取消正在进行的调用。
+ */
+export declare function useAgentInvoke(options: UseAgentInvokeOptions): {
+    isInvoking: Ref<boolean, boolean>;
+    currentTextContent: Ref<string, string>;
+    currentToolParts: Ref<({
+        type: "tool-call";
+        toolCallId: string;
+        toolName: string;
+        args: any;
+        state: import("../lib/data-stream-parser").ToolState;
+    } | {
+        type: "tool-result";
+        toolCallId: string;
+        toolName: string;
+        args: any;
+        result: any;
+        state: import("../lib/data-stream-parser").ToolState;
+    })[], (ToolCallPart | ToolResultPart)[] | ({
+        type: "tool-call";
+        toolCallId: string;
+        toolName: string;
+        args: any;
+        state: import("../lib/data-stream-parser").ToolState;
+    } | {
+        type: "tool-result";
+        toolCallId: string;
+        toolName: string;
+        args: any;
+        result: any;
+        state: import("../lib/data-stream-parser").ToolState;
+    })[]>;
+    executingTools: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    hasAnyContent: import("vue").ComputedRef<boolean>;
+    conversationHistory: Ref<{
+        role: "user" | "assistant";
+        content: string;
+    }[], {
+        role: "user" | "assistant";
+        content: string;
+    }[] | {
+        role: "user" | "assistant";
+        content: string;
+    }[]>;
+    toolDisplayName: (name: string) => string;
+    invoke: (question: string) => Promise<void>;
+    abort: () => void;
+    resetState: () => void;
+    clearHistory: () => void;
+};

package/types/composables/use-bubble.d.ts

@@ -1,41 +1,41 @@
-import type { Ref } from 'vue';
-export interface BubbleSize {
-    /** 气泡最大宽度，如 '380px' 或 '86vw' */
-    width?: string;
-    /** 气泡最大高度，如 '520px' 或 '58vh' */
-    maxHeight?: string;
-}
-export interface UseBubbleOptions {
-    /** 自动消失延迟 (ms)，默认 4000 */
-    dismissDelay?: number;
-    /** 外部 isSpeaking 引用，TTS 播报期间阻止消失 */
-    isSpeaking?: Ref<boolean>;
-    /** 外部 hasPendingAudio 引用，TTS 已提交内容但尚未开始播放（覆盖异步窗口期） */
-    hasPendingAudio?: Ref<boolean>;
-    /** 外部 isInvoking 引用，调用期间阻止消失 */
-    isInvoking?: Ref<boolean>;
-    /** 气泡尺寸 */
-    bubbleSize?: BubbleSize;
-}
-/**
- * 气泡生命周期 composable
- *
- * 管理气泡显示/隐藏、自动消失倒计时、滚动。
- * 核心保证：TTS 播报期间（含异步等待 WebSocket 的窗口期）气泡绝不消失。
- */
-export declare function useBubble(options?: UseBubbleOptions): {
-    visible: Ref<boolean, boolean>;
-    fadingOut: Ref<boolean, boolean>;
-    show: import("vue").ComputedRef<boolean>;
-    style: import("vue").ComputedRef<{
-        width: string | undefined;
-        maxHeight: string | undefined;
-    }>;
-    stackRef: Ref<HTMLElement | null, HTMLElement | null>;
-    open: () => void;
-    hide: () => void;
-    cancelDismiss: () => void;
-    scheduleDismiss: () => void;
-    scrollToBottom: () => void;
-    destroy: () => void;
-};
+import type { Ref } from 'vue';
+export interface BubbleSize {
+    /** 气泡最大宽度，如 '380px' 或 '86vw' */
+    width?: string;
+    /** 气泡最大高度，如 '520px' 或 '58vh' */
+    maxHeight?: string;
+}
+export interface UseBubbleOptions {
+    /** 自动消失延迟 (ms)，默认 4000 */
+    dismissDelay?: number;
+    /** 外部 isSpeaking 引用，TTS 播报期间阻止消失 */
+    isSpeaking?: Ref<boolean>;
+    /** 外部 hasPendingAudio 引用，TTS 已提交内容但尚未开始播放（覆盖异步窗口期） */
+    hasPendingAudio?: Ref<boolean>;
+    /** 外部 isInvoking 引用，调用期间阻止消失 */
+    isInvoking?: Ref<boolean>;
+    /** 气泡尺寸 */
+    bubbleSize?: BubbleSize;
+}
+/**
+ * 气泡生命周期 composable
+ *
+ * 管理气泡显示/隐藏、自动消失倒计时、滚动。
+ * 核心保证：TTS 播报期间（含异步等待 WebSocket 的窗口期）气泡绝不消失。
+ */
+export declare function useBubble(options?: UseBubbleOptions): {
+    visible: Ref<boolean, boolean>;
+    fadingOut: Ref<boolean, boolean>;
+    show: import("vue").ComputedRef<boolean>;
+    style: import("vue").ComputedRef<{
+        width: string | undefined;
+        maxHeight: string | undefined;
+    }>;
+    stackRef: Ref<HTMLElement | null, HTMLElement | null>;
+    open: () => void;
+    hide: () => void;
+    cancelDismiss: () => void;
+    scheduleDismiss: () => void;
+    scrollToBottom: () => void;
+    destroy: () => void;
+};

package/types/composables/use-tts.d.ts

@@ -1,18 +1,18 @@
-import type { VoiceConfig } from '../types';
-/**
- * TTS 语音播报 composable
- *
- * 管理讯飞 SpeechSynthesizerStandalone 的生命周期、
- * 句子级缓冲、Markdown 清理、AudioContext 预热。
- */
-export declare function useTTS(getVoiceConfig: () => VoiceConfig | null): {
-    isSpeaking: import("vue").Ref<boolean, boolean>;
-    hasPendingAudio: import("vue").Ref<boolean, boolean>;
-    warmUpAudio: () => void;
-    speak: (text: string) => Promise<void>;
-    feed: (delta: string) => void;
-    flush: () => void;
-    stop: () => void;
-    destroy: () => void;
-    setOnQueueEmpty: (cb: () => void) => void;
-};
+import type { VoiceConfig } from '../types';
+/**
+ * TTS 语音播报 composable
+ *
+ * 管理讯飞 SpeechSynthesizerStandalone 的生命周期、
+ * 句子级缓冲、Markdown 清理、AudioContext 预热。
+ */
+export declare function useTTS(getVoiceConfig: () => VoiceConfig | null): {
+    isSpeaking: import("vue").Ref<boolean, boolean>;
+    hasPendingAudio: import("vue").Ref<boolean, boolean>;
+    warmUpAudio: () => void;
+    speak: (text: string) => Promise<void>;
+    feed: (delta: string) => void;
+    flush: () => void;
+    stop: () => void;
+    destroy: () => void;
+    setOnQueueEmpty: (cb: () => void) => void;
+};