@mdaemon/html-editor 1.2.1 → 1.3.0

package/README.md

@@ -104,6 +104,7 @@ const editor = new HTMLEditor(container, {
 | `convert_unsafe_embeds` | boolean | true | Sanitize embedded content |
 | `format_empty_lines` | boolean | true | Format empty lines |
 | `paste_from_office` | boolean | true | Clean and preserve formatting when pasting from Microsoft Word and Excel |
+| `speech_to_text` | boolean | true | Enable Speech to Text and Dictate toolbar buttons (requires Web Speech API: Chrome, Edge, Safari) |
 | `setup` | (editor) => void | - | Callback invoked before init — use to register custom buttons |
 
 ### Toolbar Toggle
@@ -259,6 +260,8 @@ All built-in toolbar button names that can be used in the `toolbar` config strin
 | `fullscreen` | Toggle fullscreen editing mode |
 | `preview` | Open content preview in a new window |
 | `searchreplace` | Open Find & Replace dialog |
+| `speechtotext` | Open Speech to Text dialog (browser support required) |
+| `dictate` | Toggle inline dictation — inserts speech directly at cursor (browser support required) |
 | `ltr` | Set text direction to left-to-right |
 | `rtl` | Set text direction to right-to-left |
 

package/dist/index.d.ts

@@ -75,6 +75,37 @@ export declare function createTranslateFunction(code: string): TranslateFunction
  */
 export declare const DEFAULT_ICONS: IconSet;
 
+export declare class Dictation {
+    private options;
+    private recognition;
+    private _isActive;
+    private restartTimer;
+    private interimStart;
+    private interimLength;
+    constructor(options: DictationOptions);
+    get isActive(): boolean;
+    toggle(): void;
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    private getSpeechLang;
+    private handleResult;
+    /** Replace the current interim text in the editor with new interim text */
+    private replaceInterim;
+    /** Remove interim text without inserting anything */
+    private clearInterim;
+    private needsLeadingSpace;
+    private handleError;
+    private handleEnd;
+}
+
+export declare interface DictationOptions {
+    editor: HTMLEditor;
+    trans: (key: string) => string;
+    /** Called when dictation starts or stops so the toolbar can update the button state */
+    onStateChange?: (isActive: boolean) => void;
+}
+
 declare type DirtyCallback = (dirty: boolean) => void;
 
 /**
@@ -139,6 +170,7 @@ export declare interface EditorConfig {
     quickbars_image_toolbar?: boolean;
     quickbars_insert_toolbar?: boolean;
     paste_from_office?: boolean;
+    speech_to_text?: boolean;
     browser_spellcheck?: boolean;
     elementpath?: boolean;
     entity_encoding?: 'raw' | 'named' | 'numeric';
@@ -316,6 +348,11 @@ export declare interface ImageUploadResult {
  */
 declare type InitCallback = (editor: MDHTMLEditor) => void;
 
+/**
+ * Check if the Web Speech API is available in the current browser
+ */
+export declare function isSpeechRecognitionSupported(): boolean;
+
 export declare type LanguageChangeCallback = (code: string) => void;
 
 export declare const LineHeight: Extension<LineHeightOptions, any>;
@@ -461,6 +498,50 @@ export declare interface SourceEditorOptions {
     trans: (key: string) => string;
 }
 
+export declare class SpeechToText {
+    private options;
+    private overlay;
+    private dialog;
+    private recognition;
+    private isListening;
+    private finalTranscript;
+    private interimTranscript;
+    private lastConfidence;
+    private restartTimer;
+    private transcriptArea;
+    private confidenceEl;
+    private statusEl;
+    private startStopBtn;
+    private insertBtn;
+    private clearBtn;
+    private languageSelect;
+    constructor(options: SpeechToTextOptions);
+    open(): void;
+    close(): void;
+    destroy(): void;
+    private get editorLanguage();
+    private getDefaultSpeechLang;
+    private createDialog;
+    private toggleRecognition;
+    private startRecognition;
+    private handleResult;
+    private handleError;
+    private handleEnd;
+    private stopRecognition;
+    private updateButtonState;
+    private setStatus;
+    private updateTranscriptDisplay;
+    private updateConfidenceDisplay;
+    private insertTranscript;
+    private clearTranscript;
+    private escapeHtml;
+}
+
+export declare interface SpeechToTextOptions {
+    editor: HTMLEditor;
+    trans: (key: string) => string;
+}
+
 /**
  * Template object for email templates
  */
@@ -493,6 +574,8 @@ export declare class Toolbar {
     private searchReplace;
     private sourceEditor;
     private linkEditor;
+    private speechToText;
+    private dictation;
     private updateInterval;
     private boundClickHandler;
     private boundKeydownHandler;
@@ -537,6 +620,8 @@ export declare class Toolbar {
     private openCharMap;
     private openEmojiPicker;
     private openSearchReplace;
+    private openSpeechToText;
+    private toggleDictation;
     private openSourceCode;
     private openPreview;
     private toggleFullscreen;