suneditor 3.0.0-beta.9 → 3.0.0-rc.2

package/src/plugins/modal/audio.js

@@ -1,37 +1,39 @@
-import EditorInjector from '../../editorInjector';
-import { Modal, Controller, FileManager, Figure, _DragHandle } from '../../modules';
+import { PluginModal } from '../../interfaces';
+import { Modal, Controller, Figure } from '../../modules/contract';
+import { FileManager } from '../../modules/manager';
+import { _DragHandle } from '../../modules/ui';
 import { dom, numbers, env } from '../../helper';
 const { NO_EVENT, ON_OVER_COMPONENT } = env;
 
-/**
- * @typedef {import('../../events').AudioInfo} AudioInfo_audio
- */
-
 /**
  * @typedef {Object} AudioPluginOptions
- * @property {string} [defaultWidth="300px"] - The default width of the audio tag (e.g., "300px").
- * @property {string} [defaultHeight="150px"] - The default height of the audio tag (e.g., "150px").
+ * @property {string} [defaultWidth="300px"] - The default width of the `AUDIO` tag (e.g., `"300px"`).
+ * @property {string} [defaultHeight="150px"] - The default height of the `AUDIO` tag (e.g., `"150px"`).
  * @property {boolean} [createFileInput] - Whether to create a file input element.
- * @property {boolean} [createUrlInput] - Whether to create a URL input element (default is true if file input is not created).
+ * @property {boolean} [createUrlInput] - Whether to create a URL input element (default is `true` if file input is not created).
  * @property {string} [uploadUrl] - The URL to which files will be uploaded.
  * @property {Object<string, string>} [uploadHeaders] - Headers to include in the file upload request.
  * @property {number} [uploadSizeLimit] - The total upload size limit in bytes.
  * @property {number} [uploadSingleSizeLimit] - The single file size limit in bytes.
  * @property {boolean} [allowMultiple] - Whether to allow multiple file uploads.
- * @property {string} [acceptedFormats="audio/*"] - Accepted file formats (default is "audio/*").
- * @property {Object<string, string>} [audioTagAttributes] - Additional attributes to set on the audio tag.
+ * @property {string} [acceptedFormats="audio/*"] - Accepted file formats (default is `"audio/*"`).
+ * @property {Object<string, string>} [audioTagAttributes] - Additional attributes to set on the `AUDIO` tag.
+ * @property {SunEditor.ComponentInsertType} [insertBehavior] - Component insertion behavior for selection and cursor placement. [default: `options.get('componentInsertBehavior')`]
+ * - `auto`: Move cursor to the next line if possible, otherwise select the component.
+ * - `select`: Always select the inserted component.
+ * - `line`: Move cursor to the next line if possible, or create a new line and move there.
+ * - `none`: Do nothing.
  */
 
 /**
  * @class
  * @description Audio modal plugin.
  */
