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

package/src/themes/dark.css

@@ -1,132 +1,155 @@
+/** Theme color tokens used by suneditor.css and suneditor-contents.css. */
+/** [ assets/design/color.css ] */
+
 .sun-editor.se-theme-dark,
 .sun-editor-editable.se-theme-dark {
 	/** --------------------------- content - [colors] ----------- */
-	--se-caret-color: #ccc;
-	--se-placeholder-color: #64718c;
-	--se-edit-font-color: #ccc;
-	--se-edit-font-pre: #aaa;
-	--se-edit-font-quote: #888;
-	--se-edit-background-color: #0f1828;
-	--se-edit-background-pre: #364153;
-	--se-edit-border-light: #555;
-	--se-edit-border-dark: #444;
-	--se-edit-border-dark-n1: #555;
-	--se-edit-border-dark-n2: #666;
-	--se-edit-anchor: #77aaff;
-	--se-edit-anchor-on-back: #004cff;
-	--se-edit-anchor-on-font: #e8f7ff;
-	--se-edit-hr-color: #ccc;
-	--se-edit-hr-on-back: #77aaff;
-	--se-edit-active: #77aaff;
-	--se-edit-hover: #5599ff;
-	--se-edit-outline: #444;
+	/* caret and placeholder */
+	--se-caret-color: #e4e4e4;
+	--se-drag-caret-color: #86f0ff;
+	--se-placeholder-color: #9aa0a6;
+
+	/* editable text tones */
+	--se-edit-font-color: #e4e4e4;
+	--se-edit-font-pre: #d0d0d0;
+	--se-edit-font-quote: #b5b5b5;
+
+	/* editable surfaces */
+	--se-edit-background-color: #212121;
+	--se-edit-background-pre: #1a2a30;
+
+	/* content border scale */
+	--se-edit-border-light: #3d5c6e;
+	--se-edit-border-dark: #2e4a5a;
+	--se-edit-border-dark-n1: #355363;
+	--se-edit-border-dark-n2: #456d7f;
+	--se-edit-border-table: #5e5e5e;
+
+	/* links and horizontal rules */
+	--se-edit-anchor: #a7b8d6;
+	--se-edit-anchor-on-back: #2f3b4a;
+	--se-edit-anchor-on-font: #ffffff;
+	--se-edit-hr-color: #777;
+	--se-edit-hr-on-back: #566070;
+
+	/* content interaction states */
+	--se-edit-active: #64c7da;
+	--se-edit-hover: #58c0d2;
+	--se-edit-outline: #424242;
 
 	/** --------------------------- layout - [colors] ----------- */
-	/** main, common */
+	/* main shell and typography */
 	--se-main-font-family: Helvetica Neue;
-	--se-main-out-color: #444;
-	--se-main-color: #ccc;
-	--se-main-color-lighter: #aaa;
-	--se-main-background-color: #0f1828;
-	--se-code-view-color: #030712;
-	--se-main-font-color: #ccc;
-	--se-code-view-background-color: #ddd;
-	--se-main-divider-color: #555;
-	--se-main-border-color: #666;
-	--se-main-outline-color: #444;
-	--se-main-shadow-color: #222;
-	--se-statusbar-font-color: #aaa;
-	--se-overlay-background-color: #111;
-
-	/* hover */
-	--se-hover-color: #0d200c;
-	--se-hover-dark-color: #8192a3;
-	--se-hover-dark2-color: #738495;
-	--se-hover-dark3-color: #667788;
-	--se-hover-light-color: #9ab0c5;
-	--se-hover-light2-color: #adc2d7;
-	--se-hover-light3-color: #c0d3e5;
-
-	/* active */
-	--se-active-color: #5cd2e6;
-	--se-active-hover-color: #6de9f5;
-	--se-active-dark-color: #3bb9cd;
-	--se-active-dark2-color: #2a9fb1;
-	--se-active-dark3-color: #5cd2e6;
-	--se-active-dark4-color: #3bb9cd;
-	--se-active-dark5-color: #197d91;
-	--se-active-light-color: #17303a;
-	--se-active-light2-color: #1e3f4d;
-	--se-active-light3-color: #255e6f;
-	--se-active-light4-color: #2c7d91;
-	--se-active-light5-color: #33aacc;
-	--se-active-light6-color: #3bd1f2;
-
-	/* [toolbar, menu, modal] layer - shadow */
-	--se-shadow-layer-color: rgba(0, 64, 128, 0.25);
-
-	/* drag */
-	--se-drag-over-color: #ffcc00;
-
-	/* modal, browser, dropdown */
-	--se-modal-background-color: #1c202a;
-	--se-modal-color: #ececec;
-	--se-modal-border-color: #555;
-	--se-modal-anchor-color: #77aaff;
-	--se-modal-preview-color: #aaa;
-	--se-modal-file-input-background-color: #232837;
-	--se-modal-input-disabled-color: #666;
+	--se-main-out-color: #2c2c2c;
+	--se-main-color: #e4e4e4;
+	--se-main-color-lighter: #cfcfcf;
+	--se-main-background-color: #212121;
+	--se-code-view-color: #111111;
+	--se-main-font-color: #e4e4e4;
+	--se-code-view-background-color: #dadada;
+	--se-main-divider-color: #333;
+	--se-main-border-color: #444;
+	--se-main-outline-color: #2c2c2c;
+	--se-main-shadow-color: #000;
+	--se-statusbar-font-color: #a1a1a1;
+	--se-overlay-background-color: rgba(0, 0, 0, 0.6);
+
+	/* hover states */
+	--se-hover-color: #2f3f44;
+	--se-hover-dark-color: #4b6b72;
+	--se-hover-dark2-color: #5a7c84;
+	--se-hover-dark3-color: #689099;
+	--se-hover-light-color: #7fb0bb;
+	--se-hover-light2-color: #8fc2cc;
+	--se-hover-light3-color: #a2d6df;
+
+	/* active foreground states */
+	--se-active-color: #64c7da;
+	--se-active-hover-color: #7ad9e8;
+	--se-active-dark-color: #46b4c8;
+	--se-active-dark2-color: #379daf;
+	--se-active-dark3-color: #64c7da;
+	--se-active-dark4-color: #46b4c8;
+	--se-active-dark5-color: #2a7f8f;
+
+	/* active background states */
+	--se-active-light-color: #26383d;
+	--se-active-light2-color: #2c4349;
+	--se-active-light3-color: #334f56;
+	--se-active-light4-color: #3b5c64;
+	--se-active-light5-color: #446b75;
+	--se-active-light6-color: #4f7d88;
+
+	/* floating layer shadow */
+	--se-shadow-layer-color: rgba(0, 0, 0, 0.38);
+
+	/* drag feedback */
+	--se-drag-over-color: #f0c34a;
+
+	/* modal, browser, dropdown surfaces */
+	--se-modal-background-color: #2b2b2b;
+	--se-modal-color: #f1f1f1;
+	--se-modal-border-color: #4a4a4a;
+	--se-modal-anchor-color: #95a5bc;
+	--se-modal-preview-color: #c2c2c2;
+	--se-modal-file-input-background-color: #1a1a1a;
+	--se-modal-input-disabled-color: #888;
 	--se-modal-input-disabled-background-color: #333;
 
-	/* dropdown, selectMenu */
-	--se-dropdown-font-color: #ccc;
-
-	/* controller */
-	--se-controller-border-color: #555;
-	--se-controller-background-color: #091025;
-	--se-controller-color: #ececec;
-	--se-shadow-controller-color: rgba(80, 200, 255, 0.2);
-
-	/* button : input-side */
-	--se-input-btn-border-color: #444;
-	--se-input-btn-disabled-color: #666;
-
-	/* success */
-	--se-success-color: #2cb67d;
-	--se-success-dark-color: #1f8f65;
-	--se-success-dark2-color: #186f4f;
-	--se-success-dark3-color: #125f44;
-	--se-success-light-color: #3dd9a5;
-	--se-success-light2-color: #57e2b7;
-	--se-success-light3-color: #8cf0ce;
-	--se-success-light4-color: #c1fae4;
-	--se-success-light5-color: #e9fef5;
-
-	/* error */
+	/* dropdown text */
+	--se-dropdown-font-color: #e4e4e4;
+
+	/* media/controller chrome */
+	--se-controller-border-color: #3a3a3a;
+	--se-controller-background-color: #212121;
+	--se-controller-color: #e4e4e4;
+	--se-shadow-controller-color: rgba(0, 0, 0, 0.45);
+
+	/* input-side button states */
+	--se-input-btn-border-color: #3a3a3a;
+	--se-input-btn-disabled-color: #777;
+
+	/* table picker */
+	--se-table-picker-color: #3a3a3a;
+	--se-table-picker-border-color: #555;
+	--se-table-picker-highlight-color: #304a5c;
+	--se-table-picker-highlight-border-color: #6589a0;
+
+	/* success status palette */
+	--se-success-color: #22c55e;
+	--se-success-dark-color: #16a34a;
+	--se-success-dark2-color: #15803d;
+	--se-success-dark3-color: #166534;
+	--se-success-light-color: #4ade80;
+	--se-success-light2-color: #86efac;
+	--se-success-light3-color: #c7f7e3;
+	--se-success-light4-color: #e9fdf5;
+	--se-success-light5-color: #f5fffb;
+
+	/* error status palette */
 	--se-error-color: #ef4444;
-	--se-error-dark-color: #991b1b;
-	--se-error-dark2-color: #7f1d1d;
-	--se-error-dark3-color: #651616;
+	--se-error-dark-color: #dc2626;
+	--se-error-dark2-color: #b91c1c;
+	--se-error-dark3-color: #991b1b;
 	--se-error-light-color: #f87171;
 	--se-error-light2-color: #fca5a5;
-	--se-error-light3-color: #fecaca;
-	--se-error-light4-color: #fee2e2;
-	--se-error-light5-color: #fef2f2;
-
-	/* document type */
-	--se-doc-background: #344153;
-	--se-doc-info-page-font-color: #0f1828;
-	--se-doc-info-page-background-color: #cfcfcf;
-	/* document type - font, active */
-	--se-doc-info-font-color: #cfcfcf;
-	--se-doc-info-active-color: #5599ff;
-
-	/* loading */
-	--se-loading-color: #77aaff;
-
-	/* show blocks */
-	--se-show-blocks-color: #5599ff;
-	--se-show-blocks-li-color: #d539ff;
-	--se-show-blocks-pre-color: #27c022;
-	--se-show-blocks-component-color: #f4b124;
+	--se-error-light3-color: #fee2e2;
+	--se-error-light4-color: #fef2f2;
+	--se-error-light5-color: #fff5f5;
+
+	/* document mode palette */
+	--se-doc-background: #2c2c2c;
+	--se-doc-info-page-font-color: #212121;
+	--se-doc-info-page-background-color: #d0d0d0;
+	--se-doc-info-font-color: #d0d0d0;
+	--se-doc-info-active-color: #7f90a8;
+
+	/* loading indicator */
+	--se-loading-color: #7f90a8;
+
+	/* show-blocks debug colors */
+	--se-show-blocks-color: #7f90a8;
+	--se-show-blocks-li-color: #c084fc;
+	--se-show-blocks-pre-color: #34d399;
+	--se-show-blocks-component-color: #f0c34a;
 }

