@ckeditor/ckeditor5-clipboard 41.3.1 → 41.4.0

package/dist/types/clipboardpipeline.d.ts

@@ -0,0 +1,269 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/clipboardpipeline
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import type { DataTransfer, DocumentFragment, Range, ViewDocumentFragment, ViewRange, Selection, DocumentSelection } from '@ckeditor/ckeditor5-engine';
+import ClipboardMarkersUtils from './clipboardmarkersutils.js';
+/**
+ * The clipboard pipeline feature. It is responsible for intercepting the `paste` and `drop` events and
+ * passing the pasted content through a series of events in order to insert it into the editor's content.
+ * It also handles the `cut` and `copy` events to fill the native clipboard with the serialized editor's data.
+ *
+ * # Input pipeline
+ *
+ * The behavior of the default handlers (all at a `low` priority):
+ *
+ * ## Event: `paste` or `drop`
+ *
+ * 1. Translates the event data.
+ * 2. Fires the {@link module:engine/view/document~Document#event:clipboardInput `view.Document#clipboardInput`} event.
+ *
+ * ## Event: `view.Document#clipboardInput`
+ *
+ * 1. If the `data.content` event field is already set (by some listener on a higher priority), it takes this content and fires the event
+ *    from the last point.
+ * 2. Otherwise, it retrieves `text/html` or `text/plain` from `data.dataTransfer`.
+ * 3. Normalizes the raw data by applying simple filters on string data.
+ * 4. Processes the raw data to {@link module:engine/view/documentfragment~DocumentFragment `view.DocumentFragment`} with the
+ *    {@link module:engine/controller/datacontroller~DataController#htmlProcessor `DataController#htmlProcessor`}.
+ * 5. Fires the {@link module:clipboard/clipboardpipeline~ClipboardPipeline#event:inputTransformation
+ *   `ClipboardPipeline#inputTransformation`} event with the view document fragment in the `data.content` event field.
+ *
+ * ## Event: `ClipboardPipeline#inputTransformation`
+ *
+ * 1. Converts {@link module:engine/view/documentfragment~DocumentFragment `view.DocumentFragment`} from the `data.content` field to
+ *    {@link module:engine/model/documentfragment~DocumentFragment `model.DocumentFragment`}.
+ * 2. Fires the {@link module:clipboard/clipboardpipeline~ClipboardPipeline#event:contentInsertion `ClipboardPipeline#contentInsertion`}
+ *    event with the model document fragment in the `data.content` event field.
+ *    **Note**: The `ClipboardPipeline#contentInsertion` event is fired within a model change block to allow other handlers
+ *    to run in the same block without post-fixers called in between (i.e., the selection post-fixer).
+ *
+ * ## Event: `ClipboardPipeline#contentInsertion`
+ *
+ * 1. Calls {@link module:engine/model/model~Model#insertContent `model.insertContent()`} to insert `data.content`
+ *    at the current selection position.
+ *
+ * # Output pipeline
+ *
+ * The behavior of the default handlers (all at a `low` priority):
+ *
+ * ## Event: `copy`, `cut` or `dragstart`
+ *
+ * 1. Retrieves the selected {@link module:engine/model/documentfragment~DocumentFragment `model.DocumentFragment`} by calling
+ *    {@link module:engine/model/model~Model#getSelectedContent `model#getSelectedContent()`}.
+ * 2. Converts the model document fragment to {@link module:engine/view/documentfragment~DocumentFragment `view.DocumentFragment`}.
+ * 3. Fires the {@link module:engine/view/document~Document#event:clipboardOutput `view.Document#clipboardOutput`} event
+ *    with the view document fragment in the `data.content` event field.
+ *
+ * ## Event: `view.Document#clipboardOutput`
+ *
+ * 1. Processes `data.content` to HTML and plain text with the
+ *    {@link module:engine/controller/datacontroller~DataController#htmlProcessor `DataController#htmlProcessor`}.
+ * 2. Updates the `data.dataTransfer` data for `text/html` and `text/plain` with the processed data.
+ * 3. For the `cut` method, calls {@link module:engine/model/model~Model#deleteContent `model.deleteContent()`}
+ *    on the current selection.
+ *
+ * Read more about the clipboard integration in the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+ */
+export default class ClipboardPipeline extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "ClipboardPipeline";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ClipboardMarkersUtils];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Fires Clipboard `'outputTransformation'` event for given parameters.
+     *
+     * @internal
+     */
+    _fireOutputTransformationEvent(dataTransfer: DataTransfer, selection: Selection | DocumentSelection, method: 'copy' | 'cut' | 'dragstart'): void;
+    /**
+     * The clipboard paste pipeline.
+     */
+    private _setupPasteDrop;
+    /**
+     * The clipboard copy/cut pipeline.
+     */
+    private _setupCopyCut;
+}
+/**
+ * Fired with the `content`, `dataTransfer`, `method`, and `targetRanges` properties:
+ *
+ * * The `content` which comes from the clipboard (it was pasted or dropped) should be processed in order to be inserted into the editor.
+ * * The `dataTransfer` object is available in case the transformation functions need access to the raw clipboard data.
+ * * The `method` indicates the original DOM event (for example `'drop'` or `'paste'`).
+ * * The `targetRanges` property is an array of view ranges (it is available only for `'drop'`).
+ *
+ * It is a part of the {@glink framework/deep-dive/clipboard#input-pipeline clipboard input pipeline}.
+ *
+ * **Note**: You should not stop this event if you want to change the input data. You should modify the `content` property instead.
+ *
+ * @see module:clipboard/clipboardobserver~ClipboardObserver
+ * @see module:clipboard/clipboardpipeline~ClipboardPipeline
+ *
+ * @eventName ~ClipboardPipeline#inputTransformation
+ * @param data The event data.
+ */
+export type ClipboardInputTransformationEvent = {
+    name: 'inputTransformation';
+    args: [data: ClipboardInputTransformationData];
+};
+/**
+ * The data of 'inputTransformation' event.
+ */
+export interface ClipboardInputTransformationData {
+    /**
+     * The event data.
+     * The content to be inserted into the editor. It can be modified by event listeners. Read more about the clipboard pipelines in
+     * the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+     */
+    content: ViewDocumentFragment;
+    /**
+     * The data transfer instance.
+     */
+    dataTransfer: DataTransfer;
+    /**
+     * The target drop ranges.
+     */
+    targetRanges: Array<ViewRange> | null;
+    /**
+     * Whether the event was triggered by a paste or a drop operation.
+     */
+    method: 'paste' | 'drop';
+}
+/**
+ * Fired with the `content`, `dataTransfer`, `method`, and `targetRanges` properties:
+ *
+ * * The `content` which comes from the clipboard (was pasted or dropped) should be processed in order to be inserted into the editor.
+ * * The `dataTransfer` object is available in case the transformation functions need access to the raw clipboard data.
+ * * The `method` indicates the original DOM event (for example `'drop'` or `'paste'`).
+ * * The `targetRanges` property is an array of view ranges (it is available only for `'drop'`).
+ *
+ * Event handlers can modify the content according to the final insertion position.
+ *
+ * It is a part of the {@glink framework/deep-dive/clipboard#input-pipeline clipboard input pipeline}.
+ *
+ * **Note**: You should not stop this event if you want to change the input data. You should modify the `content` property instead.
+ *
+ * @see module:clipboard/clipboardobserver~ClipboardObserver
+ * @see module:clipboard/clipboardpipeline~ClipboardPipeline
+ * @see module:clipboard/clipboardpipeline~ClipboardPipeline#event:inputTransformation
+ *
+ * @eventName ~ClipboardPipeline#contentInsertion
+ * @param data The event data.
+ */
+export type ClipboardContentInsertionEvent = {
+    name: 'contentInsertion';
+    args: [data: ClipboardContentInsertionData];
+};
+/**
+ * The data of 'contentInsertion' event.
+ */
+export interface ClipboardContentInsertionData {
+    /**
+     * The content to be inserted into the editor.
+     * Read more about the clipboard pipelines in the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+     */
+    content: DocumentFragment;
+    /**
+     * Whether the event was triggered by a paste or a drop operation.
+     */
+    method: 'paste' | 'drop';
+    /**
+     * The data transfer instance.
+     */
+    dataTransfer: DataTransfer;
+    /**
+     * The target drop ranges.
+     */
+    targetRanges: Array<ViewRange> | null;
+    /**
+     * The result of the `model.insertContent()` call
+     * (inserted by the event handler at a low priority).
+     */
+    resultRange?: Range;
+}
+/**
+ * Fired on {@link module:engine/view/document~Document#event:copy} and {@link module:engine/view/document~Document#event:cut}
+ * with a copy of the selected content. The content can be processed before it ends up in the clipboard.
+ *
+ * It is a part of the {@glink framework/deep-dive/clipboard#output-pipeline clipboard output pipeline}.
+ *
+ * @see module:clipboard/clipboardobserver~ClipboardObserver
+ * @see module:clipboard/clipboardpipeline~ClipboardPipeline
+ *
+ * @eventName module:engine/view/document~Document#clipboardOutput
+ * @param data The event data.
+ */
+export type ViewDocumentClipboardOutputEvent = {
+    name: 'clipboardOutput';
+    args: [data: ViewDocumentClipboardOutputEventData];
+};
+/**
+ * The value of the 'clipboardOutput' event.
+ */
+export interface ViewDocumentClipboardOutputEventData {
+    /**
+     * The data transfer instance.
+     *
+     * @readonly
+     */
+    dataTransfer: DataTransfer;
+    /**
+     * Content to be put into the clipboard. It can be modified by the event listeners.
+     * Read more about the clipboard pipelines in the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+     */
+    content: ViewDocumentFragment;
+    /**
+     * Whether the event was triggered by a copy or cut operation.
+     */
+    method: 'copy' | 'cut' | 'dragstart';
+}
+/**
+ * Fired on {@link module:engine/view/document~Document#event:copy}, {@link module:engine/view/document~Document#event:cut}
+ * and {@link module:engine/view/document~Document#event:dragstart}. The content can be processed before it ends up in the clipboard.
+ *
+ * It is a part of the {@glink framework/deep-dive/clipboard#output-pipeline clipboard output pipeline}.
+ *
+ * @eventName ~ClipboardPipeline#outputTransformation
+ * @param data The event data.
+ */
+export type ClipboardOutputTransformationEvent = {
+    name: 'outputTransformation';
+    args: [data: ClipboardOutputTransformationData];
+};
+/**
+ * The value of the 'outputTransformation' event.
+ */
+export interface ClipboardOutputTransformationData {
+    /**
+     * The data transfer instance.
+     *
+     * @readonly
+     */
+    dataTransfer: DataTransfer;
+    /**
+     * Content to be put into the clipboard. It can be modified by the event listeners.
+     * Read more about the clipboard pipelines in the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+     */
+    content: DocumentFragment;
+    /**
+     * Whether the event was triggered by a copy or cut operation.
+     */
+    method: 'copy' | 'cut' | 'dragstart';
+}

