suneditor 3.0.6 → 3.1.0

package/types/core/logic/shell/shortcuts.d.ts

@@ -54,7 +54,7 @@ export type ShortcutInfo = {
 	 */
 	r: Array<string>;
 	/**
-	 * - Whether the event was triggered by a text input (e.g., mention like
+	 * - Whether the event was triggered by a text input (e.g., autocomplete like
 	 */
 	textTrigger: string;
 };
@@ -73,7 +73,7 @@ export type ShortcutInfo = {
  * @property {string} type - Plugin's type. (`command`, `dropdown`, `modal`, `browser`, `input`, `field`, `popup`).
  * @property {Node} button - The plugin command button.
  * @property {Array<string>} r - An array of key codes generated with the reverseButtons option, used to reverse the action for a specific key combination.
- * @property {string} textTrigger - Whether the event was triggered by a text input (e.g., mention like @ab).
+ * @property {string} textTrigger - Whether the event was triggered by a text input (e.g., autocomplete like @ab).
  */
 /**
  * @description Shortcuts class

package/types/core/schema/options.d.ts

@@ -525,6 +525,7 @@ export namespace DEFAULTS {
  * @property {import('../../plugins/dropdown/align.js').AlignPluginOptions} [align]
  * @property {import('../../plugins/modal/audio.js').AudioPluginOptions} [audio]
  * @property {import('../../plugins/browser/audioGallery.js').AudioGalleryPluginOptions} [audioGallery]
+ * @property {import('../../plugins/field/autocomplete.js').AutocompletePluginOptions} [autocomplete]
  * @property {import('../../plugins/dropdown/backgroundColor.js').BackgroundColorPluginOptions} [backgroundColor]
  * @property {import('../../plugins/dropdown/blockStyle.js').BlockStylePluginOptions} [blockStyle]
  * @property {import('../../plugins/command/codeBlock.js').CodeBlockPluginOptions} [codeBlock]
@@ -544,7 +545,6 @@ export namespace DEFAULTS {
  * @property {import('../../plugins/dropdown/lineHeight.js').LineHeightPluginOptions} [lineHeight]
  * @property {import('../../plugins/modal/link.js').LinkPluginOptions} [link]
  * @property {import('../../plugins/modal/math.js').MathPluginOptions} [math]
- * @property {import('../../plugins/field/mention.js').MentionPluginOptions} [mention]
  * @property {import('../../plugins/dropdown/paragraphStyle.js').ParagraphStylePluginOptions} [paragraphStyle]
  * @property {import('../../plugins/dropdown/table/index.js').TablePluginOptions} [table]
  * @property {import('../../plugins/dropdown/template.js').TemplatePluginOptions} [template]
@@ -1429,6 +1429,7 @@ export type EditorBaseOptions = {
 	align?: import('../../plugins/dropdown/align.js').AlignPluginOptions;
 	audio?: import('../../plugins/modal/audio.js').AudioPluginOptions;
 	audioGallery?: import('../../plugins/browser/audioGallery.js').AudioGalleryPluginOptions;
+	autocomplete?: import('../../plugins/field/autocomplete.js').AutocompletePluginOptions;
 	backgroundColor?: import('../../plugins/dropdown/backgroundColor.js').BackgroundColorPluginOptions;
 	blockStyle?: import('../../plugins/dropdown/blockStyle.js').BlockStylePluginOptions;
 	codeBlock?: import('../../plugins/command/codeBlock.js').CodeBlockPluginOptions;
@@ -1448,7 +1449,6 @@ export type EditorBaseOptions = {
 	lineHeight?: import('../../plugins/dropdown/lineHeight.js').LineHeightPluginOptions;
 	link?: import('../../plugins/modal/link.js').LinkPluginOptions;
 	math?: import('../../plugins/modal/math.js').MathPluginOptions;
-	mention?: import('../../plugins/field/mention.js').MentionPluginOptions;
 	paragraphStyle?: import('../../plugins/dropdown/paragraphStyle.js').ParagraphStylePluginOptions;
 	table?: import('../../plugins/dropdown/table/index.js').TablePluginOptions;
 	template?: import('../../plugins/dropdown/template.js').TemplatePluginOptions;

package/types/helper/index.d.ts

@@ -174,6 +174,9 @@ export const markdown: {
 	jsonToMarkdown: typeof import('./markdown').jsonToMarkdown;
 	markdownToHtml: typeof import('./markdown').markdownToHtml;
 };
+export const msOffice: {
+	cleanHTML: typeof import('./msOffice').cleanHTML;
+};
 declare namespace _default {
 	export { env };
 	export { unicode };
@@ -183,5 +186,6 @@ declare namespace _default {
 	export { keyCodeMap };
 	export { clipboard };
 	export { markdown };
+	export { msOffice };
 }
 export default _default;

package/types/helper/msOffice.d.ts

@@ -0,0 +1,11 @@
+import type {} from '../typedef';
+/**
+ * @description Converts MS Word/Excel/OneNote HTML clipboard data to clean, standards-compliant HTML.
+ * @param {string} html Raw HTML string from MS Office clipboard
+ * @returns {string} Cleaned HTML string
+ */
+export function cleanHTML(html: string): string;
+declare namespace _default {
+	export { cleanHTML };
+}
+export default _default;

package/types/interfaces/plugins.d.ts

@@ -92,7 +92,7 @@ export class PluginDropdownFree extends Base {
  * These plugins typically respond to input events in the wysiwyg area
  *
  * **Commonly used hooks:**
- * - `onInput()` - Responds to input events in the editor (See: `mention` plugin)
+ * - `onInput()` - Responds to input events in the editor (See: `autocomplete` plugin)
  * - Other event hooks can be used as needed (`onKeydown`, `onClick`, etc.)
  *
  * Child classes MAY optionally implement event hook methods

package/types/langs/_Lang.d.ts

@@ -38,7 +38,6 @@ export type _Lang = {
 	caption: string;
 	cellProperties: string;
 	center: string;
-	clear: string;
 	close: string;
 	codeView: string;
 	color: string;
@@ -119,7 +118,7 @@ export type _Lang = {
 	math_modal_title: string;
 	maxSize: string;
 	mediaGallery: string;
-	mention: string;
+	autocomplete: string;
 	menu_bordered: string;
 	menu_code: string;
 	menu_neon: string;

package/types/plugins/field/autocomplete.d.ts

@@ -0,0 +1,177 @@
+import type {} from '../../typedef';
+export default Autocomplete;
+export type AutocompleteTriggerConfig = {
+	/**
+	 * - Static data array. Each item must have a `key` field. Mutually exclusive with `apiUrl`.
+	 * ```js
+	 * // data
+	 * [{ key: 'john', name: 'John Doe', url: '/users/john' }]
+	 * ```
+	 */
+	data?: Array<{
+		key: string;
+		[x: string]: any;
+	}>;
+	/**
+	 * - API endpoint URL. Supports `{key}` and `{limitSize}` placeholders. Mutually exclusive with `data`.
+	 */
+	apiUrl?: string;
+	/**
+	 * - HTTP headers for the API request.
+	 */
+	apiHeaders?: {
+		[x: string]: string;
+	};
+	/**
+	 * - Transforms parsed JSON response into an array of data items.
+	 */
+	transformResponse?: (
+		arg0: any,
+		arg1: XMLHttpRequest,
+	) => Array<{
+		key: string;
+	}>;
+	/**
+	 * - Override global `limitSize` for this trigger.
+	 */
+	limitSize?: number;
+	/**
+	 * - Override global `searchStartLength` for this trigger.
+	 */
+	searchStartLength?: number;
+	/**
+	 * - Override global `useCachingData` for this trigger.
+	 */
+	useCachingData?: boolean;
+	/**
+	 * - Override global `useCachingFieldData` for this trigger.
+	 */
+	useCachingFieldData?: boolean;
+	/**
+	 * - Custom dropdown item renderer. Receives `(item, triggerText)`, returns HTML string.
+	 */
+	renderItem?: (
+		arg0: {
+			key: string;
+			[x: string]: any;
+		},
+		arg1: string,
+	) => string;
+	/**
+	 * - Custom selection handler. Returns:
+	 * - `string`: inserted as text node
+	 * - `Element`: inserted as-is
+	 * - `{tag, attrs, text}`: creates element via `dom.utils.createElement`
+	 */
+	onSelect?: (
+		arg0: {
+			key: string;
+			[x: string]: any;
+		},
+		arg1: string,
+	) =>
+		| string
+		| Element
+		| {
+				tag: string;
+				attrs?: any;
+				text?: string;
+		  };
+};
+export type AutocompletePluginOptions = {
+	/**
+	 * - Debounce delay in ms before processing input.
+	 */
+	delayTime?: number;
+	/**
+	 * - Maximum number of items to display in the dropdown.
+	 */
+	limitSize?: number;
+	/**
+	 * - Minimum input length before triggering search.
+	 */
+	searchStartLength?: number;
+	/**
+	 * - Whether to cache query responses per trigger.
+	 */
+	useCachingData?: boolean;
+	/**
+	 * - Whether to cache selected items for priority display.
+	 */
+	useCachingFieldData?: boolean;
+	/**
+	 * - Per-trigger configurations keyed by trigger character.
+	 * ```js
+	 * // triggers
+	 * {
+	 * '@': { data: [...], renderItem: (item) => `...` },
+	 * '#': { apiUrl: '/api/tags?q={key}' }
+	 * }
+	 * ```
+	 */
+	triggers: {
+		[x: string]: AutocompleteTriggerConfig;
+	};
+};
+/**
+ * @typedef {Object} AutocompleteTriggerConfig
+ * @property {Array<{key: string, [x: string]: any}>} [data] - Static data array. Each item must have a `key` field. Mutually exclusive with `apiUrl`.
+ * ```js
+ * // data
+ * [{ key: 'john', name: 'John Doe', url: '/users/john' }]
+ * ```
+ * @property {string} [apiUrl] - API endpoint URL. Supports `{key}` and `{limitSize}` placeholders. Mutually exclusive with `data`.
+ * @property {Object<string, string>} [apiHeaders] - HTTP headers for the API request.
+ * @property {function(Object, XMLHttpRequest): Array<{key: string}>} [transformResponse] - Transforms parsed JSON response into an array of data items.
+ * @property {number} [limitSize] - Override global `limitSize` for this trigger.
+ * @property {number} [searchStartLength] - Override global `searchStartLength` for this trigger.
+ * @property {boolean} [useCachingData] - Override global `useCachingData` for this trigger.
+ * @property {boolean} [useCachingFieldData] - Override global `useCachingFieldData` for this trigger.
+ * @property {function({key: string, [x: string]: any}, string): string} [renderItem] - Custom dropdown item renderer. Receives `(item, triggerText)`, returns HTML string.
+ * @property {function({key: string, [x: string]: any}, string): (string|Element|{tag: string, attrs?: Object, text?: string})} [onSelect] - Custom selection handler. Returns:
+ *   - `string`: inserted as text node
+ *   - `Element`: inserted as-is
+ *   - `{tag, attrs, text}`: creates element via `dom.utils.createElement`
+ */
+/**
+ * @typedef {Object} AutocompletePluginOptions
+ * @property {number} [delayTime=120] - Debounce delay in ms before processing input.
+ * @property {number} [limitSize=5] - Maximum number of items to display in the dropdown.
+ * @property {number} [searchStartLength=0] - Minimum input length before triggering search.
+ * @property {boolean} [useCachingData=true] - Whether to cache query responses per trigger.
+ * @property {boolean} [useCachingFieldData=true] - Whether to cache selected items for priority display.
+ * @property {Object<string, AutocompleteTriggerConfig>} triggers - Per-trigger configurations keyed by trigger character.
+ * ```js
+ * // triggers
+ * {
+ *   '@': { data: [...], renderItem: (item) => `...` },
+ *   '#': { apiUrl: '/api/tags?q={key}' }
+ * }
+ * ```
+ */
+/**
+ * @class
+ * @description Autocomplete Plugin
+ * - A generic autocomplete plugin supporting multiple trigger characters.
+ * - Each trigger can have its own data source, rendering, and selection behavior.
+ * - Supports static data arrays and API-based data fetching.
+ * - Uses per-trigger caching for optimized performance.
+ */
+declare class Autocomplete extends PluginField {
+	/**
+	 * @constructor
+	 * @param {SunEditor.Kernel} kernel - The Kernel instance
+	 * @param {AutocompletePluginOptions} pluginOptions
+	 */
+	constructor(kernel: SunEditor.Kernel, pluginOptions: AutocompletePluginOptions);
+	title: any;
+	triggerContexts: Map<any, any>;
+	sortedTriggers: any[];
+	selectMenu: SelectMenu;
+	controller: Controller;
+	onInput(params: SunEditor.HookParams.InputWithData): Promise<void>;
+	#private;
+}
+import { PluginField } from '../../interfaces';
+import { Controller } from '../../modules/contract';
+import { SelectMenu } from '../../modules/ui';

package/types/plugins/index.d.ts

@@ -6,7 +6,7 @@ declare namespace _default {
 	export { fileUpload };
 	export { list_bulleted };
 	export { list_numbered };
-	export { mention };
+	export { autocomplete };
 	export { align };
 	export { font };
 	export { fontColor };
@@ -61,7 +61,7 @@ import paragraphStyle from './dropdown/paragraphStyle';
 import table from './dropdown/table';
 import template from './dropdown/template';
 import textStyle from './dropdown/textStyle';
-import mention from './field/mention';
+import autocomplete from './field/autocomplete';
 import fontSize from './input/fontSize';
 import pageNavigator from './input/pageNavigator';
 import audio from './modal/audio';
@@ -77,6 +77,7 @@ export {
 	anchor,
 	audio,
 	audioGallery,
+	autocomplete,
 	backgroundColor,
 	blockquote,
 	blockStyle,
@@ -100,7 +101,6 @@ export {
 	list_bulleted,
 	list_numbered,
 	math,
-	mention,
 	pageNavigator,
 	paragraphStyle,
 	table,

package/types/typedef.d.ts

@@ -306,7 +306,7 @@ declare global {
 				| 'fileUpload'
 				| 'list_bulleted'
 				| 'list_numbered'
-				| 'mention'
+				| 'autocomplete'
 				| 'align'
 				| 'font'
 				| 'fontColor'

package/src/plugins/field/mention.js

@@ -1,251 +0,0 @@
-import { PluginField } from '../../interfaces';
-import { Controller } from '../../modules/contract';
-import { ApiManager } from '../../modules/manager';
-import { SelectMenu } from '../../modules/ui';
-import { dom, converter } from '../../helper';
-
-const { debounce } = converter;
-
-/**
- * @typedef {Object} MentionPluginOptions
- * @property {string} [triggerText="@"] - The character that triggers the mention list.
- * @property {number} [limitSize=5] - The number of items to display in the mention list
- * @property {number} [searchStartLength=0] - The number of characters to start searching for the mention list
- * @property {number} [delayTime=120] - The time to wait before displaying the mention list
- * @property {Array<{key: string, name: string, url: string}>} [data] - Static mention data (used instead of API).
- * ```js
- * // data
- * [{ key: 'john', name: 'John Doe', url: '/users/john' }]
- * ```
- * @property {string} [apiUrl] - The URL to call the mention list
- * @property {Object<string, string>} [apiHeaders] - The headers to send with the API call
- * @property {boolean} [useCachingData=true] - Whether to cache the mention list data
- * @property {boolean} [useCachingFieldData=true] - Whether to cache the mention list data in the field
- */
-
-/**
- * @class
- * @description Mention Plugin
- * - A plugin that provides a mention feature using `@` or a custom trigger character.
- * - Displays a mention list when the trigger character is typed.
- * - Supports fetching mention data from an API or a predefined data array.
- * - Uses caching for optimized performance.
- */
-class Mention extends PluginField {
-	static key = 'mention';
-	static className = '';
-
-	#lastAtPos = 0;
-	#anchorOffset = 0;
-	#anchorNode = null;
-
-	/**
-	 * @constructor
-	 * @param {SunEditor.Kernel} kernel - The Kernel instance
-	 * @param {MentionPluginOptions} pluginOptions
-	 */
-	constructor(kernel, pluginOptions) {
-		super(kernel);
-		// plugin basic properties
-		this.title = this.$.lang.mention;
-		this.icon = 'mention';
-
-		// members
-		this.triggerText = pluginOptions.triggerText || '@';
-		this.limitSize = pluginOptions.limitSize || 5;
-		this.searchStartLength = pluginOptions.searchStartLength || 0;
-		this.delayTime = typeof pluginOptions.delayTime === 'number' ? pluginOptions.delayTime : 120;
-		this.directData = pluginOptions.data;
-		this.apiUrl = pluginOptions.apiUrl?.replace(/\s/g, '').replace(/\{limitSize\}/i, String(this.limitSize)) || '';
-		// members - api, caching
-		this.apiManager = new ApiManager(this, this.$, { headers: pluginOptions.apiHeaders });
-		this.cachingData = (pluginOptions.useCachingData ?? true) ? new Map() : null;
-		this.cachingFieldData = (pluginOptions.useCachingFieldData ?? true) ? [] : null;
-
-		// controller
-		const controllerEl = CreateHTML_controller();
-		this.selectMenu = new SelectMenu(this.$, { position: 'right-bottom', dir: 'ltr', closeMethod: () => this.controller.close() });
-		this.controller = new Controller(
-			this,
-			this.$,
-			controllerEl,
-			{
-				position: 'bottom',
-				initMethod: () => {
-					this.apiManager.cancel();
-					this.selectMenu.close();
-				},
-			},
-			null,
-		);
-		this.selectMenu.on(controllerEl.firstElementChild, this.#SelectMention.bind(this));
-
-		// onInput debounce
-		this.onInput = debounce(this.onInput.bind(this), this.delayTime);
-	}
-
-	/**
-	 * @hook Editor.EventManager
-	 * @type {SunEditor.Hook.Event.OnInputAsync}
-	 */
-	async onInput() {
-		if (!this.directData) {
-			this.apiManager.cancel();
-		}
-
-		const sel = this.$.selection.get();
-		if (!sel.rangeCount) {
-			this.selectMenu.close();
-			return;
-		}
-
-		const anchorNode = sel.anchorNode;
-		const anchorOffset = sel.anchorOffset;
-		const textBeforeCursor = anchorNode.textContent.substring(0, anchorOffset);
-		const lastAtPos = textBeforeCursor.lastIndexOf(this.triggerText);
-
-		if (lastAtPos > -1) {
-			const mentionQuery = textBeforeCursor.substring(lastAtPos + 1, anchorOffset);
-			const beforeText = textBeforeCursor[lastAtPos - 1]?.trim();
-			if (!/\s/.test(mentionQuery) && (!beforeText || dom.check.isZeroWidth(beforeText))) {
-				if (mentionQuery.length < this.searchStartLength) return;
-
-				const anchorParent = anchorNode.parentNode;
-				if (dom.check.isAnchor(anchorParent) && !anchorParent.getAttribute('data-se-mention')) {
-					return;
-				}
-
-				try {
-					await this.#createMentionList(mentionQuery, anchorNode);
-					this.#lastAtPos = lastAtPos;
-					this.#anchorNode = anchorNode;
-					this.#anchorOffset = anchorOffset;
-					return;
-				} catch (error) {
-					console.warn('[SUNEDITOR.mention.api.file] ', error);
-				}
-			}
-		}
-
-		this.selectMenu.close();
-	}
-
-	/**
-	 * @description Generates the mention list based on user input.
-	 * - Fetches data from cache, direct data, or an API.
-	 * - Creates and opens the mention dropdown.
-	 * - Caches the fetched data for future use.
-	 * @param {string} value - The mention query text.
-	 * @param {Node} targetNode - The node where the mention is triggered.
-	 * @returns {Promise<boolean>} - Returns `true` if the mention list is displayed, `false` otherwise.
-	 */
-	async #createMentionList(value, targetNode) {
-		const limit = this.limitSize;
-		const lowerValue = value.toLowerCase();
-		let response = null;
-		if (this.cachingData) {
-			response = this.cachingData.get(value);
-		}
-
-		if (!response) {
-			if (this.directData) {
-				response = this.directData.filter((item) => item.key.toLowerCase().startsWith(lowerValue)).slice(0, limit);
-			} else {
-				const xmlHttp = await this.apiManager.asyncCall({ method: 'GET', url: this.#createUrl(value) });
-				response = JSON.parse(xmlHttp.responseText);
-			}
-		}
-
-		if (this.cachingFieldData) {
-			const uniqueKeys = new Set();
-			response = this.cachingFieldData
-				.concat(response)
-				.filter(({ key }) => {
-					if (uniqueKeys.has(key)) return false;
-					uniqueKeys.add(key);
-					return key.toLowerCase().startsWith(lowerValue);
-				})
-				.slice(0, limit);
-		}
-
-		if (!response?.length) {
-			this.selectMenu.close();
-			return false;
-		}
-
-		const list = [];
-		const menus = [];
-		for (let i = 0, len = response.length, v; i < len; i++) {
-			v = response[i];
-			list.push(v);
-			menus.push(`<div class="se-mention-item"><span>${v.key}</span><span>${v.name}</span></div>`);
-		}
-
-		if (list.length === 0) {
-			this.selectMenu.close();
-			return false;
-		} else {
-			// controller open
-			this.controller.open(targetNode, null, { isWWTarget: true, initMethod: null, addOffset: null });
-			// select menu create
-			this.selectMenu.create(list, menus);
-			this.selectMenu.open();
-			this.selectMenu.setItem(0);
-			if (this.cachingData) this.cachingData.set(value, list);
-			return true;
-		}
-	}
-
-	/**
-	 * @description Constructs the API request URL with the mention query.
-	 * @param {string} key - The mention query text.
-	 * @returns {string} - The formatted API request URL.
-	 */
-	#createUrl(key) {
-		return this.apiUrl.replace(/\{key\}/i, key);
-	}
-
-	/**
-	 * @description Inserts a mention link into the editor when a user selects a mention from the list.
-	 * @param {{ key: string, name: string, url: string }} item - The selected mention item.
-	 * @returns {boolean} Returns `false` if insertion fails, otherwise completes execution.
-	 */
-	#SelectMention(item) {
-		if (!item) return false;
-
-		let oA = null;
-		const { key, name, url } = item;
-		const anchorParent = this.#anchorNode.parentNode;
-
-		if (dom.check.isAnchor(anchorParent)) {
-			oA = anchorParent;
-			oA.setAttribute('data-se-mention', key);
-			oA.setAttribute('href', url);
-			oA.setAttribute('title', name);
-			oA.textContent = this.triggerText + key;
-		} else {
-			this.$.selection.setRange(this.#anchorNode, this.#lastAtPos, this.#anchorNode, this.#anchorOffset);
-			oA = dom.utils.createElement('A', { 'data-se-mention': key, href: url, title: name, target: '_blank' }, this.triggerText + key);
-			if (!this.$.html.insertNode(oA, { afterNode: null, skipCharCount: false })) return false;
-		}
-
-		this.selectMenu.close();
-
-		const space = dom.utils.createTextNode('\u00A0');
-		oA.parentNode.insertBefore(space, oA.nextSibling);
-		this.$.selection.setRange(space, 1, space, 1);
-
-		if (this.cachingFieldData && !this.cachingFieldData.some((data) => data.key === item.key)) {
-			this.cachingFieldData.push(item);
-		}
-	}
-}
-
-/**
- * @returns {HTMLElement}
- */
-function CreateHTML_controller() {
-	return dom.utils.createElement('DIV', { class: 'se-controller se-empty-controller' }, '<div></div>');
-}
-
-export default Mention;

package/types/plugins/field/mention.d.ts

@@ -1,104 +0,0 @@
-import type {} from '../../typedef';
-export default Mention;
-export type MentionPluginOptions = {
-	/**
-	 * - The character that triggers the mention list.
-	 */
-	triggerText?: string;
-	/**
-	 * - The number of items to display in the mention list
-	 */
-	limitSize?: number;
-	/**
-	 * - The number of characters to start searching for the mention list
-	 */
-	searchStartLength?: number;
-	/**
-	 * - The time to wait before displaying the mention list
-	 */
-	delayTime?: number;
-	/**
-	 * - Static mention data (used instead of API).
-	 * ```js
-	 * // data
-	 * [{ key: 'john', name: 'John Doe', url: '/users/john' }]
-	 * ```
-	 */
-	data?: Array<{
-		key: string;
-		name: string;
-		url: string;
-	}>;
-	/**
-	 * - The URL to call the mention list
-	 */
-	apiUrl?: string;
-	/**
-	 * - The headers to send with the API call
-	 */
-	apiHeaders?: {
-		[x: string]: string;
-	};
-	/**
-	 * - Whether to cache the mention list data
-	 */
-	useCachingData?: boolean;
-	/**
-	 * - Whether to cache the mention list data in the field
-	 */
-	useCachingFieldData?: boolean;
-};
-/**
- * @typedef {Object} MentionPluginOptions
- * @property {string} [triggerText="@"] - The character that triggers the mention list.
- * @property {number} [limitSize=5] - The number of items to display in the mention list
- * @property {number} [searchStartLength=0] - The number of characters to start searching for the mention list
- * @property {number} [delayTime=120] - The time to wait before displaying the mention list
- * @property {Array<{key: string, name: string, url: string}>} [data] - Static mention data (used instead of API).
- * ```js
- * // data
- * [{ key: 'john', name: 'John Doe', url: '/users/john' }]
- * ```
- * @property {string} [apiUrl] - The URL to call the mention list
- * @property {Object<string, string>} [apiHeaders] - The headers to send with the API call
- * @property {boolean} [useCachingData=true] - Whether to cache the mention list data
- * @property {boolean} [useCachingFieldData=true] - Whether to cache the mention list data in the field
- */
-/**
- * @class
- * @description Mention Plugin
- * - A plugin that provides a mention feature using `@` or a custom trigger character.
- * - Displays a mention list when the trigger character is typed.
- * - Supports fetching mention data from an API or a predefined data array.
- * - Uses caching for optimized performance.
- */
-declare class Mention extends PluginField {
-	/**
-	 * @constructor
-	 * @param {SunEditor.Kernel} kernel - The Kernel instance
-	 * @param {MentionPluginOptions} pluginOptions
-	 */
-	constructor(kernel: SunEditor.Kernel, pluginOptions: MentionPluginOptions);
-	title: any;
-	triggerText: string;
-	limitSize: number;
-	searchStartLength: number;
-	delayTime: number;
-	directData: {
-		key: string;
-		name: string;
-		url: string;
-	}[];
-	apiUrl: string;
-	apiManager: ApiManager;
-	cachingData: Map<any, any>;
-	cachingFieldData: any[];
-	selectMenu: SelectMenu;
-	controller: Controller;
-	onInput(params: SunEditor.HookParams.InputWithData): Promise<void>;
-	#private;
-}
-import { PluginField } from '../../interfaces';
-import { Controller } from '../../modules/contract';
-import { ApiManager } from '../../modules/manager';
-import { SelectMenu } from '../../modules/ui';