autumnnote 1.7.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autumnnote",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "WYSIWYG rich-text editor built with vanilla JavaScript — zero dependencies, no jQuery. Dark mode, @mention, markdown shortcuts, bubble toolbar. React and Vue 3 wrappers included.",
   "main": "dist/autumnnote.umd.js",
   "module": "dist/autumnnote.es.js",

package/src/js/Context.js

@@ -339,10 +339,13 @@ export class Context {
 
   /**
    * Returns the current HTML content of the editor.
+   * Zero-width spaces (U+200B) inserted by inline editing helpers are stripped
+   * from the output so they don't leak into the consumer's HTML.
    * @returns {string}
    */
   getHTML() {
-    return this.invoke('editor.getHTML');
+    const html = this.invoke('editor.getHTML');
+    return typeof html === 'string' ? html.replace(/​/g, '') : html;
   }
 
   /**
@@ -545,6 +548,28 @@ export class Context {
     }));
   }
 
+  /**
+   * Moves focus into the editable area.
+   */
+  focus() {
+    this.layoutInfo.editable.focus();
+  }
+
+  /**
+   * Removes focus from the editable area.
+   */
+  blur() {
+    this.layoutInfo.editable.blur();
+  }
+
+  /**
+   * Returns true when the editor is currently in fullscreen mode.
+   * @returns {boolean}
+   */
+  isFullscreen() {
+    return this.invoke('fullscreen.isActive') === true;
+  }
+
   /**
    * Sets whether the editor is disabled (readonly).
    * @param {boolean} disabled

package/src/js/i18n/de.js

@@ -325,4 +325,11 @@ export const de = {
     imageSize: (maxSize) =>
       `Die Bilddatei ist zu groß. Die maximal zulässige Größe beträgt ${maxSize} MB.`,
   },
+
+  autoSaveRestore: {
+    found:   'Entwurf gefunden. Wiederherstellen?',
+    foundAt: 'Entwurf vom {date}. Wiederherstellen?',
+    restore: 'Wiederherstellen',
+    discard: 'Verwerfen',
+  },
 };

package/src/js/i18n/en.js

@@ -153,6 +153,7 @@ export const en = {
     findPlaceholder:  'Find\u2026',
     searchAriaLabel:  'Search text',
     caseSensitive:    '\u00a0Case sensitive',
+    wholeWord:        'Whole Word',
     prevBtn:          '\u2190 Prev',
     nextBtn:          'Next \u2192',
     replacePlaceholder: 'Replace with\u2026',
@@ -164,6 +165,13 @@ export const en = {
     close:              '\u00d7',
   },
 
+  autoSaveRestore: {
+    found:   'Draft found. Restore?',
+    foundAt: 'Draft from {date}. Restore?',
+    restore: 'Restore',
+    discard: 'Discard',
+  },
+
   shortcutsDialog: {
     title:     'Keyboard Shortcuts',
     ariaLabel: 'Keyboard Shortcuts',

package/src/js/i18n/es.js

@@ -325,4 +325,11 @@ export const es = {
     imageSize: (maxSize) =>
       `El archivo de imagen es demasiado grande. El tamaño máximo permitido es ${maxSize} MB.`,
   },
+
+  autoSaveRestore: {
+    found:   'Borrador encontrado. ¿Restaurar?',
+    foundAt: 'Borrador del {date}. ¿Restaurar?',
+    restore: 'Restaurar',
+    discard: 'Descartar',
+  },
 };

package/src/js/i18n/fr.js

@@ -326,4 +326,11 @@ export const fr = {
     imageSize: (maxSize) =>
       `Le fichier image est trop volumineux. La taille maximale autorisée est de ${maxSize}\u00a0Mo.`,
   },
-};
+
+  autoSaveRestore: {
+    found:   'Brouillon trouvé. Restaurer ?',
+    foundAt: 'Brouillon du {date}. Restaurer ?',
+    restore: 'Restaurer',
+    discard: 'Ignorer',
+  },
+};

package/src/js/i18n/ja.js

@@ -326,4 +326,11 @@ export const ja = {
     imageSize: (maxSize) =>
       `画像ファイルが大きすぎます。最大許容サイズは ${maxSize} MB です。`,
   },
+
+  autoSaveRestore: {
+    found:   '下書きが見つかりました。復元しますか？',
+    foundAt: '{date} の下書きが見つかりました。復元しますか？',
+    restore: '復元',
+    discard: '破棄',
+  },
 };

package/src/js/i18n/ko.js

@@ -325,4 +325,11 @@ export const ko = {
     imageSize: (maxSize) =>
       `이미지 파일이 너무 큽니다. 최대 허용 크기는 ${maxSize} MB입니다.`,
   },
+
+  autoSaveRestore: {
+    found:   '초안을 찾았습니다. 복원하시겠습니까?',
+    foundAt: '{date}의 초안을 찾았습니다. 복원하시겠습니까?',
+    restore: '복원',
+    discard: '삭제',
+  },
 };

package/src/js/i18n/vi.js

@@ -328,4 +328,11 @@ export const vi = {
     imageSize: (maxSize) =>
       `Tệp hình ảnh quá lớn. Kích thước tối đa cho phép là ${maxSize} MB.`,
   },
+
+  autoSaveRestore: {
+    found:   'Tìm thấy bản nháp. Khôi phục?',
+    foundAt: 'Bản nháp từ {date}. Khôi phục?',
+    restore: 'Khôi phục',
+    discard: 'Bỏ qua',
+  },
 };

package/src/js/i18n/zh.js

@@ -326,4 +326,11 @@ export const zh = {
     imageSize: (maxSize) =>
       `图片文件过大。最大允许大小为 ${maxSize} MB。`,
   },
+
+  autoSaveRestore: {
+    found:   '找到草稿。是否恢复？',
+    foundAt: '发现 {date} 的草稿。是否恢复？',
+    restore: '恢复',
+    discard: '放弃',
+  },
 };

package/src/js/index.js

@@ -12,7 +12,7 @@
 // @ts-ignore
 import '../styles/autumnnote.scss';
 import { Context, _customModules, _globalPlugins } from './Context.js';
-import { registerButton } from './module/Buttons.js';
+import { registerButton, buttons } from './module/Buttons.js';
 import { defaultOptions } from './settings.js';
 
 // Snapshot of factory defaults taken at module-load time (before any setDefaults() calls)
@@ -140,8 +140,11 @@ const AutumnNote = {
    */
   registerButton(btnDef) { registerButton(btnDef); return this; },
 
+  /** All pre-built button definitions — accessible in every module format including UMD/CJS. */
+  buttons,
+
   /** Library version */
-  version: '1.7.0',
+  version: '1.8.0',
 };
 
 // ---------------------------------------------------------------------------

