@ckeditor/ckeditor5-clipboard 44.1.0 → 44.2.0-alpha.1

package/dist/dragdrop.d.ts

@@ -1,110 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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 isOfficialPlugin(): true;
-    /**
-     * @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/dragdropblocktoolbar.d.ts

@@ -1,55 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @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/dragdroptarget.d.ts

@@ -1,102 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @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/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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 { default as plainTextToHtml } from './utils/plaintexttohtml.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/lineview.d.ts

@@ -1,49 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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/pasteplaintext.d.ts

@@ -1,36 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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 isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ClipboardPipeline];
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-}

package/dist/utils/normalizeclipboarddata.d.ts

@@ -1,19 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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/utils/plaintexttohtml.d.ts

@@ -1,18 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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/utils/viewtoplaintext.d.ts

@@ -1,19 +0,0 @@
-/**
- * @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-licensing-options
- */
-/**
- * @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;