jodit-pro 4.12.32 → 4.12.33

package/types/plugins/ai-assistant-pro/voice/voice-input-button.d.ts

@@ -0,0 +1,85 @@
+/*!
+ * Jodit Editor PRO (https://xdsoft.net/jodit/)
+ * See LICENSE.md in the project root for license information.
+ * Copyright (c) 2013-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net/jodit/pro/
+ */
+import type { IViewBased } from "jodit/esm/types/index";
+import type { VoiceEngineFactory } from "./voice-engine";
+/**
+ * Resolved voice settings the mic button needs (built by the input area from the
+ * flat `voiceInput*` options).
+ *
+ * @module plugins/ai-assistant-pro/voice
+ */
+export interface IVoiceInputConfig {
+    url?: string;
+    apiKey?: string;
+    defaultModel?: string;
+    language?: string;
+    silenceTimeoutMs?: number;
+    autoSendSilenceMs?: number | null;
+    /** Custom recognition engine; when set it replaces the built-in proxy engine. */
+    api?: VoiceEngineFactory;
+}
+/**
+ * Read/write access to the prompt the dictated text goes into.
+ */
+export interface IVoiceInputIO {
+    /** Raw current value (not trimmed). */
+    getValue(): string;
+    /** Replace the value and optionally place the caret at `caret`. */
+    setValue(value: string, caret?: number): void;
+    /** Current selection range within the value. */
+    getSelection(): {
+        start: number;
+        end: number;
+    };
+    focus(): void;
+    /** Send the current prompt (no-op if empty or a request is in flight). */
+    send(): void;
+}
+/**
+ * The microphone button for the assistant input area. Toggles a
+ * `VoiceTranscriber` session and writes interim/final transcripts into the prompt
+ * (interim text is previewed; final phrases are appended).
+ */
+export declare class VoiceInputButton {
+    private readonly jodit;
+    private readonly config;
+    private readonly io;
+    private readonly button;
+    private engine;
+    /** Whether a recognition session is active. */
+    private listening;
+    /** Whether a phrase is in progress (between its first interim and its final). */
+    private phraseActive;
+    /** Prompt text before the caret, captured at the start of the current phrase. */
+    private before;
+    /** Prompt text after the caret (or selection), captured at phrase start. */
+    private after;
+    /** Pending hands-free auto-send timer id (0 = none). */
+    private autoSendTimer;
+    constructor(jodit: IViewBased, config: IVoiceInputConfig, io: IVoiceInputIO);
+    private onPromptSent;
+    get container(): HTMLElement;
+    setParentView(view: IViewBased): void;
+    private toggle;
+    private start;
+    private reset;
+    /**
+     * Schedule a hands-free auto-send after `autoSendSilenceMs` of no new speech.
+     * No-op when the option is unset/null.
+     */
+    private scheduleAutoSend;
+    private clearAutoSend;
+    private setActive;
+    /**
+     * Insert the current phrase at the caret. The text around the caret (or
+     * selection) is captured once at the start of each phrase from the live input,
+     * so dictation lands where the cursor is, replaces any selection, and respects
+     * manual edits / sends between phrases. Subsequent interims of the same phrase
+     * replace its preview rather than accumulating.
+     */
+    private insertPhrase;
+    destruct(): void;
+}

package/types/plugins/ai-assistant-pro/voice/voice-transcriber.d.ts

@@ -0,0 +1,55 @@
+/*!
+ * Jodit Editor PRO (https://xdsoft.net/jodit/)
+ * See LICENSE.md in the project root for license information.
+ * Copyright (c) 2013-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net/jodit/pro/
+ */
+import type { IVoiceEngine } from "./voice-engine";
+/**
+ * Streams microphone audio to the Jodit transcription proxy
+ * (`wss://…/v1/ai/transcribe`) and reports transcript events back. The cloud key
+ * stays on the server; the browser only opens an authenticated socket and sends
+ * binary PCM16 audio.
+ *
+ * The server speaks the JSON protocol `ready` / `delta` / `final` / `error`; this
+ * class translates it into callbacks the mic button consumes.
+ *
+ * @module plugins/ai-assistant-pro/voice
+ */
+export interface IVoiceTranscriberOptions {
+    /** Proxy endpoint, e.g. `wss://cloud.xdsoft.net/v1/ai/transcribe`. */
+    url: string;
+    /** Cloud API key (sent as the `key` query param). */
+    apiKey: string;
+    /** Transcription model; defaults to the server's default. */
+    model?: string;
+    /** BCP-47 language hint, e.g. `en-US`. */
+    language?: string;
+    /** Silence (ms) before a phrase is committed; sent as the `silence` param. */
+    silenceMs?: number;
+    /** Upstream session is live — audio is now streaming. */
+    onReady?: () => void;
+    /** Interim (partial) transcript for the current phrase. */
+    onInterim?: (text: string) => void;
+    /** Committed transcript for a finished phrase. */
+    onFinal?: (text: string) => void;
+    /** A recoverable error (mic denied, connection/provider error). */
+    onError?: (message: string) => void;
+    /** The session ended (socket closed). */
+    onEnd?: () => void;
+}
+export declare class VoiceTranscriber implements IVoiceEngine {
+    private readonly options;
+    private ws;
+    private streamer;
+    private running;
+    constructor(options: IVoiceTranscriberOptions);
+    get isActive(): boolean;
+    /** Open the socket and begin a transcription session. */
+    start(): void;
+    /** Stop the session and release the microphone. */
+    stop(): void;
+    private onMessage;
+    private startAudio;
+    private fail;
+    private finish;
+}