autumnnote 1.3.0 → 1.4.0

package/dist/autumnnote.umd.js

@@ -803,6 +803,34 @@
 			isDisabled
 		};
 	}
+	/**
+	* Global registry for custom buttons registered via AutumnNote.registerButton()
+	* or via a plugin's `buttons` array. Toolbar resolves string names from here.
+	* @type {Map<string, object>}
+	*/
+	var _buttonRegistry = /* @__PURE__ */ new Map();
+	/**
+	* Registers a button definition in the global registry so it can be referenced
+	* by string name in toolbar configuration: `toolbar: [['myBtn', boldBtn]]`.
+	* @param {object} btnDef - Any ToolbarItemDef-compatible object with a `name` string.
+	*/
+	function registerButton(btnDef) {
+		if (!btnDef || typeof btnDef.name !== "string") {
+			console.warn("[AutumnNote] registerButton: btnDef must have a string `name` property.");
+			return;
+		}
+		if (_buttonRegistry.has(btnDef.name)) console.warn(`[AutumnNote] registerButton: overwriting existing button "${btnDef.name}".`);
+		_buttonRegistry.set(btnDef.name, btnDef);
+	}
+	/**
+	* Looks up a button definition by name from the global registry.
+	* Returns undefined when not found.
+	* @param {string} name
+	* @returns {object|undefined}
+	*/
+	function getButton(name) {
+		return _buttonRegistry.get(name);
+	}
 	var boldBtn = btn("bold", "bold", "Bold (Ctrl+B)", () => bold(), () => document.queryCommandState("bold"));
 	var italicBtn = btn("italic", "italic", "Italic (Ctrl+I)", () => italic(), () => document.queryCommandState("italic"));
 	var underlineBtn = btn("underline", "underline", "Underline (Ctrl+U)", () => underline(), () => {
@@ -5502,6 +5530,8 @@
 	* Toolbar.js - Builds and manages the editor toolbar UI
 	* Inspired by Summernote's Toolbar module — rewritten without jQuery
 	*/
+	/** Resolve a toolbar item: string → registry lookup, object → pass-through. */
+	var _resolveBtn = (item) => typeof item === "string" ? getButton(item) : item;
 	var _faPageLevelReady = null;
 	var _S$1 = "stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"";
 	var _svgWrap = (paths) => `<svg xmlns="http://www.w3.org/2000/svg" width="15" height="15" viewBox="0 0 24 24" fill="none" ${_S$1} style="display:block">${paths}</svg>`;
@@ -5598,7 +5628,7 @@
 			this.el = createElement("div", { class: "an-toolbar" });
 			this._faReady = this._detectFontAwesome();
 			this._buildButtons();
-			this._btnMap = new Map((this.options.toolbar || []).flat().map((b) => [b.name, b]));
+			this._btnMap = new Map((this.options.toolbar || []).flat().map(_resolveBtn).filter(Boolean).map((b) => [b.name, b]));
 			return this;
 		}
 		destroy() {
@@ -5614,7 +5644,12 @@
 			const fragment = document.createDocumentFragment();
 			toolbar.forEach((group) => {
 				const groupEl = createElement("div", { class: "an-btn-group" });
-				group.forEach((btnDef) => {
+				group.forEach((item) => {
+					const btnDef = _resolveBtn(item);
+					if (!btnDef) {
+						console.warn(`[AutumnNote] Toolbar: button "${item}" not found in registry. Skipped.`);
+						return;
+					}
 					let el;
 					if (btnDef.type === "select") el = this._createSelect(btnDef);
 					else if (btnDef.type === "grid") el = this._createGridPicker(btnDef);
@@ -6034,6 +6069,24 @@
 		hide() {
 			if (this.el) this.el.style.display = "none";
 		}
+		/**
+		* Tears down and re-renders the toolbar in-place.
+		* Call after registering new buttons post-create via context.use(plugin)
+		* or AutumnNote.registerButton() to make them appear in the toolbar.
+		*/
+		rebuild() {
+			if (this._refreshRaf) {
+				cancelAnimationFrame(this._refreshRaf);
+				this._refreshRaf = null;
+			}
+			this._disposers.forEach((d) => d());
+			this._disposers = [];
+			if (this.el) this.el.innerHTML = "";
+			this._faReady = this._detectFontAwesome();
+			this._buildButtons();
+			this._btnMap = new Map((this.options.toolbar || []).flat().map(_resolveBtn).filter(Boolean).map((b) => [b.name, b]));
+			this.refresh();
+		}
 	};
 	//#endregion
 	//#region src/js/module/Statusbar.js
@@ -15481,6 +15534,8 @@
 	*/
 	/** Module registry shared across all Context instances (populated via AutumnNote.registerModule). */
 	var _customModules = /* @__PURE__ */ new Map();
+	/** Global plugin registry (populated via AutumnNote.use()). Applied to every new Context. */
+	var _globalPlugins = /* @__PURE__ */ new Map();
 	var Context = class {
 		/**
 		* @param {HTMLElement} targetEl - The element to replace with the editor
@@ -15497,6 +15552,8 @@
 			this._listeners = /* @__PURE__ */ new Map();
 			/** @type {Map<string, object>} */
 			this._modules = /* @__PURE__ */ new Map();
+			/** @type {Map<string, { plugin: object, publicApi: * }>} */
+			this._plugins = /* @__PURE__ */ new Map();
 			this._disposers = [];
 			this._alive = false;
 		}
@@ -15519,6 +15576,7 @@
 			if (this.options.focus) editable.focus();
 			this._alive = true;
 			this.invoke("toolbar.refresh");
+			this._applyGlobalPlugins();
 			if (typeof this.options.onInit === "function") this.options.onInit(this);
 			return this;
 		}
@@ -15570,6 +15628,46 @@
 			this._modules.set(name, instance);
 			return this;
 		}
+		/**
+		* Installs a plugin on this editor instance.
+		* If called after create(), buttons are registered immediately but the toolbar
+		* must be rebuilt via ctx.invoke('toolbar.rebuild') to render new buttons.
+		* @param {object} plugin - { name, version?, buttons?, install?, uninstall? }
+		* @param {object} [options] - Forwarded to plugin.install(context, options)
+		* @returns {this}
+		*/
+		use(plugin, options = {}) {
+			if (Array.isArray(plugin.buttons)) plugin.buttons.forEach((b) => registerButton(b));
+			this._installPlugin(plugin, options);
+			return this;
+		}
+		/**
+		* Returns the public API returned by plugin.install(), or null.
+		* @param {string} name
+		* @returns {*}
+		*/
+		getPlugin(name) {
+			return this._plugins.get(name)?.publicApi ?? null;
+		}
+		_installPlugin(plugin, pluginOptions = {}) {
+			const { name } = plugin;
+			if (!name || typeof name !== "string") {
+				console.warn("[AutumnNote] Plugin must have a string `name` property.");
+				return;
+			}
+			if (this._plugins.has(name)) {
+				console.warn(`[AutumnNote] Plugin "${name}" already installed on this instance. Skipping.`);
+				return;
+			}
+			const publicApi = typeof plugin.install === "function" ? plugin.install(this, pluginOptions) ?? null : null;
+			this._plugins.set(name, {
+				plugin,
+				publicApi
+			});
+		}
+		_applyGlobalPlugins() {
+			for (const { plugin, options } of _globalPlugins.values()) this._installPlugin(plugin, options);
+		}
 		_bindEditorEvents(editable) {
 			const d0 = on(editable, "input", () => this._syncToTarget());
 			const d1 = on(editable, "focus", () => {
@@ -15820,6 +15918,10 @@
 				if (typeof module.destroy === "function") module.destroy();
 			});
 			this._modules.clear();
+			for (const { plugin } of this._plugins.values()) if (typeof plugin.uninstall === "function") try {
+				plugin.uninstall(this);
+			} catch (_) {}
+			this._plugins.clear();
 			this._disposers.forEach((d) => d());
 			this._disposers = [];
 			const container = this.layoutInfo.container;
@@ -15888,7 +15990,27 @@
 		registerModule(name, ModuleClass) {
 			_customModules.set(name, ModuleClass);
 		},
-		version: "1.1.1"
+		use(plugin, options = {}) {
+			if (!plugin || typeof plugin.name !== "string") throw new TypeError("[AutumnNote] AutumnNote.use: plugin must have a string `name` property.");
+			if (_globalPlugins.has(plugin.name)) {
+				console.warn(`[AutumnNote] Plugin "${plugin.name}" already registered globally. Skipping.`);
+				return this;
+			}
+			if (Array.isArray(plugin.buttons)) plugin.buttons.forEach((b) => registerButton(b));
+			_globalPlugins.set(plugin.name, {
+				plugin,
+				options
+			});
+			return this;
+		},
+		hasPlugin(name) {
+			return _globalPlugins.has(name);
+		},
+		registerButton(btnDef) {
+			registerButton(btnDef);
+			return this;
+		},
+		version: "1.4.0"
 	};
 	/**
 	* @param {string|Element|NodeList|Element[]} selector