autumnnote 1.0.8 → 1.0.9

package/src/js/module/LinkTooltip.js

@@ -63,7 +63,8 @@ export class LinkTooltip {
   // ---------------------------------------------------------------------------
 
   _buildTooltip() {
-    const el = createElement('div', { class: 'an-link-tooltip', role: 'toolbar', 'aria-label': 'Link actions' });
+    const L = this.context.locale.tooltips.link;
+    const el = createElement('div', { class: 'an-link-tooltip', role: 'toolbar', 'aria-label': L.ariaLabel });
     el.style.display = 'none';
 
     // URL preview text (truncated)
@@ -74,10 +75,10 @@ export class LinkTooltip {
     el.appendChild(createElement('div', { class: 'an-link-tooltip-sep' }));
 
     // Action buttons
-    this._openBtn   = this._makeBtn(ICONS.open,   'Open link',   () => this._openLink());
-    this._copyBtn   = this._makeBtn(ICONS.copy,   'Copy URL',    () => this._copyLink());
-    this._editBtn   = this._makeBtn(ICONS.edit,   'Edit link',   () => this._editLink());
-    this._unlinkBtn = this._makeBtn(ICONS.unlink, 'Remove link', () => this._unlink());
+    this._openBtn   = this._makeBtn(ICONS.open,   L.openLink,   () => this._openLink());
+    this._copyBtn   = this._makeBtn(ICONS.copy,   L.copyUrl,    () => this._copyLink());
+    this._editBtn   = this._makeBtn(ICONS.edit,   L.editLink,   () => this._editLink());
+    this._unlinkBtn = this._makeBtn(ICONS.unlink, L.removeLink, () => this._unlink());
 
     el.appendChild(this._openBtn);
     el.appendChild(this._copyBtn);

package/src/js/module/ShortcutsDialog.js

@@ -93,7 +93,7 @@ export class ShortcutsDialog {
       class: 'an-dialog-overlay',
       role: 'dialog',
       'aria-modal': 'true',
-      'aria-label': 'Keyboard Shortcuts',
+      'aria-label': this.context.locale.shortcutsDialog.ariaLabel,
     });
 
     const box = createElement('div', { class: 'an-dialog-box an-shortcuts-box' });
@@ -101,18 +101,19 @@ export class ShortcutsDialog {
     // Title row with close button
     const titleRow = createElement('div', { class: 'an-icon-title-row' });
     const title = createElement('h3', { class: 'an-dialog-title' });
-    title.textContent = 'Keyboard Shortcuts';
+    title.textContent = this.context.locale.shortcutsDialog.title;
     const closeBtn = createElement('button', {
       type: 'button',
       class: 'an-icon-close',
-      'aria-label': 'Close',
+      'aria-label': this.context.locale.shortcutsDialog.close,
     });
     closeBtn.textContent = '×';
     this._closeBtn = closeBtn;
     titleRow.append(title, closeBtn);
     box.appendChild(titleRow);
 
-    SHORTCUTS.forEach(({ category, items }) => {
+    const shortcuts = this.context.locale.shortcutsDialog.shortcuts || SHORTCUTS;
+    shortcuts.forEach(({ category, items }) => {
       const catEl = createElement('div', { class: 'an-shortcuts-cat' });
       catEl.textContent = category;
       box.appendChild(catEl);

package/src/js/module/Statusbar.js

@@ -82,7 +82,7 @@ export class Statusbar {
     if (this.options.resizable !== false) {
       const handle = createElement('div', {
         class: 'an-resize-handle',
-        title: 'Resize editor',
+        title: this.context.locale.statusbar.resizeHandle,
         'aria-hidden': 'true',
       });
       this._bindResize(handle);
@@ -220,12 +220,13 @@ export class Statusbar {
     const maxWords = this.options.maxWords || 0;
     const maxChars = this.options.maxChars || 0;
 
+    const LS = this.context.locale.statusbar;
     this._wordCountEl.textContent = maxWords
-      ? `Words: ${words}/${maxWords}`
-      : `Words: ${words}`;
+      ? LS.wordsLimit(words, maxWords)
+      : LS.words(words);
     this._charCountEl.textContent = maxChars
-      ? `Chars: ${chars}/${maxChars}`
-      : `Chars: ${chars}`;
+      ? LS.charsLimit(chars, maxChars)
+      : LS.chars(chars);
 
     // Apply warning / exceeded styles
     _applyLimitClass(this._wordCountEl, words, maxWords);

package/src/js/module/TableTooltip.js

@@ -376,55 +376,56 @@ export class TableTooltip {
   // ---------------------------------------------------------------------------
 
   _buildTooltip() {
+    const L = this.context.locale.tooltips.table;
     const el = createElement('div', {
       class: 'an-link-tooltip an-table-tooltip',
       role: 'toolbar',
-      'aria-label': 'Table actions',
+      'aria-label': L.ariaLabel,
     });
     el.style.display = 'none';
 
     // Label
     this._label = createElement('span', { class: 'an-link-tooltip-url' });
-    this._label.textContent = 'Table';
+    this._label.textContent = L.label;
     el.appendChild(this._label);
 
     el.appendChild(this._sep());
 
     // Select-cells toggle
-    this._selectBtn = this._makeBtn(ICONS.selectCells, 'Select Cells', () => this._toggleSelectMode());
+    this._selectBtn = this._makeBtn(ICONS.selectCells, L.selectCells, () => this._toggleSelectMode());
     el.appendChild(this._selectBtn);
 
     el.appendChild(this._sep());
 
     // Row operations
-    el.appendChild(this._makeBtn(ICONS.rowAbove, 'Add Row Above', () => this._addRow('above')));
-    el.appendChild(this._makeBtn(ICONS.rowBelow, 'Add Row Below', () => this._addRow('below')));
-    el.appendChild(this._makeBtn(ICONS.deleteRow, 'Delete Row',   () => this._deleteRow()));
+    el.appendChild(this._makeBtn(ICONS.rowAbove, L.addRowAbove, () => this._addRow('above')));
+    el.appendChild(this._makeBtn(ICONS.rowBelow, L.addRowBelow, () => this._addRow('below')));
+    el.appendChild(this._makeBtn(ICONS.deleteRow, L.deleteRow,  () => this._deleteRow()));
 
     el.appendChild(this._sep());
 
     // Column operations
-    el.appendChild(this._makeBtn(ICONS.colLeft,   'Add Column Left',  () => this._addColumn('left')));
-    el.appendChild(this._makeBtn(ICONS.colRight,  'Add Column Right', () => this._addColumn('right')));
-    el.appendChild(this._makeBtn(ICONS.deleteCol, 'Delete Column',    () => this._deleteColumn()));
+    el.appendChild(this._makeBtn(ICONS.colLeft,   L.addColumnLeft,   () => this._addColumn('left')));
+    el.appendChild(this._makeBtn(ICONS.colRight,  L.addColumnRight,  () => this._addColumn('right')));
+    el.appendChild(this._makeBtn(ICONS.deleteCol, L.deleteColumn,    () => this._deleteColumn()));
 
     el.appendChild(this._sep());
 
     // Merge cells
-    el.appendChild(this._makeBtn(ICONS.mergeCells,   'Merge Cells',   () => this._mergeCells()));
-    el.appendChild(this._makeBtn(ICONS.unmergeCells, 'Unmerge Cells', () => this._unmergeCells()));
+    el.appendChild(this._makeBtn(ICONS.mergeCells,   L.mergeCells,   () => this._mergeCells()));
+    el.appendChild(this._makeBtn(ICONS.unmergeCells, L.unmergeCells, () => this._unmergeCells()));
 
     el.appendChild(this._sep());
 
     // Resize
-    el.appendChild(this._makeBtn(ICONS.colWidth,   'Column Width',      () => this._openSizePopover('col')));
-    el.appendChild(this._makeBtn(ICONS.rowHeight,  'Row Height',        () => this._openSizePopover('row')));
-    el.appendChild(this._makeBtn(ICONS.tableBorder,'Table Border Width',() => this._openSizePopover('border')));
+    el.appendChild(this._makeBtn(ICONS.colWidth,   L.columnWidth,      () => this._openSizePopover('col')));
+    el.appendChild(this._makeBtn(ICONS.rowHeight,  L.rowHeight,        () => this._openSizePopover('row')));
+    el.appendChild(this._makeBtn(ICONS.tableBorder,L.tableBorderWidth, () => this._openSizePopover('border')));
 
     el.appendChild(this._sep());
 
     // Delete table (danger)
-    el.appendChild(this._makeBtn(ICONS.deleteTable, 'Delete Table', () => this._deleteTable(), true));
+    el.appendChild(this._makeBtn(ICONS.deleteTable, L.deleteTable, () => this._deleteTable(), true));
 
     // Keep tooltip alive while hovering.
     // Don't schedule hide on mouseleave when the size popover is open —
@@ -909,9 +910,9 @@ export class TableTooltip {
 
     const actionsEl  = createElement('div', { class: 'an-size-popover-actions' });
     const cancelBtn  = createElement('button', { type: 'button', class: 'an-btn' });
-    cancelBtn.textContent = 'Cancel';
+    cancelBtn.textContent = this.context.locale.tooltips.table.cancelBtn;
     const applyBtn   = createElement('button', { type: 'button', class: 'an-btn an-btn-primary' });
-    applyBtn.textContent = 'Apply';
+    applyBtn.textContent = this.context.locale.tooltips.table.applyBtn;
     actionsEl.appendChild(cancelBtn);
     actionsEl.appendChild(applyBtn);
 
@@ -960,7 +961,7 @@ export class TableTooltip {
         ? (parseInt(firstCell.style.borderWidth, 10) ||
            parseInt(window.getComputedStyle(firstCell).borderWidth, 10) || 1)
         : 1;
-      this._sizeTitleEl.textContent = 'Table Border Width (px)';
+      this._sizeTitleEl.textContent = this.context.locale.tooltips.table.tableBorderWidthPx;
       this._sizeInputEl.min   = '0';
       this._sizeInputEl.max   = '10';
       this._sizeInputEl.value = currentPx;
@@ -979,7 +980,9 @@ export class TableTooltip {
         const t = c.closest('table');
         return t && t === cell.closest('table');
       });
-      this._sizeTitleEl.textContent = isCol ? 'Column Width (px)' : 'Row Height (px)';
+      this._sizeTitleEl.textContent = isCol
+        ? this.context.locale.tooltips.table.columnWidthPx
+        : this.context.locale.tooltips.table.rowHeightPx;
       this._sizeInputEl.min   = '1';
       this._sizeInputEl.max   = '2000';
       this._sizeInputEl.value = isCol

package/src/js/module/Toolbar.js

@@ -182,9 +182,9 @@ export class Toolbar {
     const btn = createElement('button', {
       type: 'button',
       class: baseClass,
-      title: def.tooltip || '',
+      title: this.context.locale.toolbar[def.name] || def.tooltip || '',
       'data-btn': def.name,
-      'aria-label': def.tooltip || def.name,
+      'aria-label': this.context.locale.toolbar[def.name] || def.tooltip || def.name,
       'aria-haspopup': 'true',
       'aria-expanded': 'false',
     });
@@ -206,7 +206,7 @@ export class Toolbar {
     });
     const grid = createElement('div', { class: 'an-table-grid' });
     const label = createElement('div', { class: 'an-table-label' });
-    label.textContent = 'Insert Table';
+    label.textContent = this.context.locale.toolbar.insertTableLabel || 'Insert Table';
 
     const cells = [];
     for (let r = 1; r <= ROWS; r++) {
@@ -232,7 +232,7 @@ export class Toolbar {
         const c = +cell.getAttribute('data-col');
         cell.classList.toggle('active', r <= rows && c <= cols);
       });
-      label.textContent = (rows && cols) ? `${rows} × ${cols}` : 'Insert Table';
+      label.textContent = (rows && cols) ? `${rows} × ${cols}` : (this.context.locale.toolbar.insertTableLabel || 'Insert Table');
     };
 
     const openPopup = () => {
@@ -307,9 +307,9 @@ export class Toolbar {
     const applyBtn = createElement('button', {
       type: 'button',
       class: `${baseClass} an-color-btn`,
-      title: def.tooltip || '',
+      title: this.context.locale.toolbar[def.name] || def.tooltip || '',
       'data-btn': def.name,
-      'aria-label': def.tooltip || def.name,
+      'aria-label': this.context.locale.toolbar[def.name] || def.tooltip || def.name,
     });
 
     const S = 'stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"';
@@ -326,7 +326,9 @@ export class Toolbar {
     const arrowBtn = createElement('button', {
       type: 'button',
       class: `${baseClass} an-color-arrow`,
-      title: `Choose ${def.name === 'foreColor' ? 'text' : 'highlight'} color`,
+      title: def.name === 'foreColor'
+        ? (this.context.locale.toolbar.chooseTextColor || 'Choose text color')
+        : (this.context.locale.toolbar.chooseHighlightColor || 'Choose highlight color'),
       'aria-haspopup': 'true',
       'aria-expanded': 'false',
     });
@@ -346,8 +348,8 @@ export class Toolbar {
     });
 
     const customRow = createElement('div', { class: 'an-color-custom' });
-    const colorInput = createElement('input', { type: 'color', value: currentColor, title: 'Custom color' });
-    const customLabel = createElement('span', {}, ['Custom color']);
+    const colorInput = createElement('input', { type: 'color', value: currentColor, title: this.context.locale.toolbar.customColor || 'Custom color' });
+    const customLabel = createElement('span', {}, [this.context.locale.toolbar.customColor || 'Custom color']);
     customRow.appendChild(colorInput);
     customRow.appendChild(customLabel);
 
@@ -491,19 +493,23 @@ export class Toolbar {
     const cls = def.selectClass ? `an-select ${def.selectClass}` : 'an-select';
     const select = createElement('select', {
       class: cls,
-      title: def.tooltip || '',
+      title: this.context.locale.toolbar[def.name] || def.tooltip || '',
       'data-btn': def.name,
-      'aria-label': def.tooltip || def.name,
+      'aria-label': this.context.locale.toolbar[def.name] || def.tooltip || def.name,
     });
 
     // Blank "placeholder" option (non-selectable header)
-    const placeholderText = def.placeholder || 'Font';
+    const placeholderText = this.context.locale.toolbar[def.name + 'Placeholder'] || def.placeholder || 'Font';
     const placeholder = createElement('option', { value: '', disabled: '', hidden: '' }, [placeholderText]);
     select.appendChild(placeholder);
 
     items.forEach((item) => {
       const value    = (typeof item === 'object') ? item.value    : item;
-      const label    = (typeof item === 'object') ? item.label    : item;
+      const label    = (typeof item === 'object')
+        ? (def.name === 'paragraphStyle'
+            ? ((this.context.locale.toolbar.paragraphItems || {})[item.value] || item.label)
+            : item.label)
+        : item;
       const isHeader = (typeof item === 'object') && !!item.disabled;
       const attrs    = { value };
       if (isHeader) attrs.disabled = '';
@@ -558,9 +564,9 @@ export class Toolbar {
     const btn = createElement('button', {
       type: 'button',
       class: classAttr,
-      title: btnDef.tooltip || '',
+      title: this.context.locale.toolbar[btnDef.name] || btnDef.tooltip || '',
       'data-btn': btnDef.name,
-      'aria-label': btnDef.tooltip || btnDef.name,
+      'aria-label': this.context.locale.toolbar[btnDef.name] || btnDef.tooltip || btnDef.name,
     });
 
     // Render icon: prefer FontAwesome if enabled; otherwise fall back to SVG or text.

package/src/js/module/VideoDialog.js

@@ -59,24 +59,25 @@ export class VideoDialog {
   // ---------------------------------------------------------------------------
 
   _buildDialog() {
+    const L = this.context.locale.videoDialog;
     const overlay = createElement('div', {
       class: 'an-dialog-overlay',
       role: 'dialog',
       'aria-modal': 'true',
-      'aria-label': 'Insert video',
+      'aria-label': L.ariaLabel,
     });
     const box = createElement('div', { class: 'an-dialog-box' });
 
     const title = createElement('h3', { class: 'an-dialog-title' });
-    title.textContent = 'Insert Video';
+    title.textContent = L.title;
 
     // URL input
     const urlLabel = createElement('label', { class: 'an-label' });
-    urlLabel.textContent = 'Video URL';
+    urlLabel.textContent = L.videoUrl;
     const urlInput = /** @type {HTMLInputElement} */ (createElement('input', {
       type: 'url',
       class: 'an-input',
-      placeholder: 'YouTube, Vimeo, or direct .mp4 URL',
+      placeholder: L.urlPlaceholder,
       autocomplete: 'off',
     }));
     this._urlInput = urlInput;
@@ -87,7 +88,7 @@ export class VideoDialog {
 
     // Width
     const widthLabel = createElement('label', { class: 'an-label' });
-    widthLabel.textContent = 'Width (px)';
+    widthLabel.textContent = L.widthLabel;
     const widthInput = /** @type {HTMLInputElement} */ (createElement('input', {
       type: 'number',
       class: 'an-input',
@@ -101,9 +102,9 @@ export class VideoDialog {
     // Buttons
     const btnRow = createElement('div', { class: 'an-dialog-actions' });
     const insertBtn = createElement('button', { type: 'button', class: 'an-btn an-btn-primary' });
-    insertBtn.textContent = 'Insert';
+    insertBtn.textContent = L.insertBtn;
     const cancelBtn = createElement('button', { type: 'button', class: 'an-btn' });
-    cancelBtn.textContent = 'Cancel';
+    cancelBtn.textContent = L.cancelBtn;
     btnRow.appendChild(insertBtn);
     btnRow.appendChild(cancelBtn);
 
@@ -113,7 +114,7 @@ export class VideoDialog {
     // Live URL hint
     const d0 = on(urlInput, 'input', () => {
       const info = this._parseVideoUrl(urlInput.value.trim());
-      hintEl.textContent = info ? `Detected: ${info.type}` : (urlInput.value ? 'Unknown format — will try direct video embed' : '');
+      hintEl.textContent = info ? this.context.locale.videoDialog.detected(info.type) : (urlInput.value ? this.context.locale.videoDialog.unknownFormat : '');
     });
 
     const d1 = on(insertBtn, 'click', () => this._onInsert());
@@ -140,7 +141,7 @@ export class VideoDialog {
 
     const html = this._buildEmbedHtml(rawUrl, width);
     if (!html) {
-      this._hintEl.textContent = 'Invalid URL — please enter a valid video link.';
+      this._hintEl.textContent = this.context.locale.videoDialog.invalidUrl;
       this._urlInput.focus();
       return;
     }

package/src/js/module/VideoTooltip.js

@@ -78,24 +78,25 @@ export class VideoTooltip {
   // ---------------------------------------------------------------------------
 
   _buildTooltip() {
+    const L = this.context.locale.tooltips.video;
     const el = createElement('div', {
       class: 'an-link-tooltip an-video-tooltip',
       role: 'toolbar',
-      'aria-label': 'Video actions',
+      'aria-label': L.ariaLabel,
     });
     el.style.display = 'none';
 
     // Label
     this._label = createElement('span', { class: 'an-link-tooltip-url' });
-    this._label.textContent = 'Video';
+    this._label.textContent = L.label;
     el.appendChild(this._label);
 
     el.appendChild(createElement('div', { class: 'an-link-tooltip-sep' }));
 
-    this._floatLeftBtn  = this._makeBtn(ICONS.floatLeft,    'Float Left',     () => this._setFloat('left'));
-    this._floatNoneBtn  = this._makeBtn(ICONS.floatNone,    'No Float',       () => this._setFloat(''));
-    this._alignCenterBtn = this._makeBtn(ICONS.alignCenter, 'Align Center',   () => this._setCenter());
-    this._floatRightBtn = this._makeBtn(ICONS.floatRight,   'Float Right',    () => this._setFloat('right'));
+    this._floatLeftBtn  = this._makeBtn(ICONS.floatLeft,    L.floatLeft,    () => this._setFloat('left'));
+    this._floatNoneBtn  = this._makeBtn(ICONS.floatNone,    L.noFloat,      () => this._setFloat(''));
+    this._alignCenterBtn = this._makeBtn(ICONS.alignCenter, L.alignCenter,  () => this._setCenter());
+    this._floatRightBtn = this._makeBtn(ICONS.floatRight,   L.floatRight,   () => this._setFloat('right'));
 
     el.appendChild(this._floatLeftBtn);
     el.appendChild(this._floatNoneBtn);
@@ -104,18 +105,18 @@ export class VideoTooltip {
 
     el.appendChild(createElement('div', { class: 'an-link-tooltip-sep' }));
 
-    this._originalBtn = this._makeBtn(ICONS.originalSize, 'Original Size', () => this._resetSize());
+    this._originalBtn = this._makeBtn(ICONS.originalSize, L.originalSize, () => this._resetSize());
 
     el.appendChild(this._originalBtn);
 
     el.appendChild(createElement('div', { class: 'an-link-tooltip-sep' }));
 
-    this._previewBtn = this._makeBtn(ICONS.preview, 'Preview Video', () => this._togglePreview());
+    this._previewBtn = this._makeBtn(ICONS.preview, L.previewVideo, () => this._togglePreview());
     el.appendChild(this._previewBtn);
 
     el.appendChild(createElement('div', { class: 'an-link-tooltip-sep' }));
 
-    this._deleteBtn = this._makeBtn(ICONS.deleteVideo, 'Delete Video', () => this._delete(), true);
+    this._deleteBtn = this._makeBtn(ICONS.deleteVideo, L.deleteVideo, () => this._delete(), true);
 
     el.appendChild(this._deleteBtn);
 
@@ -292,7 +293,7 @@ export class VideoTooltip {
 
     // Visual feedback: button turns primary-coloured
     this._previewBtn.classList.add('an-link-tooltip-btn--copied');
-    this._previewBtn.title = 'Exit Preview';
+    this._previewBtn.title = this.context.locale.tooltips.video.exitPreview;
 
     // Exit preview on mousedown outside the wrapper.
     // Using 'mousedown' (not 'click') so clicks inside an iframe
@@ -319,7 +320,7 @@ export class VideoTooltip {
 
     // Reset button appearance
     this._previewBtn.classList.remove('an-link-tooltip-btn--copied');
-    this._previewBtn.title = 'Preview Video';
+    this._previewBtn.title = this.context.locale.tooltips.video.previewVideo;
 
     if (this._previewClickOff) {
       document.removeEventListener('mousedown', this._previewClickOff, true);

package/src/js/settings.js

@@ -135,4 +135,8 @@ export const defaultOptions = {
   // Custom focus ring colour — overrides the default blue when set.
   // Accepts any valid CSS colour string, e.g. '#f97316', 'hsl(25,90%,55%)'.
   focusColor: null,
+  // Display language for the editor UI.
+  // Built-in values: 'en' (default), 'vi', 'ja', 'zh', 'fr'.
+  // Pass a partial or full locale object to override individual strings.
+  lang: 'en',
 };

package/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * AutumnNote – TypeScript declarations
- * @version 1.0.4
+ * @version 1.0.9
  */
 
 // ---------------------------------------------------------------------------
@@ -104,6 +104,12 @@ export interface AsnOptions {
   onPaste?: (data: { text: string; html: string | null }) => void;
   /** Additional color swatches shown at the top of the color picker. */
   colorSwatches?: string[];
+  /**
+   * Display language for the editor UI.
+   * Built-in: 'en' (default) | 'vi' | 'ja' | 'zh' | 'fr'.
+   * Pass a partial locale object to override individual strings.
+   */
+  lang?: string | Partial<AsnLocale>;
 }
 
 // ---------------------------------------------------------------------------
@@ -179,6 +185,57 @@ export type ToolbarItemDef = ButtonDef | DropdownDef | GridButtonDef | ColorPick
 /** Runtime default options object (same export as `src/js/index.js`). */
 export declare const defaultOptions: Required<AsnOptions>;
 
+// ---------------------------------------------------------------------------
+// Locale / i18n
+// ---------------------------------------------------------------------------
+
+/** Full locale object shape used by the editor. All leaf values are strings or template functions. */
+export interface AsnLocale {
+  toolbar: Record<string, string | ((n: string | number) => string) | Record<string, string>>;
+  linkDialog: Record<string, string>;
+  imageDialog: Record<string, string>;
+  videoDialog: Record<string, string | ((type: string) => string)>;
+  emojiDialog: Record<string, string | Record<string, string>>;
+  iconDialog: Record<string, string | Record<string, string>>;
+  findReplace: Record<string, string>;
+  shortcutsDialog: {
+    title: string;
+    ariaLabel: string;
+    close: string;
+    shortcuts: Array<{ category: string; items: Array<{ keys: string; action: string }> }>;
+  };
+  contextMenu: Record<string, string>;
+  statusbar: {
+    resizeHandle: string;
+    words: (n: number) => string;
+    wordsLimit: (n: number, max: number) => string;
+    chars: (n: number) => string;
+    charsLimit: (n: number, max: number) => string;
+  };
+  tooltips: {
+    link: Record<string, string>;
+    image: Record<string, string>;
+    code: Record<string, string>;
+    table: Record<string, string>;
+    video: Record<string, string>;
+  };
+  errors: {
+    imageFormat: (type: string) => string;
+    imageSize: (maxMb: number) => string;
+  };
+}
+
+/** Registry of all built-in locales (keys: 'en', 'vi', 'ja', 'zh', 'fr'). */
+export declare const locales: Record<string, AsnLocale>;
+
+/**
+ * Resolves a lang value to a full AsnLocale.
+ * - string key → looks up locales registry, deep-merges with 'en' fallback.
+ * - object → deep-merges with 'en' as base.
+ * - falsy / 'en' → returns the canonical English locale.
+ */
+export declare function resolveLocale(lang: string | Partial<AsnLocale> | null | undefined): AsnLocale;
+
 // Re-export core utility modules exposed by the package entry-point.
 export * from '../src/js/core/dom.js';
 export * from '../src/js/core/range.js';