@sd-angular/core 19.0.0-beta.3 → 19.0.0-beta.30

package/assets/scss/ckeditor5.scss

@@ -17,15 +17,73 @@
 // Import the editor styles.
 // @import '@ckeditor/ckeditor5-editor-classic/dist/index.css';
 @import '@ckeditor/ckeditor5-essentials/dist/index.css';
+@import '@ckeditor/ckeditor5-page-break/dist/index.css';
 @import '@ckeditor/ckeditor5-autoformat/dist/index.css';
 @import '@ckeditor/ckeditor5-basic-styles/dist/index.css';
 // @import '@ckeditor/ckeditor5-block-quote/dist/index.css';
 @import '@ckeditor/ckeditor5-heading/dist/index.css';
-@import '@ckeditor/ckeditor5-image/dist/index.css';
+// @import '@ckeditor/ckeditor5-image/dist/index.css';
+@import '@ckeditor/ckeditor5-image/dist/index-editor.css';
 @import '@ckeditor/ckeditor5-indent/dist/index.css';
 @import '@ckeditor/ckeditor5-link/dist/index.css';
 @import '@ckeditor/ckeditor5-list/dist/index.css';
 // @import '@ckeditor/ckeditor5-media-embed/dist/index.css';
 @import '@ckeditor/ckeditor5-paste-from-office/dist/index.css';
-@import '@ckeditor/ckeditor5-table/dist/index.css';
+
+// hung.pham16: không sử dụng default styles của ckeditor vì server không hỗ trợ
+// @import '@ckeditor/ckeditor5-table/dist/index.css';
+@import '@ckeditor/ckeditor5-table/dist/index-editor.css';
+
 // @import '@ckeditor/ckeditor5-mention/dist/index.css';
+
+// Custom toolbar
+.ck-editor {
+  /* --- 1. GIẢM KÍCH THƯỚC ICON VÀ CHỮ --- */
+  /* Giảm cỡ chữ trong dropdown (mặc định khoảng 13px) */
+  --ck-font-size-base: 11px !important;
+
+  /* Giảm kích thước Icon (mặc định 20px) */
+  --ck-icon-size: 16px !important;
+
+  /* --- 2. TỐI ƯU KHOẢNG CÁCH (Padding/Margin) --- */
+
+  /* Giảm khoảng cách giữa các nút */
+  --ck-spacing-small: 2px !important;
+  --ck-spacing-standard: 6px !important;
+  --ck-spacing-large: 8px !important;
+
+  /*  */
+  --ck-color-table-focused-cell-background: transparent !important;
+  --ck-table-content-default-border-color: transparent !important;
+
+  //
+  --ck-insert-table-dropdown-padding: 10px;
+  --ck-insert-table-dropdown-box-height: 16px;
+  --ck-insert-table-dropdown-box-width: 16px;
+  --ck-insert-table-dropdown-box-margin: 1px;
+
+  --ck-focus-ring: 1px solid var(--ck-color-base-border);
+}
+
+/* Giảm độ cao của thanh toolbar (cho gọn) */
+.ck-toolbar {
+  min-height: 32px !important; /* Mặc định thường là 40px */
+  padding: 2px !important;
+
+  /* Làm màu nền toolbar nhạt hơn cho hiện đại */
+  background: #f8f9fa !important;
+  border-bottom: 1px solid #e0e0e0 !important;
+}
+
+.ck-toolbar__items {
+  /* Chỉnh nút bấm trong toolbar nhỏ lại */
+  > .ck-button {
+    padding: 2px 4px !important; /* Giảm padding trái phải của nút */
+    min-height: 24px !important;
+  }
+
+  /* Chỉnh lại dropdown (Heading, Font Size) cho khớp */
+  > .ck-dropdown {
+    min-height: 24px !important;
+  }
+}

package/components/avatar/index.d.ts

@@ -0,0 +1 @@
+export * from './src/avatar.component';

package/components/avatar/src/avatar.component.d.ts

