suneditor 3.3.1 → 3.3.3

package/src/core/logic/dom/nodeTransform.js

@@ -106,8 +106,9 @@ class NodeTransform {
 
 			if (temp) {
 				if (dom.check.isListCell(newEl) && dom.check.isList(temp) && temp.firstElementChild) {
-					newEl.innerHTML = temp.firstElementChild.innerHTML;
-					dom.utils.removeItem(temp.firstElementChild);
+					const firstCell = temp.firstElementChild;
+					while (firstCell.firstChild) newEl.appendChild(firstCell.firstChild);
+					dom.utils.removeItem(firstCell);
 					if (temp.children.length > 0) newEl.appendChild(temp);
 				} else {
 					newEl.appendChild(temp);
@@ -300,7 +301,8 @@ class NodeTransform {
 							}
 						}
 					} else {
-						child.innerHTML += next.innerHTML;
+						while (next.firstChild) child.appendChild(next.firstChild);
+						child.normalize();
 					}
 
 					dom.utils.removeItem(next);

package/src/core/logic/panel/blockHandle.js

@@ -54,6 +54,10 @@ class BlockHandle {
 	#pendingMouseY = undefined;
 	/** @type {number|null} */
 	#hideTimer = null;
+	/** @type {boolean} */
+	#keyboardLock = false;
+	/** @type {number|undefined} */
+	#lastMouseY = undefined;
 	/** @type {HTMLElement[]} */
 	#hoverLines = [];
 
@@ -123,8 +127,6 @@ class BlockHandle {
 			em.addEvent(wrapper, 'dragover', this.#onDragOver.bind(this));
 			em.addEvent(wrapper, 'drop', this.#onDrop.bind(this));
 		}
-
-		em.addEvent(this.#$.frameContext.get('eventWysiwyg'), 'keydown', this.#onWrapperKeyDown.bind(this), true);
 	}
 
 	/**
@@ -161,13 +163,24 @@ class BlockHandle {
 		this.#cancelHide();
 		// Lock handle while action menu is open or dragging
 		if (this.#actionMenu?.isOpen || this.#isDragging) return;
+
+		if (this.#keyboardLock) {
+			if (mouseY === this.#lastMouseY) return;
+			this.#keyboardLock = false;
+		}
+
+		const framePending = this.#pendingTarget !== null;
 		this.#pendingTarget = eventTarget;
+		this.#lastMouseY = mouseY;
 		this.#pendingMouseY = mouseY;
-		if (this.#rafId) return;
+		if (framePending) return;
+
 		this.#rafId = _w.requestAnimationFrame(() => {
 			this.#rafId = null;
-			if (this.#pendingTarget) {
-				this.#doPosition(this.#pendingTarget, this.#pendingMouseY);
+			const target = this.#pendingTarget;
+			this.#pendingTarget = null;
+			if (target) {
+				this.#doPosition(target, this.#pendingMouseY);
 			}
 		});
 	}
@@ -321,6 +334,7 @@ class BlockHandle {
 		if (!this.#$) return;
 		if (this.#isDragging) return;
 
+		this.#keyboardLock = false;
 		this.#cancelHide();
 
 		// Don't reposition while action menu is open
@@ -494,6 +508,24 @@ class BlockHandle {
 
 		const totalOffset = indent + centeringExtra;
 
+		const toolbarEl = this.#$.context?.get('toolbar_main');
+		if (toolbarEl) {
+			const tRect = toolbarEl.getBoundingClientRect();
+			const handleWidth = this.#handle.offsetWidth || 0;
+			const hTop = firstLineCenterVP - handleHeight / 2;
+			const hLeft = isRtl ? areaRect.right - totalOffset - handleWidth : areaRect.left + totalOffset;
+			if (
+				tRect.height > 0 &&
+				hTop < tRect.bottom - 1 &&
+				hTop + handleHeight > tRect.top + 1 &&
+				hLeft < tRect.right &&
+				hLeft + handleWidth > tRect.left
+			) {
+				this.#hideHandle();
+				return;
+			}
+		}
+
 		this.#handle.style.top = top + 'px';
 		if (isRtl) {
 			this.#handle.style.left = '';
@@ -628,10 +660,13 @@ class BlockHandle {
 	}
 
 	/**
+	 * @internal
 	 * @description Editor keyboard activity (typing, Enter, etc.)
 	 */
-	#onWrapperKeyDown() {
-		this.#clearHoverLines();
+	hideOnKeyDown() {
+		if (this.#actionMenu?.isOpen) return;
+		this.#keyboardLock = true;
+		this.hideNow();
 	}
 
 	/**

package/src/core/logic/shell/component.js

@@ -136,6 +136,8 @@ class Component {
 
 		if (insertBehavior === undefined) insertBehavior = this.#options.get('componentInsertBehavior');
 
+		if (this.isSelected) this.__deselect();
+
 		const r = this.#$.html.remove();
 		const isInline = this.isInline(element);
 		this.#$.selection.getRangeAndAddLine(this.#$.selection.getRange(), r.container);
@@ -195,7 +197,7 @@ class Component {
 
 		const targetElement = /** @type {HTMLElement} */ (oNode || element);
 
-		if (scrollTo) this.#$.selection.scrollTo(targetElement, { behavior: 'auto' });
+		if (scrollTo) this.#$.selection.scrollTo(targetElement, { behavior: 'auto', noFocus: true });
 		if (insertBehavior !== null) this.applyInsertBehavior(element, oNode, insertBehavior);
 
 		return targetElement;

package/src/core/logic/shell/history.js

@@ -1,7 +1,36 @@
-import { _w } from '../../../helper/env';
+import { _w, _d } from '../../../helper/env';
 import { getNodeFromPath, getNodePath } from '../../../helper/dom/domQuery';
 import { numbers } from '../../../helper';
 
+const TRANSIENT_UI_CLASSES = [
+	'se-component-selected',
+	'se-figure-over-selected',
+	'se-block-hover',
+	'se-pre-code-focus',
+];
+const TRANSIENT_UI_CLASS_RE = new RegExp(TRANSIENT_UI_CLASSES.join('|'));
+const TRANSIENT_UI_CLASS_SELECTOR = '.' + TRANSIENT_UI_CLASSES.join(', .');
+
+/**
+ * @description Strips transient UI-state classes (selection/hover markers) from a snapshot's HTML.
+ * - only while a marker is actually present in the serialized content.
+ * @param {string} html Serialized wysiwyg content
+ * @returns {string} The cleaned content
+ */
+function cleanSnapshot(html) {
+	if (!TRANSIENT_UI_CLASS_RE.test(html)) return html;
+
+	const t = _d.createElement('template');
+	t.innerHTML = html;
+
+	const marked = t.content.querySelectorAll(TRANSIENT_UI_CLASS_SELECTOR);
+	for (let i = 0; i < marked.length; i++) {
+		marked[i].classList.remove(...TRANSIENT_UI_CLASSES);
+	}
+
+	return t.innerHTML;
+}
+
 /**
  * @description History stack closure
  * @param {SunEditor.Kernel} kernel
@@ -206,7 +235,7 @@ export default function History(kernel) {
 		$.pluginManager.checkFileInfo(false);
 
 		const fc = frameRoots.get(rootKey);
-		const current = fc.get('wysiwyg').innerHTML;
+		const current = cleanSnapshot(fc.get('wysiwyg').innerHTML);
 		const root = rootStack[rootKey];
 		if (!current || (root.value[root.index] && current === root.value[root.index].content)) return;
 		if (stack.length > stackIndex + 1) refreshRoots(root);
@@ -319,7 +348,7 @@ export default function History(kernel) {
 		 */
 		overwrite(rootKey) {
 			setStack(
-				frameRoots.get(rootKey || store.get('rootKey')).get('wysiwyg').innerHTML,
+				cleanSnapshot(frameRoots.get(rootKey || store.get('rootKey')).get('wysiwyg').innerHTML),
 				null,
 				store.get('rootKey'),
 				0,

package/src/core/logic/shell/ui.js

@@ -959,7 +959,12 @@ class UIManager {
 		this._updatePlaceholder(fc);
 		// document type page
 		if (fc.has('documentType_use_page')) {
-			fc.get('documentTypePageMirror').innerHTML = fc.get('wysiwyg').innerHTML;
+			const mirror = fc.get('documentTypePageMirror');
+			const frag = mirror.ownerDocument.createDocumentFragment();
+			for (let n = fc.get('wysiwyg').firstChild; n; n = n.nextSibling) {
+				frag.appendChild(n.cloneNode(true));
+			}
+			mirror.replaceChildren(frag);
 			fc.get('documentType').rePage(true);
 		}
 	}

package/src/core/schema/options.js

@@ -71,6 +71,7 @@ export const DEFAULTS = {
 		'@text': 'font-family|font-size|color|background-color|width|height',
 		'@line': 'text-align|margin|margin-left|margin-right|line-height',
 		'@component': 'width|height|min-width',
+		li: 'font-family|font-size|color|background-color|font-weight|font-style',
 		'table|th|td':
 			'border|border-[a-z]+|color|background-color|text-align|float|font-weight|text-decoration|font-style|vertical-align',
 		'table|td': 'width',
@@ -457,7 +458,7 @@ export const DEFAULTS = {
  * - Value is a pipe-delimited list of allowed style names.
  * - Resolution order when filtering an element: `@component` (for `.se-component` containers) → explicit tag entry → `@line` (for formatLine elements) → `@text` (for textStyleTags).
  * - `@component` guards the inline sizing (`width`/`height`/`min-width`) the editor writes on a media component's container for percentage-based sizes; keep these so a clean() round-trip does not reset the component to full width.
- * - An explicit tag entry **replaces** the category default — include category styles in the value if you want both.
+ * - An explicit tag entry is **merged** with its category default when the tag belongs to one (`@line` for formatLine elements, else `@text` for textStyleTags) — the entry adds styles on top of the category's.
  * - Merged with {@link DEFAULTS.TAG_STYLES}; user-supplied keys win.
  * ```js
  * {
@@ -465,8 +466,8 @@ export const DEFAULTS = {
  *     '@text': 'color|font-size|background-color',  // default for span, b, i, em, ...
  *     '@line': 'text-align|margin|line-height',     // default for p, h1-h6, div, li, ...
  *     'table|td': 'border|color|background-color',  // per-tag whitelist
- *     div: 'color',                                   // explicit override; ignores `@line` default
- *     hr: 'border-top',
+ *      div: 'color',                                 // merged with the `@line` default (div is a line element)
+ *      hr: 'border-top',
  *   }
  * }
  * ```

package/src/events.js

@@ -17,7 +17,7 @@
  * @property {Event} event - event object
  * @property {string} data - drop data
  * @property {boolean} maxCharCount - is max char count
- * @property {string} from - `"SE"`|`"MS"`|`""` - source
+ * @property {string} from - `"SE"`|`"MS"`|`"GOOGLE"`|`""` - source
  */
 
 // --- media

package/src/helper/dom/domQuery.js

@@ -513,7 +513,8 @@ export function getEdgeChildNodes(first, last) {
 
 /**
  * @template {Node} T
- * @description Gets the previous sibling last child. If there is no sibling, then it'll take it from the closest ancestor with child
+ * @description Gets the previous sibling last child. If there is no sibling, then it'll take it from the closest ancestor with child.
+ * - Components (image, table, etc.) are treated as a single tag and not traversed into.
  * @param {Node} node Reference element
  * @param {?Node} [ceiling] Highest boundary allowed
  * @returns {T|null} Not found: `null`
@@ -533,14 +534,17 @@ export function getPreviousDeepestNode(node, ceiling) {
 
 	if (domCheck.isNonEditable(previousNode)) return /** @type {T} */ (/** @type {unknown} */ (previousNode));
 
-	while (previousNode.lastChild) previousNode = previousNode.lastChild;
+	while (!domCheck.isComponentContainer(previousNode) && previousNode.lastChild) {
+		previousNode = previousNode.lastChild;
+	}
 
 	return /** @type {T} */ (/** @type {unknown} */ (previousNode));
 }
 
 /**
  * @template {Node} T
- * @description Gets the next sibling first child. If there is no sibling, then it'll take it from the closest ancestor with child
+ * @description Gets the next sibling first child. If there is no sibling, then it'll take it from the closest ancestor with child.
+ * - Components (image, table, etc.) are treated as a single tag and not traversed into.
  * @param {Node} node Reference element
  * @param {?Node} [ceiling] Highest boundary allowed
  * @returns {T|null} Not found: `null`
@@ -560,7 +564,9 @@ export function getNextDeepestNode(node, ceiling) {
 
 	if (domCheck.isNonEditable(nextNode)) return /** @type {T} */ (/** @type {unknown} */ (nextNode));
 
-	while (nextNode.firstChild) nextNode = nextNode.firstChild;
+	while (!domCheck.isComponentContainer(nextNode) && nextNode.firstChild) {
+		nextNode = nextNode.firstChild;
+	}
 
 	return /** @type {T} */ (/** @type {unknown} */ (nextNode));
 }

package/src/helper/googleDocs.js

@@ -0,0 +1,40 @@
+/**
+ * @description Cleans Google Docs clipboard HTML.
+ */
+
+/** Matches the Google Docs clipboard wrapper id */
+const _RE_GUID = /id=["']?docs-internal-guid-/i;
+
+/**
+ * @description Whether the HTML string is a Google Docs clipboard payload.
+ * @param {string} html HTML string
+ * @returns {boolean}
+ */
+export function isGoogleDocs(html) {
+	return _RE_GUID.test(html);
+}
+
+/**
+ * @description Removes the Google Docs clipboard wrapper tags, keeping their children.
+ * - Only the guid-carrying inline wrappers (`b`/`span`) are unwrapped; real formatting tags inside are untouched.
+ * @param {string} html HTML string
+ * @returns {string} HTML string
+ */
+export function cleanHTML(html) {
+	const doc = new DOMParser().parseFromString(html, 'text/html');
+	const wrappers = doc.body.querySelectorAll('b[id^="docs-internal-guid-"], span[id^="docs-internal-guid-"]');
+	if (wrappers.length === 0) return html;
+
+	for (let i = 0, len = wrappers.length, w; i < len; i++) {
+		w = wrappers[i];
+		while (w.firstChild) w.parentNode.insertBefore(w.firstChild, w);
+		w.parentNode.removeChild(w);
+	}
+
+	return doc.body.innerHTML;
+}
+
+export default {
+	isGoogleDocs,
+	cleanHTML,
+};

package/src/helper/index.js

@@ -7,6 +7,7 @@ import KeyCodeMap from './keyCodeMap';
 import Clipboard from './clipboard';
 import Markdown from './markdown';
 import MSOffice from './msOffice';
+import GoogleDocs from './googleDocs';
 
 export const env = Env;
 export const unicode = Unicode;
@@ -17,6 +18,7 @@ export const keyCodeMap = KeyCodeMap;
 export const clipboard = Clipboard;
 export const markdown = Markdown;
 export const msOffice = MSOffice;
+export const googleDocs = GoogleDocs;
 
 export default {
 	env,
@@ -28,4 +30,5 @@ export default {
 	clipboard,
 	markdown,
 	msOffice,
+	googleDocs,
 };

package/src/modules/contract/Modal.js

@@ -249,6 +249,7 @@ class Modal {
 		}
 
 		this.#targetElement = null;
+		this.isUpdate = false;
 	}
 
 	/**

package/src/plugins/command/codeBlock.js

@@ -1,5 +1,5 @@
 import { PluginCommand, PluginDropdown } from '../../interfaces';
-import { converter, dom } from '../../helper';
+import { converter, dom, env } from '../../helper';
 import { Controller } from '../../modules/contract';
 import { SelectMenu } from '../../modules/ui';
 
@@ -133,6 +133,14 @@ class CodeBlock extends PluginCommand {
 		this.#hoverSelectMenu.on(this.#hoverButton, this.#onHoverSelect.bind(this));
 		this.#buildHoverMenu('');
 
+		this.$.eventManager.addEvent(containerEl, 'mousedown', (e) => {
+			if (env.isMobile || this.#hoverSelectMenu.form?.contains(dom.query.getEventTarget(e))) {
+				this.$.store.set('_preventBlur', true);
+			} else {
+				e.preventDefault();
+			}
+		});
+
 		// selectMenu
 		this.$.eventManager.addEvent(this.#hoverButton, 'click', (e) => {
 			e.preventDefault();

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

@@ -51,3 +51,59 @@ export function isRtlBidiMismatch(
 	detectedEdge: 'front' | 'end',
 	doc: Document,
 ): boolean;
+/**
+ * @description Whether the caret sits on a bare `<br>` that stands at the front/end edge of its `line`.
+ * @param {Range} range - The current range
+ * @param {Node} selectionNode - Current selection node
+ * @param {'front'|'end'} edge - Edge to test: `front` for Backspace, `end` for Delete
+ * @returns {boolean} `true` if the caret is on an edge `<br>`
+ */
+export function isEdgeBreakCaret(range: Range, selectionNode: Node, edge: 'front' | 'end'): boolean;
+/**
+ * @description The previous/next element in document order — crossing in and out of blocks (list, quote).
+ * - Out of list-cell ancestors (a nested list), stopping at a closure block (table cell).
+ * @param {EventPorts['format']} format - Format module
+ * @param {?HTMLElement} line - The caret's `line` element
+ * @param {'front'|'end'} edge - `front` for the previous element, `end` for the next one
+ * @returns {?HTMLElement} The adjacent element, or `null` at the document edge
+ */
+export function getAdjacentElement(
+	format: EventPorts['format'],
+	line: HTMLElement | null,
+	edge: 'front' | 'end',
+): HTMLElement | null;
+/**
+ * @description The previous/next `line` in document order — {@link getAdjacentElement} filtered to lines.
+ * - `null` means either the document edge or a non-`line` neighbour (a component); use
+ * {@link getAdjacentElement} when the two must be told apart.
+ * @param {EventPorts['format']} format - Format module
+ * @param {?HTMLElement} line - The caret's `line` element
+ * @param {'front'|'end'} edge - `front` for the previous line, `end` for the next one
+ * @returns {?HTMLElement} The adjacent line, or `null`
+ */
+export function getAdjacentLine(
+	format: EventPorts['format'],
+	line: HTMLElement | null,
+	edge: 'front' | 'end',
+): HTMLElement | null;
+/**
+ * @description The neighbouring `line` an empty line collapses into, or `null` when there is nothing to merge.
+ * - A cell owning a nested list belongs to {@link getNestedListTarget} instead.
+ * @param {EventPorts['format']} format - Format module
+ * @param {?HTMLElement} formatEl - The caret's `line` element
+ * @param {'front'|'end'} edge - `front` for Backspace (previous line), `end` for Delete (next line)
+ * @returns {?HTMLElement} The neighbouring line to merge into, or `null`
+ */
+export function getEmptyLineMergeTarget(
+	format: EventPorts['format'],
+	formatEl: HTMLElement | null,
+	edge: 'front' | 'end',
+): HTMLElement | null;
+/**
+ * @description The nested list a list-cell Backspace/Delete would lift, or `null` when there is none.
+ * - The rules gate their list branch on it so the branch can't claim the key with nothing to do.
+ * @param {HTMLElement} formatEl - The caret's list cell
+ * @param {HTMLElement} rangeEl - The list (`UL`/`OL`) the cell belongs to
+ * @returns {?HTMLElement} The element carrying the nested list, or `null`
+ */
+export function getNestedListTarget(formatEl: HTMLElement, rangeEl: HTMLElement): HTMLElement | null;

package/types/core/logic/panel/blockHandle.d.ts

@@ -47,5 +47,10 @@ declare class BlockHandle {
 	 * @description Cleanup — remove listeners, destroy menus, null references.
 	 */
 	destroy(): void;
+	/**
+	 * @internal
+	 * @description Editor keyboard activity (typing, Enter, etc.)
+	 */
+	hideOnKeyDown(): void;
 	#private;
 }

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

@@ -28,6 +28,7 @@ export namespace DEFAULTS {
 		'@text': string;
 		'@line': string;
 		'@component': string;
+		li: string;
 		'table|th|td': string;
 		'table|td': string;
 		tr: string;
@@ -400,7 +401,7 @@ export namespace DEFAULTS {
  * - Value is a pipe-delimited list of allowed style names.
  * - Resolution order when filtering an element: `@component` (for `.se-component` containers) → explicit tag entry → `@line` (for formatLine elements) → `@text` (for textStyleTags).
  * - `@component` guards the inline sizing (`width`/`height`/`min-width`) the editor writes on a media component's container for percentage-based sizes; keep these so a clean() round-trip does not reset the component to full width.
- * - An explicit tag entry **replaces** the category default — include category styles in the value if you want both.
+ * - An explicit tag entry is **merged** with its category default when the tag belongs to one (`@line` for formatLine elements, else `@text` for textStyleTags) — the entry adds styles on top of the category's.
  * - Merged with {@link DEFAULTS.TAG_STYLES}; user-supplied keys win.
  * ```js
  * {
@@ -408,8 +409,8 @@ export namespace DEFAULTS {
  *     '@text': 'color|font-size|background-color',  // default for span, b, i, em, ...
  *     '@line': 'text-align|margin|line-height',     // default for p, h1-h6, div, li, ...
  *     'table|td': 'border|color|background-color',  // per-tag whitelist
- *     div: 'color',                                   // explicit override; ignores `@line` default
- *     hr: 'border-top',
+ *      div: 'color',                                 // merged with the `@line` default (div is a line element)
+ *      hr: 'border-top',
  *   }
  * }
  * ```
@@ -1254,7 +1255,7 @@ export type EditorBaseOptions = {
 	 * - Value is a pipe-delimited list of allowed style names.
 	 * - Resolution order when filtering an element: `@component` (for `.se-component` containers) → explicit tag entry → `@line` (for formatLine elements) → `@text` (for textStyleTags).
 	 * - `@component` guards the inline sizing (`width`/`height`/`min-width`) the editor writes on a media component's container for percentage-based sizes; keep these so a clean() round-trip does not reset the component to full width.
-	 * - An explicit tag entry **replaces** the category default — include category styles in the value if you want both.
+	 * - An explicit tag entry is **merged** with its category default when the tag belongs to one (`@line` for formatLine elements, else `@text` for textStyleTags) — the entry adds styles on top of the category's.
 	 * - Merged with {@link DEFAULTS.TAG_STYLES}; user-supplied keys win.
 	 * ```js
 	 * {
@@ -1262,7 +1263,7 @@ export type EditorBaseOptions = {
 	 * '@text': 'color|font-size|background-color',  // default for span, b, i, em, ...
 	 * '@line': 'text-align|margin|line-height',     // default for p, h1-h6, div, li, ...
 	 * 'table|td': 'border|color|background-color',  // per-tag whitelist
-	 * div: 'color',                                   // explicit override; ignores `@line` default
+	 * div: 'color',                                 // merged with the `@line` default (div is a line element)
 	 * hr: 'border-top',
 	 * }
 	 * }

package/types/events.d.ts

@@ -35,7 +35,7 @@ export type ClipboardEvent = {
 	 */
 	maxCharCount: boolean;
 	/**
-	 * - `"SE"`|`"MS"`|`""` - source
+	 * - `"SE"`|`"MS"`|`"GOOGLE"`|`""` - source
 	 */
 	from: string;
 };
@@ -289,7 +289,7 @@ export type EventHandlers = {
  * @property {Event} event - event object
  * @property {string} data - drop data
  * @property {boolean} maxCharCount - is max char count
- * @property {string} from - `"SE"`|`"MS"`|`""` - source
+ * @property {string} from - `"SE"`|`"MS"`|`"GOOGLE"`|`""` - source
  */
 /**
  * @typedef {Object} FileManagementInfo

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

@@ -198,7 +198,8 @@ export function getEdgeChildNodes(
 };
 /**
  * @template {Node} T
- * @description Gets the previous sibling last child. If there is no sibling, then it'll take it from the closest ancestor with child
+ * @description Gets the previous sibling last child. If there is no sibling, then it'll take it from the closest ancestor with child.
+ * - Components (image, table, etc.) are treated as a single tag and not traversed into.
  * @param {Node} node Reference element
  * @param {?Node} [ceiling] Highest boundary allowed
  * @returns {T|null} Not found: `null`
@@ -206,7 +207,8 @@ export function getEdgeChildNodes(
 export function getPreviousDeepestNode<T extends Node>(node: Node, ceiling?: Node | null): T | null;
 /**
  * @template {Node} T
- * @description Gets the next sibling first child. If there is no sibling, then it'll take it from the closest ancestor with child
+ * @description Gets the next sibling first child. If there is no sibling, then it'll take it from the closest ancestor with child.
+ * - Components (image, table, etc.) are treated as a single tag and not traversed into.
  * @param {Node} node Reference element
  * @param {?Node} [ceiling] Highest boundary allowed
  * @returns {T|null} Not found: `null`

package/types/helper/googleDocs.d.ts

@@ -0,0 +1,19 @@
+import type {} from '../typedef';
+/**
+ * @description Whether the HTML string is a Google Docs clipboard payload.
+ * @param {string} html HTML string
+ * @returns {boolean}
+ */
+export function isGoogleDocs(html: string): boolean;
+/**
+ * @description Removes the Google Docs clipboard wrapper tags, keeping their children.
+ * - Only the guid-carrying inline wrappers (`b`/`span`) are unwrapped; real formatting tags inside are untouched.
+ * @param {string} html HTML string
+ * @returns {string} HTML string
+ */
+export function cleanHTML(html: string): string;
+declare namespace _default {
+	export { isGoogleDocs };
+	export { cleanHTML };
+}
+export default _default;

package/types/helper/index.d.ts

@@ -178,6 +178,10 @@ export const markdown: {
 export const msOffice: {
 	cleanHTML: typeof import('./msOffice').cleanHTML;
 };
+export const googleDocs: {
+	isGoogleDocs: typeof import('./googleDocs').isGoogleDocs;
+	cleanHTML: typeof import('./googleDocs').cleanHTML;
+};
 declare namespace _default {
 	export { env };
 	export { unicode };
@@ -188,5 +192,6 @@ declare namespace _default {
 	export { clipboard };
 	export { markdown };
 	export { msOffice };
+	export { googleDocs };
 }
 export default _default;