@malva-ui/editor 0.1.14 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malva-ui/editor",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "description": "SSR-safe Angular rich-text editor for Malva UI — a Tiptap shell with HTML/Markdown/JSON values, image uploads and block reordering.",
   "license": "MIT",
   "keywords": [
@@ -31,21 +31,23 @@
     "@angular/core": "^22.0.0",
     "@angular/forms": "^22.0.0",
     "@lucide/angular": "^1.25.0",
-    "@malva-ui/cdk": "0.1.14",
-    "@malva-ui/core": "0.1.14",
-    "@malva-ui/i18n": "0.1.14",
-    "@tiptap/core": "^3.29.0",
-    "@tiptap/extension-file-handler": "^3.29.0",
-    "@tiptap/extension-highlight": "^3.29.0",
-    "@tiptap/extension-image": "^3.29.0",
-    "@tiptap/extension-list": "^3.29.0",
-    "@tiptap/extension-table": "^3.29.0",
-    "@tiptap/extension-text-align": "^3.29.0",
-    "@tiptap/extension-text-style": "^3.29.0",
-    "@tiptap/extensions": "^3.29.0",
-    "@tiptap/markdown": "^3.29.0",
-    "@tiptap/pm": "^3.29.0",
-    "@tiptap/starter-kit": "^3.29.0",
+    "@malva-ui/cdk": "0.2.0",
+    "@malva-ui/core": "0.2.0",
+    "@malva-ui/i18n": "0.2.0",
+    "@tiptap/core": "^3.31.0",
+    "@tiptap/extension-file-handler": "^3.31.0",
+    "@tiptap/extension-highlight": "^3.31.0",
+    "@tiptap/extension-image": "^3.31.0",
+    "@tiptap/extension-list": "^3.31.0",
+    "@tiptap/extension-table": "^3.31.0",
+    "@tiptap/extension-text-align": "^3.31.0",
+    "@tiptap/extension-text-style": "^3.31.0",
+    "@tiptap/extensions": "^3.31.0",
+    "@tiptap/markdown": "^3.31.0",
+    "@tiptap/pm": "^3.31.0",
+    "@tiptap/starter-kit": "^3.31.0",
+    "prosemirror-model": "^1.25.12",
+    "prosemirror-view": "^1.42.5",
     "rxjs": "~7.8.0"
   },
   "sideEffects": false,

package/types/malva-ui-editor.d.ts

@@ -33,6 +33,25 @@ type MlvEditorFormat = 'html' | 'markdown' | 'json';
  * reserved at every value, so block affordances never overlap text.
  */
 type MlvEditorContentWidth = 'default' | 'wide' | 'full';
+/**
+ * Where `mlv-editor` places its toolbar relative to the content viewport.
+ *
+ * The DOM order follows the value, so the Tab order always matches the visual
+ * order: `'top'` renders toolbar → content and `'bottom'` renders content →
+ * toolbar. Both are block-axis positions and do not change in RTL.
+ */
+type MlvEditorToolbarPosition = 'top' | 'bottom';
+/**
+ * How `mlv-editor` draws its toolbar.
+ *
+ * `'bar'` is the docked full-width row with a hairline toward the content.
+ * `'floating'` is a selection bubble: an overlay hugging its controls, shown
+ * only while focus is in the editor, the selection is non-empty (Alt+F10
+ * summons it at the caret) and the editor is neither disabled nor `readonly`.
+ * It prefers above the selection and flips below at the window's or a capped
+ * viewport's edge. `toolbarPosition` and `toolbarSticky` do not apply to it.
+ */
+type MlvEditorToolbarAppearance = 'bar' | 'floating';
 /** Origin of an image file supplied to the editor. */
 type MlvEditorImageUploadSource = 'button' | 'paste' | 'drop';
 /** Decides whether an uploaded image URL is safe to insert into the editor. */
