suneditor 3.1.3 → 3.2.0

package/types/core/config/eventManager.d.ts

@@ -10,7 +10,11 @@ declare class EventManager {
 	 * @param {import('./optionProvider').default} optionProvider
 	 * @param {import('../kernel/coreKernel').Deps} $
 	 */
-	constructor(contextProvider: import('./contextProvider').default, optionProvider: import('./optionProvider').default, $: import('../kernel/coreKernel').Deps);
+	constructor(
+		contextProvider: import('./contextProvider').default,
+		optionProvider: import('./optionProvider').default,
+		$: import('../kernel/coreKernel').Deps,
+	);
 	/**
 	 * @description Events object, call by triggerEvent function
 	 * @type {SunEditor.Event.Handlers}
@@ -21,6 +25,22 @@ declare class EventManager {
 	 * @type {(eventName: string, ...args: *) => Promise<*>}
 	 */
 	triggerEvent: (eventName: string, ...args: any) => Promise<any>;
+	/**
+	 * @internal
+	 * @description Bind the EventOrchestrator once it is constructed. Invoked by `coreKernel`
+	 * immediately after orchestrator creation so the public `applyTagEffect` method below can delegate.
+	 * @param {import('../event/eventOrchestrator').default} orchestrator
+	 */
+	_bindOrchestrator(orchestrator: import('../event/eventOrchestrator').default): void;
+	/**
+	 * @description Re-run the toolbar/menu active-state pass against the given selection node (or the
+	 * current selection if `null`). Thin pass-through to {@link EventOrchestrator#applyTagEffect};
+	 * exposed on `$.eventManager` so modules/plugins can request an immediate sync after they mutate
+	 * `commandDispatcher.targets` (e.g. CommandMenu pushing newly-rendered rows).
+	 * @param {?Node} [selectionNode]
+	 * @returns {Node | undefined}
+	 */
+	applyTagEffect(selectionNode?: Node | null): Node | undefined;
 	/**
 	 * @description Register for an event.
 	 * - Only events registered with this method are unregistered or re-registered when methods such as 'setOptions', 'destroy' are called.
@@ -30,7 +50,12 @@ declare class EventManager {
 	 * @param {boolean|AddEventListenerOptions} [useCapture] Event useCapture option
 	 * @return {?SunEditor.Event.Info} Registered event information
 	 */
-	addEvent(target: any, type: string, listener: any, useCapture?: boolean | AddEventListenerOptions): SunEditor.Event.Info | null;
+	addEvent(
+		target: any,
+		type: string,
+		listener: any,
+		useCapture?: boolean | AddEventListenerOptions,
+	): SunEditor.Event.Info | null;
 	/**
 	 * @description Remove event
 	 * @param {SunEditor.Event.Info} params event info = this.addEvent()
@@ -45,7 +70,11 @@ declare class EventManager {
 	 * @param {boolean|AddEventListenerOptions} [useCapture] Use event capture
 	 * @return {SunEditor.Event.GlobalInfo} Registered event information
 	 */
-	addGlobalEvent(type: string, listener: any, useCapture?: boolean | AddEventListenerOptions): SunEditor.Event.GlobalInfo;
+	addGlobalEvent(
+		type: string,
+		listener: any,
+		useCapture?: boolean | AddEventListenerOptions,
+	): SunEditor.Event.GlobalInfo;
 	/**
 	 * @description Remove events from document.
 	 * - When created as an Iframe, the event of the document inside the Iframe is also removed.
@@ -54,7 +83,11 @@ declare class EventManager {
 	 * @param {boolean|AddEventListenerOptions} [useCapture] Use event capture
 	 * @returns {undefined|null} Success: `null`, Not found: `undefined`
 	 */
-	removeGlobalEvent(type: string | SunEditor.Event.GlobalInfo, listener?: any, useCapture?: boolean | AddEventListenerOptions): undefined | null;
+	removeGlobalEvent(
+		type: string | SunEditor.Event.GlobalInfo,
+		listener?: any,
+		useCapture?: boolean | AddEventListenerOptions,
+	): undefined | null;
 	/**
 	 * @internal
 	 * @description Gives an active effect when the mouse down event is blocked. (Used when "env.isGecko" is `true`)

package/types/core/config/optionProvider.d.ts

@@ -52,7 +52,11 @@ export default class OptionProvider {
 	 * @param {SunEditor.Kernel} kernel
 	 * @param {import('../section/constructor').ConstructorReturnType} product
 	 */
-	constructor(kernel: SunEditor.Kernel, product: import('../section/constructor').ConstructorReturnType, options: any);
+	constructor(
+		kernel: SunEditor.Kernel,
+		product: import('../section/constructor').ConstructorReturnType,
+		options: any,
+	);
 	/**
 	 * @return {BaseOptionsMap}
 	 */

package/types/core/event/actions/index.d.ts

@@ -10,29 +10,67 @@ export namespace A {
 	function historyPush(hard: boolean): Action;
 	function documentTypeRefreshHeader(): Action;
 	function selectionSetRange(sc: Node, so: number, ec: Node, eo: number): Action;
-	function formatRemoveBlock(rangeEl: Element, selectedFormats: Element[] | null, newBlockElement: Element | null, shouldDelete: boolean, skipHistory: boolean): Action;
+	function formatRemoveBlock(
+		rangeEl: Element,
+		selectedFormats: Element[] | null,
+		newBlockElement: Element | null,
+		shouldDelete: boolean,
+		skipHistory: boolean,
+	): Action;
 	function domUtilsRemoveItem(item: Node): Action;
 	function selectComponentFallback(cmponentInfo: SunEditor.ComponentInfo): Action;
 	function delFormatRemoveAndMove(container: Node, formatEl: Element): Action;
 	function backspaceFormatMaintain(formatEl: Element): Action;
 	function backspaceBrLineStrip(formatEl: Element): Action;
-	function backspaceComponentSelect(selectionNode: Node, range: Range, fileComponentInfo: SunEditor.ComponentInfo): Action;
-	function backspaceComponentRemove(isList: boolean, sel: Node, formatEl: Element, fileComponentInfo: SunEditor.ComponentInfo): Action;
+	function backspaceComponentSelect(
+		selectionNode: Node,
+		range: Range,
+		fileComponentInfo: SunEditor.ComponentInfo,
+	): Action;
+	function backspaceComponentRemove(
+		isList: boolean,
+		sel: Node,
+		formatEl: Element,
+		fileComponentInfo: SunEditor.ComponentInfo,
+	): Action;
 	function backspaceListMergePrev(prev: Element, formatEl: Element, rangeEl: Element): Action;
 	function backspaceListRemoveNested(range: Range): Action;
+	function backspaceEmptyLineMergePrev(formatEl: Element, prev: Element): Action;
+	function backspaceBrLineRowMerge(rowEndBr: Node, rowStartBr: Node): Action;
 	function deleteComponentSelect(formatEl: Element, fileComponentInfo: SunEditor.ComponentInfo): Action;
 	function deleteComponentSelectNext(formatEl: any, nextEl: Element): Action;
 	function deleteListRemoveNested(range: Range, formatEl: Element, rangeEl: Element): Action;
+	function deleteEmptyLineMergeNext(formatEl: Element, next: Element): Action;
+	function deleteBrLineRowMerge(rowEndBr: Node): Action;
 	function tabFormatIndent(range: Range, formatEl: Element, shift: boolean): Action;
 	function enterScrollTo(range: Range): Action;
 	function enterLineAddDefault(formatEl: Element): Action;
 	function enterListAddItem(formatEl: Element, selectionNode: Node): Action;
 	function enterFormatExitEmpty(formatEl: Element, rangeEl: Element): Action;
-	function enterFormatCleanBrAndZWS(selectionNode: Node, selectionFormat: boolean, brBlock: Element, children: NodeList, offset: number): Action;
+	function enterFormatCleanBrAndZWS(
+		selectionNode: Node,
+		selectionFormat: boolean,
+		brBlock: Element,
+		children: NodeList,
+		offset: number,
+	): Action;
 	function enterFormatInsertBrHtml(brBlock: Element, range: Range, wSelection: Selection, offset: number): Action;
 	function enterFormatInsertBrNode(wSelection: Selection): Action;
-	function enterFormatBreakAtEdge(formatEl: Element, selectionNode: Node, formatStartEdge: boolean, formatEndEdge: boolean, bidiSwapped?: boolean): Action;
-	function enterFormatBreakWithSelection(formatEl: Element, range: Range, formatStartEdge: boolean, formatEndEdge: boolean): Action;
+	function enterBrLineInsert(range: Range): Action;
+	function enterBrLineExit(brBlock: Element): Action;
+	function enterFormatBreakAtEdge(
+		formatEl: Element,
+		selectionNode: Node,
+		formatStartEdge: boolean,
+		formatEndEdge: boolean,
+		bidiSwapped?: boolean,
+	): Action;
+	function enterFormatBreakWithSelection(
+		formatEl: Element,
+		range: Range,
+		formatStartEdge: boolean,
+		formatEndEdge: boolean,
+	): Action;
 	function enterFormatBreakAtCursor(formatEl: Element, range: Range): Action;
 	function enterFigcaptionExitInList(formatEl: Element): Action;
 	function keydownInputInsertNbsp(): Action;

package/types/core/event/effects/keydown.registry.d.ts

@@ -9,13 +9,23 @@ declare const _default: {
 	/** @action backspaceFormatMaintain */
 	'backspace.format.maintain': ({ ctx }: EffectContext_keydown, { formatEl }: any) => void;
 	/** @action backspaceComponentSelect */
-	'backspace.component.select': ({ ports }: EffectContext_keydown, { selectionNode, range, fileComponentInfo }: any) => void;
+	'backspace.component.select': (
+		{ ports }: EffectContext_keydown,
+		{ selectionNode, range, fileComponentInfo }: any,
+	) => void;
 	/** @action backspaceComponentRemove */
-	'backspace.component.remove': ({ ports }: EffectContext_keydown, { isList, sel, formatEl, fileComponentInfo }: any) => void;
+	'backspace.component.remove': (
+		{ ports }: EffectContext_keydown,
+		{ isList, sel, formatEl, fileComponentInfo }: any,
+	) => void;
 	/** @action backspaceListMergePrev */
 	'backspace.list.mergePrev': ({ ports }: EffectContext_keydown, { prev, formatEl, rangeEl }: any) => void;
 	/** @action backspaceListRemoveNested */
 	'backspace.list.removeNested': ({ ports }: EffectContext_keydown, { range }: any) => void;
+	/** @action backspaceEmptyLineMergePrev */
+	'backspace.emptyLine.mergePrev': ({ ports }: EffectContext_keydown, { formatEl, prev }: any) => void;
+	/** @action backspaceBrLineRowMerge */
+	'backspace.brline.rowMerge': ({ ports }: EffectContext_keydown, { rowEndBr, rowStartBr }: any) => void;
 	/** [delete] */
 	/** @action deleteComponentSelect */
 	'delete.component.select': ({ ports }: EffectContext_keydown, { formatEl, fileComponentInfo }: any) => void;
@@ -23,6 +33,10 @@ declare const _default: {
 	'delete.component.selectNext': ({ ports, ctx }: EffectContext_keydown, { formatEl, nextEl }: any) => void;
 	/** @action deleteListRemoveNested */
 	'delete.list.removeNested': ({ ports, ctx }: EffectContext_keydown, { range, formatEl, rangeEl }: any) => void;
+	/** @action deleteEmptyLineMergeNext — remove an empty line, move caret to the start of the next line */
+	'delete.emptyLine.mergeNext': ({ ports }: EffectContext_keydown, { formatEl, next }: any) => void;
+	/** @action deleteBrLineRowMerge — remove an empty row inside a brLine (PRE), pull the next row up */
+	'delete.brline.rowMerge': ({ ports }: EffectContext_keydown, { rowEndBr }: any) => void;
 	/** [tab] */
 	/** @action tabFormatIndent */
 	'tab.format.indent': ({ ports, ctx }: EffectContext_keydown, { range, formatEl, shift }: any) => boolean;
@@ -30,21 +44,37 @@ declare const _default: {
 	/** @action enterScrollTo */
 	'enter.scrollTo': ({ ports }: EffectContext_keydown, { range }: any) => void;
 	/** @action enterLineAddDefault */
-	'enter.line.addDefault': ({ ports, ctx }: EffectContext_keydown, { formatEl }: any) => void;
+	'enter.line.addDefault': ({ ports }: EffectContext_keydown, { formatEl }: any) => void;
 	/** @action enterListAddItem */
 	'enter.list.addItem': ({ ports }: EffectContext_keydown, { formatEl, selectionNode }: any) => void;
 	/** @action enterFormatExitEmpty */
 	'enter.format.exitEmpty': ({ ports, ctx }: EffectContext_keydown, { formatEl, rangeEl }: any) => void;
 	/** @action enterFormatCleanBrAndZWS */
-	'enter.format.cleanBrAndZWS': ({ ports }: EffectContext_keydown, { selectionNode, selectionFormat, brBlock, children, offset }: any) => void;
+	'enter.format.cleanBrAndZWS': (
+		{ ports }: EffectContext_keydown,
+		{ selectionNode, selectionFormat, brBlock, children, offset }: any,
+	) => void;
 	/** @action enterFormatInsertBrHtml */
-	'enter.format.insertBrHtml': ({ ports }: EffectContext_keydown, { brBlock, range, wSelection, offset }: any) => void;
+	'enter.format.insertBrHtml': (
+		{ ports }: EffectContext_keydown,
+		{ brBlock, range, wSelection, offset }: any,
+	) => void;
+	/** @action enterBrLineInsert — insert exactly one empty row at the caret inside a normal brLine. */
+	'enter.brline.insert': ({ ports }: EffectContext_keydown, { range }: any) => void;
+	/** @action enterBrLineExit — consume only the caret's current (last) empty row and add a default line after the brLine. */
+	'enter.brline.exit': ({ ports }: EffectContext_keydown, { brBlock }: any) => void;
 	/** @action enterFormatInsertBrNode */
 	'enter.format.insertBrNode': ({ ports }: EffectContext_keydown, { wSelection }: any) => void;
 	/** @action enterFormatBreakAtEdge */
-	'enter.format.breakAtEdge': ({ ports, ctx }: EffectContext_keydown, { formatEl, selectionNode, formatStartEdge, formatEndEdge, bidiSwapped }: any) => void;
+	'enter.format.breakAtEdge': (
+		{ ports, ctx }: EffectContext_keydown,
+		{ formatEl, selectionNode, formatStartEdge, formatEndEdge, bidiSwapped }: any,
+	) => void;
 	/** @action enterFormatBreakWithSelection */
-	'enter.format.breakWithSelection': ({ ports, ctx }: EffectContext_keydown, { formatEl, range, formatStartEdge, formatEndEdge }: any) => void;
+	'enter.format.breakWithSelection': (
+		{ ports, ctx }: EffectContext_keydown,
+		{ formatEl, range, formatStartEdge, formatEndEdge }: any,
+	) => void;
 	/** @action enterFormatBreakAtCursor */
 	'enter.format.breakAtCursor': ({ ports, ctx }: EffectContext_keydown, { formatEl, range }: any) => void;
 	/** @action enterFigcaptionExitInList */

package/types/core/event/effects/ruleHelpers.d.ts

@@ -45,4 +45,9 @@ export function setDefaultLine(ports: EventPorts, lineTagName: string): void;
  * @param {Document} doc - The document object
  * @returns {boolean} true if the detected edge doesn't match the visual position (bidi mismatch)
  */
-export function isRtlBidiMismatch(range: Range, formatEl: HTMLElement, detectedEdge: 'front' | 'end', doc: Document): boolean;
+export function isRtlBidiMismatch(
+	range: Range,
+	formatEl: HTMLElement,
+	detectedEdge: 'front' | 'end',
+	doc: Document,
+): boolean;

package/types/core/event/eventOrchestrator.d.ts

@@ -96,7 +96,12 @@ declare class EventOrchestrator extends KernelInjector {
 	 * @param {SunEditor.FrameContext} frameContext The frame context
 	 * @returns {Promise<boolean>} Resolves to `false` if processing is complete, otherwise allows default behavior
 	 */
-	_dataTransferAction(type: 'paste' | 'drop', e: Event, clipboardData: DataTransfer, frameContext: SunEditor.FrameContext): Promise<boolean>;
+	_dataTransferAction(
+		type: 'paste' | 'drop',
+		e: Event,
+		clipboardData: DataTransfer,
+		frameContext: SunEditor.FrameContext,
+	): Promise<boolean>;
 	/**
 	 * @internal
 	 * @description Registers common UI events such as toolbar and menu interactions.

package/types/core/event/handlers/handler_ww_clipboard.d.ts

@@ -6,12 +6,20 @@ import type {} from '../../../typedef';
  * @this {EventManagerThis_handler_ww_clipboard}
  * @param {ClipboardEvent} e - Event object
  */
-export function OnPaste_wysiwyg(this: import('../eventOrchestrator').default, frameContext: any, e: ClipboardEvent): true | Promise<boolean>;
+export function OnPaste_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	frameContext: any,
+	e: ClipboardEvent,
+): true | Promise<boolean>;
 /**
  * @this {EventManagerThis_handler_ww_clipboard}
  * @param {ClipboardEvent} e - Event object
  */
-export function OnCopy_wysiwyg(this: import('../eventOrchestrator').default, frameContext: any, e: ClipboardEvent): Promise<boolean>;
+export function OnCopy_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	frameContext: any,
+	e: ClipboardEvent,
+): Promise<boolean>;
 export class OnCopy_wysiwyg {
 	/**
 	 * @this {EventManagerThis_handler_ww_clipboard}
@@ -24,7 +32,11 @@ export class OnCopy_wysiwyg {
  * @this {EventManagerThis_handler_ww_clipboard}
  * @param {ClipboardEvent} e - Event object
  */
-export function OnCut_wysiwyg(this: import('../eventOrchestrator').default, frameContext: any, e: ClipboardEvent): Promise<boolean>;
+export function OnCut_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	frameContext: any,
+	e: ClipboardEvent,
+): Promise<boolean>;
 export class OnCut_wysiwyg {
 	/**
 	 * @this {EventManagerThis_handler_ww_clipboard}

package/types/core/event/handlers/handler_ww_dragDrop.d.ts

@@ -10,7 +10,14 @@ import type {} from '../../../typedef';
  * @param {?HTMLElement} _innerToolbar - Inner toolbar element
  * @param {DragEvent} e - Event object
  */
-export function OnDragOver_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, dragCursor: HTMLElement, _iframeTopArea: HTMLElement | null, _innerToolbar: HTMLElement | null, e: DragEvent): void;
+export function OnDragOver_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	dragCursor: HTMLElement,
+	_iframeTopArea: HTMLElement | null,
+	_innerToolbar: HTMLElement | null,
+	e: DragEvent,
+): void;
 /**
  * @this {EventManagerThis_handler_ww_dragDrop}
  * @param {HTMLElement} dragCursor - Drag cursor element
@@ -22,5 +29,10 @@ export function OnDragEnd_wysiwyg(this: import('../eventOrchestrator').default,
  * @param {HTMLElement} dragCursor - Drag cursor element
  * @param {DragEvent} e - Event object
  */
-export function OnDrop_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, dragCursor: HTMLElement, e: DragEvent): boolean | Promise<boolean>;
+export function OnDrop_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	dragCursor: HTMLElement,
+	e: DragEvent,
+): boolean | Promise<boolean>;
 export type EventManagerThis_handler_ww_dragDrop = import('../eventOrchestrator').default;

package/types/core/event/handlers/handler_ww_input.d.ts

@@ -7,7 +7,11 @@ import type {} from '../../../typedef';
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {InputEvent} e - Event object
  */
-export function OnBeforeInput_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: InputEvent): Promise<boolean>;
+export function OnBeforeInput_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: InputEvent,
+): Promise<boolean>;
 export class OnBeforeInput_wysiwyg {
 	/**
 	 * @typedef {import('../eventOrchestrator').default} EventManagerThis_handler_ww_input
@@ -25,7 +29,11 @@ export class OnBeforeInput_wysiwyg {
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {InputEvent} e - Event object
  */
-export function OnInput_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: InputEvent): Promise<boolean>;
+export function OnInput_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: InputEvent,
+): Promise<boolean>;
 export class OnInput_wysiwyg {
 	/**
 	 * @this {EventManagerThis_handler_ww_input}

package/types/core/event/handlers/handler_ww_key.d.ts

@@ -7,7 +7,11 @@ import type {} from '../../../typedef';
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {KeyboardEvent} e - Event object
  */
-export function OnKeyDown_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: KeyboardEvent): Promise<boolean>;
+export function OnKeyDown_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: KeyboardEvent,
+): Promise<boolean>;
 export class OnKeyDown_wysiwyg {
 	/**
 	 * @typedef {import('../eventOrchestrator').default} EventManagerThis_handler_ww_key_input
@@ -26,7 +30,11 @@ export class OnKeyDown_wysiwyg {
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {KeyboardEvent} e - Event object
  */
-export function OnKeyUp_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: KeyboardEvent): Promise<void>;
+export function OnKeyUp_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: KeyboardEvent,
+): Promise<void>;
 export class OnKeyUp_wysiwyg {
 	/**
 	 * @this {EventManagerThis_handler_ww_key_input}

package/types/core/event/handlers/handler_ww_mouse.d.ts

@@ -7,7 +7,11 @@ import type {} from '../../../typedef';
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {MouseEvent} e - Event object
  */
-export function OnMouseDown_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: MouseEvent): Promise<void>;
+export function OnMouseDown_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: MouseEvent,
+): Promise<void>;
 export class OnMouseDown_wysiwyg {
 	/**
 	 * @typedef {import('../eventOrchestrator').default} EventManagerThis_handler_ww_mouse
@@ -25,23 +29,39 @@ export class OnMouseDown_wysiwyg {
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {MouseEvent} e - Event object
  */
-export function OnMouseUp_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: MouseEvent): Promise<void>;
+export function OnMouseUp_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: MouseEvent,
+): Promise<void>;
 /**
  * @this {EventManagerThis_handler_ww_mouse}
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {MouseEvent} e - Event object
  */
