@ckeditor/ckeditor5-clipboard 0.0.0-nightly-next-20260105.0 → 0.0.0-nightly-next-20260106.0

package/src/clipboardpipeline.js

@@ -1,287 +0,0 @@
-/**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module clipboard/clipboardpipeline
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { EventInfo } from '@ckeditor/ckeditor5-utils';
-import { ClipboardObserver } from './clipboardobserver.js';
-import { plainTextToHtml } from './utils/plaintexttohtml.js';
-import { normalizeClipboardData } from './utils/normalizeclipboarddata.js';
-import { viewToPlainText } from './utils/viewtoplaintext.js';
-import { ClipboardMarkersUtils } from './clipboardmarkersutils.js';
-// Input pipeline events overview:
-//
-//              ┌──────────────────────┐          ┌──────────────────────┐
-//              │     view.Document    │          │     view.Document    │
-//              │         paste        │          │         drop         │
-//              └───────────┬──────────┘          └───────────┬──────────┘
-//                          │                                 │
-//                          └────────────────┌────────────────┘
-//                                           │
-//                                 ┌─────────V────────┐
-//                                 │   view.Document  │   Retrieves text/html or text/plain from data.dataTransfer
-//                                 │  clipboardInput  │   and processes it to view.DocumentFragment.
-//                                 └─────────┬────────┘
-//                                           │
-//                               ┌───────────V───────────┐
-//                               │   ClipboardPipeline   │   Converts view.DocumentFragment to model.DocumentFragment.
-//                               │  inputTransformation  │
-//                               └───────────┬───────────┘
-//                                           │
-//                                ┌──────────V──────────┐
-//                                │  ClipboardPipeline  │   Calls model.insertContent().
-//                                │   contentInsertion  │
-//                                └─────────────────────┘
-//
-//
-// Output pipeline events overview:
-//
-//              ┌──────────────────────┐          ┌──────────────────────┐
-//              │     view.Document    │          │     view.Document    │   Retrieves the selected model.DocumentFragment
-//              │         copy         │          │          cut         │   and fires the `outputTransformation` event.
-//              └───────────┬──────────┘          └───────────┬──────────┘
-//                          │                                 │
-//                          └────────────────┌────────────────┘
-//                                           │
-//                               ┌───────────V───────────┐
-//                               │   ClipboardPipeline   │   Processes model.DocumentFragment and converts it to
-//                               │  outputTransformation │   view.DocumentFragment.
-//                               └───────────┬───────────┘
-//                                           │
-//                                 ┌─────────V────────┐
-//                                 │   view.Document  │   Processes view.DocumentFragment to text/html and text/plain
-//                                 │  clipboardOutput │   and stores the results in data.dataTransfer.
-//                                 └──────────────────┘
-//
-/**
- * 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~ViewDocument#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~ViewDocumentFragment `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~ViewDocumentFragment `view.DocumentFragment`} from the `data.content` field to
- *    {@link module:engine/model/documentfragment~ModelDocumentFragment `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~ModelDocumentFragment `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~ViewDocumentFragment `view.DocumentFragment`}.
- * 3. Fires the {@link module:engine/view/document~ViewDocument#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 class ClipboardPipeline extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'ClipboardPipeline';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [ClipboardMarkersUtils];
-    }
-    /**
-     * @inheritDoc
-     */
-    init() {
-        const editor = this.editor;
-        const view = editor.editing.view;
-        view.addObserver(ClipboardObserver);
-        this._setupPasteDrop();
-        this._setupCopyCut();
-    }
-    /**
-     * Fires Clipboard `'outputTransformation'` event for given parameters.
-     *
-     * @internal
-     */
-    _fireOutputTransformationEvent(dataTransfer, selection, method) {
-        const clipboardMarkersUtils = this.editor.plugins.get('ClipboardMarkersUtils');
-        this.editor.model.enqueueChange({ isUndoable: method === 'cut' }, () => {
-            const documentFragment = clipboardMarkersUtils._copySelectedFragmentWithMarkers(method, selection);
-            this.fire('outputTransformation', {
-                dataTransfer,
-                content: documentFragment,
-                method
-            });
-        });
-    }
-    /**
-     * The clipboard paste pipeline.
-     */
-    _setupPasteDrop() {
-        const editor = this.editor;
-        const model = editor.model;
-        const view = editor.editing.view;
-        const viewDocument = view.document;
-        const clipboardMarkersUtils = this.editor.plugins.get('ClipboardMarkersUtils');
-        // Pasting is disabled when selection is in non-editable place.
-        // Dropping is disabled in drag and drop handler.
-        this.listenTo(viewDocument, 'clipboardInput', (evt, data) => {
-            if (data.method == 'paste' && !editor.model.canEditAt(editor.model.document.selection)) {
-                evt.stop();
-            }
-        }, { priority: 'highest' });
-        this.listenTo(viewDocument, 'clipboardInput', (evt, data) => {
-            const dataTransfer = data.dataTransfer;
-            let content;
-            // Some feature could already inject content in the higher priority event handler (i.e., codeBlock).
-            if (data.content) {
-                content = data.content;
-            }
-            else {
-                let contentData = '';
-                if (dataTransfer.getData('text/html')) {
-                    contentData = normalizeClipboardData(dataTransfer.getData('text/html'));
-                }
-                else if (dataTransfer.getData('text/plain')) {
-                    contentData = plainTextToHtml(dataTransfer.getData('text/plain'));
-                }
-                content = this.editor.data.htmlProcessor.toView(contentData);
-            }
-            const eventInfo = new EventInfo(this, 'inputTransformation');
-            const sourceEditorId = dataTransfer.getData('application/ckeditor5-editor-id') || null;
-            this.fire(eventInfo, {
-                content,
-                dataTransfer,
-                sourceEditorId,
-                targetRanges: data.targetRanges,
-                method: data.method
-            });
-            // If CKEditor handled the input, do not bubble the original event any further.
-            // This helps external integrations recognize this fact and act accordingly.
-            // https://github.com/ckeditor/ckeditor5-upload/issues/92
-            if (eventInfo.stop.called) {
-                evt.stop();
-            }
-            view.scrollToTheSelection();
-        }, { priority: 'low' });
-        this.listenTo(this, 'inputTransformation', (evt, data) => {
-            if (data.content.isEmpty) {
-                return;
-            }
-            const dataController = this.editor.data;
-            // Convert the pasted content into a model document fragment.
-            // The conversion is contextual, but in this case an "all allowed" context is needed
-            // and for that we use the $clipboardHolder item.
-            const modelFragment = dataController.toModel(data.content, '$clipboardHolder');
-            if (modelFragment.childCount == 0) {
-                return;
-            }
-            evt.stop();
-            // Fire content insertion event in a single change block to allow other handlers to run in the same block
-            // without post-fixers called in between (i.e., the selection post-fixer).
-            model.change(() => {
-                this.fire('contentInsertion', {
-                    content: modelFragment,
-                    method: data.method,
-                    sourceEditorId: data.sourceEditorId,
-                    dataTransfer: data.dataTransfer,
-                    targetRanges: data.targetRanges
-                });
-            });
-        }, { priority: 'low' });
-        this.listenTo(this, 'contentInsertion', (evt, data) => {
-            data.resultRange = clipboardMarkersUtils._pasteFragmentWithMarkers(data.content);
-        }, { priority: 'low' });
-    }
-    /**
-     * The clipboard copy/cut pipeline.
-     */
-    _setupCopyCut() {
-        const editor = this.editor;
-        const modelDocument = editor.model.document;
-        const view = editor.editing.view;
-        const viewDocument = view.document;
-        const onCopyCut = (evt, data) => {
-            const dataTransfer = data.dataTransfer;
-            data.preventDefault();
-            this._fireOutputTransformationEvent(dataTransfer, modelDocument.selection, evt.name);
-        };
-        this.listenTo(viewDocument, 'copy', onCopyCut, { priority: 'low' });
-        this.listenTo(viewDocument, 'cut', (evt, data) => {
-            // Cutting is disabled when selection is in non-editable place.
-            // See: https://github.com/ckeditor/ckeditor5-clipboard/issues/26.
-            if (!editor.model.canEditAt(editor.model.document.selection)) {
-                data.preventDefault();
-            }
-            else {
-                onCopyCut(evt, data);
-            }
-        }, { priority: 'low' });
-        this.listenTo(this, 'outputTransformation', (evt, data) => {
-            const content = editor.data.toView(data.content, { isClipboardPipeline: true });
-            viewDocument.fire('clipboardOutput', {
-                dataTransfer: data.dataTransfer,
-                content,
-                method: data.method
-            });
-        }, { priority: 'low' });
-        this.listenTo(viewDocument, 'clipboardOutput', (evt, data) => {
-            if (!data.content.isEmpty) {
-                data.dataTransfer.setData('text/html', this.editor.data.htmlProcessor.toData(data.content));
-                data.dataTransfer.setData('text/plain', viewToPlainText(editor.data.htmlProcessor.domConverter, data.content));
-                data.dataTransfer.setData('application/ckeditor5-editor-id', this.editor.id);
-            }
-            if (data.method == 'cut') {
-                editor.model.deleteContent(modelDocument.selection);
-            }
-        }, { priority: 'low' });
-    }
-}