suneditor 3.0.0-alpha.2 → 3.0.0-alpha.20

package/src/core/base/events.js

@@ -1,320 +1,616 @@
-export default function () {
-	return {
-		/**
-		 * @description Event functions
-		 */
-		onload: null,
-		onScroll: null,
-		onMouseDown: null,
-		onClick: null,
-		onInput: null,
-		onMouseLeave: null,
-		onKeyDown: null,
-		onKeyUp: null,
-		onCopy: null,
-		onCut: null,
-		onFocus: null,
-		onBlur: null,
-		onChange: null,
-
-		/**
-		 * @description Called just before the inline toolbar is positioned and displayed on the screen.
-		 * @param {Element} toolbar Toolbar Element
-		 * @param {Object} context The editor's context object (editor.getContext())
-		 * @param {Object} core Core object
-		 */
-		onShowToolbar: null,
-
-		/**
-		 * @description Called just after the controller is positioned and displayed on the screen.
-		 * controller - editing elements displayed on the screen [image resizing, table editor, link editor..]]
-		 * @param {String} name The name of the plugin that called the controller
-		 * @param {Array} controllers Array of Controller elements
-		 * @param {Object} core Core object
-		 */
-		onShowController: null,
-		onBeforeShowController: null,
-
-		/**
-		 * @description An event when toggling between code view and wysiwyg view.
-		 * @param {Boolean} isCodeView Whether the current code view mode
-		 * @param {Object} core Core object
-		 */
-		onToggleCodeView: null,
-
-		/**
-		 * @description An event when toggling full screen.
-		 * @param {Boolean} isFullScreen Whether the current full screen mode
-		 * @param {Object} core Core object
-		 */
-		onToggleFullScreen: null,
-
-		/**
-		 * @description Called when the editor is resized using the bottom bar
-		 */
-		onResizeEditor: null,
-
-		/**
-		 * @description Called after the "setToolbarButtons" invocation.
-		 * Can be used to tweak buttons properties (useful for custom buttons)
-		 * @param {Element} buttonTray Button tray element
-		 * @param {Object} core Core object
-		 */
-		onSetToolbarButtons: null,
-
-		/**
-		 * --------------------------------------------------- async function ---------------------------------------------------
-		 */
-
-		/**
-		 * @description Event functions
-		 * @param {String} contents Current contents
-		 * @param {String|null} key Root key
-		 */
-		onSave: null,
-
-		/**
-		 * @description Event functions (drop, paste)
-		 * When false is returned, the default behavior is stopped.
-		 * If the string is returned, the cleanData value is modified to the return value.
-		 * @param {Object} e Event object.
-		 * @param {String} cleanData HTML string modified for editor format.
-		 * @param {Boolean} maxChartCount option (true if max character is exceeded)
-		 * @param {Object} core Core object
-		 * @returns {Boolean|String}
-		 */
-		onDrop: null,
-		onPaste: null,
-
-		/**
-		 * @description It replaces the default callback function of the image upload
-		 * @param {Object} response Response object
-		 * @param {Object} info Input information
-		 * - linkValue: Link url value
-		 * - linkNewWindow: Open in new window Check Value
-		 * - inputWidth: Value of width input
-		 * - inputHeight: Value of height input
-		 * - align: Align Check Value
-		 * - isUpdate: Update image if true, create image if false
-		 * - element: If isUpdate is true, the currently selected image.
-		 * @param {Object} core Core object
-		 */
-		imageUploadHandler: null,
-
-		/**
-		 * @description Called before the image is uploaded
-		 * If true is returned, the internal upload process runs normally.
-		 * If false is returned, no image upload is performed.
-		 * If new fileList are returned,  replaced the previous fileList
-		 * If undefined is returned, it waits until "uploadHandler" is executed.
-		 * @param {Array} files Files array
-		 * @param {Object} info info: {
-		 * - linkValue: Link url value
-		 * - linkNewWindow: Open in new window Check Value
-		 * - inputWidth: Value of width input
-		 * - inputHeight: Value of height input
-		 * - align: Align Check Value
-		 * - isUpdate: Update image if true, create image if false
-		 * - element: If isUpdate is true, the currently selected image.
-		 * }
-		 * @param {Object} core Core object
-		 * @param {Function} uploadHandler If undefined is returned, it waits until "uploadHandler" is executed.
-		 *                "uploadHandler" is an upload function with "core" and "info" bound.
-		 *                [upload files] : uploadHandler(files or [new File(...),])
-		 *                [error]        : uploadHandler("Error message")
-		 *                [Just finish]  : uploadHandler()
-		 *                [directly register] : uploadHandler(response) // Same format as "imageUploadUrl" response
-		 *                                   ex) {
-		 *                                      // "errorMessage": "insert error message",
-		 *                                      "result": [ { "url": "...", "name": "...", "size": "999" }, ]
-		 *                                   }
-		 * @returns {Boolean|Array|undefined}
-		 */
-		onImageUploadBefore: null,
-
-		/**
-		 * @description Called before the image is deleted
-		 */
-		onImageDeleteBefore: null,
-
-		/**
-		 * @description Called when the editor loaded, file Current editor value
-		 * -- arguments is same "Image info object" --
-		 */
-		onImageLoad: null,
-
-		/**
-		 * @description Called when the image is uploaded, updated, deleted
-		 * @param {Element} targetElement Target element
-		 * @param {Number} index Uploaded index
-		 * @param {String} state Upload status ('create', 'update', 'delete')
-		 * @param {Object} info Image info object
-		 * - index: data index
-		 * - name: file name
-		 * - size: file size
-		 * - select: select function
-		 * - delete: delete function
-		 * - element: target element
-		 * - src: src attribute of tag
-		 * @param {Number} remainingFilesCount Count of remaining files to upload (0 when added as a url)
-		 * @param {Object} core Core object
-		 */
-		onImageAction: null,
-
-		/**
-		 * @description Called when the image is upload failed
-		 * @param {String} errorMessage Error message
-		 * @param {Object} result Response Object
-		 * @param {Object} core Core object
-		 * @returns {Boolean}
-		 */
-		onImageUploadError: null,
-
-		/**
-		 * @description It replaces the default callback function of the video upload
-		 * @param xmlHttp xmlHttpRequest object
-		 * @param info Input information
-		 * - inputWidth: Value of width input
-		 * - inputHeight: Value of height input
-		 * - align: Align Check Value
-		 * - isUpdate: Update video if true, create video if false
-		 * - element: If isUpdate is true, the currently selected video.
-		 * @param core Core object
-		 */
-		videoUploadHandler: null,
-
-		/**
-		 * @description Called before the video is uploaded
-		 * If true is returned, the internal upload process runs normally.
-		 * If false is returned, no video(iframe, video) upload is performed.
-		 * If new fileList are returned,  replaced the previous fileList
-		 * If undefined is returned, it waits until "uploadHandler" is executed.
-		 * @param {Array} files Files array
-		 * @param {Object} info info: {
-		 * - inputWidth: Value of width input
-		 * - inputHeight: Value of height input
-		 * - align: Align Check Value
-		 * - isUpdate: Update video if true, create video if false
-		 * - element: If isUpdate is true, the currently selected video.
-		 * }
-		 * @param {Object} core Core object
-		 * @param {Function} uploadHandler If undefined is returned, it waits until "uploadHandler" is executed.
-		 *                "uploadHandler" is an upload function with "core" and "info" bound.
-		 *                [upload files] : uploadHandler(files or [new File(...),])
-		 *                [error]        : uploadHandler("Error message")
-		 *                [Just finish]  : uploadHandler()
-		 *                [directly register] : uploadHandler(response) // Same format as "videoUploadUrl" response
-		 *                                   ex) {
-		 *                                      // "errorMessage": "insert error message",
-		 *                                      "result": [ { "url": "...", "name": "...", "size": "999" }, ]
-		 *                                   }
-		 * @returns {Boolean|Array|undefined}
-		 */
-		onVideoUploadBefore: null,
-
-		/**
-		 * @description Called when the video(iframe, video) upload failed
-		 */
-		onVideoUploadError: null,
-
-		/**
-		 * @description Called when the editor loaded, file Current editor value
-		 * -- arguments is same "Image info object" --
-		 */
-		onVideoLoad: null,
-
-		/**
-		 * @description Called when the video(iframe, video) is is uploaded, updated, deleted
-		 * -- arguments is same "onImageUpload" --
-		 */
-		onVideoAction: null,
-
-		/**
-		 * @description Called before the video is deleted
-		 */
-		onVideoDeleteBefore: null,
-
-		/**
-		 * @description It replaces the default callback function of the audio upload
-		 * @param xmlHttp xmlHttpRequest object
-		 * @param info Input information
-		 * - isUpdate: Update audio if true, create audio if false
-		 * - element: If isUpdate is true, the currently selected audio.
-		 * @param core Core object
-		 */
-		audioUploadHandler: null,
-
-		/**
-		 * @description Called before the audio is uploaded
-		 * If true is returned, the internal upload process runs normally.
-		 * If false is returned, no audio upload is performed.
-		 * If new fileList are returned,  replaced the previous fileList
-		 * If undefined is returned, it waits until "uploadHandler" is executed.
-		 * @param {Array} files Files array
-		 * @param {Object} info info: {
-		 * - isUpdate: Update audio if true, create audio if false
-		 * - element: If isUpdate is true, the currently selected audio.
-		 * }
-		 * @param {Object} core Core object
-		 * @param {Function} uploadHandler If undefined is returned, it waits until "uploadHandler" is executed.
-		 *                "uploadHandler" is an upload function with "core" and "info" bound.
-		 *                [upload files] : uploadHandler(files or [new File(...),])
-		 *                [error]        : uploadHandler("Error message")
-		 *                [Just finish]  : uploadHandler()
-		 *                [directly register] : uploadHandler(response) // Same format as "audioUploadUrl" response
-		 *                                   ex) {
-		 *                                      // "errorMessage": "insert error message",
-		 *                                      "result": [ { "url": "...", "name": "...", "size": "999" }, ]
-		 *                                   }
-		 * @returns {Boolean|Array|undefined}
-		 */
-		onAudioUploadBefore: null,
-
-		/**
-		 * @description Called when the audio upload failed
-		 */
-		onAudioUploadError: null,
-
-		/**
-		 * @description Called when the audio is is uploaded, updated, deleted
-		 * -- arguments is same "onImageUpload" --
-		 */
-		onAudioAction: null,
-
-		/**
-		 * @description Called before the audio is deleted
-		 */
-		onAudioDeleteBefore: null,
-
-		/**
-		 * @description Called when the editor loaded, file Current editor value
-		 * -- arguments is same "Image info object" --
-		 */
-		onAudioLoad: null,
-
-		/**
-		 * @description Called when the file is is uploaded, updated, deleted
-		 * -- arguments is same "onImageUpload" --
-		 */
-		onFileAction: null,
-
-		/**
-		 * @description Called before the file is deleted
-		 */
-		onFileDeleteBefore: null,
-
-		/**
-		 * @description Called when the editor loaded, file Current editor value
-		 * -- arguments is same "Image info object" --
-		 */
-		onFileLoad: null,
-
-		onFileUploadBefore: null,
-
-		onFileUploadError: null,
-
-		onExportPdfBefore: null,
-
-		onFileManagerAction: null
-	};
-}
+// Event function collection
+// This is a collection of functions that can be used in the editor's event callback.
+// ---------
+
+/**
+ * @typedef {import('../../modules/Controller').default} ControllerInstance
+ */
+
+// --- native events
+/**
+ * @typedef {Object} BaseEvent
+ * @property {__se__EditorCore} editor - The root editor instance
+ * @property {__se__FrameContext} frameContext - frame context
+ * @property {Event} event - event object
+ */
+
+/**
+ * @typedef {Object} ClipboardEvent
+ * @property {__se__EditorCore} editor - The root editor instance
+ * @property {__se__FrameContext} frameContext - frame context
+ * @property {Event} event - event object
+ * @property {string} data - drop data
+ * @property {boolean} maxCharCount - is max char count
+ * @property {string} from - "SE"|"MS"|"" - source
+ */
+
+// --- controller
+/**
+ * @typedef {Object} ControllerInfo
+ * @property {"top"|"bottom"|"position"} position - controller position
+ * @property {ControllerInstance} inst - controller instance
+ * @property {HTMLElement} form - controller element
+ * @property {HTMLElement} target - controller target element
+ * @property {boolean} isRangeTarget - If the target is a Range, set it to true.
+ * @property {boolean} notInCarrier - "form"" is not included in the carrier.
+ */
+
+// --- media
+/**
+ * @typedef {Object} FileManagementInfo
+ * @property {string} src - source URL of the image.
+ * @property {number} index - index of the image.
+ * @property {string} name - name of the file.
+ * @property {number} size -  size of the file in bytes.
+ * @property {HTMLElement} element -  target element.
+ * @property {() => void} delete -  delete function.
+ * @property {() => void} select -  select function.
+ */
+
+/**
+ * @typedef {Object} ProcessInfo
+ * @property {string} origin - origin url
+ * @property {string} url - url
+ * @property {"video"|"iframe"} tag - tag name
+ * @property {?HTMLCollection} children - embed children tags
+ */
+
+// --- image
+/**
+ * @typedef {Object} ImageInfo
+ * @property {FileList} files - FileList object
+ * @property {HTMLImageElement} element - target element
+ * @property {string} inputWidth - width value
+ * @property {string} inputHeight - height value
+ * @property {string} align - align value
+ * @property {boolean} isUpdate - new create or update
+ * @property {?HTMLElement} anchor - Anchor element, if it exists
+ * @property {string} alt - alt text value
+ */
+
+// --- video
+/**
+ * @typedef {Object} VideoInfo
+ * @property {FileList} files - FileList object
+ * @property {HTMLIFrameElement|HTMLVideoElement} element - target element
+ * @property {string} inputWidth - width value
+ * @property {string} inputHeight - height value
+ * @property {string} align - align value
+ * @property {boolean} isUpdate - new create or update
+ * @property {string} url - video url
+ * @property {?ProcessInfo} process - video process info
+ */
+
+// --- audio
+/**
+ * @typedef {Object} AudioInfo
+ * @property {HTMLAudioElement} element - target element
+ * @property {FileList} files - FileList object
+ * @property {boolean} isUpdate - new create or update
+ */
+
+// --- file
+/**
+ * @typedef {Object} FileInfo
+ * @property {string} url - file url
+ * @property {FileList} files - FileList object
+ * @property {Object} uploadHeaders - upload headers
+ */
+
+// --- embed
+/**
+ * @typedef {Object} EmbedInfo
+ * @property {HTMLElement} element - target element
+ * @property {string} inputWidth - width value
+ * @property {string} inputHeight - height value
+ * @property {string} align - align value
+ * @property {boolean} isUpdate - new create or update
+ * @property {string} url - embed url
+ * @property {?HTMLElement} children - When the input source is stacked in an iframe, etc., the actual embedded DOM
+ * @property {?ProcessInfo} process - embed process info
+ */
+
+// event function collection
+export default {
+	/**
+	 * @description Event call back function
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 */
+	onload: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onScroll: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onMouseDown: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onClick: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onInput: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onMouseLeave: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onKeyDown: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onKeyUp: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onFocus: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {BaseEvent} params
+	 */
+	onBlur: null,
+
+	/**
+	 * @description Event function on copy
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {Event} params.event - event object
+	 * @param {Event} params.clipboardData - clipboardData
+	 */
+	onCopy: null,
+
+	/**
+	 * @description Event function on cut
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {Event} params.event - event object
+	 * @param {Event} params.clipboardData - clipboardData
+	 */
+	onCut: null,
+
+	/**
+	 * @description Event call back function
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {Event} params.event - event object
+	 * @param {Event} params.data - editor data
+	 */
+	onChange: null,
+
+	/**
+	 * @description Called just before the inline toolbar is positioned and displayed on the screen.
+	 * @param {HTMLElement} toolbar - Toolbar element
+	 * @param {string} mode - Toolbar mode
+	 */
+	onShowToolbar: null,
+
+	/**
+	 * @description Called just after the controller is positioned and displayed on the screen.
+	 * - controller : editing elements displayed on the screen [image resizing, table editor, link editor..]]
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {string} params.caller - caller plugin name
+	 * @param {ControllerInfo} params.info - info object
+	 */
+	onShowController: null,
+
+	/**
+	 * @description Called just after the controller is positioned and displayed on the screen.
+	 * - controller : editing elements displayed on the screen [image resizing, table editor, link editor..]]
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {string} params.caller - caller plugin name
+	 * @param {ControllerInfo} params.info - info object
+	 */
+	onBeforeShowController: null,
+
+	/**
+	 * @description An event when toggling between code view and wysiwyg view.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {boolean} params.is - code view status
+	 */
+	onToggleCodeView: null,
+
+	/**
+	 * @description An event when toggling full screen.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {boolean} params.is - full screen status
+	 */
+	onToggleFullScreen: null,
+
+	/**
+	 * @description Called when the editor is resized using the bottom bar
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {number} params.height - wysiwyg area frame height
+	 * @param {boolean} params.prevHeight - wysiwyg area previous height
+	 * @param {ResizeObserverEntry} params.observerEntry - ResizeObserverEntry
+	 */
+	onResizeEditor: null,
+
+	/**
+	 * @description Called after the "setToolbarButtons" invocation.
+	 * - Can be used to tweak buttons properties (useful for custom buttons)
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {HTMLElement} params.buttonTray - button tray element
+	 */
+	onSetToolbarButtons: null,
+
+	/**
+	 * --------------------------------------------------- async function ---------------------------------------------------
+	 */
+
+	/**
+	 * @description Event callback function on save
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {__se__FrameContext} params.frameContext - frame context
+	 * @param {Event} params.data - editor data
+	 * @returns {Promise<boolean>}
+	 */
+	onSave: null,
+
+	/**
+	 * @description Event function on [drop, paste] before
+	 * - When false is returned, the default behavior is stopped.
+	 * - If the string is returned, the cleanData value is modified to the return value.
+	 * @param {ClipboardEvent} params
+	 * @returns {Promise<boolean|string>}
+	 */
+	onDrop: null,
+
+	/**
+	 * @description Event function on [drop, paste] before
+	 * - When false is returned, the default behavior is stopped.
+	 * - If the string is returned, the cleanData value is modified to the return value.
+	 * @param {ClipboardEvent} params
+	 * @returns {Promise<boolean|string>}
+	 */
+	onPaste: null,
+
+	// --- image
+	/**
+	 * @description It replaces the default callback function of the image upload
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {XMLHttpRequest} params.xmlHttp - XMLHttpRequest
+	 * @param {ImageInfo} params.info - info object
+	 * @returns {Promise<boolean>}
+	 */
+	imageUploadHandler: null,
+
+	/**
+	 * @description Called before the image is uploaded
+	 * - If true is returned, the internal upload process runs normally.
+	 * - If false is returned, no image upload is performed.
+	 * - If new "info" are returned, replaced the previous "params.info"
+	 * - If undefined is returned, it waits until "uploadHandler" is executed.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {ImageInfo} params.info - info object
+	 * @param {(newInfo?: ImageInfo|null) => void} params.handler - handler function
+	 * @returns {Promise<boolean|undefined|ImageInfo>}
+	 */
+	onImageUploadBefore: null,
+
+	/**
+	 * @description Called when the editor loaded, file Current editor value
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {Array<FileManagementInfo>} infoList - info list
+	 */
+	onImageLoad: null,
+
+	/**
+	 * @description Called when the image is uploaded, updated, deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileManagementInfo} params.info - info object
+	 * @param {HTMLElement|null} params.element - target element
+	 * @param {"create"|"update"|"delete"} params.state - state
+	 * @param {number} params.index - data index
+	 * @param {number} params.remainingFilesCount - remaining files count
+	 * @param {string} params.pluginName - plugin name
+	 */
+	onImageAction: null,
+
+	/**
+	 * @description Called when the image is upload failed
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {string} params.error - error message
+	 * @param {number=} params.limitSize - limit size
+	 * @param {number=} params.uploadSize - upload size
+	 * @param {number=} params.currentSize - current size
+	 * @param {File=} params.file - File object
+	 * @returns {Promise<string|undefined>}
+	 */
+	onImageUploadError: null,
+
+	/**
+	 * @description Called before the image is deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {HTMLElement} params.element - target element
+	 * @param {HTMLElement} params.container - target's container element (div)
+	 * @param {string} params.align - align value
+	 * @param {string} params.alt - alt text value
+	 * @param {?string} params.url - Anchor url, if it exists
+	 * @returns {Promise<boolean>}
+	 */
+	onImageDeleteBefore: null,
+
+	// --- video
+	/**
+	 * @description It replaces the default callback function of the video upload
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {XMLHttpRequest} params.xmlHttp - XMLHttpRequest
+	 * @param {VideoInfo} params.info - info object
+	 * @returns {Promise<boolean>}
+	 */
+	videoUploadHandler: null,
+
+	/**
+	 * @description Called before the video is uploaded
+	 * - If true is returned, the internal upload process runs normally.
+	 * - If false is returned, no video(iframe, video) upload is performed.
+	 * - If new "info" are returned, replaced the previous "params.info"
+	 * - If undefined is returned, it waits until "uploadHandler" is executed.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {VideoInfo} params.info - info object
+	 * @param {(newInfo?: VideoInfo|null) => void} params.handler - handler function
+	 * @returns {Promise<boolean|undefined|VideoInfo>}
+	 */
+	onVideoUploadBefore: null,
+
+	/**
+	 * @description Called when the editor loaded, file Current editor value
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {Array<FileManagementInfo>} infoList - info list
+	 */
+	onVideoLoad: null,
+
+	/**
+	 * @description Called when the video(iframe, video) is is uploaded, updated, deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileManagementInfo} params.info - info object
+	 * @param {HTMLElement|null} params.element - target element
+	 * @param {"create"|"update"|"delete"} params.state - state
+	 * @param {number} params.index - data index
+	 * @param {number} params.remainingFilesCount - remaining files count
+	 * @param {string} params.pluginName - plugin name
+	 */
+	onVideoAction: null,
+
+	/**
+	 * @description Called when the video(iframe, video) upload failed
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {string} params.error - error message
+	 * @param {number=} params.limitSize - limit size
+	 * @param {number=} params.uploadSize - upload size
+	 * @param {number=} params.currentSize - current size
+	 * @param {File=} params.file - File object
+	 * @returns {Promise<string|undefined>}
+	 */
+	onVideoUploadError: null,
+
+	/**
+	 * @description Called before the video is deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {HTMLElement} params.element - target element
+	 * @param {HTMLElement} params.container - target's container element (div)
+	 * @param {string} params.align - align value
+	 * @param {string} params.url - video url
+	 * @returns {Promise<boolean>}
+	 */
+	onVideoDeleteBefore: null,
+
+	/**
+	 * @description It replaces the default callback function of the audio upload
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {XMLHttpRequest} params.xmlHttp - XMLHttpRequest
+	 * @param {AudioInfo} params.info - info object
+	 * @returns {Promise<boolean>}
+	 */
+	audioUploadHandler: null,
+
+	// --- audio
+	/**
+	 * @description Called before the audio is uploaded
+	 * - If true is returned, the internal upload process runs normally.
+	 * - If false is returned, no audio upload is performed.
+	 * - If new "info" are returned, replaced the previous "params.info"
+	 * - If undefined is returned, it waits until "uploadHandler" is executed.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {AudioInfo} params.info - info object
+	 * @param {(newInfo?: AudioInfo|null) => void} params.handler - handler function
+	 * @returns {Promise<boolean|undefined|AudioInfo>}
+	 */
+	onAudioUploadBefore: null,
+
+	/**
+	 * @description Called when the audio upload failed
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {string} params.error - error message
+	 * @param {number=} params.limitSize - limit size
+	 * @param {number=} params.uploadSize - upload size
+	 * @param {number=} params.currentSize - current size
+	 * @param {File=} params.file - File object
+	 * @returns {Promise<string|undefined>}
+	 */
+	onAudioUploadError: null,
+
+	/**
+	 * @description Called when the editor loaded, file Current editor value
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {Array<FileManagementInfo>} infoList - info list
+	 */
+	onAudioLoad: null,
+
+	/**
+	 * @description Called when the audio is is uploaded, updated, deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileManagementInfo} params.info - info object
+	 * @param {HTMLElement|null} params.element - target element
+	 * @param {"create"|"update"|"delete"} params.state - state
+	 * @param {number} params.index - data index
+	 * @param {number} params.remainingFilesCount - remaining files count
+	 * @param {string} params.pluginName - plugin name
+	 */
+	onAudioAction: null,
+
+	/**
+	 * @description Called before the audio is deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {HTMLElement} params.element - target element
+	 * @param {HTMLElement} params.container - target's container element (div)
+	 * @param {string} params.url - audio url
+	 * @returns {Promise<boolean>}
+	 */
+	onAudioDeleteBefore: null,
+
+	// --- fileUpload
+	/**
+	 * @description Called when the file is uploaded
+	 * - If true is returned, the internal upload process runs normally.
+	 * - If false is returned, no image upload is performed.
+	 * - If new "info" are returned, replaced the previous "params.info"
+	 * - If undefined is returned, it waits until "uploadHandler" is executed.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileInfo} params.info - info object
+	 * @param {(newInfo?: FileInfo|null) => void} params.handler - handler function
+	 * @returns {Promise<boolean|undefined|AudioInfo>}
+	 */
+	onFileUploadBefore: null,
+
+	/**
+	 * @description Called when the editor loaded, file Current editor value
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {Array<FileManagementInfo>} infoList - info list
+	 */
+	onFileLoad: null,
+
+	/**
+	 * @description Called when the file is is uploaded, updated, deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileManagementInfo} params.info - info object
+	 * @param {HTMLElement|null} params.element - target element
+	 * @param {"create"|"update"|"delete"} params.state - state
+	 * @param {number} params.index - data index
+	 * @param {number} params.remainingFilesCount - remaining files count
+	 * @param {string} params.pluginName - plugin name
+	 */
+	onFileAction: null,
+
+	/**
+	 * @description Called when the file is upload failed
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {string} params.error - error message
+	 * @param {number=} params.limitSize - limit size
+	 * @param {number=} params.uploadSize - upload size
+	 * @param {number=} params.currentSize - current size
+	 * @param {File=} params.file - File object
+	 * @returns {Promise<string|undefined>}
+	 */
+	onFileUploadError: null,
+
+	/**
+	 * @description Called before the file is deleted
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {HTMLElement} params.element - target element
+	 * @param {HTMLElement} params.container - target's container element (div)
+	 * @param {string} params.url - file url
+	 * @returns {Promise<boolean>}
+	 */
+	onFileDeleteBefore: null,
+
+	// --- exportPDF
+	/**
+	 * @description Called before the PDF export is started
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {HTMLElement} params.target - wysiwyg editable element
+	 * @returns {Promise<boolean>}
+	 */
+	onExportPDFBefore: null,
+
+	// --- fileManager
+	/**
+	 * @description Events that occur when actions such as uploading or deleting all files are performed in the file manager
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {FileManagementInfo} params.info - info object
+	 * @param {HTMLElement|null} params.element - target element
+	 * @param {"create"|"update"|"delete"} params.state - state
+	 * @param {number} params.index - data index
+	 * @param {number} params.remainingFilesCount - remaining files count
+	 * @param {string} params.pluginName - plugin name
+	 */
+	onFileManagerAction: null,
+
+	// --- embed
+	/**
+	 * @description Called before the embed is inserted
+	 * - If true is returned, the internal upload process runs normally.
+	 * - If false is returned, no image upload is performed.
+	 * - If new fileList are returned,  replaced the previous fileList
+	 * - If undefined is returned, it waits until "uploadHandler" is executed.
+	 * @param {Object} params
+	 * @param {__se__EditorCore} params.editor - The root editor instance
+	 * @param {EmbedInfo} params.info - info object
+	 * @param {(newInfo?: EmbedInfo|null) => void} params.handler - handler function
+	 */
+	onEmbedInputBefore: null
+};