suneditor 3.0.0-beta.2 → 3.0.0-beta.20

package/types/langs/_Lang.d.ts

@@ -1,194 +1,194 @@
-export interface _Lang {
-	code: string;
-	align: string;
-	alignBottom: string;
-	alignCenter: string;
-	alignJustify: string;
-	alignLeft: string;
-	alignMiddle: string;
-	alignRight: string;
-	alignTop: string;
-	anchor: string;
-	asBlock: string;
-	asInline: string;
-	asLink: string;
-	audio: string;
-	audioGallery: string;
-	audio_modal_file: string;
-	audio_modal_title: string;
-	audio_modal_url: string;
-	autoSize: string;
-	backgroundColor: string;
-	basic: string;
-	blockStyle: string;
-	bold: string;
-	border: string;
-	border_all: string;
-	border_inside: string;
-	border_horizontal: string;
-	border_vertical: string;
-	border_outside: string;
-	border_left: string;
-	border_top: string;
-	border_right: string;
-	border_bottom: string;
-	border_none: string;
-	bulletedList: string;
-	cancel: string;
-	caption: string;
-	cellProperties: string;
-	center: string;
-	close: string;
-	codeView: string;
-	color: string;
-	colorPicker: string;
-	column: string;
-	comment: string;
-	commentAdd: string;
-	commentShow: string;
-	copy: string;
-	copyFormat: string;
-	cut: string;
-	default: string;
-	deleteColumn: string;
-	deleteRow: string;
-	dir_ltr: string;
-	dir_rtl: string;
-	download: string;
-	drag: string;
-	drawing: string;
-	drawing_modal_title: string;
-	edit: string;
-	embed: string;
-	embed_modal_title: string;
-	embed_modal_source: string;
-	exportPDF: string;
-	exportWord: string;
-	find: string;
-	decrease: string;
-	increase: string;
-	fileBrowser: string;
-	fileGallery: string;
-	fileUpload: string;
-	fixedColumnWidth: string;
-	font: string;
-	fontColor: string;
-	fontSize: string;
-	formats: string;
-	fullScreen: string;
-	height: string;
-	horizontalLine: string;
-	horizontalSplit: string;
-	hr_dashed: string;
-	hr_dotted: string;
-	hr_solid: string;
-	id: string;
-	image: string;
-	imageGallery: string;
-	image_modal_altText: string;
-	image_modal_file: string;
-	image_modal_title: string;
-	image_modal_url: string;
-	importWord: string;
-	indent: string;
-	inlineStyle: string;
-	insertColumnAfter: string;
-	insertColumnBefore: string;
-	insertRowAbove: string;
-	insertRowBelow: string;
-	insertLine: string;
-	italic: string;
-	layout: string;
-	left: string;
-	lineHeight: string;
-	link: string;
-	link_modal_bookmark: string;
-	link_modal_downloadLinkCheck: string;
-	link_modal_newWindowCheck: string;
-	link_modal_text: string;
-	link_modal_title: string;
-	link_modal_url: string;
-	link_modal_relAttribute: string;
-	list: string;
-	math: string;
-	math_modal_fontSizeLabel: string;
-	math_modal_inputLabel: string;
-	math_modal_previewLabel: string;
-	math_modal_title: string;
-	maxSize: string;
-	mediaGallery: string;
-	mention: string;
-	menu_bordered: string;
-	menu_code: string;
-	menu_neon: string;
-	menu_shadow: string;
-	menu_spaced: string;
-	menu_translucent: string;
-	mergeCells: string;
-	minSize: string;
-	mirrorHorizontal: string;
-	mirrorVertical: string;
-	newDocument: string;
-	numberedList: string;
-	outdent: string;
-	pageBreak: string;
-	pageDown: string;
-	pageNumber: string;
-	pageUp: string;
-	paragraphStyle: string;
-	preview: string;
-	print: string;
-	proportion: string;
-	ratio: string;
-	redo: string;
-	remove: string;
-	removeFormat: string;
-	replace: string;
-	replaceAll: string;
-	resize100: string;
-	resize25: string;
-	resize50: string;
-	resize75: string;
-	resize: string;
-	revert: string;
-	revisionHistory: string;
-	right: string;
-	rotateLeft: string;
-	rotateRight: string;
-	row: string;
-	save: string;
-	search: string;
-	selectAll: string;
-	showBlocks: string;
-	size: string;
-	splitCells: string;
-	strike: string;
-	submitButton: string;
-	subscript: string;
-	superscript: string;
-	table: string;
-	tableHeader: string;
-	tableProperties: string;
-	tags: string;
-	tag_blockquote: string;
-	tag_div: string;
-	tag_h: string;
-	tag_p: string;
-	tag_pre: string;
-	template: string;
-	textStyle: string;
-	title: string;
-	underline: string;
-	undo: string;
-	unmergeCells: string;
-	unlink: string;
-	verticalSplit: string;
-	video: string;
-	videoGallery: string;
-	video_modal_file: string;
-	video_modal_title: string;
-	video_modal_url: string;
-	width: string;
-	message_copy_success: string;
-	message_copy_fail: string;
-}
+export interface _Lang {
+	code: string;
+	align: string;
+	alignBottom: string;
+	alignCenter: string;
+	alignJustify: string;
+	alignLeft: string;
+	alignMiddle: string;
+	alignRight: string;
+	alignTop: string;
+	anchor: string;
+	asBlock: string;
+	asInline: string;
+	asLink: string;
+	audio: string;
+	audioGallery: string;
+	audio_modal_file: string;
+	audio_modal_title: string;
+	audio_modal_url: string;
+	autoSize: string;
+	backgroundColor: string;
+	basic: string;
+	blockStyle: string;
+	bold: string;
+	border: string;
+	border_all: string;
+	border_inside: string;
+	border_horizontal: string;
+	border_vertical: string;
+	border_outside: string;
+	border_left: string;
+	border_top: string;
+	border_right: string;
+	border_bottom: string;
+	border_none: string;
+	bulletedList: string;
+	cancel: string;
+	caption: string;
+	cellProperties: string;
+	center: string;
+	close: string;
+	codeView: string;
+	color: string;
+	colorPicker: string;
+	column: string;
+	comment: string;
+	commentAdd: string;
+	commentShow: string;
+	copy: string;
+	copyFormat: string;
+	cut: string;
+	default: string;
+	deleteColumn: string;
+	deleteRow: string;
+	dir_ltr: string;
+	dir_rtl: string;
+	download: string;
+	drag: string;
+	drawing: string;
+	drawing_modal_title: string;
+	edit: string;
+	embed: string;
+	embed_modal_title: string;
+	embed_modal_source: string;
+	exportPDF: string;
+	exportWord: string;
+	find: string;
+	decrease: string;
+	increase: string;
+	fileBrowser: string;
+	fileGallery: string;
+	fileUpload: string;
+	fixedColumnWidth: string;
+	font: string;
+	fontColor: string;
+	fontSize: string;
+	formats: string;
+	fullScreen: string;
+	height: string;
+	horizontalLine: string;
+	horizontalSplit: string;
+	hr_dashed: string;
+	hr_dotted: string;
+	hr_solid: string;
+	id: string;
+	image: string;
+	imageGallery: string;
+	image_modal_altText: string;
+	image_modal_file: string;
+	image_modal_title: string;
+	image_modal_url: string;
+	importWord: string;
+	indent: string;
+	inlineStyle: string;
+	insertColumnAfter: string;
+	insertColumnBefore: string;
+	insertRowAbove: string;
+	insertRowBelow: string;
+	insertLine: string;
+	italic: string;
+	layout: string;
+	left: string;
+	lineHeight: string;
+	link: string;
+	link_modal_bookmark: string;
+	link_modal_downloadLinkCheck: string;
+	link_modal_newWindowCheck: string;
+	link_modal_text: string;
+	link_modal_title: string;
+	link_modal_url: string;
+	link_modal_relAttribute: string;
+	list: string;
+	math: string;
+	math_modal_fontSizeLabel: string;
+	math_modal_inputLabel: string;
+	math_modal_previewLabel: string;
+	math_modal_title: string;
+	maxSize: string;
+	mediaGallery: string;
+	mention: string;
+	menu_bordered: string;
+	menu_code: string;
+	menu_neon: string;
+	menu_shadow: string;
+	menu_spaced: string;
+	menu_translucent: string;
+	mergeCells: string;
+	minSize: string;
+	mirrorHorizontal: string;
+	mirrorVertical: string;
+	newDocument: string;
+	numberedList: string;
+	outdent: string;
+	pageBreak: string;
+	pageDown: string;
+	pageNumber: string;
+	pageUp: string;
+	paragraphStyle: string;
+	preview: string;
+	print: string;
+	proportion: string;
+	ratio: string;
+	redo: string;
+	remove: string;
+	removeFormat: string;
+	replace: string;
+	replaceAll: string;
+	resize100: string;
+	resize25: string;
+	resize50: string;
+	resize75: string;
+	resize: string;
+	revert: string;
+	revisionHistory: string;
+	right: string;
+	rotateLeft: string;
+	rotateRight: string;
+	row: string;
+	save: string;
+	search: string;
+	selectAll: string;
+	showBlocks: string;
+	size: string;
+	splitCells: string;
+	strike: string;
+	submitButton: string;
+	subscript: string;
+	superscript: string;
+	table: string;
+	tableHeader: string;
+	tableProperties: string;
+	tags: string;
+	tag_blockquote: string;
+	tag_div: string;
+	tag_h: string;
+	tag_p: string;
+	tag_pre: string;
+	template: string;
+	textStyle: string;
+	title: string;
+	underline: string;
+	undo: string;
+	unmergeCells: string;
+	unlink: string;
+	verticalSplit: string;
+	video: string;
+	videoGallery: string;
+	video_modal_file: string;
+	video_modal_title: string;
+	video_modal_url: string;
+	width: string;
+	message_copy_success: string;
+	message_copy_fail: string;
+}

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/modules/Controller.d.ts

