suneditor 3.0.0-rc.5 → 3.0.0

package/types/core/schema/options.d.ts

@@ -193,8 +193,10 @@ export namespace DEFAULTS {
  * @property {{pluginName: string, we: boolean}|boolean} [__pluginRetainFilter=true] - Plugin retain filter configuration. (Internal use primarily)
  * - You can turn it off/on globally with `true`/`false` or set it per plugin.
  * ```js
- * // __pluginRetainFilter - disable filter for table plugin only
- * { __pluginRetainFilter: { table: false } }
+ * // disable filter for table plugin only
+ * {
+ *   __pluginRetainFilter: { table: false }
+ * }
  * ```
  */
 /**
@@ -223,7 +225,7 @@ export namespace DEFAULTS {
  *
  * === Modes & Themes ===
  * @property {boolean} [v2Migration=false] - Enables migration mode for SunEditor v2.
- * @property {"classic"|"inline"|"balloon"|"balloon-always"} [mode="classic"] - Toolbar mode: `classic`, `inline`, `balloon`, `balloon-always`.
+ * @property {"classic"|"inline"|"balloon"|"balloon-always"|"classic:bottom"|"inline:bottom"} [mode="classic"] - Toolbar mode: `classic`, `inline`, `balloon`, `balloon-always`. Append `:bottom` to place toolbar at the bottom (e.g. `classic:bottom`, `inline:bottom`).
  * @property {string} [type=""] - Editor type. Use `"document"` for a document-style layout, with optional sub-types after `:`.
  * ```js
  * // type
@@ -257,7 +259,16 @@ export namespace DEFAULTS {
  * - `styleFilter`: Filters disallowed inline styles (`spanStyles`/`lineStyles`/`allUsedStyles`)
  * ```js
  * // disable only attribute and style filters
- * { strictMode: { tagFilter: true, formatFilter: true, classFilter: true, textStyleTagFilter: true, attrFilter: false, styleFilter: false } }
+ * {
+ *   strictMode: {
+ *     tagFilter: true,
+ *     formatFilter: true,
+ *     classFilter: true,
+ *     textStyleTagFilter: true,
+ *     attrFilter: false,
+ *     styleFilter: false
+ *   }
+ * }
  * ```
  * @property {Array<string>} [scopeSelectionTags=CONSTANTS.SCOPE_SELECTION_TAGS] - Tags treated as whole units when selecting all content.
  * - The default follows {@link DEFAULTS.SCOPE_SELECTION_TAGS}
@@ -287,7 +298,13 @@ export namespace DEFAULTS {
  * @property {{[key: string]: string|undefined}} [attributeWhitelist=null] - Specifies additional attributes to allow for each tag. `"*"` applies to all tags.
  * - Rules specified here will be merged into {@link PrivateBaseOptions.__defaultAttributeWhitelist}.
  * ```js
- * { attributeWhitelist: { a: 'href|target', img: 'src|alt', '*': 'id|data-*' } }
+ * {
+ *   attributeWhitelist: {
+ *     a: 'href|target',
+ *     img: 'src|alt',
+ *     '*': 'id|data-*'
+ *   }
+ * }
  * ```
  * @property {{[key: string]: string|undefined}} [attributeBlacklist=null] - Specifies attributes to disallow by tag. `"*"` applies to all tags.
  * - Attributes specified here will eventually be removed even if they are allowed by other settings.
@@ -302,7 +319,14 @@ export namespace DEFAULTS {
  * - The default follows {@link PrivateBaseOptions.__textStyleTags}
  * @property {Object<string, string>} [convertTextTags={bold: "strong", underline: "u", italic: "em", strike: "del", subscript: "sub", superscript: "sup"}] - Maps text styles to specific HTML tags.
  * ```js
- * { convertTextTags: { bold: 'b', italic: 'i', underline: 'u', strike: 's' } }
+ * {
+ *   convertTextTags: {
+ *     bold: 'b',
+ *     italic: 'i',
+ *     underline: 'u',
+ *     strike: 's'
+ *   }
+ * }
  * ```
  * @property {string} [allUsedStyles] - Specifies additional styles to the list of allowed styles. Delimiter: `"|"`.
  * ```js
@@ -310,7 +334,12 @@ export namespace DEFAULTS {
  * ```
  * @property {Object<string, string>} [tagStyles={}] - Specifies allowed styles for HTML tags. Key is tag name(s), value is pipe-delimited allowed styles.
  * ```js
- * { tagStyles: { 'table|td': 'border|color|background-color', hr: 'border-top' } }
+ * {
+ *   tagStyles: {
+ *     'table|td': 'border|color|background-color',
+ *     hr: 'border-top'
+ *   }
+ * }
  * ```
  * @property {string} [spanStyles=CONSTANTS.SPAN_STYLES] - Specifies allowed styles for the `span` tag.
  * - The default follows {@link DEFAULTS.SPAN_STYLES}
@@ -390,11 +419,16 @@ export namespace DEFAULTS {
  * @property {boolean} [shortcutsHint=true] - Displays shortcut hints in tooltips.
  * @property {boolean} [shortcutsDisable=false] - Disables keyboard shortcuts.
  * @property {{[key: string]: Array<string>|undefined}} [shortcuts={}] - Custom keyboard shortcuts.
- * Keys starting with `_` are user-defined custom shortcuts. Each value is an array of `[keyCombo, hintLabel]` pairs.
- * Key combos use `c` (Ctrl/Cmd), `s` (Shift), and `KeyEvent.code` values joined by `+`.
- * Use `$~pluginName.method` to call a specific plugin method.
+ * - Keys starting with `_` are user-defined custom shortcuts. Each value is an array of `[keyCombo, hintLabel]` pairs.
+ * - Key combos use `c` (Ctrl/Cmd), `s` (Shift), and `KeyEvent.code` values joined by `+`.
+ * - Use `$~pluginName.method` to call a specific plugin method.
  * ```js
- * { shortcuts: { bold: ['c+KeyB', 'B'], _h1: ['c+s+Digit1+$~blockStyle.applyHeaderByShortcut', ''] } }
+ * {
+ *   shortcuts: {
+ *     bold: ['c+KeyB', 'B'],
+ *     _h1: ['c+s+Digit1+$~blockStyle.applyHeaderByShortcut', '']
+ *   }
+ * }
  * ```
  * ///
  *
@@ -404,6 +438,7 @@ export namespace DEFAULTS {
  * - Default: `Boolean(plugins.link)` — determined by whether the `link` plugin is enabled.
  * @property {Array<string>} [autoStyleify=["bold", "underline", "italic", "strike"]] - Styles applied automatically on text input.
  * @property {number} [historyStackDelayTime=400] - Delay time for history stack updates (ms).
+ * @property {number} [historyStackSize=100] - Maximum number of history entries per root frame. Oldest entries are discarded when exceeded.
  * @property {string} [printClass=""] - Class name for printing.
  * @property {number} [fullScreenOffset=0] - Offset applied when entering fullscreen mode.
  * @property {?string} [previewTemplate=null] - Custom HTML template for preview mode. Use `{{ contents }}` as a placeholder for editor content.
@@ -421,24 +456,45 @@ export namespace DEFAULTS {
  * @property {?string} [defaultUrlProtocol=null] - Default URL protocol for links.
  * @property {Object<"copy", number>} [toastMessageTime={copy: 1500}] - Duration for displaying toast messages (ms).
  * @property {boolean} [freeCodeViewMode=false] - Enables free code view mode.
+ * @property {boolean} [finder_panel=true] - Shows the built-in Find/Replace panel UI.
+ * - The finder is always created internally; this option controls whether the panel is visible to users (Ctrl+F / Ctrl+H).
+ * @property {boolean} [finder_liveSearch=true] - Searches instantly as you type (debounced). When false, search runs only on Enter.
+ *
+ * ///
  *
  * === Dynamic Options ===
  * @property {Object<string, *>} [externalLibs] - External libraries like CodeMirror, KaTeX, or MathJax.
  * - See {@link https://github.com/ARA-developer/suneditor/blob/develop/guide/external-libraries.md External Libraries Guide}
  * ```js
- * { externalLibs: { katex: window.katex, codeMirror: { src: CodeMirror } } }
+ * {
+ *   externalLibs: {
+ *     katex: window.katex,
+ *     codeMirror: { src: CodeMirror }
+ *   }
+ * }
  * ```
  * @property {Object<string, boolean>} [allowedExtraTags=CONSTANTS.EXTRA_TAG_MAP] - Specifies extra allowed or disallowed tags. `true` to allow, `false` to disallow.
  * - The default follows {@link DEFAULTS.EXTRA_TAG_MAP}
  * ```js
- * { allowedExtraTags: { script: false, style: false, mark: true } }
+ * {
+ *   allowedExtraTags: {
+ *     script: false,
+ *     style: false,
+ *     mark: true
+ *   }
+ * }
  * ```
  * ///
  *
  * === User Events ===
  * @property {SunEditor.Event.Handlers} [events] - User event handlers configuration.
  * ```js
- * { events: { onChange: (content) => console.log(content), onImageUploadBefore: (files, info) => true } }
+ * {
+ *   events: {
+ *     onChange: (content) => console.log(content),
+ *     onImageUploadBefore: (files, info) => true
+ *   }
+ * }
  * ```
  * ///
  *
@@ -449,6 +505,7 @@ export namespace DEFAULTS {
  * @property {import('../../plugins/browser/audioGallery.js').AudioGalleryPluginOptions} [audioGallery]
  * @property {import('../../plugins/dropdown/backgroundColor.js').BackgroundColorPluginOptions} [backgroundColor]
  * @property {import('../../plugins/dropdown/blockStyle.js').BlockStylePluginOptions} [blockStyle]
+ * @property {import('../../plugins/command/codeBlock.js').CodeBlockPluginOptions} [codeBlock]
  * @property {import('../../plugins/modal/drawing.js').DrawingPluginOptions} [drawing]
  * @property {import('../../plugins/modal/embed.js').EmbedPluginOptions} [embed]
  * @property {import('../../plugins/command/exportPDF.js').ExportPDFPluginOptions} [exportPDF]
@@ -507,7 +564,6 @@ export namespace DEFAULTS {
  * @property {*} [codeMirror] - CodeMirror configuration object from `externalLibs.codeMirror`.
  * @property {boolean} [codeMirrorEditor] - Whether CodeMirror is available (base-level flag). Frame-level stores the actual CM instance.
  * @property {boolean} [hasCodeMirror] - Uses CodeMirror for code view.
- *
  * @property {Set<string>} [allUsedStyles] - Processed set of all allowed CSS styles.
  * - Converted from user's `string` input ("|" delimited) to `Set<string>` in constructor.
  */
@@ -789,8 +845,10 @@ export type PrivateBaseOptions = {
 	 * - Plugin retain filter configuration. (Internal use primarily)
 	 * - You can turn it off/on globally with `true`/`false` or set it per plugin.
 	 * ```js
-	 * // __pluginRetainFilter - disable filter for table plugin only
-	 * { __pluginRetainFilter: { table: false } }
+	 * // disable filter for table plugin only
+	 * {
+	 * __pluginRetainFilter: { table: false }
+	 * }
 	 * ```
 	 */
 	__pluginRetainFilter?:
@@ -843,9 +901,9 @@ export type EditorBaseOptions = {
 	 */
 	v2Migration?: boolean;
 	/**
-	 * - Toolbar mode: `classic`, `inline`, `balloon`, `balloon-always`.
+	 * - Toolbar mode: `classic`, `inline`, `balloon`, `balloon-always`. Append `:bottom` to place toolbar at the bottom (e.g. `classic:bottom`, `inline:bottom`).
 	 */
-	mode?: 'classic' | 'inline' | 'balloon' | 'balloon-always';
+	mode?: 'classic' | 'inline' | 'balloon' | 'balloon-always' | 'classic:bottom' | 'inline:bottom';
 	/**
 	 * - Editor type. Use `"document"` for a document-style layout, with optional sub-types after `:`.
 	 * ```js
@@ -895,7 +953,16 @@ export type EditorBaseOptions = {
 	 * - `styleFilter`: Filters disallowed inline styles (`spanStyles`/`lineStyles`/`allUsedStyles`)
 	 * ```js
 	 * // disable only attribute and style filters
-	 * { strictMode: { tagFilter: true, formatFilter: true, classFilter: true, textStyleTagFilter: true, attrFilter: false, styleFilter: false } }
+	 * {
+	 * strictMode: {
+	 * tagFilter: true,
+	 * formatFilter: true,
+	 * classFilter: true,
+	 * textStyleTagFilter: true,
+	 * attrFilter: false,
+	 * styleFilter: false
+	 * }
+	 * }
 	 * ```
 	 */
 	strictMode?:
@@ -949,7 +1016,13 @@ export type EditorBaseOptions = {
 	 * - Specifies additional attributes to allow for each tag. `"*"` applies to all tags.
 	 * - Rules specified here will be merged into {@link PrivateBaseOptions.__defaultAttributeWhitelist}.
 	 * ```js
-	 * { attributeWhitelist: { a: 'href|target', img: 'src|alt', '*': 'id|data-*' } }
+	 * {
+	 * attributeWhitelist: {
+	 * a: 'href|target',
+	 * img: 'src|alt',
+	 * '*': 'id|data-*'
+	 * }
+	 * }
 	 * ```
 	 */
 	attributeWhitelist?: {
@@ -977,7 +1050,14 @@ export type EditorBaseOptions = {
 	/**
 	 * - Maps text styles to specific HTML tags.
 	 * ```js
-	 * { convertTextTags: { bold: 'b', italic: 'i', underline: 'u', strike: 's' } }
+	 * {
+	 * convertTextTags: {
+	 * bold: 'b',
+	 * italic: 'i',
+	 * underline: 'u',
+	 * strike: 's'
+	 * }
+	 * }
 	 * ```
 	 */
 	convertTextTags?: {
@@ -993,7 +1073,12 @@ export type EditorBaseOptions = {
 	/**
 	 * - Specifies allowed styles for HTML tags. Key is tag name(s), value is pipe-delimited allowed styles.
 	 * ```js
-	 * { tagStyles: { 'table|td': 'border|color|background-color', hr: 'border-top' } }
+	 * {
+	 * tagStyles: {
+	 * 'table|td': 'border|color|background-color',
+	 * hr: 'border-top'
+	 * }
+	 * }
 	 * ```
 	 */
 	tagStyles?: {
@@ -1145,11 +1230,16 @@ export type EditorBaseOptions = {
 	shortcutsDisable?: boolean;
 	/**
 	 * - Custom keyboard shortcuts.
-	 * Keys starting with `_` are user-defined custom shortcuts. Each value is an array of `[keyCombo, hintLabel]` pairs.
-	 * Key combos use `c` (Ctrl/Cmd), `s` (Shift), and `KeyEvent.code` values joined by `+`.
-	 * Use `$~pluginName.method` to call a specific plugin method.
+	 * - Keys starting with `_` are user-defined custom shortcuts. Each value is an array of `[keyCombo, hintLabel]` pairs.
+	 * - Key combos use `c` (Ctrl/Cmd), `s` (Shift), and `KeyEvent.code` values joined by `+`.
+	 * - Use `$~pluginName.method` to call a specific plugin method.
 	 * ```js
-	 * { shortcuts: { bold: ['c+KeyB', 'B'], _h1: ['c+s+Digit1+$~blockStyle.applyHeaderByShortcut', ''] } }
+	 * {
+	 * shortcuts: {
+	 * bold: ['c+KeyB', 'B'],
+	 * _h1: ['c+s+Digit1+$~blockStyle.applyHeaderByShortcut', '']
+	 * }
+	 * }
 	 * ```
 	 * ///
 	 *
@@ -1175,6 +1265,10 @@ export type EditorBaseOptions = {
 	 * - Delay time for history stack updates (ms).
 	 */
 	historyStackDelayTime?: number;
+	/**
+	 * - Maximum number of history entries per root frame. Oldest entries are discarded when exceeded.
+	 */
+	historyStackSize?: number;
 	/**
 	 * - Class name for printing.
 	 */
@@ -1214,14 +1308,30 @@ export type EditorBaseOptions = {
 	toastMessageTime?: any;
 	/**
 	 * - Enables free code view mode.
+	 */
+	freeCodeViewMode?: boolean;
+	/**
+	 * - Shows the built-in Find/Replace panel UI.
+	 * - The finder is always created internally; this option controls whether the panel is visible to users (Ctrl+F / Ctrl+H).
+	 */
+	finder_panel?: boolean;
+	/**
+	 * - Searches instantly as you type (debounced). When false, search runs only on Enter.
+	 *
+	 * ///
 	 *
 	 * === Dynamic Options ===
 	 */
-	freeCodeViewMode?: boolean;
+	finder_liveSearch?: boolean;
 	/**
 	 * - External libraries like CodeMirror, KaTeX, or MathJax.
 	 * - See {@link https://github.com/ARA-developer/suneditor/blob/develop/guide/external-libraries.md External Libraries Guide}```js
-	 * { externalLibs: { katex: window.katex, codeMirror: { src: CodeMirror } } }
+	 * {
+	 * externalLibs: {
+	 * katex: window.katex,
+	 * codeMirror: { src: CodeMirror }
+	 * }
+	 * }
 	 * ```
 	 */
 	externalLibs?: {
@@ -1230,7 +1340,13 @@ export type EditorBaseOptions = {
 	/**
 	 * - Specifies extra allowed or disallowed tags. `true` to allow, `false` to disallow.
 	 * - The default follows {@link DEFAULTS.EXTRA_TAG_MAP}```js
-	 * { allowedExtraTags: { script: false, style: false, mark: true } }
+	 * {
+	 * allowedExtraTags: {
+	 * script: false,
+	 * style: false,
+	 * mark: true
+	 * }
+	 * }
 	 * ```
 	 * ///
 	 *
@@ -1242,7 +1358,12 @@ export type EditorBaseOptions = {
 	/**
 	 * - User event handlers configuration.
 	 * ```js
-	 * { events: { onChange: (content) => console.log(content), onImageUploadBefore: (files, info) => true } }
+	 * {
+	 * events: {
+	 * onChange: (content) => console.log(content),
+	 * onImageUploadBefore: (files, info) => true
+	 * }
+	 * }
 	 * ```
 	 * ///
 	 *
@@ -1255,6 +1376,7 @@ export type EditorBaseOptions = {
 	audioGallery?: import('../../plugins/browser/audioGallery.js').AudioGalleryPluginOptions;
 	backgroundColor?: import('../../plugins/dropdown/backgroundColor.js').BackgroundColorPluginOptions;
 	blockStyle?: import('../../plugins/dropdown/blockStyle.js').BlockStylePluginOptions;
+	codeBlock?: import('../../plugins/command/codeBlock.js').CodeBlockPluginOptions;
 	drawing?: import('../../plugins/modal/drawing.js').DrawingPluginOptions;
 	embed?: import('../../plugins/modal/embed.js').EmbedPluginOptions;
 	exportPDF?: import('../../plugins/command/exportPDF.js').ExportPDFPluginOptions;

package/types/events.d.ts

@@ -239,6 +239,7 @@ export type EventHandlers = {
 	onShowController?: typeof onShowController | null;
 	onBeforeShowController?: typeof onBeforeShowController | null;
 	onToggleCodeView?: typeof onToggleCodeView | null;
+	onToggleMarkdownView?: typeof onToggleMarkdownView | null;
 	onToggleFullScreen?: typeof onToggleFullScreen | null;
 	onResizeEditor?: typeof onResizeEditor | null;
 	onSetToolbarButtons?: typeof onSetToolbarButtons | null;
@@ -554,6 +555,16 @@ declare function onBeforeShowController(params: { $: SunEditor.Deps; frameContex
  * @param {boolean} params.is - code view status
  */
 declare function onToggleCodeView(params: { $: SunEditor.Deps; frameContext: SunEditor.FrameContext; is: boolean }): void;
+/**
+ * @callback
+ * @description Fired when the editor switches between WYSIWYG view and markdown view.
+ * The `is` parameter indicates whether markdown view is now active (`true`) or WYSIWYG view is active (`false`).
+ * @param {Object} params
+ * @param {SunEditor.Deps} params.$ - Kernel dependencies
+ * @param {SunEditor.FrameContext} params.frameContext - frame context
+ * @param {boolean} params.is - markdown view status
+ */
+declare function onToggleMarkdownView(params: { $: SunEditor.Deps; frameContext: SunEditor.FrameContext; is: boolean }): void;
 /**
  * @callback
  * @description Fired when the editor enters or exits fullscreen mode.

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

@@ -176,9 +176,9 @@ export function removeClass(element: Node | SunEditor.NodeCollection, className:
  * @description Argument value If there is no class name, insert it and delete the class name if it exists
  * @param {Node} element Element to replace class name
  * @param {string} className Class name to be change
- * @returns {boolean|undefined}
+ * @param {boolean} [force] If true, adds the class; if false, removes it.
  */
-export function toggleClass(element: Node, className: string): boolean | undefined;
+export function toggleClass(element: Node, className: string, force?: boolean): void;
 /**
  * @description Flash the class name of the argument value element for a certain time
  * @param {Node} element Element to flash class name

package/types/helper/index.d.ts

@@ -170,6 +170,10 @@ export const keyCodeMap: {
 export const clipboard: {
 	write: typeof import('./clipboard').write;
 };
+export const markdown: {
+	jsonToMarkdown: typeof import('./markdown').jsonToMarkdown;
+	markdownToHtml: typeof import('./markdown').markdownToHtml;
+};
 declare namespace _default {
 	export { env };
 	export { unicode };
@@ -178,5 +182,6 @@ declare namespace _default {
 	export { numbers };
 	export { keyCodeMap };
 	export { clipboard };
+	export { markdown };
 }
 export default _default;

package/types/helper/markdown.d.ts

@@ -0,0 +1,27 @@
+import type {} from '../typedef';
+/**
+ * @description Converts a JSON tree (from htmlToJson) to a Markdown string.
+ * @param {Object} jsonNode JSON node from htmlToJson
+ * @returns {string} Markdown string
+ * @example
+ * const json = htmlToJson('<p><strong>Hello</strong> World</p>');
+ * const md = jsonToMarkdown(json);
+ * // '**Hello** World\n\n'
+ */
+export function jsonToMarkdown(jsonNode: any): string;
+/**
+ * @description Parses a Markdown string into an HTML string.
+ * - HTML tags in the markdown are passed through as-is (for fallback elements).
+ * @param {string} md Markdown string
+ * @param {string} [defaultLine='p'] Default block element tag
+ * @returns {string} HTML string
+ * @example
+ * markdownToHtml('# Hello\n\n**bold** text');
+ * // '<h1>Hello</h1><p><strong>bold</strong> text</p>'
+ */
+export function markdownToHtml(md: string, defaultLine?: string): string;
+export default markdown;
+declare namespace markdown {
+	export { jsonToMarkdown };
+	export { markdownToHtml };
+}

package/types/langs/_Lang.d.ts

@@ -110,6 +110,7 @@ export type _Lang = {
 	link_modal_url: string;
 	link_modal_relAttribute: string;
 	list: string;
+	markdownView: string;
 	math: string;
 	math_modal_fontSizeLabel: string;
 	math_modal_inputLabel: string;
@@ -171,6 +172,7 @@ export type _Lang = {
 	tableProperties: string;
 	tags: string;
 	tag_blockquote: string;
+	codeBlock: string;
 	tag_div: string;
 	tag_h: string;
 	tag_p: string;
@@ -189,6 +191,13 @@ export type _Lang = {
 	video_modal_title: string;
 	video_modal_url: string;
 	width: string;
+	codeLanguage: string;
+	codeLanguage_none: string;
+	finder_matchCase: string;
+	finder_wholeWord: string;
+	finder_regex: string;
+	finder_prev: string;
+	finder_next: string;
 	message_copy_success: string;
 	message_copy_fail: string;
 };

package/types/modules/contract/Controller.d.ts

@@ -150,9 +150,13 @@ declare class Controller {
 	 * @param {Node} [positionTarget] Position target element
 	 * @param {Object} [params={}] params
 	 * @param {boolean} [params.isWWTarget] If the controller is in the WYSIWYG area, set it to `true`.
+	 * @param {boolean} [params.passive] If `true`, opens the controller visually without affecting editor state
+	 * - (`_preventBlur`, `controlActive`, `onControllerContext`, `opendControllers`).
+	 * - Used for lightweight, non-intrusive display such as hover-triggered UI (e.g., codeLang selector on `<pre>` hover).
+	 * - Automatically set to `true` when opened during component hover selection (`ON_OVER_COMPONENT`).
 	 * @param {() => void} [params.initMethod] Method to be called when the controller is closed.
 	 * @param {boolean} [params.disabled] If `true`, When the `controller` is opened, buttons without the `se-component-enabled` class are disabled. (default: `this.disabled`)
-	 * @param {{left?: number, top?: number}} [params.addOffset] Additional offset values
+	 * @param {{left?: number, right?:number, top?: number}} [params.addOffset] Additional offset values
 	 * @example
 	 * // Open controller on a target element with default options
 	 * this.controller.open(target);
@@ -168,15 +172,18 @@ declare class Controller {
 		positionTarget?: Node,
 		{
 			isWWTarget,
+			passive,
 			initMethod,
 			disabled,
 			addOffset,
 		}?: {
 			isWWTarget?: boolean;
+			passive?: boolean;
 			initMethod?: () => void;
 			disabled?: boolean;
 			addOffset?: {
 				left?: number;
+				right?: number;
 				top?: number;
 			};
 		},

package/types/modules/ui/SelectMenu.d.ts

@@ -30,6 +30,14 @@ export type SelectMenuParams = {
 	 * Optional method to call when the menu is closed
 	 */
 	closeMethod?: () => void;
+	/**
+	 * Optional max-height CSS value (e.g. `"200px"`). Enables scrolling when items exceed this height.
+	 */
+	maxHeight?: string;
+	/**
+	 * Optional min-width CSS value (e.g. `"130px"`).
+	 */
+	minWidth?: string;
 };
 /**
  * @typedef {Object} SelectMenuParams
@@ -44,6 +52,8 @@ export type SelectMenuParams = {
  * @property {number} [splitNum=0] Optional split number for horizontal positioning; defines how many items per row
  * @property {() => void} [openMethod] Optional method to call when the menu is opened
  * @property {() => void} [closeMethod] Optional method to call when the menu is closed
+ * @property {string} [maxHeight] Optional max-height CSS value (e.g. `"200px"`). Enables scrolling when items exceed this height.
+ * @property {string} [minWidth] Optional min-width CSS value (e.g. `"130px"`).
  */
 /**
  * @class
@@ -71,6 +81,8 @@ declare class SelectMenu {
 	horizontal: boolean;
 	openMethod: () => void;
 	closeMethod: () => void;
+	maxHeight: string;
+	minWidth: string;
 	/**
 	 * @description Creates the select menu items.
 	 * @param {Array<string>|SunEditor.NodeCollection} items - Command list of selectable items.

package/types/plugins/command/codeBlock.d.ts

@@ -0,0 +1,53 @@
+import type {} from '../../typedef';
+export default CodeBlock;
+export type CodeBlockPluginOptions = {
+	/**
+	 * - List of selectable programming languages for code blocks.
+	 * - Defaults to 21 common languages
+	 * - [javascript, typescript, html, css, json, python, java, c, cpp, csharp, go, rust, ruby, php, swift, kotlin, sql, bash, markdown, xml, yaml].
+	 * - Set to empty array `[]` to disable language selection UI entirely.
+	 * ```js
+	 * { codeBlock: { langs: ['javascript', 'python', 'html', 'css'] } }
+	 * ```
+	 */
+	langs?: Array<string>;
+};
+/**
+ * @typedef {Object} CodeBlockPluginOptions
+ * @property {Array<string>} [langs] - List of selectable programming languages for code blocks.
+ * - Defaults to 21 common languages
+ * - [javascript, typescript, html, css, json, python, java, c, cpp, csharp, go, rust, ruby, php, swift, kotlin, sql, bash, markdown, xml, yaml].
+ * - Set to empty array `[]` to disable language selection UI entirely.
+ * ```js
+ * { codeBlock: { langs: ['javascript', 'python', 'html', 'css'] } }
+ * ```
+ */
+/**
+ * @class
+ * @implements {PluginDropdown}
+ * @description Code block plugin — toggles `<pre>` formatting with language selection.
+ * - Toolbar: command button (toggle `<pre>`) + optional dropdown (language list)
+ * - Hover UI: shows language selector on `<pre>` hover (Controller + SelectMenu)
+ * - I/O conversion: `<pre class="language-xxx">` ↔ `<pre><code class="language-xxx">`
+ */
+declare class CodeBlock extends PluginCommand implements PluginDropdown {
+	/**
+	 * @constructor
+	 * @param {SunEditor.Kernel} kernel - The Kernel instance
+	 * @param {CodeBlockPluginOptions} pluginOptions - Configuration options for the CodeBlock plugin.
+	 */
+	constructor(kernel: SunEditor.Kernel, pluginOptions: CodeBlockPluginOptions);
+	title: any;
+	onMouseMove(params: SunEditor.HookParams.MouseEvent): void;
+	active(element: HTMLElement | null, target: HTMLElement | null): boolean | void;
+	on(target?: HTMLElement): void;
+	/** @hook Module.Controller */
+	controllerClose(): void;
+	/**
+	 * @description Cleans up resources.
+	 */
+	destroy(): void;
+	#private;
+}
+import { PluginDropdown } from '../../interfaces';
+import { PluginCommand } from '../../interfaces';

package/types/plugins/index.d.ts

@@ -1,6 +1,7 @@
 import type {} from '../typedef';
 declare namespace _default {
 	export { blockquote };
+	export { codeBlock };
 	export { exportPDF };
 	export { fileUpload };
 	export { list_bulleted };
@@ -42,6 +43,7 @@ import fileGallery from './browser/fileGallery';
 import imageGallery from './browser/imageGallery';
 import videoGallery from './browser/videoGallery';
 import blockquote from './command/blockquote';
+import codeBlock from './command/codeBlock';
 import exportPDF from './command/exportPDF';
 import fileUpload from './command/fileUpload';
 import list_bulleted from './command/list_bulleted';
@@ -78,6 +80,7 @@ export {
 	backgroundColor,
 	blockquote,
 	blockStyle,
+	codeBlock,
 	drawing,
 	embed,
 	exportPDF,

package/types/plugins/input/fontSize.d.ts

@@ -13,10 +13,12 @@ export type FontSizePluginOptions = {
 	showDefaultSizeLabel?: boolean;
 	/**
 	 * - When `true`, displays increase and decrease buttons for font size adjustments.
+	 * - Defaults to `false`. Always `false` when `sizeUnit` is `'text'` (ignored).
 	 */
 	showIncDecControls?: boolean;
 	/**
 	 * - When `true`, disables the direct font size input box.
+	 * - Defaults to `true` when `sizeUnit` is `'text'`, otherwise `false`.
 	 */
 	disableInput?: boolean;
 	/**
@@ -43,8 +45,10 @@ export type FontSizePluginOptions = {
  * - Accepted values include: `'px'`, `'pt'`, `'em'`, `'rem'`, `'vw'`, `'vh'`, `'%'` or `'text'`.
  * - If `'text'` is used, a text-based font size list is applied.
  * @property {boolean} [showDefaultSizeLabel=true] - Determines whether the default size label is displayed in the dropdown menu.
- * @property {boolean} [showIncDecControls=false] - When `true`, displays increase and decrease buttons for font size adjustments.
- * @property {boolean} [disableInput=true] - When `true`, disables the direct font size input box.
+ * @property {boolean} [showIncDecControls] - When `true`, displays increase and decrease buttons for font size adjustments.
+ * - Defaults to `false`. Always `false` when `sizeUnit` is `'text'` (ignored).
+ * @property {boolean} [disableInput] - When `true`, disables the direct font size input box.
+ * - Defaults to `true` when `sizeUnit` is `'text'`, otherwise `false`.
  * @property {Object<string, {default: number, inc: number, min: number, max: number, list: Array<number>}>} [unitMap={}] - Override or extend the default unit mapping for font sizes.
  * Each key is a unit name (e.g., `'px'`, `'em'`). `default`: initial size, `inc`: step for inc/dec buttons, `min`/`max`: range limits, `list`: dropdown values.
  * When `sizeUnit` is `'text'`, list items use `{title: string, size: string}` instead of numbers.

package/types/plugins/modal/audio.d.ts

@@ -14,7 +14,8 @@ export type AudioPluginOptions = {
 	 */
 	createFileInput?: boolean;
 	/**
-	 * - Whether to create a URL input element (default is `true` if file input is not created).
+	 * - Whether to create a URL input element.
+	 * - Defaults to `true`. Always `true` when `createFileInput` is `false`.
 	 */
 	createUrlInput?: boolean;
 	/**
@@ -67,7 +68,8 @@ export type AudioPluginOptions = {
  * @property {string} [defaultWidth="300px"] - The default width of the `AUDIO` tag.
  * @property {string} [defaultHeight="150px"] - The default height of the `AUDIO` tag.
  * @property {boolean} [createFileInput] - Whether to create a file input element.
- * @property {boolean} [createUrlInput] - Whether to create a URL input element (default is `true` if file input is not created).
+ * @property {boolean} [createUrlInput] - Whether to create a URL input element.
+ * - Defaults to `true`. Always `true` when `createFileInput` is `false`.
  * @property {string} [uploadUrl] - The URL to which files will be uploaded.
  * @property {Object<string, string>} [uploadHeaders] - Headers to include in the file upload request.
  * @property {number} [uploadSizeLimit] - The total upload size limit in bytes.