suneditor 3.0.0-beta.21 → 3.0.0-beta.23

package/src/plugins/modal/video.js

@@ -37,6 +37,11 @@ const { NO_EVENT } = env;
  * @property {Array<RegExp>} [urlPatterns] - Additional URL patterns for video embedding.
  * @property {Array<string>} [extensions] - Additional file extensions to be recognized for video uploads.
  * @property {FigureControls_video} [controls] - Figure controls.
+ * @property {__se__ComponentInsertBehaviorType} [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.
  */
 
 /**
@@ -95,7 +100,8 @@ class Video extends EditorInjector {
 			videoTagAttributes: pluginOptions.videoTagAttributes || null,
 			iframeTagAttributes: pluginOptions.iframeTagAttributes || null,
 			query_youtube: pluginOptions.query_youtube || '',
-			query_vimeo: pluginOptions.query_vimeo || ''
+			query_vimeo: pluginOptions.query_vimeo || '',
+			insertBehavior: pluginOptions.insertBehavior
 		};
 
 		// create HTML
@@ -314,7 +320,7 @@ class Video extends EditorInjector {
 				const figureInfo = Figure.GetContainer(element);
 				if (figureInfo && figureInfo.container && figureInfo.cover) return;
 
-				this._ready(element);
+				this._ready(element, true);
 				const line = this.format.getLine(element);
 				if (line) this._align = line.style.textAlign || line.style.float;
 
@@ -364,10 +370,11 @@ class Video extends EditorInjector {
 	 * - Ensures that the controller is properly positioned and initialized.
 	 * - Prevents duplicate event handling if the component is already selected.
 	 * @param {HTMLIFrameElement|HTMLVideoElement} target - The selected element.
+	 * @param {boolean} [infoOnly=false] - If true, only retrieves information without opening the controller.
 	 */
-	_ready(target) {
+	_ready(target, infoOnly = false) {
 		if (!target) return;
-		const figureInfo = this.figure.open(target, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, __fileManagerInfo: false });
+		const figureInfo = this.figure.open(target, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, infoOnly });
 
 		this._element = target;
 		this._cover = figureInfo.cover;
@@ -574,10 +581,11 @@ class Video extends EditorInjector {
 		this._element = oFrame;
 		this._cover = cover;
 		this._container = container;
-		this.figure.open(oFrame, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, __fileManagerInfo: true });
+		this.figure.open(oFrame, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, infoOnly: true });
+
+		width ||= this._defaultSizeX;
+		height ||= this._frameRatio;
 
-		width = width || this._defaultSizeX;
-		height = height || this._frameRatio;
 		const size = this.figure.getSize(oFrame);
 		const inputUpdate = size.w !== width || size.h !== height;
 		const changeSize = !isUpdate || inputUpdate;
