autumnnote 1.7.0 → 1.8.1

package/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * AutumnNote – TypeScript declarations
- * @version 1.7.0
+ * @version 1.8.0
  */
 
 // ---------------------------------------------------------------------------
@@ -106,7 +106,7 @@ export interface AsnOptions {
   colorSwatches?: string[];
   /**
    * Display language for the editor UI.
-   * Built-in: 'en' (default) | 'vi' | 'ja' | 'zh' | 'fr'.
+   * Built-in: 'en' (default) | 'vi' | 'ja' | 'zh' | 'fr' | 'de' | 'es' | 'ko'.
    * Pass a partial locale object to override individual strings.
    */
   lang?: string | Partial<AsnLocale>;
@@ -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,9 +315,15 @@ 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'). */
+/** Registry of all built-in locales (keys: 'en', 'vi', 'ja', 'zh', 'fr', 'de', 'es', 'ko'). */
 export declare const locales: Record<string, AsnLocale>;
 
 /**
@@ -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;
 }