suneditor 3.0.0-beta.3 → 3.0.0-beta.30

package/src/modules/SelectMenu.js

@@ -1,6 +1,7 @@
 import CoreInjector from '../editorInjector/_core';
 import { dom, env, keyCodeMap } from '../helper';
 
+const { _w } = env;
 const MENU_MIN_HEIGHT = 38;
 
 /**
@@ -18,6 +19,19 @@ const MENU_MIN_HEIGHT = 38;
  * @description Creates a select menu
  */
 class SelectMenu extends CoreInjector {
+	#dirPosition;
+	#dirSubPosition;
+	#textDirDiff;
+	#refer;
+	#keydownTarget;
+	#selectMethod;
+	#bindClose_key;
+	#bindClose_mousedown;
+	#bindClose_click;
+	#events;
+	#eventHandlers;
+	#globalEventHandlers;
+
 	/**
 	 * @constructor
 	 * @param {*} inst The instance object that called the constructor.
@@ -42,28 +56,28 @@ class SelectMenu extends CoreInjector {
 		this.checkList = !!params.checkList;
 		this.position = positionItems[0];
 		this.subPosition = positionItems[1];
-		this._dirPosition = /^(left|right)$/.test(this.position) ? (this.position === 'left' ? 'right' : 'left') : this.position;
-		this._dirSubPosition = /^(left|right)$/.test(this.subPosition) ? (this.subPosition === 'left' ? 'right' : 'left') : this.subPosition;
-		this._textDirDiff = params.dir === 'ltr' ? false : params.dir === 'rtl' ? true : null;
 		this.splitNum = params.splitNum || 0;
 		this.horizontal = !!this.splitNum;
 		this.openMethod = params.openMethod;
 		this.closeMethod = params.closeMethod;
-		this._refer = null;
-		this._keydownTarget = null;
-		this._selectMethod = null;
-		this._bindClose_key = null;
-		this._bindClose_mousedown = null;
-		this._bindClose_click = null;
-		this._closeSignal = false;
-		this.__events = null;
-		this.__eventHandlers = {
+
+		this.#dirPosition = /^(left|right)$/.test(this.position) ? (this.position === 'left' ? 'right' : 'left') : this.position;
+		this.#dirSubPosition = /^(left|right)$/.test(this.subPosition) ? (this.subPosition === 'left' ? 'right' : 'left') : this.subPosition;
+		this.#textDirDiff = params.dir === 'ltr' ? false : params.dir === 'rtl' ? true : null;
+		this.#refer = null;
+		this.#keydownTarget = null;
+		this.#selectMethod = null;
+		this.#bindClose_key = null;
+		this.#bindClose_mousedown = null;
+		this.#bindClose_click = null;
+		this.#events = null;
+		this.#eventHandlers = {
 			mousedown: this.#OnMousedown_list.bind(this),
 			mousemove: this.#OnMouseMove_list.bind(this),
 			click: this.#OnClick_list.bind(this),
 			keydown: this.#OnKeyDown_refer.bind(this)
 		};
-		this.__globalEventHandlers = { keydown: this.#CloseListener_key.bind(this), mousedown: this.#CloseListener_mousedown.bind(this), click: this.#CloseListener_click.bind(this) };
+		this.#globalEventHandlers = { keydown: this.#CloseListener_key.bind(this), mousedown: this.#CloseListener_mousedown.bind(this), click: this.#CloseListener_click.bind(this) };
 	}
 
 	/**
@@ -73,16 +87,16 @@ class SelectMenu extends CoreInjector {
 	 */
 	create(items, menus) {
 		this.form.firstElementChild.innerHTML = '';
-		menus = menus || items;
+		menus ||= items;
 		let html = '';
 		for (let i = 0, len = menus.length; i < len; i++) {
 			if (i > 0 && i % this.splitNum === 0) {
-				this._createFormat(html);
+				this.#createFormat(html);
 				html = '';
 			}
 			html += `<li class="se-select-item" data-index="${i}">${typeof menus[i] === 'string' ? menus[i] : /** @type {HTMLElement} */ (menus[i]).outerHTML}</li>`;
 		}
-		this._createFormat(html);
+		this.#createFormat(html);
 
 		this.items = /** @type {Array<string|Node>} */ (items);
 		this.menus = Array.from(this.form.querySelectorAll('li'));
@@ -95,11 +109,10 @@ class SelectMenu extends CoreInjector {
 	 * @param {(command: string) => void} selectMethod - The function to execute when an item is selected.
 	 * @param {{class?: string, style?: string}} [attr={}] - Additional attributes for the select menu container.
 	 */
-	on(referElement, selectMethod, attr) {
-		if (!attr) attr = {};
-		this._refer = /** @type {HTMLElement} */ (referElement);
-		this._keydownTarget = dom.check.isInputElement(referElement) ? referElement : this._w;
-		this._selectMethod = selectMethod;
+	on(referElement, selectMethod, attr = {}) {
+		this.#refer = /** @type {HTMLElement} */ (referElement);
+		this.#keydownTarget = dom.check.isInputElement(referElement) ? referElement : this.frameContext.get('_ww');
+		this.#selectMethod = selectMethod;
 		this.form = dom.utils.createElement(
 			'DIV',
 			{
@@ -119,12 +132,12 @@ class SelectMenu extends CoreInjector {
 	open(position, onItemQuerySelector) {
 		this.editor.selectMenuOn = true;
 		if (typeof this.openMethod === 'function') this.openMethod();
-		this.__addEvents();
-		this.__addGlobalEvent();
+		this.#addEvents();
+		this.#addGlobalEvent();
 		const positionItems = position ? position.split('-') : [];
-		const mainPosition = positionItems[0] || (this._textDirDiff !== null && this._textDirDiff !== this.options.get('_rtl') ? this._dirPosition : this.position);
-		const subPosition = positionItems[1] || (this._textDirDiff !== null && this._textDirDiff !== this.options.get('_rtl') ? this._dirSubPosition : this.subPosition);
-		this._setPosition(mainPosition, subPosition, onItemQuerySelector);
+		const mainPosition = positionItems[0] || (this.#textDirDiff !== null && this.#textDirDiff !== this.options.get('_rtl') ? this.#dirPosition : this.position);
+		const subPosition = positionItems[1] || (this.#textDirDiff !== null && this.#textDirDiff !== this.options.get('_rtl') ? this.#dirSubPosition : this.subPosition);
+		this.#setPosition(mainPosition, subPosition, onItemQuerySelector);
 		this.isOpen = true;
 	}
 
@@ -133,9 +146,9 @@ class SelectMenu extends CoreInjector {
 	 */
 	close() {
 		this.editor.selectMenuOn = false;
-		dom.utils.removeClass(this._refer, 'on');
-		this._init();
-		if (this.form) this.form.style.cssText = '';
+		dom.utils.removeClass(this.#refer, 'on');
+		this.#init();
+		this.form?.removeAttribute('style');
 		this.isOpen = false;
 		if (typeof this.closeMethod === 'function') this.closeMethod();
 	}
@@ -154,25 +167,23 @@ class SelectMenu extends CoreInjector {
 	 * @param {number} index Item index
 	 */
 	setItem(index) {
-		this._selectItem(index);
+		this.#selectItem(index);
 	}
 
 	/**
-	 * @private
 	 * @description Appends a formatted list of items to the menu.
 	 * @param {string} html - The HTML string representing the menu items.
 	 */
-	_createFormat(html) {
+	#createFormat(html) {
 		this.form.firstElementChild.innerHTML += `<ul class="se-list-basic se-list-checked${this.horizontal ? ' se-list-horizontal' : ''}">${html}</ul>`;
 	}
 
 	/**
-	 * @private
 	 * @description Resets the menu state and removes event listeners.
 	 */
-	_init() {
-		this.__removeEvents();
-		this.__removeGlobalEvent();
+	#init() {
+		this.#removeEvents();
+		this.#removeGlobalEvent();
 		this.index = -1;
 		this.item = null;
 		if (this._onItem) {
@@ -182,24 +193,22 @@ class SelectMenu extends CoreInjector {
 	}
 
 	/**
-	 * @private
 	 * @description Moves the selection up or down by a specified number of items.
 	 * @param {number} num - The number of items to move (negative for up, positive for down).
 	 */
-	_moveItem(num) {
+	#moveItem(num) {
 		num = this.index + num;
 		const len = this.menuLen;
 		const selectIndex = (this.index = num >= len ? 0 : num < 0 ? len - 1 : num);
 
-		this._selectItem(selectIndex);
+		this.#selectItem(selectIndex);
 	}
 
 	/**
-	 * @private
 	 * @description Highlights and selects an item by index.
 	 * @param {number} selectIndex - The index of the item to select.
 	 */
-	_selectItem(selectIndex) {
+	#selectItem(selectIndex) {
 		dom.utils.removeClass(this.form, 'se-select-menu-mouse-move');
 
 		const len = this.menuLen;
@@ -216,17 +225,16 @@ class SelectMenu extends CoreInjector {
 	}
 
 	/**
-	 * @private
 	 * @description Sets the position of the select menu relative to the reference element.
 	 * @param {string} position Menu position ("left"|"right") | ("top"|"bottom")
 	 * @param {string} subPosition Sub position ("middle"|"top"|"bottom") | ("center"|"left"|"right")
 	 * @param {string} [onItemQuerySelector] - A query selector string to highlight a specific item.
 	 * @param {boolean} [_re=false] - Whether this is a retry after adjusting the position.
 	 */
-	_setPosition(position, subPosition, onItemQuerySelector, _re) {
+	#setPosition(position, subPosition, onItemQuerySelector, _re) {
 		const originP = position;
 		const form = this.form;
-		const target = this._refer;
+		const target = this.#refer;
 		form.style.visibility = 'hidden';
 		form.style.display = 'block';
 		dom.utils.removeClass(form, 'se-select-menu-scroll');
@@ -254,7 +262,7 @@ class SelectMenu extends CoreInjector {
 		const targetOffsetTop = target.offsetTop;
 		const targetGlobalTop = globalTarget.top;
 		const targetHeight = target.offsetHeight;
-		const wbottom = dom.utils.getClientSize().h - (targetGlobalTop - this._w.scrollY + targetHeight);
+		const wbottom = dom.utils.getClientSize().h - (targetGlobalTop - _w.scrollY + targetHeight);
 		const sideAddH = side ? targetHeight : 0;
 		let overH = 10000;
 		switch (position) {
@@ -308,7 +316,7 @@ class SelectMenu extends CoreInjector {
 		}
 
 		if (overH < MENU_MIN_HEIGHT && !_re && position !== 'middle') {
-			this._setPosition(position === 'top' ? 'bottpm' : 'top', subPosition, onItemQuerySelector, true);
+			this.#setPosition(position === 'top' ? 'bottpm' : 'top', subPosition, onItemQuerySelector, true);
 			return;
 		}
 
@@ -331,15 +339,15 @@ class SelectMenu extends CoreInjector {
 		let overW = 0;
 		switch (side + '-' + (side ? originP : subPosition)) {
 			case 'true-left':
-				overW = globalTarget.left - this._w.scrollX + fl;
+				overW = globalTarget.left - _w.scrollX + fl;
 				if (overW < 0) l = l = targetL + targetW + 1;
 				break;
 			case 'true-right':
-				overW = this._w.innerWidth - (fl + formW);
+				overW = _w.innerWidth - (fl + formW);
 				if (overW < 0) l = targetL - formW - 1;
 				break;
 			case 'false-center': {
-				overW = this._w.innerWidth - (fl + formW);
+				overW = _w.innerWidth - (fl + formW);
 				if (overW < 0) l += overW - 4;
 				form.style.left = l + 'px';
 				const centerfl = this.editor.offset.getGlobal(form).left;
@@ -347,7 +355,7 @@ class SelectMenu extends CoreInjector {
 				break;
 			}
 			case 'false-left':
-				overW = this._w.innerWidth - (globalTarget.left - this._w.scrollX + formW);
+				overW = _w.innerWidth - (globalTarget.left - _w.scrollX + formW);
 				if (overW < 0) l += overW - 4;
 				break;
 			case 'false-right':
@@ -369,59 +377,54 @@ class SelectMenu extends CoreInjector {
 	}
 
 	/**
-	 * @private
 	 * @description Selects an item and triggers the callback function.
 	 * @param {number} index - The index of the item to select.
 	 */
-	_select(index) {
+	#select(index) {
 		if (this.checkList) dom.utils.toggleClass(this.menus[index], 'se-checked');
-		this._selectMethod(this.getItem(index));
+		this.#selectMethod(this.getItem(index));
 	}
 
 	/**
-	 * @private
 	 * @description Adds event listeners for menu interactions.
 	 */
-	__addEvents() {
-		this.__removeEvents();
-		this.__events = this.__eventHandlers;
-		this.form.addEventListener('mousedown', this.__events.mousedown);
-		this.form.addEventListener('mousemove', this.__events.mousemove);
-		this.form.addEventListener('click', this.__events.click);
-		this._keydownTarget.addEventListener('keydown', this.__events.keydown);
+	#addEvents() {
+		this.#removeEvents();
+		this.#events = this.#eventHandlers;
+		this.form.addEventListener('mousedown', this.#events.mousedown);
+		this.form.addEventListener('mousemove', this.#events.mousemove);
+		this.form.addEventListener('click', this.#events.click);
+		this.#keydownTarget.addEventListener('keydown', this.#events.keydown);
 	}
 
 	/**
-	 * @private
 	 * @description Removes event listeners for menu interactions.
 	 */
-	__removeEvents() {
-		if (!this.__events) return;
-		this.form.removeEventListener('mousedown', this.__events.mousedown);
-		this.form.removeEventListener('mousemove', this.__events.mousemove);
-		this.form.removeEventListener('click', this.__events.click);
-		this._keydownTarget.removeEventListener('keydown', this.__events.keydown);
-		this.__events = null;
+	#removeEvents() {
+		if (!this.#events) return;
+		this.form.removeEventListener('mousedown', this.#events.mousedown);
+		this.form.removeEventListener('mousemove', this.#events.mousemove);
+		this.form.removeEventListener('click', this.#events.click);
+		this.#keydownTarget.removeEventListener('keydown', this.#events.keydown);
+		this.#events = null;
 	}
 
 	/**
-	 * @private
 	 * @description Adds global event listeners for closing the menu.
 	 */
-	__addGlobalEvent() {
-		this.__removeGlobalEvent();
-		this._bindClose_key = this.eventManager.addGlobalEvent('keydown', this.__globalEventHandlers.keydown, true);
-		this._bindClose_mousedown = this.eventManager.addGlobalEvent('mousedown', this.__globalEventHandlers.mousedown, true);
+	#addGlobalEvent() {
+		this.#removeGlobalEvent();
+		this.#bindClose_key = this.eventManager.addGlobalEvent('keydown', this.#globalEventHandlers.keydown, true);
+		this.#bindClose_mousedown = this.eventManager.addGlobalEvent('mousedown', this.#globalEventHandlers.mousedown, true);
 	}
 
 	/**
-	 * @private
 	 * @description Removes global event listeners for closing the menu.
 	 */
-	__removeGlobalEvent() {
-		if (this._bindClose_key) this._bindClose_key = this.eventManager.removeGlobalEvent(this._bindClose_key);
-		if (this._bindClose_mousedown) this._bindClose_mousedown = this.eventManager.removeGlobalEvent(this._bindClose_mousedown);
-		if (this._bindClose_click) this._bindClose_click = this.eventManager.removeGlobalEvent(this._bindClose_click);
+	#removeGlobalEvent() {
+		this.#bindClose_key &&= this.eventManager.removeGlobalEvent(this.#bindClose_key);
+		this.#bindClose_mousedown &&= this.eventManager.removeGlobalEvent(this.#bindClose_mousedown);
+		this.#bindClose_click &&= this.eventManager.removeGlobalEvent(this.#bindClose_click);
 	}
 
 	/**
@@ -465,14 +468,14 @@ class SelectMenu extends CoreInjector {
 				if (this.index > -1) {
 					e.preventDefault();
 					e.stopPropagation();
-					this._select(this.index);
+					this.#select(this.index);
 				} else {
 					this.close();
 				}
 				break;
 		}
 
-		if (moveIndex) this._moveItem(moveIndex);
+		if (moveIndex) this.#moveItem(moveIndex);
 	}
 
 	/**
@@ -510,7 +513,7 @@ class SelectMenu extends CoreInjector {
 		}
 
 		if (!index) return;
-		this._select(Number(index));
+		this.#select(Number(index));
 	}
 
 	/**
@@ -527,10 +530,10 @@ class SelectMenu extends CoreInjector {
 	#CloseListener_mousedown(e) {
 		const eventTarget = dom.query.getEventTarget(e);
 		if (this.form.contains(eventTarget)) return;
-		if (e.target !== this._refer) {
+		if (e.target !== this.#refer) {
 			this.close();
 		} else if (!dom.check.isInputElement(eventTarget)) {
-			this._bindClose_click = this.eventManager.addGlobalEvent('click', this.__globalEventHandlers.click, true);
+			this.#bindClose_click = this.eventManager.addGlobalEvent('click', this.#globalEventHandlers.click, true);
 		}
 	}
 
@@ -538,8 +541,8 @@ class SelectMenu extends CoreInjector {
 	 * @param {MouseEvent} e - Event object
 	 */
 	#CloseListener_click(e) {
-		this._bindClose_click = this.eventManager.removeGlobalEvent(this._bindClose_click);
-		if (e.target === this._refer) {
+		this.#bindClose_click = this.eventManager.removeGlobalEvent(this.#bindClose_click);
+		if (e.target === this.#refer) {
 			e.stopPropagation();
 			this.close();
 		}

package/src/plugins/browser/audioGallery.js

@@ -5,6 +5,14 @@ import { Browser } from '../../modules';
  * @typedef {import('../../modules/Browser').BrowserFile} BrowserFile_audioGallery
  */
 
+/**
+ * @typedef {Object} AudioGalleryPluginOptions
+ * @property {Array<BrowserFile_audioGallery>} [data] - Direct data without server calls
+ * @property {string} [url] - Server request URL
+ * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string|((item: BrowserFile_audioGallery) => string)} [thumbnail] - Default thumbnail
+ */
+
 /**
  * @class
  * @extends EditorInjector
@@ -18,11 +26,7 @@ class AudioGallery extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<*>=} pluginOptions.data - direct data without server calls
-	 * @param {string} pluginOptions.url - server request url
-	 * @param {Object<string, string>=} pluginOptions.headers - server request headers
-	 * @param {string|((item: BrowserFile_audioGallery) => string)} pluginOptions.thumbnail - default thumbnail
+	 * @param {AudioGalleryPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
 		// plugin bisic properties

package/src/plugins/browser/fileBrowser.js

@@ -5,6 +5,15 @@ import { Browser } from '../../modules';
  * @typedef {import('../../modules/Browser').BrowserFile} BrowserFile_fileBrowser
  */
 
+/**
+ * @typedef {Object} FileBrowserPluginOptions
+ * @property {Object<string, *>|Array<*>} [data] - Direct data without server calls
+ * @property {string} [url] - Server request URL
+ * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string|((item: BrowserFile_fileBrowser) => string)} [thumbnail] - Default thumbnail
+ * @property {Array<string>} [props] - Additional tag names
+ */
+
 /**
  * @class
  * @extends EditorInjector
@@ -18,12 +27,7 @@ class FileBrowser extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Object<string, *>|Array<*>=} pluginOptions.data - direct data without server calls
-	 * @param {string} pluginOptions.url - server request url
-	 * @param {Object<string, string>=} pluginOptions.headers - server request headers
-	 * @param {string|((item: BrowserFile_fileBrowser) => string)} pluginOptions.thumbnail - default thumbnail
-	 * @param {Array<string>} pluginOptions.props - additional tag names
+	 * @param {FileBrowserPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
 		// plugin bisic properties

package/src/plugins/browser/fileGallery.js

@@ -5,6 +5,14 @@ import { Browser } from '../../modules';
  * @typedef {import('../../modules/Browser').BrowserFile} BrowserFile_fileGallery
  */
 
+/**
+ * @typedef {Object} FileGalleryPluginOptions
+ * @property {Array<BrowserFile_fileGallery>} [data] - Direct data without server calls
+ * @property {string} [url] - Server request URL
+ * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string|((item: BrowserFile_fileGallery) => string)} [thumbnail] - Default thumbnail
+ */
+
 /**
  * @class
  * @extends EditorInjector
@@ -18,11 +26,7 @@ class FileGallery extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<*>=} pluginOptions.data - direct data without server calls
-	 * @param {string} pluginOptions.url - server request url
-	 * @param {Object<string, string>=} pluginOptions.headers - server request headers
-	 * @param {string|((item: BrowserFile_fileGallery) => string)} pluginOptions.thumbnail - default thumbnail
+	 * @param {FileGalleryPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
 		// plugin bisic properties

package/src/plugins/browser/imageGallery.js

@@ -1,6 +1,13 @@
 import EditorInjector from '../../editorInjector';
 import { Browser } from '../../modules';
 
+/**
+ * @typedef ImageGalleryPluginOptions
+ * @property {Array<*>} [data] - Direct data without server calls
+ * @property {string} [url] - Server request URL
+ * @property {Object<string, string>} [headers] - Server request headers
+ */
+
 /**
  * @class
  * @extends EditorInjector
@@ -14,10 +21,7 @@ class ImageGallery extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<*>=} pluginOptions.data - direct data without server calls
-	 * @param {string=} pluginOptions.url - server request url
-	 * @param {Object<string, string>=} pluginOptions.headers - server request headers
+	 * @param {ImageGalleryPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
 		// plugin bisic properties
@@ -73,7 +77,7 @@ class ImageGallery extends EditorInjector {
 		} else {
 			const file = { name: target.getAttribute('data-name'), size: 0 };
 			this.plugins.image.init();
-			this.plugins.image.create(target.getAttribute('data-command'), null, this.width, this.height, 'none', file, target.alt);
+			this.plugins.image.create(target.getAttribute('data-command'), null, this.width, this.height, 'none', file, target.alt, true);
 		}
 	}
 }

package/src/plugins/browser/videoGallery.js

@@ -5,6 +5,14 @@ import { Browser } from '../../modules';
  * @typedef {import('../../modules/Browser').BrowserFile} BrowserFile_videoGallery
  */
 
+/**
+ * @typedef {Object} VideoGalleryPluginOptions
+ * @property {Array<BrowserFile_videoGallery>} [data] - Direct data without server calls
+ * @property {string} [url] - Server request URL
+ * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string|((item: BrowserFile_videoGallery) => string)} [thumbnail] - Default thumbnail
+ */
+
 /**
  * @class
  * @extends EditorInjector
@@ -18,11 +26,7 @@ class VideoGallery extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<*>=} pluginOptions.data - direct data without server calls
-	 * @param {string=} pluginOptions.url - server request url
-	 * @param {Object<string, string>=} pluginOptions.headers - server request headers
-	 * @param {string|((item: BrowserFile_videoGallery) => string)} pluginOptions.thumbnail - default thumbnail
+	 * @param {VideoGalleryPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
 		// plugin bisic properties
@@ -94,7 +98,8 @@ class VideoGallery extends EditorInjector {
 				this.width,
 				this.height,
 				false,
-				file
+				file,
+				true
 			);
 		}
 	}

package/src/plugins/command/blockquote.js

@@ -30,6 +30,7 @@ class Blockquote extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element, target) {
 		if (/blockquote/i.test(element?.nodeName)) {

package/src/plugins/command/exportPDF.js

@@ -4,6 +4,12 @@ import { ApiManager } from '../../modules';
 
 const { _w, _d } = env;
 
+/**
+ * @typedef ExportPDFPluginOptions
+ * @property {string} apiUrl - Server request URL for PDF generation
+ * @property {string} [fileName="suneditor-pdf"] - Name of the generated PDF file
+ */
+
 /**
  * @class
  * @description Export PDF plugin
@@ -16,9 +22,7 @@ class ExportPDF extends EditorInjector {
 	/**
 	 * @constructor
 	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions - plugin options
-	 * @param {string} pluginOptions.apiUrl - server request url
-	 * @param {string} pluginOptions.fileName - file name
+	 * @param {ExportPDFPluginOptions} pluginOptions - plugin options
 	 */
 	constructor(editor, pluginOptions) {
 		super(editor);
@@ -61,11 +65,11 @@ class ExportPDF extends EditorInjector {
 		let ww = null;
 
 		try {
-			const standardWW = this.editor.frameContext.get('documentTypePageMirror') || this.editor.frameContext.get('wysiwygFrame');
+			const standardWW = this.frameContext.get('documentTypePageMirror') || this.frameContext.get('wysiwygFrame');
 			const editableDiv = dom.utils.createElement('div', { class: standardWW.className }, standardWW.innerHTML);
 			ww = dom.utils.createElement('div', { style: `position: absolute; top: -10000px; left: -10000px; width: 21cm; columns: 21cm; height: auto;` }, editableDiv);
 
-			const innerPadding = this._w.getComputedStyle(standardWW).padding;
+			const innerPadding = _w.getComputedStyle(standardWW).padding;
 			const inlineWW = dom.utils.applyInlineStylesAll(editableDiv, true, this.options.get('allUsedStyles'));
 			inlineWW.style.padding = inlineWW.style.paddingTop = inlineWW.style.paddingBottom = inlineWW.style.paddingLeft = inlineWW.style.paddingRight = '0';
 			ww.innerHTML = `
@@ -83,7 +87,7 @@ class ExportPDF extends EditorInjector {
 			if ((await this.triggerEvent('onExportPDFBefore', { target: ww })) === false) return;
 
 			// at server
-			await this._createByServer(ww);
+			await this.#createByServer(ww);
 			return;
 		} catch (error) {
 			console.error('[SUNEDITOR.plugins.exportPDF.error]', error.message);
@@ -94,13 +98,12 @@ class ExportPDF extends EditorInjector {
 	}
 
 	/**
-	 * @private
 	 * @description Sends the editor content to the server for PDF generation.
 	 * @param {HTMLElement} ww - A temporary container holding the formatted editor content.
 	 * @returns {Promise<void>} Resolves when the PDF file is successfully downloaded.
 	 * @throws {Error} Throws an error if the server response indicates a failure.
 	 */
-	async _createByServer(ww) {
+	async #createByServer(ww) {
 		const data = {
 			fileName: this.fileName,
 			htmlContent: ww.innerHTML