@malva-ui/editor 0.1.13 → 0.1.14

package/lib/ai/editor-ai-stream.d.ts

@@ -1,207 +0,0 @@
-import type { Editor } from '@tiptap/core';
-import type { MlvEditorErrorCode } from '../editor.types';
-import type { MlvEditorAiOutputMode } from './editor-ai.types';
-/**
- * CSS class of the inline decoration marking the active streaming region.
- *
- * The class is applied through a ProseMirror decoration held in plugin state,
- * never through document content, so it can appear in no HTML, Markdown, or
- * JSON serialization.
- */
-export declare const MLV_EDITOR_AI_STREAMING_CLASS = "mlv-editor__ai-streaming";
-/**
- * CSS class of the one-shot inline decoration over each flush's newly
- * revealed slice of the streaming region.
- *
- * Created exactly once per revealed delta and only mapped afterwards — never
- * rebuilt for old ranges — so a one-shot CSS entrance animation runs once per
- * chunk and earlier text never re-animates. Removed with the region
- * decoration on commit, cancel, and abandonment, and excluded from every
- * serialization the same way.
- */
-export declare const MLV_EDITOR_AI_STREAMING_CHUNK_CLASS = "mlv-editor__ai-streaming-chunk";
-/**
- * CSS class of the `aria-hidden` widget decoration the streaming engine
- * keeps at the current insertion tip while a writing session is active.
- *
- * View-layer only: it exists in no HTML, Markdown, or JSON serialization and
- * is removed when the session settles (commit, cancel, abandonment, failure).
- * Collect-only `'review'` sessions never render it — they never write.
- */
-export declare const MLV_EDITOR_AI_CARET_CLASS = "mlv-editor__ai-caret";
-/**
- * Output modes a streaming session supports.
- *
- * `'replace-selection'` and `'insert-below'` write into the document while
- * streaming. `'review'` is collect-only: the session runs the full lifecycle
- * — Escape cancellation, external-transaction abandonment, transport/result
- * error detection — but never writes; the caller routes the accumulated text
- * through the suggestion engine after commit.
- */
-export type MlvEditorAiStreamOutputMode = MlvEditorAiOutputMode;
-/**
- * Error categories a streaming session can report.
- *
- * `'ai-transport'` — the chunk iterable threw or rejected mid-stream.
- * `'ai-result'` — the completed stream produced no usable content (empty or
- * whitespace-only total output), or the target region rejected the write.
- * Both are narrowed from {@link MlvEditorErrorCode} so hosts can forward them
- * to `editorError` unchanged.
- */
-export type MlvEditorAiStreamErrorCode = Extract<MlvEditorErrorCode, 'ai-transport' | 'ai-result'>;
-/**
- * Terminal state of one streaming session.
- *
- * `'committed'` — the stream completed and the final content landed as exactly
- * one history-visible step. `'cancelled'` — {@link MlvEditorAiStreamHandle.cancel}
- * aborted the session and the checkpoint was restored silently. `'abandoned'`
- * — an external document change ended the session without any restore.
- * `'failed'` — the session ended with an {@link MlvEditorAiStreamErrorCode}
- * and the checkpoint was restored.
- */
-export type MlvEditorAiStreamStatus = 'committed' | 'cancelled' | 'abandoned' | 'failed';
-/**
- * Schedules one buffered-chunk flush for the next animation frame.
- *
- * Receives the flush callback and returns a cancel function. The default
- * implementation uses `requestAnimationFrame` and falls back to a short
- * `setTimeout` where no frame API exists (server rendering, test DOMs).
- * Tests inject a manual scheduler to control flush timing deterministically.
- */
-export type MlvEditorAiFrameScheduler = (flush: () => void) => () => void;
-/** Options accepted by {@link runMlvEditorAiStream}. */
-export interface MlvEditorAiStreamOptions {
-    /**
-     * Markdown/text chunks in document order, typically produced by an
-     * `MlvEditorAiProvider`. A non-streaming source may yield a single chunk.
-     */
-    readonly chunks: AsyncIterable<string>;
-    /**
-     * Where the streamed content lands: `'replace-selection'` replaces the
-     * selection captured when the session started, `'insert-below'` streams
-     * into a new paragraph after the selection's top-level block, and
-     * `'review'` collects the complete stream without touching the document —
-     * the result is read from {@link MlvEditorAiStreamResult.text}.
-     */
-    readonly output: MlvEditorAiStreamOutputMode;
-    /** Frame scheduler override; defaults to `requestAnimationFrame`. */
-    readonly scheduler?: MlvEditorAiFrameScheduler;
-    /**
-     * Maximum characters one frame flush reveals into the document. Buffered
-     * text beyond the cap carries over: the session keeps scheduling follow-up
-     * frames until the buffer drains, so bursty provider chunks render at an
-     * even typing cadence instead of appearing in per-chunk lumps. Defaults to
-     * 4; `Infinity` restores the uncapped write-everything-per-frame behavior.
-     * Non-finite values other than `Infinity` and values below 1 fall back to
-     * the default; fractions are floored. The cap never delays settlement —
-     * commit, cancellation, and abandonment still apply the complete
-     * accumulated text immediately. Collect-only `'review'` sessions ignore it
-     * entirely (they never flush).
-     */
-    readonly revealCharsPerFrame?: number;
-}
-/** Terminal result every streaming session resolves with; it never rejects. */
-export interface MlvEditorAiStreamResult {
-    /** Terminal state of the session. */
-    readonly status: MlvEditorAiStreamStatus;
-    /** Error category for `'failed'` sessions, `null` for every other status. */
-    readonly error: MlvEditorAiStreamErrorCode | null;
-    /**
-     * Whether the session was stopped before completing: `true` for
-     * `'cancelled'` and `'abandoned'`, `false` for `'committed'` and
-     * `'failed'`. Cancellation and abandonment are silent — neither carries an
-     * error code.
-     */
-    readonly aborted: boolean;
-    /** Complete text accumulated from the stream, including unwritten chunks. */
-    readonly text: string;
-}
-/** Handle controlling one in-flight or finished streaming session. */
-export interface MlvEditorAiStreamHandle {
-    /** Resolves with the terminal {@link MlvEditorAiStreamResult}; never rejects. */
-    readonly done: Promise<MlvEditorAiStreamResult>;
-    /**
-     * Aborts an in-flight session: stops consuming chunks, restores the
-     * checkpoint through a history-invisible step, and resolves {@link done}
-     * with `'cancelled'` and no error. A no-op once the session has settled.
-     */
-    cancel(): void;
-    /**
-     * Restores the checkpoint captured when the session started.
-     *
-     * While the session is running this behaves exactly like {@link cancel}.
-     * After the session has settled it replaces the whole document with the
-     * checkpoint in one history-visible step — so a post-commit restore is
-     * itself undoable. Returns whether the document changed; `false` when the
-     * document already matches the checkpoint or the editor was destroyed.
-     * After an `'abandoned'` session this overwrites the external edit too —
-     * callers own that decision.
-     */
-    restoreCheckpoint(): boolean;
-}
-/**
- * Runs one AI streaming session against a live Tiptap editor.
- *
- * Framework-free: the runner needs only the editor instance and an async
- * iterable of Markdown/text chunks — no Angular, no provider token, no
- * network. Interim writes render the chunks as plain text inside the target
- * region; the final commit parses the accumulated Markdown through the
- * editor's Markdown manager, so the committed document carries real
- * structure rather than literal Markdown syntax. An editor without a
- * Markdown manager commits plain text — the same fallback the Angular
- * context uses for request serialization. The `'review'` output mode is
- * collect-only: no interim write, no decoration, and no final commit ever
- * touches the document — a `'committed'` result just carries the complete
- * text for the caller to route through the suggestion engine. Every other
- * lifecycle rule below (Escape, cancellation, abandonment, transport and
- * result errors) applies to it unchanged.
- *
- * Lifecycle:
- *
- * - A checkpoint (document JSON) and the target coordinates are captured when
- *   the session starts, before the first mutating step.
- * - Chunks are buffered and written at most once per animation frame, and
- *   each flush reveals at most {@link MlvEditorAiStreamOptions.revealCharsPerFrame}
- *   characters — the remainder carries over to self-scheduled follow-up
- *   frames, smoothing bursty providers into a steady typing cadence. Every
- *   interim write dispatches with `addToHistory: false`, so no partial state
- *   ever becomes an undo step.
- * - Each flush's newly revealed slice carries a one-shot
- *   {@link MLV_EDITOR_AI_STREAMING_CHUNK_CLASS} entrance decoration (created
- *   once, then only mapped), and an `aria-hidden`
- *   {@link MLV_EDITOR_AI_CARET_CLASS} widget marks the insertion tip while
- *   the session writes. Both are view-layer decorations: removed when the
- *   session settles and excluded from every serialization, exactly like the
- *   region tint.
- * - On successful completion the session silently reverts to the checkpoint
- *   and commits the complete content as exactly one history-visible step
- *   (closed against the previous history group): one undo restores the
- *   pre-session document.
- * - {@link MlvEditorAiStreamHandle.cancel} restores the checkpoint and
- *   resolves with `'cancelled'` — silently, with no error code. Pressing
- *   Escape inside the content region triggers the same cancellation through
- *   the session plugin's key handler.
- * - A thrown or rejected chunk iteration restores the checkpoint and resolves
- *   `'failed'` with `'ai-transport'`. Empty or whitespace-only total output
- *   restores the checkpoint and resolves `'failed'` with `'ai-result'`.
- * - **Abandonment**: any external transaction — one whose root carries no
- *   session metadata but changes the document (directly or through appended
- *   transactions) — ends the session immediately following the drag-lifecycle
- *   precedent. The session stops consuming and writing, removes its
- *   decoration, and resolves `'abandoned'` with `error: null` and
- *   `aborted: true`. **Nothing is restored**: inverting the checkpoint
- *   through foreign steps is unsafe, so the document is left exactly as the
- *   external edit made it, including any interim session writes (which were
- *   history-invisible and therefore cannot be undone individually).
- * - Destroying the editor mid-session settles it as `'abandoned'` without
- *   touching the DOM.
- *
- * The session never throws and {@link MlvEditorAiStreamHandle.done} never
- * rejects. Starting a new session on an editor cancels the session already
- * running there.
- *
- * @param editor Live Tiptap editor the session writes into.
- * @param options Chunk source, output mode, and optional frame scheduler.
- * @returns Handle exposing completion, cancellation, and checkpoint restore.
- */
-export declare function runMlvEditorAiStream(editor: Editor, options: MlvEditorAiStreamOptions): MlvEditorAiStreamHandle;

