@sd-angular/core 19.0.0-beta.10 → 19.0.0-beta.101

package/components/document-builder/src/document-builder.component.d.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from '@angular/core';
 import { ClassicEditor, ModelRange } from 'ckeditor5';
-import { SdDocumentBuilderComment, SdDocumentBuilderHeading, SdDocumentBuilderOption, SdDocumentBuilderVariable, SdEditorConfig } from './document-builder.model';
+import { VariablePlugin, CkCommentPlugin } from './plugins';
+import { DocumentBuilderOption, SdDocumentBuilderHeading, SdDocumentBuilderOption } from './document-builder.model';
 import * as i0 from "@angular/core";
 export declare class SdDocumentBuilder {
     #private;
@@ -9,7 +10,7 @@ export declare class SdDocumentBuilder {
     set _disabled(val: boolean | '' | undefined | null);
     contentChange: EventEmitter<string>;
     Editor: typeof ClassicEditor;
-    config: SdEditorConfig;
+    config: DocumentBuilderOption;
     ngOnInit(): void;
     ngOnDestroy(): void;
     onReady(editor: ClassicEditor): void;
@@ -30,56 +31,8 @@ export declare class SdDocumentBuilder {
          */
         scroll: (id: string) => void;
     };
-    comment: {
-        /**
-         * Lấy tất cả comments trong document
-         * @returns Danh sách tất cả comments
-         */
-        all: () => SdDocumentBuilderComment[];
-        /**
-         * Thêm comment vào vùng text đang được chọn
-         * @param comment - Dữ liệu comment
-         * @param data - Dữ liệu extra data
-         * @returns SdDocumentBuilderComment hoặc null nếu không có text được chọn
-         */
-        add: <T = any>(range: ModelRange, comment: string, data?: T) => SdDocumentBuilderComment<T> | null;
-        /**
-         * Cập nhật nội dung comment
-         * @param markerId - ID của marker
-         * @param commentData - Dữ liệu mới
-         * @returns Comment đã cập nhật hoặc null
-         */
-        update: <T = any>(markerId: string, comment: string, data?: T) => SdDocumentBuilderComment<T> | null;
-        /**
-         * Lấy chi tiết comment theo markerId
-         * @param markerId - ID của marker
-         * @returns Comment hoặc null
-         */
-        detail: (markerId: string) => SdDocumentBuilderComment | null;
-        /**
-         * Xóa comment theo markerId
-         * @param markerId - ID của marker cần xóa
-         * @returns true nếu xóa thành công, false nếu không tìm thấy
-         */
-        remove: (markerId: string) => boolean;
-        /**
-         * Scroll đến vị trí comment
-         * @param markerId - ID của marker cần scroll tới
-         */
-        scroll: (markerId: string) => void;
-    };
-    variable: {
-        /**
-         * Lấy tất cả variabes trong document
-         * @returns Danh sách tất cả variables
-         */
-        all: () => SdDocumentBuilderVariable[];
-        /**
-         * Scroll tới vị trí của variable
-         * @param uuid - uuid của variable FE sẽ tự sinh sau mỗi lần drop vào editor
-         */
-        scroll: (uuid: string) => void;
-    };
+    getCommentPluginAPI(): CkCommentPlugin | null;
+    getVariablePluginAPI(): VariablePlugin | null;
     /**
      * Xuất file Word có Header/Footer
      * @param fileName Tên file
@@ -93,6 +46,8 @@ export declare class SdDocumentBuilder {
         header?: string;
         footer?: string;
     }): void;
+    hightSelectRange: (range: ModelRange) => void;
+    removeHighlightSeclectRange: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdDocumentBuilder, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SdDocumentBuilder, "sd-document-builder", never, { "option": { "alias": "option"; "required": true; }; "_disabled": { "alias": "disabled"; "required": false; }; }, { "contentChange": "contentChange"; }, never, never, true, never>;
 }

package/components/document-builder/src/document-builder.model.d.ts

@@ -1,13 +1,22 @@
-import { EditorConfig, EventInfo, ModelDocumentSelection, ModelRange } from 'ckeditor5';
-export type SdEditorConfig = EditorConfig & {
+import { EditorConfig, EventInfo, ModelDocumentSelection, ViewDataTransfer } from 'ckeditor5';
+import { I18nParams } from '@sd-angular/core/i18n';
+import { CkCommentConfig } from './plugins/ck-comment/ck-comment.plugin.model';
+/** Plain translator cho CKEditor plugin — tránh truyền thẳng I18nService (private fields mất `this` qua config). */
+export interface DocumentBuilderI18n {
+    t(key: string, params?: I18nParams): string;
+}
+export type DocumentBuilderOption = EditorConfig & {
     getOption?: () => SdDocumentBuilderOption;
+    _i18n?: DocumentBuilderI18n;
 };
 export interface SdDocumentBuilderOption {
-    onDropVariable?: (variable: SdDocumentBuilderVariable, dropIndex: number) => boolean | Promise<boolean | SdDocumentBuilderVariable>;
-    onAddComment?: (range: ModelRange) => void;
-    onSelectComment?: (markerId: string) => void;
+    onDropVariable?: (variable: SdDocumentBuilderVariable) => boolean | Promise<boolean | SdDocumentBuilderVariable>;
+    onAfterDropVariable?: (variable: SdDocumentBuilderVariable) => void;
+    onPasteVariable?: (display: string) => SdDocumentBuilderVariable | null | Promise<SdDocumentBuilderVariable | null>;
+    comment?: CkCommentConfig;
     onSelection?: (selection: ModelDocumentSelection, $event: EventInfo<string, unknown>) => void;
     onOrientation?: (orientation: 'PORTRAIT' | 'LANDSCAPE') => void;
+    onPaste?: (data: SdPasteEventData) => void | Promise<void>;
     orientation?: 'PORTRAIT' | 'LANDSCAPE';
 }
 export interface SdDocumentBuilderVariable<T = any> {
@@ -15,13 +24,7 @@ export interface SdDocumentBuilderVariable<T = any> {
     uuid?: string;
     value: string;
     display: string;
-    data?: T;
-}
-export interface SdDocumentBuilderComment<T = any> {
-    markerId: string;
-    selectedText: string;
-    comment?: string;
-    createdAt?: Date;
+    bindingValue?: string;
     data?: T;
 }
 export interface SdDocumentBuilderHeading {
@@ -30,3 +33,9 @@ export interface SdDocumentBuilderHeading {
     level: number;
     type: string;
 }
+export interface SdPasteEventData {
+    html?: string;
+    text: string;
+    source: 'word' | 'excel' | 'google-docs' | 'web' | 'unknown';
+    dataTransfer: ViewDataTransfer;
+}

package/components/document-builder/src/plugins/block-space/block-space.plugin.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from 'ckeditor5';
+/**
+ * Plugin để thêm margin-bottom: 4px cho các block elements
+ * (paragraph, heading, list, table) thông qua downcast conversion
+ */
+export declare class BlockSpace extends Plugin {
+    static get pluginName(): string;
+    init(): void;
+}

package/components/document-builder/src/plugins/ck-comment/ck-comment.plugin.d.ts

@@ -0,0 +1,44 @@
+import { Plugin, ContextualBalloon } from 'ckeditor5';
+import { CkComment, CkCommentConfig, CkCommentColors } from './ck-comment.plugin.model';
+export declare class CkCommentPlugin extends Plugin {
+    #private;
+    static get pluginName(): string;
+    static get requires(): (typeof ContextualBalloon)[];
+    static readonly PENDING_MARKER_ID = "__pending_comment__";
+    static readonly DEFAULT_SEARCH_RANGE = 5;
+    static readonly DEFAULT_MAX_TEXT_LENGTH = 1000;
+    static readonly DEFAULT_COLORS: CkCommentColors;
+    init(): void;
+    /**
+     * Thiết lập config với callbacks
+     */
+    setConfig(config: CkCommentConfig): void;
+    /**
+     * Thêm comment và tạo marker
+     */
+    addComment(comment: CkComment): boolean;
+    /**
+     * Xóa comment theo id
+     */
+    removeComment(id: string | number): boolean;
+    /**
+     * Chọn comment theo id - chỉ thêm class highlight, không bôi đen text
+     */
+    selectComment(id: string | number, scrollIntoView?: boolean): void;
+    /**
+     * Thiết lập tất cả comments (khôi phục từ dữ liệu)
+     */
+    setComments(comments: CkComment[]): void;
+    /**
+     * Lấy tất cả comments
+     */
+    get comments(): CkComment[];
+    /**
+     * Thiết lập pending highlight cho selection (khi user đang nhập nội dung comment)
+     */
+    setPendingSelection(startPath: number[], endPath: number[]): boolean;
+    /**
+     * Xóa pending highlight và fire onCancelPending callback
+     */
+    clearPendingSelection(): void;
+}

package/components/document-builder/src/plugins/ck-comment/ck-comment.plugin.model.d.ts

@@ -0,0 +1,57 @@
+import { ModelRange } from 'ckeditor5';
+/**
+ * Comment status based on text changes
+ */
+export type CkCommentStatus = 'normal' | 'modified' | 'broken';
+/**
+ * Color configuration for comment markers
+ */
+export interface CkCommentColors {
+    marker?: string;
+    markerSelected?: string;
+    markerPending?: string;
+    markerModified?: string;
+    markerBroken?: string;
+}
+/**
+ * Comment data structure for CkCommentPlugin
+ */
+export interface CkComment<T = any> {
+    id: string | number;
+    startPath: number[];
+    endPath: number[];
+    originalText: string;
+    currentText: string;
+    status: CkCommentStatus;
+    data?: T;
+}
+/**
+ * Config for CkCommentPlugin
+ */
+export interface CkCommentConfig {
+    onPendingComment?: (comment: CkComment) => void;
+    onAddComment?: (comment: CkComment) => void;
+    onSelectComment?: (id: string | number) => void;
+    onRemoveComment?: (id: string | number) => void;
+    onChange?: (comments: CkComment[]) => void;
+    onCancelPending?: () => void;
+    onError?: (error: {
+        code: string;
+        message: string;
+        data?: any;
+    }) => void;
+    searchRange?: number;
+    debug?: boolean;
+    colors?: CkCommentColors;
+    maxTextLength?: number;
+    allowCreating?: boolean;
+}
+/**
+ * Data returned when user selects text for comment
+ */
+export interface CkCommentSelection {
+    range: ModelRange;
+    startPath: number[];
+    endPath: number[];
+    text: string;
+}

package/components/document-builder/src/plugins/heading/heading.plugin.d.ts

@@ -1,4 +1,5 @@
 import { Plugin } from 'ckeditor5';
 export declare class HeadingPlugin extends Plugin {
+    static get pluginName(): string;
     init(): void;
 }

package/components/document-builder/src/plugins/highlight-range/highlight-range.plugin.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from 'ckeditor5';
+export declare class HighlightRangePlugin extends Plugin {
+    init(): void;
+}

package/components/document-builder/src/plugins/image-custom/image-custom.plugin.d.ts

@@ -0,0 +1,31 @@
+import { Plugin } from 'ckeditor5';
+export declare class ImageCustomPlugin extends Plugin {
+    static get pluginName(): "ImageCustomPlugin";
+    init(): void;
+    /**
+     * Xử lý sự kiện chèn ảnh
+     */
+    private handleImageInsert;
+    /**
+     * Xử lý sự kiện thay đổi attribute ảnh
+     */
+    private handleImageAttributeChange;
+    /**
+     * Xử lý sự kiện thay đổi style ảnh - thêm float inline style cho căn chỉnh
+     */
+    private handleImageStyleChange;
+    /**
+     * Áp dụng custom styles cho element ảnh
+     */
+    private applyCustomStyles;
+    /**
+     * Tìm container ck-widget (element figure)
+     * CKEditor wrap ảnh block trong <figure class="ck-widget"><img></figure>
+     */
+    private findWidgetElement;
+    /**
+     * Tìm element img thực tế bên trong widget structure
+     * CKEditor wrap ảnh block trong <figure class="ck-widget"><img></figure>
+     */
+    private findImgElement;
+}

package/components/document-builder/src/plugins/index.d.ts

@@ -1,6 +1,11 @@
 export * from './heading/heading.plugin';
-export * from './comment/comment.plugin';
 export * from './variable/variable.plugin';
-export * from './table-fit/table-fit.plugin';
+export * from './table-custom';
 export * from './image-upload/image-upload.plugin';
+export * from './image-custom/image-custom.plugin';
 export * from './page-orientation/page-orientation.plugin';
+export * from './paste-handler';
+export * from './highlight-range/highlight-range.plugin';
+export * from './block-space/block-space.plugin';
+export * from './ck-comment/ck-comment.plugin';
+export * from './ck-comment/ck-comment.plugin.model';

package/components/document-builder/src/plugins/page-orientation/page-orientation.plugin.d.ts

@@ -1,6 +1,6 @@
 import { Plugin } from 'ckeditor5';
-export declare class PageOrientationPlugin extends Plugin {
-    static readonly pluginName = "PageOrientationPlugin";
+export declare class PageOrientation extends Plugin {
+    static readonly pluginName = "PageOrientation";
     private _currentOrientation;
     private orientationChangeEmitter?;
     private buttonView?;

package/components/document-builder/src/plugins/paste-handler/filters/bookmark.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/bookmark
+ */
+import { type ViewUpcastWriter, type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * Transforms `<a>` elements which are bookmarks by moving their children after the element.
+ *
+ * @internal
+ */
+export declare function transformBookmarks(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/components/document-builder/src/plugins/paste-handler/filters/br.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/br
+ */
+import { type ViewUpcastWriter, type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/image.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/image
+ */
+import { type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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.
+ */
+export declare function _convertHexToBase64(hexString: string): string;

package/components/document-builder/src/plugins/paste-handler/filters/list.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/list
+ */
+import { ViewUpcastWriter, type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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.
+ * @internal
+ */
+export declare function transformListItemLikeElementsIntoLists(documentFragment: ViewDocumentFragment, stylesString: string, hasMultiLevelListPlugin: boolean): void;
+/**
+ * Removes paragraph wrapping content inside a list item.
+ *
+ * @internal
+ */
+export declare function unwrapParagraphInListItem(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/components/document-builder/src/plugins/paste-handler/filters/parse.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/parse
+ */
+import { type StylesProcessor, type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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}.
+ */
+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;
+}

package/components/document-builder/src/plugins/paste-handler/filters/removeboldwrapper.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removeboldwrapper
+ */
+import type { ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/removegooglesheetstag.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removegooglesheetstag
+ */
+import type { ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/removeinvalidtablewidth.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removeinvalidtablewidth
+ */
+import type { ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/removemsattributes.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removemsattributes
+ */
+import { type ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/removestyleblock.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removestyleblock
+ */
+import type { ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/removexmlns.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/removexmlns
+ */
+import type { ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/replacemsfootnotes.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @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 'ckeditor5';
+/**
+ * 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
+ */
+export declare function replaceMSFootnotes(documentFragment: ViewDocumentFragment, writer: ViewUpcastWriter): void;

package/components/document-builder/src/plugins/paste-handler/filters/replacetabswithinprewithspaces.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module paste-from-office/filters/replacetabswithinprewithspaces
+ */
+import type { ViewDocumentFragment, ViewUpcastWriter } from 'ckeditor5';
+/**
+ * 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/components/document-builder/src/plugins/paste-handler/filters/space.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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
+ */
+/**
+ * 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 #39 and #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
+ */
+export declare function normalizeSpacerunSpans(htmlDocument: Document): void;