suneditor 3.1.4 → 3.2.1

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

@@ -51,8 +51,6 @@ declare class EventOrchestrator extends KernelInjector {
 	__eventDoc: Document;
 	/** @type {string} */
 	__secopy: string;
-	/** @type {HTMLInputElement} */
-	__focusTemp: HTMLInputElement;
 	/**
 	 * @description Activates the corresponding button with the tags information of the current cursor position,
 	 * - such as `bold`, `underline`, etc., and executes the `active` method of the plugins.
@@ -86,6 +84,13 @@ declare class EventOrchestrator extends KernelInjector {
 	 * @param {?string} formatName Format tag name (default: `P`)
 	 */
 	_setDefaultLine(formatName: string | null): void;
+	/**
+	 * @internal
+	 * @description Normalize the Enter range before the reducer reads it: reset to a text node, and when the
+	 * caret sits inside a zero-width text node adjacent to a `<br>`, move it onto the `<br>`.
+	 * @returns {?(HTMLElement|Text)} The updated selection node, or `null` when the caret is not on a line (no normalization ran).
+	 */
+	_normalizeEnterRange(): (HTMLElement | Text) | null;
 	/**
 	 * @internal
 	 * @description Handles data transfer actions for `paste` and `drop` events.
@@ -96,7 +101,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,12 +169,14 @@ 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;
 	/**
-	 * @description Prevents the default behavior of the `Enter` key and refocuses the editor.
-	 * @param {Event} e The keyboard event
+	 * @description Prevents the default behavior of the `Enter` key.
+	 * Enter now runs from `beforeinput` (post-IME-commit), so the former mobile focus-shuffle
+	 * (temp-focus → refocus, to force-end a virtual-keyboard IME session) is unnecessary.
+	 * @param {Event} e The keyboard/input event
 	 */
 	enterPrevent(e: Event): void;
 };
@@ -204,6 +208,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 +225,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/reducers/keydown.reducer.d.ts

@@ -4,7 +4,7 @@ import type {} from '../../../typedef';
  */
 /**
  * @typedef {Object} KeydownReducerCtx - Keydown Reducer Context object
- * @property {KeyboardEvent} ctx.e - The keyboard event
+ * @property {KeyboardEvent|InputEvent} ctx.e - The keyboard event (or the `beforeinput` InputEvent when Enter is dispatched from `beforeinput`)
  * @property {SunEditor.FrameContext} ctx.fc - Frame context object
  * @property {SunEditor.Store} ctx.store - Editor store object
  * @property {SunEditor.Options} ctx.options - Options object
@@ -27,15 +27,24 @@ import type {} from '../../../typedef';
  * @returns {Promise<EventActions>} Action list
  */
 export function reduceKeydown(ports: EventPorts, ctx: KeydownReducerCtx): Promise<EventActions>;
+/**
+ * @description Enter is processed from the `beforeinput` event (post-IME-commit) instead of `keydown`,
+ * to avoid trapping iOS/mobile IME marked-text when `keydown` mutates the DOM (see `handler_ww_input.js`).
+ * Flip to `false` to instantly restore the legacy synchronous `keydown` Enter path — no other file needs
+ * touching for rollback (the `keydown` Enter gate, the `handler_ww_key` normalization guard, and the
+ * `beforeinput` dispatch all key off this single flag).
+ * @type {boolean}
+ */
+export const ENTER_FROM_BEFOREINPUT: boolean;
 export type EventPorts = import('../ports').EventReducerPorts;
 /**
  * - Keydown Reducer Context object
  */
 export type KeydownReducerCtx = {
 	/**
-	 * - The keyboard event
+	 * - The keyboard event (or the `beforeinput` InputEvent when Enter is dispatched from `beforeinput`)
 	 */
-	e: KeyboardEvent;
+	e: KeyboardEvent | InputEvent;
 	/**
 	 * - Frame context object
 	 */

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;