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

package/types/helper/clipboard.d.ts

@@ -1,11 +1,12 @@
+import type {} from '../typedef';
 /**
  * @description Write the content to the clipboard
- * - Iframe is replaced with a placeholder : <div data-se-iframe-holder-src="iframe.src">[iframe: iframe.src]</div>
- * - "iframe placeholder" is re-rendered in html.clean when pasted into the editor.
+ * - Iframe is replaced with a placeholder : `<div data-se-iframe-holder-src="iframe.src">[iframe: iframe.src]</div>`
+ * - `iframe placeholder` is re-rendered in `html.clean` when pasted into the editor.
  * @param {Element|Text|string} content Content to be copied to the clipboard
- * @returns {Promise<void>}
+ * @returns {Promise<void|false>} If it fails, it returns `false`.
  */
-export function write(content: Element | Text | string): Promise<void>;
+export function write(content: Element | Text | string): Promise<void | false>;
 declare namespace _default {
 	export { write };
 }

package/types/helper/converter.d.ts

@@ -1,7 +1,13 @@
+import type {} from '../typedef';
 /**
  * @description Parses an HTML string into a DOM tree, then recursively traverses the nodes to convert them into a structured JSON representation.
- * -Each element includes its tag name, attributes, and children.
- * -Text nodes are represented as { type: 'text', content: '...' }.
+ * - Each element includes its tag name, attributes, and children.
+ * - Text nodes are represented as `{ type: 'text', content: '...' }`.
+ * @example
+ * const json = converter.htmlToJson('<p class="txt">Hello</p>');
+ * // { type: 'element', tag: 'p', attributes: { class: 'txt' }, children: [
+ * //   { type: 'text', content: 'Hello' }
+ * // ]}
  * @param {string} content HTML string
  * @returns {Object<string, *>} JSON data
  */
@@ -10,9 +16,15 @@ export function htmlToJson(content: string): {
 };
 /**
  * @description Takes a JSON structure representing HTML elements and recursively serializes it into a valid HTML string.
- * -It rebuilds each tag with attributes and inner content.
+ * - It rebuilds each tag with attributes and inner content.
  * Text content and attributes are safely escaped to prevent parsing issues or XSS.
  * Useful for restoring dynamic HTML from a data format.
+ * @example
+ * const html = converter.jsonToHtml({
+ *   type: 'element', tag: 'p', attributes: { class: 'txt' },
+ *   children: [{ type: 'text', content: 'Hello' }],
+ * });
+ * // '<p class="txt">Hello</p>'
  * @param {Object<string, *>} jsonData
  * @returns {string} HTML string
  */
@@ -21,7 +33,6 @@ export function jsonToHtml(jsonData: { [x: string]: any }): string;
  * @description Convert HTML string to HTML Entity
  * @param {string} content
  * @returns {string} Content string
- * @private
  */
 export function htmlToEntity(content: string): string;
 /**
@@ -59,35 +70,40 @@ export function mergeMaps(...mapsToMerge: Map<any, any>[]): Map<any, any>;
  */
 export function getValues(obj: any): Array<any>;
 /**
- * @description Convert the CamelCase To the KebabCase.
+ * @description Convert the `CamelCase` To the `KebabCase`.
  * @param {string|Array<string>} param [Camel string]
  */
 export function camelToKebabCase(param: string | Array<string>): any;
 /**
  * @overload
- * @param {string} param - Kebab-case string.
- * @returns {string} CamelCase string.
+ * @param {string} param - `Kebab-case` string.
+ * @returns {string} `CamelCase` string.
  */
 export function kebabToCamelCase(param: string): string;
 /**
  * @overload
- * @param {Array<string>} param - Array of Kebab-case strings.
- * @returns {Array<string>} Array of CamelCase strings.
+ * @param {Array<string>} param - Array of `Kebab-case` strings.
+ * @returns {Array<string>} Array of `CamelCase` strings.
  */
 export function kebabToCamelCase(param: Array<string>): Array<string>;
 /**
- *
+ * @description Converts a font size string from one CSS unit to another.
+ * @example
+ * converter.toFontUnit('px', '1rem');   // '16px'
+ * converter.toFontUnit('em', '16px');   // '1.00em'
+ * converter.toFontUnit('pt', '16px');   // '12pt'
+ * converter.toFontUnit('%', '16px');    // '100%'
  * @param {"em"|"rem"|"%"|"pt"|"px"} to Size units to be converted
- * @param {string} size siSize to convert with units (ex: "15rem")
+ * @param {string} size Size to convert with units (ex: `"15rem"`)
  * @returns {string}
  */
 export function toFontUnit(to: 'em' | 'rem' | '%' | 'pt' | 'px', size: string): string;
 /**
  * @description Convert the node list to an array. If not, returns an empty array.
- * @param {?__se__NodeCollection} nodeList
+ * @param {?SunEditor.NodeCollection} [nodeList]
  * @returns Array
  */
