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

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

@@ -1,53 +1,85 @@
+import type {} from '../../typedef';
 export default FileUpload;
+export type FileUploadPluginOptions = {
+	/**
+	 * - Server request URL for file upload
+	 */
+	uploadUrl: string;
+	/**
+	 * - Server request headers
+	 */
+	uploadHeaders?: {
+		[x: string]: string;
+	};
+	/**
+	 * - Total upload size limit in bytes
+	 */
+	uploadSizeLimit?: number;
+	/**
+	 * - Single file size limit in bytes
+	 */
+	uploadSingleSizeLimit?: number;
+	/**
+	 * - Allow multiple file uploads
+	 */
+	allowMultiple?: boolean;
+	/**
+	 * - Accepted file formats (e.g., 'image/*, .pdf')
+	 */
+	acceptedFormats?: string;
+	/**
+	 * - Specify the default form of the file component as `box` or `link`
+	 */
+	as?: string;
+	/**
+	 * - Additional controls to be added to the figure
+	 */
+	controls?: Array<string>;
+	/**
+	 * - Component insertion behavior for selection and cursor placement. [default: `options.get('componentInsertBehavior')`]
+	 * - `auto`: Move cursor to the next line if possible, otherwise select the component.
+	 * - `select`: Always select the inserted component.
+	 * - `line`: Move cursor to the next line if possible, or create a new line and move there.
+	 * - `none`: Do nothing.
+	 */
+	insertBehavior?: SunEditor.ComponentInsertType;
+};
+/**
+ * @typedef FileUploadPluginOptions
+ * @property {string} uploadUrl - Server request URL for file upload
+ * @property {Object<string, string>} [uploadHeaders] - Server request headers
+ * @property {number} [uploadSizeLimit] - Total upload size limit in bytes
+ * @property {number} [uploadSingleSizeLimit] - Single file size limit in bytes
+ * @property {boolean} [allowMultiple=false] - Allow multiple file uploads
+ * @property {string} [acceptedFormats="*"] - Accepted file formats (e.g., 'image/*, .pdf')
+ * @property {string} [as="box"] - Specify the default form of the file component as `box` or `link`
+ * @property {Array<string>} [controls] - Additional controls to be added to the figure
+ * @property {SunEditor.ComponentInsertType} [insertBehavior] - Component insertion behavior for selection and cursor placement. [default: `options.get('componentInsertBehavior')`]
+ * - `auto`: Move cursor to the next line if possible, otherwise select the component.
+ * - `select`: Always select the inserted component.
+ * - `line`: Move cursor to the next line if possible, or create a new line and move there.
+ * - `none`: Do nothing.
+ */
 /**
  * @class
  * @description File upload plugin
  */
