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

package/types/core/util/instanceCheck.d.ts

@@ -0,0 +1,50 @@
+export default InstanceCheck;
+export type InstanceCheckThis = InstanceCheck;
+/**
+ * @typedef {InstanceCheck} InstanceCheckThis
+ */
+/**
+ * @constructor
+ * @this {InstanceCheck}
+ * @description iframe-safe instanceof check utility class
+ * @param {__se__EditorCore} editor - The root editor instance
+ */
+declare function InstanceCheck(this: InstanceCheck, editor: __se__EditorCore): void;
+declare class InstanceCheck {
+	/**
+	 * @typedef {InstanceCheck} InstanceCheckThis
+	 */
+	/**
+	 * @constructor
+	 * @this {InstanceCheck}
+	 * @description iframe-safe instanceof check utility class
+	 * @param {__se__EditorCore} editor - The root editor instance
+	 */
+	constructor(this: InstanceCheck, editor: __se__EditorCore);
+	editor: import('../editor').default;
+	/**
+	 * @param {*} obj
+	 * @returns {obj is Node}
+	 */
+	isNode(obj: any): obj is Node;
+	/**
+	 * @param {*} obj
+	 * @returns {obj is Element}
+	 */
+	isElement(obj: any): obj is Element;
+	/**
+	 * @param {*} obj
+	 * @returns {obj is Range}
+	 */
+	isRange(obj: any): obj is Range;
+	/**
+	 * @param {*} obj
+	 * @returns {obj is Selection}
+	 */
+	isSelection(obj: any): obj is Selection;
+	/**
+	 * @private
+	 * @returns {window}
+	 */
+	_getFrameWindow(): Window & typeof globalThis;
+}

package/types/editorInjector/_core.d.ts

@@ -19,6 +19,11 @@ export default class CoreInjector {
 	 * @type {__se__EditorCore['eventManager']}
 	 */
 	eventManager: __se__EditorCore['eventManager'];
+	/**
+	 * @description The util/instanceCheck instance.
+	 * @type {__se__EditorCore['instanceCheck']}
+	 */
+	instanceCheck: __se__EditorCore['instanceCheck'];
 	/**
 	 * @description The history manager instance.
 	 * @type {__se__EditorCore['history']}
@@ -84,9 +89,4 @@ export default class CoreInjector {
 	 * @type {Document}
 	 */
 	_d: Document;
-	/**
-	 * @description The shadow root object (if any).
-	 * @type {__se__EditorCore['_shadowRoot']}
-	 */
-	_shadowRoot: __se__EditorCore['_shadowRoot'];
 }

package/types/editorInjector/index.d.ts