@@ -82,9 +101,24 @@ interface MlvEditorImageUploadContext {
 interface MlvEditorImageUploadResult {
     /** URL used in the inserted image node. */
     readonly src: string;
-    /** Optional alternative text for the image. */
+    /**
+     * Optional alternative text for the image.
+     *
+     * Returned by an uploader, it is a **fallback**: alternative text the
+     * author supplied — typed in the upload dialog, or the empty alt of an
+     * image marked decorative — wins, because the author states what the image
+     * means and a file name rarely describes it (WCAG 1.1.1). Pasted and
+     * dropped images carry no author alt, so this value applies to them.
+     */
     readonly alt?: string;
-    /** Optional image title. */
+    /**
+     * Optional image title. Returned by an uploader, it is a fallback: a
+     * non-empty title the author typed in the upload dialog wins. An image the
+     * author marked decorative gets no title at all — an `alt=""` image with a
+     * title is exposed as an unnamed image described by it (WCAG H67). An
+     * uploader's own `alt: ''` is inserted as returned, title included — return
+     * no `title` for an image you mean to be decorative (WCAG H67).
+     */
     readonly title?: string;
     /** Optional rendered image width. */
     readonly width?: number;
@@ -148,7 +182,15 @@ declare abstract class MlvEditorImageUploadControl {
     abstract readonly options: Signal<MlvEditorImageUploadOptions>;
     /** Active and retryable uploads owned by this editor. */
     abstract readonly pending: Signal<readonly MlvEditorPendingUpload[]>;
-    /** Starts validated uploads in the owning editor. */
+    /**
+     * Starts validated uploads in the owning editor.
+     *
+     * `metadata.alt` and `metadata.title` are the author's and win over the
+     * uploader's result. Omit `alt` when the author supplied none — `''` marks
+     * the image decorative, keeps it empty and drops every title, the
+     * author's and the uploader's; otherwise an empty `title` lets the
+     * uploader's apply.
+     */
     abstract start(files: readonly File[], source: MlvEditorImageUploadSource, metadata?: {
         readonly position?: number;
         readonly alt?: string;
@@ -167,7 +209,10 @@ interface MlvEditorImageUploadSuccess {
     readonly file: File;
     /** Origin of the image file. */
     readonly source: MlvEditorImageUploadSource;
-    /** Metadata returned by the image uploader. */
+    /**
+     * Metadata inserted into the document: the uploader's validated result
+     * with the author's alt and title applied over the uploader's.
+     */
     readonly result: MlvEditorImageUploadResult;
 }
 /** Details emitted when an image upload fails. */
@@ -504,7 +549,7 @@ declare class MlvEditorAiContext {
      */
     private _serializeDocument;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvEditorAiContext, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MlvEditorAiContext>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 /** Injects the AI command state belonging to the nearest `mlv-editor`. */
 declare const MLV_EDITOR_AI_CONTEXT: InjectionToken<MlvEditorAiContext>;
@@ -920,6 +965,8 @@ declare function mlvEditorAiDefaultActions(copy: MlvEditorI18n | null | undefine
  * resolves no provider (presence), and its actions disable — without hiding —
  * while the editor is readonly or disabled or a transform is already running
  * (executability), matching the toolbar's presence-vs-executability rule.
+ * Projected into `mlv-editor`'s toolbar it is not rendered at all while the
+ * editor is `readonly`, which renders no toolbar (#498).
  */
 declare class MlvEditorAiMenu {
     /**
@@ -1464,6 +1511,82 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     readonly format: _angular_core.InputSignal<MlvEditorFormat>;
     /** Width of the centred content column; a gutter is reserved at every value. */
     readonly contentWidth: _angular_core.InputSignal<MlvEditorContentWidth>;
+    /**
+     * Fixed block size of the editor surface (toolbar plus content viewport).
+     * A number is px; a string is any CSS length, passed through verbatim.
+     *
+     * Setting it **caps** the editor: `.mlv-editor__viewport` becomes the only
+     * scroll container. With neither `height` nor `maxHeight`, the editor grows
+     * with its content, never shows a scrollbar, and never stops a scroll meant
+     * for the page. Writing `--mlv-editor-height` in CSS alone does not cap.
+     */
+    readonly height: _angular_core.InputSignal<string | number | undefined>;
+    /**
+     * Minimum block size of the editable content area; the viewport adds its
+     * 1rem padding around it. A number is px; a string is any CSS length. `undefined` keeps the `8rem` floor. Setting only this input
+     * leaves the editor in auto mode. `--mlv-editor-min-height` may also be set
+     * in CSS.
+     *
+     * Under a cap (`height` / `maxHeight`) the cap wins, even over a larger
+     * `minHeight`: the viewport shrinks to fit the surface, and the floor moves
+     * to the content inside the scroller, at every zoom level. A `minHeight`
+     * above what the cap leaves the content (the cap minus the toolbar band and
+     * the viewport padding) scrolls an empty document; for a fixed size set
+     * `height` rather than `minHeight` equal to `maxHeight`.
+     */
+    readonly minHeight: _angular_core.InputSignal<string | number | undefined>;
+    /**
+     * Largest block size of the editor surface. The surface grows with its
+     * content up to this cap, and then the viewport scrolls. A number is px; a
+     * string is any CSS length. Like `height`, this caps the editor; writing
+     * `--mlv-editor-max-height` in CSS alone does not.
+     */
+    readonly maxHeight: _angular_core.InputSignal<string | number | undefined>;
+    /**
+     * Docked-bar placement. The DOM order follows it, so the Tab order matches
+     * the visual order (WCAG 2.4.3). Changing it re-creates the toolbar view,
+     * which closes any open toolbar popup. It does not move the floating
+     * selection bubble, which always prefers above the selection. While
+     * `readonly` no bar renders in either position (see `toolbarAppearance`).
+     */
+    readonly toolbarPosition: _angular_core.InputSignal<MlvEditorToolbarPosition>;
+    /**
+     * Toolbar drawing: `'bar'` is the docked row with a hairline; `'floating'` is
+     * a selection bubble. The bubble is a CDK overlay (`.mlv-editor-bubble`)
+     * shown only while focus is in the editor, the selection is non-empty and
+     * the editor is neither disabled nor `readonly`; it prefers above the
+     * selection and flips below at the window's or a capped viewport's edge.
+     * Alt+F10 in the content summons it at the caret and focuses its first
+     * control (the content carries `aria-keyshortcuts="Alt+F10"` while floating
+     * and editable); Escape dismisses it and returns focus to the content with
+     * the selection intact. A plugin that claims Escape itself (a consumer's
+     * `@tiptap/suggestion` list, an AI stream) gets it first, and the Escape
+     * that dismisses the bubble goes no further, so a dialog or drawer around
+     * the editor closes only on the next one. Turning `readonly` on while the
+     * bubble is shown hides it and closes its popups.
+     *
+     * A `readonly` editor renders **no toolbar in either appearance** (#498):
+     * no `.mlv-editor__toolbar-band`, and no space kept for one. Turning
+     * `readonly` on tears the bar down, closes every popup the editor owns and
+     * returns focus from the bar or such a popup to the content, with the
+     * selection intact; turning it off stamps the bar again in its position.
+     * A consumer toolbar (`[mlvEditorToolbar]`, `[mlvEditorToolbarStart]`,
+     * `[mlvEditorToolbarEnd]`) is stamped in the same band and goes with it.
+     */
+    readonly toolbarAppearance: _angular_core.InputSignal<MlvEditorToolbarAppearance>;
+    /**
+     * Keeps the docked bar `position: sticky` against the page (or the nearest
+     * consumer scroll container) while the surface is on screen, offset by
+     * `--mlv-editor-toolbar-sticky-offset` (default `0`).
+     *
+     * It applies only to an **uncapped** **bar**. A capped editor
+     * (`height` / `maxHeight`) scrolls inside its own viewport, and the bar
+     * sits outside that scroller, so there is nothing for it to stick against;
+     * the floating bubble follows the selection instead; and a `readonly`
+     * editor renders no bar at all (#498). In each case the input is ignored
+     * and `.mlv-editor--toolbar-sticky` is not stamped.
+     */
+    readonly toolbarSticky: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /** Complete Tiptap extension replacement; omit it for Malva's fresh preset. */
     readonly extensions: _angular_core.InputSignal<Extensions | undefined>;
     /** Placeholder displayed by the default extension preset. */
@@ -1490,6 +1613,50 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     get imageUpload(): MlvEditorImageUploadControl;
     /** View-only zoom percentage shared with the nearest toolbar. */
     readonly zoom: _angular_core.WritableSignal<number>;
+    /** @protected Resolved `height`, written into `--mlv-editor-height`; `null` writes nothing. */
+    protected readonly _heightStyle: _angular_core.Signal<string | null>;
+    /** @protected Resolved `minHeight`, written into `--mlv-editor-min-height`; `null` writes nothing. */
+    protected readonly _minHeightStyle: _angular_core.Signal<string | null>;
+    /** @protected Resolved `maxHeight`, written into `--mlv-editor-max-height`; `null` writes nothing. */
+    protected readonly _maxHeightStyle: _angular_core.Signal<string | null>;
+    /**
+     * @protected Whether the editor is capped. Only `height` or `maxHeight`
+     * switches it on; `minHeight` alone stays in auto mode. It is the one input
+     * that turns `.mlv-editor__viewport` into a scroll container.
+     */
+    protected readonly _capped: _angular_core.Signal<boolean>;
+    /**
+     * @protected Whether the editor stamps its toolbar at all, in either
+     * appearance: never while `readonly` (#498 owner ruling, "a readonly editor
+     * renders no toolbar"). The docked bar is torn down and the selection
+     * bubble's pane stays empty; both come back when `readonly` turns off.
+     *
+     * This is the one switch, and it covers a consumer toolbar too: a complete
+     * `[mlvEditorToolbar]` replacement and the `[mlvEditorToolbarStart]` /
+     * `[mlvEditorToolbarEnd]` slots are stamped inside the same band. That is
+     * an assumption the owner may reverse. Keeping a complete replacement while
+     * `readonly` is `!this.readonly() || this._hasToolbarDef()` here for the
+     * bar, and the default groups inside the band then need their own readonly
+     * hiding; `_closeBarForReadonly()`'s `_barRendered()` early return must
+     * then key on the removed region, not the band, or focus on a removed
+     * default control drops to `<body>`. The bubble also gates itself on
+     * `readonly` in `MlvEditorBubble._wanted()` / `_ownsContentKey()`, and
+     * `_editorAttributes()` drops `aria-keyshortcuts`.
+     */
+    protected readonly _toolbarRendered: _angular_core.Signal<boolean>;
+    /**
+     * @protected Whether the docked bar is stamped before or after the
+     * viewport: the `'bar'` appearance while `_toolbarRendered()`. With it
+     * false no band exists, so nothing reserves space for one and no sticky
+     * extent is measured.
+     */
+    protected readonly _barRendered: _angular_core.Signal<boolean>;
+    /**
+     * @protected Whether the docked bar is actually sticky: `toolbarSticky` on an
+     * uncapped bar that renders (not while `readonly`). Drives
+     * `.mlv-editor--toolbar-sticky` and the caret scroll margin.
+     */
+    protected readonly _stickyToolbar: _angular_core.Signal<boolean>;
     /** Whether the mounted editor currently accepts document mutations. */
     readonly editable: _angular_core.Signal<boolean>;
     /** Emits after the browser-only Tiptap editor has been created. */
@@ -1515,7 +1682,7 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     /** @private Browser-only mount element for Tiptap's ProseMirror DOM. */
     private readonly _content;
     /**
-     * @private Zoom-transformed layer the floating block handle is mounted into.
+     * @private Zoomed layer (CSS `zoom`) the floating block handle is mounted into.
      *
      * Deliberately optional rather than `viewChild.required`: the block-handle
      * `mount` capability is typed `() => HTMLElement | null`, and the extension
@@ -1524,6 +1691,11 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
      * uncaught error rather than the absent mount the contract already allows.
      */
     private readonly _view;
+    /**
+     * @private Toolbar band currently stamped before or after the viewport.
+     * Queried by declaration, so it follows the band across position changes.
+     */
+    private readonly _toolbarBand;
     /** @protected Complete projected toolbar replacement, if the consumer provides one. */
     protected readonly _toolbarDefs: _angular_core.Signal<readonly MlvEditorToolbarDef[]>;
     /** @protected Projected controls displayed before the built-in toolbar groups. */
@@ -1548,6 +1720,16 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     private readonly _uploadAbortRegistry;
     /** @private Physical host used to determine the composite focus boundary. */
     private readonly _host;
+    /**
+     * @private Live ProseMirror `scrollMargin` (WCAG 2.2 SC 2.4.11). One stable
+     * object passed on every `editorProps` write; its sides re-measure per read.
+     * Read untracked: ProseMirror scrolls synchronously inside `updateState`,
+     * which can run within `_synchronizeEditor`'s effect, and that effect must
+     * not start depending on the toolbar inputs.
+     */
+    private readonly _scrollMargin;
+    /** @private Live ProseMirror `scrollThreshold`, paired with `_scrollMargin`. */
+    private readonly _scrollThreshold;
     /** @private Optional translated accessible defaults. */
     private readonly _i18n;
     /** @private Announces block moves politely; the editor content itself is not a live region. */
@@ -1574,13 +1756,7 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     private _blurCheckQueued;
     /** @private The last boundary event, retained until the microtask resolves focus ownership. */
     private _pendingBlurEvent;
-    /** @private Stable capture listener for focus entering the physical host. */
-    private readonly _onHostFocusIn;
-    /** @private Stable capture listener for focus leaving the physical host. */
-    private readonly _onHostFocusOut;
-    /** @private Stable capture listener that blocks disabled projected controls. */
-    private readonly _onDisabledPointerOrClick;
-    /** @private Stable capture listener that blocks disabled keyboard activation. */
+    /** @private Blocks disabled keyboard activation; the other three subscribe to their handler directly. */
     private readonly _onDisabledKeydown;
     /** @protected Fallback-accessible name when no visible label is supplied. */
     protected readonly _resolvedAriaLabel: _angular_core.Signal<string>;
@@ -1593,6 +1769,19 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     constructor();
     /** Creates the one Tiptap editor after Angular has rendered the mount element. */
     ngAfterViewInit(): void;
+    /**
+     * @protected Focuses the editable content when the control's own
+     * `<mlv-label>` is clicked.
+     *
+     * ProseMirror's contenteditable root is focusable but not HTML-labelable, so
+     * `<label for>` can never name it and the native click-to-focus a field
+     * label owes its control never ran — the visible label was inert (#216), the
+     * same gap the three date/time pickers close. `readonly` still focuses (a
+     * read-only `<textarea>` does), `disabled` returns early (the host is
+     * `inert` anyway), and Tiptap's `focus` command restores the stored
+     * selection rather than dropping the caret at the document start.
+     */
+    protected _onLabelClick(): void;
     /** Clears the document through Tiptap when the shared form wrapper is clearable. */
     clearValue(): void;
     /** @private Formats a completed block move and announces it politely. */
@@ -1656,6 +1845,24 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     private _supportsMarkdown;
     /** @private Emits the stable unsupported-Markdown error without throwing through Angular. */
     private _emitUnsupportedMarkdownError;
+    /**
+     * @private Block extent the toolbar hides on its own side, in px.
+     *
+     * Only a sticky bar hides anything: its height plus its offset, at its
+     * nearest scroll container. A docked bar sits outside the content, and the
+     * floating bubble is an overlay that follows the selection, clear of it by
+     * construction.
+     * Sticky applies only to an uncapped bar (`_stickyToolbar`), so the margin
+     * never lands on a capped viewport's own edge.
+     *
+     * Read by ProseMirror at scroll time, never for layout. ProseMirror applies
+     * one margin at every scroll ancestor. For an uncapped editor the page is
+     * usually the only one. With a consumer scroll container in between, the
+     * band sticks to that container, where the margin is right; the page, one
+     * scroll ancestor further out, also keeps the caret that far from its edge
+     * although no band is there, which errs toward visibility.
+     */
+    private _obscuredToolbarExtent;
     /** @private Builds the exact accessible attributes assigned to Tiptap's contenteditable root. */
     private _editorAttributes;
     /** @internal Capture handler for focus entering the host or an owned overlay root. */
@@ -1666,7 +1873,22 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     private _isFocusInsideComposite;
     /** @private Whether a node belongs to the physical shell or an owned overlay. */
     private _isOwnedFocusNode;
-    /** @private Installs native capture listeners because overlay focus is outside Angular's view tree. */
+    /**
+     * @private Subscribes the composite's host listeners, because overlay focus
+     * happens outside Angular's view tree.
+     *
+     * Every one is registered in the **capture** phase, which is load-bearing
+     * rather than incidental: ProseMirror binds its own handlers to `view.dom`,
+     * a descendant of this host, so only a capture-phase listener on the host
+     * runs ahead of them. The disabled handlers depend on that to call
+     * `stopImmediatePropagation()` while the event is still travelling down —
+     * from the bubble phase ProseMirror would already have acted on it. Capture
+     * is carried through `fromEvent`'s third argument, and `editor-focus.spec.ts`
+     * pins the ordering against descendant listeners.
+     *
+     * Called from `ngAfterViewInit`, which is not an injection context, so
+     * `takeUntilDestroyed` is given the ref explicitly.
+     */
     private _bindCompositeFocusEvents;
     /** @private Stops all pointer/click/activation-key command surfaces while disabled. */
     private _blockDisabledInteraction;
@@ -1674,12 +1896,25 @@ declare class MlvEditor extends MlvSignalFormControlBase<string | null> implemen
     private _removeCompositeFocusForDisabledState;
     /** @private Keeps the real ProseMirror root in sync with dynamic ARIA/tabindex state. */
     private _synchronizeContentSurfaceState;
+    /**
+     * @private `readonly` just turned on over a docked bar, which this render
+     * tears down (#498). Every popup the editor owns closes, and focus in the
+     * band or in such a popup returns to the content first, through the same
+     * registry call the selection bubble makes. Called from the constructor
+     * effect, which is registered on the parent view, so it runs before this
+     * component's template (and the wrapper-stamped band `@if`) refreshes: the
+     * band and its focus are still there. A disabled editor is left alone, like
+     * the bubble's own focus return: it takes no focus, even from a projected
+     * consumer control, which the editor does not disable and which can hold
+     * focus in the band of a disabled editor.
+     */
+    private _closeBarForReadonly;
     /** @private Aborts registered upload work while preserving the document/editor instance. */
     private _abortInFlightUploads;
     /** @private Destroys the owned Tiptap editor exactly once. */
     private _destroyEditor;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvEditor, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvEditor, "mlv-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "contentWidth": { "alias": "contentWidth"; "required": false; "isSignal": true; }; "extensions": { "alias": "extensions"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "characterLimit": { "alias": "characterLimit"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "imageUploader": { "alias": "imageUploader"; "required": false; "isSignal": true; }; "imageUploadOptions": { "alias": "imageUploadOptions"; "required": false; "isSignal": true; }; "aiProvider": { "alias": "aiProvider"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "editorReady": "editorReady"; "focus": "focus"; "blur": "blur"; "selectionChange": "selectionChange"; "transaction": "transaction"; "editorError": "editorError"; "imageUploadSuccess": "imageUploadSuccess"; "imageUploadFailure": "imageUploadFailure"; "imageUploadCancelled": "imageUploadCancelled"; }, ["_toolbarDefs", "_toolbarStartDefs", "_toolbarEndDefs"], ["[mlvEditorToolbar]", "[mlvEditorToolbarStart]", "[mlvEditorToolbarEnd]", "[mlvEditorStatus]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvEditor, "mlv-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "contentWidth": { "alias": "contentWidth"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "toolbarPosition": { "alias": "toolbarPosition"; "required": false; "isSignal": true; }; "toolbarAppearance": { "alias": "toolbarAppearance"; "required": false; "isSignal": true; }; "toolbarSticky": { "alias": "toolbarSticky"; "required": false; "isSignal": true; }; "extensions": { "alias": "extensions"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "characterLimit": { "alias": "characterLimit"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "imageUploader": { "alias": "imageUploader"; "required": false; "isSignal": true; }; "imageUploadOptions": { "alias": "imageUploadOptions"; "required": false; "isSignal": true; }; "aiProvider": { "alias": "aiProvider"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "editorReady": "editorReady"; "focus": "focus"; "blur": "blur"; "selectionChange": "selectionChange"; "transaction": "transaction"; "editorError": "editorError"; "imageUploadSuccess": "imageUploadSuccess"; "imageUploadFailure": "imageUploadFailure"; "imageUploadCancelled": "imageUploadCancelled"; }, ["_toolbarDefs", "_toolbarStartDefs", "_toolbarEndDefs"], ["[mlvEditorToolbar]", "[mlvEditorToolbarStart]", "[mlvEditorToolbarEnd]", "[mlvEditorStatus]"], true, never>;
 }
 
 /** A completed block move, reported so the host can announce it. */
@@ -1702,7 +1937,7 @@ interface MlvEditorBlockMove {
 interface MlvEditorBlockHandleOptions {
     /**
      * Container the floating handle is appended to. Must be the layer carrying the
-     * editor zoom transform so the handle shares its coordinate space.
+     * editor zoom (CSS `zoom`) so the handle shares its coordinate space.
      */
     readonly mount: () => HTMLElement | null;
     /** Accessible label for the handle, read live so locale changes apply. */
@@ -2439,6 +2674,18 @@ declare class MlvEditorTable {
     protected readonly _context: _malva_ui_editor.MlvEditorToolbarContext;
     /** @private Normalizes horizontal grid movement for RTL. */
     private readonly _rtlService;
+    /**
+     * @private Host element; the scope horizontal arrow keys resolve their
+     * direction against. The grid renders in a popup pane portaled out of this
+     * subtree, so the handler speaks for the host, never for `event.target`.
+     */
+    private readonly _elementRef;
+    /**
+     * @private Direction applying to this control, resolved once and cached
+     * behind the shared `dir` observer rather than re-walked on every arrow
+     * keypress.
+     */
+    private readonly _direction;
     /** @private Transaction and selection invalidation bridge. */
     private readonly _revision;
     /** @private Detached popup ownership for composite editor focus. */
@@ -2992,4 +3239,4 @@ declare class MlvEditorTextColor extends MlvEditorColorControl {
 }
 
 export { MLV_EDITOR_AI_CARET_CLASS, MLV_EDITOR_AI_CONTEXT, MLV_EDITOR_AI_PROVIDER, MLV_EDITOR_AI_STREAMING_CHUNK_CLASS, MLV_EDITOR_AI_STREAMING_CLASS, MLV_EDITOR_AI_SUGGESTION_CURRENT_CLASS, MLV_EDITOR_AI_SUGGESTION_DELETE_CLASS, MLV_EDITOR_AI_SUGGESTION_INSERT_CLASS, MLV_EDITOR_DEFAULT_IMAGE_UPLOAD_OPTIONS, MLV_EDITOR_IMAGE_UPLOADER, MLV_EDITOR_TOOLBAR_CONTEXT, MlvEditor, MlvEditorAiContext, MlvEditorAiMenu, MlvEditorAiReviewBar, MlvEditorAlignment, MlvEditorBlockHandle, MlvEditorBlockInsert, MlvEditorFileHandler, MlvEditorHeading, MlvEditorHighlight, MlvEditorImageUpload, MlvEditorImageUploadControl, MlvEditorInlineMarks, MlvEditorLink, MlvEditorList, MlvEditorStatus, MlvEditorTable, MlvEditorTableControls, MlvEditorTextColor, MlvEditorToolbar, MlvEditorToolbarDef, MlvEditorToolbarEndDef, MlvEditorToolbarStartDef, MlvEditorToolbarWidget, MlvEditorUndoRedo, MlvEditorUploadPlaceholder, MlvEditorZoom, applyMlvEditorAiSuggestions, countMlvEditorWords, mlvEditorAiDefaultActions, mlvEditorAiReplaceRange, mlvEditorBlockHandleExtensions, mlvEditorDefaultExtensions, mlvEditorDefaultImageUrlPolicy, mlvEditorFormattingExtensions, mlvEditorImageExtensions, mlvEditorListExtensions, mlvEditorMarkdownExtensions, mlvEditorTableExtensions, mlvEditorTableGeometry, mlvEditorUtilityExtensions, normalizeMlvEditorCharacterLimit, runMlvEditorAiStream };
-export type { MlvEditorAiAction, MlvEditorAiBuiltInTransformKind, MlvEditorAiFrameScheduler, MlvEditorAiOutputMode, MlvEditorAiProvider, MlvEditorAiRequest, MlvEditorAiReviewSuggestion, MlvEditorAiStatus, MlvEditorAiStreamErrorCode, MlvEditorAiStreamHandle, MlvEditorAiStreamOptions, MlvEditorAiStreamOutputMode, MlvEditorAiStreamResult, MlvEditorAiStreamStatus, MlvEditorAiSuggestion, MlvEditorAiSuggestionKind, MlvEditorAiSuggestionRange, MlvEditorAiSuggestionsOptions, MlvEditorAiSuggestionsSession, MlvEditorAiTransformKind, MlvEditorAiTransformOptions, MlvEditorBlockHandleOptions, MlvEditorBlockMove, MlvEditorContentWidth, MlvEditorDefaultExtensionOptions, MlvEditorError, MlvEditorErrorCode, MlvEditorFileHandlerEvent, MlvEditorFocusEvent, MlvEditorFormat, MlvEditorFormattingExtensionOptions, MlvEditorHeadingLevel, MlvEditorImageExtensionOptions, MlvEditorImageUploadCancelled, MlvEditorImageUploadContext, MlvEditorImageUploadFailure, MlvEditorImageUploadOptions, MlvEditorImageUploadResult, MlvEditorImageUploadSource, MlvEditorImageUploadSuccess, MlvEditorImageUploader, MlvEditorImageUrlPolicy, MlvEditorInsertUploadPlaceholderOptions, MlvEditorListExtensionOptions, MlvEditorMarkdownExtensionOptions, MlvEditorPendingUpload, MlvEditorRemoveUploadPlaceholderOptions, MlvEditorReplaceUploadPlaceholderOptions, MlvEditorSelectionChange, MlvEditorTableBox, MlvEditorTableExtensionOptions, MlvEditorTableGeometry, MlvEditorTableGeometryInput, MlvEditorToolbarContext, MlvEditorTransactionEvent, MlvEditorUpdateUploadPlaceholderOptions, MlvEditorUploadPlaceholderItem, MlvEditorUploadPlaceholderStorage, MlvEditorUtilityExtensionOptions };
+export type { MlvEditorAiAction, MlvEditorAiBuiltInTransformKind, MlvEditorAiFrameScheduler, MlvEditorAiOutputMode, MlvEditorAiProvider, MlvEditorAiRequest, MlvEditorAiReviewSuggestion, MlvEditorAiStatus, MlvEditorAiStreamErrorCode, MlvEditorAiStreamHandle, MlvEditorAiStreamOptions, MlvEditorAiStreamOutputMode, MlvEditorAiStreamResult, MlvEditorAiStreamStatus, MlvEditorAiSuggestion, MlvEditorAiSuggestionKind, MlvEditorAiSuggestionRange, MlvEditorAiSuggestionsOptions, MlvEditorAiSuggestionsSession, MlvEditorAiTransformKind, MlvEditorAiTransformOptions, MlvEditorBlockHandleOptions, MlvEditorBlockMove, MlvEditorContentWidth, MlvEditorDefaultExtensionOptions, MlvEditorError, MlvEditorErrorCode, MlvEditorFileHandlerEvent, MlvEditorFocusEvent, MlvEditorFormat, MlvEditorFormattingExtensionOptions, MlvEditorHeadingLevel, MlvEditorImageExtensionOptions, MlvEditorImageUploadCancelled, MlvEditorImageUploadContext, MlvEditorImageUploadFailure, MlvEditorImageUploadOptions, MlvEditorImageUploadResult, MlvEditorImageUploadSource, MlvEditorImageUploadSuccess, MlvEditorImageUploader, MlvEditorImageUrlPolicy, MlvEditorInsertUploadPlaceholderOptions, MlvEditorListExtensionOptions, MlvEditorMarkdownExtensionOptions, MlvEditorPendingUpload, MlvEditorRemoveUploadPlaceholderOptions, MlvEditorReplaceUploadPlaceholderOptions, MlvEditorSelectionChange, MlvEditorTableBox, MlvEditorTableExtensionOptions, MlvEditorTableGeometry, MlvEditorTableGeometryInput, MlvEditorToolbarAppearance, MlvEditorToolbarContext, MlvEditorToolbarPosition, MlvEditorTransactionEvent, MlvEditorUpdateUploadPlaceholderOptions, MlvEditorUploadPlaceholderItem, MlvEditorUploadPlaceholderStorage, MlvEditorUtilityExtensionOptions };