-export function nodeListToArray(nodeList: __se__NodeCollection | null): any;
+export function nodeListToArray(nodeList?: SunEditor.NodeCollection | null): any;
 /**
  * @description Returns a new object with keys and values swapped.
  * @param {Object<*, *>} obj object
@@ -95,14 +111,14 @@ export function nodeListToArray(nodeList: __se__NodeCollection | null): any;
  */
 export function swapKeyValue(obj: any): any;
 /**
- * @description Create whitelist RegExp object.
- * @param {string} list Tags list ("br|p|div|pre...")
+ * @description Create whitelist `RegExp` object.
+ * @param {string} list Tags list (`"br|p|div|pre..."`)
  * @returns {RegExp} Return RegExp format: new RegExp("<\\/?\\b(?!" + list + ")\\b[^>^<]*+>", "gi")
  */
 export function createElementWhitelist(list: string): RegExp;
 /**
- * @description Create blacklist RegExp object.
- * @param {string} list Tags list ("br|p|div|pre...")
+ * @description Create blacklist `RegExp` object.
+ * @param {string} list Tags list (`"br|p|div|pre..."`)
  * @returns {RegExp} Return RegExp format: new RegExp("<\\/?\\b(?:" + list + ")\\b[^>^<]*+>", "gi")
  */
 export function createElementBlacklist(list: string): RegExp;
@@ -112,7 +128,7 @@ export function createElementBlacklist(list: string): RegExp;
  */
 export function isHexColor(str: string): boolean;
 /**
- * @description Function to convert hex format to a rgb color
+ * @description Function to convert hex format to a `rgb` color
  * @param {string} rgba RGBA color format
  * @returns {string}
  */
@@ -120,19 +136,19 @@ export function rgb2hex(rgba: string): string;
 /**
  * @description Computes the width as a percentage of the parent's width, and returns this value rounded to two decimal places.
  * @param {HTMLElement} target The target element for which to calculate the width percentage.
- * @param {?HTMLElement=} parentTarget The parent element to use as the reference for the width calculation. If not provided, the target's parent element is used.
+ * @param {?HTMLElement} [parentTarget] The parent element to use as the reference for the width calculation. If not provided, the target's parent element is used.
  * @returns {number}
  */
-export function getWidthInPercentage(target: HTMLElement, parentTarget?: (HTMLElement | null) | undefined): number;
+export function getWidthInPercentage(target: HTMLElement, parentTarget?: HTMLElement | null): number;
 /**
  * @description Convert url pattern text node to anchor node
  * @param {Node} node Text node
- * @returns {boolean} Return true if the text node is converted to an anchor node
+ * @returns {boolean} Return `true` if the text node is converted to an anchor node
  */
 export function textToAnchor(node: Node): boolean;
 /**
- * Converts styles within a <span> tag to corresponding HTML tags (e.g., <strong>, <em>, <u>, <s>).
- * Maintains the original <span> tag and wraps its content with the new tags.
+ * Converts styles within a `<span>` tag to corresponding HTML tags (e.g., `<strong>`, `<em>`, `<u>`, `<s>`).
+ * Maintains the original `<span>` tag and wraps its content with the new tags.
  * @param {{ regex: RegExp, tag: string }} styleToTag An object mapping style properties to HTML tags. ex) {bold: { regex: /font-weight\s*:\s*bold/i, tag: 'strong' },}
  * @param {Node} node Node
  */
