@ckeditor/ckeditor5-paste-from-office 48.2.0 → 48.3.0-alpha.0

package/dist/augmentation.d.ts

@@ -1,10 +1,10 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import type { PasteFromOffice } from './index.js';
-declare module '@ckeditor/ckeditor5-core' {
-    interface PluginsMap {
-        [PasteFromOffice.pluginName]: PasteFromOffice;
-    }
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import type { PasteFromOffice } from "./index.js";
+declare module "@ckeditor/ckeditor5-core" {
+	interface PluginsMap {
+		[PasteFromOffice.pluginName]: PasteFromOffice;
+	}
 }

package/dist/filters/bookmark.d.ts

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/bookmark
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/bookmark
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Transforms `<a>` elements which are bookmarks by moving their children after the element.
- *
- * @internal
- */
+* Transforms `<a>` elements which are bookmarks by moving their children after the element.
+*
+* @internal
+*/
 export declare function transformBookmarks(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/br.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/br
- */
-import { type ViewUpcastWriter, type ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/br
+*/
+import { type ViewUpcastWriter, type ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Transforms `<br>` elements that are siblings to some block element into a paragraphs.
- *
- * @param documentFragment The view structure to be transformed.
- * @internal
- */
+* Transforms `<br>` elements that are siblings to some block element into a paragraphs.
+*
+* @param documentFragment The view structure to be transformed.
+* @internal
+*/
 export declare function transformBlockBrsToParagraphs(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/image.d.ts

@@ -1,25 +1,25 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/image
- */
-import { type ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/image
+*/
+import { type ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Replaces source attribute of all `<img>` elements representing regular
- * images (not the Word shapes) with inlined base64 image representation extracted from RTF or Blob data.
- *
- * @param documentFragment Document fragment on which transform images.
- * @param rtfData The RTF data from which images representation will be used.
- * @internal
- */
+* Replaces source attribute of all `<img>` elements representing regular
+* images (not the Word shapes) with inlined base64 image representation extracted from RTF or Blob data.
+*
+* @param documentFragment Document fragment on which transform images.
+* @param rtfData The RTF data from which images representation will be used.
+* @internal
+*/
 export declare function replaceImagesSourceWithBase64(documentFragment: ViewDocumentFragment, rtfData: string): void;
 /**
- * Converts given HEX string to base64 representation.
- *
- * @internal
- * @param hexString The HEX string to be converted.
- * @returns Base64 representation of a given HEX string.
- */
+* Converts given HEX string to base64 representation.
+*
+* @internal
+* @param hexString The HEX string to be converted.
+* @returns Base64 representation of a given HEX string.
+*/
 export declare function _convertHexToBase64(hexString: string): string;

package/dist/filters/list.d.ts

@@ -1,31 +1,31 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/list
- */
-import { ViewUpcastWriter, type ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/list
+*/
+import { ViewUpcastWriter, type ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Transforms Word specific list-like elements to the semantic HTML lists.
- *
- * Lists in Word are represented by block elements with special attributes like:
- *
- * ```xml
- * <p class=MsoListParagraphCxSpFirst style='mso-list:l1 level1 lfo1'>...</p> // Paragraph based list.
- * <h1 style='mso-list:l0 level1 lfo1'>...</h1> // Heading 1 based list.
- * ```
- *
- * @param documentFragment The view structure to be transformed.
- * @param stylesString Styles from which list-like elements styling will be extracted.
- * @param hasMultiLevelListPlugin Whether the editor has the multi-level list plugin enabled.
- * @param enableSkipLevelLists Whether to enable skip-level lists.
- * @internal
- */
+* Transforms Word specific list-like elements to the semantic HTML lists.
+*
+* Lists in Word are represented by block elements with special attributes like:
+*
+* ```xml
+* <p class=MsoListParagraphCxSpFirst style='mso-list:l1 level1 lfo1'>...</p> // Paragraph based list.
+* <h1 style='mso-list:l0 level1 lfo1'>...</h1> // Heading 1 based list.
+* ```
+*
+* @param documentFragment The view structure to be transformed.
+* @param stylesString Styles from which list-like elements styling will be extracted.
+* @param hasMultiLevelListPlugin Whether the editor has the multi-level list plugin enabled.
+* @param enableSkipLevelLists Whether to enable skip-level lists.
+* @internal
+*/
 export declare function transformListItemLikeElementsIntoLists(documentFragment: ViewDocumentFragment, stylesString: string, hasMultiLevelListPlugin: boolean, enableSkipLevelLists?: boolean): void;
 /**
- * Removes paragraph wrapping content inside a list item.
- *
- * @internal
- */
+* Removes paragraph wrapping content inside a list item.
+*
+* @internal
+*/
 export declare function unwrapParagraphInListItem(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/parse.d.ts

@@ -1,35 +1,35 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/parse
- */
-import { type StylesProcessor, type ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/parse
+*/
+import { type StylesProcessor, type ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Parses the provided HTML extracting contents of `<body>` and `<style>` tags.
- *
- * @param htmlString HTML string to be parsed.
- */
+* Parses the provided HTML extracting contents of `<body>` and `<style>` tags.
+*
+* @param htmlString HTML string to be parsed.
+*/
 export declare function parsePasteOfficeHtml(htmlString: string, stylesProcessor: StylesProcessor): PasteOfficeHtmlParseResult;
 /**
- * The result of {@link ~parsePasteOfficeHtml}.
- */
+* The result of {@link ~parsePasteOfficeHtml}.
+*/
 export interface PasteOfficeHtmlParseResult {
-    /**
-     * Parsed body content as a traversable structure.
-     */
-    body: ViewDocumentFragment;
-    /**
-     * Entire body content as a string.
-     */
-    bodyString: string;
-    /**
-     * Array of native `CSSStyleSheet` objects, each representing separate `style` tag from the source HTML.
-     */
-    styles: Array<CSSStyleSheet>;
-    /**
-     * All `style` tags contents combined in the order of occurrence into one string.
-     */
-    stylesString: string;
+	/**
+	* Parsed body content as a traversable structure.
+	*/
+	body: ViewDocumentFragment;
+	/**
+	* Entire body content as a string.
+	*/
+	bodyString: string;
+	/**
+	* Array of native `CSSStyleSheet` objects, each representing separate `style` tag from the source HTML.
+	*/
+	styles: Array<CSSStyleSheet>;
+	/**
+	* All `style` tags contents combined in the order of occurrence into one string.
+	*/
+	stylesString: string;
 }

package/dist/filters/removeboldwrapper.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removeboldwrapper
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removeboldwrapper
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Removes the `<b>` tag wrapper added by Google Docs to a copied content.
- *
- * @param documentFragment element `data.content` obtained from clipboard
- * @internal
- */
+* Removes the `<b>` tag wrapper added by Google Docs to a copied content.
+*
+* @param documentFragment element `data.content` obtained from clipboard
+* @internal
+*/
 export declare function removeBoldWrapper(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/removegooglesheetstag.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removegooglesheetstag
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removegooglesheetstag
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Removes the `<google-sheets-html-origin>` tag wrapper added by Google Sheets to a copied content.
- *
- * @param documentFragment element `data.content` obtained from clipboard
- * @internal
- */
+* Removes the `<google-sheets-html-origin>` tag wrapper added by Google Sheets to a copied content.
+*
+* @param documentFragment element `data.content` obtained from clipboard
+* @internal
+*/
 export declare function removeGoogleSheetsTag(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/removeinvalidtablewidth.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removeinvalidtablewidth
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removeinvalidtablewidth
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Removes the `width:0px` style from table pasted from Google Sheets and `width="0"` attribute from Word tables.
- *
- * @param documentFragment element `data.content` obtained from clipboard
- * @internal
- */
+* Removes the `width:0px` style from table pasted from Google Sheets and `width="0"` attribute from Word tables.
+*
+* @param documentFragment element `data.content` obtained from clipboard
+* @internal
+*/
 export declare function removeInvalidTableWidth(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/removemsattributes.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removemsattributes
- */
-import { type ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removemsattributes
+*/
+import { type ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Cleanup MS attributes like styles, attributes and elements.
- *
- * @param documentFragment element `data.content` obtained from clipboard.
- * @internal
- */
+* Cleanup MS attributes like styles, attributes and elements.
+*
+* @param documentFragment element `data.content` obtained from clipboard.
+* @internal
+*/
 export declare function removeMSAttributes(documentFragment: ViewDocumentFragment): void;

package/dist/filters/removestyleblock.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removestyleblock
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removestyleblock
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Removes `<style>` block added by Google Sheets to a copied content.
- *
- * @param documentFragment element `data.content` obtained from clipboard
- * @internal
- */
+* Removes `<style>` block added by Google Sheets to a copied content.
+*
+* @param documentFragment element `data.content` obtained from clipboard
+* @internal
+*/
 export declare function removeStyleBlock(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/removexmlns.d.ts

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/removexmlns
- */
-import type { ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/removexmlns
+*/
+import type { ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
 /**
- * Removes the `xmlns` attribute from table pasted from Google Sheets.
- *
- * @param documentFragment element `data.content` obtained from clipboard
- * @internal
- */
+* Removes the `xmlns` attribute from table pasted from Google Sheets.
+*
+* @param documentFragment element `data.content` obtained from clipboard
+* @internal
+*/
 export declare function removeXmlns(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/replacemsfootnotes.d.ts

@@ -1,54 +1,57 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/replacemsfootnotes
- */
-import type { ViewDocumentFragment, ViewUpcastWriter } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/replacemsfootnotes
+*/
+import type { ViewDocumentFragment, ViewUpcastWriter } from "@ckeditor/ckeditor5-engine";
 /**
- * Replaces MS Word specific footnotes references and definitions with proper elements.
- *
- * Things to know about MS Word footnotes:
- *
- * * Footnote references in Word are marked with `mso-footnote-id` style.
- * * Word does not support nested footnotes, so references within definitions are ignored.
- * * Word appends extra spaces after footnote references within definitions, which are trimmed.
- * * Footnote definitions list is marked with `mso-element: footnote-list` style it contain `mso-element: footnote` elements.
- * * Footnote definition might contain tables, lists and other elements, not only text. They are placed directly within `li` element,
- * without any wrapper (in opposition to text content of the definition, which is placed within `MsoFootnoteText` element).
- *
- * Example pseudo document showing MS Word footnote structure:
- *
- * ```html
- * <p>Text with footnote<a style='mso-footnote-id:ftn1'>[1]</a> reference.</p>
- *
- * <div style='mso-element:footnote-list'>
- * 	<div style='mso-element:footnote' id=ftn1>
- * 		<p class=MsoFootnoteText><a style='mso-footnote-id:ftn1'>[1]</a> Footnote content</p>
- * 		<table class="MsoTableGrid">...</table>
- * 	</div>
- * </div>
- * ```
- *
- * Will be transformed into:
- *
- * ```html
- * <p>Text with footnote<sup class="footnote"><a id="ref-footnote-ftn1" href="#footnote-ftn1">1</a></sup> reference.</p>
- *
- * <ol class="footnotes">
- * 	<li class="footnote-definition" id="footnote-ftn1">
- * 		<a href="#ref-footnote-ftn1" class="footnote-backlink">^</a>
- * 		<div class="footnote-content">
- * 			<p>Footnote content</p>
- * 			<table>...</table>
- * 		</div>
- * 	</li>
- * </ol>
- * ```
- *
- * @param documentFragment `data.content` obtained from clipboard.
- * @param writer The view writer instance.
- * @internal
- */
+* Replaces MS Word specific footnotes references and definitions with proper elements.
+*
+* Things to know about MS Word footnotes:
+*
+* * Footnote references in Word are marked with `mso-footnote-id` style.
+* * Word does not support nested footnotes, so references within definitions are ignored.
+* * Word appends extra spaces after footnote references within definitions, which are trimmed.
+* * Footnote definitions list is marked with `mso-element: footnote-list` style it contain `mso-element: footnote` elements.
+* * Footnote definition might contain tables, lists and other elements, not only text. They are placed directly within `li` element,
+* without any wrapper (in opposition to text content of the definition, which is placed within `MsoFootnoteText` element).
+*
+* Example pseudo document showing MS Word footnote structure:
+*
+* ```html
+* <p>Text with footnote<a style='mso-footnote-id:ftn1'>[1]</a> reference.</p>
+*
+* <div style='mso-element:footnote-list'>
+* 	<div style='mso-element:footnote' id=ftn1>
+* 		<p class=MsoFootnoteText><a style='mso-footnote-id:ftn1'>[1]</a> Footnote content</p>
+* 		<table class="MsoTableGrid">...</table>
+* 	</div>
+* </div>
+* ```
+*
+* Will be transformed into:
+*
+* ```html
+* <p>Text with footnote<sup class="footnote"><a id="ref-footnote-ftn1" href="#footnote-ftn1">1</a></sup> reference.</p>
+*
+* <div class="footnotes">
+* 	<hr class="footnotes-divider">
+* 	<ol class="footnotes-list">
+* 		<li class="footnote-definition" id="footnote-ftn1">
+* 			<a href="#ref-footnote-ftn1" class="footnote-backlink">^</a>
+* 			<div class="footnote-content">
+* 				<p>Footnote content</p>
+* 				<table>...</table>
+* 			</div>
+* 		</li>
+* 	</ol>
+* </div>
+* ```
+*
+* @param documentFragment `data.content` obtained from clipboard.
+* @param writer The view writer instance.
+* @internal
+*/
 export declare function replaceMSFootnotes(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/dist/filters/replacetabswithinprewithspaces.d.ts

@@ -1,24 +1,24 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/replacetabswithinprewithspaces
- */
-import type { ViewDocumentFragment, ViewUpcastWriter } from '@ckeditor/ckeditor5-engine';
+* @module paste-from-office/filters/replacetabswithinprewithspaces
+*/
+import type { ViewDocumentFragment, ViewUpcastWriter } from "@ckeditor/ckeditor5-engine";
 /**
- * Replaces tab characters with spaces in text nodes that are inside elements styled with `white-space: pre-wrap`.
- *
- * This is a workaround for incorrect detection of pre-like formatting in the DOM converter for pasted Google Docs documents.
- * When an element uses `white-space: pre-wrap`, the editor reduces tab characters to a single space, causing
- * inconsistent spacing in pasted content. This function replaces tabs with spaces to ensure visual consistency.
- * This is intended as a temporary solution.
- *
- * See: https://github.com/ckeditor/ckeditor5/issues/18995
- *
- * @param documentFragment The `data.content` element obtained from the clipboard.
- * @param writer The upcast writer used to manipulate the view structure.
- * @param tabWidth The number of spaces to replace each tab with. Defaults to 8.
- * @internal
- */
+* Replaces tab characters with spaces in text nodes that are inside elements styled with `white-space: pre-wrap`.
+*
+* This is a workaround for incorrect detection of pre-like formatting in the DOM converter for pasted Google Docs documents.
+* When an element uses `white-space: pre-wrap`, the editor reduces tab characters to a single space, causing
+* inconsistent spacing in pasted content. This function replaces tabs with spaces to ensure visual consistency.
+* This is intended as a temporary solution.
+*
+* See: https://github.com/ckeditor/ckeditor5/issues/18995
+*
+* @param documentFragment The `data.content` element obtained from the clipboard.
+* @param writer The upcast writer used to manipulate the view structure.
+* @param tabWidth The number of spaces to replace each tab with. Defaults to 8.
+* @internal
+*/
 export declare function replaceTabsWithinPreWithSpaces(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter, tabWidth: number): void;

package/dist/filters/space.d.ts

@@ -1,29 +1,29 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module paste-from-office/filters/space
- */
+* @module paste-from-office/filters/space
+*/
 /**
- * Replaces last space preceding elements closing tag with ` `. Such operation prevents spaces from being removed
- * during further DOM/View processing (see especially {@link module:engine/view/domconverter~ViewDomConverter#_processDomInlineNodes}).
- * This method also takes into account Word specific `<o:p></o:p>` empty tags.
- * Additionally multiline sequences of spaces and new lines between tags are removed (see
- * https://github.com/ckeditor/ckeditor5-paste-from-office/issues/39
- * and https://github.com/ckeditor/ckeditor5-paste-from-office/issues/40).
- *
- * @param htmlString HTML string in which spacing should be normalized.
- * @returns Input HTML with spaces normalized.
- * @internal
- */
+* Replaces last space preceding elements closing tag with `&nbsp;`. Such operation prevents spaces from being removed
+* during further DOM/View processing (see especially {@link module:engine/view/domconverter~ViewDomConverter#_processDomInlineNodes}).
+* This method also takes into account Word specific `<o:p></o:p>` empty tags.
+* Additionally multiline sequences of spaces and new lines between tags are removed (see
+* https://github.com/ckeditor/ckeditor5-paste-from-office/issues/39
+* and https://github.com/ckeditor/ckeditor5-paste-from-office/issues/40).
+*
+* @param htmlString HTML string in which spacing should be normalized.
+* @returns Input HTML with spaces normalized.
+* @internal
+*/
 export declare function normalizeSpacing(htmlString: string): string;
 /**
- * Normalizes spacing in special Word `spacerun spans` (`<span style='mso-spacerun:yes'>\s+</span>`) by replacing
- * all spaces with `&nbsp; ` pairs. This prevents spaces from being removed during further DOM/View processing
- * (see especially {@link module:engine/view/domconverter~ViewDomConverter#_processDomInlineNodes}).
- *
- * @param htmlDocument Native `Document` object in which spacing should be normalized.
- * @internal
- */
+* Normalizes spacing in special Word `spacerun spans` (`<span style='mso-spacerun:yes'>\s+</span>`) by replacing
+* all spaces with `&nbsp; ` pairs. This prevents spaces from being removed during further DOM/View processing
+* (see especially {@link module:engine/view/domconverter~ViewDomConverter#_processDomInlineNodes}).
+*
+* @param htmlDocument Native `Document` object in which spacing should be normalized.
+* @internal
+*/
 export declare function normalizeSpacerunSpans(htmlDocument: Document): void;