package/src/typedef.js

@@ -2,26 +2,50 @@
  * @fileoverview Global Type Declarations for SunEditor Custom Types
  */
 
-// --------------------------------------------------------- [Node] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Array<Node>|HTMLCollection|NodeList} __se__NodeCollection
+ * @namespace SunEditor
  */
 
-// --------------------------------------------------------- [Editor] ---------------------------------------------------------------------------------------------------
+// ================================================================================================================================
+// === PUBLIC API TYPES (User-facing types for common use cases)
+// ================================================================================================================================
+
+// --------------------------------------------------------- [Editor Types] ---------------------------------------------------------------------------------------------------
+/**
+ * @typedef {import('./core/editor').default} SunEditor.Instance
+ * @typedef {import('./core/kernel/coreKernel').default} SunEditor.Kernel
+ * @typedef {import('./core/kernel/store').default} SunEditor.Store
+ * @typedef {import('./core/kernel/store').StoreState} SunEditor.StorePathMap
+ * @typedef {import('./core/kernel/coreKernel').Deps} SunEditor.Deps
+ */
+
+// --------------------------------------------------------- [Init Options] ---------------------------------------------------------------------------------------------------
+/**
+ * @typedef {import('./core/schema/options').EditorInitOptions} SunEditor.InitOptions
+ * @typedef {import('./core/schema/options').EditorFrameOptions} SunEditor.InitFrameOptions
+ */
+
+// --------------------------------------------------------- [Context & Options] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {import('./core/editor').default} __se__EditorCore
+ * @typedef {import('./core/config/contextProvider').ContextMap} SunEditor.Context
+ * @typedef {import('./core/config/optionProvider').BaseOptionsMap} SunEditor.Options
  */
 