package/src/js/module/Buttons.js

@@ -348,3 +348,52 @@ export const defaultToolbar = [
   [hrBtn, linkBtn, imageBtn, videoBtn, tableBtn, emojiBtn, iconBtn],
   [removeFormatBtn, codeviewBtn, fullscreenBtn, findBtn, printBtn, shortcutsBtn],
 ];
+
+// ---------------------------------------------------------------------------
+// Buttons namespace — all pre-built button definitions in a single object.
+// Exposed as AutumnNote.buttons so UMD / CJS consumers can access them
+// without named imports: AutumnNote.buttons.boldBtn, etc.
+// ---------------------------------------------------------------------------
+
+export const buttons = {
+  boldBtn,
+  italicBtn,
+  underlineBtn,
+  strikeBtn,
+  superscriptBtn,
+  subscriptBtn,
+  alignLeftBtn,
+  alignCenterBtn,
+  alignRightBtn,
+  alignJustifyBtn,
+  ulBtn,
+  olBtn,
+  indentBtn,
+  outdentBtn,
+  undoBtn,
+  redoBtn,
+  hrBtn,
+  linkBtn,
+  imageBtn,
+  videoBtn,
+  emojiBtn,
+  iconBtn,
+  tableBtn,
+  fontSizeBtn,
+  removeFormatBtn,
+  directionBtn,
+  fontFamilyBtn,
+  paragraphStyleBtn,
+  lineHeightBtn,
+  codeviewBtn,
+  fullscreenBtn,
+  shortcutsBtn,
+  findBtn,
+  findReplaceBtn,
+  inlineCodeBtn,
+  checklistBtn,
+  printBtn,
+  foreColorBtn,
+  backColorBtn,
+  defaultToolbar,
+};

