@ssml-builder-js/ssml-editor-react 2.4.0

package/CHANGELOG.md

@@ -0,0 +1,91 @@
+# @ssml-builder-js/ssml-editor-react
+
+## 2.4.0
+
+### Minor Changes
+
+- Add SSML text-node translation helpers and Azure semantic validation, improve Azure TTS endpoint and logger handling, support React 18 peer dependencies, and complete independent package publishing metadata.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ssml-builder-js/ssml-core@2.4.0
+
+## 2.3.0
+
+### Minor Changes
+
+- deecde6: Add CodeLens quick controls for editing and managing SSML prosody and break tags.
+
+### Patch Changes
+
+- @ssml-builder-js/ssml-core@2.3.0
+
+## 2.2.0
+
+### Minor Changes
+
+- e124614: ---
+
+  "@ssml-builder-js/ssml-editor-elements": minor
+  "@ssml-builder-js/ssml-editor-react": minor
+  "@ssml-builder-js/ssml-core": minor
+  "@ssml-builder-js/azure-tts-client": minor
+  "playground": minor
+
+  ***
+
+  - **Web Components サポート (`@ssml-builder-js/ssml-editor-elements`) の追加**
+    - フレームワーク非依存で利用可能な `<ssml-editor>` カスタム要素（Custom Element）パッケージを新設。
+    - ルートパッケージからのエクスポート（`ssml-builder-js/elements`）および Playground での React / Web Components 切り替え動作環境を整備。
+  - **多言語音声モデル（Voice）ごとの感情スタイル動的フィルタリングの拡充**
+    - 日本語（`ja-JP`）、英語（`en-US`）、中国語（`zh-CN`）、韓国語、欧州言語等の Neural 音声モデルに対応する発話スタイル一覧を公式仕様に合わせて網羅。
+    - 感情非対応の音声モデルに対する disabled 表示・フォールバック処理を実装。
+  - **スタイル選択 UI の `<optgroup>` カテゴリ分類**
+    - `ProsodyPopovers` 内のスタイル選択肢を「感情・トーン（Emotions）」「会話・シナリオ（Scenarios）」「メディア・報道（Media）」にグループ化し、視認性と操作性を向上。
+  - **ツールバーのアクティブタグ状態表示 (Active State Feedback)**
+
+    - エディタ内のカーソル位置（キャレット）を囲む SSML タグをリアルタイムに検知し、対応するツールバーボタン（Prosody, Style 等）をハイライト表示する機能を追加。
+
+  - モノレポ各パッケージのビルド設定（tsup）および型定義エクスポート（dts）を最適化。
+
+### Patch Changes
+
+- Updated dependencies [e124614]
+  - @ssml-builder-js/ssml-core@2.2.0
+
+## 2.1.0
+
+### Minor Changes
+
+- 5b21410: Filter express-as style completion and Emotion menu options by the active parent voice.
+
+### Patch Changes
+
+- 845a6d3: - **`<mstts:express-as>` のスタイル動的フィルタリング:** 親要素の `<voice name="...">` に応じて利用可能な感情スタイル（`style`）のみを自動補完・Popover 選択肢へ動的に絞り込む機能を追加。
+  - **Quick Fix (CodeAction) の拡張:** 未閉じタグの自動補完挿入および無効な属性値の 1 クリック修正に対応。
+  - **自動補完およびエディタ内部設計の最適化:** 入力時の Range 置換精度の改善および Popover コンポーネント・状態管理のモジュール分離を実施。
+- Updated dependencies [845a6d3]
+  - @ssml-builder-js/ssml-core@2.1.0
+
+## 2.0.0
+
+### Major Changes
+
+- 4935073: ---
+
+### Patch Changes
+
+- Updated dependencies [4935073]
+  - @ssml-builder-js/ssml-core@2.0.0
+
+## 1.0.0
+
+### Major Changes
+
+- 6c78e70: chore: initial release
+
+### Patch Changes
+
+- Updated dependencies [6c78e70]
+  - @ssml-builder-js/ssml-core@1.0.0

package/dist/index.d.mts