+// --------------------------------------------------------- [{Frame} Context & Options] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {import('./editorInjector').default} __se__EditorInjector
+ * @typedef {import('./core/config/contextProvider').FrameContextMap} SunEditor.FrameContext
+ * @typedef {import('./core/config/optionProvider').FrameOptionsMap} SunEditor.FrameOptions
  */
 
 /**
- * @typedef {import('./editorInjector/_core').default} __se__CoreInjector
+ * @typedef {HTMLElement & Window} SunEditor.EventWysiwyg
+ * @typedef {HTMLElement & HTMLIFrameElement} SunEditor.WysiwygFrame
+ * @typedef {Window & typeof globalThis} SunEditor.GlobalWindow
  */
 
+// --------------------------------------------------------- [Component Types] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Object} __se__ComponentInfo
+ * @typedef {Object} SunEditor.ComponentInfo
  * @property {HTMLElement} target - The target element associated with the component.
  * @property {string} pluginName - The name of the plugin related to the component.
  * @property {Object<string, *>} options - Options related to the component.
@@ -35,96 +59,223 @@
  */
 
 /**
- * @typedef {Object} __se__EditorStatus
- * @property {boolean} hasFocus Boolean value of whether the editor has focus
- * @property {number} tabSize Indent size of tab (4)
- * @property {number} indentSize Indent size (25)px
- * @property {number} codeIndentSize Indent size of Code view mode (2)
- * @property {Array<string>} currentNodes  An element array of the current cursor's node structure
- * @property {Array<string>} currentNodesMap  An element name array of the current cursor's node structure
- * @property {boolean} onSelected Boolean value of whether component is selected
- * @property {number} rootKey Current root key
- * @property {Range} _range Current range object
- * @property {boolean} _onMousedown Mouse down event status
+ * @typedef {"auto"|"select"|"line"|"none"} SunEditor.ComponentInsertType
+ * @description Component insertion behavior for selection and cursor placement.
+ * - For inline components: places the cursor near the inserted component or selects it if no nearby range is available.
+ * - For block components: executes behavior based on `selectMode`:
+ *    - `auto`: Move cursor to the next line if possible, otherwise select the component.
+ *    - `select`: Always select the inserted component.
+ *    - `line`: Move cursor to the next line if possible, or create a new line and move there.
+ *    - `none`: Do nothing.
  */
 