@@ -14,6 +14,8 @@ declare class EditorInjector {
 	editor: __se__EditorCore;
 	/** @type {import('./_core').default['eventManager']} */
 	eventManager: import('./_core').default['eventManager'];
+	/** @type {import('./_core').default['instanceCheck']} */
+	instanceCheck: import('./_core').default['instanceCheck'];
 	/** @type {import('./_core').default['history']} */
 	history: import('./_core').default['history'];
 	/** @type {import('./_core').default['events']} */
@@ -40,8 +42,6 @@ declare class EditorInjector {
 	_w: import('./_core').default['_w'];
 	/** @type {import('./_core').default['_d']} */
 	_d: import('./_core').default['_d'];
-	/** @type {import('./_core').default['_shadowRoot']} */
-	_shadowRoot: import('./_core').default['_shadowRoot'];
 	/** @type {import('./_classes').default['toolbar']} */
 	toolbar: import('./_classes').default['toolbar'];
 	/** @type {import('./_classes').default['subToolbar']} */

package/types/events.d.ts

@@ -8,7 +8,9 @@ declare namespace _default {
 	let onKeyDown: any;
 	let onKeyUp: any;
 	let onFocus: any;
+	let onNativeFocus: any;
 	let onBlur: any;
+	let onNativeBlur: any;
 	let onCopy: any;
 	let onCut: any;
 	let onChange: any;

package/types/helper/converter.d.ts

@@ -44,6 +44,14 @@ export function debounce(func: (...args: any) => void, wait: number): any;
  * @param {Map<*, *>} referenceMap The Map providing the reference values (source).
  */
 export function syncMaps(targetMap: Map<any, any>, referenceMap: Map<any, any>): void;
+/**
+ * @description Merges multiple Map objects into a new Map using spread syntax.
+ * - Entries from later maps in the arguments list will overwrite entries from earlier maps if keys conflict.
+ * - The original maps are not modified.
+ * @param {...Map<*, *>} mapsToMerge - An arbitrary number of Map objects to merge.
+ * @returns {Map<*, *>} A new Map containing all entries from the input maps.
+ */
+export function mergeMaps(...mapsToMerge: Map<any, any>[]): Map<any, any>;
 /**
  * @description Object.values
  * @param {Object<*, *>} obj Object parameter.
@@ -177,6 +185,7 @@ declare namespace converter {
 	export { entityToHTML };
 	export { debounce };
 	export { syncMaps };
+	export { mergeMaps };
 	export { getValues };
 	export { camelToKebabCase };
 	export { kebabToCamelCase };

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

@@ -186,11 +186,11 @@ export function findTabEndIndex(line: Node, baseIndex: number, minTabSize: numbe
  */
 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'))
@@ -218,6 +218,6 @@ declare namespace query {
 	export { findTextIndexOnLine };
 	export { findTabEndIndex };
 	export { findVisualLastCell };
-	export { getScrollParent };
+	export { getScrollParents };
 	export { getIframeDocument };
 }

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

@@ -115,6 +115,13 @@ export function changeTxt(node: Node, txt: string): void;
  * @param {string|number} value Style value
  */
 export function setStyle(elements: Node | Node[], styleName: string, value: string | number): void;
+/**
+ * @description Gets the style value of the element. If the elements is an array, the style of the first element is returned.
+ * @param {Node} element Element to get style from.
+ * @param {string} styleName Style attribute name (e.g., 'marginLeft', 'textAlign').
+ * @returns {string | undefined} The value of the style attribute, or undefined if the element does not exist.
+ */
+export function getStyle(element: Node, styleName: string): string | undefined;
 /**
  * @description In the predefined code view mode, the buttons except the executable button are changed to the 'disabled' state.
  * @param {Array<HTMLButtonElement|HTMLInputElement>} buttonList (Button | Input) Element array
@@ -212,6 +219,7 @@ declare namespace utils {
 	export { changeElement };
 	export { changeTxt };
 	export { setStyle };
+	export { getStyle };
 	export { setDisabled };
 	export { hasClass };
 	export { addClass };

package/types/helper/env.d.ts

@@ -78,10 +78,14 @@ export const isChromium: boolean;
 export const isSafari: boolean;
 /**
  * @description Check if User Agent is Mobile device.
- * - when the device is touchable, it is judged as a mobile device.
  * @type {boolean}
  */
 export const isMobile: boolean;
+/**
+ * @description Check if the device is touchable.
+ * @type {boolean}
+ */
+export const isTouchDevice: boolean;
 /**
  * @description Check if User Agent is Android mobile device.
  * @type {boolean}
@@ -124,6 +128,7 @@ declare namespace env {
 	export { isOSX_IOS };
 	export { isAndroid };
 	export { isMobile };
+	export { isTouchDevice };
 	export { cmdIcon };
 	export { shiftIcon };
 	export { DPI };

package/types/helper/index.d.ts

@@ -16,6 +16,7 @@ export const env: {
 	isOSX_IOS: boolean;
 	isAndroid: boolean;
 	isMobile: boolean;
+	isTouchDevice: boolean;
 	cmdIcon: string;
 	shiftIcon: string;
 	DPI: number;
@@ -35,6 +36,7 @@ export const converter: {
 	entityToHTML: typeof import('./converter').entityToHTML;
 	debounce: typeof import('./converter').debounce;
 	syncMaps: typeof import('./converter').syncMaps;
+	mergeMaps: typeof import('./converter').mergeMaps;
 	getValues: typeof import('./converter').getValues;
 	camelToKebabCase: typeof import('./converter').camelToKebabCase;
 	kebabToCamelCase: typeof import('./converter').kebabToCamelCase;
@@ -74,7 +76,7 @@ export const dom: {
 		findTextIndexOnLine: typeof import('./dom/domQuery').findTextIndexOnLine;
 		findTabEndIndex: typeof import('./dom/domQuery').findTabEndIndex;
 		findVisualLastCell: typeof import('./dom/domQuery').findVisualLastCell;
-		getScrollParent: typeof import('./dom/domQuery').getScrollParent;
+		getScrollParents: typeof import('./dom/domQuery').getScrollParents;
 		getIframeDocument: typeof import('./dom/domQuery').getIframeDocument;
 	};
 	check: {
@@ -122,6 +124,7 @@ export const dom: {
 		changeElement: typeof import('./dom/domUtils').changeElement;
 		changeTxt: typeof import('./dom/domUtils').changeTxt;
 		setStyle: typeof import('./dom/domUtils').setStyle;
+		getStyle: typeof import('./dom/domUtils').getStyle;
 		setDisabled: typeof import('./dom/domUtils').setDisabled;
 		hasClass: typeof import('./dom/domUtils').hasClass;
 		addClass: typeof import('./dom/domUtils').addClass;

package/types/index.d.ts

@@ -1,120 +1,122 @@
-/**
- * @file Automatically generated by barrelsby.
- */
-
-export * from './events';
-export * from './index';
-export * from './suneditor';
-export * from './assets/icons/defaultIcons';
-export * from './core/editor';
-export * from './core/base/eventManager';
-export * from './core/base/history';
-export * from './core/base/eventHandlers/handler_toolbar';
-export * from './core/base/eventHandlers/handler_ww_clipboard';
-export * from './core/base/eventHandlers/handler_ww_dragDrop';
-export * from './core/base/eventHandlers/handler_ww_key_input';
-export * from './core/base/eventHandlers/handler_ww_mouse';
-export * from './core/class/char';
-export * from './core/class/component';
-export * from './core/class/format';
-export * from './core/class/html';
-export * from './core/class/menu';
-export * from './core/class/nodeTransform';
-export * from './core/class/offset';
-export * from './core/class/selection';
-export * from './core/class/shortcuts';
-export * from './core/class/toolbar';
-export * from './core/class/ui';
-export * from './core/class/viewer';
-export * from './core/section/actives';
-export * from './core/section/constructor';
-export * from './core/section/context';
-export * from './core/section/documentType';
-export * from './editorInjector/_classes';
-export * from './editorInjector/_core';
-export * from './editorInjector/index';
-export * from './helper/clipboard';
-export * from './helper/converter';
-export * from './helper/env';
-export * from './helper/index';
-export * from './helper/keyCodeMap';
-export * from './helper/numbers';
-export * from './helper/unicode';
-export * from './helper/dom/domCheck';
-export * from './helper/dom/domQuery';
-export * from './helper/dom/domUtils';
-export * from './helper/dom/index';
-export * from './langs/_Lang';
-export * from './langs/ckb';
-export * from './langs/cs';
-export * from './langs/da';
-export * from './langs/de';
-export * from './langs/en';
-export * from './langs/es';
-export * from './langs/fa';
-export * from './langs/fr';
-export * from './langs/he';
-export * from './langs/hu';
-export * from './langs/index';
-export * from './langs/it';
-export * from './langs/ja';
-export * from './langs/km';
-export * from './langs/ko';
-export * from './langs/lv';
-export * from './langs/nl';
-export * from './langs/pl';
-export * from './langs/pt_br';
-export * from './langs/ro';
-export * from './langs/ru';
-export * from './langs/se';
-export * from './langs/tr';
-export * from './langs/uk';
-export * from './langs/ur';
-export * from './langs/zh_cn';
-export * from './modules/ApiManager';
-export * from './modules/Browser';
-export * from './modules/ColorPicker';
-export * from './modules/Controller';
-export * from './modules/Figure';
-export * from './modules/FileManager';
-export * from './modules/HueSlider';
-export * from './modules/Modal';
-export * from './modules/ModalAnchorEditor';
-export * from './modules/SelectMenu';
-export * from './modules/_DragHandle';
-export * from './modules/index';
-export * from './plugins/index';
-export * from './plugins/browser/audioGallery';
-export * from './plugins/browser/fileBrowser';
-export * from './plugins/browser/fileGallery';
-export * from './plugins/browser/imageGallery';
-export * from './plugins/browser/videoGallery';
-export * from './plugins/command/blockquote';
-export * from './plugins/command/exportPDF';
-export * from './plugins/command/fileUpload';
-export * from './plugins/command/list_bulleted';
-export * from './plugins/command/list_numbered';
-export * from './plugins/dropdown/align';
-export * from './plugins/dropdown/backgroundColor';
-export * from './plugins/dropdown/font';
-export * from './plugins/dropdown/fontColor';
-export * from './plugins/dropdown/formatBlock';
-export * from './plugins/dropdown/hr';
-export * from './plugins/dropdown/layout';
-export * from './plugins/dropdown/lineHeight';
-export * from './plugins/dropdown/list';
-export * from './plugins/dropdown/paragraphStyle';
-export * from './plugins/dropdown/table';
-export * from './plugins/dropdown/template';
-export * from './plugins/dropdown/textStyle';
-export * from './plugins/field/mention';
-export * from './plugins/input/fontSize';
-export * from './plugins/input/pageNavigator';
-export * from './plugins/modal/audio';
-export * from './plugins/modal/drawing';
-export * from './plugins/modal/embed';
-export * from './plugins/modal/image';
-export * from './plugins/modal/link';
-export * from './plugins/modal/math';
-export * from './plugins/modal/video';
-export * from './plugins/popup/anchor';
+/**
+ * @file Automatically generated by barrelsby.
+ */
+
+export * from './events';
+export * from './index';
+export * from './suneditor';
+export * from './assets/icons/defaultIcons';
+export * from './core/editor';
+export * from './core/base/eventManager';
+export * from './core/base/history';
+export * from './core/base/eventHandlers/handler_toolbar';
+export * from './core/base/eventHandlers/handler_ww_clipboard';
+export * from './core/base/eventHandlers/handler_ww_dragDrop';
+export * from './core/base/eventHandlers/handler_ww_key_input';
+export * from './core/base/eventHandlers/handler_ww_mouse';
+export * from './core/class/char';
+export * from './core/class/component';
+export * from './core/class/format';
+export * from './core/class/html';
+export * from './core/class/menu';
+export * from './core/class/nodeTransform';
+export * from './core/class/offset';
+export * from './core/class/selection';
+export * from './core/class/shortcuts';
+export * from './core/class/toolbar';
+export * from './core/class/ui';
+export * from './core/class/viewer';
+export * from './core/section/actives';
+export * from './core/section/constructor';
+export * from './core/section/context';
+export * from './core/section/documentType';
+export * from './core/section/options';
+export * from './core/util/instanceCheck';
+export * from './editorInjector/_classes';
+export * from './editorInjector/_core';
+export * from './editorInjector/index';
+export * from './helper/clipboard';
+export * from './helper/converter';
+export * from './helper/env';
+export * from './helper/index';
+export * from './helper/keyCodeMap';
+export * from './helper/numbers';
+export * from './helper/unicode';
+export * from './helper/dom/domCheck';
+export * from './helper/dom/domQuery';
+export * from './helper/dom/domUtils';
+export * from './helper/dom/index';
+export * from './langs/_Lang';
+export * from './langs/ckb';
+export * from './langs/cs';
+export * from './langs/da';
+export * from './langs/de';
+export * from './langs/en';
+export * from './langs/es';
+export * from './langs/fa';
+export * from './langs/fr';
+export * from './langs/he';
+export * from './langs/hu';
+export * from './langs/index';
+export * from './langs/it';
+export * from './langs/ja';
+export * from './langs/km';
+export * from './langs/ko';
+export * from './langs/lv';
+export * from './langs/nl';
+export * from './langs/pl';
+export * from './langs/pt_br';
+export * from './langs/ro';
+export * from './langs/ru';
+export * from './langs/se';
+export * from './langs/tr';
+export * from './langs/uk';
+export * from './langs/ur';
+export * from './langs/zh_cn';
+export * from './modules/ApiManager';
+export * from './modules/Browser';
+export * from './modules/ColorPicker';
+export * from './modules/Controller';
+export * from './modules/Figure';
+export * from './modules/FileManager';
+export * from './modules/HueSlider';
+export * from './modules/Modal';
+export * from './modules/ModalAnchorEditor';
+export * from './modules/SelectMenu';
+export * from './modules/_DragHandle';
+export * from './modules/index';
+export * from './plugins/index';
+export * from './plugins/browser/audioGallery';
+export * from './plugins/browser/fileBrowser';
+export * from './plugins/browser/fileGallery';
+export * from './plugins/browser/imageGallery';
+export * from './plugins/browser/videoGallery';
+export * from './plugins/command/blockquote';
+export * from './plugins/command/exportPDF';
+export * from './plugins/command/fileUpload';
+export * from './plugins/command/list_bulleted';
+export * from './plugins/command/list_numbered';
+export * from './plugins/dropdown/align';
+export * from './plugins/dropdown/backgroundColor';
+export * from './plugins/dropdown/font';
+export * from './plugins/dropdown/fontColor';
+export * from './plugins/dropdown/formatBlock';
+export * from './plugins/dropdown/hr';
+export * from './plugins/dropdown/layout';
+export * from './plugins/dropdown/lineHeight';
+export * from './plugins/dropdown/list';
+export * from './plugins/dropdown/paragraphStyle';
+export * from './plugins/dropdown/table';
+export * from './plugins/dropdown/template';
+export * from './plugins/dropdown/textStyle';
+export * from './plugins/field/mention';
+export * from './plugins/input/fontSize';
+export * from './plugins/input/pageNavigator';
+export * from './plugins/modal/audio';
+export * from './plugins/modal/drawing';
+export * from './plugins/modal/embed';
+export * from './plugins/modal/image';
+export * from './plugins/modal/link';
+export * from './plugins/modal/math';
+export * from './plugins/modal/video';
+export * from './plugins/popup/anchor';