package/dist/types/dragdrop.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/dragdrop
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import { Widget } from '@ckeditor/ckeditor5-widget';
+import ClipboardPipeline from './clipboardpipeline.js';
+import DragDropTarget from './dragdroptarget.js';
+import DragDropBlockToolbar from './dragdropblocktoolbar.js';
+import '../theme/clipboard.css';
+/**
+ * The drag and drop feature. It works on top of the {@link module:clipboard/clipboardpipeline~ClipboardPipeline}.
+ *
+ * Read more about the clipboard integration in the {@glink framework/deep-dive/clipboard clipboard deep-dive} guide.
+ *
+ * @internal
+ */
+export default class DragDrop extends Plugin {
+    /**
+     * The live range over the original content that is being dragged.
+     */
+    private _draggedRange;
+    /**
+     * The UID of current dragging that is used to verify if the drop started in the same editor as the drag start.
+     *
+     * **Note**: This is a workaround for broken 'dragend' events (they are not fired if the source text node got removed).
+     */
+    private _draggingUid;
+    /**
+     * The reference to the model element that currently has a `draggable` attribute set (it is set while dragging).
+     */
+    private _draggableElement;
+    /**
+     * A delayed callback removing draggable attributes.
+     */
+    private _clearDraggableAttributesDelayed;
+    /**
+     * Whether the dragged content can be dropped only in block context.
+     */
+    private _blockMode;
+    /**
+     * DOM Emitter.
+     */
+    private _domEmitter;
+    /**
+     * The DOM element used to generate dragged preview image.
+     */
+    private _previewContainer?;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "DragDrop";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ClipboardPipeline, typeof Widget, typeof DragDropTarget, typeof DragDropBlockToolbar];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * Drag and drop events handling.
+     */
+    private _setupDragging;
+    /**
+     * Integration with the `clipboardInput` event.
+     */
+    private _setupClipboardInputIntegration;
+    /**
+     * Integration with the `contentInsertion` event of the clipboard pipeline.
+     */
+    private _setupContentInsertionIntegration;
+    /**
+     * Adds listeners that add the `draggable` attribute to the elements while the mouse button is down so the dragging could start.
+     */
+    private _setupDraggableAttributeHandling;
+    /**
+     * Removes the `draggable` attribute from the element that was used for dragging.
+     */
+    private _clearDraggableAttributes;
+    /**
+     * Deletes the dragged content from its original range and clears the dragging state.
+     *
+     * @param moved Whether the move succeeded.
+     */
+    private _finalizeDragging;
+    /**
+     * Sets the dragged source range based on event target and document selection.
+     */
+    private _prepareDraggedRange;
+    /**
+     * Updates the dragged preview image.
+     */
+    private _updatePreview;
+}

