@naersen/tts-rich-text 0.4.0 → 0.5.0

package/README.md

@@ -238,6 +238,22 @@ import '@naersen/tts-rich-text/theme-default.css'
 
 这些组件共享 `TtsEditorRoot` 提供的编辑器上下文，不能脱离 Root 单独使用。布局接近原项目时使用完整的 `TtsRichTextEditor`；页面结构差异较大时再组合原子组件，业务接口仍统一通过 `services` 注入。
 
+### 组合式 API
+
+自定义工具栏、试听面板或业务弹窗时，可以从包根入口引入：
+
+```ts
+import {
+	useGlobalAudioControl,
+	useSSETool,
+	useSynthesizeAudioTool,
+	useTestAudioTool,
+	useVoiceChangeConfirm
+} from '@naersen/tts-rich-text'
+```
+
+`useSynthesizeAudioTool` 和 `useTestAudioTool` 会读取编辑器 services，需要在 `TtsEditorRoot` 的后代组件中调用。`useGlobalAudioControl` 和 `useSSETool` 可以独立使用。
+
 ## 对外方法
 
 通过组件 ref 可以调用：

package/dist/components/tts-rich-text/editor/useSSETool.d.ts

@@ -2,7 +2,7 @@ import { Ref } from 'vue';
 import { TtsServiceContext } from '../../../type';
 type ScrollTarget = Ref<HTMLElement | null | undefined> | (() => HTMLElement | null | undefined);
 type StreamRunner = (data: Record<string, unknown>, context: TtsServiceContext) => Promise<string | void>;
-interface UseSseToolOptions {
+export interface UseSseToolOptions {
     runner?: StreamRunner;
     onChange?: (text: string) => void;
     scrollTarget?: ScrollTarget;

package/dist/editor/index.d.ts

@@ -1,4 +1,8 @@
 export { useEditorContext, useEditorProvider, useRichTextEditor, type RichTextEditor, type UseRichTextEditorOptions } from '../components/tts-rich-text/editor/useRichTextEditor';
 export { createCustomTagNode, CustomTagName } from '../components/tts-rich-text/editor/nodes/tag-node';
 export { createTtsCharacterCount } from '../components/tts-rich-text/editor/plugins/tts-character-count';
+export { useSSETool, type UseSseToolOptions } from '../components/tts-rich-text/editor/useSSETool';
+export { useTestAudioTool } from '../components/tts-rich-text/editor/useTestAudioTool';
+export { globalAudioControlKey, useGlobalAudioControl } from '../components/tts-rich-text/hooks/useGlobalAudioControl';
+export { useSynthesizeAudioTool } from '../components/tts-rich-text/hooks/useSynthesizeAudioTool';
 export { useVoiceChangeConfirm } from '../components/tts-rich-text/hooks/useVoiceChangeConfirm';