-// --------------------------------------------------------- [Event] ---------------------------------------------------------------------------------------------------
+// --------------------------------------------------------- [DOM/Utility Types] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Object} __se__EventInfo
- * @property {*} target Target element
- * @property {string} type Event type
- * @property {(...args: *) => *} listener Event listener
- * @property {boolean|AddEventListenerOptions=} useCapture Event useCapture option
+ * @typedef {Array<Node>|HTMLCollection|NodeList} SunEditor.NodeCollection
  */
 
+// --------------------------------------------------------- [Module Types - Cross-module Public API] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Object} __se__GlobalEventInfo
- * @property {string} type Event type
- * @property {(...args: *) => *} listener Event listener
- * @property {boolean|AddEventListenerOptions=} useCapture Use event capture
+ * @typedef {import('./modules/contract/Controller').ControllerInfo} SunEditor.Module.Controller.Info
+ *
+ * @typedef {import('./modules/contract/Figure').FigureInfo} SunEditor.Module.Figure.Info
+ * @typedef {import('./modules/contract/Figure').FigureTargetInfo} SunEditor.Module.Figure.TargetInfo
+ * @typedef {import('./modules/contract/Figure').FigureControlButton} SunEditor.Module.Figure.ControlButton
+ * @typedef {import('./modules/contract/Figure').FigureControlResize} SunEditor.Module.Figure.ControlResize
+ * @typedef {import('./modules/contract/Figure').ControlCustomAction} SunEditor.Module.Figure.ControlCustomAction
+ * @typedef {import('./modules/contract/Figure').FigureControls} SunEditor.Module.Figure.Controls
+ *
+ * @typedef {import('./modules/contract/Browser').BrowserFile} SunEditor.Module.Browser.File
+ *
+ * @typedef {import('./modules/contract/HueSlider').HueSliderColor} SunEditor.Module.HueSlider.Color
  */
 