package/src/js/module/Clipboard.js

@@ -187,6 +187,18 @@ export class Clipboard {
     const forcePlain = this._forcePlain;
     this._forcePlain = false;
 
+    // Enforce maxPasteSize limit (default 5 MB)
+    const maxBytes = (this.options.maxPasteSize ?? 5) * 1024 * 1024;
+    if (maxBytes > 0) {
+      const text = clipboardData.getData('text/plain') || '';
+      const html = clipboardData.getData('text/html') || '';
+      const size = Math.max(text.length, html.length);
+      if (size > maxBytes) {
+        event.preventDefault();
+        return;
+      }
+    }
+
     // 1. Image file in clipboard (screenshot, copy-image-from-browser, etc.)
     if (clipboardData.items) {
       const imageItems = Array.from(clipboardData.items).filter(

package/src/js/module/FindReplace.js

@@ -31,6 +31,7 @@ export class FindReplace extends BaseDialog {
     this._currentIndex = -1;
     this._caseSensitive = false;
     this._useRegex = false;
+    this._wholeWord = false;
     /** @type {'find'|'replace'} */
     this._mode = 'find';
 
@@ -39,6 +40,7 @@ export class FindReplace extends BaseDialog {
     this._lastQuery = null;
     this._lastCaseSensitive = null;
     this._lastUseRegex = null;
+    this._lastWholeWord = null;
 
     this._focusTimer = null;
   }
@@ -179,6 +181,14 @@ export class FindReplace extends BaseDialog {
     });
     regexBtn.textContent = '.*';
 
+    const wholeWordBtn = createElement('button', {
+      type: 'button',
+      class: 'an-fr-icon-btn',
+      title: L.wholeWord,
+      'aria-label': L.wholeWord,
+    });
+    wholeWordBtn.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="7" width="18" height="10" rx="2"/><line x1="7" y1="21" x2="7" y2="17"/><line x1="17" y1="21" x2="17" y2="17"/></svg>`;
+
     const prevBtn = createElement('button', {
       type: 'button',
       class: 'an-fr-icon-btn',
@@ -198,7 +208,7 @@ export class FindReplace extends BaseDialog {
     const counter = createElement('span', { class: 'an-fr-counter' });
     this._counterEl = counter;
 
-    searchBar.append(findInput, caseCheckbox, caseBtn, regexBtn, prevBtn, nextBtn, counter);
+    searchBar.append(findInput, caseCheckbox, caseBtn, regexBtn, wholeWordBtn, prevBtn, nextBtn, counter);
     box.appendChild(searchBar);
 
     // ---- Replace row: [input] [Replace] [All]  (hidden by default) ----
@@ -266,7 +276,14 @@ export class FindReplace extends BaseDialog {
       this._lastQuery = null;
       this._onSearch();
     });
-    this._disposers.push(d1, d2, d3, d4, d5, d6, d7, d8, d9, d10, d11, dRegex);
+    const dWholeWord = on(wholeWordBtn, 'click', () => {
+      this._wholeWord = !this._wholeWord;
+      wholeWordBtn.classList.toggle('an-fr-icon-btn--active', this._wholeWord);
+      this._queryRegex = null;
+      this._lastQuery = null;
+      this._onSearch();
+    });
+    this._disposers.push(d1, d2, d3, d4, d5, d6, d7, d8, d9, d10, d11, dRegex, dWholeWord);
 
     return overlay;
   }
@@ -341,13 +358,14 @@ export class FindReplace extends BaseDialog {
    */
   _findRawMatches(query, root) {
     const results = [];
-    // Reuse compiled regex when query, case-sensitivity, and regex mode haven't changed
-    if (this._lastQuery !== query || this._lastCaseSensitive !== this._caseSensitive || this._lastUseRegex !== this._useRegex) {
+    // Reuse compiled regex when query, case-sensitivity, regex mode, and whole-word haven't changed
+    if (this._lastQuery !== query || this._lastCaseSensitive !== this._caseSensitive || this._lastUseRegex !== this._useRegex || this._lastWholeWord !== this._wholeWord) {
       const flags = this._caseSensitive ? 'g' : 'gi';
       try {
-        const pattern = this._useRegex
+        let pattern = this._useRegex
           ? query
           : query.replace(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+        if (this._wholeWord) pattern = `\\b${pattern}\\b`;
         this._queryRegex = new RegExp(pattern, flags);
       } catch (_) {
         this._queryRegex = null;
@@ -355,6 +373,7 @@ export class FindReplace extends BaseDialog {
       this._lastQuery = query;
       this._lastCaseSensitive = this._caseSensitive;
       this._lastUseRegex = this._useRegex;
+      this._lastWholeWord = this._wholeWord;
     }
     if (!this._queryRegex) return results;
     const re = this._queryRegex;

package/src/js/module/ImageResizer.js

@@ -204,6 +204,7 @@ export class ImageResizer {
     const isCorner = pos.length === 2; // 'nw','ne','se','sw'
 
     const editable = this.context.layoutInfo.editable;
+    const minSz = this.context.options?.minImageSize ?? 20;
     let _raf = null; // rAF handle — ensures at most one write per paint frame
 
     const onMove = (me) => {
@@ -218,19 +219,19 @@ export class ImageResizer {
         let newW = startW;
         let newH = startH;
 
-        if (pos.includes('e')) newW = Math.max(20, startW + dx);
-        if (pos.includes('w')) newW = Math.max(20, startW - dx);
-        if (pos.includes('s')) newH = Math.max(20, startH + dy);
-        if (pos.includes('n')) newH = Math.max(20, startH - dy);
+        if (pos.includes('e')) newW = Math.max(minSz, startW + dx);
+        if (pos.includes('w')) newW = Math.max(minSz, startW - dx);
+        if (pos.includes('s')) newH = Math.max(minSz, startH + dy);
+        if (pos.includes('n')) newH = Math.max(minSz, startH - dy);
 
         newW = Math.min(newW, maxW);
 
         if (isCorner) {
           if (Math.abs(dx) >= Math.abs(dy)) {
-            newH = Math.max(20, Math.round(newW / aspectRatio));
+            newH = Math.max(minSz, Math.round(newW / aspectRatio));
           } else {
-            newW = Math.min(Math.max(20, Math.round(newH * aspectRatio)), maxW);
-            newH = Math.max(20, Math.round(newW / aspectRatio));
+            newW = Math.min(Math.max(minSz, Math.round(newH * aspectRatio)), maxW);
+            newH = Math.max(minSz, Math.round(newW / aspectRatio));
           }
         }
 

package/src/js/module/Mention.js

@@ -279,7 +279,10 @@ export class Mention {
       };
       const result = this._cfg.onSearch(this._query, cb);
       if (result && typeof result.then === 'function') {
-        result.then(cb).catch(() => this._hideDropdown());
+        result.then(cb).catch((err) => {
+          this._hideDropdown();
+          if (typeof this._cfg.onError === 'function') this._cfg.onError(err);
+        });
       }
     }, this._cfg.debounce);
   }

package/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * AutumnNote – TypeScript declarations
- * @version 1.7.0
+ * @version 1.8.0
  */
 
 // ---------------------------------------------------------------------------
@@ -119,6 +119,10 @@ export interface AsnOptions {
   autoSaveRestoreTimeout?: number;
   /** Callback fired after the user chooses to restore a draft. */
   onAutoSaveRestore?: (html: string, context: Context) => void;
+  /** Maximum paste size in MB before paste is silently dropped (0 = unlimited). Default: 5. */
+  maxPasteSize?: number;
+  /** Minimum image dimension in px during resize (width and height). Default: 20. */
+  minImageSize?: number;
 
   // ---- Markdown input shortcuts (#3) ----------------------------------------
 
@@ -165,6 +169,8 @@ export interface MentionOptions {
    * - Promise:  `async onSearch(query) { return items; }`
    */
   onSearch: (query: string, callback: (items: MentionItem[]) => void) => void | Promise<MentionItem[]>;
+  /** Called when onSearch rejects with an error (Promise style only). */
+  onError?: (error: unknown) => void;
   /** Optional. Return custom HTML string for the inserted chip, or null to use the default. */
   onInsert?: (item: MentionItem) => string | null;
   /** CSS class added to the inserted mention chip. Default: 'an-mention'. */
@@ -309,6 +315,12 @@ export interface AsnLocale {
     imageFormat: (type: string) => string;
     imageSize: (maxMb: number) => string;
   };
+  autoSaveRestore: {
+    found: string;
+    foundAt: string;
+    restore: string;
+    discard: string;
+  };
 }
 
 /** Registry of all built-in locales (keys: 'en', 'vi', 'ja', 'zh', 'fr'). */
@@ -423,6 +435,18 @@ export declare class Context {
   /** Downloads the editor content as a Markdown file. */
   downloadMarkdown(filename?: string): void;
 
+  /** Moves keyboard focus into the editable area. */
+  focus(): void;
+
+  /** Removes keyboard focus from the editable area. */
+  blur(): void;
+
+  /** Returns true when the editor is currently in fullscreen mode. */
+  isFullscreen(): boolean;
+
+  /** Opens a print dialog with the editor content. */
+  print(title?: string): void;
+
   /** Enables or disables (read-only) mode on this instance. */
   setDisabled(disabled: boolean): void;
 
@@ -494,6 +518,56 @@ export declare const foreColorBtn: ColorPickerDef;
 export declare const backColorBtn: ColorPickerDef;
 export declare const defaultToolbar: Array<Array<ToolbarItemDef>>;
 
+/**
+ * All pre-built button definitions grouped in a single namespace object.
+ * Use this to access individual buttons in UMD / CJS environments where
+ * named imports are not available: `AutumnNote.buttons.boldBtn`.
+ */
+export interface ButtonsNamespace {
+  boldBtn: ButtonDef;
+  italicBtn: ButtonDef;
+  underlineBtn: ButtonDef;
+  strikeBtn: ButtonDef;
+  superscriptBtn: ButtonDef;
+  subscriptBtn: ButtonDef;
+  alignLeftBtn: ButtonDef;
+  alignCenterBtn: ButtonDef;
+  alignRightBtn: ButtonDef;
+  alignJustifyBtn: ButtonDef;
+  ulBtn: ButtonDef;
+  olBtn: ButtonDef;
+  indentBtn: ButtonDef;
+  outdentBtn: ButtonDef;
+  undoBtn: ButtonDef;
+  redoBtn: ButtonDef;
+  hrBtn: ButtonDef;
+  linkBtn: ButtonDef;
+  imageBtn: ButtonDef;
+  videoBtn: ButtonDef;
+  emojiBtn: ButtonDef;
+  iconBtn: ButtonDef;
+  tableBtn: GridButtonDef;
+  fontSizeBtn: DropdownDef;
+  removeFormatBtn: ButtonDef;
+  directionBtn: ButtonDef;
+  fontFamilyBtn: DropdownDef;
+  paragraphStyleBtn: DropdownDef;
+  lineHeightBtn: DropdownDef;
+  codeviewBtn: ButtonDef;
+  fullscreenBtn: ButtonDef;
+  shortcutsBtn: ButtonDef;
+  findBtn: ButtonDef;
+  findReplaceBtn: ButtonDef;
+  inlineCodeBtn: ButtonDef;
+  checklistBtn: ButtonDef;
+  printBtn: ButtonDef;
+  foreColorBtn: ColorPickerDef;
+  backColorBtn: ColorPickerDef;
+  defaultToolbar: Array<Array<ToolbarItemDef>>;
+}
+
+export declare const buttons: ButtonsNamespace;
+
 // ---------------------------------------------------------------------------
 // Main AutumnNote API
 // ---------------------------------------------------------------------------
@@ -543,6 +617,13 @@ export interface AutumnNoteStatic {
    */
   registerButton(btnDef: ToolbarItemDef): this;
 
+  /**
+   * All pre-built button definitions in a single namespace.
+   * Use in UMD / CJS builds where named imports are unavailable:
+   * `AutumnNote.buttons.boldBtn`, `AutumnNote.buttons.defaultToolbar`, etc.
+   */
+  readonly buttons: ButtonsNamespace;
+
   /** Library version string. */
   readonly version: string;
 }