@@ -596,11 +604,7 @@ class Video extends EditorInjector {
 		this.fileManager.setFileData(oFrame, file);
 
 		if (!isUpdate) {
-			this.component.insert(container, { skipCharCount: false, skipSelection: true, skipHistory: false });
-			if (!this.options.get('componentAutoSelect')) {
-				const line = this.format.addLine(container, null);
-				if (line) this.selection.setRange(line, 0, line, 0);
-			}
+			this.component.insert(container, { insertBehavior: this.pluginOptions.insertBehavior });
 			return;
 		}
 
@@ -651,8 +655,9 @@ class Video extends EditorInjector {
 	 * @param {string|number} h - The height of the video.
 	 */
 	_applySize(w, h) {
-		if (!w) w = this.inputX?.value || this.pluginOptions.defaultWidth;
-		if (!h) h = this.inputY?.value || this.pluginOptions.defaultHeight;
+		w ||= this.inputX?.value || this.pluginOptions.defaultWidth;
+		h ||= this.inputY?.value || this.pluginOptions.defaultHeight;
+
 		if (this._onlyPercentage) {
 			if (!w) w = '100%';
 			else if (/%$/.test(w + '')) w += '%';
@@ -751,8 +756,7 @@ class Video extends EditorInjector {
 	 * @returns {Promise<boolean>} If return false, the file upload will be canceled
 	 */
 	async submitURL(url) {
-		if (!url) url = this._linkValue;
-		if (!url) return false;
+		if (!(url = this._linkValue)) return false;
 
 		/** iframe source */
 		if (/^<iframe.*\/iframe>$/.test(url)) {
@@ -802,23 +806,22 @@ class Video extends EditorInjector {
 			this._setIframeAttrs(/** @type {HTMLIFrameElement} */ (oFrame));
 		}
 
-		let existElement = this.format.isBlock(oFrame.parentNode) || dom.check.isWysiwygFrame(oFrame.parentNode) ? oFrame : this.format.getLine(oFrame) || oFrame;
-
 		const prevFrame = oFrame;
 		const cloneFrame = /** @type {HTMLIFrameElement|HTMLVideoElement} */ (oFrame.cloneNode(true));
 		const figure = Figure.CreateContainer(cloneFrame, 'se-video-container');
 		const container = figure.container;
 
-		const figcaption = existElement.querySelector('figcaption');
+		const figcaption = Figure.GetContainer(prevFrame)?.container.querySelector('figcaption');
 		let caption = null;
 		if (figcaption) {
-			caption = dom.utils.createElement('DIV');
+			caption = dom.utils.createElement('figcaption');
 			caption.innerHTML = figcaption.innerHTML;
 			dom.utils.removeItem(figcaption);
+			figure.cover.appendChild(caption);
 		}
 
 		// size
-		this.figure.open(cloneFrame, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, __fileManagerInfo: true });
+		this.figure.open(cloneFrame, { nonResizing: this._nonResizing, nonSizeInfo: false, nonBorder: false, figureTarget: false, infoOnly: true });
 		const size = (cloneFrame.getAttribute('data-se-size') || ',').split(',');
 
 		const width = size[0] || prevFrame.style.width || prevFrame.width || '';
@@ -830,24 +833,7 @@ class Video extends EditorInjector {
 		if (format) this._align = format.style.textAlign || format.style.float;
 		this.figure.setAlign(cloneFrame, this._align);
 
-		if (dom.query.getParentElement(prevFrame, dom.check.isExcludeFormat)) {
-			prevFrame.replaceWith(container);
-		} else if (dom.check.isListCell(existElement)) {
-			const refer = dom.query.getParentElement(prevFrame, (current) => current.parentNode === existElement);
-			existElement.insertBefore(container, refer);
-			dom.utils.removeItem(prevFrame);
-			this.nodeTransform.removeEmptyNode(refer, null, true);
-		} else if (this.format.isLine(existElement)) {
-			const refer = dom.query.getParentElement(prevFrame, (current) => current.parentNode === existElement);
-			existElement = this.nodeTransform.split(existElement, refer);
-			existElement.parentNode.insertBefore(container, existElement);
-			dom.utils.removeItem(prevFrame);
-			this.nodeTransform.removeEmptyNode(existElement, null, true);
-		} else {
-			/** @type {Element} */ (existElement).replaceWith(container);
-		}
-
-		if (caption) existElement.parentNode.insertBefore(caption, container.nextElementSibling);
+		this.figure.retainFigureFormat(container, this._element, null, this.fileManager);
 
 		return cloneFrame;
 	}

package/src/plugins/popup/anchor.js

@@ -91,6 +91,8 @@ class Anchor extends EditorInjector {
 
 		switch (command) {
 			case 'submit': {
+				this.controller.close();
+
 				if (!currentElement) {
 					const id = this.inputEl.value.trim();
 					if (!id) {
@@ -106,7 +108,7 @@ class Anchor extends EditorInjector {
 						class: 'se-component se-inline-component'
 					});
 
-					this.component.insert(a, { skipCharCount: false, skipSelection: true, skipHistory: false });
+					this.component.insert(a, { insertBehavior: 'none', scrollTo: false });
 
 					const r = this.selection.getNearRange(a);
 					if (r) {
@@ -114,15 +116,13 @@ class Anchor extends EditorInjector {
 					} else {
 						this.component.select(a, Anchor.key);
 					}
+
 					this._init();
 				} else {
-					this.controller.close();
 					currentElement.id = this.inputEl.value;
-					this.select(currentElement);
+					this.component.select(currentElement, Anchor.key);
 				}
 
-				this.controller.close();
-
 				break;
 			}
 			case 'cancel': {
@@ -142,6 +142,7 @@ class Anchor extends EditorInjector {
 				this.inputEl.value = this.displayId.textContent;
 				this.controllerSelect.hide();
 				this.controller.open(currentElement);
+				this.inputEl.focus();
 
 				break;
 			}

package/src/typedef.js

@@ -50,6 +50,17 @@
  * @property {boolean} _onMousedown Mouse down event status
  */
 
+/**
+ * @typedef {"auto"|"select"|"line"|"none"} __se__ComponentInsertBehaviorType
+ * @description Component insertion behavior for selection and cursor placement.
+ * - For inline components: places the cursor near the inserted component or selects it if no nearby range is available.
+ * - For block components: executes behavior based on `selectMode`:
+ *    - `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.
+ */
+
 // --------------------------------------------------------- [Event] ---------------------------------------------------------------------------------------------------
 /**
  * @typedef {Object} __se__EventInfo

package/types/core/class/component.d.ts

@@ -73,8 +73,10 @@ declare class Component {
 	 * @param {Node} element Element to be inserted
 	 * @param {Object} [options] Options
 	 * @param {boolean} [options.skipCharCount=false] If true, it will be inserted even if "frameOptions.get('charCounter_max')" is exceeded.
-	 * @param {boolean} [options.skipSelection=false] If true, do not automatically select the inserted component.
 	 * @param {boolean} [options.skipHistory=false] If true, do not push to history.
+	 * @param {boolean} [options.scrollTo=true] true : Scroll to the inserted element, false : Do not scroll.
+	 * @param {?__se__ComponentInsertBehaviorType} [options.insertBehavior] If true, do not automatically select the inserted component. [default: options.get('componentInsertBehavior')]
+	 * - If null, noting action is performed after insertion.
 	 * @returns {HTMLElement} The inserted element or new line (for HR)
 	 */
 	insert(
@@ -82,14 +84,24 @@ declare class Component {
 		element: Node,
 		{
 			skipCharCount,
-			skipSelection,
-			skipHistory
+			skipHistory,
+			scrollTo,
+			insertBehavior
 		}?: {
 			skipCharCount?: boolean;
-			skipSelection?: boolean;
 			skipHistory?: boolean;
+			scrollTo?: boolean;
+			insertBehavior?: __se__ComponentInsertBehaviorType | null;
 		}
 	): HTMLElement;
+	/**
+	 * @this {ComponentThis}
+	 * @description Handles post-insertion behavior for a newly created component based on the specified mode.
+	 * @param {Node} element The inserted component element.
+	 * @param {Node|null} [oNode] Optional node to use for selection if the component cannot be selected.
+	 * @param {__se__ComponentInsertBehaviorType} [insertBehavior] Behavior mode after component insertion.
+	 */
+	applyInsertBehavior(this: Omit<Component & Partial<import('../../editorInjector').default>, 'component'>, element: Node, oNode?: Node | null, insertBehavior?: __se__ComponentInsertBehaviorType): void;
 	/**
 	 * @this {ComponentThis}
 	 * @description Gets the file component and that plugin name
@@ -171,6 +183,18 @@ declare class Component {
 	 * - This method resets the selection state and hides UI elements related to the component selection.
 	 */
 	__deselect(this: Omit<Component & Partial<import('../../editorInjector').default>, 'component'>): void;
+	/**
+	 * @private
+	 * @this {ComponentThis}
+	 * @description
+	 * Attempts to move the cursor to a valid line after the given container.
+	 * - If a valid next sibling line exists, moves the selection there.
+	 * - If no next sibling exists, creates a new line after the container and moves the selection there.
+	 * - If the next sibling exists but is not a valid line element and cannot create a new line, returns false.
+	 * @param {HTMLElement} container The component container element.
+	 * @returns {boolean} Returns true if the selection moved to a line (existing or newly created), otherwise false.
+	 */
+	__moveToNextLineOrAdd(this: Omit<Component & Partial<import('../../editorInjector').default>, 'component'>, container: HTMLElement): boolean;
 	/**
 	 * @private
 	 * @this {ComponentThis}

package/types/core/class/format.d.ts

@@ -433,17 +433,17 @@ declare class Format {
 	 * @private
 	 * @this {FormatThis}
 	 * @description Nest list cells or cancel nested cells.
-	 * @param selectedCells List cells.
-	 * @param nested Nested or cancel nested.
+	 * @param {Array<HTMLElement>} selectedCells List cells.
+	 * @param {boolean} nested Nested or cancel nested.
 	 */
 	_applyNestedList(
 		this: Omit<Format & Partial<import('../../editorInjector').default>, 'format'>,
-		selectedCells: any,
-		nested: any
+		selectedCells: Array<HTMLElement>,
+		nested: boolean
 	): {
-		sc: any;
+		sc: Node;
 		so: number;
-		ec: any;
+		ec: Node;
 		eo: number;
 	};
 	/**

package/types/core/class/menu.d.ts

@@ -42,9 +42,9 @@ declare class Menu {
 		mousemove: any;
 		mouseout: any;
 	};
-	_bindClose_dropdown_mouse: any;
+	_bindClose_dropdown_mouse: __se__GlobalEventInfo;
 	_bindClose_dropdown_key: any;
-	_bindClose_cons_mouse: any;
+	_bindClose_cons_mouse: __se__GlobalEventInfo;
 	currentDropdownPlugin: any;
 	__menuBtn: Node;
 	__menuContainer: HTMLElement;

package/types/core/class/ui.d.ts

@@ -30,7 +30,7 @@ declare class UI {
 	_alertInner: HTMLElement;
 	_closeListener: any[];
 	_closeSignal: boolean;
-	_bindClose: any;
+	_bindClose: __se__GlobalEventInfo;
 	_backWrapper: HTMLElement;
 	toastPopup: HTMLElement;
 	toastContainer: Element;

package/types/core/config/options.d.ts

@@ -383,7 +383,13 @@ export namespace DEFAULTS {
  * @property {number} [fullScreenOffset=0] - Offset applied when entering fullscreen mode.
  * @property {string} [previewTemplate=null] - Custom template for preview mode.
  * @property {string} [printTemplate=null] - Custom template for print mode.
- * @property {boolean} [componentAutoSelect=false] - Enables automatic selection of inserted components.
+ * @property {__se__ComponentInsertBehaviorType} [componentInsertBehavior="auto"] - Enables automatic selection of inserted components.
+ * - For inline components: places the cursor near the inserted component or selects it if no nearby range is available.
+ * - For block components: executes behavior based on `selectMode`:
+ *    - `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.
  * @property {string} [defaultUrlProtocol=null] - Default URL protocol for links.
  * @property {Object<"copy", number>} [toastMessageTime={copy: 1500}] - {"copy": 1500} - Duration for displaying toast messages.
  * @property {string} [freeCodeViewMode=false] - Enables free code view mode.
@@ -984,8 +990,14 @@ export type EditorBaseOptions = {
 	printTemplate?: string;
 	/**
 	 * - Enables automatic selection of inserted components.
-	 */
-	componentAutoSelect?: boolean;
+	 * - For inline components: places the cursor near the inserted component or selects it if no nearby range is available.
+	 * - For block components: executes behavior based on `selectMode`:
+	 * - `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.
+	 */
+	componentInsertBehavior?: __se__ComponentInsertBehaviorType;
 	/**
 	 * - Default URL protocol for links.
 	 */

package/types/modules/Browser.d.ts

@@ -228,7 +228,7 @@ declare class Browser extends CoreInjector {
 	keyword: string;
 	sideInner: HTMLElement;
 	_closeSignal: boolean;
-	_bindClose: any;
+	_bindClose: __se__GlobalEventInfo;
 	__globalEventHandler: (e: any) => void;
 	apiManager: ApiManager;
 	sideOpenBtn: HTMLButtonElement;

package/types/modules/Controller.d.ts

@@ -133,8 +133,8 @@ declare class Controller extends EditorInjector {
 		keydown: any;
 		mousedown: any;
 	};
-	_bindClose_key: any;
-	_bindClose_mouse: any;
+	_bindClose_key: __se__GlobalEventInfo;
+	_bindClose_mouse: __se__GlobalEventInfo;
 	/** @type {{left?: number, top?: number, addOfffset?: {left?: number, top?: number}}} */
 	__offset: {
 		left?: number;

package/types/modules/Figure.d.ts

@@ -302,7 +302,6 @@ declare class Figure extends EditorInjector {
 	__onContainerEvent: any;
 	__offContainerEvent: any;
 	__onResizeESCEvent: __se__GlobalEventInfo;
-	__fileManagerInfo: boolean;
 	/**
 	 * @description Close the figure's controller
 	 */
@@ -315,7 +314,7 @@ declare class Figure extends EditorInjector {
 	 * @param {boolean} [params.nonSizeInfo=false] Do not display the size information
 	 * @param {boolean} [params.nonBorder=false] Do not display the selected style line
 	 * @param {boolean} [params.figureTarget=false] If true, the target is a figure element
-	 * @param {boolean} [params.__fileManagerInfo=false] If true, the file manager is called
+	 * @param {boolean} [params.infoOnly=false] If true, returns only the figure target info without opening the controller
 	 * @returns {FigureTargetInfo|undefined} figure target info
 	 */
 	open(
@@ -325,13 +324,13 @@ declare class Figure extends EditorInjector {
 			nonSizeInfo,
 			nonBorder,
 			figureTarget,
-			__fileManagerInfo
+			infoOnly
 		}: {
 			nonResizing?: boolean;
 			nonSizeInfo?: boolean;
 			nonBorder?: boolean;
 			figureTarget?: boolean;
-			__fileManagerInfo?: boolean;
+			infoOnly?: boolean;
 		}
 	): FigureTargetInfo | undefined;
 	/**

package/types/modules/Modal.d.ts

@@ -58,7 +58,7 @@ declare class Modal extends CoreInjector {
 	/** @type {HTMLElement} */
 	_modalInner: HTMLElement;
 	_closeListener: any[];
-	_bindClose: any;
+	_bindClose: __se__GlobalEventInfo;
 	_onClickEvent: any;
 	_closeSignal: boolean;
 	/** @type {HTMLElement} */
@@ -71,8 +71,8 @@ declare class Modal extends CoreInjector {
 		mousemove: any;
 		mouseup: any;
 	};
-	_bindClose_mousemove: any;
-	_bindClose_mouseup: any;
+	_bindClose_mousemove: __se__GlobalEventInfo;
+	_bindClose_mouseup: __se__GlobalEventInfo;
 	/**
 	 * @description Open a modal plugin
 	 * - The plugin's "init" method is called.

package/types/modules/SelectMenu.d.ts

@@ -68,8 +68,8 @@ declare class SelectMenu extends CoreInjector {
 	_refer: HTMLElement;
 	_keydownTarget: any;
 	_selectMethod: (command: string) => void;
-	_bindClose_key: any;
-	_bindClose_mousedown: any;
+	_bindClose_key: __se__GlobalEventInfo;
+	_bindClose_mousedown: __se__GlobalEventInfo;
 	_bindClose_click: any;
 	_closeSignal: boolean;
 	__events: {

package/types/plugins/browser/audioGallery.d.ts

@@ -1,8 +1,35 @@
 export default AudioGallery;
 export type BrowserFile_audioGallery = import('../../modules/Browser').BrowserFile;
+export type AudioGalleryPluginOptions = {
+	/**
+	 * - Direct data without server calls
+	 */
+	data?: Array<BrowserFile_audioGallery>;
+	/**
+	 * - Server request URL
+	 */
+	url?: string;
+	/**
+	 * - Server request headers
+	 */
+	headers?: {
+		[x: string]: string;
+	};
+	/**
+	 * - Default thumbnail
+	 */
+	thumbnail?: string | ((item: BrowserFile_audioGallery) => string);
+};
 /**
  * @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
@@ -15,25 +42,9 @@ declare 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: __se__EditorCore,
-		pluginOptions: {
-			data?: Array<any> | undefined;
-			url: string;
-			headers?:
-				| {
-						[x: string]: string;
-				  }
-				| undefined;
-			thumbnail: string | ((item: BrowserFile_audioGallery) => string);
-		}
-	);
+	constructor(editor: __se__EditorCore, pluginOptions: AudioGalleryPluginOptions);
 	title: any;
 	icon: string;
 	onSelectfunction: (targe: Node) => any;

package/types/plugins/browser/fileBrowser.d.ts

@@ -1,8 +1,44 @@
 export default FileBrowser;
 export type BrowserFile_fileBrowser = import('../../modules/Browser').BrowserFile;
+export type FileBrowserPluginOptions = {
+	/**
+	 * - Direct data without server calls
+	 */
+	data?:
+		| {
+				[x: string]: any;
+		  }
+		| Array<any>;
+	/**
+	 * - Server request URL
+	 */
+	url?: string;
+	/**
+	 * - Server request headers
+	 */
+	headers?: {
+		[x: string]: string;
+	};
+	/**
+	 * - Default thumbnail
+	 */
+	thumbnail?: string | ((item: BrowserFile_fileBrowser) => string);
+	/**
+	 * - Additional tag names
+	 */
+	props?: Array<string>;
+};
 /**
  * @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
@@ -15,34 +51,9 @@ declare 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: __se__EditorCore,
-		pluginOptions: {
-			data?:
-				| (
-						| {
-								[x: string]: any;
-						  }
-						| Array<any>
-				  )
-				| undefined;
-			url: string;
-			headers?:
-				| {
-						[x: string]: string;
-				  }
-				| undefined;
-			thumbnail: string | ((item: BrowserFile_fileBrowser) => string);
-			props: Array<string>;
-		}
-	);
+	constructor(editor: __se__EditorCore, pluginOptions: FileBrowserPluginOptions);
 	title: any;
 	icon: string;
 	onSelectfunction: (targe: Node) => any;

package/types/plugins/browser/fileGallery.d.ts

@@ -1,8 +1,35 @@
 export default FileGallery;
 export type BrowserFile_fileGallery = import('../../modules/Browser').BrowserFile;
+export type FileGalleryPluginOptions = {
+	/**
+	 * - Direct data without server calls
+	 */
+	data?: Array<BrowserFile_fileGallery>;
+	/**
+	 * - Server request URL
+	 */
+	url?: string;
+	/**
+	 * - Server request headers
+	 */
+	headers?: {
+		[x: string]: string;
+	};
+	/**
+	 * - Default thumbnail
+	 */
+	thumbnail?: string | ((item: BrowserFile_fileGallery) => string);
+};
 /**
  * @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
@@ -15,25 +42,9 @@ declare 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: __se__EditorCore,
-		pluginOptions: {
-			data?: Array<any> | undefined;
-			url: string;
-			headers?:
-				| {
-						[x: string]: string;
-				  }
-				| undefined;
-			thumbnail: string | ((item: BrowserFile_fileGallery) => string);
-		}
-	);
+	constructor(editor: __se__EditorCore, pluginOptions: FileGalleryPluginOptions);
 	title: any;
 	icon: string;
 	onSelectfunction: (targe: Node) => any;