-// --------------------------------------------------------- [Plugin Event] ---------------------------------------------------------------------------------------------------
+// --------------------------------------------------------- [Plugin Hook Types] ---------------------------------------------------------------------------------------------------
+// Editor hooks - Called by Editor core
+// Event sync
 /**
- * @typedef {Object} __se__PluginMouseEventInfo
- * @property {__se__FrameContext} frameContext Frame context
- * @property {MouseEvent} event Event object
+ * @typedef {typeof import('./hooks/base').Event.Active} SunEditor.Hook.Event.Active
+ * @typedef {typeof import('./hooks/base').Event.OnFocus} SunEditor.Hook.Event.OnFocus
+ * @typedef {typeof import('./hooks/base').Event.OnBlur} SunEditor.Hook.Event.OnBlur
+ * @typedef {typeof import('./hooks/base').Event.OnMouseMove} SunEditor.Hook.Event.OnMouseMove
+ * @typedef {typeof import('./hooks/base').Event.OnScroll} SunEditor.Hook.Event.OnScroll
  */
 
+// Event sync/async
 /**
- * @typedef {Object} __se__PluginKeyEventInfo
- * @property {__se__FrameContext} frameContext Frame context
- * @property {KeyboardEvent} event Event object
- * @property {Range} range range object
- * @property {HTMLElement} line Current line element
+ * @typedef {typeof import('./hooks/base').Event.OnBeforeInput} SunEditor.Hook.Event.OnBeforeInput
+ * @typedef {typeof import('./hooks/base').Event.OnBeforeInputAsync} SunEditor.Hook.Event.OnBeforeInputAsync
+ * @typedef {typeof import('./hooks/base').Event.OnInput} SunEditor.Hook.Event.OnInput
+ * @typedef {typeof import('./hooks/base').Event.OnInputAsync} SunEditor.Hook.Event.OnInputAsync
+ * @typedef {typeof import('./hooks/base').Event.OnKeyDown} SunEditor.Hook.Event.OnKeyDown
+ * @typedef {typeof import('./hooks/base').Event.OnKeyDownAsync} SunEditor.Hook.Event.OnKeyDownAsync
+ * @typedef {typeof import('./hooks/base').Event.OnKeyUp} SunEditor.Hook.Event.OnKeyUp
+ * @typedef {typeof import('./hooks/base').Event.OnKeyUpAsync} SunEditor.Hook.Event.OnKeyUpAsync
+ * @typedef {typeof import('./hooks/base').Event.OnMouseDown} SunEditor.Hook.Event.OnMouseDown
+ * @typedef {typeof import('./hooks/base').Event.OnMouseDownAsync} SunEditor.Hook.Event.OnMouseDownAsync
+ * @typedef {typeof import('./hooks/base').Event.OnMouseUp} SunEditor.Hook.Event.OnMouseUp
+ * @typedef {typeof import('./hooks/base').Event.OnMouseUpAsync} SunEditor.Hook.Event.OnMouseUpAsync
+ * @typedef {typeof import('./hooks/base').Event.OnClick} SunEditor.Hook.Event.OnClick
+ * @typedef {typeof import('./hooks/base').Event.OnClickAsync} SunEditor.Hook.Event.OnClickAsync
+ * @typedef {typeof import('./hooks/base').Event.OnMouseLeave} SunEditor.Hook.Event.OnMouseLeave
+ * @typedef {typeof import('./hooks/base').Event.OnMouseLeaveAsync} SunEditor.Hook.Event.OnMouseLeaveAsync
+ * @typedef {typeof import('./hooks/base').Event.OnFilePasteAndDrop} SunEditor.Hook.Event.OnFilePasteAndDrop
+ * @typedef {typeof import('./hooks/base').Event.OnFilePasteAndDropAsync} SunEditor.Hook.Event.OnFilePasteAndDropAsync
+ * @typedef {typeof import('./hooks/base').Event.OnPaste} SunEditor.Hook.Event.OnPaste
+ * @typedef {typeof import('./hooks/base').Event.OnPasteAsync} SunEditor.Hook.Event.OnPasteAsync
  */
 