package/dist/types/dragdropblocktoolbar.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/dragdropblocktoolbar
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+/**
+ * Integration of a block Drag and Drop support with the block toolbar.
+ *
+ * @internal
+ */
+export default class DragDropBlockToolbar extends Plugin {
+    /**
+     * Whether current dragging is started by block toolbar button dragging.
+     */
+    private _isBlockDragging;
+    /**
+     * DOM Emitter.
+     */
+    private _domEmitter;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "DragDropBlockToolbar";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * The `dragstart` event handler.
+     */
+    private _handleBlockDragStart;
+    /**
+     * The `dragover` and `drop` event handler.
+     */
+    private _handleBlockDragging;
+    /**
+     * The `dragend` event handler.
+     */
+    private _handleBlockDragEnd;
+}

package/dist/types/dragdroptarget.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/dragdroptarget
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import { type Range, type LiveRange, type ViewElement, type ViewRange } from '@ckeditor/ckeditor5-engine';
+/**
+ * Part of the Drag and Drop handling. Responsible for finding and displaying the drop target.
+ *
+ * @internal
+ */
+export default class DragDropTarget extends Plugin {
+    /**
+     * A delayed callback removing the drop marker.
+     *
+     * @internal
+     */
+    readonly removeDropMarkerDelayed: import("@ckeditor/ckeditor5-utils").DelayedFunc<() => void>;
+    /**
+     * A throttled callback updating the drop marker.
+     */
+    private readonly _updateDropMarkerThrottled;
+    /**
+     * A throttled callback reconverting the drop parker.
+     */
+    private readonly _reconvertMarkerThrottled;
+    /**
+     * The horizontal drop target line view.
+     */
+    private _dropTargetLineView;
+    /**
+     * DOM Emitter.
+     */
+    private _domEmitter;
+    /**
+     * Map of document scrollable elements.
+     */
+    private _scrollables;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "DragDropTarget";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * Finds the drop target range and updates the drop marker.
+     *
+     * @internal
+     */
+    updateDropMarker(targetViewElement: ViewElement, targetViewRanges: Array<ViewRange> | null, clientX: number, clientY: number, blockMode: boolean, draggedRange: LiveRange | null): void;
+    /**
+     * Finds the final drop target range.
+     *
+     * @internal
+     */
+    getFinalDropRange(targetViewElement: ViewElement, targetViewRanges: Array<ViewRange> | null, clientX: number, clientY: number, blockMode: boolean, draggedRange: LiveRange | null): Range | null;
+    /**
+     * Removes the drop target marker.
+     *
+     * @internal
+     */
+    removeDropMarker(): void;
+    /**
+     * Creates downcast conversion for the drop target marker.
+     */
+    private _setupDropMarker;
+    /**
+     * Updates the drop target marker to the provided range.
+     *
+     * @param targetRange The range to set the marker to.
+     */
+    private _updateDropMarker;
+    /**
+     * Creates the UI element for vertical (in-line) drop target.
+     */
+    private _createDropTargetPosition;
+    /**
+     * Updates the horizontal drop target line.
+     */
+    private _updateDropTargetLine;
+    /**
+     * Finds the closest scrollable element rect for the given view element.
+     */
+    private _getScrollableRect;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard
+ */
+export { default as Clipboard } from './clipboard.js';
+export { default as ClipboardPipeline, type ClipboardContentInsertionEvent, type ClipboardContentInsertionData, type ClipboardInputTransformationEvent, type ClipboardInputTransformationData, type ClipboardOutputTransformationEvent, type ClipboardOutputTransformationData, type ViewDocumentClipboardOutputEvent } from './clipboardpipeline.js';
+export { default as ClipboardMarkersUtils, type ClipboardMarkerRestrictedAction, type ClipboardMarkerConfiguration } from './clipboardmarkersutils.js';
+export type { ClipboardEventData } from './clipboardobserver.js';
+export { default as DragDrop } from './dragdrop.js';
+export { default as PastePlainText } from './pasteplaintext.js';
+export { default as DragDropTarget } from './dragdroptarget.js';
+export { default as DragDropBlockToolbar } from './dragdropblocktoolbar.js';
+export type { ViewDocumentClipboardInputEvent, ViewDocumentCopyEvent, ViewDocumentCutEvent } from './clipboardobserver.js';
+import './augmentation.js';

package/dist/types/lineview.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/lineview
+ */
+import { View } from '@ckeditor/ckeditor5-ui';
+/**
+ * The horizontal drop target line view.
+ */
+export default class LineView extends View {
+    /**
+     * Controls whether the line is visible.
+     *
+     * @observable
+     * @default false
+     */
+    isVisible: boolean;
+    /**
+     * Controls the line position x coordinate.
+     *
+     * @observable
+     * @default null
+     */
+    left: number | null;
+    /**
+     * Controls the line width.
+     *
+     * @observable
+     * @default null
+     */
+    width: number | null;
+    /**
+     * Controls the line position y coordinate.
+     *
+     * @observable
+     * @default null
+     */
+    top: number | null;
+    /**
+     * @inheritDoc
+     */
+    constructor();
+}

package/dist/types/pasteplaintext.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/pasteplaintext
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import ClipboardPipeline from './clipboardpipeline.js';
+/**
+ * The plugin detects the user's intention to paste plain text.
+ *
+ * For example, it detects the <kbd>Ctrl/Cmd</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> keystroke.
+ */
+export default class PastePlainText extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "PastePlainText";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof ClipboardPipeline];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/dist/types/utils/normalizeclipboarddata.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/utils/normalizeclipboarddata
+ */
+/**
+ * Removes some popular browser quirks out of the clipboard data (HTML).
+ * Removes all HTML comments. These are considered an internal thing and it makes little sense if they leak into the editor data.
+ *
+ * @param data The HTML data to normalize.
+ * @returns Normalized HTML.
+ */
+export default function normalizeClipboardData(data: string): string;

package/dist/types/utils/plaintexttohtml.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/utils/plaintexttohtml
+ */
+/**
+ * Converts plain text to its HTML-ized version.
+ *
+ * @param text The plain text to convert.
+ * @returns HTML generated from the plain text.
+ */
+export default function plainTextToHtml(text: string): string;

package/dist/types/utils/viewtoplaintext.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module clipboard/utils/viewtoplaintext
+ */
+import type { ViewDocumentFragment, ViewItem } from '@ckeditor/ckeditor5-engine';
+/**
+ * Converts {@link module:engine/view/item~Item view item} and all of its children to plain text.
+ *
+ * @param viewItem View item to convert.
+ * @returns Plain text representation of `viewItem`.
+ */
+export default function viewToPlainText(viewItem: ViewItem | ViewDocumentFragment): string;