autumnnote 1.4.2 → 1.5.0

package/dist/autumnnote.umd.js

@@ -922,13 +922,6 @@
 		}
 	};
 	var removeFormatBtn = btn("removeFormat", "remove-format", "Remove Format", () => execCommand("removeFormat"));
-	btn("direction", "direction", "Toggle Text Direction (LTR / RTL)", (ctx) => {
-		const editable = ctx.layoutInfo.editable;
-		const next = (editable.getAttribute("dir") || "ltr") === "ltr" ? "rtl" : "ltr";
-		editable.setAttribute("dir", next);
-		editable.style.textAlign = next === "rtl" ? "right" : "left";
-		ctx.invoke("editor.afterCommand");
-	});
 	/** @type {DropdownDef} */
 	var fontFamilyBtn = {
 		name: "fontFamily",
@@ -1048,7 +1041,6 @@
 	var fullscreenBtn = btn("fullscreen", "expand", "Fullscreen", (ctx) => ctx.invoke("fullscreen.toggle"), (ctx) => ctx.invoke("fullscreen.isActive"));
 	var shortcutsBtn = btn("shortcuts", "keyboard", "Keyboard Shortcuts (Ctrl+Shift+/)", (ctx) => ctx.invoke("shortcutsDialog.show"));
 	var findBtn = btn("find", "search", "Find (Ctrl+F)", (ctx) => ctx.invoke("findReplace.show", "find"));
-	btn("findReplace", "find-replace", "Find & Replace (Ctrl+H)", (ctx) => ctx.invoke("findReplace.show", "replace"));
 	var inlineCodeBtn = btn("inlineCode", "inline-code", "Inline Code (Ctrl+`)", (ctx) => ctx.invoke("editor.inlineCode"), () => isInlineCode());
 	var checklistBtn = btn("checklist", "checklist", "Checklist", (ctx) => ctx.invoke("editor.toggleChecklist"), () => isInChecklist());
 	var printBtn = btn("print", "print", "Print", (ctx) => ctx.invoke("editor.print"));
@@ -1295,6 +1287,7 @@
 			chooseHighlightColor: "Choose highlight color",
 			customColor: "Custom color",
 			insertTableLabel: "Insert Table",
+			/** Map of paragraph-style value → label (only values needing translation) */
 			paragraphItems: {
 				p: "Normal",
 				blockquote: "Quote",
@@ -1337,6 +1330,7 @@
 			widthPlaceholder: "560",
 			insertBtn: "Insert",
 			cancelBtn: "Cancel",
+			/** @param {string} type */
 			detected: (type) => `Detected: ${type}`,
 			unknownFormat: "Unknown format — will try direct video embed",
 			invalidUrl: "Invalid URL — please enter a valid video link."
@@ -1499,9 +1493,13 @@
 		},
 		statusbar: {
 			resizeHandle: "Resize editor",
+			/** @param {number} n */
 			words: (n) => `Words: ${n}`,
+			/** @param {number} n @param {number} max */
 			wordsLimit: (n, max) => `Words: ${n}/${max}`,
+			/** @param {number} n */
 			chars: (n) => `Chars: ${n}`,
+			/** @param {number} n @param {number} max */
 			charsLimit: (n, max) => `Chars: ${n}/${max}`
 		},
 		tooltips: {
@@ -1574,7 +1572,9 @@
 			}
 		},
 		errors: {
+			/** @param {string} type */
 			imageFormat: (type) => `Format "${type}" is not supported for display in web browsers. Please convert to JPEG, PNG, or WebP first.`,
+			/** @param {number} maxSize */
 			imageSize: (maxSize) => `Image file is too large. Maximum allowed size is ${maxSize} MB.`
 		}
 	};
@@ -15961,6 +15961,13 @@
 	/** @type {WeakMap<Element, Context>} */
 	var instances = /* @__PURE__ */ new WeakMap();
 	var AutumnNote = {
+		/**
+		* Creates (or returns existing) editor instance on one or more elements.
+		*
+		* @param {string|Element|NodeList|Element[]} selector
+		* @param {import('./settings.js').AsnOptions} [options]
+		* @returns {Context|Context[]} single Context or array of Contexts
+		*/
 		create(selector, options = {}) {
 			const ctxs = resolveElements(selector).map((el) => {
 				if (instances.has(el)) return instances.get(el);
@@ -15971,6 +15978,10 @@
 			});
 			return ctxs.length === 1 ? ctxs[0] : ctxs;
 		},
+		/**
+		* Destroys the editor(s) on the given selector.
+		* @param {string|Element|NodeList|Element[]} selector
+		*/
 		destroy(selector) {
 			resolveElements(selector).forEach((el) => {
 				const ctx = instances.get(el);
@@ -15980,23 +15991,45 @@
 				}
 			});
 		},
+		/**
+		* Returns the Context instance for a given element (or null).
+		* @param {string|Element} selector
+		* @returns {Context|null}
+		*/
 		getInstance(selector) {
 			const el = typeof selector === "string" ? document.querySelector(selector) : selector;
 			return el ? instances.get(el) || null : null;
 		},
+		/** Returns a shallow copy of the default options (read-only snapshot). */
 		get defaults() {
 			return { ...defaultOptions };
 		},
+		/** Merges properties into the global defaults, applied to all future instances. */
 		setDefaults(overrides) {
 			Object.assign(defaultOptions, overrides);
 		},
+		/** Restores global defaults to their original factory values. */
 		resetDefaults() {
 			Object.keys(defaultOptions).forEach((k) => delete defaultOptions[k]);
 			Object.assign(defaultOptions, _originalDefaults);
 		},
+		/**
+		* Registers a custom module to be included in every new editor instance.
+		* @param {string} name - unique module key used for ctx.invoke() calls
+		* @param {Function} ModuleClass - class with initialize() and optional destroy()
+		*/
 		registerModule(name, ModuleClass) {
 			_customModules.set(name, ModuleClass);
 		},
+		/**
+		* Installs a plugin globally — applied to every future editor instance.
+		* Plugin `buttons` are registered to the global button registry immediately
+		* so they are available when Toolbar initialises inside create().
+		* Plugin `install()` is called after all built-in modules have initialised.
+		* @param {object} plugin - { name, version?, buttons?, install?, uninstall? }
+		* @param {object} [options] - Forwarded to plugin.install(context, options)
+		* @returns {typeof AutumnNote}
+		*/
 		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)) {
@@ -16010,14 +16043,26 @@
 			});
 			return this;
 		},
+		/**
+		* Returns true if a plugin with the given name has been registered globally.
+		* @param {string} name
+		* @returns {boolean}
+		*/
 		hasPlugin(name) {
 			return _globalPlugins.has(name);
 		},
+		/**
+		* Registers a single button definition in the global button registry.
+		* After create(), call ctx.invoke('toolbar.rebuild') to render new buttons.
+		* @param {object} btnDef - ButtonDef-compatible object with a `name` string
+		* @returns {typeof AutumnNote}
+		*/
 		registerButton(btnDef) {
 			registerButton(btnDef);
 			return this;
 		},
-		version: "1.4.2"
+		/** Library version */
+		version: "1.5.0"
 	};
 	/**
 	* @param {string|Element|NodeList|Element[]} selector