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

package/types/plugins/modal/video/services/video.size.d.ts

@@ -0,0 +1,74 @@
+import type {} from '../../../../typedef';
+/**
+ * @class VideoSizeService
+ * @description Handles video size operations including ratio management and size input controls.
+ */
+export class VideoSizeService {
+	/**
+	 * @param {import('../index').default} main - The main Video plugin instance.
+	 * @param {import('../render/video.html').ModalReturns_video} modalEl - Modal element
+	 */
+	constructor(main: import('../index').default, modalEl: import('../render/video.html').ModalReturns_video);
+	frameRatioOption: HTMLSelectElement;
+	/**
+	 * @description Sets the width and height input values.
+	 * @param {string} w - Width value
+	 * @param {string} h - Height value
+	 */
+	setInputSize(w: string, h: string): void;
+	/**
+	 * @description Gets the current width and height input values.
+	 * @returns {{w: string, h: string}}
+	 */
+	getInputSize(): {
+		w: string;
+		h: string;
+	};
+	/**
+	 * @description Sets the original width and height of the video.
+	 * @param {string} w - Original width
+	 * @param {string} h - Original height
+	 */
+	setOriginSize(w: string, h: string): void;
+	/**
+	 * @description Sets the size of the video element.
+	 * @param {string|number} w - The width of the video.
+	 * @param {string|number} h - The height of the video.
+	 */
+	applySize(w: string | number, h: string | number): void;
+	/**
+	 * @description Resolves the final size of the video element, checking if it has changed from the current size.
+	 * @param {string} width - Desired width
+	 * @param {string} height - Desired height
+	 * @param {HTMLElement} oFrame - The video/iframe element
+	 * @param {boolean} isUpdate - Whether we are updating an existing component
+	 * @returns {{width: string, height: string, isChanged: boolean}} Resolved size info
+	 */
+	resolveSize(
+		width: string,
+		height: string,
+		oFrame: HTMLElement,
+		isUpdate: boolean,
+	): {
+		width: string;
+		height: string;
+		isChanged: boolean;
+	};
+	/**
+	 * @description Called when the modal is opened. Initializes inputs and ratio options.
+	 * @param {boolean} isUpdate - Indicates whether the modal is for editing an existing component (`true`) or registering a new one (`false`).
+	 */
+	on(isUpdate: boolean): void;
+	/**
+	 * @description Prepares the size inputs and options when a video component is selected.
+	 * @param {import('../../../../modules/contract/Figure').FigureTargetInfo} figureInfo - Figure size information
+	 * @param {HTMLElement} target - The selected video/iframe element
+	 */
+	ready(figureInfo: import('../../../../modules/contract/Figure').FigureTargetInfo, target: HTMLElement): void;
+	/**
+	 * @description Initializes the size service state.
+	 */
+	init(): void;
+	#private;
+}
+export default VideoSizeService;

package/types/plugins/modal/video/services/video.upload.d.ts

@@ -0,0 +1,19 @@
+import type {} from '../../../../typedef';
+/**
+ * @class VideoUploadService
+ * @description Handles video upload operations including server upload and registration.
+ */
+export class VideoUploadService {
+	/**
+	 * @param {import('../index').default} main - The main Video plugin instance.
+	 */
+	constructor(main: import('../index').default);
+	/**
+	 * @description Uploads a video to the server using an external upload handler.
+	 * @param {SunEditor.EventParams.VideoInfo} info - Video information object.
+	 * @param {FileList} files - The video files to upload.
+	 */
+	serverUpload(info: SunEditor.EventParams.VideoInfo, files: FileList): void;
+	#private;
+}
+export default VideoUploadService;

package/types/plugins/popup/anchor.d.ts

@@ -1,56 +1,26 @@
+import type {} from '../../typedef';
 export default Anchor;
 /**
  * @class
  * @description Anchor plugin
  * - Allows you to create, edit, and delete elements that act as anchors (bookmarks) within a document.
  */
-declare class Anchor extends EditorInjector {
-	static key: string;
-	static type: string;
-	static className: string;
+declare class Anchor extends PluginPopup {
 	/**
-	 * @this {Anchor}
 	 * @param {HTMLElement} node - The node to check.
 	 * @returns {HTMLElement|null} Returns a node if the node is a valid component.
 	 */
-	static component(this: Anchor, node: HTMLElement): HTMLElement | null;
+	static component(node: HTMLElement): HTMLElement | null;
 	title: any;
-	icon: string;
 	bookmarkIcon: HTMLElement;
-	_element: HTMLElement;
-	_range: Range;
 	displayId: Element;
 	controllerSelect: Controller;
 	inputEl: HTMLInputElement;
 	controller: Controller;
-	/**
-	 * @editorMethod Editor.Plugin<popup>
-	 * @description Displays a popup and gives focus to the input field.
-	 */
-	show(): 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): void;
-	/**
-	 * @editorMethod Editor.Component
-	 * @description Called when a container is deselected.
-	 */
-	deselect(): 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
-	 */
+	componentSelect(target: HTMLElement): void | boolean;
+	componentDeselect(target: HTMLElement): void;
 	controllerAction(target: HTMLButtonElement): void;
-	/**
-	 * @private
-	 * @description Initializes state variables.
-	 * - called when the popup is closed
-	 */
-	private _init;
+	#private;
 }