package/lib/ai/editor-ai-suggestions.d.ts

@@ -1,219 +0,0 @@
-import type { Editor } from '@tiptap/core';
-/**
- * CSS class of the inline decoration highlighting text a pending suggestion
- * inserted into the document.
- *
- * The class is applied through a ProseMirror decoration held in plugin state,
- * never through document content, so it can appear in no HTML, Markdown, or
- * JSON serialization.
- */
-export declare const MLV_EDITOR_AI_SUGGESTION_INSERT_CLASS = "mlv-editor__ai-suggestion-insert";
-/**
- * CSS class of the widget decoration rendering text a pending suggestion
- * removed from the document.
- *
- * The removed text lives only inside the widget element — a strikethrough,
- * `aria-hidden` affordance — so it is absent from the document and from every
- * serialization the moment the suggestion is applied.
- */
-export declare const MLV_EDITOR_AI_SUGGESTION_DELETE_CLASS = "mlv-editor__ai-suggestion-delete";
-/**
- * CSS class added on top of the insert and delete decorations of the one
- * suggestion a review surface currently navigates
- * ({@link MlvEditorAiSuggestionsSession.setCurrent}).
- *
- * A decoration-only outline affordance: it never enters document content or
- * any serialization, and marking a suggestion current dispatches no document
- * step, so it can never create a history entry.
- */
-export declare const MLV_EDITOR_AI_SUGGESTION_CURRENT_CLASS = "mlv-editor__ai-suggestion-current";
-/**
- * Shape of one reviewable change.
- *
- * `'insert'` — new text was added; reject removes it. `'delete'` — text was
- * removed; reject restores it. `'replace'` — text was swapped; reject
- * restores the original.
- */
-export type MlvEditorAiSuggestionKind = 'insert' | 'delete' | 'replace';
-/** Document range a suggestion currently occupies. */
-export interface MlvEditorAiSuggestionRange {
-    /** Start position of the suggestion's inserted content. */
-    readonly from: number;
-    /**
-     * End position of the suggestion's inserted content. Equals {@link from}
-     * for `'delete'` suggestions, whose removed text exists only in the widget
-     * decoration anchored at this collapsed position.
-     */
-    readonly to: number;
-}
-/** One pending, reviewable AI change. */
-export interface MlvEditorAiSuggestion {
-    /** Stable identifier, unique across sessions within this runtime. */
-    readonly id: string;
-    /** Shape of the change. */
-    readonly kind: MlvEditorAiSuggestionKind;
-    /**
-     * Current document range of the inserted content, remapped through every
-     * concurrent transaction. Collapsed for `'delete'` suggestions.
-     */
-    readonly range: MlvEditorAiSuggestionRange;
-    /** Plain text the change removed; empty for `'insert'`. */
-    readonly oldText: string;
-    /** Plain text the change added; empty for `'delete'`. */
-    readonly newText: string;
-}
-/** Options accepted by {@link applyMlvEditorAiSuggestions}. */
-export interface MlvEditorAiSuggestionsOptions {
-    /** Start of the document region the replacement rewrites. */
-    readonly from: number;
-    /** End of the document region the replacement rewrites. */
-    readonly to: number;
-    /**
-     * AI-produced replacement for the region, as Markdown. Parsed through the
-     * editor's Markdown manager when one is registered; treated as plain text
-     * otherwise — the same fallback the streaming engine uses for its commit.
-     */
-    readonly replacementMarkdown: string;
-}
-/**
- * Handle over one review session created by {@link applyMlvEditorAiSuggestions}.
- *
- * Undo semantics — a deliberate refinement of the spec sentence "each
- * accept/reject = one undo step": in the applied-edits storage model the
- * document already carries every change, so **accepting changes no document
- * content**. Accept operations (including {@link acceptAll}) are pure
- * plugin-state updates that drop decorations and entries without dispatching
- * a single step, and therefore create **no** history entry — an "accept undo
- * step" would necessarily be an empty one. Rejects mutate the document:
- * {@link reject} is exactly one history-visible step per call, and
- * {@link rejectAll} is exactly one step total.
- *
- * Every method returns `false` once the session has ended — all suggestions
- * resolved, the application undone, a newer session started, or the editor
- * destroyed.
- */
-export interface MlvEditorAiSuggestionsSession {
-    /**
-     * Current pending suggestions in document order, with ranges remapped
-     * through every transaction dispatched since application. Empty once the
-     * session has ended.
-     */
-    suggestions(): readonly MlvEditorAiSuggestion[];
-    /**
-     * Accepts one suggestion: the applied change stays in the document and its
-     * decorations are dropped. A pure plugin-state update — no document step,
-     * no history entry. Returns whether the suggestion existed.
-     */
-    accept(id: string): boolean;
-    /**
-     * Rejects one suggestion: the original content is restored over the
-     * suggestion's current range in exactly one history-visible step, and the
-     * suggestion's decorations are dropped. Returns whether the suggestion
-     * existed and the restore succeeded.
-     *
-     * Restored is the reviewed region, not the editor's own schema-maintenance
-     * reactions to the suggested state: for example, the default preset's
-     * `trailingNode` paragraph appended while a structural suggestion was the
-     * last block stays behind — the same residue an ordinary user edit leaves.
-     */
-    reject(id: string): boolean;
-    /**
-     * Accepts every pending suggestion in one plugin-state update. Like
-     * {@link accept}, dispatches no document step and creates no history
-     * entry. Returns whether any suggestion was pending.
-     */
-    acceptAll(): boolean;
-    /**
-     * Rejects every pending suggestion in exactly one history-visible step,
-     * restoring the original content of the whole reviewed region. Returns
-     * whether any suggestion was pending and the restore succeeded.
-     */
-    rejectAll(): boolean;
-    /**
-     * Marks one suggestion as the current one under review: its decorations
-     * gain {@link MLV_EDITOR_AI_SUGGESTION_CURRENT_CLASS} and the previous
-     * current suggestion loses it. `null` clears the marker. Like
-     * {@link accept}, a pure plugin-state update — no document step, no
-     * history entry. The marker clears itself when its suggestion resolves or
-     * is dropped by a concurrent edit. Returns `false` once the session has
-     * ended or for an unknown id.
-     */
-    setCurrent(id: string | null): boolean;
-}
-/** One contiguous change between two texts, produced by {@link mlvEditorAiWordDiff}. */
-export interface MlvEditorAiWordDiffRun {
-    /** Shape of the change at this position. */
-    readonly kind: MlvEditorAiSuggestionKind;
-    /** Inclusive character offset in the old text where the run starts. */
-    readonly oldFrom: number;
-    /**
-     * Exclusive character offset in the old text where the run ends. Equals
-     * {@link oldFrom} for `'insert'` runs.
-     */
-    readonly oldTo: number;
-    /** Old text covered by the run; empty for `'insert'`. */
-    readonly oldText: string;
-    /** New text the run introduces; empty for `'delete'`. */
-    readonly newText: string;
-}
-/**
- * Token-level word diff between two plain texts, computed over a
- * longest-common-subsequence of tokens. Tokens are maximal whitespace or
- * non-whitespace runs, so whitespace changes are diffed like words.
- * Consecutive non-equal tokens merge into one run; a run that both removes
- * and adds text is a `'replace'`.
- *
- * Pure and framework-free. Returns an empty array for identical inputs.
- *
- * @param oldText Text currently in the document.
- * @param newText Replacement text.
- * @returns Change runs in ascending old-text offset order.
- */
-export declare function mlvEditorAiWordDiff(oldText: string, newText: string): readonly MlvEditorAiWordDiffRun[];
-/**
- * Applies an AI replacement for `[from, to]` as reviewable tracked changes —
- * the Phase 2 suggestion engine (storage option B of the design spec).
- *
- * Framework-free: only the editor instance and the replacement Markdown are
- * needed — no Angular, no provider token, no network.
- *
- * Diff granularity (pragmatic, documented rule): when the original region is
- * a single textblock of plain, unmarked text **and** the parsed replacement
- * is a single paragraph of plain text, the two are diffed token-by-token
- * (tokens are whitespace or word runs) over a longest common subsequence,
- * producing individual insert/delete/replace suggestions. Any structural or
- * formatted content on either side falls back to **one** whole-region
- * replace suggestion.
- *
- * Representation: inserted text enters the document immediately and is
- * highlighted by an inline decoration
- * ({@link MLV_EDITOR_AI_SUGGESTION_INSERT_CLASS}); deleted text is removed
- * from the document and re-rendered at its position by a strikethrough
- * `aria-hidden` widget decoration
- * ({@link MLV_EDITOR_AI_SUGGESTION_DELETE_CLASS}). Because both are
- * decorations, `getHTML`/`getMarkdown`/`getJSON` during review serialize the
- * document as-is — inserted text present, removed text absent — the spec's
- * accepted-by-default rule. Hosts gate saves on pending suggestions.
- *
- * The whole application is exactly **one** history-visible transaction:
- * one undo removes every suggested change at once — and, because the undo
- * intersects every suggestion range, it also drops the whole session.
- *
- * Concurrent edits: user transactions remap all suggestion ranges through
- * their step maps; an edit that intersects a suggestion's range drops that
- * one suggestion (decorations removed, the current document text stands,
- * nothing is restored). The session ends when every suggestion is resolved
- * or dropped, and editor destruction cleans up listeners and plugin state.
- * Starting a new session on an editor first ends the previous one, leaving
- * its remaining suggestions applied (accepted-by-default).
- *
- * Undo-step semantics of the returned session are documented on
- * {@link MlvEditorAiSuggestionsSession}.
- *
- * @param editor Live Tiptap editor the suggestions are applied to.
- * @param options Region to rewrite and the replacement Markdown.
- * @returns The review session, or `null` when nothing reviewable results —
- * destroyed editor, out-of-range positions, unusable replacement, or a
- * replacement identical to the region.
- */
-export declare function applyMlvEditorAiSuggestions(editor: Editor, options: MlvEditorAiSuggestionsOptions): MlvEditorAiSuggestionsSession | null;

