suneditor 3.1.3 → 3.2.0

package/types/modules/contract/Browser.d.ts

@@ -102,7 +102,7 @@ export type BrowserParams = {
 	/**
 	 * - File server search http header. Optional. Can be overridden in browser.
 	 */
-	searchUrlHeader?: {
+	searchHeaders?: {
 		[x: string]: string;
 	};
 	/**
@@ -172,7 +172,7 @@ export type BrowserParams = {
  *   ]
  * }
  * ```
- * @property {Object<string, string>} [searchUrlHeader] - File server search http header. Optional. Can be overridden in browser.
+ * @property {Object<string, string>} [searchHeaders] - File server search http header. Optional. Can be overridden in browser.
  * @property {string} [listClass] - Class name of list div. Required. Can be overridden in browser.
  * @property {(item: BrowserFile) => string} [drawItemHandler] - Function that returns HTML string for rendering each file item. Required. Can be overridden in browser.
  * ```js
@@ -227,11 +227,11 @@ declare class Browser {
 				[x: string]: any;
 		  };
 	url: string;
-	urlHeader: {
+	headers: {
 		[x: string]: string;
 	};
 	searchUrl: string;
-	searchUrlHeader: {
+	searchHeaders: {
 		[x: string]: string;
 	};
 	drawItemHandler: any;
@@ -276,7 +276,7 @@ declare class Browser {
 	 * @param {string} [params.listClass] - Class name of list div. If not, use `this.listClass`.
 	 * @param {string} [params.title] - File browser window title. If not, use `this.title`.
 	 * @param {string} [params.url] - File server url. If not, use `this.url`.
-	 * @param {Object<string, string>} [params.urlHeader] - File server http header. If not, use `this.urlHeader`.
+	 * @param {Object<string, string>} [params.headers] - File server http header. If not, use `this.headers`.
 	 * @example
 	 * // Open with default settings (configured at construction):
 	 * this.browser.open();
@@ -285,14 +285,14 @@ declare class Browser {
 	 * this.browser.open({
 	 *   title: 'Select a video',
 	 *   url: '/api/videos',
-	 *   urlHeader: { Authorization: 'Bearer token' },
+	 *   headers: { Authorization: 'Bearer token' },
 	 * });
 	 */
 	open(params?: {
 		listClass?: string;
 		title?: string;
 		url?: string;
-		urlHeader?: {
+		headers?: {
 			[x: string]: string;
 		};
 	}): void;

package/types/modules/contract/ColorPicker.d.ts

@@ -78,7 +78,7 @@ declare class ColorPicker {
 	 * @description Displays or resets the currently selected color at color list.
 	 * @param {Node|string} nodeOrColor Current Selected node
 	 * @param {Node} target target
-	 * @param {?(current: Node) => boolean} [stopCondition] - A function used to stop traversing parent nodes while finding the color.
+	 * @param {?(current: *) => boolean} [stopCondition] - A function used to stop traversing parent nodes while finding the color.
 	 * - When this function returns `true`, the traversal ends at that node.
 	 * - e.g., `(node) => this.format.isLine(node)` stops at line-level elements like <p>, <div>.
 	 * @example
@@ -88,7 +88,7 @@ declare class ColorPicker {
 	 * // Initialize with a color string directly (e.g., from a table cell style)
 	 * this.colorPicker.init(color?.value || '', button);
 	 */
-	init(nodeOrColor: Node | string, target: Node, stopCondition?: ((current: Node) => boolean) | null): void;
+	init(nodeOrColor: Node | string, target: Node, stopCondition?: ((current: any) => boolean) | null): void;
 	/**
 	 * @description Store color values
 	 * @param {string} hexColorStr Hax color value

package/types/modules/contract/Controller.d.ts

@@ -46,6 +46,11 @@ export type ControllerParams = {
 	 * Method to be called when the controller is closed.
 	 */
 	initMethod?: () => void;
+	/**
+	 * Called on ESC before the controller closes. Return `true`
+	 * to keep it open (e.g. when an inner sub-panel should absorb the ESC instead).
+	 */
+	escGuard?: () => boolean;
 	/**
 	 * If `true`, When the `controller` is opened, buttons without the `se-component-enabled` class are disabled.
 	 */
@@ -93,6 +98,8 @@ export type ControllerParams = {
  * @property {"top"|"bottom"} [position="bottom"] Controller position
  * @property {boolean} [isWWTarget=true] If the controller is in the WYSIWYG area, set it to `true`.
  * @property {() => void} [initMethod=null] Method to be called when the controller is closed.
+ * @property {() => boolean} [escGuard=null] Called on ESC before the controller closes. Return `true`
+ * to keep it open (e.g. when an inner sub-panel should absorb the ESC instead).
  * @property {boolean} [disabled=false] If `true`, When the `controller` is opened, buttons without the `se-component-enabled` class are disabled.
  * @property {Array<Controller|HTMLElement>} [parents=[]] The parent `controller` instance array when `controller` is opened nested.
  * @property {boolean} [parentsHide=false] If `true`, the parent element is hidden when the controller is opened.

package/types/modules/contract/Figure.d.ts

@@ -96,11 +96,28 @@ export type FigureTargetInfo = {
 /**
  * Figure control button type
  */
-export type FigureControlButton = 'mirror_h' | 'mirror_v' | 'rotate_l' | 'rotate_r' | 'caption' | 'revert' | 'edit' | 'copy' | 'remove' | 'as' | 'align' | 'onalign' | 'onresize';
+export type FigureControlButton =
+	| 'mirror_h'
+	| 'mirror_v'
+	| 'rotate_l'
+	| 'rotate_r'
+	| 'caption'
+	| 'revert'
+	| 'edit'
+	| 'copy'
+	| 'remove'
+	| 'as'
+	| 'align'
+	| 'onalign'
+	| 'onresize';
 /**
  * Figure control resize value type (auto, or percentage numbers)
  */
-export type FigureControlResize = `resize_auto,${number}` | `resize_auto,${number},${number}` | `resize_auto,${number},${number},${number}` | `resize_auto,${number},${number},${number},${number}`;
+export type FigureControlResize =
+	| `resize_auto,${number}`
+	| `resize_auto,${number},${number}`
+	| `resize_auto,${number},${number},${number}`
+	| `resize_auto,${number},${number},${number},${number}`;
 /**
  * Figure control custom action object
  */
@@ -513,7 +530,12 @@ declare class Figure {
 	 * // Replace with anchor cover (e.g., image wrapped in a link)
 	 * this.figure.retainFigureFormat(container, this.#element, anchorEl, this.fileManager);
 	 */
-	retainFigureFormat(container: Node, originEl: Node, anchorCover: Node, fileManagerInst?: import('../manager/FileManager').default): void;
+	retainFigureFormat(
+		container: Node,
+		originEl: Node,
+		anchorCover: Node,
+		fileManagerInst?: import('../manager/FileManager').default,
+	): void;
 	/**
 	 * @description Initialize the transform style (rotation) of the element.
 	 * @param {?Node} [node] Target element, default is the current element
@@ -532,7 +554,12 @@ declare class Figure {
 	 * // Apply size without additional rotation (deg=0 preserves current rotation)
 	 * this.figure.setTransform(oFrame, width, height, 0);
 	 */
-	setTransform(node: Node, width: (string | number) | null, height: (string | number) | null, deg: number | null): void;
+	setTransform(
+		node: Node,
+		width: (string | number) | null,
+		height: (string | number) | null,
+		deg: number | null,
+	): void;
 	/**
 	 * @internal
 	 * @description Displays or hides the resize handles of the figure component.

package/types/modules/ui/CommandMenu.d.ts

@@ -0,0 +1,262 @@
+import type {} from '../../typedef';
+/**
+ * @description Resolve an icon spec to an HTML string. Accepts a key from `$.icons`,
+ * a raw HTML snippet (anything starting with `<`), or empty.
+ * @param {string} icon
+ * @param {Object} icons
+ * @returns {string}
+ */
+export function resolveIconHTML(icon: string, icons: any): string;
+/**
+ * @description Build the canonical command-menu row HTML. Single source of truth for the
+ * BlockHandle action menu and the SlashCommand menu, so they look identical.
+ * @param {string} label
+ * @param {string} iconHTML
+ * @returns {string}
+ */
+export function buildRowHTML(label: string, iconHTML: string): string;
+export default CommandMenu;
+export type CommandMenuItem = {
+	/**
+	 * - Optional identifier.
+	 */
+	key?: string;
+	/**
+	 * - Display label.
+	 */
+	title: string;
+	/**
+	 * - `$.icons` key or raw HTML snippet.
+	 */
+	icon?: string;
+	/**
+	 * - Extra search terms (used by the filter).
+	 */
+	keywords?: string[];
+	/**
+	 * - Custom callback. The second
+	 * argument is the host-supplied context (e.g. `{block}` for BlockHandle, `{triggerChar, query}` for SlashCommand).
+	 */
+	action: (arg0: SunEditor.Deps, arg1: any) => void | Promise<void>;
+};
+export type SubmenuChild = {
+	/**
+	 * - Owning plugin key.
+	 */
+	pluginName: string;
+	/**
+	 * - The original toolbar dropdown button element. Passed to `plugin.action(element)` on click.
+	 */
+	element: HTMLElement;
+};
+export type ResolvedItem = {
+	kind: 'custom' | 'plugin' | 'submenu' | 'dropdownFree';
+	title: string;
+	iconHTML: string;
+	/**
+	 * - Lower-cased haystack for substring filtering.
+	 */
+	search: string;
+	raw?: CommandMenuItem;
+	/**
+	 * - Plugin key.
+	 */
+	name?: string;
+	/**
+	 * - Plugin type (`'modal'`, `'command'`, etc.).
+	 */
+	type?: string;
+	command?: string;
+	/**
+	 * - For `kind: 'submenu'` — clickable child rows (one per dropdown item).
+	 */
+	children?: SubmenuChild[];
+	/**
+	 * - For `kind: 'submenu'` — HTML for each child row.
+	 */
+	childMenus?: string[];
+};
+export type CommandMenuParams = {
+	/**
+	 * - Raw menu entries.
+	 */
+	items: Array<string | CommandMenuItem>;
+	/**
+	 *   Caller-provided plugin/button resolver. Inject `ResolveButton` from `core/section/constructor`.
+	 *   Injected (not imported) because this module lives under `src/modules/` and cannot import from `src/core/*`.
+	 */
+	resolveButton: (
+		arg0: string,
+		arg1: any,
+		arg2: any,
+		arg3: any,
+		arg4: any,
+	) => {
+		title: string;
+		icon: string;
+		type: string;
+		command: string;
+	} | null;
+	/**
+	 * - Base SelectMenu params (`position`, `minWidth`, `keydownTarget`, etc.).
+	 */
+	selectMenuParams: any;
+	/**
+	 * - Optional renderer
+	 * applied to custom (object) items only. Plugin-string items always render with `buildRowHTML`.
+	 */
+	renderCustomItem?: (
+		arg0: CommandMenuItem,
+		arg1: {
+			icons: any;
+		},
+	) => string;
+};
+/**
+ * @typedef {Object} CommandMenuItem
+ * @property {string} [key] - Optional identifier.
+ * @property {string} title - Display label.
+ * @property {string} [icon] - `$.icons` key or raw HTML snippet.
+ * @property {string[]} [keywords] - Extra search terms (used by the filter).
+ * @property {function(SunEditor.Deps, *): void | Promise<void>} action - Custom callback. The second
+ *   argument is the host-supplied context (e.g. `{block}` for BlockHandle, `{triggerChar, query}` for SlashCommand).
+ */
+/**
+ * @typedef {Object} SubmenuChild
+ * @property {string} pluginName - Owning plugin key.
+ * @property {HTMLElement} element - The original toolbar dropdown button element. Passed to `plugin.action(element)` on click.
+ */
+/**
+ * @typedef {Object} ResolvedItem
+ * @property {'custom'|'plugin'|'submenu'|'dropdownFree'} kind
+ * @property {string} title
+ * @property {string} iconHTML
+ * @property {string} search   - Lower-cased haystack for substring filtering.
+ * @property {CommandMenuItem} [raw]
+ * @property {string} [name]   - Plugin key.
+ * @property {string} [type]   - Plugin type (`'modal'`, `'command'`, etc.).
+ * @property {string} [command]
+ * @property {SubmenuChild[]} [children]   - For `kind: 'submenu'` — clickable child rows (one per dropdown item).
+ * @property {string[]} [childMenus]       - For `kind: 'submenu'` — HTML for each child row.
+ */
+/**
+ * @typedef {Object} CommandMenuParams
+ * @property {Array<string | CommandMenuItem>} items - Raw menu entries.
+ * @property {function(string, Object, *, Object, Object): ({title: string, icon: string, type: string, command: string} | null)} resolveButton
+ *   Caller-provided plugin/button resolver. Inject `ResolveButton` from `core/section/constructor`.
+ *   Injected (not imported) because this module lives under `src/modules/` and cannot import from `src/core/*`.
+ * @property {Object} selectMenuParams - Base SelectMenu params (`position`, `minWidth`, `keydownTarget`, etc.).
+ * @property {function(CommandMenuItem, { icons: Object }): string} [renderCustomItem] - Optional renderer
+ *   applied to custom (object) items only. Plugin-string items always render with `buildRowHTML`.
+ */
+/**
+ * @class
+ * @description Shared command-menu module used by BlockHandle and SlashCommand.
+ * - Owns the underlying `SelectMenu`, renders rows with the canonical BlockHandle row HTML.
+ * - Supports four item kinds:
+ *   - `'custom'` — user-defined `{title, icon?, action}` invoked with `($, hostContext)`.
+ *   - `'plugin'` — plain plugin (modal/browser/command/popup) dispatched via `plugin.open/show/action`.
+ *   - `'submenu'` — dropdown plugin auto-expanded inline (children come from `$.menu.itemsMap`).
+ *   - `'dropdownFree'` — dropdown-free plugin (e.g. `fontColor`, `table`) shown with a submenu arrow
+ *     and an attached hover flyout that reuses the plugin's toolbar dropdown DOM.
+ * - Handles blur prevention on mousedown, hover flyout lifecycle, and click-to-toggle for dropdown-free.
+ *
+ * Host responsibilities (kept outside this module):
+ * - Pre-dispatch side effects (BlockHandle: `expandRangeToFullLines`; SlashCommand: delete trigger text).
+ * - Anchor element selection (BlockHandle anchors to the drag button; SlashCommand to a Controller wrapper).
+ * - Context object for custom-item actions.
+ */
+declare class CommandMenu {
+	/**
+	 * @constructor
+	 * @param {*} _host - Reserved for future host-aware behavior (kept for API symmetry with `Modal`/`Controller`).
+	 * @param {SunEditor.Deps} $ - Deps bag.
+	 * @param {CommandMenuParams} params
+	 */
+	constructor(_host: any, $: SunEditor.Deps, params: CommandMenuParams);
+	/** @type {SelectMenu} */
+	selectMenu: SelectMenu;
+	/**
+	 * @description Bind the menu to a reference element and register the click handler.
+	 * @param {HTMLElement} referElement
+	 * @param {(item: ResolvedItem|null) => void} onSelect - Called with the resolved item picked by the user.
+	 *   Hosts run their pre-dispatch hook here (delete trigger, etc.) and then call `dispatch(item, ctx)`.
+	 * @param {{ class?: string, style?: string }} [attr]
+	 */
+	attach(
+		referElement: HTMLElement,
+		onSelect: (item: ResolvedItem | null) => void,
+		attr?: {
+			class?: string;
+			style?: string;
+		},
+	): void;
+	/**
+	 * @description Replace the items list (e.g. when host options change). Invalidates the resolved cache.
+	 * @param {Array<string | CommandMenuItem>} items
+	 */
+	setItems(items: Array<string | CommandMenuItem>): void;
+	/**
+	 * @description Lazily normalize raw items. Lazy because plugin instances (`$.plugins`) may not
+	 * be available during the host's constructor.
+	 * @returns {ResolvedItem[]}
+	 */
+	getItems(): ResolvedItem[];
+	/**
+	 * @description Case-insensitive substring filter on `title + keywords + plugin name`.
+	 * Empty query returns all items (up to `limit`).
+	 * @param {string} query
+	 * @param {number} [limit=Infinity]
+	 * @returns {ResolvedItem[]}
+	 */
+	filter(query: string, limit?: number): ResolvedItem[];
+	/**
+	 * @description Build row HTML for a list of resolved items.
+	 * @param {ResolvedItem[]} items
+	 * @returns {string[]}
+	 */
+	renderRows(items: ResolvedItem[]): string[];
+	/**
+	 * @description Populate the SelectMenu rows.
+	 * @param {ResolvedItem[]} items
+	 */
+	createRows(items: ResolvedItem[]): void;
+	/**
+	 * @description Open the SelectMenu. Lazily (re-)registers menu rows into
+	 * `commandDispatcher.targets` so `selectionState.update` paints the `active` class on them through
+	 * @param {string} [position]
+	 */
+	open(position?: string): void;
+	/**
+	 * @description Close the SelectMenu. Also unregisters menu rows from `commandDispatcher.targets`
+	 */
+	close(): void;
+	/**
+	 * @description Whether a sub-panel (native submenu or dropdown-free flyout) is currently open.
+	 * Lets an owning Controller keep the menu open on ESC and close only the sub-panel.
+	 * @returns {boolean}
+	 */
+	hasOpenSubPanel(): boolean;
+	/**
+	 * @description Highlight a row.
+	 * @param {number} index
+	 */
+	setItem(index: number): void;
+	/**
+	 * @description Soft-hide / soft-show without changing open state. Pass-through.
+	 * @param {boolean} hidden
+	 */
+	setHidden(hidden: boolean): void;
+	get isOpen(): boolean;
+	/**
+	 * @description Dispatch a resolved item. For custom items, calls `raw.action($, ctx)`. For plugin
+	 * items, routes to `plugin.open/show/action` or `commandDispatcher.run` (built-ins). For dropdown-free
+	 * items, toggles the hover flyout
+	 * @param {ResolvedItem | SubmenuChild | null} item
+	 * @param {*} [ctx] - Context passed to custom-item `action` (host-specific shape).
+	 * @returns {boolean} `true` if a plugin was dispatched
+	 */
+	dispatch(item: ResolvedItem | SubmenuChild | null, ctx?: any): boolean;
+	#private;
+}
+import SelectMenu from './SelectMenu.js';

package/types/modules/ui/ModalAnchorEditor.d.ts

@@ -196,6 +196,8 @@ declare class ModalAnchorEditor {
 	/**
 	 * @description Creates an anchor (`<a>`) element with the specified attributes.
 	 * @param {boolean} notText - If `true`, the anchor will not contain text content.
+	 * @param {?string} [urlOverride] - Fallback URL used when the modal's `linkValue` is empty
+	 * - (e.g., when called outside the modal lifecycle such as from `retainFormat`)
 	 * @returns {HTMLElement|null} - The newly created anchor element, or `null` if the URL is empty.
 	 * @example
 	 * // In a link plugin — create anchor with text content:
@@ -208,8 +210,11 @@ declare class ModalAnchorEditor {
 	 * if (anchor) {
 	 *   anchor.appendChild(imgElement);
 	 * }
+	 *
+	 * // Preserve an existing parent anchor's href when rebuilding outside the modal:
+	 * const anchor = this.anchor.create(true, parentAnchor.href);
 	 */
-	create(notText: boolean): HTMLElement | null;
+	create(notText: boolean, urlOverride?: string | null): HTMLElement | null;
 	/**
 	 * @description Resets the ModalAnchorEditor to its initial state.
 	 */

package/types/modules/ui/SelectMenu.d.ts

@@ -30,6 +30,12 @@ export type SelectMenuParams = {
 	 * Optional method to call when the menu is closed
 	 */
 	closeMethod?: () => void;
+	/**
+	 * Optional owner hook invoked on ESC before the menu closes.
+	 * Return `true` if it dismissed an owner-managed sub-panel (e.g. CommandMenu's flyout), so ESC only
+	 * closes that sub-panel and keeps the menu open.
+	 */
+	subEscMethod?: () => boolean;
 	/**
 	 * Optional max-height CSS value (e.g. `"200px"`). Enables scrolling when items exceed this height.
 	 */
@@ -38,6 +44,14 @@ export type SelectMenuParams = {
 	 * Optional min-width CSS value (e.g. `"130px"`).
 	 */
 	minWidth?: string;
+	/**
+	 * Optional override for the keyboard navigation target. By default `on()` listens
+	 * - on the iframe `contentWindow` (`_ww`) when the refer isn't an input — appropriate when the
+	 * - refer is inside the wysiwyg. Set this to `window` (parent) for menus whose refer lives in
+	 * - the parent doc (e.g. BlockHandle's dragBtn in `carrierWrapper`). Also avoids
+	 * - cross-origin/sandboxed iframe `addEventListener` errors.
+	 */
+	keydownTarget?: any;
 };
 /**
  * @typedef {Object} SelectMenuParams
@@ -52,8 +66,16 @@ export type SelectMenuParams = {
  * @property {number} [splitNum=0] Optional split number for horizontal positioning; defines how many items per row
  * @property {() => void} [openMethod] Optional method to call when the menu is opened
  * @property {() => void} [closeMethod] Optional method to call when the menu is closed
+ * @property {() => boolean} [subEscMethod] Optional owner hook invoked on ESC before the menu closes.
+ * Return `true` if it dismissed an owner-managed sub-panel (e.g. CommandMenu's flyout), so ESC only
+ * closes that sub-panel and keeps the menu open.
  * @property {string} [maxHeight] Optional max-height CSS value (e.g. `"200px"`). Enables scrolling when items exceed this height.
  * @property {string} [minWidth] Optional min-width CSS value (e.g. `"130px"`).
+ * @property {*} [keydownTarget]  Optional override for the keyboard navigation target. By default `on()` listens
+ * - on the iframe `contentWindow` (`_ww`) when the refer isn't an input — appropriate when the
+ * - refer is inside the wysiwyg. Set this to `window` (parent) for menus whose refer lives in
+ * - the parent doc (e.g. BlockHandle's dragBtn in `carrierWrapper`). Also avoids
+ * - cross-origin/sandboxed iframe `addEventListener` errors.
  */
 /**
  * @class
@@ -81,14 +103,28 @@ declare class SelectMenu {
 	horizontal: boolean;
 	openMethod: () => void;
 	closeMethod: () => void;
+	subEscMethod: () => boolean;
 	maxHeight: string;
 	minWidth: string;
 	/**
 	 * @description Creates the select menu items.
-	 * @param {Array<string>|SunEditor.NodeCollection} items - Command list of selectable items.
-	 * @param {Array<string>|SunEditor.NodeCollection} [menus] - Optional list of menu display elements; defaults to `items`.
+	 * @param {Array<*>} items - Selectable items.
+	 * - Plain entry: any value (string/object); passed to the `selectMethod` callback when picked.
+	 * - Submenu entry: `{ children: Array<*>, childMenus?: Array<string|HTMLElement> }` —
+	 *   `children` are the child values delivered to `selectMethod` on selection; `childMenus`
+	 *   is the optional display content for each child (HTML string or `HTMLElement`). When
+	 *   omitted, `children` doubles as the display content.
+	 * @param {Array<string>|SunEditor.NodeCollection} [menus] - Optional list of display elements
+	 * (HTML strings or nodes) for the top-level rows. Defaults to `items`. For submenu entries
+	 * this controls the parent row's content; child rows use `childMenus` (or `children`).
+	 * @example
+	 * // Submenu — "List" opens a hover submenu of UL/OL options
+	 * selectMenu.create(
+	 *   [{ children: ['ul', 'ol'], childMenus: ['<i>•</i> Bulleted', '<i>1.</i> Numbered'] }],
+	 *   ['List']
+	 * );
 	 */
-	create(items: Array<string> | SunEditor.NodeCollection, menus?: Array<string> | SunEditor.NodeCollection): void;
+	create(items: Array<any>, menus?: Array<string> | SunEditor.NodeCollection): void;
 	/**
 	 * @description Initializes the select menu and attaches it to a reference element.
 	 * @param {Node} referElement - The element that triggers the select menu.
@@ -125,6 +161,17 @@ declare class SelectMenu {
 	 * selectMenu.open('', '[data-command="' + this.align + '"]');
 	 */
 	open(position?: string | null, onItemQuerySelector?: string | null): void;
+	/**
+	 * @description Re-runs positioning using the same direction the menu was opened with.
+	 * Use when the reference element has moved (e.g. scroll repositioned the trigger) but
+	 * the menu should stay open and follow.
+	 */
+	reposition(): void;
+	/**
+	 * @description Soft-hide / soft-show without changing open state.
+	 * close listeners (outside click, ESC) keep working, but is visually hidden until the trigger comes back.
+	 */
+	setHidden(hidden: any): void;
 	/**
 	 * @description Select menu close
 	 */
@@ -140,6 +187,12 @@ declare class SelectMenu {
 	 * @param {number} index Item index
 	 */
 	setItem(index: number): void;
+	/**
+	 * @description Whether a native submenu is currently open. Used by owners (e.g. a Controller) to
+	 * let ESC dismiss only the open submenu instead of the whole menu.
+	 * @returns {boolean}
+	 */
+	hasOpenSubmenu(): boolean;
 	_onItem: Element;
 	#private;
 }

package/types/modules/ui/index.d.ts

@@ -1,4 +1,5 @@
 import type {} from '../../typedef';
 export { default as _DragHandle } from './_DragHandle.js';
+export { default as CommandMenu } from './CommandMenu.js';
 export { default as ModalAnchorEditor } from './ModalAnchorEditor.js';
 export { default as SelectMenu } from './SelectMenu.js';

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

@@ -28,6 +28,18 @@ export type AudioGalleryPluginOptions = {
 	headers?: {
 		[x: string]: string;
 	};
+	/**
+	 * - Server-side search URL. When set, the keyword is sent to this URL
+	 * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+	 * already-loaded items locally.
+	 */
+	searchUrl?: string;
+	/**
+	 * - Server-side search request headers
+	 */
+	searchHeaders?: {
+		[x: string]: string;
+	};
 	/**
 	 * - Default thumbnail
 	 */
@@ -51,6 +63,10 @@ export type AudioGalleryPluginOptions = {
  * }
  * ```
  * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string} [searchUrl] - Server-side search URL. When set, the keyword is sent to this URL
+ * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+ * already-loaded items locally.
+ * @property {Object<string, string>} [searchHeaders] - Server-side search request headers
  * @property {string|((item: SunEditor.Module.Browser.File) => string)} [thumbnail] - Default thumbnail
  */
 /**
@@ -65,7 +81,7 @@ declare class AudioGallery extends PluginBrowser {
 	 */
 	constructor(kernel: SunEditor.Kernel, pluginOptions: AudioGalleryPluginOptions);
 	title: any;
-	onSelectfunction: (target: Node) => any;
+	onSelectfunction: (target: any) => any;
 	browser: Browser;
 	#private;
 }

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

@@ -39,6 +39,18 @@ export type FileBrowserPluginOptions = {
 	headers?: {
 		[x: string]: string;
 	};
+	/**
+	 * - Server-side search URL. When set, the keyword is sent to this URL
+	 * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+	 * already-loaded items locally.
+	 */
+	searchUrl?: string;
+	/**
+	 * - Server-side search request headers
+	 */
+	searchHeaders?: {
+		[x: string]: string;
+	};
 	/**
 	 * - Default thumbnail URL or a function that returns a thumbnail URL per item.
 	 */
@@ -80,6 +92,10 @@ export type FileBrowserPluginOptions = {
  * }
  * ```
  * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string} [searchUrl] - Server-side search URL. When set, the keyword is sent to this URL
+ * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+ * already-loaded items locally.
+ * @property {Object<string, string>} [searchHeaders] - Server-side search request headers
  * @property {string|((item: SunEditor.Module.Browser.File) => string)} [thumbnail] - Default thumbnail URL or a function that returns a thumbnail URL per item.
  * @property {number} [expand=1] - Initial folder expand depth. `1` expands the first level, `Infinity` expands all. Default: `1`.
  * @property {Array<string>} [props] - Additional tag names
@@ -99,7 +115,7 @@ declare class FileBrowser extends PluginBrowser {
 	 */
 	constructor(kernel: SunEditor.Kernel, pluginOptions: FileBrowserPluginOptions);
 	title: any;
-	onSelectfunction: (target: Node) => any;
+	onSelectfunction: (target: any) => any;
 	browser: Browser;
 	#private;
 }

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

@@ -29,6 +29,18 @@ export type FileGalleryPluginOptions = {
 	headers?: {
 		[x: string]: string;
 	};
+	/**
+	 * - Server-side search URL. When set, the keyword is sent to this URL
+	 * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+	 * already-loaded items locally.
+	 */
+	searchUrl?: string;
+	/**
+	 * - Server-side search request headers
+	 */
+	searchHeaders?: {
+		[x: string]: string;
+	};
 	/**
 	 * - Default thumbnail
 	 */
@@ -53,6 +65,10 @@ export type FileGalleryPluginOptions = {
  * }
  * ```
  * @property {Object<string, string>} [headers] - Server request headers
+ * @property {string} [searchUrl] - Server-side search URL. When set, the keyword is sent to this URL
+ * as `?keyword=<value>` and the server response replaces the list. When not set, search filters the
+ * already-loaded items locally.
+ * @property {Object<string, string>} [searchHeaders] - Server-side search request headers
  * @property {string|((item: SunEditor.Module.Browser.File) => string)} [thumbnail] - Default thumbnail
  */
 /**
@@ -67,7 +83,7 @@ declare class FileGallery extends PluginBrowser {
 	 */
 	constructor(kernel: SunEditor.Kernel, pluginOptions: FileGalleryPluginOptions);
 	title: any;
-	onSelectfunction: (target: Node) => any;
+	onSelectfunction: (target: any) => any;
 	browser: Browser;
 	#private;
 }