autumnnote 1.15.0 → 2.0.0

package/src/js/i18n/fr.js

@@ -343,4 +343,19 @@ export const fr = {
     restore: 'Restaurer',
     discard: 'Ignorer',
   },
+
+  slashMenu: {
+    noResults:      'Aucune commande correspondante',
+    heading1:       'Titre 1',
+    heading2:       'Titre 2',
+    heading3:       'Titre 3',
+    bulletList:     'Liste à puces',
+    numberedList:   'Liste numérotée',
+    checklist:      'Liste de contrôle',
+    blockquote:     'Citation',
+    codeBlock:      'Bloc de code',
+    horizontalRule: 'Ligne horizontale',
+    table:          'Tableau',
+    image:          'Image',
+  },
 };

package/src/js/i18n/index.js

@@ -1,33 +1,51 @@
 /**
  * i18n/index.js — Locale registry and resolver for autumn-note-ce.
  *
+ * Only English ships in the ESM bundle. Bundling all eight locales cost every
+ * consumer ~15 KB gzip even when they only ever rendered English, so the other
+ * locales are opt-in via subpath imports:
+ *
+ *   import AutumnNote from 'autumnnote';
+ *   import { vi } from 'autumnnote/i18n/vi';
+ *
+ *   AutumnNote.registerLocale('vi', vi);
+ *   AutumnNote.create('#editor', { lang: 'vi' });
+ *
+ * The UMD/CDN build cannot tree-shake, so it pre-registers every locale and
+ * `lang: 'vi'` keeps working there with no extra imports.
+ *
  * Usage:
- *   lang: 'en'          → built-in English (default)
- *   lang: 'vi'          → built-in Vietnamese
- *   lang: 'ja'          → built-in Japanese
- *   lang: 'zh'          → built-in Simplified Chinese
- *   lang: 'fr'          → built-in French
- *   lang: 'de'          → built-in German
- *   lang: 'es'          → built-in Spanish
- *   lang: 'ko'          → built-in Korean
+ *   lang: 'en'          → built-in English (always available)
+ *   lang: '<code>'      → a locale previously passed to registerLocale()
  *   lang: { ... }       → custom locale object, deep-merged over English
  */
 
 import { mergeDeep } from '../core/func.js';
 import { en } from './en.js';
-import { vi } from './vi.js';
-import { ja } from './ja.js';
-import { zh } from './zh.js';
-import { fr } from './fr.js';
-import { de } from './de.js';
-import { es } from './es.js';
-import { ko } from './ko.js';
 
 /**
- * All built-in locales keyed by their language code.
+ * Locales available to `lang: '<code>'`. Starts with English only; other codes
+ * are added through {@link registerLocale}.
  * @type {Record<string, Partial<AsnLocale>>}
  */