@@ -141,7 +157,7 @@ export function spanToStyleNode(
 		regex: RegExp;
 		tag: string;
 	},
-	node: Node
+	node: Node,
 ): void;
 /**
  * Adds a query string to a URL. If the URL already contains a query string, the new query is appended to the existing one.
@@ -150,34 +166,30 @@ export function spanToStyleNode(
  * @returns {string} The updated URL with the query string appended.
  */
 export function addUrlQuery(url: string, query: string): string;
+/**
+ * @typedef {import('../core/schema/options').OptionStyleResult} OptionStyleResult_converter
+ */
 /**
  * @description Converts options-related styles and returns them for each frame.
- * @param {Map<string, *>} fo editor.frameOptions
+ * @param {SunEditor.FrameOptions} fo `editor.frameOptions`
  * @param {string} cssText Style string
- * @returns {{top: string, frame: string, editor: string}}
- * @private
- */
-export function _setDefaultOptionStyle(
-	fo: Map<string, any>,
-	cssText: string
-): {
-	top: string;
-	frame: string;
-	editor: string;
-};
+ * @returns {OptionStyleResult_converter}
+ */
+export function _setDefaultOptionStyle(fo: SunEditor.FrameOptions, cssText: string): OptionStyleResult_converter;
 /**
- * @description Set default style tag of the iframe
- * @param {Array<string>} linkNames link names array of CSS files
- * @returns {string} "<link rel="stylesheet" href=".." />.."
+ * @description Set default style tag of the `iframe`
+ * @param {Array<string>} linkNames link names array of CSS files or `'*'` for all stylesheets
+ * @returns {string} `"<link rel="stylesheet" href=".." />.."`
  */
 export function _setIframeStyleLinks(linkNames: Array<string>): string;
 /**
- * @description When iframe height options is "auto" return "<style>" tag that required.
- * @param {string} frameHeight height
- * @returns {string} "<style>...</style>"
+ * @description When `iframe` height options is `"auto"` return `"<style>"` tag that required.
+ * @param {string|number} frameHeight height
+ * @returns {string} `"<style>...</style>"`
  */
-export function _setAutoHeightStyle(frameHeight: string): string;
+export function _setAutoHeightStyle(frameHeight: string | number): string;
 export default converter;