-export function OnClick_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: MouseEvent): Promise<boolean>;
+export function OnClick_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: MouseEvent,
+): Promise<boolean>;
 /**
  * @this {EventManagerThis_handler_ww_mouse}
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {MouseEvent} e - Event object
  */
-export function OnMouseMove_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: MouseEvent): boolean;
+export function OnMouseMove_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: MouseEvent,
+): boolean;
 /**
  * @this {EventManagerThis_handler_ww_mouse}
  * @param {SunEditor.FrameContext} fc - Frame context object
  * @param {MouseEvent} e - Event object
  */
-export function OnMouseLeave_wysiwyg(this: import('../eventOrchestrator').default, fc: SunEditor.FrameContext, e: MouseEvent): Promise<void>;
+export function OnMouseLeave_wysiwyg(
+	this: import('../eventOrchestrator').default,
+	fc: SunEditor.FrameContext,
+	e: MouseEvent,
+): Promise<void>;
 export type EventManagerThis_handler_ww_mouse = import('../eventOrchestrator').default;

package/types/core/event/ports.d.ts

@@ -33,6 +33,7 @@ import type {} from '../../typedef';
  * @property {(...args: Parameters<Format['isEdgeLine']>) => ReturnType<Format['isEdgeLine']>} isEdgeLine
  * @property {(...args: Parameters<Format['removeBlock']>) => ReturnType<Format['removeBlock']>} removeBlock
  * @property {(...args: Parameters<Format['addLine']>) => ReturnType<Format['addLine']>} addLine