-export const locales = { en, vi, ja, zh, fr, de, es, ko };
+export const locales = { en };
+
+/**
+ * Registers a locale so it can be selected by code.
+ *
+ * @param {string} code - Language code, e.g. 'vi'.
+ * @param {Partial<AsnLocale>} locale - Locale object; missing keys fall back to English.
+ * @returns {void}
+ */
+export function registerLocale(code, locale) {
+  if (typeof code !== 'string' || !code) {
+    throw new TypeError('[AutumnNote] registerLocale: code must be a non-empty string.');
+  }
+  if (!locale || typeof locale !== 'object') {
+    throw new TypeError(`[AutumnNote] registerLocale: locale for "${code}" must be an object.`);
+  }
+  locales[code] = locale;
+}
 
 /**
  * Resolve a locale object from a lang option value.
@@ -41,8 +59,16 @@ export function resolveLocale(lang) {
 
   if (typeof lang === 'string') {
     const partial = locales[lang];
-    // Unknown language code → fall back to English
-    if (!partial) return en;
+    if (!partial) {
+      // Unregistered code → English, but say why: silently rendering English
+      // after asking for another language is confusing to debug.
+      console.warn(
+        `[AutumnNote] Locale "${lang}" is not registered, falling back to English. ` +
+        `Import it first: import { ${lang} } from 'autumnnote/i18n/${lang}'; ` +
+        `AutumnNote.registerLocale('${lang}', ${lang});`,
+      );
+      return en;
+    }
     return mergeDeep(mergeDeep({}, en), partial);
   }
 

package/src/js/i18n/ja.js

@@ -343,4 +343,19 @@ export const ja = {
     restore: '復元',
     discard: '破棄',
   },
+
+  slashMenu: {
+    noResults:      '一致するコマンドがありません',
+    heading1:       '見出し1',
+    heading2:       '見出し2',
+    heading3:       '見出し3',
+    bulletList:     '箇条書きリスト',
+    numberedList:   '番号付きリスト',
+    checklist:      'チェックリスト',
+    blockquote:     '引用',
+    codeBlock:      'コードブロック',
+    horizontalRule: '水平線',
+    table:          '表',
+    image:          '画像',
+  },
 };

package/src/js/i18n/ko.js

@@ -342,4 +342,19 @@ export const ko = {
     restore: '복원',
     discard: '삭제',
   },
+
+  slashMenu: {
+    noResults:      '일치하는 명령이 없습니다',
+    heading1:       '제목 1',
+    heading2:       '제목 2',
+    heading3:       '제목 3',
+    bulletList:     '글머리 기호 목록',
+    numberedList:   '번호 매기기 목록',
+    checklist:      '체크리스트',
+    blockquote:     '인용문',
+    codeBlock:      '코드 블록',
+    horizontalRule: '가로선',
+    table:          '표',
+    image:          '이미지',
+  },
 };

package/src/js/i18n/vi.js

@@ -343,4 +343,19 @@ export const vi = {
     restore: 'Khôi phục',
     discard: 'Bỏ qua',
   },
+
+  slashMenu: {
+    noResults:      'Không có lệnh phù hợp',
+    heading1:       'Tiêu đề 1',
+    heading2:       'Tiêu đề 2',
+    heading3:       'Tiêu đề 3',
+    bulletList:     'Danh sách không thứ tự',
+    numberedList:   'Danh sách có thứ tự',
+    checklist:      'Danh sách công việc',
+    blockquote:     'Trích dẫn',
+    codeBlock:      'Khối mã',
+    horizontalRule: 'Đường kẻ ngang',
+    table:          'Bảng',
+    image:          'Hình ảnh',
+  },
 };

package/src/js/i18n/zh.js

@@ -343,4 +343,19 @@ export const zh = {
     restore: '恢复',
     discard: '放弃',
   },
+
+  slashMenu: {
+    noResults:      '没有匹配的命令',
+    heading1:       '标题 1',
+    heading2:       '标题 2',
+    heading3:       '标题 3',
+    bulletList:     '项目符号列表',
+    numberedList:   '编号列表',
+    checklist:      '检查清单',
+    blockquote:     '引用',
+    codeBlock:      '代码块',
+    horizontalRule: '水平线',
+    table:          '表格',
+    image:          '图片',
+  },
 };

package/src/js/index.js

@@ -14,6 +14,7 @@ import '../styles/autumnnote.scss';
 import { Context, _customModules, _globalPlugins } from './Context.js';
 import { registerButton, buttons } from './module/Buttons.js';
 import { defaultOptions } from './settings.js';
+import { registerLocale } from './i18n/index.js';
 
 // Snapshot of factory defaults taken at module-load time (before any setDefaults() calls)
 const _originalDefaults = { ...defaultOptions };
@@ -29,7 +30,7 @@ export * from './core/lists.js';
 export * from './core/env.js';
 export * from './core/sanitise.js';
 export * from './module/Buttons.js';
-export { locales, resolveLocale } from './i18n/index.js';
+export { locales, resolveLocale, registerLocale } from './i18n/index.js';
 
 // ---------------------------------------------------------------------------
 // Main factory
@@ -140,11 +141,32 @@ const AutumnNote = {
    */
   registerButton(btnDef) { registerButton(btnDef); return this; },
 
+  /**
+   * Registers a locale so `lang: '<code>'` can select it.
+   * Only English ships in the ESM bundle — import others from
+   * `autumnnote/i18n/<code>` and register them here.
+   * @param {string} code
+   * @param {object} locale
+   */
+  registerLocale(code, locale) { registerLocale(code, locale); return this; },
+
+  /** Registers a slash-menu command for future editor instances. */
+  registerSlashCommand(command) {
+    if (!command?.id || typeof command.run !== 'function') {
+      throw new TypeError('[AutumnNote] Slash command requires an id and run(context) function.');
+    }
+    const commands = defaultOptions.slashCommands;
+    const index = commands.findIndex((item) => item.id === command.id);
+    if (index >= 0) commands[index] = command;
+    else commands.push(command);
+    return this;
+  },
+
   /** All pre-built button definitions — accessible in every module format including UMD/CJS. */
   buttons,
 
   /** Library version */
-  version: '1.15.0',
+  version: '2.0.0',
 };
 
 // ---------------------------------------------------------------------------

package/src/js/index.umd.js

@@ -9,4 +9,9 @@
  *     const editor = AutumnNote.create('#my-editor');
  *   </script>
  */
+// Script-tag consumers have no bundler to tree-shake with, so every locale is
+// pre-registered here and `lang: 'vi'` works without extra imports. ESM
+// consumers opt in per locale via `autumnnote/i18n/<code>` instead.
+import './i18n/all.js';
+
 export { default } from './index.js';

package/src/js/module/BaseMediaTooltip.js

