suneditor 3.0.0-beta.7 → 3.0.0-beta.9

package/types/modules/ColorPicker.d.ts

@@ -83,8 +83,11 @@ declare class ColorPicker extends CoreInjector {
 	 * @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.
+	 * - 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>.
 	 */
-	init(nodeOrColor: Node | string, target: Node): void;
+	init(nodeOrColor: Node | string, target: Node, stopCondition?: (((current: Node) => boolean) | null) | undefined): void;
 	/**
 	 * @description Store color values
 	 * @param {string} hexColorStr Hax color value
@@ -104,6 +107,7 @@ declare class ColorPicker extends CoreInjector {
 	 * @private
 	 * @description Gets color value at color property of node
 	 * @param {Node} node Selected node
+	 * @param {(current: Node) => boolean} stopCondition - A function used to stop traversing parent nodes while finding the color.
 	 * @returns {string}
 	 */
 	private _getColorInNode;

package/types/plugins/command/blockquote.d.ts

@@ -16,6 +16,7 @@ declare class Blockquote extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/command/list_bulleted.d.ts

@@ -17,6 +17,7 @@ declare class List_bulleted extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/command/list_numbered.d.ts

@@ -17,6 +17,7 @@ declare class List_numbered extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/align.d.ts

@@ -35,6 +35,7 @@ declare class Align extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/backgroundColor.d.ts

@@ -38,6 +38,7 @@ declare class BackgroundColor extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/font.d.ts

@@ -34,6 +34,7 @@ declare class Font extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/fontColor.d.ts

@@ -38,6 +38,7 @@ declare class FontColor extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/formatBlock.d.ts

@@ -29,6 +29,7 @@ declare class FormatBlock extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/lineHeight.d.ts

@@ -32,6 +32,7 @@ declare class LineHeight extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/dropdown/list.d.ts

@@ -20,6 +20,7 @@ declare class List extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/input/fontSize.d.ts

@@ -114,6 +114,7 @@ declare class FontSize extends EditorInjector {
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @param {?HTMLElement=} target - The plugin's toolbar button element
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined, target?: (HTMLElement | null) | undefined): boolean;
 	/**

package/types/plugins/modal/link.d.ts

@@ -86,6 +86,7 @@ declare class Link extends EditorInjector {
 	 * @description Executes the method that is called whenever the cursor position changes.
 	 * @param {?HTMLElement=} element - Node element where the cursor is currently located
 	 * @returns {boolean} - Whether the plugin is active
+	 * - If it returns "undefined", it will no longer be called in this scope.
 	 */
 	active(element?: (HTMLElement | null) | undefined): boolean;
 	/**