suneditor 3.1.4 → 3.2.1

package/types/helper/dom/domCheck.d.ts

@@ -61,7 +61,15 @@ export function isTable(node: (Node | string) | null): node is HTMLTableElement;
  * @param {?Node|string} node The element or element name to check
  * @returns {node is HTMLTableElement|HTMLTableSectionElement|HTMLTableRowElement|HTMLTableCellElement|HTMLTableColElement|HTMLTableColElement}
  */
-export function isTableElements(node: (Node | string) | null): node is HTMLTableElement | HTMLTableSectionElement | HTMLTableRowElement | HTMLTableCellElement | HTMLTableColElement | HTMLTableColElement;
+export function isTableElements(
+	node: (Node | string) | null,
+): node is
+	| HTMLTableElement
+	| HTMLTableSectionElement
+	| HTMLTableRowElement
+	| HTMLTableCellElement
+	| HTMLTableColElement
+	| HTMLTableColElement;
 /**
  * @description Check the node is a table cell (td, th)
  * @param {?Node|string} node The element or element name to check
@@ -91,7 +99,9 @@ export function isAnchor(node: (Node | string) | null): node is HTMLAnchorElemen
  * @param {?Node|string} node The element or element name to check
  * @returns {node is HTMLImageElement|HTMLIFrameElement|HTMLAudioElement|HTMLVideoElement|HTMLCanvasElement}
  */
-export function isMedia(node: (Node | string) | null): node is HTMLImageElement | HTMLIFrameElement | HTMLAudioElement | HTMLVideoElement | HTMLCanvasElement;
+export function isMedia(
+	node: (Node | string) | null,
+): node is HTMLImageElement | HTMLIFrameElement | HTMLAudioElement | HTMLVideoElement | HTMLCanvasElement;
 /**
  * @description Check the node is a iframe tag
  * @param {?Node|string} node The element or element name to check

package/types/helper/dom/domQuery.d.ts

@@ -40,7 +40,10 @@ export function getNodeFromPath<T extends Node>(offsets: Array<number>, parentNo
  * @param {?(current: *) => boolean} validation Conditional function
  * @returns {T|null}
  */
-export function getChildNode<T extends HTMLElement>(element: Node, validation: ((current: any) => boolean) | null): T | null;
+export function getChildNode<T extends HTMLElement>(
+	element: Node,
+	validation: ((current: any) => boolean) | null,
+): T | null;
 /**
  * @template {HTMLElement} T
  * @description Get all `children` of the argument value element (Without text nodes)
@@ -49,7 +52,11 @@ export function getChildNode<T extends HTMLElement>(element: Node, validation: (
  * @param {?number} depth Number of child levels to depth.
  * @returns {Array<T>}
  */
-export function getListChildren<T extends HTMLElement>(element: Node, validation: ((current: any) => boolean) | null, depth: number | null): Array<T>;
+export function getListChildren<T extends HTMLElement>(
+	element: Node,
+	validation: ((current: any) => boolean) | null,
+	depth: number | null,
+): Array<T>;
 /**
  * @template {Node} T
  * @description Get all `childNodes` of the argument value element (Include text nodes)
@@ -60,7 +67,11 @@ export function getListChildren<T extends HTMLElement>(element: Node, validation
  * @example
  * const allNodes = dom.query.getListChildNodes(container, (node) => node.nodeType === 3);
  */
-export function getListChildNodes<T extends Node>(element: Node, validation: ((current: any) => boolean) | null, depth: number | null): Array<T>;
+export function getListChildNodes<T extends Node>(
+	element: Node,
+	validation: ((current: any) => boolean) | null,
+	depth: number | null,
+): Array<T>;
 /**
  * @description Returns the number of parents nodes.
  * - `0` when the parent node is the WYSIWYG area.
@@ -115,7 +126,11 @@ export function compareElements(
  * @param {?number} [depth] Number of parent levels to depth.
  * @returns {T|null} Not found: `null`
  */
-export function getParentElement<T extends HTMLElement>(element: Node, query: string | ((current: any) => boolean) | Node, depth?: number | null): T | null;
+export function getParentElement<T extends HTMLElement>(
+	element: Node,
+	query: string | ((current: any) => boolean) | Node,
+	depth?: number | null,
+): T | null;
 /**
  * @template {HTMLElement} T
  * @description Gets all ancestors of the argument value.
@@ -127,7 +142,11 @@ export function getParentElement<T extends HTMLElement>(element: Node, query: st
  * @param {?number} [depth] Number of parent levels to depth.
  * @returns {Array<T>} Returned in an array in order.
  */