@@ -0,0 +1,14 @@
+import { OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class SdAvatar implements OnInit {
+    #private;
+    src: string | undefined | null;
+    size: number;
+    isUrl: boolean;
+    initials: string;
+    bgColor: string;
+    ngOnInit(): void;
+    handleError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAvatar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdAvatar, "sd-avatar", never, { "src": { "alias": "src"; "required": true; }; "size": { "alias": "size"; "required": false; }; }, {}, never, never, true, never>;
+}

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

@@ -7,23 +7,28 @@ export declare class SdDocumentBuilder {
     option: SdDocumentBuilderOption;
     disabled: boolean;
     set _disabled(val: boolean | '' | undefined | null);
+    contentChange: EventEmitter<string>;
     Editor: typeof ClassicEditor;
     config: SdEditorConfig;
-    contentChange: EventEmitter<string>;
     ngOnInit(): void;
     ngOnDestroy(): void;
     onReady(editor: ClassicEditor): void;
-    scrollToComment: (markerId: string) => void;
     setContent: (html: string) => void;
     getContent: () => string;
     setOrientation: (orientation: "PORTRAIT" | "LANDSCAPE") => void;
     getOrientation: () => "PORTRAIT" | "LANDSCAPE";
-    getVariables: () => SdDocumentBuilderVariable[];
-    getComments(): SdDocumentBuilderComment[];
     scrollToTop(): void;
     heading: {
-        getHeadings: () => SdDocumentBuilderHeading[];
-        scrollToHeading: (id: string) => void;
+        /**
+         * Lấy tất cả headings trong document
+         * @returns Danh sách tất cả headings
+         */
+        all: () => SdDocumentBuilderHeading[];
+        /**
+         * Scroll tới vị trí của heading
+         * @param id - ID của heading cần scroll tới
+         */
+        scroll: (id: string) => void;
     };
     comment: {
         /**
@@ -37,7 +42,10 @@ export declare class SdDocumentBuilder {
          * @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;
+        add: <T = any>(range: ModelRange, comment: string, args?: {
+            markerIdExternal?: string | number;
+            data?: T;
+        }) => SdDocumentBuilderComment<T> | null;
         /**
          * Cập nhật nội dung comment
          * @param markerId - ID của marker
@@ -63,6 +71,18 @@ export declare class SdDocumentBuilder {
          */
         scroll: (markerId: string) => void;
     };
+    variable: {
+        /**
+         * Lấy tất cả variabes trong document
+         * @returns Danh sách tất cả variables
+         */
+        all: <T = any>() => SdDocumentBuilderVariable<T>[];
+        /**
+         * 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;
+    };
     /**
      * Xuất file Word có Header/Footer
      * @param fileName Tên file
@@ -76,6 +96,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.config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cấu hình màu cho Document Builder
+ * Bảng màu tập trung và cấu hình cho việc lựa chọn màu nhất quán
+ */
+import { ColorPickerConfig, FontColorConfig, FontSizeConfig, HeadingConfig } from 'ckeditor5';
+/**
+ * Trả về bảng màu chung được sử dụng trong tất cả tính năng của document builder
+ * @returns Mảng các tùy chọn màu được định sẵn với giá trị hex và label
+ */
+export declare function getPresetColors(): FontColorConfig['colors'];
+/**
+ * Trả về cấu hình bộ chọn màu với định dạng hex
+ * @returns Đối tượng cấu hình bộ chọn màu
+ */
+export declare function getColorPickerConfig(): ColorPickerConfig;
+/**
+ * Trả về cấu hình kích thước font cho document builder
+ * @returns Mảng các tùy chọn kích thước font được định sẵn
+ */
+export declare function getFontSizeOptions(): FontSizeConfig['options'];
+export declare function getHeadingOptions(): HeadingConfig['options'];

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

@@ -1,21 +1,27 @@
-import { EditorConfig, EventInfo, ModelDocumentSelection, ModelRange } from 'ckeditor5';
+import { EditorConfig, EventInfo, ModelDocumentSelection, ModelRange, ViewDataTransfer } from 'ckeditor5';
 export type SdEditorConfig = EditorConfig & {
     getOption?: () => SdDocumentBuilderOption;
 };
 export interface SdDocumentBuilderOption {
     onDropVariable?: (variable: SdDocumentBuilderVariable, dropIndex: number) => boolean | Promise<boolean | SdDocumentBuilderVariable>;
-    onAddComment?: (range: ModelRange) => void;
+    onAddComment?: (selectedComment: SdDocumentBuilderSelectedComment) => void;
     onSelectComment?: (markerId: string) => void;
     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> {
     id: string;
+    uuid?: string;
     value: string;
     display: string;
     data?: T;
 }
+export interface SdDocumentBuilderSelectedComment {
+    range: ModelRange;
+    selectedText: string;
+}
 export interface SdDocumentBuilderComment<T = any> {
     markerId: string;
     selectedText: string;
@@ -29,3 +35,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/document-builder.utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Document Builder Utilities
+ * Các hàm tiện ích cho document builder
+ */
+/**
+ * Chuẩn hóa nội dung bằng cách chuyển đổi tất cả màu HSL và RGB sang hex
+ * @param content - Nội dung HTML cần chuẩn hóa
+ * @returns Nội dung đã được chuẩn hóa với màu hex
+ */
+export declare function normalize(content: string): string;

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/heading/heading.plugin.d.ts

@@ -0,0 +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/{image-upload.plugin.d.ts → image-upload/image-upload.plugin.d.ts}

@@ -1,8 +1,4 @@
 import { Plugin } from 'ckeditor5';
-/**
- * Custom base64 upload adapter plugin for CKEditor 5.
- * Converts uploaded images to base64 data URLs instead of uploading to a server.
- */
 export declare class ImageUploadPlugin extends Plugin {
     static get pluginName(): "ImageUploadPlugin";
     init(): void;

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

@@ -1,5 +1,10 @@
-export * from './page-orientation.plugin';
-export * from './comment.plugin';
-export * from './variable.plugin';
-export * from './table-fit.plugin';
-export * from './image-upload.plugin';
+export * from './heading/heading.plugin';
+export * from './comment/comment.plugin';
+export * from './variable/variable.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';

package/components/document-builder/src/plugins/{page-orientation.plugin.d.ts → 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;