+// Core etc
 /**
- * @typedef {Object} __se__PluginToolbarInputChangeEventInfo
- * @property {HTMLElement} target Input element
- * @property {Event} event Event object
- * @property {string} value Input value
+ * @typedef {typeof import('./hooks/base').Core.RetainFormat} SunEditor.Hook.Core.RetainFormat
+ * @typedef {typeof import('./hooks/base').Core.Shortcut} SunEditor.Hook.Core.Shortcut
+ * @typedef {typeof import('./hooks/base').Core.SetDir} SunEditor.Hook.Core.SetDir
+ * @typedef {typeof import('./hooks/base').Core.Init} SunEditor.Hook.Core.Init
  */
 
+// component
 /**
- * @typedef {Object} __se__PluginShortcutInfo Information of the "shortcut" plugin
- * @property {Range} range - Range object
- * @property {HTMLElement} line - The line element of the current range
- * @property {import('./core/class/shortcuts').ShortcutInfo} info - Information of the shortcut
- * @property {KeyboardEvent} event - Key event object
- * @property {string} keyCode - KeyBoardEvent.code
- * @property {__se__EditorCore} editor - The root editor instance
+ * @typedef {typeof import('./interfaces/contracts').EditorComponent.prototype.componentSelect} SunEditor.Hook.Component.Select
+ * @typedef {typeof import('./interfaces/contracts').EditorComponent.prototype.componentDeselect} SunEditor.Hook.Component.Deselect
+ * @typedef {typeof import('./interfaces/contracts').EditorComponent.prototype.componentEdit} SunEditor.Hook.Component.Edit
+ * @typedef {typeof import('./interfaces/contracts').EditorComponent.prototype.componentDestroy} SunEditor.Hook.Component.Destroy
+ * @typedef {typeof import('./interfaces/contracts').EditorComponent.prototype.componentCopy} SunEditor.Hook.Component.Copy
  */
 