-class Audio_ extends EditorInjector {
+class Audio_ extends PluginModal {
 	static key = 'audio';
-	static type = 'modal';
 	static className = '';
+
 	/**
-	 * @this {Audio_}
 	 * @param {HTMLElement} node - The node to check.
 	 * @returns {HTMLElement|null} Returns a node if the node is a valid component.
 	 */
@@ -39,15 +41,20 @@ class Audio_ extends EditorInjector {
 		return /^AUDIO$/i.test(node?.nodeName) ? node : null;
 	}
 
+	#defaultWidth;
+	#defaultHeight;
+	#urlValue = '';
+	#element = null;
+
 	/**
 	 * @constructor
-	 * @param {__se__EditorCore} editor - The root editor instance
+	 * @param {SunEditor.Kernel} editor - The core kernel
 	 * @param {AudioPluginOptions} pluginOptions
 	 */
 	constructor(editor, pluginOptions) {
-		// plugin bisic properties
+		// plugin basic properties
 		super(editor);
-		this.title = this.lang.audio;
+		this.title = this.$.lang.audio;
 		this.icon = 'audio';
 
 		// define plugin options
@@ -62,24 +69,25 @@ class Audio_ extends EditorInjector {
 			uploadSingleSizeLimit: numbers.get(pluginOptions.uploadSingleSizeLimit, 0),
 			allowMultiple: !!pluginOptions.allowMultiple,
 			acceptedFormats: typeof pluginOptions.acceptedFormats !== 'string' || pluginOptions.acceptedFormats.trim() === '*' ? 'audio/*' : pluginOptions.acceptedFormats.trim() || 'audio/*',
-			audioTagAttributes: pluginOptions.audioTagAttributes || null
+			audioTagAttributes: pluginOptions.audioTagAttributes || null,
+			insertBehavior: pluginOptions.insertBehavior,
 		};
 
 		// create HTML
-		const modalEl = CreateHTML_modal(editor, this.pluginOptions);
-		const controllerEl = CreateHTML_controller(editor);
+		const modalEl = CreateHTML_modal(this.$, this.pluginOptions);
+		const controllerEl = CreateHTML_controller(this.$);
 
 		// modules
-		this.modal = new Modal(this, modalEl);
-		this.controller = new Controller(this, controllerEl, { position: 'bottom', disabled: true });
-		this.fileManager = new FileManager(this, {
+		this.modal = new Modal(this, this.$, modalEl);
+		this.controller = new Controller(this, this.$, controllerEl, { position: 'bottom', disabled: true });
+		this.fileManager = new FileManager(this, this.$, {
 			query: 'audio',
-			loadHandler: this.events.onAudioLoad,
-			eventHandler: this.events.onAudioAction
+			loadEventName: 'onAudioLoad',
+			actionEventName: 'onAudioAction',
 		});
 
 		// members
-		this.figure = new Figure(this, null, {});
+		this.figure = new Figure(this, this.$, null, {});
 
 		/** @type {HTMLElement} */
 		this.fileModalWrapper = modalEl.querySelector('.se-flex-input-wrapper');
@@ -89,92 +97,99 @@ class Audio_ extends EditorInjector {
 		this.audioUrlFile = modalEl.querySelector('.se-input-url');
 		/** @type {HTMLElement} */
 		this.preview = modalEl.querySelector('.se-link-preview');
-		/** @type {HTMLAudioElement} */
-		this._element = null;
 
-		this.defaultWidth = this.pluginOptions.defaultWidth;
-		this.defaultHeight = this.pluginOptions.defaultHeight;
-		this.urlValue = '';
+		/** @type {HTMLAudioElement} */
+		this.#defaultWidth = this.pluginOptions.defaultWidth;
+		this.#defaultHeight = this.pluginOptions.defaultHeight;
 
 		const galleryButton = modalEl.querySelector('.__se__gallery');
-		if (galleryButton) this.eventManager.addEvent(galleryButton, 'click', this.#OpenGallery.bind(this));
+		if (galleryButton) this.$.eventManager.addEvent(galleryButton, 'click', this.#OpenGallery.bind(this));
 
 		// init
 		if (this.audioInputFile) {
-			this.eventManager.addEvent(modalEl.querySelector('.se-modal-files-edge-button'), 'click', this.#RemoveSelectedFiles.bind(this, this.audioUrlFile, this.preview));
+			this.$.eventManager.addEvent(modalEl.querySelector('.se-modal-files-edge-button'), 'click', this.#RemoveSelectedFiles.bind(this, this.audioUrlFile, this.preview));
 			if (this.audioUrlFile) {
-				this.eventManager.addEvent(this.audioInputFile, 'change', this.#FileInputChange.bind(this));
+				this.$.eventManager.addEvent(this.audioInputFile, 'change', this.#FileInputChange.bind(this));
 			}
 		}
 		if (this.audioUrlFile) {
-			this.eventManager.addEvent(this.audioUrlFile, 'input', this.#OnLinkPreview.bind(this));
+			this.$.eventManager.addEvent(this.audioUrlFile, 'input', this.#OnLinkPreview.bind(this));
 		}
 	}
 
 	/**
-	 * @editorMethod Modules.Modal
-	 * @description Executes the method that is called when a "Modal" module's is opened.
+	 * @override
+	 * @type {PluginModal['open']}
 	 */
 	open() {
 		this.modal.open();
 	}
 
 	/**
-	 * @editorMethod Modules.Modal
-	 * @description Executes the method that is called when a plugin's modal is opened.
-	 * @param {boolean} isUpdate "Indicates whether the modal is for editing an existing component (true) or registering a new one (false)."
+	 * @hook Editor.core
+	 * @type {SunEditor.Hook.Core.RetainFormat}
 	 */
-	on(isUpdate) {
-		if (!isUpdate) {
-			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.setAttribute('multiple', 'multiple');
-		} else if (this._element) {
-			this.urlValue = this.preview.textContent = this.audioUrlFile.value = this._element.src;
-			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.removeAttribute('multiple');
-		} else {
-			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.removeAttribute('multiple');
-		}
+	retainFormat() {
+		return {
+			query: 'audio',
+			method: (element) => {
+				const figureInfo = Figure.GetContainer(element);
+				if (figureInfo && figureInfo.container && figureInfo.cover) return;
+
+				this.#setTagAttrs(element);
+				const figure = Figure.CreateContainer(element.cloneNode(true), 'se-flex-component');
+				this.figure.retainFigureFormat(figure.container, element, null, this.fileManager);
+			},
+		};
 	}
 
 	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the event function of "paste" or "drop".
-	 * @param {Object} params { frameContext, event, file }
-	 * @param {__se__FrameContext} params.frameContext Frame context
-	 * @param {ClipboardEvent} params.event Event object
-	 * @param {File} params.file File object
-	 * @returns {boolean} - If return false, the file upload will be canceled
+	 * @hook Editor.EventManager
+	 * @type {SunEditor.Hook.Event.OnFilePasteAndDrop}
 	 */
 	onFilePasteAndDrop({ file }) {
 		if (!/^audio/.test(file.type)) return;
 
 		this.submitFile([file]);
-		this.editor.focus();
+		this.$.focusManager.focus();
+	}
 
-		return false;
+	/**
+	 * @hook Modules.Modal
+	 * @type {SunEditor.Hook.Modal.On}
+	 */
+	modalOn(isUpdate) {
+		if (!isUpdate) {
+			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.setAttribute('multiple', 'multiple');
+		} else if (this.#element) {
+			this.#urlValue = this.preview.textContent = this.audioUrlFile.value = this.#element.src;
+			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.removeAttribute('multiple');
+		} else {
+			if (this.audioInputFile && this.pluginOptions.allowMultiple) this.audioInputFile.removeAttribute('multiple');
+		}
 	}
 
 	/**
-	 * @editorMethod Modules.Modal
-	 * @description This function is called when a form within a modal window is "submit".
-	 * @returns {Promise<boolean>} Success or failure
+	 * @hook Modules.Modal
+	 * @type {SunEditor.Hook.Modal.Action}
 	 */
 	async modalAction() {
 		if (this.audioInputFile && this.audioInputFile?.files.length > 0) {
 			return await this.submitFile(this.audioInputFile.files);
-		} else if (this.audioUrlFile && this.urlValue.length > 0) {
-			return await this.submitURL(this.urlValue);
+		} else if (this.audioUrlFile && this.#urlValue.length > 0) {
+			return await this.submitURL(this.#urlValue);
 		}
 		return false;
 	}
 
 	/**
-	 * @editorMethod Modules.Modal
-	 * @description This function is called before the modal window is opened, but before it is closed.
+	 * @hook Modules.Modal
+	 * @type {SunEditor.Hook.Modal.Init}
 	 */
-	init() {
+	modalInit() {
 		Modal.OnChangeFile(this.fileModalWrapper, []);
 		if (this.audioInputFile) this.audioInputFile.value = '';
-		if (this.audioUrlFile) this.urlValue = this.preview.textContent = this.audioUrlFile.value = '';
+		if (this.audioUrlFile) this.#urlValue = this.preview.textContent = this.audioUrlFile.value = '';
 		if (this.audioInputFile && this.audioUrlFile) {
 			this.audioUrlFile.disabled = false;
 			this.preview.style.textDecoration = '';
@@ -182,155 +197,94 @@ class Audio_ extends EditorInjector {
 	}
 
 	/**
-	 * @editorMethod Modules.Controller
-	 * @description Executes the method that is called when a button is clicked in the "controller".
-	 * @param {HTMLButtonElement} target Target button element
+	 * @hook Modules.Controller
+	 * @type {SunEditor.Hook.Controller.Action}
 	 */
 	controllerAction(target) {
 		switch (target.getAttribute('data-command')) {
 			case 'update':
-				if (this.audioUrlFile) this.urlValue = this.preview.textContent = this.audioUrlFile.value = this._element.src;
+				if (this.audioUrlFile) this.#urlValue = this.preview.textContent = this.audioUrlFile.value = this.#element.src;
 				this.open();
 				break;
 			case 'copy': {
-				const figure = Figure.GetContainer(this._element);
-				this.component.copy(figure.container);
+				const figure = Figure.GetContainer(this.#element);
+				this.$.component.copy(figure.container);
 				break;
 			}
 			case 'delete':
-				this.destroy();
+				this.componentDestroy(null);
 				break;
 		}
 	}
 
 	/**
-	 * @editorMethod Editor.core
-	 * @description This method is used to validate and preserve the format of the component within the editor.
-	 * - It ensures that the structure and attributes of the element are maintained and secure.
-	 * - The method checks if the element is already wrapped in a valid container and updates its attributes if necessary.
-	 * - If the element isn't properly contained, a new container is created to retain the format.
-	 * @returns {{query: string, method: (element: HTMLAudioElement) => void}} The format retention object containing the query and method to process the element.
-	 * - query: The selector query to identify the relevant elements (in this case, 'audio').
-	 * - method:The function to execute on the element to validate and preserve its format.
-	 * - The function takes the element as an argument, checks if it is contained correctly, and applies necessary adjustments.
+	 * @hook Editor.Component
+	 * @type {SunEditor.Hook.Component.Select}
 	 */
-	retainFormat() {
-		return {
-			query: 'audio',
-			method: (element) => {
-				const figureInfo = Figure.GetContainer(element);
-				if (figureInfo && figureInfo.container && figureInfo.cover) return;
-
-				this._setTagAttrs(element);
-				const figure = Figure.CreateContainer(element.cloneNode(true), 'se-flex-component');
-				this.figure.retainFigureFormat(figure.container, element, null, this.fileManager);
-			}
-		};
+	componentSelect(target) {
+		this.figure.open(target, { nonResizing: true, nonSizeInfo: true, nonBorder: true, figureTarget: true, infoOnly: false });
+		this.#ready(target);
 	}
 
 	/**
-	 * @editorMethod Editor.Component
-	 * @description Executes the method that is called when a component of a plugin is selected.
-	 * @param {HTMLElement} target Target component element
+	 * @hook Editor.Component
+	 * @type {SunEditor.Hook.Component.Destroy}
 	 */
-	select(target) {
-		this.figure.open(target, { nonResizing: true, nonSizeInfo: true, nonBorder: true, figureTarget: true, __fileManagerInfo: false });
-		this._ready(target);
-	}
-
-	/**
-	 * @private
-	 * @description Prepares the component for selection.
-	 * - Ensures that the controller is properly positioned and initialized.
-	 * - Prevents duplicate event handling if the component is already selected.
-	 * @param {HTMLElement} target - The selected element.
-	 */
-	_ready(target) {
-		if (_DragHandle.get('__overInfo') === ON_OVER_COMPONENT) return;
-		this._element = /** @type {HTMLAudioElement} */ (target);
-		this.controller.open(target, null, { isWWTarget: false, addOffset: null });
-	}
-
-	/**
-	 * @editorMethod Editor.Component
-	 * @description Method to delete a component of a plugin, called by the "FileManager", "Controller" module.
-	 * @param {HTMLElement=} target Target element, if null current selected element
-	 * @returns {Promise<void>}
-	 */
-	async destroy(target) {
-		const element = target || this._element;
+	async componentDestroy(target) {
+		const element = target || this.#element;
 		const figure = Figure.GetContainer(element);
 		const container = figure.container || element;
 		const focusEl = container.previousElementSibling || container.nextElementSibling;
 
-		const message = await this.triggerEvent('onAudioDeleteBefore', { element: element, container: figure, url: element.getAttribute('src') });
+		const message = await this.$.eventManager.triggerEvent('onAudioDeleteBefore', { element: element, container: figure, url: element.getAttribute('src') });
 		if (message === false) return;
 
 		const emptyDiv = container.parentNode;
 		dom.utils.removeItem(container);
-		this.init();
+		this.modalInit();
 		this.controller.close();
 
-		if (emptyDiv !== this.editor.frameContext.get('wysiwyg')) {
-			this.nodeTransform.removeAllParents(
+		if (emptyDiv !== this.$.frameContext.get('wysiwyg')) {
+			this.$.nodeTransform.removeAllParents(
 				emptyDiv,
 				function (current) {
 					return current.childNodes.length === 0;
 				},
-				null
+				null,
 			);
 		}
 
 		// focus
-		this.editor.focusEdge(focusEl);
-		this.history.push(false);
+		this.$.focusManager.focusEdge(focusEl);
+		this.$.history.push(false);
 	}
 
 	/**
-	 * @private
-	 * @description Registers uploaded audio files and creates the corresponding audio elements.
-	 * - Iterates through the uploaded files and inserts them into the editor.
-	 * @param {AudioInfo_audio} info - Upload metadata, including `isUpdate` flag and `element`.
-	 * @param {Object<string, *>} response - Server response containing uploaded file details.
-	 */
-	_register(info, response) {
-		const fileList = response.result;
-
-		for (let i = 0, len = fileList.length, file, oAudio; i < len; i++) {
-			if (info.isUpdate) oAudio = info.element;
-			else oAudio = this._createAudioTag();
-
-			file = { name: fileList[i].name, size: fileList[i].size };
-			this._createComp(oAudio, fileList[i].url, file, info.isUpdate);
-		}
-	}
-
-	/**
-	 * @description Create an "audio" component using the provided files.
+	 * @description Create an `audio` component using the provided files.
 	 * @param {FileList|File[]} fileList File object list
-	 * @returns {Promise<boolean>} If return false, the file upload will be canceled
+	 * @returns {Promise<boolean>} If return `false`, the file upload will be canceled
 	 */
 	async submitFile(fileList) {
 		if (fileList.length === 0) return false;
 
 		let fileSize = 0;
 		const files = [];
-		const slngleSizeLimit = this.pluginOptions.uploadSingleSizeLimit;
+		const singleSizeLimit = this.pluginOptions.uploadSingleSizeLimit;
 		for (let i = 0, len = fileList.length, f, s; i < len; i++) {
 			f = fileList[i];
 			if (!/audio/i.test(f.type)) continue;
 
 			s = f.size;
-			if (slngleSizeLimit && slngleSizeLimit > s) {
-				const err = '[SUNEDITOR.audioUpload.fail] Size of uploadable single file: ' + slngleSizeLimit / 1000 + 'KB';
-				const message = await this.triggerEvent('onAudioUploadError', {
+			if (singleSizeLimit > 0 && s > singleSizeLimit) {
+				const err = '[SUNEDITOR.audioUpload.fail] Size of uploadable single file: ' + singleSizeLimit / 1000 + 'KB';
+				const message = await this.$.eventManager.triggerEvent('onAudioUploadError', {
 					error: err,
-					limitSize: slngleSizeLimit,
+					limitSize: singleSizeLimit,
 					uploadSize: s,
-					file: f
+					file: f,
 				});
 
-				this.ui.alertOpen(message === NO_EVENT ? err : message || err, 'error');
+				this.$.ui.alertOpen(message === NO_EVENT ? err : message || err, 'error');
 
 				return false;
 			}
@@ -342,9 +296,9 @@ class Audio_ extends EditorInjector {
 		const limitSize = this.pluginOptions.uploadSizeLimit;
 		if (limitSize > 0 && fileSize + this.fileManager.getSize() > limitSize) {
 			const err = '[SUNEDITOR.audioUpload.fail] Size of uploadable total audios: ' + limitSize / 1000 + 'KB';
-			const message = await this.triggerEvent('onAudioUploadError', { error: err, limitSize, currentSize: this.fileManager.getSize(), uploadSize: fileSize });
+			const message = await this.$.eventManager.triggerEvent('onAudioUploadError', { error: err, limitSize, currentSize: this.fileManager.getSize(), uploadSize: fileSize });
 
-			this.ui.alertOpen(message === NO_EVENT ? err : message || err, 'error');
+			this.$.ui.alertOpen(message === NO_EVENT ? err : message || err, 'error');
 
 			return false;
 		}
@@ -352,17 +306,17 @@ class Audio_ extends EditorInjector {
 		const audioInfo = {
 			files,
 			isUpdate: this.modal.isUpdate,
-			element: this._element
+			element: this.#element,
 		};
 
-		const handler = function (newInfos, infos) {
+		const handler = function (uploadCallback, newInfos, infos) {
 			infos = newInfos || infos;
-			this._serverUpload(infos, infos.files);
-		}.bind(this, audioInfo);
+			uploadCallback(infos, infos.files);
+		}.bind(this, this.#serverUpload.bind(this), audioInfo);
 
-		const result = await this.triggerEvent('onAudioUploadBefore', {
+		const result = await this.$.eventManager.triggerEvent('onAudioUploadBefore', {
 			info: audioInfo,
-			handler
+			handler,
 		});
 
 		if (typeof result === 'undefined') return true;
@@ -375,7 +329,7 @@ class Audio_ extends EditorInjector {
 	}
 
 	/**
-	 * @description Create an "audio" component using the provided url.
+	 * @description Create an `audio` component using the provided url.
 	 * @param {string} url File url
 	 * @returns {Promise<boolean>}
 	 */
@@ -387,17 +341,17 @@ class Audio_ extends EditorInjector {
 			url,
 			files: file,
 			isUpdate: this.modal.isUpdate,
-			element: this._createAudioTag()
+			element: this.#createAudioTag(),
 		};
 
-		const handler = function (newInfos, infos) {
+		const handler = function (uploadCallback, newInfos, infos) {
 			infos = newInfos || infos;
-			this._createComp(infos.element, infos.url, infos.files, infos.isUpdate);
-		}.bind(this, audioInfo);
+			uploadCallback(infos.element, infos.url, infos.files, infos.isUpdate, true);
+		}.bind(this, this.create.bind(this), audioInfo);
 
-		const result = await this.triggerEvent('onAudioUploadBefore', {
+		const result = await this.$.eventManager.triggerEvent('onAudioUploadBefore', {
 			info: audioInfo,
-			handler
+			handler,
 		});
 
 		if (typeof result === 'undefined') return true;
@@ -410,66 +364,94 @@ class Audio_ extends EditorInjector {
 	}
 
 	/**
-	 * @private
-	 * @description Creates or updates an audio component within the editor.
+	 * @description Creates or updates an `audio` component within the editor.
 	 * - If `isUpdate` is `true`, updates the existing element's `src`.
-	 * - Otherwise, inserts a new audio component with the given file.
-	 * @param {HTMLAudioElement} element - The target audio element.
+	 * - Otherwise, inserts a new `audio` component with the given file.
+	 * @param {HTMLAudioElement} element - The target `AUDIO` element.
 	 * @param {string} src - The source URL of the audio file.
 	 * @param {{name: string, size: number}} file - The file metadata (name, size).
 	 * @param {boolean} isUpdate - Whether to update an existing element.
+	 * @param {boolean} isLast - Indicates whether this is the last file in the batch (used for scroll and insert actions).
 	 */
-	_createComp(element, src, file, isUpdate) {
+	create(element, src, file, isUpdate, isLast) {
 		// create new tag
 		if (!isUpdate) {
 			this.fileManager.setFileData(element, file);
 			element.src = src;
 			const figure = Figure.CreateContainer(element, 'se-flex-component');
-			if (!this.component.insert(figure.container, { skipCharCount: false, skipSelection: !this.options.get('componentAutoSelect'), skipHistory: false })) {
-				this.editor.focus();
+			if (!this.$.component.insert(figure.container, { scrollTo: isLast ? true : false, insertBehavior: isLast ? this.pluginOptions.insertBehavior : 'line' })) {
+				if (isLast) this.$.focusManager.focus();
 				return;
 			}
-			if (!this.options.get('componentAutoSelect')) {
-				const line = this.format.addLine(figure.container, null);
-				if (line) this.selection.setRange(line, 0, line, 0);
+			if (!this.$.options.get('componentInsertBehavior')) {
+				const line = this.$.format.addLine(figure.container, null);
+				if (line) this.$.selection.setRange(line, 0, line, 0);
 			}
 		} else {
-			if (this._element) element = this._element;
+			if (this.#element) element = this.#element;
 			this.fileManager.setFileData(element, file);
 			if (element && element.src !== src) {
 				element.src = src;
-				this.component.select(element, Audio_.key);
+				this.$.component.select(element, Audio_.key);
 			} else {
-				this.component.select(element, Audio_.key);
+				this.$.component.select(element, Audio_.key);
 				return;
 			}
 		}
 
-		if (isUpdate) this.history.push(false);
+		if (isUpdate) this.$.history.push(false);
+	}
+
+	/**
+	 * @description Prepares the component for selection.
+	 * - Ensures that the controller is properly positioned and initialized.
+	 * - Prevents duplicate event handling if the component is already selected.
+	 * @param {HTMLElement} target - The selected element.
+	 */
+	#ready(target) {
+		if (_DragHandle.get('__overInfo') === ON_OVER_COMPONENT) return;
+		this.#element = /** @type {HTMLAudioElement} */ (target);
+		this.controller.open(target, null, { isWWTarget: false, addOffset: null });
+	}
+
+	/**
+	 * @description Registers uploaded audio files and creates the corresponding audio elements.
+	 * - Iterates through the uploaded files and inserts them into the editor.
+	 * @param {SunEditor.EventParams.AudioInfo} info - Upload metadata, including `isUpdate` flag and `element`.
+	 * @param {Object<string, *>} response - Server response containing uploaded file details.
+	 */
+	#register(info, response) {
+		const fileList = response.result;
+
+		for (let i = 0, len = fileList.length, file, oAudio; i < len; i++) {
+			if (info.isUpdate) oAudio = info.element;
+			else oAudio = this.#createAudioTag();
+
+			file = { name: fileList[i].name, size: fileList[i].size };
+			this.create(oAudio, fileList[i].url, file, info.isUpdate, i === len - 1);
+		}
 	}
 
 	/**
-	 * @private
-	 * @description Creates a new `<audio>` element with default attributes.
+	 * @description Creates a new `AUDIO` element with default attributes.
 	 * - Applies width, height, and additional attributes from plugin options.
-	 * @returns {HTMLAudioElement} - The newly created `<audio>` element.
+	 * @returns {HTMLAudioElement} - The newly created `AUDIO` element.
 	 */
-	_createAudioTag() {
-		const w = this.defaultWidth;
-		const h = this.defaultHeight;
+	#createAudioTag() {
+		const w = this.#defaultWidth;
+		const h = this.#defaultHeight;
 		/** @type {HTMLAudioElement} */
 		const oAudio = dom.utils.createElement('AUDIO', { style: (w ? 'width:' + w + '; ' : '') + (h ? 'height:' + h + ';' : '') });
-		this._setTagAttrs(oAudio);
+		this.#setTagAttrs(oAudio);
 		return oAudio;
 	}
 
 	/**
-	 * @private
-	 * @description Sets attributes on an audio element based on plugin options.
+	 * @description Sets attributes on an `AUDIO` element based on plugin options.
 	 * - Adds the `controls` attribute and applies any custom attributes.
-	 * @param {HTMLElement} element - The `<audio>` element to modify.
+	 * @param {HTMLElement} element - The `AUDIO` element to modify.
 	 */
-	_setTagAttrs(element) {
+	#setTagAttrs(element) {
 		element.setAttribute('controls', 'true');
 
 		const attrs = this.pluginOptions.audioTagAttributes;
@@ -481,21 +463,19 @@ class Audio_ extends EditorInjector {
 	}
 
 	/**
-	 * @private
 	 * @description Uploads audio files to the server.
 	 * - Sends a request to the configured upload URL and processes the response.
-	 * @param {AudioInfo_audio} info - Upload metadata, including `files` and `isUpdate`.
+	 * @param {SunEditor.EventParams.AudioInfo} info - Upload metadata, including `files` and `isUpdate`.
 	 * @param {FileList|File[]} files - The files to be uploaded.
 	 */
-	_serverUpload(info, files) {
+	#serverUpload(info, files) {
 		if (!files) return;
 
 		const uploadFiles = this.modal.isUpdate ? [files[0]] : files;
-		this.fileManager.upload(this.pluginOptions.uploadUrl, this.pluginOptions.uploadHeaders, uploadFiles, this.#UploadCallBack.bind(this, info), this._error.bind(this));
+		this.fileManager.upload(this.pluginOptions.uploadUrl, this.pluginOptions.uploadHeaders, uploadFiles, this.#UploadCallBack.bind(this, info), this.#error.bind(this));
 	}
 
 	/**
-	 * @private
 	 * @description Handles errors that occur during the audio upload process.
 	 * - Triggers the `onAudioUploadError` event to allow custom handling of errors.
 	 * - Displays an error message in the editor's UI.
@@ -503,10 +483,10 @@ class Audio_ extends EditorInjector {
 	 * @param {Object<string, *>} response - The error response object from the server or upload process.
 	 * @returns {Promise<void>}
 	 */
-	async _error(response) {
-		const message = await this.triggerEvent('onAudioUploadError', { error: response });
+	async #error(response) {
+		const message = await this.$.eventManager.triggerEvent('onAudioUploadError', { error: response });
 		const err = message === NO_EVENT ? response.errorMessage : message || response.errorMessage;
-		this.ui.alertOpen(err, 'error');
+		this.$.ui.alertOpen(err, 'error');
 		console.error('[SUNEDITOR.plugin.audio.error]', err);
 	}
 
@@ -514,16 +494,16 @@ class Audio_ extends EditorInjector {
 	 * @description Handles the server response after a file upload.
 	 * - If the upload is successful, registers the uploaded audio.
 	 * - If an error occurs, triggers an error event.
-	 * @param {AudioInfo_audio} info - Upload metadata.
+	 * @param {SunEditor.EventParams.AudioInfo} info - Upload metadata.
 	 * @param {XMLHttpRequest} xmlHttp - The completed XHR request.
 	 */
 	async #UploadCallBack(info, xmlHttp) {
-		if ((await this.triggerEvent('audioUploadHandler', { xmlHttp, info })) === NO_EVENT) {
+		if ((await this.$.eventManager.triggerEvent('audioUploadHandler', { xmlHttp, info })) === NO_EVENT) {
 			const response = JSON.parse(xmlHttp.responseText);
 			if (response.errorMessage) {
-				this._error(response);
+				this.#error(response);
 			} else {
-				this._register(info, response);
+				this.#register(info, response);
 			}
 		}
 	}
@@ -537,13 +517,13 @@ class Audio_ extends EditorInjector {
 		/** @type {HTMLInputElement} */
 		const target = dom.query.getEventTarget(e);
 		const value = target.value.trim();
-		this.urlValue = this.preview.textContent = !value
+		this.#urlValue = this.preview.textContent = !value
 			? ''
-			: this.options.get('defaultUrlProtocol') && !value.includes('://') && value.indexOf('#') !== 0
-			? this.options.get('defaultUrlProtocol') + value
-			: !value.includes('://')
-			? '/' + value
-			: value;
+			: this.$.options.get('defaultUrlProtocol') && !value.includes('://') && value.indexOf('#') !== 0
+				? this.$.options.get('defaultUrlProtocol') + value
+				: !value.includes('://')
+					? '/' + value
+					: value;
 	}
 
 	/**
@@ -551,14 +531,14 @@ class Audio_ extends EditorInjector {
 	 * - Calls a function to populate the URL input with the selected audio file.
 	 */
 	#OpenGallery() {
-		this.plugins.audioGallery.open(this.#SetUrlInput.bind(this));
+		this.$.plugins.audioGallery.open(this.#SetUrlInput.bind(this));
 	}
 
 	/**
 	 * @param {HTMLInputElement} target - The target element.
 	 */
 	#SetUrlInput(target) {
-		this.urlValue = this.preview.textContent = this.audioUrlFile.value = target.getAttribute('data-command') || target.src;
+		this.#urlValue = this.preview.textContent = this.audioUrlFile.value = target.getAttribute('data-command') || target.src;
 		this.audioUrlFile.focus();
 	}
 
@@ -598,6 +578,11 @@ class Audio_ extends EditorInjector {
 	}
 }
 
+/**
+ * @param {SunEditor.Deps} $ - Kernel dependencies
+ * @param {import('./audio').AudioPluginOptions} pluginOptions - Audio plugin options
+ * @returns {HTMLElement}
+ */
 function CreateHTML_modal({ lang, icons, plugins }, pluginOptions) {
 	let html = /*html*/ `
     <form method="post" enctype="multipart/form-data">
@@ -645,6 +630,10 @@ function CreateHTML_modal({ lang, icons, plugins }, pluginOptions) {
 	return dom.utils.createElement('DIV', { class: 'se-modal-content' }, html);
 }
 
+/**
+ * @param {SunEditor.Deps} $ - Kernel dependencies
+ * @returns {HTMLElement}
+ */
 function CreateHTML_controller({ lang, icons }) {
 	const html = /*html*/ `
     <div class="se-arrow se-arrow-up"></div>