@@ -56,12 +56,14 @@ export type ControllerParams = {
 	parentsHide?: boolean | undefined;
 	/**
 	 * The related sibling controller element that this controller is positioned relative to.
+	 * - e.g.) table plugin :: 118
 	 */
 	sibling?: HTMLElement | undefined;
 	/**
-	 * The relative position of this controller to the sibling element (e.g., display above or beside the sibling).
+	 * If true, This sibling controller is the main controller.
+	 * - You must specify this option, if use "sibling"
 	 */
-	siblingPosition?: 'top' | 'side';
+	siblingMain?: boolean | undefined;
 	/**
 	 * If the controller is inside a form, set it to true.
 	 */
@@ -90,7 +92,9 @@ export type ControllerParams = {
  * @property {Array<HTMLElement>=} [parents=[]] The parent "controller" array when "controller" is opened nested.
  * @property {boolean=} [parentsHide=false] If true, the parent element is hidden when the controller is opened.
  * @property {HTMLElement=} [sibling=null] The related sibling controller element that this controller is positioned relative to.
- * @property {"top"|"side"} [siblingPosition="top"] The relative position of this controller to the sibling element (e.g., display above or beside the sibling).
+ * - e.g.) table plugin :: 118
+ * @property {boolean=} [siblingMain=false] If true, This sibling controller is the main controller.
+ * - You must specify this option, if use "sibling"
  * @property {boolean=} [isInsideForm=false] If the controller is inside a form, set it to true.
  * @property {boolean=} [isOutsideForm=false] If the controller is outside a form, set it to true.
  */
@@ -119,7 +123,7 @@ declare class Controller extends EditorInjector {
 	parents: HTMLElement[];
 	parentsHide: boolean;
 	sibling: HTMLElement;
-	siblingPosition: 'top' | 'side';
+	siblingMain: boolean;
 	isInsideForm: boolean;
 	isOutsideForm: boolean;
 	toTop: boolean;

package/types/modules/Figure.d.ts

@@ -378,8 +378,9 @@ declare class Figure extends EditorInjector {
 	 * @description As style[block, inline] the component
 	 * @param {?Node} targetNode Target element
 	 * @param {"block"|"inline"} formatStyle Format style
+	 * @returns {HTMLElement} New target element after conversion
 	 */
-	convertAsFormat(targetNode: Node | null, formatStyle: 'block' | 'inline'): void;
+	convertAsFormat(targetNode: Node | null, formatStyle: 'block' | 'inline'): HTMLElement;
 	/**
 	 * @private
 	 * @description Handles format conversion (block/inline) for the figure component and applies size changes.

package/types/modules/HueSlider.d.ts

@@ -101,8 +101,11 @@ declare class HueSlider {
 	isOpen: boolean;
 	controlle: any;
 	__globalMouseDown: any;
-	__globalMouseMove: any;
+	__globalTouchMove: any;
 	__globalMouseUp: any;
+	__globalMouseMove: any;
+	__globalTouchStart: any;
+	__globalTouchEnd: any;
 	controller: Controller;
 	/**
 	 * @description Get the current color information.

package/types/modules/SelectMenu.d.ts

@@ -66,7 +66,7 @@ declare class SelectMenu extends CoreInjector {
 	openMethod: () => void;
 	closeMethod: () => void;
 	_refer: HTMLElement;
-	_keydownTarget: Window | HTMLInputElement;
+	_keydownTarget: any;
 	_selectMethod: (command: string) => void;
 	_bindClose_key: any;
 	_bindClose_mousedown: any;

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;
 	/**
@@ -46,9 +47,9 @@ declare class FormatBlock extends EditorInjector {
 	action(target: HTMLElement): void;
 	/**
 	 * @description Create a header tag, call by "shortcut" class
-	 * - (e.g. shortcuts._h1: ['c+s+49+p~formatBlock.createHeader', ''])
+	 * - (e.g. shortcuts._h1: ['c+s+49+$~formatBlock.applyHeaderByShortcut', ''])
 	 * @param {__se__PluginShortcutInfo} params - Information of the "shortcut" plugin
 	 */
-	createHeader({ keyCode }: __se__PluginShortcutInfo): void;
+	applyHeaderByShortcut({ keyCode }: __se__PluginShortcutInfo): void;
 }
 import EditorInjector from '../../editorInjector';

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/dropdown/table.d.ts

@@ -409,6 +409,12 @@ declare class Table extends EditorInjector {
 	 * @param {Node} target - The target figure element.
 	 */
 	private _figureOpen;
+	/**
+	 * @private
+	 * @description Converts the width of <col> elements to percentages.
+	 * @param {HTMLTableElement} target - The target table element.
+	 */
+	private _resizePercentCol;
 	/**
 	 * @private
 	 * @description Starts resizing a table cell.

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/drawing.d.ts

@@ -140,6 +140,8 @@ declare class Drawing extends EditorInjector {
 	paths: any[];
 	resizeObserver: ResizeObserver;
 	__events: {
+		touchstart: any;
+		touchmove: any;
 		mousedown: any;
 		mousemove: any;
 		mouseup: any;
@@ -147,6 +149,8 @@ declare class Drawing extends EditorInjector {
 		mouseenter: any;
 	};
 	__eventsRegister: {
+		touchstart: any;
+		touchmove: any;
 		mousedown: any;
 		mousemove: any;
 		mouseup: any;