+// Module hooks - Called by Module instances (defined in interfaces/contracts.js)
 /**
- * @typedef {Object} __se__PluginPasteParams
- * @property {__se__FrameContext} frameContext Frame context
- * @property {ClipboardEvent} event Clipboard event object
- * @property {string} data Format cleaned paste data (HTML string)
- * @property {Document} doc DomParser data (new DOMParser().parseFromString(data, 'text/html');)
+ * @typedef {typeof import('./interfaces/contracts').ModuleModal.prototype.modalAction} SunEditor.Hook.Modal.Action
+ * @typedef {typeof import('./interfaces/contracts').ModuleModal.prototype.modalOn} SunEditor.Hook.Modal.On
+ * @typedef {typeof import('./interfaces/contracts').ModuleModal.prototype.modalInit} SunEditor.Hook.Modal.Init
+ * @typedef {typeof import('./interfaces/contracts').ModuleModal.prototype.modalOff} SunEditor.Hook.Modal.Off
+ * @typedef {typeof import('./interfaces/contracts').ModuleModal.prototype.modalResize} SunEditor.Hook.Modal.Resize
+ *
+ * @typedef {typeof import('./interfaces/contracts').ModuleController.prototype.controllerAction} SunEditor.Hook.Controller.Action
+ * @typedef {typeof import('./interfaces/contracts').ModuleController.prototype.controllerOn} SunEditor.Hook.Controller.On
+ * @typedef {typeof import('./interfaces/contracts').ModuleController.prototype.controllerClose} SunEditor.Hook.Controller.Close
+ *
+ * @typedef {typeof import('./interfaces/contracts').ModuleBrowser.prototype.browserInit} SunEditor.Hook.Browser.Init
+ *
+ * @typedef {typeof import('./interfaces/contracts').ModuleColorPicker.prototype.colorPickerAction} SunEditor.Hook.ColorPicker.Action
+ * @typedef {typeof import('./interfaces/contracts').ModuleColorPicker.prototype.colorPickerHueSliderOpen} SunEditor.Hook.ColorPicker.HueSliderOpen
+ * @typedef {typeof import('./interfaces/contracts').ModuleColorPicker.prototype.colorPickerHueSliderClose} SunEditor.Hook.ColorPicker.HueSliderClose
+ *
+ * @typedef {typeof import('./interfaces/contracts').ModuleHueSlider.prototype.hueSliderAction} SunEditor.Hook.HueSlider.Action
+ * @typedef {typeof import('./interfaces/contracts').ModuleHueSlider.prototype.hueSliderCancelAction} SunEditor.Hook.HueSlider.CancelAction
+ */
+
+// --------------------------------------------------------- [Plugin Hook parameter types] ---------------------------------------------------------------------------------------------------
+/**
+ * @typedef {import('./hooks/params').MouseEventInfo} SunEditor.HookParams.MouseEvent
+ * @typedef {import('./hooks/params').KeyEventInfo} SunEditor.HookParams.KeyEvent
+ * @typedef {import('./hooks/params').ShortcutInfo} SunEditor.HookParams.Shortcut
+ * @typedef {import('./hooks/params').FilePasteDrop} SunEditor.HookParams.FilePasteDrop
+ * @typedef {import('./hooks/params').FocusBlurEvent} SunEditor.HookParams.FocusBlur
+ * @typedef {import('./hooks/params').ScrollEvent} SunEditor.HookParams.Scroll
+ * @typedef {import('./hooks/params').InputEventWithData} SunEditor.HookParams.InputWithData
+ * @typedef {import('./hooks/params').Paste} SunEditor.HookParams.Paste
+ * @typedef {import('./hooks/params').Mouse} SunEditor.HookParams.Mouse
+ * @typedef {import('./hooks/params').Keyboard} SunEditor.HookParams.Keyboard
+ *
+ * @typedef {import('./hooks/params').ToolbarInputKeyDown} SunEditor.HookParams.ToolbarInputKeyDown
+ * @typedef {import('./hooks/params').ToolbarInputChange} SunEditor.HookParams.ToolbarInputChange
+ *
+ * @typedef {import('./hooks/params').CopyComponent} SunEditor.HookParams.CopyComponent
+ */
+
+//** ****************************************************************************************************************************************************************************************** */
+
+// ================================================================================================================================
+// === INTERNAL/ADVANCED TYPES (Framework internals and advanced use cases)
+// ================================================================================================================================
+
+// --------------------------------------------------------- [Event Types] ---------------------------------------------------------------------------------------------------
+/**
+ * EventManager event information
+ * @typedef {Object} SunEditor.Event.Info
+ * @property {*} target Target element
+ * @property {string} type Event type
+ * @property {EventListenerOrEventListenerObject} listener Event listener
+ * @property {boolean|AddEventListenerOptions} [useCapture] Event useCapture option
+ */
+
+/**
+ * EventManager global event information
+ * @typedef {Object} SunEditor.Event.GlobalInfo
+ * @property {string} type Event type
+ * @property {(...args: *) => *} listener Event listener
+ * @property {boolean|AddEventListenerOptions} [useCapture] Use event capture
  */
 
 /**
- * @typedef {Object} __se__PluginCopyComponentParams
- * @property {ClipboardEvent} event Clipboard event object
- * @property {HTMLElement} cloneContainer Cloned component container
- * @property {__se__ComponentInfo} info Component information
+ * EventHandlers object containing all event callback functions
+ * To access individual handler types, use indexed access:
+ * Use `SunEditor.Event.Handlers["onload"]` to get the `onload` callback type
+ * @typedef {import('./events').EventHandlers} SunEditor.Event.Handlers
  */
 
-// --------------------------------------------------------- [Context] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Map<string, *>} __se__FrameOptions
+ * EventParams - Event callback parameters
+ * @typedef {import('./events').BaseEvent} SunEditor.EventParams.BaseEvent
+ * @typedef {import('./events').ClipboardEvent} SunEditor.EventParams.ClipboardEvent
+ * @typedef {import('./events').FileManagementInfo} SunEditor.EventParams.FileManagementInfo
+ * @typedef {import('./events').ProcessInfo} SunEditor.EventParams.ProcessInfo
+ * @typedef {import('./events').ImageInfo} SunEditor.EventParams.ImageInfo
+ * @typedef {import('./events').VideoInfo} SunEditor.EventParams.VideoInfo
+ * @typedef {import('./events').AudioInfo} SunEditor.EventParams.AudioInfo
+ * @typedef {import('./events').FileInfo} SunEditor.EventParams.FileInfo
+ * @typedef {import('./events').EmbedInfo} SunEditor.EventParams.EmbedInfo
  */
 
 /**
- * @typedef {Map<string, *>} __se__FrameContext
+ * The event object passed to the plugin event handler
+ * @typedef {import('./core/logic/shell/pluginManager').PluginEventParam} SunEditor.EventParams.PluginEvent
  */
 