+ * @property {(...args: Parameters<Format['addLineAfter']>) => ReturnType<Format['addLineAfter']>} addLineAfter
  */
 /**
  * @typedef {Object} ListFormatPorts
@@ -111,6 +112,7 @@ export function makePorts(
 			removeArray: Array<Node> | null;
 		};
 		addLine: (el: any, nextOrTag: any) => HTMLElement;
+		addLineAfter: (el: any) => HTMLElement;
 	};
 	listFormat: {
 		applyNested: (
@@ -167,7 +169,7 @@ export function makePorts(
 	setOnShortcutKey: (v: any) => any;
 	/**
 	 * @description Scrolls the editor view to the caret position after pressing `Enter`.
-	 * @param {Range} range Range object
+	 * @param {Range} range Pre-Enter snapshot range (fallback only).
 	 */
 	enterScrollTo(range: Range): void;
 	/**
@@ -204,6 +206,7 @@ export type FormatPorts = {
 	isEdgeLine: (...args: Parameters<Format['isEdgeLine']>) => ReturnType<Format['isEdgeLine']>;
 	removeBlock: (...args: Parameters<Format['removeBlock']>) => ReturnType<Format['removeBlock']>;
 	addLine: (...args: Parameters<Format['addLine']>) => ReturnType<Format['addLine']>;
+	addLineAfter: (...args: Parameters<Format['addLineAfter']>) => ReturnType<Format['addLineAfter']>;
 };
 export type ListFormatPorts = {
 	applyNested: (...args: Parameters<ListFormat['applyNested']>) => ReturnType<ListFormat['applyNested']>;
@@ -220,7 +223,9 @@ export type HtmlPorts = {
 	insertNode: (...args: Parameters<Html['insertNode']>) => ReturnType<Html['insertNode']>;
 };
 export type NodeTransformPorts = {
-	removeAllParents: (...args: Parameters<NodeTransform['removeAllParents']>) => ReturnType<NodeTransform['removeAllParents']>;
+	removeAllParents: (
+		...args: Parameters<NodeTransform['removeAllParents']>
+	) => ReturnType<NodeTransform['removeAllParents']>;
 	split: (...args: Parameters<NodeTransform['split']>) => ReturnType<NodeTransform['split']>;
 };
 export type CharPorts = {

package/types/core/event/rules/keydown.rule.backspace.d.ts

@@ -12,7 +12,12 @@ import type {} from '../../../typedef';
  * @param {EventKeydownCtx} ctx - Context object
  * @returns {boolean} Return `false` to stop the processing
  */