@@ -0,0 +1,288 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { SsmlDocument } from '@ssml-builder-js/ssml-core';
+import { OnMount, Monaco } from '@monaco-editor/react';
+
+type SsmlEditorInsertionButton = "break" | "emphasis" | "rate" | "pitch" | "volume" | "emotion" | "say-as" | "phoneme" | "audio" | "sub" | "lang" | "mark" | "bookmark" | "mstts:silence" | "mstts:viseme" | (string & {});
+type SsmlEditorButton = "help" | SsmlEditorInsertionButton | "undo" | "redo" | "clearAll" | "format" | "decorations" | (string & {});
+type SsmlEditorButtonVisibility = Readonly<Partial<Record<string, boolean>>>;
+
+type SsmlEditorLocale = "ja" | "en";
+type SsmlEditorLanguage = SsmlEditorLocale;
+type SsmlEditorLocalizedText = Readonly<Record<SsmlEditorLocale, string>>;
+interface EditorCopy {
+    editorAriaLabel: string;
+    toolbarAriaLabel: string;
+    undo: string;
+    undoTitle: string;
+    redo: string;
+    redoTitle: string;
+    clearAll: string;
+    clearAllTitle: string;
+    help: string;
+    helpTitle: string;
+    helpHeading: string;
+    helpDescription: string;
+    parameters: string;
+    format: string;
+    formatTitle: string;
+    decorations: string;
+    decorationsShowTitle: string;
+    decorationsHideTitle: string;
+    syntaxError: string;
+    selectionActions: string;
+    selectionCountSuffix: string;
+    previewSelection: string;
+    previewSelectionTitle: string;
+    noAvailableOptions: string;
+    styleNotSupported: string;
+    categoryEmotions: string;
+    categoryScenarios: string;
+    categoryMedia: string;
+    categoryOther: string;
+}
+interface InlineBadgeCopy {
+    pause: string;
+    pitch: string;
+    prosody: string;
+}
+interface SsmlHoverParameterCopy {
+    title: string;
+    description: string;
+}
+interface SsmlHoverTagCopy {
+    title: string;
+    description: string;
+    parameters: Readonly<Record<string, SsmlHoverParameterCopy>>;
+}
+interface SsmlHoverLocale {
+    parameterHeading: string;
+    parametersHeading: string;
+    allowedValues: string;
+    example: string;
+    noParameters: string;
+    tags: Readonly<Record<string, SsmlHoverTagCopy>>;
+}
+declare const EDITOR_COPY: Readonly<Record<SsmlEditorLocale, EditorCopy>>;
+declare const INLINE_BADGE_COPY: Readonly<Record<SsmlEditorLocale, InlineBadgeCopy>>;
+declare const SSML_HOVER_COPY: Readonly<Record<SsmlEditorLocale, SsmlHoverLocale>>;
+
+type SsmlEditorInsertionMode = "insert" | "wrap";
+interface SsmlEditorInsertionOption {
+    value: string;
+    labels: SsmlEditorLocalizedText;
+    descriptions?: SsmlEditorLocalizedText;
+}
+interface SsmlEditorInsertionTemplate {
+    prefix: string;
+    suffix: string;
+    mode: SsmlEditorInsertionMode;
+}
+interface SsmlEditorInsertionDefinition {
+    id: string;
+    icon: string;
+    tagName?: string;
+    selfClosing?: boolean;
+    labels: SsmlEditorLocalizedText;
+    titles?: SsmlEditorLocalizedText;
+    descriptions: SsmlEditorLocalizedText;
+    parameterDescription: SsmlEditorLocalizedText;
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => SsmlEditorInsertionTemplate;
+}
+interface SsmlEditorCustomInsertionDefinition {
+    id: string;
+    tagName: string;
+    attribute?: string;
+    icon?: string;
+    labels: SsmlEditorLocalizedText;
+    titles?: SsmlEditorLocalizedText;
+    descriptions?: SsmlEditorLocalizedText;
+    parameterDescription?: SsmlEditorLocalizedText;
+    options: readonly SsmlEditorInsertionOption[];
+    mode?: SsmlEditorInsertionMode;
+}
+type SsmlEditorCustomInsertion = SsmlEditorInsertionDefinition | SsmlEditorCustomInsertionDefinition;
+type SsmlEditorCustomInsertionCollection = readonly SsmlEditorCustomInsertion[] | Readonly<Record<string, SsmlEditorCustomInsertion | undefined>>;
+interface SsmlEditorInsertionGroup {
+    id: string;
+    labels: SsmlEditorLocalizedText;
+    insertionIds: readonly string[];
+}
+interface SsmlEditorToolbarGroup {
+    id: string;
+    buttonIds: readonly string[];
+}
+type SsmlEditorTheme = "system" | "light" | "dark";
+type SsmlEditorWordWrap = "off" | "on" | "wordWrapColumn" | "bounded";
+type SsmlEditorLineNumbers = "on" | "off" | "relative" | "interval";
+interface SsmlEditorOptions {
+    height?: string | number;
+    minHeight?: string | number;
+    readOnly?: boolean;
+    theme?: SsmlEditorTheme;
+    fontSize?: number;
+    wordWrap?: SsmlEditorWordWrap;
+    lineNumbers?: SsmlEditorLineNumbers;
+    minimap?: boolean;
+    automaticLayout?: boolean;
+}
+type SsmlInsertionOption = SsmlEditorInsertionOption;
+type SsmlInsertionTemplate = SsmlEditorInsertionTemplate;
+type SsmlInsertionDefinition = SsmlEditorInsertionDefinition;
+declare function createSsmlEditorInsertionDefinition(definition: SsmlEditorCustomInsertionDefinition): SsmlEditorInsertionDefinition;
+declare const SSML_INSERTIONS: ({
+    id: string;
+    icon: string;
+    tagName: string;
+    selfClosing: true;
+    labels: {
+        ja: string;
+        en: string;
+    };
+    descriptions: {
+        ja: string;
+        en: string;
+    };
+    parameterDescription: {
+        ja: string;
+        en: string;
+    };
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => {
+        prefix: string;
+        suffix: string;
+        mode: "insert";
+    };
+} | {
+    id: string;
+    icon: string;
+    tagName: string;
+    labels: {
+        ja: string;
+        en: string;
+    };
+    descriptions: {
+        ja: string;
+        en: string;
+    };
+    parameterDescription: {
+        ja: string;
+        en: string;
+    };
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => {
+        prefix: string;
+        suffix: string;
+        mode: "wrap";
+    };
+    selfClosing?: undefined;
+})[];
+interface SsmlEditorProps {
+    document: SsmlDocument;
+    onChange?: (document: SsmlDocument) => void;
+    onSsmlChange?: (xml: string) => void;
+    onSelectionChange?: (info: SelectionInfo) => void;
+    /** Called with the selected partial SSML when the selection preview action is used. The action is disabled when omitted. */
+    onPreviewSelection?: (ssml: string) => void;
+    /** UI language. Japanese is used when omitted. */
+    language?: SsmlEditorLanguage;
+    /** UI locale. Japanese is used when omitted; takes precedence over the legacy language prop. */
+    locale?: SsmlEditorLocale;
+    /** Whether the toolbar is displayed. */
+    showToolbar?: boolean;
+    /** Whether toolbar action icons are displayed. */
+    showToolbarIcons?: boolean;
+    /** Whether toolbar action text labels are displayed. */
+    showToolbarLabels?: boolean;
+    /** Whether inline SSML decorations are displayed. The toolbar switch can change this at runtime. */
+    showDecorations?: boolean;
+    /** Whether SSML CodeLens quick controls are displayed. */
+    enableCodeLens?: boolean;
+    /** Controls which editor action buttons are displayed. Unspecified buttons are shown. */
+    buttonVisibility?: SsmlEditorButtonVisibility;
+    /** Monaco editor settings. */
+    editorOptions?: SsmlEditorOptions;
+    /** Alias for editorOptions. */
+    settings?: SsmlEditorOptions;
+    /** Fallback UI displayed while Monaco is loading. */
+    loadingFallback?: ReactNode;
+    /** Height of the Monaco editor. */
+    height?: string | number;
+    /** Minimum height of the Monaco editor container. */
+    minHeight?: string | number;
+    /** Whether the Monaco editor is read-only. */
+    readOnly?: boolean;
+    /** Monaco theme mode. */
+    theme?: SsmlEditorTheme;
+    /** Monaco editor font size. */
+    fontSize?: number;
+    /** Monaco editor word wrapping mode. */
+    wordWrap?: SsmlEditorWordWrap;
+    /** Monaco editor line number mode. */
+    lineNumbers?: SsmlEditorLineNumbers;
+    /** Whether the Monaco minimap is displayed. */
+    minimap?: boolean;
+    /** Whether Monaco automatically lays out when its container changes size. */
+    automaticLayout?: boolean;
+    /** Reorders all toolbar controls. Unlisted controls follow. */
+    toolbarOrder?: readonly SsmlEditorButton[];
+    /** Adds vertical separators between configured toolbar groups. */
+    toolbarGroups?: readonly SsmlEditorToolbarGroup[];
+    /** Reorders built-in and custom insertion menus. Unlisted insertions follow. */
+    insertionOrder?: readonly string[];
+    /** Visually groups insertion menus when toolbarGroups is not supplied. */
+    insertionGroups?: readonly SsmlEditorInsertionGroup[];
+    /** Replaces built-in insertion definitions with custom definitions by ID. */
+    customInsertions?: SsmlEditorCustomInsertionCollection;
+    /** Adds insertion definitions without replacing built-in definitions. */
+    additionalInsertions?: SsmlEditorCustomInsertionCollection;
+    /** Candidate style values shown by the built-in emotion insertion. */
+    emotionStyles?: readonly string[];
+    /** Class name applied to the editor container. */
+    className?: string;
+    /** Inline styles applied to the editor container. */
+    style?: CSSProperties;
+    /** Class name applied to the toolbar. */
+    toolbarClassName?: string;
+    /** Inline styles applied to the toolbar. */
+    toolbarStyle?: CSSProperties;
+    /** Class name applied to the editor display area. */
+    displayClassName?: string;
+    /** Inline styles applied to the editor display area. */
+    displayStyle?: CSSProperties;
+}
+interface SelectionInfo {
+    selectedText: string;
+    characterCount: number;
+    hasSelection: boolean;
+}
+interface SsmlEditorRef {
+    getSelectedSsml(): string | null;
+    getCurrentLineSsml(): string | null;
+    getFullSsml(): string;
+}
+declare const SsmlEditor: react.ForwardRefExoticComponent<SsmlEditorProps & react.RefAttributes<SsmlEditorRef>>;
+
+type MonacoEditor = Parameters<OnMount>[0];
+
+interface SsmlTagRange {
+    start: number;
+    end: number;
+}
+declare function updateTagAttribute(text: string, tagRange: SsmlTagRange, attributeName: string, newValue: string): string;
+
+type SsmlCodeLensAction = {
+    type: "attribute";
+    insertionId: "rate" | "pitch" | "break";
+    attributeName: "rate" | "pitch" | "time";
+    tagRange: SsmlTagRange;
+} | {
+    type: "unwrap" | "delete";
+    tagRange: SsmlTagRange;
+    elementRange: SsmlTagRange;
+};
+type SsmlCodeLensCallback = (action: SsmlCodeLensAction) => void;
+declare function registerSsmlCodeLens(monaco: Monaco, editor: MonacoEditor, onOpenPopover: SsmlCodeLensCallback): ReturnType<Monaco["languages"]["registerCodeLensProvider"]>;
+
+export { EDITOR_COPY, type EditorCopy, INLINE_BADGE_COPY, type InlineBadgeCopy, SSML_HOVER_COPY, SSML_INSERTIONS, type SelectionInfo, type SsmlCodeLensAction, type SsmlCodeLensCallback, SsmlEditor, type SsmlEditorButton, type SsmlEditorButtonVisibility, type SsmlEditorCustomInsertion, type SsmlEditorCustomInsertionCollection, type SsmlEditorCustomInsertionDefinition, type SsmlEditorInsertionButton, type SsmlEditorInsertionDefinition, type SsmlEditorInsertionGroup, type SsmlEditorInsertionMode, type SsmlEditorInsertionOption, type SsmlEditorInsertionTemplate, type SsmlEditorLanguage, type SsmlEditorLineNumbers, type SsmlEditorLocale, type SsmlEditorLocalizedText, type SsmlEditorOptions, type SsmlEditorProps, type SsmlEditorRef, type SsmlEditorTheme, type SsmlEditorToolbarGroup, type SsmlEditorWordWrap, type SsmlHoverLocale, type SsmlHoverParameterCopy, type SsmlHoverTagCopy, type SsmlInsertionDefinition, type SsmlInsertionOption, type SsmlInsertionTemplate, type SsmlTagRange, createSsmlEditorInsertionDefinition, registerSsmlCodeLens, updateTagAttribute };