+// --------------------------------------------------------- [UI Types] ---------------------------------------------------------------------------------------------------
 /**
- * @typedef {Map<string, *>} __se__Context
+ * Special toolbar control strings
+ * - `"|"`: Vertical separator between buttons
+ * - `"/"`: Line break (start new row)
+ * - `":[title]-[icon]"`: More button with dropdown (e.g., `":More Button-default.more_vertical"`)
+ * - `"-left"|"-right"`: Float alignment for button groups
+ * - `"#fix"`: RTL direction fix
+ * - `"%100"|"%50"`: Responsive breakpoint (percentage)
+ *
+ * @example
+ * // Basic separators and layout
+ * [['bold', 'italic', '|', 'underline'],]  // Separator between buttons
+ * [['font', 'fontSize'], '/', ['align'],]  // Line break between rows
+ *
+ * // Float alignment
+ * [['-right', 'undo', 'redo'],]          // Float right side
+ *
+ * // More button (collapsible group)
+ * [[':Paragraph-More', 'fontSize', 'align'],]      // Dropdown with title
+ *
+ * // Responsive breakpoint
+ * ['%50', ['bold', 'italic'],]           // Show at 50% width breakpoint
+ *
+ * @typedef {"|"|"/"|`-${"left"|"right"|"center"}`|"#fix"|`:${string}-${string}`|`%${number}`} SunEditor.UI.ButtonSpecial
  */
 
-// --------------------------------------------------------- [core.class] ---------------------------------------------------------------------------------------------------
+// ========================================================= [ButtonList Generate] ===================================================================================================
 /**
- * @typedef {import('./core/class/offset').OffsetGlobalInfo} __se__Class_OffsetGlobalInfo
+ * === [ Button Types - Auto-generated ] ===
+ * ---[ Auto-generated by scripts/check/gen-button-types.cjs - DO NOT EDIT MANUALLY ]---
+ *
+ * Default command buttons available in the toolbar
+ * @typedef {"bold"|"underline"|"italic"|"strike"|"subscript"|"superscript"|"removeFormat"|"copyFormat"|"indent"|"outdent"|"fullScreen"|"showBlocks"|"codeView"|"undo"|"redo"|"preview"|"print"|"copy"|"dir"|"dir_ltr"|"dir_rtl"|"save"|"newDocument"|"selectAll"|"pageBreak"|"pageUp"|"pageDown"|"pageNavigator"} SunEditor.UI.ButtonCommand
+ *
+ * Plugin buttons available in the toolbar
+ * @typedef {"blockquote"|"exportPDF"|"fileUpload"|"list_bulleted"|"list_numbered"|"mention"|"align"|"font"|"fontColor"|"backgroundColor"|"list"|"table"|"blockStyle"|"hr"|"layout"|"lineHeight"|"template"|"paragraphStyle"|"textStyle"|"link"|"image"|"video"|"audio"|"embed"|"math"|"drawing"|"imageGallery"|"videoGallery"|"audioGallery"|"fileGallery"|"fileBrowser"|"fontSize"|"pageNavigator"|"anchor"} SunEditor.UI.ButtonPlugin
+ *
+ * Single button item in the toolbar (includes special controls and custom strings)
+ * @typedef {SunEditor.UI.ButtonCommand|SunEditor.UI.ButtonPlugin|SunEditor.UI.ButtonSpecial|string} SunEditor.UI.ButtonItem
+ *
+ * Button list configuration for the toolbar
+ * Supports nested arrays, special controls, and responsive breakpoint configurations
+ * @typedef {Array<SunEditor.UI.ButtonItem|SunEditor.UI.ButtonList|SunEditor.UI.ButtonSpecial>} SunEditor.UI.ButtonList
+ * ///
+ * ---[ End of auto-generated button types ]---
  */

package/types/assets/icons/defaultIcons.d.ts

@@ -41,6 +41,7 @@ declare namespace _default {
 	export let background_color: string;
 	export let list_bulleted: string;
 	export let list_numbered: string;
+	export let list_checked: string;
 	export let table: string;
 	export let table_header: string;
 	export let table_properties: string;
@@ -134,6 +135,13 @@ declare namespace _default {
 	export let side_menu_item: string;
 	export let side_menu_folder_plus: string;
 	export let alert_outline: string;
+	export let more_media: string;
+	export let more_gallery: string;
+	export let more_folder: string;
+	export let more_list: string;
+	export let more_file: string;
+	export let more_view: string;
+	export let more_page: string;
 	export let more_text: string;
 	export let more_paragraph: string;
 	export let more_plus: string;