-declare class FileUpload extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class FileUpload extends PluginCommand {
 	static options: {
 		eventIndex: number;
 	};
 	/**
-	 * @this {FileUpload}
 	 * @param {HTMLElement} node - The node to check.
 	 * @returns {HTMLElement|null} Returns a node if the node is a valid component.
 	 */
-	static component(this: FileUpload, node: HTMLElement): HTMLElement | null;
+	static component(node: HTMLElement): HTMLElement | null;
 	/**
 	 * @constructor
-	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions - plugin options
-	 * @param {string} pluginOptions.uploadUrl - server request url
-	 * @param {Object<string, string>=} pluginOptions.uploadHeaders - server request headers
-	 * @param {string=} pluginOptions.uploadSizeLimit - upload size limit
-	 * @param {string=} pluginOptions.uploadSingleSizeLimit - upload single size limit
-	 * @param {boolean=} pluginOptions.allowMultiple - allow multiple files
-	 * @param {string=} pluginOptions.acceptedFormats - accepted formats
-	 * @param {string=} pluginOptions.as - Whether to use the 'Box' or 'Link' conversion button
-	 * @param {Array<string>} pluginOptions.controls - Additional controls to be added to the figure
+	 * @param {SunEditor.Kernel} editor - The core kernel
+	 * @param {FileUploadPluginOptions} pluginOptions - plugin options
 	 */
-	constructor(
-		editor: __se__EditorCore,
-		pluginOptions: {
-			uploadUrl: string;
-			uploadHeaders?:
-				| {
-						[x: string]: string;
-				  }
-				| undefined;
-			uploadSizeLimit?: string | undefined;
-			uploadSingleSizeLimit?: string | undefined;
-			allowMultiple?: boolean | undefined;
-			acceptedFormats?: string | undefined;
-			as?: string | undefined;
-			controls: Array<string>;
-		}
-	);
+	constructor(editor: SunEditor.Kernel, pluginOptions: FileUploadPluginOptions);
 	title: any;
-	icon: string;
 	uploadUrl: string;
 	uploadHeaders: {
 		[x: string]: string;
@@ -56,72 +88,35 @@ declare class FileUpload extends EditorInjector {
 	uploadSingleSizeLimit: number;
 	allowMultiple: boolean;
 	acceptedFormats: string;
-	_acceptedCheck: string[];
 	as: string;
+	insertBehavior: SunEditor.ComponentInsertType;
 	input: HTMLElement;
-	_element: HTMLElement;
 	figure: Figure;
 	fileManager: FileManager;
 	controller: Controller;
 	editInput: HTMLInputElement;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the main execution method of the plugin.
-	 * - It is executed by clicking a toolbar "command" button or calling an API.
-	 */
-	action(): void;
-	/**
-	 * @editorMethod Editor.Component
-	 * @description Executes the method that is called when a component of a plugin is selected.
-	 * @param {HTMLElement} target Target component element
-	 */
-	select(target: HTMLElement): boolean;
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the event function of "paste" or "drop".
-	 * @param {Object} params { frameContext, event, file }
-	 * @param {__se__FrameContext} params.frameContext Frame context
-	 * @param {ClipboardEvent} params.event Event object
-	 * @param {File} params.file File object
-	 * @returns {boolean} - If return false, the file upload will be canceled
-	 */
-	onFilePasteAndDrop({ file }: { frameContext: __se__FrameContext; event: ClipboardEvent; file: File }): boolean;
-	/**
-	 * @editorMethod Modules.Controller
-	 * @description Executes the method that is called when a target component is edited.
-	 * @param {HTMLElement|Text} target Target element
-	 */
-	edit(target: HTMLElement | Text): void;
-	/**
-	 * @editorMethod Modules.Controller
-	 * @description Executes the method that is called when a button is clicked in the "controller".
-	 * @param {HTMLButtonElement} target Target button element
-	 */
+	onFilePasteAndDrop(params: SunEditor.HookParams.FilePasteDrop): void;
 	controllerAction(target: HTMLButtonElement): void;
+	componentSelect(target: HTMLElement): void | boolean;
+	componentEdit(target: HTMLElement): void;
+	componentDestroy(target: HTMLElement): Promise<void>;
 	/**
-	 * @editorMethod Editor.Component
-	 * @description Method to delete a component of a plugin, called by the "FileManager", "Controller" module.
-	 * @param {HTMLElement} target Target element
-	 * @returns {Promise<void>}
-	 */
-	destroy(target: HTMLElement): Promise<void>;
-	/**
-	 * @description Create an "file" component using the provided files.
+	 * @description Create a `file` component using the provided files.
 	 * @param {File[]|FileList} fileList File object list
 	 * @returns {Promise<boolean>} If return false, the file upload will be canceled
 	 */
 	submitFile(fileList: File[] | FileList): Promise<boolean>;
 	/**
-	 * @description Convert format to link or block
+	 * @description Convert format to `link` or `block`
 	 * @param {HTMLElement} target Target element
-	 * @param {string} value 'link' or 'block'
+	 * @param {string} value `link` or `block`
 	 */
 	convertFormat(target: HTMLElement, value: string): void;
 	/**
 	 * @description Create file element
 	 * @param {string} url File URL
 	 * @param {File|{name: string, size: number}} file File object
-	 * @param {boolean} isLast Is last file
+	 * @param {boolean} isLast Indicates whether this is the last file in the batch (used for scroll and insert actions).
 	 */
 	create(
 		url: string,
@@ -131,26 +126,11 @@ declare class FileUpload extends EditorInjector {
 					name: string;
 					size: number;
 			  },
-		isLast: boolean
+		isLast: boolean,
 	): void;
-	/**
-	 * @private
-	 * @description Processes the server response after file upload.
-	 * - Registers the uploaded files in the editor.
-	 * @param {Object<string, *>} response - The response object from the server.
-	 */
-	private _register;
-	/**
-	 * @private
-	 * @description Handles file upload errors.
-	 * - Displays an error message if the upload fails.
-	 * @param {Object<string, *>} response - The error response from the server.
-	 * @returns {Promise<void>}
-	 */
-	private _error;
 	#private;
 }
-import EditorInjector from '../../editorInjector';
-import { Figure } from '../../modules';
-import { FileManager } from '../../modules';
-import { Controller } from '../../modules';
+import { PluginCommand } from '../../interfaces';
+import { Figure } from '../../modules/contract';
+import { Controller } from '../../modules/contract';
+import { FileManager } from '../../modules/manager';

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

@@ -1,47 +1,21 @@
+import type {} from '../../typedef';
 export default List_bulleted;
 /**
  * @class
+ * @implements {PluginDropdown}
  * @description List bulleted plugin, Several types of lists are provided.
  */
-declare class List_bulleted extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class List_bulleted extends PluginCommand implements PluginDropdown {
 	title: any;
-	icon: string;
-	afterItem: HTMLElement;
-	listItems: NodeListOf<Element>;
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the method that is called whenever the cursor position changes.
-	 * @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;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's dropdown menu is opened.
-	 */
-	on(): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the main execution method of the plugin.
-	 * - Called when an item in the "dropdown" menu is clicked.
-	 * @param {HTMLElement} target - The plugin's toolbar button element
-	 */
-	action(target: HTMLElement): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes methods called by shortcut keys.
-	 * @param {__se__PluginShortcutInfo} params - Information of the "shortcut" plugin
-	 */
-	shortcut({ range, info }: __se__PluginShortcutInfo): void;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	on(target?: HTMLElement): void;
+	shortcut(params: SunEditor.HookParams.Shortcut): void;
 	/**
 	 * @description Add a bulleted list
 	 * @param {string} [type=""] List type
 	 */
 	submit(type?: string): void;
+	#private;
 }
-import EditorInjector from '../../editorInjector';
+import { PluginDropdown } from '../../interfaces';
+import { PluginCommand } from '../../interfaces';

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

@@ -1,47 +1,21 @@
+import type {} from '../../typedef';
 export default List_numbered;
 /**
  * @class
+ * @implements {PluginDropdown}
  * @description List numbered plugin, Several types of lists are provided.
  */
-declare class List_numbered extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class List_numbered extends PluginCommand implements PluginDropdown {
 	title: any;
-	icon: string;
-	afterItem: HTMLElement;
-	listItems: NodeListOf<Element>;
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the method that is called whenever the cursor position changes.
-	 * @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;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's dropdown menu is opened.
-	 */
-	on(): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the main execution method of the plugin.
-	 * - Called when an item in the "dropdown" menu is clicked.
-	 * @param {HTMLElement} target - The plugin's toolbar button element
-	 */
-	action(target: HTMLElement): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes methods called by shortcut keys.
-	 * @param {__se__PluginShortcutInfo} params - Information of the "shortcut" plugin
-	 */
-	shortcut({ range, info }: __se__PluginShortcutInfo): void;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	on(target?: HTMLElement): void;
+	shortcut(params: SunEditor.HookParams.Shortcut): void;
 	/**
 	 * @description Add a numbered list
 	 * @param {string} [type=""] List type
 	 */
 	submit(type?: string): void;
+	#private;
 }
-import EditorInjector from '../../editorInjector';
+import { PluginDropdown } from '../../interfaces';
+import { PluginCommand } from '../../interfaces';

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

@@ -1,61 +1,38 @@
+import type {} from '../../typedef';
 export default Align;
+export type AlignPluginOptions = {
+	/**
+	 * - Align items
+	 */
+	items?: Array<'right' | 'center' | 'left' | 'justify'>;
+};
+/**
+ * @typedef {Object} AlignPluginOptions
+ * @property {Array.<"right"|"center"|"left"|"justify">} [items] - Align items
+ */
 /**
  * @class
  * @description Align plugin
  */
-declare class Align extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class Align extends PluginDropdown {
 	/**
-	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array.<"right"|"center"|"left"|"justify">} pluginOptions.items - Align items
+	 * @param {SunEditor.Kernel} editor - The core kernel
+	 * @param {AlignPluginOptions} pluginOptions - Plugin options
 	 */
-	constructor(
-		editor: __se__EditorCore,
-		pluginOptions: {
-			items: Array<'right' | 'center' | 'left' | 'justify'>;
-		}
-	);
+	constructor(editor: SunEditor.Kernel, pluginOptions: AlignPluginOptions);
 	title: any;
-	icon: string;
 	_itemMenu: HTMLUListElement;
 	defaultDir: string;
 	alignIcons: {
-		justify: string;
-		left: string;
-		right: string;
-		center: string;
+		justify: any;
+		left: any;
+		right: any;
+		center: any;
 	};
 	alignList: NodeListOf<Element>;
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the method that is called whenever the cursor position changes.
-	 * @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;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's dropdown menu is opened.
-	 * @param {HTMLElement} target Line element at the current cursor position
-	 */
-	on(target: HTMLElement): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the method called when the rtl, ltr mode changes. ("editor.setDir")
-	 * @param {string} dir Direction ("rtl" or "ltr")
-	 */
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
 	setDir(dir: string): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the main execution method of the plugin.
-	 * - Called when an item in the "dropdown" menu is clicked.
-	 * @param {HTMLElement} target - The plugin's toolbar button element
-	 */
-	action(target: HTMLElement): void;
+	init(): void;
+	#private;
 }
-import EditorInjector from '../../editorInjector';
+import { PluginDropdown } from '../../interfaces';

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

@@ -1,64 +1,46 @@
+import type {} from '../../typedef';
 export default BackgroundColor;
+export type BackgroundColorPluginOptions = {
+	/**
+	 * - Color list
+	 */
+	items?: Array<
+		| string
+		| {
+				value: string;
+				name: string;
+		  }
+	>;
+	/**
+	 * - Number of colors per line
+	 */
+	splitNum?: number;
+	/**
+	 * - Disable HEX input
+	 */
+	disableHEXInput?: boolean;
+};
+/**
+ * @typedef {Object} BackgroundColorPluginOptions
+ * @property {Array<string|{value: string, name: string}>} [items] - Color list
+ * @property {number} [splitNum] - Number of colors per line
+ * @property {boolean} [disableHEXInput] - Disable HEX input
+ */
 /**
  * @class
  * @description Text background color plugin
  */
-declare class BackgroundColor extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class BackgroundColor extends PluginDropdownFree {
 	/**
 	 * @constructor
-	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<string|{value: string, name: string}>} pluginOptions.items - Color list
-	 * @param {number} pluginOptions.splitNum - Number of colors per line
-	 * @param {boolean} pluginOptions.disableHEXInput - Disable HEX input
+	 * @param {SunEditor.Kernel} editor - The core kernel
+	 * @param {BackgroundColorPluginOptions} pluginOptions - Plugin options
 	 */
-	constructor(
-		editor: __se__EditorCore,
-		pluginOptions: {
-			items: Array<
-				| string
-				| {
-						value: string;
-						name: string;
-				  }
-			>;
-			splitNum: number;
-			disableHEXInput: boolean;
-		}
-	);
+	constructor(editor: SunEditor.Kernel, pluginOptions: BackgroundColorPluginOptions);
 	title: any;
-	icon: string;
 	colorPicker: ColorPicker;
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the method that is called whenever the cursor position changes.
-	 * @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;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's "dropdown" menu is opened.
-	 * @param {HTMLElement} target Line element at the current cursor position
-	 */
-	on(target: HTMLElement): void;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's "dropdown" menu is closed.
-	 */
-	off(): void;
-	/**
-	 * @editorMethod Modules.ColorPicker
-	 * @description Executes the method called when a button of "ColorPicker" module is clicked.
-	 * - This plugin is by applying the "ColorPicker" module globally to the "dropdown" menu, the default "action" method is not called.
-	 * @param {string} color - Color code (hex)
-	 */
-	colorPickerAction(color: string): void;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	colorPickerAction(color: SunEditor.Module.HueSlider.Color): void;
 }
-import EditorInjector from '../../editorInjector';
-import ColorPicker from '../../modules/ColorPicker';
+import { PluginDropdownFree } from '../../interfaces';
+import { ColorPicker } from '../../modules/contract';

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

@@ -0,0 +1,45 @@
+import type {} from '../../typedef';
+export default BlockStyle;
+export type BlockStyleItem = {
+	tag: string;
+	command: 'line' | 'br-line' | 'block';
+	name?: string;
+	class?: string;
+};
+export type BlockStylePluginOptions = {
+	/**
+	 * - Format list
+	 */
+	items?: Array<'p' | 'div' | 'blockquote' | 'pre' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | string | BlockStyleItem>;
+};
+/**
+ * @typedef {{tag: string, command: "line"|"br-line"|"block", name?: string, class?: string}} BlockStyleItem
+ */
+/**
+ * @typedef {Object} BlockStylePluginOptions
+ * @property {Array<"p"|"div"|"blockquote"|"pre"|"h1"|"h2"|"h3"|"h4"|"h5"|"h6"|string|BlockStyleItem>} [items] - Format list
+ */
+/**
+ * @class
+ * @description BlockStyle Plugin (`P`, `BLOCKQUOTE`, `PRE`, `H1`, `H2`...)
+ */
+declare class BlockStyle extends PluginDropdown {
+	/**
+	 * @constructor
+	 * @param {SunEditor.Kernel} editor - The core kernel
+	 * @param {BlockStylePluginOptions} pluginOptions - Plugin options
+	 */
+	constructor(editor: SunEditor.Kernel, pluginOptions: BlockStylePluginOptions);
+	title: any;
+	inner: string;
+	formatList: NodeListOf<Element>;
+	currentFormat: string;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	/**
+	 * @description Create a header tag, call by `shortcut` class
+	 * - (e.g. shortcuts._h1: ['c+s+49+$~blockStyle.applyHeaderByShortcut', ''])
+	 * @param {SunEditor.HookParams.Shortcut} params - Information of the `shortcut` plugin
+	 */
+	applyHeaderByShortcut({ keyCode }: SunEditor.HookParams.Shortcut): void;
+}
+import { PluginDropdown } from '../../interfaces';

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

@@ -1,55 +1,32 @@
+import type {} from '../../typedef';
 export default Font;
+export type FontPluginOptions = {
+	/**
+	 * - Font list
+	 */
+	items?: Array<string>;
+};
+/**
+ * @typedef {Object} FontPluginOptions
+ * @property {Array<string>} [items] - Font list
+ */
 /**
  * @class
  * @description Text font plugin
  */
-declare class Font extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class Font extends PluginDropdown {
 	/**
 	 * @constructor
-	 * @param {__se__EditorCore} editor - The root editor instance
-	 * @param {Object} pluginOptions
-	 * @param {Array<string>} pluginOptions.items - Font list
-	 * @param {number} pluginOptions.splitNum - Number of colors per line
-	 * @param {boolean} pluginOptions.disableHEXInput - Disable HEX input
+	 * @param {SunEditor.Kernel} editor - The core kernel
+	 * @param {FontPluginOptions} pluginOptions - plugin options
 	 */
-	constructor(
-		editor: __se__EditorCore,
-		pluginOptions: {
-			items: Array<string>;
-			splitNum: number;
-			disableHEXInput: boolean;
-		}
-	);
+	constructor(editor: SunEditor.Kernel, pluginOptions: FontPluginOptions);
 	title: any;
 	inner: string;
 	currentFont: string;
 	fontList: NodeListOf<Element>;
 	fontArray: string[];
-	/**
-	 * @editorMethod Editor.EventManager
-	 * @description Executes the method that is called whenever the cursor position changes.
-	 * @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;
-	/**
-	 * @editorMethod Modules.Dropdown
-	 * @description Executes the method that is called when a plugin's dropdown menu is opened.
-	 * @param {HTMLElement} target Line element at the current cursor position
-	 */
-	on(target: HTMLElement): void;
-	/**
-	 * @editorMethod Editor.core
-	 * @description Executes the main execution method of the plugin.
-	 * - Called when an item in the "dropdown" menu is clicked.
-	 * @param {HTMLElement} target - The plugin's toolbar button element
-	 * @returns {Promise<void>}
-	 */
-	action(target: HTMLElement): Promise<void>;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	#private;
 }
-import EditorInjector from '../../editorInjector';
+import { PluginDropdown } from '../../interfaces';