package/lib/ai/editor-ai.tokens.d.ts

@@ -1,10 +0,0 @@
-import { InjectionToken } from '@angular/core';
-import { type MlvEditorAiProvider } from './editor-ai.types';
-/**
- * Optional dependency-injection token for a host-provided AI transport.
- *
- * The per-editor `aiProvider` input wins over this token, mirroring
- * `MLV_EDITOR_IMAGE_UPLOADER` precedence. Without either, AI UI modules hide
- * and AI commands are unavailable.
- */
-export declare const MLV_EDITOR_AI_PROVIDER: InjectionToken<MlvEditorAiProvider>;

package/lib/ai/editor-ai.types.d.ts

@@ -1,176 +0,0 @@
-import type { MlvEditorAiContext } from './editor-ai-context';
-import type { MlvEditorAiSuggestionKind } from './editor-ai-suggestions';
-/**
- * The transform kinds the library itself ships menu entries and i18n copy for.
- *
- * `'improve'`, `'fix-grammar'`, `'shorten'`, `'extend'`, and `'summarize'`
- * rewrite the selection without further arguments. `'tone'` and `'translate'`
- * carry their target tone or language in
- * {@link MlvEditorAiRequest.instruction}. `'custom'` carries a free-form host
- * or user prompt in the same field.
- */
-export type MlvEditorAiBuiltInTransformKind = 'improve' | 'fix-grammar' | 'shorten' | 'extend' | 'summarize' | 'tone' | 'translate' | 'custom';
-/**
- * Selection transform requested from an AI provider: one of the
- * {@link MlvEditorAiBuiltInTransformKind} values, or any host-authored string.
- *
- * The provider owns prompting, so a kind is a name the *provider* understands
- * and is fully opaque to the editor: nothing in the library branches on it,
- * and it is forwarded verbatim on {@link MlvEditorAiRequest.kind}. A host that
- * supplies its own {@link MlvEditorAiAction} list can therefore name kinds the
- * library has never heard of (`'legal-review'`, `'to-bullets'`, …) and answer
- * them in its own provider.
- *
- * The union with `string` deliberately keeps the built-in literals in
- * autocomplete — `(string & {})` is not reduced to `string` by the compiler,
- * so editors still suggest `'improve'` while any other string remains
- * assignable. The corollary for providers: `request.kind` is not exhaustively
- * checkable, so a `switch` over it needs a `default` branch that tolerates
- * kinds it does not know.
- */
-export type MlvEditorAiTransformKind = MlvEditorAiBuiltInTransformKind | (string & {});
-/**
- * One entry of the AI menu's action list.
- *
- * Hosts pass an array of these to `MlvEditorAiMenu.actions` to replace the
- * built-in list literally — see `mlvEditorAiDefaultActions()` to start from
- * the built-ins instead of retyping them.
- */
-export interface MlvEditorAiAction {
-    /**
-     * Transform kind forwarded verbatim to the provider through
-     * {@link MlvEditorAiContext.runTransform}. Any string is valid; see
-     * {@link MlvEditorAiTransformKind}. Ignored when {@link run} is present.
-     *
-     * Kinds are not required to be unique within one list: two entries may run
-     * the same kind with different instructions.
-     */
-    readonly kind: MlvEditorAiTransformKind;
-    /**
-     * Display text of the menu item, already resolved. The menu renders it as
-     * given and never translates it — a localized list is built by resolving
-     * the copy before constructing the actions.
-     */
-    readonly label: string;
-    /**
-     * Free-form transform argument passed through as
-     * {@link MlvEditorAiRequest.instruction}: a fixed tone for `'tone'`, a fixed
-     * target language for `'translate'`, or a canned prompt for `'custom'`.
-     * Omitted from the request when absent. Ignored when {@link run} is present.
-     */
-    readonly instruction?: string;
-    /**
-     * Where the result lands; defaults to `'replace-selection'`. Ignored when
-     * {@link run} is present.
-     */
-    readonly output?: MlvEditorAiOutputMode;
-    /**
-     * Escape hatch replacing the menu's own behaviour for this entry.
-     *
-     * When present the menu calls this instead of `runTransform` and reads
-     * neither {@link kind}, {@link instruction}, nor {@link output} — they stay
-     * available to the callback itself, which owns the whole action. The
-     * argument is the live per-editor {@link MlvEditorAiContext}, so the
-     * callback can call `runTransform` with anything (including options this
-     * shape cannot express), chain several calls, inspect `status()` /
-     * `hasProvider()` / the review surface, or do something else entirely and
-     * never touch the AI context at all.
-     *
-     * It runs only when the item is enabled, so the readonly, disabled, and
-     * already-running guards still hold.
-     *
-     * @param context The AI context of the editor this menu belongs to.
-     */
-    readonly run?: (context: MlvEditorAiContext) => void;
-}
-/**
- * Where the streamed result of a transform lands in the document.
- *
- * `'replace-selection'` overwrites the selected fragment in place.
- * `'insert-below'` keeps the selection and streams the result into a new
- * block after it. `'review'` collects the complete result without touching
- * the document, then lands it as reviewable tracked suggestions the user
- * accepts or rejects through the context's suggestion surface.
- */
-export type MlvEditorAiOutputMode = 'replace-selection' | 'insert-below' | 'review';
-/**
- * One pending AI change as the Angular context exposes it to review UIs.
- *
- * A projection of the engine-level `MlvEditorAiSuggestion`: the live document
- * range stays internal to the context — positions remap on every transaction
- * and would be stale the moment a template read them. Review surfaces render
- * identity, shape, and the two texts; accept/reject go back through the
- * context by `id`.
- */
-export interface MlvEditorAiReviewSuggestion {
-    /** Stable identifier, unique across sessions within this runtime. */
-    readonly id: string;
-    /**
-     * Shape of the change: `'insert'` added text, `'delete'` removed text,
-     * `'replace'` swapped text.
-     */
-    readonly kind: MlvEditorAiSuggestionKind;
-    /** Plain text the change removed; empty for `'insert'`. */
-    readonly oldText: string;
-    /** Plain text the change added; empty for `'delete'`. */
-    readonly newText: string;
-}
-/**
- * One structured request handed to an {@link MlvEditorAiProvider}.
- *
- * The editor never builds a prompt: the provider receives the transform kind,
- * the optional instruction, and Markdown context, and owns prompting, model
- * choice, and server-side policy itself.
- */
-export interface MlvEditorAiRequest {
-    /**
-     * Requested capability. Either a selection transform or `'autocomplete'`
-     * for ghost-text completion at the caret.
-     *
-     * Not a closed union: a host-supplied action list can name any kind, so a
-     * provider that branches on this field must tolerate kinds it does not
-     * recognize rather than assume exhaustiveness.
-     */
-    readonly kind: MlvEditorAiTransformKind | 'autocomplete';
-    /**
-     * Free-form argument for the transform: the custom prompt for `'custom'`,
-     * the target tone for `'tone'`, or the target language for `'translate'`.
-     * Absent for transforms that need no argument.
-     */
-    readonly instruction?: string;
-    /** Markdown context captured from the editor when the request started. */
-    readonly context: {
-        /** Selected fragment as Markdown, or `null` when nothing is selected. */
-        readonly selection: string | null;
-        /** Optional surrounding document window as Markdown, or `null`. */
-        readonly document: string | null;
-    };
-    /**
-     * Aborted when the user cancels, presses Escape, or edits the document
-     * mid-stream. Providers should stop producing chunks once aborted.
-     */
-    readonly signal: AbortSignal;
-    /** Host-defined passthrough metadata; the editor never reads it. */
-    readonly meta?: Record<string, unknown>;
-}
-/**
- * Host-supplied transport for AI transforms.
- *
- * The library performs no network requests itself. Hosts provide an
- * implementation through the `aiProvider` input on `mlv-editor` or the
- * `MLV_EDITOR_AI_PROVIDER` injection token; the input wins, mirroring the
- * image-uploader precedence rule.
- */
-export interface MlvEditorAiProvider {
-    /**
-     * Streams the result of one request as plain Markdown/text chunks.
-     *
-     * Non-streaming transports may return a single-chunk iterable. A thrown
-     * error or rejected iteration surfaces as a recoverable `'ai-transport'`
-     * editor error; unusable output surfaces as `'ai-result'`.
-     *
-     * @param request Structured transform or autocomplete request.
-     * @returns Async iterable of Markdown/text chunks in document order.
-     */
-    stream(request: MlvEditorAiRequest): AsyncIterable<string>;
-}