suneditor 3.1.1 → 3.1.3

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

@@ -42,7 +42,7 @@ declare const _default: {
 	/** @action enterFormatInsertBrNode */
 	'enter.format.insertBrNode': ({ ports }: EffectContext_keydown, { wSelection }: any) => void;
 	/** @action enterFormatBreakAtEdge */
-	'enter.format.breakAtEdge': ({ ports, ctx }: EffectContext_keydown, { formatEl, selectionNode, formatStartEdge, formatEndEdge }: 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;
 	/** @action enterFormatBreakAtCursor */

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

@@ -34,3 +34,15 @@ export function isUneditableNode(ports: EventPorts, range: Range, isFront: boole
  * @returns {void}
  */
 export function setDefaultLine(ports: EventPorts, lineTagName: string): void;
+/**
+ * @description Detects if a detected logical edge is incorrect due to bidi text direction mismatch in RTL mode.
+ * When LTR text (numbers, Latin) is inside an RTL line, the browser may place the caret at offset 0
+ * for the visual end or offset=length for the visual start. This function compares the caret's visual
+ * position against the content boundaries to detect such mismatches.
+ * @param {Range} range - The current collapsed range
+ * @param {HTMLElement} formatEl - The format/line element
+ * @param {'front'|'end'} detectedEdge - The edge detected by logical offset check
+ * @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;

package/types/core/logic/shell/ui.d.ts

@@ -51,9 +51,9 @@ declare class UIManager {
 	setTheme(theme: string): void;
 	/**
 	 * @description Set direction to `rtl` or `ltr`.
-	 * @param {string} dir `rtl` or `ltr`
+	 * @param {"rtl"|"ltr"} dir `rtl` or `ltr`
 	 */
-	setDir(dir: string): void;
+	setDir(dir: 'rtl' | 'ltr'): void;
 	/**
 	 * @description Switch to or off `ReadOnly` mode.
 	 * @param {boolean} value `readOnly` boolean value.

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

@@ -309,7 +309,7 @@ export namespace DEFAULTS {
  *   attributeWhitelist: {
  *     a: 'href|target',
  *     img: 'src|alt',
- *     '*': 'id|data-*'
+ *     '*': 'id|data-[^\s]+'
  *   }
  * }
  * ```
@@ -1055,7 +1055,7 @@ export type EditorBaseOptions = {
 	 * attributeWhitelist: {
 	 * a: 'href|target',
 	 * img: 'src|alt',
-	 * '*': 'id|data-*'
+	 * '*': 'id|data-[^\s]+'
 	 * }
 	 * }
 	 * ```

package/types/core/section/documentType.d.ts

@@ -30,9 +30,19 @@ declare class DocumentType {
 	 * @param {number} t - The initial top position value to be adjusted.
 	 * @param {HTMLCollection} chr - The elements array in the current (main) page.
 	 * @param {HTMLCollection} mChr - The elements array in the mirrored page.
+	 * @param {Array.<{number: number, top: number, isBreak?: boolean}>} [pages] - The pages array containing page break info.
 	 * @returns {number|null} The adjusted top value.
 	 */
-	_calcPageBreakTop(t: number, chr: HTMLCollection, mChr: HTMLCollection): number | null;
+	_calcPageBreakTop(
+		t: number,
+		chr: HTMLCollection,
+		mChr: HTMLCollection,
+		pages?: Array<{
+			number: number;
+			top: number;
+			isBreak?: boolean;
+		}>,
+	): number | null;
 	/**
 	 * @internal
 	 * @description Initializes the cache for document elements.
@@ -44,6 +54,7 @@ declare class DocumentType {
 	 * @description Retrieves the element at a given position.
 	 * @param {number} pageTop - The vertical position to check.
 	 * @param {HTMLCollection} mChr - List of mirrored elements.
+	 * @param {Array.<{number: number, top: number, isBreak?: boolean}>} [pages] - The pages array containing page break info for skipping break elements.
 	 * @returns {{ci: number, cm: number, ch: number}} The closest element and its related data.
 	 * - ci: The index of the closest element.
 	 * - cm: The distance between the top of the closest element and the given position.
@@ -52,6 +63,11 @@ declare class DocumentType {
 	_getElementAtPosition(
 		pageTop: number,
 		mChr: HTMLCollection,
+		pages?: Array<{
+			number: number;
+			top: number;
+			isBreak?: boolean;
+		}>,
 	): {
 		ci: number;
 		cm: number;