+export type OptionStyleResult_converter = import('../core/schema/options').OptionStyleResult;
 declare namespace converter {
 	export { htmlToJson };
 	export { jsonToHtml };

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

@@ -1,5 +1,6 @@
+import type {} from '../../typedef';
 /**
- * @description A method that checks If the text is blank or to see if it contains 'ZERO WIDTH SPACE' or empty (unicode.zeroWidthSpace)
+ * @description A method that checks If the text is blank or to see if it contains `ZERO WIDTH SPACE` or empty (`unicode.zeroWidthSpace`)
  * @param {string|Node} text String value or Node
  * @returns {boolean}
  */
@@ -8,34 +9,34 @@ export function isZeroWidth(text: string | Node): boolean;
  * @description Determine if this offset is the edge offset of container
  * @param {Node} container The node of the selection object. (range.startContainer..)
  * @param {number} offset The offset of the selection object. (core.getRange().startOffset...)
- * @param {?"front"|"end"=} dir Select check point - Both edge, Front edge or End edge. ("front": Front edge, "end": End edge, undefined: Both edge)
+ * @param {?("front"|"end")} [dir] Select check point - Both edge, Front edge or End edge. (`"front"`: Front edge, `"end"`: End edge, `undefined`: Both edge)
  * @returns {boolean}
  */
-export function isEdgePoint(container: Node, offset: number, dir?: (('front' | 'end') | null) | undefined): boolean;
+export function isEdgePoint(container: Node, offset: number, dir?: ('front' | 'end') | null): boolean;
 /**
  * @description Check the node is a text node.
- * @param {?Node} node The node to check
+ * @param {?*} node The node to check
  * @returns {node is Text}
  */
-export function isText(node: Node | null): node is Text;
+export function isText(node: any | null): node is Text;
 /**
  * @description Check the node is an HTMLElement node.
- * @param {?Node} node The node to check
+ * @param {?*} node The node to check
  * @returns {node is HTMLElement}
  */
-export function isElement(node: Node | null): node is HTMLElement;
+export function isElement(node: any | null): node is HTMLElement;
 /**
  * @description It is judged whether it is the input element (INPUT, TEXTAREA)
- * @param {?Node} node The node to check
+ * @param {?*} node The node to check
  * @returns {node is HTMLInputElement}
  */
-export function isInputElement(node: Node | null): node is HTMLInputElement;
+export function isInputElement(node: any | null): node is HTMLInputElement;
 /**
  * @description It is judged whether it is the button element
- * @param {?Node} node The node to check
+ * @param {?*} node The node to check
  * @returns {node is HTMLButtonElement}
  */
-export function isButtonElement(node: Node | null): node is HTMLButtonElement;
+export function isButtonElement(node: any | null): node is HTMLButtonElement;
 /**
  * @description Check the node is a list (ol, ul)
  * @param {?Node|string} node The element or element name to check
@@ -109,25 +110,31 @@ export function isFigure(node: (Node | string) | null): boolean;
  */
 export function isContentLess(node: (Node | string) | null): boolean;
 /**
- * @description Check the line element is empty.
- * @param {Node} node "line" element node
+ * @description Check the `line` element is empty.
+ * @param {Node} node `line` element node
  * @returns {boolean}
  */
 export function isEmptyLine(node: Node): boolean;
 /**
- * @description It is judged whether it is the edit region top div element or iframe's body tag.
+ * @description Checks if the given node is a container component (class `se-component-container`).
+ * @param {Node} element
+ * @returns {boolean} `true` if the node is a container component, otherwise `false`.
+ */
+export function isComponentContainer(element: Node): boolean;
+/**
+ * @description It is judged whether it is the edit region top `div` element or `iframe`'s `body` tag.
  * @param {?Node} node The node to check
  * @returns {node is HTMLElement}
  */
 export function isWysiwygFrame(node: Node | null): node is HTMLElement;
 /**
- * @description It is judged whether it is the contenteditable property is false.
+ * @description It is judged whether it is the `contenteditable` property is `false`.
  * @param {?Node} node The node to check
  * @returns {node is HTMLElement}
  */
 export function isNonEditable(node: Node | null): node is HTMLElement;
 /**
- * @description Check the span's attributes are empty.
+ * @description Check the `span`'s attributes are empty.
  * @param {?Node} node Element node
  * @returns {boolean}
  */
@@ -140,14 +147,14 @@ export function isSpanWithoutAttr(node: Node | null): boolean;
  */
 export function isSameAttributes(a: Node, b: Node): boolean;
 /**
- * @description It is judged whether it is the not checking node. (class="katex", "MathJax", "se-exclude-format")
+ * @description It is judged whether it is the not checking node. (class=`katex`, `MathJax`, `se-exclude-format`)
  * @param {Node} node The node to check
  * @returns {node is HTMLElement}
  */
 export function isExcludeFormat(node: Node): node is HTMLElement;
 /**
- * @description Checks for "__se__uneditable" in the class list.
- * - Components with class "__se__uneditable" cannot be modified.
+ * @description Checks for `__se__uneditable` in the class list.
+ * - Components with class `__se__uneditable` cannot be modified.
  * @param {Node} node The element to check
  * @returns {boolean}
  */
@@ -179,6 +186,7 @@ declare namespace check {
 	export { isFigure };
 	export { isContentLess };
 	export { isEmptyLine };
+	export { isComponentContainer };
 	export { isWysiwygFrame };
 	export { isNonEditable };
 	export { isSpanWithoutAttr };

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

@@ -1,3 +1,4 @@
+import type {} from '../../typedef';
 /**
  * @description Returns the index compared to other sibling nodes.
  * @param {Node} node The Node to find index
@@ -5,53 +6,61 @@
  */
 export function getPositionIndex(node: Node): number;
 /**
- * @description Returns the position of the "node" in the "parentNode" in a numerical array.
+ * @description Returns the position of the `node` in the `parentNode` in a numerical array.
  * - e.g.) <p><span>aa</span><span>bb</span></p> : getNodePath(node: "bb", parentNode: "<P>") -> [1, 0]
  * @param {Node} node The Node to find position path
- * @param {?Node} parentNode Parent node. If null, wysiwyg div area
- * @param {?{s: number, e: number}=} _newOffsets If you send an object of the form "{s: 0, e: 0}", the text nodes that are attached together are merged into one, centered on the "node" argument.
- * "_newOffsets.s" stores the length of the combined characters after "node" and "_newOffsets.e" stores the length of the combined characters before "node".
+ * @param {?Node} parentNode Parent node. If `null`, wysiwyg `div` area
+ * @param {?{s: number, e: number}} [_newOffsets] If you send an object of the form `{s: 0, e: 0}`, the text nodes that are attached together are merged into one, centered on the `node` argument.
+ * `_newOffsets.s` stores the length of the combined characters after `node` and `_newOffsets.e` stores the length of the combined characters before `node`.
  * Do not use unless absolutely necessary.
  * @returns {Array<number>}
  */
 export function getNodePath(
 	node: Node,
 	parentNode: Node | null,
-	_newOffsets?:
-		| ({
-				s: number;
-				e: number;
-		  } | null)
-		| undefined
+	_newOffsets?: {
+		s: number;
+		e: number;
+	} | null,
 ): Array<number>;
 /**
  * @template {Node} T
- * @description Returns the node in the location of the path array obtained from "helper.dom.getNodePath".
- * @param {Array<number>} offsets Position array, array obtained from "helper.dom.getNodePath"
+ * @description Returns the node in the location of the path array obtained from `helper.dom.getNodePath`.
+ * @param {Array<number>} offsets Position array, array obtained from `helper.dom.getNodePath`
  * @param {Node} parentNode Base parent element
  * @returns {T}
  */
 export function getNodeFromPath<T extends Node>(offsets: Array<number>, parentNode: Node): T;
 /**
  * @template {HTMLElement} T
- * @description Get all "children" of the argument value element (Without text nodes)
+ * @description Get all `child node` of the argument value element
  * @param {Node} element element to get child node
  * @param {?(current: *) => boolean} validation Conditional function
+ * @returns {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)
+ * @param {Node} element element to get child node
+ * @param {?(current: *) => boolean} validation Conditional function
+ * @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): 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)
+ * @description Get all `childNodes` of the argument value element (Include text nodes)
  * @param {Node} element element to get child node
  * @param {?(current: *) => boolean} validation Conditional function
+ * @param {?number} depth Number of child levels to depth.
  * @returns {Array<T>}
  */
-export function getListChildNodes<T extends Node>(element: Node, validation: ((current: any) => boolean) | 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.
- * - '-1' when the element argument is the WYSIWYG area.
+ * - `0` when the parent node is the WYSIWYG area.
+ * - `-1` when the element argument is the WYSIWYG area.
  * @param {Node} node The element to check
  * @returns {number}
  */
@@ -59,18 +68,18 @@ export function getNodeDepth(node: Node): number;
 /**
  * @description Sort a node array by depth of element.
  * @param {Array<Node>} array Node array
- * @param {boolean} des true: descending order / false: ascending order
+ * @param {boolean} des `true`: descending order / `false`: ascending order
  */
 export function sortNodeByDepth(array: Array<Node>, des: boolean): void;
 /**
  * @description Compares two elements to find a common ancestor, and returns the order of the two elements.
  * @param {Node} a Node to compare.
  * @param {Node} b Node to compare.
- * @returns {{ancestor: HTMLElement|null, a: Node, b: Node, result: number}} { ancesstor, a, b, result: (a > b ? 1 : a < b ? -1 : 0) };
+ * @returns {{ancestor: ?HTMLElement, a: Node, b: Node, result: number}} { ancesstor, a, b, result: (a > b ? 1 : a < b ? -1 : 0) };
  */
 export function compareElements(
 	a: Node,
-	b: Node
+	b: Node,
 ): {
 	ancestor: HTMLElement | null;
 	a: Node;
@@ -81,29 +90,38 @@ export function compareElements(
  * @template {HTMLElement} T
  * @description Get the parent element of the argument value.
  * - A tag that satisfies the query condition is imported.
+ * @example
+ * // Find by tag name
+ * const table = dom.query.getParentElement(cell, 'TABLE');
+ *
+ * // Find by CSS class
+ * const wrapper = dom.query.getParentElement(node, '.se-wrapper');
+ *
+ * // Find by validation function
+ * const line = dom.query.getParentElement(node, (el) => el.nodeType === 1);
  * @param {Node} element Reference element
- * @param {string|((current: *) => boolean)|Node} query Query String (nodeName, .className, #ID, :name) or validation function.
+ * @param {string|((current: *) => boolean)|Node} query Query String (`nodeName`, `.className`, `#ID`, `:name`) or validation function.
  * - Not use it like jquery.
  * - Only one condition can be entered at a time.
- * @param {?number=} depth Number of parent levels to depth.
- * @returns {T|null} Not found: null
+ * @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) | undefined): 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.
  * - Get all tags that satisfy the query condition.
  * @param {Node} element Reference element
- * @param {string|((current: *) => boolean)|Node} query Query String (nodeName, .className, #ID, :name) or validation function.
+ * @param {string|((current: *) => boolean)|Node} query Query String (`nodeName`, `.className`, `#ID`, `:name`) or validation function.
  * Not use it like jquery.
  * Only one condition can be entered at a time.
- * @param {?number=} depth Number of parent levels to depth.
+ * @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) | undefined): 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.
+ * @description Gets the element with `data-command` attribute among the parent elements.
  * @param {Node} target Target element
  * @returns {T|null}
  */
@@ -120,25 +138,25 @@ export function getEventTarget<T extends HTMLElement>(event: Event): T | null;
  * @description Get the child element of the argument value.
  * - A tag that satisfies the query condition is imported.
  * @param {Node} node Reference element
- * @param {string|((current: *) => boolean)|Node} query Query String (nodeName, .className, #ID, :name) or validation function.
- * @param {boolean} last If true returns the last node among the found child nodes. (default: first node)
+ * @param {string|((current: *) => boolean)|Node} query Query String (`nodeName`, `.className`, `#ID`, `:name`) or validation function.
+ * @param {boolean} last If `true` returns the last node among the found child nodes. (default: first node)
  * Not use it like jquery.
  * Only one condition can be entered at a time.
- * @returns {T|null} Not found: null
+ * @returns {T|null} Not found: `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.
- * - 2. The last node of all the child nodes of the "last" element is returned.
- * - 3. When there is no "last" element, the first and last nodes of all the children of the "first" element are returned.
+ * - 1. The first node of all the child nodes of the `first` element is returned.
+ * - 2. The last node of all the child nodes of the `last` element is returned.
+ * - 3. When there is no `last` element, the first and last nodes of all the children of the `first` element are returned.
  * @param {Node} first First element
- * @param {Node|null} last Last element
- * @returns {{sc: Node, ec: Node}} { sc: "first", ec: "last" }
+ * @param {?Node} last Last element
+ * @returns {{sc: Node, ec: Node}} { sc: `first`, ec: `last` }
  */
 export function getEdgeChildNodes(
 	first: Node,
-	last: Node | null
+	last: Node | null,
 ): {
 	sc: Node;
 	ec: Node;
@@ -147,31 +165,31 @@ export function getEdgeChildNodes(
  * @template {Node} T
  * @description Gets the previous sibling last child. If there is no sibling, then it'll take it from the closest ancestor with child
  * @param {Node} node Reference element
- * @param {?Node=} ceiling Highest boundary allowed
- * @returns {T|null} Not found: null
+ * @param {?Node} [ceiling] Highest boundary allowed
+ * @returns {T|null} Not found: `null`
  */
-export function getPreviousDeepestNode<T extends Node>(node: Node, ceiling?: (Node | null) | undefined): T | null;
+export function getPreviousDeepestNode<T extends Node>(node: Node, ceiling?: Node | null): T | null;
 /**
  * @template {Node} T
  * @description Gets the next sibling first child. If there is no sibling, then it'll take it from the closest ancestor with child
  * @param {Node} node Reference element
- * @param {?Node=} ceiling Highest boundary allowed
- * @returns {T|null} Not found: null
+ * @param {?Node} [ceiling] Highest boundary allowed
+ * @returns {T|null} Not found: `null`
  */
-export function getNextDeepestNode<T extends Node>(node: Node, ceiling?: (Node | null) | undefined): T | null;
+export function getNextDeepestNode<T extends Node>(node: Node, ceiling?: Node | null): T | null;
 /**
- * @description Find the index of the text node in the line element.
- * @param {Node} line Line element (p, div, etc.)
+ * @description Find the index of the text node in the `line` element.
+ * @param {Node} line `line` element (p, div, etc.)
  * @param {Node} offsetContainer Base node to start searching
  * @param {number} offset Base offset to start searching
- * @param {?(current: *) => boolean=} validate Validation function
+ * @param {?(current: *) => boolean} [validate] Validation function
  * @returns {number}
  */
-export function findTextIndexOnLine(line: Node, offsetContainer: Node, offset: number, validate?: (((current: any) => boolean) | null) | undefined): 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.
- * @param {Node} line Line element (p, div, etc.)
+ * @param {Node} line `line` element (p, div, etc.)
  * @param {number} baseIndex Base index to start searching
  * @param {number} minTabSize Minimum number of consecutive spaces to consider as a tab
  * @returns {number} The adjusted index within the line element accounting for non-space characters
@@ -179,21 +197,21 @@ export function findTextIndexOnLine(line: Node, offsetContainer: Node, offset: n
 export function findTabEndIndex(line: Node, baseIndex: number, minTabSize: number): number;
 /**
  * @description Finds the table cell that appears visually at the bottom-right position,
- * considering both rowSpan and colSpan, even if smaller cells are placed after large merged cells.
+ * considering both `rowSpan` and `colSpan`, even if smaller cells are placed after large merged cells.
  *
  * @param {HTMLTableCellElement[]} cells
  * @returns {HTMLTableCellElement|null}
  */
 export function findVisualLastCell(cells: HTMLTableCellElement[]): HTMLTableCellElement | null;
 /**
- * @description Get nearest scrollable parent
- * @param {Node} element Element
- * @returns {HTMLElement|null}
+ * @description Finds and returns parent containers that are scrollable.
+ * @param {HTMLElement} element - Element to start with
+ * @returns {HTMLElement[]} - Array (in descending order)
  */
-export function getScrollParent(element: Node): HTMLElement | null;
+export function getScrollParents(element: HTMLElement): HTMLElement[];
 /**
- * @description Get the argument iframe's document object if use the "iframe" or "fullPage" options
- * @param {HTMLIFrameElement} iframe Iframe element (this.editor.frameContext.get('wysiwygFrame'))
+ * @description Get the argument iframe's document object if use the `iframe` or `fullPage` options
+ * @param {HTMLIFrameElement} iframe Iframe element (`this.frameContext.get('wysiwygFrame')`)
  * @returns {Document}
  */
 export function getIframeDocument(iframe: HTMLIFrameElement): Document;
@@ -202,6 +220,7 @@ declare namespace query {
 	export { getPositionIndex };
 	export { getNodePath };
 	export { getNodeFromPath };
+	export { getChildNode };
 	export { getListChildren };
 	export { getListChildNodes };
 	export { getNodeDepth };
@@ -218,6 +237,6 @@ declare namespace query {
 	export { findTextIndexOnLine };
 	export { findTabEndIndex };
 	export { findVisualLastCell };
-	export { getScrollParent };
+	export { getScrollParents };
 	export { getIframeDocument };
 }