package/dist/index.d.ts

@@ -0,0 +1,288 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { SsmlDocument } from '@ssml-builder-js/ssml-core';
+import { OnMount, Monaco } from '@monaco-editor/react';
+
+type SsmlEditorInsertionButton = "break" | "emphasis" | "rate" | "pitch" | "volume" | "emotion" | "say-as" | "phoneme" | "audio" | "sub" | "lang" | "mark" | "bookmark" | "mstts:silence" | "mstts:viseme" | (string & {});
+type SsmlEditorButton = "help" | SsmlEditorInsertionButton | "undo" | "redo" | "clearAll" | "format" | "decorations" | (string & {});
+type SsmlEditorButtonVisibility = Readonly<Partial<Record<string, boolean>>>;
+
+type SsmlEditorLocale = "ja" | "en";
+type SsmlEditorLanguage = SsmlEditorLocale;
+type SsmlEditorLocalizedText = Readonly<Record<SsmlEditorLocale, string>>;
+interface EditorCopy {
+    editorAriaLabel: string;
+    toolbarAriaLabel: string;
+    undo: string;
+    undoTitle: string;
+    redo: string;
+    redoTitle: string;
+    clearAll: string;
+    clearAllTitle: string;
+    help: string;
+    helpTitle: string;
+    helpHeading: string;
+    helpDescription: string;
+    parameters: string;
+    format: string;
+    formatTitle: string;
+    decorations: string;
+    decorationsShowTitle: string;
+    decorationsHideTitle: string;
+    syntaxError: string;
+    selectionActions: string;
+    selectionCountSuffix: string;
+    previewSelection: string;
+    previewSelectionTitle: string;
+    noAvailableOptions: string;
+    styleNotSupported: string;
+    categoryEmotions: string;
+    categoryScenarios: string;
+    categoryMedia: string;
+    categoryOther: string;
+}
+interface InlineBadgeCopy {
+    pause: string;
+    pitch: string;
+    prosody: string;
+}
+interface SsmlHoverParameterCopy {
+    title: string;
+    description: string;
+}
+interface SsmlHoverTagCopy {
+    title: string;
+    description: string;
+    parameters: Readonly<Record<string, SsmlHoverParameterCopy>>;
+}
+interface SsmlHoverLocale {
+    parameterHeading: string;
+    parametersHeading: string;
+    allowedValues: string;
+    example: string;
+    noParameters: string;
+    tags: Readonly<Record<string, SsmlHoverTagCopy>>;
+}
+declare const EDITOR_COPY: Readonly<Record<SsmlEditorLocale, EditorCopy>>;
+declare const INLINE_BADGE_COPY: Readonly<Record<SsmlEditorLocale, InlineBadgeCopy>>;
+declare const SSML_HOVER_COPY: Readonly<Record<SsmlEditorLocale, SsmlHoverLocale>>;
+
+type SsmlEditorInsertionMode = "insert" | "wrap";
+interface SsmlEditorInsertionOption {
+    value: string;
+    labels: SsmlEditorLocalizedText;
+    descriptions?: SsmlEditorLocalizedText;
+}
+interface SsmlEditorInsertionTemplate {
+    prefix: string;
+    suffix: string;
+    mode: SsmlEditorInsertionMode;
+}
+interface SsmlEditorInsertionDefinition {
+    id: string;
+    icon: string;
+    tagName?: string;
+    selfClosing?: boolean;
+    labels: SsmlEditorLocalizedText;
+    titles?: SsmlEditorLocalizedText;
+    descriptions: SsmlEditorLocalizedText;
+    parameterDescription: SsmlEditorLocalizedText;
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => SsmlEditorInsertionTemplate;
+}
+interface SsmlEditorCustomInsertionDefinition {
+    id: string;
+    tagName: string;
+    attribute?: string;
+    icon?: string;
+    labels: SsmlEditorLocalizedText;
+    titles?: SsmlEditorLocalizedText;
+    descriptions?: SsmlEditorLocalizedText;
+    parameterDescription?: SsmlEditorLocalizedText;
+    options: readonly SsmlEditorInsertionOption[];
+    mode?: SsmlEditorInsertionMode;
+}
+type SsmlEditorCustomInsertion = SsmlEditorInsertionDefinition | SsmlEditorCustomInsertionDefinition;
+type SsmlEditorCustomInsertionCollection = readonly SsmlEditorCustomInsertion[] | Readonly<Record<string, SsmlEditorCustomInsertion | undefined>>;
+interface SsmlEditorInsertionGroup {
+    id: string;
+    labels: SsmlEditorLocalizedText;
+    insertionIds: readonly string[];
+}
+interface SsmlEditorToolbarGroup {
+    id: string;
+    buttonIds: readonly string[];
+}
+type SsmlEditorTheme = "system" | "light" | "dark";
+type SsmlEditorWordWrap = "off" | "on" | "wordWrapColumn" | "bounded";
+type SsmlEditorLineNumbers = "on" | "off" | "relative" | "interval";
+interface SsmlEditorOptions {
+    height?: string | number;
+    minHeight?: string | number;
+    readOnly?: boolean;
+    theme?: SsmlEditorTheme;
+    fontSize?: number;
+    wordWrap?: SsmlEditorWordWrap;
+    lineNumbers?: SsmlEditorLineNumbers;
+    minimap?: boolean;
+    automaticLayout?: boolean;
+}
+type SsmlInsertionOption = SsmlEditorInsertionOption;
+type SsmlInsertionTemplate = SsmlEditorInsertionTemplate;
+type SsmlInsertionDefinition = SsmlEditorInsertionDefinition;
+declare function createSsmlEditorInsertionDefinition(definition: SsmlEditorCustomInsertionDefinition): SsmlEditorInsertionDefinition;
+declare const SSML_INSERTIONS: ({
+    id: string;
+    icon: string;
+    tagName: string;
+    selfClosing: true;
+    labels: {
+        ja: string;
+        en: string;
+    };
+    descriptions: {
+        ja: string;
+        en: string;
+    };
+    parameterDescription: {
+        ja: string;
+        en: string;
+    };
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => {
+        prefix: string;
+        suffix: string;
+        mode: "insert";
+    };
+} | {
+    id: string;
+    icon: string;
+    tagName: string;
+    labels: {
+        ja: string;
+        en: string;
+    };
+    descriptions: {
+        ja: string;
+        en: string;
+    };
+    parameterDescription: {
+        ja: string;
+        en: string;
+    };
+    options: readonly SsmlEditorInsertionOption[];
+    createTemplate: (value: string) => {
+        prefix: string;
+        suffix: string;
+        mode: "wrap";
+    };
+    selfClosing?: undefined;
+})[];
+interface SsmlEditorProps {
+    document: SsmlDocument;
+    onChange?: (document: SsmlDocument) => void;
+    onSsmlChange?: (xml: string) => void;
+    onSelectionChange?: (info: SelectionInfo) => void;
+    /** Called with the selected partial SSML when the selection preview action is used. The action is disabled when omitted. */
+    onPreviewSelection?: (ssml: string) => void;
+    /** UI language. Japanese is used when omitted. */
+    language?: SsmlEditorLanguage;
+    /** UI locale. Japanese is used when omitted; takes precedence over the legacy language prop. */
+    locale?: SsmlEditorLocale;
+    /** Whether the toolbar is displayed. */
+    showToolbar?: boolean;
+    /** Whether toolbar action icons are displayed. */
+    showToolbarIcons?: boolean;
+    /** Whether toolbar action text labels are displayed. */
+    showToolbarLabels?: boolean;
+    /** Whether inline SSML decorations are displayed. The toolbar switch can change this at runtime. */
+    showDecorations?: boolean;
+    /** Whether SSML CodeLens quick controls are displayed. */
+    enableCodeLens?: boolean;
+    /** Controls which editor action buttons are displayed. Unspecified buttons are shown. */
+    buttonVisibility?: SsmlEditorButtonVisibility;
+    /** Monaco editor settings. */
+    editorOptions?: SsmlEditorOptions;
+    /** Alias for editorOptions. */
+    settings?: SsmlEditorOptions;
+    /** Fallback UI displayed while Monaco is loading. */
+    loadingFallback?: ReactNode;
+    /** Height of the Monaco editor. */
+    height?: string | number;
+    /** Minimum height of the Monaco editor container. */
+    minHeight?: string | number;
+    /** Whether the Monaco editor is read-only. */
+    readOnly?: boolean;
+    /** Monaco theme mode. */
+    theme?: SsmlEditorTheme;
+    /** Monaco editor font size. */
+    fontSize?: number;
+    /** Monaco editor word wrapping mode. */
+    wordWrap?: SsmlEditorWordWrap;
+    /** Monaco editor line number mode. */
+    lineNumbers?: SsmlEditorLineNumbers;
+    /** Whether the Monaco minimap is displayed. */
+    minimap?: boolean;
+    /** Whether Monaco automatically lays out when its container changes size. */
+    automaticLayout?: boolean;
+    /** Reorders all toolbar controls. Unlisted controls follow. */
+    toolbarOrder?: readonly SsmlEditorButton[];
+    /** Adds vertical separators between configured toolbar groups. */
+    toolbarGroups?: readonly SsmlEditorToolbarGroup[];
+    /** Reorders built-in and custom insertion menus. Unlisted insertions follow. */
+    insertionOrder?: readonly string[];
+    /** Visually groups insertion menus when toolbarGroups is not supplied. */
+    insertionGroups?: readonly SsmlEditorInsertionGroup[];
+    /** Replaces built-in insertion definitions with custom definitions by ID. */
+    customInsertions?: SsmlEditorCustomInsertionCollection;
+    /** Adds insertion definitions without replacing built-in definitions. */
+    additionalInsertions?: SsmlEditorCustomInsertionCollection;
+    /** Candidate style values shown by the built-in emotion insertion. */
+    emotionStyles?: readonly string[];
+    /** Class name applied to the editor container. */
+    className?: string;
+    /** Inline styles applied to the editor container. */
+    style?: CSSProperties;
+    /** Class name applied to the toolbar. */
+    toolbarClassName?: string;
+    /** Inline styles applied to the toolbar. */
+    toolbarStyle?: CSSProperties;
+    /** Class name applied to the editor display area. */
+    displayClassName?: string;
+    /** Inline styles applied to the editor display area. */
+    displayStyle?: CSSProperties;
+}
+interface SelectionInfo {
+    selectedText: string;
+    characterCount: number;
+    hasSelection: boolean;
+}
+interface SsmlEditorRef {
+    getSelectedSsml(): string | null;
+    getCurrentLineSsml(): string | null;
+    getFullSsml(): string;
+}
+declare const SsmlEditor: react.ForwardRefExoticComponent<SsmlEditorProps & react.RefAttributes<SsmlEditorRef>>;
+
+type MonacoEditor = Parameters<OnMount>[0];
+
+interface SsmlTagRange {
+    start: number;
+    end: number;
+}
+declare function updateTagAttribute(text: string, tagRange: SsmlTagRange, attributeName: string, newValue: string): string;
+
+type SsmlCodeLensAction = {
+    type: "attribute";
+    insertionId: "rate" | "pitch" | "break";
+    attributeName: "rate" | "pitch" | "time";
+    tagRange: SsmlTagRange;
+} | {
+    type: "unwrap" | "delete";
+    tagRange: SsmlTagRange;
+    elementRange: SsmlTagRange;
+};
+type SsmlCodeLensCallback = (action: SsmlCodeLensAction) => void;
+declare function registerSsmlCodeLens(monaco: Monaco, editor: MonacoEditor, onOpenPopover: SsmlCodeLensCallback): ReturnType<Monaco["languages"]["registerCodeLensProvider"]>;
+
+export { EDITOR_COPY, type EditorCopy, INLINE_BADGE_COPY, type InlineBadgeCopy, SSML_HOVER_COPY, SSML_INSERTIONS, type SelectionInfo, type SsmlCodeLensAction, type SsmlCodeLensCallback, SsmlEditor, type SsmlEditorButton, type SsmlEditorButtonVisibility, type SsmlEditorCustomInsertion, type SsmlEditorCustomInsertionCollection, type SsmlEditorCustomInsertionDefinition, type SsmlEditorInsertionButton, type SsmlEditorInsertionDefinition, type SsmlEditorInsertionGroup, type SsmlEditorInsertionMode, type SsmlEditorInsertionOption, type SsmlEditorInsertionTemplate, type SsmlEditorLanguage, type SsmlEditorLineNumbers, type SsmlEditorLocale, type SsmlEditorLocalizedText, type SsmlEditorOptions, type SsmlEditorProps, type SsmlEditorRef, type SsmlEditorTheme, type SsmlEditorToolbarGroup, type SsmlEditorWordWrap, type SsmlHoverLocale, type SsmlHoverParameterCopy, type SsmlHoverTagCopy, type SsmlInsertionDefinition, type SsmlInsertionOption, type SsmlInsertionTemplate, type SsmlTagRange, createSsmlEditorInsertionDefinition, registerSsmlCodeLens, updateTagAttribute };