-export function reduceBackspaceDown(this: void, actions: EventActions, ports: EventPorts, ctx: EventKeydownCtx): boolean;
+export function reduceBackspaceDown(
+	this: void,
+	actions: EventActions,
+	ports: EventPorts,
+	ctx: EventKeydownCtx,
+): boolean;
 export type EventActions = import('../actions').Action[];
 export type EventPorts = import('../ports').EventReducerPorts;
 export type EventKeydownCtx = import('../reducers/keydown.reducer').KeydownReducerCtx;

package/types/core/kernel/store.d.ts

@@ -168,7 +168,10 @@ declare class Store {
 	 * @param {(newValue: StoreState[K], oldValue: StoreState[K]) => void} callback
 	 * @returns {() => void} Unsubscribe function
 	 */
-	subscribe<K extends keyof StoreState>(path: K, callback: (newValue: StoreState[K], oldValue: StoreState[K]) => void): () => void;
+	subscribe<K extends keyof StoreState>(
+		path: K,
+		callback: (newValue: StoreState[K], oldValue: StoreState[K]) => void,
+	): () => void;
 	_reset(): void;
 	_destroy(): void;
 	#private;

package/types/core/logic/dom/format.d.ts

@@ -25,13 +25,13 @@ declare class Format {
 	/**
 	 * @description If a parent node that contains an argument node finds a format node (`format.isLine`), it returns that node.
 	 * @param {Node} node Reference node.
-	 * @param {?(current: Node) => boolean} [validation] Additional validation function.
+	 * @param {?(current: *) => boolean} [validation] Additional validation function.
 	 * @returns {HTMLElement|null}
 	 * @example
 	 * const line = editor.$.format.getLine(editor.$.selection.getNode());
 	 * const lineWithFilter = editor.$.format.getLine(node, (el) => el.nodeName !== 'LI');
 	 */
-	getLine(node: Node, validation?: ((current: Node) => boolean) | null): HTMLElement | null;
+	getLine(node: Node, validation?: ((current: any) => boolean) | null): HTMLElement | null;
 	/**
 	 * @description Replace the br-line tag of the current selection.
 	 * @param {Node} element BR-Line element (PRE..)
@@ -42,30 +42,48 @@ declare class Format {
 	/**
 	 * @description If a parent node that contains an argument node finds a `brLine` (`format.isBrLine`), it returns that node.
 	 * @param {Node} element Reference node.
-	 * @param {?(current: Node) => boolean} [validation] Additional validation function.
+	 * @param {?(current: *) => boolean} [validation] Additional validation function.
 	 * @returns {HTMLBRElement|null}
 	 * @example
 	 * const brLine = editor.$.format.getBrLine(editor.$.selection.getNode());
 	 */
-	getBrLine(element: Node, validation?: ((current: Node) => boolean) | null): HTMLBRElement | null;
+	getBrLine(element: Node, validation?: ((current: any) => boolean) | null): HTMLBRElement | null;
 	/**
-	 * @description Append `line` element to sibling node of argument element.
-	 * - If the `lineNode` argument value is present, the tag of that argument value is inserted,
-	 * - If not, the currently selected format tag is inserted.
-	 * @param {Node} element Insert as siblings of that element
-	 * @param {?(string|Node)} [lineNode] Node name or node obejct to be inserted
-	 * @returns {HTMLElement}
+	 * @description Insert a new line as the next sibling of `element`.
+	 * - Selection-aware — tag/attributes default to the **currently selected line**, not
+	 * - `element`'s tag. Use {@link addLineAfter} when the decision must depend only on
+	 * - `element` (e.g., Enter exiting a heading).
+	 *
+	 * - Tag resolution: brLine context → bare `<br>`; else `lineNode` override → current
+	 * - line clone → `defaultLine`. Attribute copy excludes only `id` (vs `addLineAfter`
+	 * - which respects `lineAttrReset`). Inside a table cell, inserts within the cell.
+	 *
+	 * @param {Node} element Reference element — new line is inserted right after it
+	 * @param {?(string|Node)} [lineNode] Override: string tag name, or Node whose tag
+	 *   and attributes (except `id`) are copied
+	 * @returns {HTMLElement} The new line, or a `<br>` in brLine context
 	 */
 	addLine(element: Node, lineNode?: (string | Node) | null): HTMLElement;
+	/**
+	 * @description Insert a new line after the given block element.
+	 * Selection-independent — determines tag/attributes from the element itself.
+	 * - Heading (H1-H6), HR → new default line
+	 * - LI → new LI with copied attributes
+	 * - PRE / brLine → new default line (exit brLine)
+	 * - Normal line → same tag with copied attributes
+	 * @param {HTMLElement} element The block element to insert after
+	 * @returns {HTMLElement|null} The newly created element
+	 */
+	addLineAfter(element: HTMLElement): HTMLElement | null;
 	/**
 	 * @description If a parent node that contains an argument node finds a format node (`format.isBlock`), it returns that node.
 	 * @param {Node} element Reference node.
-	 * @param {?(current: Node) => boolean} [validation] Additional validation function.
+	 * @param {?(current: *) => boolean} [validation] Additional validation function.
 	 * @returns {HTMLElement|null}
 	 * @example
 	 * const block = editor.$.format.getBlock(editor.$.selection.getNode());
 	 */
-	getBlock(element: Node, validation?: ((current: Node) => boolean) | null): HTMLElement | null;
+	getBlock(element: Node, validation?: ((current: any) => boolean) | null): HTMLElement | null;
 	/**
 	 * @description Appended all selected `line` element to the argument element(`block`) and insert
 	 * @param {Node} blockElement Element of wrap the arguments (BLOCKQUOTE...)
@@ -218,12 +236,12 @@ declare class Format {
 	isClosureBrLine(element: Node | string): element is HTMLElement;
 	/**
 	 * @description Returns a `line` array from selected range.
-	 * @param {?(current: Node) => boolean} [validation] The validation function. (Replaces the default validation `format.isLine(current)`)
+	 * @param {?(current: *) => boolean} [validation] The validation function. (Replaces the default validation `format.isLine(current)`)
 	 * @returns {Array<HTMLElement>}
 	 * @example
 	 * const selectedLines = editor.$.format.getLines();
 	 */
-	getLines(validation?: ((current: Node) => boolean) | null): Array<HTMLElement>;
+	getLines(validation?: ((current: any) => boolean) | null): Array<HTMLElement>;
 	/**
 	 * @description Get lines and components from the selected range. (P, DIV, H[1-6], OL, UL, TABLE..)
 	 * - If some of the component are included in the selection, get the entire that component.

package/types/core/logic/dom/html.d.ts

@@ -17,7 +17,7 @@ declare class HTML {
 	 * @param {Object} params - Filtering parameters.
 	 * @param {string} [params.tagWhitelist] - Allowed tags, specified as a string with tags separated by `'|'`. (e.g. `"div|p|span"`).
 	 * @param {string} [params.tagBlacklist] - Disallowed tags, specified as a string with tags separated by `'|'`. (e.g. `"script|iframe"`).
-	 * @param {(node: Node) => Node | string | null} [params.validate] - Function to validate and modify individual nodes.
+	 * @param {(node: *) => Node | string | null} [params.validate] - Function to validate and modify individual nodes.
 	 *   - Return `null` to remove the node.
 	 *   - Return a `Node` to replace the current node.
 	 *   - Return a `string` to replace the node's `outerHTML`.
@@ -54,7 +54,7 @@ declare class HTML {
 		}: {
 			tagWhitelist?: string;
 			tagBlacklist?: string;
-			validate?: (node: Node) => Node | string | null;
+			validate?: (node: any) => Node | string | null;
 			validateAll?: boolean;
 		},
 	): string;
@@ -185,7 +185,15 @@ declare class HTML {
 	 * const html = editor.$.html.get();
 	 * const htmlWithFrame = editor.$.html.get({ withFrame: true });
 	 */
-	get({ withFrame, includeFullPage, rootKey }?: { withFrame?: boolean; includeFullPage?: boolean; rootKey?: number | Array<number> }): string | any;
+	get({
+		withFrame,
+		includeFullPage,
+		rootKey,
+	}?: {
+		withFrame?: boolean;
+		includeFullPage?: boolean;
+		rootKey?: number | Array<number>;
+	}): string | any;
 	/**
 	 * @description Sets the HTML string to the editor content
 	 * @param {string} html HTML string