@mdaemon/html-editor 1.4.1 → 1.5.0

package/README.md

@@ -77,6 +77,7 @@ const editor = new HTMLEditor(container, {
 | `basicEditor` | boolean | false | Use simplified toolbar for notes/tasks |
 | `readonly` | boolean | false | Start the editor in read-only mode (see `setReadOnly`) |
 | `forced_root_block` | 'p' \| 'div' | 'p' | Block element produced on Enter. `'div'` gives CKEditor `ENTER_DIV` parity |
+| `trailingNode` | boolean | false | Append an empty trailing paragraph when the document ends in a block node (table, image, code block) so the cursor can be placed after it |
 | `includeTemplates` | boolean | false | Show template dropdown |
 | `templates` | Template[] | [] | Array of templates |
 | `dropbox` | boolean | false | Enable Dropbox integration |
@@ -265,7 +266,7 @@ All built-in toolbar button names that can be used in the `toolbar` config strin
 | `removeformat` | Clear all formatting |
 | `copy` | Copy selection |
 | `cut` | Cut selection |
-| `paste` | Paste from clipboard |
+| `paste` | Paste from clipboard (async Clipboard API; prefers HTML, falls back to plain text) |
 | `undo` | Undo last change |
 | `redo` | Redo last undo |
 | `image` | Insert image dialog (upload file or enter URL) |
@@ -357,6 +358,8 @@ The `link` toolbar button opens a modal dialog for inserting or editing hyperlin
 
 When editing an existing link, all fields are pre-populated from the current link attributes. Clearing the URL and saving removes the link. The dialog inherits the active skin theme. The separate `unlink` toolbar button removes the link at the cursor without opening the dialog.
 
+**URL normalization:** a URL entered without a scheme that looks like a bare domain (e.g. `www.example.com` or `example.com/path`) is saved with `http://` prepended, so it resolves as an external link instead of a broken relative path. URLs that already carry a scheme (`https:`, `mailto:`, `tel:`, `ftp:`, …), anchors (`#section`), absolute/relative paths (`/`, `./`, `../`), and protocol-relative URLs (`//host`) are left exactly as typed.
+
 ## Named Anchors
 
 The `anchor` toolbar button opens a dialog to insert a named anchor — an `<a id="name">` target for in-page linking. The anchor name is required and may not contain spaces. Existing anchors in loaded content (`<a id>` with no `href`) are preserved through the editor's parse/serialize cycle.

package/dist/index.d.ts

@@ -172,6 +172,7 @@ export declare interface EditorConfig {
      * 'p' (default) emits <p>; 'div' emits <div> (CKEditor ENTER_DIV parity).
      */
     forced_root_block?: 'p' | 'div';
+    trailingNode?: boolean;
     includeTemplates?: boolean;
     templates?: Template[];
     dropbox?: boolean;
@@ -448,6 +449,14 @@ export declare class LinkEditor {
     open(): void;
     close(): void;
     private populateFromSelection;
+    /**
+     * Ensure a user-entered URL is usable as an href. Domain-like input typed
+     * without a scheme (e.g. "www.example.com", "example.com/path") would
+     * otherwise resolve as a relative path and produce a broken link, so prepend
+     * a default protocol. Anchors (#...), relative/absolute paths, protocol-
+     * relative URLs (//host) and anything with an existing scheme are left alone.
+     */
+    private normalizeUrl;
     private save;
     private createDialog;
     destroy(): void;
@@ -697,6 +706,29 @@ export declare class Toolbar {
     private toggleOverflow;
     private createButton;
     private createActionButton;
+    /**
+     * Paste clipboard contents into the editor.
+     *
+     * `document.execCommand('paste')` is deprecated and blocked by every modern
+     * browser (a page is not allowed to silently read the clipboard), so we use
+     * the async Clipboard API instead. It prompts the user for clipboard-read
+     * permission on first use. We focus the editor *before* awaiting the read —
+     * the Clipboard API rejects with "Document is not focused" if the page has
+     * lost focus, and focusing first also restores the editor selection so the
+     * content lands where the cursor was. HTML is preferred when the clipboard
+     * provides it; otherwise we fall back to plain text.
+     *
+     * Note: some browsers (notably Firefox) block clipboard reads from web pages
+     * by default; in that case nothing can be pasted programmatically and the
+     * user must use Ctrl/Cmd+V, which the engine handles directly.
+     */
+    private pasteFromClipboard;
+    /**
+     * Reduce a raw `text/html` clipboard payload to the meaningful fragment:
+     * unwrap the `<html>/<body>` scaffolding browsers add and drop the
+     * `<!--StartFragment-->`/`<!--EndFragment-->` markers and leading `<meta>`.
+     */
+    private extractClipboardFragment;
     private createCustomButton;
     private createFontFamilyDropdown;
     private createFontSizeDropdown;