@@ -0,0 +1,142 @@
+/**
+ * BaseMediaTooltip.js — Shared hover-tooltip behaviour for media embeds.
+ *
+ * ImageTooltip and VideoTooltip duplicated their button factory, show/hide
+ * timers and viewport-aware positioning (~22% of both files). Those pieces live
+ * here; each subclass keeps only what genuinely differs — which element counts
+ * as the target, which buttons the bar contains, and the actions behind them.
+ *
+ * Mirrors the existing BaseDialog / BaseResizer pattern.
+ */
+
+import { createElement, on } from '../core/dom.js';
+
+/** Delay before a hovered target shows its tooltip. */
+export const SHOW_DELAY = 100;
+/** Grace period before a tooltip hides after the pointer leaves. */
+export const HIDE_DELAY = 180;
+
+export class BaseMediaTooltip {
+  /** @param {import('../Context.js').Context} context */
+  constructor(context) {
+    this.context = context;
+    this.options = context.options;
+    /** @type {HTMLElement|null} The tooltip bar */
+    this._el = null;
+    /** @type {HTMLElement|null} Currently hovered target */
+    this._active = null;
+    this._showTimer = null;
+    this._hideTimer = null;
+    this._disposers = [];
+  }
+
+  // ---------------------------------------------------------------------------
+  // Subclass hooks
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Whether `_scheduleHide` is allowed to start the hide countdown. Subclasses
+   * override to pin the tooltip open (e.g. while a video preview is playing).
+   * @returns {boolean}
+   */
+  _canHide() { return true; }
+
+  /** Runs just before the tooltip is hidden, for subclass-specific teardown. */
+  _beforeHide() {}
+
+  // ---------------------------------------------------------------------------
+  // Buttons
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Builds a tooltip button and registers its click disposer.
+   * @param {string} icon - inline SVG markup
+   * @param {string} title
+   * @param {() => void} handler
+   * @param {boolean} [isDanger]
+   * @returns {HTMLElement}
+   */
+  _makeBtn(icon, title, handler, isDanger = false) {
+    const btn = createElement('button', {
+      type: 'button',
+      class: isDanger ? 'an-link-tooltip-btn an-link-tooltip-btn--danger' : 'an-link-tooltip-btn',
+      title,
+    });
+    btn.innerHTML = icon;
+    this._disposers.push(on(btn, 'click', (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      handler();
+    }));
+    return btn;
+  }
+
+  // ---------------------------------------------------------------------------
+  // Show / Hide
+  // ---------------------------------------------------------------------------
+
+  _scheduleShow(target) {
+    if (this._active === target && this._el.style.display !== 'none') return;
+    clearTimeout(this._hideTimer);
+    this._hideTimer = null;
+    clearTimeout(this._showTimer);
+    this._showTimer = setTimeout(() => {
+      this._active = target;
+      this._show(target);
+    }, SHOW_DELAY);
+  }
+
+  _scheduleHide() {
+    if (!this._canHide()) return;
+    clearTimeout(this._showTimer);
+    this._showTimer = null;
+    // Always reset the hide timer so rapid mouseout→mouseover sequences
+    // don't leave a stale timer that hides the tooltip prematurely.
+    clearTimeout(this._hideTimer);
+    this._hideTimer = setTimeout(() => this._hide(), HIDE_DELAY);
+  }
+
+  _show(_target) {
+    this._el.style.display = 'flex';
+    // Defer positioning: offsetWidth on a newly-visible element forces layout
+    requestAnimationFrame(() => {
+      if (this._active) this._positionNear(this._active);
+    });
+  }
+
+  _hide() {
+    this._beforeHide();
+    this._el.style.display = 'none';
+    this._active = null;
+    this._clearTimers();
+  }
+
+  _clearTimers() {
+    clearTimeout(this._showTimer);
+    clearTimeout(this._hideTimer);
+    this._showTimer = null;
+    this._hideTimer = null;
+  }
+
+  /**
+   * Places the tooltip under the target, flipping above and clamping
+   * horizontally when it would leave the viewport.
+   * @param {HTMLElement} target
+   */
+  _positionNear(target) {
+    const rect   = target.getBoundingClientRect();
+    const tipW   = this._el.offsetWidth  || 220;
+    const tipH   = this._el.offsetHeight || 32;
+    const margin = 6;
+
+    let top  = rect.bottom + margin;
+    let left = rect.left + (rect.width - tipW) / 2;
+
+    if (top + tipH > globalThis.innerHeight - margin) top = rect.top - tipH - margin;
+    if (left + tipW > globalThis.innerWidth  - margin) left = globalThis.innerWidth - tipW - margin;
+    if (left < margin) left = margin;
+
+    this._el.style.top  = `${top}px`;
+    this._el.style.left = `${left}px`;
+  }
+}