-import EditorInjector from '../../editorInjector';
-import { Controller } from '../../modules';
+import { PluginPopup } from '../../interfaces';
+import { Controller } from '../../modules/contract';

package/types/suneditor.d.ts

@@ -1,51 +1,82 @@
+import type {} from './typedef';
 declare namespace _default {
 	/**
 	 * Returns the create function with preset options.
-	 * If the options overlap, the options of the 'create' function take precedence.
-	 * @param {EditorInitOptions_suneditor} init_options - Initialization options
-	 * @returns {{create: (targets: Element|Object<string, {target: Element, options: EditorFrameOptions_suneditor}>, options: EditorInitOptions_suneditor) => Editor}}}
+	 * If the options overlap, the options of the `create` function take precedence.
+	 * @example
+	 * // Preset common options, then create multiple editors
+	 * const preset = SUNEDITOR.init({
+	 *   plugins: [image, link],
+	 *   buttonList: [['bold', 'italic'], ['image', 'link']],
+	 * });
+	 * const editor1 = preset.create('#editor1', { height: '300px' });
+	 * const editor2 = preset.create('#editor2', { height: '500px' });
+	 * @param {SunEditor.InitOptions} init_options - Initialization options
+	 * @returns {{create: (targets: Element|Object<string, {target: Element, options: SunEditor.InitFrameOptions}>, options: SunEditor.InitOptions) => SunEditor.Instance}}}
 	 */
-	function init(init_options: EditorInitOptions_suneditor): {
+	function init(init_options: SunEditor.InitOptions): {
 		create: (
 			targets:
 				| Element
 				| {
 						[x: string]: {
 							target: Element;
-							options: EditorFrameOptions_suneditor;
+							options: SunEditor.InitFrameOptions;
 						};
 				  },
-			options: EditorInitOptions_suneditor
-		) => Editor;
+			options: SunEditor.InitOptions,
+		) => SunEditor.Instance;
 	};
 	/**
 	 * Creates a new instance of the SunEditor
-	 * @param {Element|Object<string, {target: Element, options: EditorFrameOptions_suneditor}>} target - Target element or multi-root object
-	 * @param {EditorInitOptions_suneditor} options - Initialization options
-	 * @param {EditorInitOptions_suneditor} [_init_options] - Optional preset initialization options
-	 * @returns {Editor} - Instance of the SunEditor
+	 * @example
+	 * // Create with a DOM element
+	 * const editor = SUNEDITOR.create(document.getElementById('editor'), {
+	 *   buttonList: [['bold', 'italic', 'underline']],
+	 * });
+	 *
+	 * // Create with a CSS selector
+	 * const editor = SUNEDITOR.create('#editor', { height: '400px' });
+	 *
+	 * // Create multi-root editor
+	 * const editor = SUNEDITOR.create({
+	 *   header: { target: document.getElementById('header') },
+	 *   body: { target: document.getElementById('body'), options: { height: '500px' } },
+	 * });
+	 * @param {Element|string|Object<string, {target: Element, options: SunEditor.InitFrameOptions}>} target
+	 * - `Element`: The direct DOM element to initialize the editor on.
+	 * - `string`: A CSS selector string. The corresponding element is selected using `document.querySelector`.
+	 * - `Object`: For multi-root setup. Each key maps to a config with `{target, options}`.
+	 * @param {SunEditor.InitOptions} options - Initialization options
+	 * @param {SunEditor.InitOptions} [_init_options] - Optional preset initialization options
+	 * @returns {SunEditor.Instance} - Instance of the SunEditor
 	 * @throws {Error} If the target element is not provided or is invalid
 	 */
 	function create(
 		target:
 			| Element
+			| string
 			| {
 					[x: string]: {
 						target: Element;
-						options: EditorFrameOptions_suneditor;
+						options: SunEditor.InitFrameOptions;
 					};
 			  },
-		options: EditorInitOptions_suneditor,
-		_init_options?: EditorInitOptions_suneditor
-	): Editor;
+		options: SunEditor.InitOptions,
+		_init_options?: SunEditor.InitOptions,
+	): SunEditor.Instance;
 }
 export default _default;
-export type EditorFrameOptions_suneditor = import('./core/section/constructor').EditorFrameOptions;
-export type EditorInitOptions_suneditor = import('./core/section/constructor').EditorInitOptions;
-import EditorInjector from './editorInjector';
-import Plugins from './plugins';
-import Modules from './modules';
-import Langs from './langs';
-import Helper from './helper';
-import Editor from './core/editor';
-export { EditorInjector, Plugins, Modules, Langs, Helper };
+import plugins from './plugins';
+export namespace modules {
+	export { moduleContract as contract };
+	export { moduleManager as manager };
+	export { moduleUI as ui };
+}
+import helper from './helper';
+import * as interfaces from './interfaces';
+import langs from './langs';
+import * as moduleContract from './modules/contract';
+import * as moduleManager from './modules/manager';
+import * as moduleUI from './modules/ui';
+export { helper, interfaces, langs, plugins };