-export function getParentElements<T extends HTMLElement>(element: Node, query: string | ((current: any) => boolean) | Node, depth?: number | null): Array<T>;
+export function getParentElements<T extends HTMLElement>(
+	element: Node,
+	query: string | ((current: any) => boolean) | Node,
+	depth?: number | null,
+): Array<T>;
 /**
  * @template {HTMLElement} T
  * @description Gets the element with `data-command` attribute among the parent elements.
@@ -156,7 +175,11 @@ export function getEventTarget<T extends HTMLElement>(event: Event): T | null;
  * const firstLeaf = dom.query.getEdgeChild(container, (n) => n.nodeType === 3, false);
  * const lastLeaf = dom.query.getEdgeChild(container, (n) => n.nodeType === 3, true);
  */
-export function getEdgeChild<T extends Node>(node: Node, query: string | ((current: any) => boolean) | Node, last: boolean): T | null;
+export function getEdgeChild<T extends Node>(
+	node: Node,
+	query: string | ((current: any) => boolean) | Node,
+	last: boolean,
+): T | null;
 /**
  * @description Get edge child nodes of the argument value.
  * - 1. The first node of all the child nodes of the `first` element is returned.
@@ -197,7 +220,12 @@ export function getNextDeepestNode<T extends Node>(node: Node, ceiling?: Node |
  * @param {?(current: *) => boolean} [validate] Validation function
  * @returns {number}
  */
-export function findTextIndexOnLine(line: Node, offsetContainer: Node, offset: number, validate?: ((current: any) => boolean) | null): number;
+export function findTextIndexOnLine(
+	line: Node,
+	offsetContainer: Node,
+	offset: number,
+	validate?: ((current: any) => boolean) | null,
+): number;
 /**
  * @description Find the end index of a sequence of at least minTabSize consecutive non-breaking spaces or spaces
  * - which are interpreted as a tab key, occurring after a given base index in a text string.

package/types/helper/dom/domUtils.d.ts

@@ -53,7 +53,10 @@ export function getAttributesToString(element: Node, exceptAttrs: Array<string>
  * @param {?(current: *) => boolean} validation Conditional function
  * @returns {Array<Node>|null}
  */
-export function arrayFilter(array: SunEditor.NodeCollection, validation: ((current: any) => boolean) | null): Array<Node> | null;
+export function arrayFilter(
+	array: SunEditor.NodeCollection,
+	validation: ((current: any) => boolean) | null,
+): Array<Node> | null;
 /**
  * @description Get the item from the array that matches the condition.
  * @param {SunEditor.NodeCollection} array Array to get item

package/types/interfaces/plugins.d.ts

@@ -9,10 +9,10 @@ export class PluginBrowser extends Base {
 	/**
 	 * @abstract
 	 * @description Executes the method that is called when a `Browser` module is opened.
-	 * @param {?(target: Node) => *} [onSelectfunction] - Method to be executed after selecting an item in the gallery
+	 * @param {?(target: *) => *} [onSelectfunction] - Method to be executed after selecting an item in the gallery
 	 * @returns {void}
 	 */
-	open(onSelectfunction?: ((target: Node) => any) | null): void;
+	open(onSelectfunction?: ((target: any) => any) | null): void;
 	/**
 	 * @abstract
 	 * @description Executes the method that is called when a `Browser` module is closed.

package/types/langs/_Lang.d.ts

@@ -118,7 +118,6 @@ export type _Lang = {
 	math_modal_title: string;
 	maxSize: string;
 	mediaGallery: string;
-	autocomplete: string;
 	menu_bordered: string;
 	menu_code: string;
 	menu_neon: string;

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/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

@@ -81,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

@@ -115,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

@@ -83,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;
 }

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

@@ -78,7 +78,7 @@ declare class ImageGallery extends PluginBrowser {
 	 */
 	constructor(kernel: SunEditor.Kernel, pluginOptions: ImageGalleryPluginOptions);
 	title: any;
-	onSelectfunction: (target: Node) => any;
+	onSelectfunction: (target: any) => any;
 	browser: Browser;
 	width: any;
 	height: any;