@ckeditor/ckeditor5-link 47.6.1 → 48.0.0-alpha.0

package/src/autolink.js

@@ -1,307 +0,0 @@
-/**
- * @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 link/autolink
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { Delete, TextWatcher, getLastTextLine, findAttributeRange } from 'ckeditor5/src/typing.js';
-import { addLinkProtocolIfApplicable, linkHasProtocol } from './utils.js';
-import { LinkEditing } from './linkediting.js';
-const MIN_LINK_LENGTH_WITH_SPACE_AT_END = 4; // Ie: "t.co " (length 5).
-// This was a tweak from https://gist.github.com/dperini/729294.
-const URL_REG_EXP = new RegExp(
-// Group 1: Line start or after a space.
-'(^|\\s)' +
-    // Group 2: Detected URL (or e-mail).
-    '(' +
-    // Protocol identifier or short syntax "//"
-    // a. Full form http://user@foo.bar.baz:8080/foo/bar.html#baz?foo=bar
-    '(' +
-    '(?:(?:(?:https?|ftp):)?\\/\\/)' +
-    // BasicAuth using user:pass (optional)
-    '(?:\\S+(?::\\S*)?@)?' +
-    '(?:' +
-    // IP address dotted notation octets
-    // excludes loopback network 0.0.0.0
-    // excludes reserved space >= 224.0.0.0
-    // excludes network & broadcast addresses
-    // (first & last IP address of each class)
-    '(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])' +
-    '(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}' +
-    '(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))' +
-    '|' +
-    '(' +
-    // Do not allow `www.foo` - see https://github.com/ckeditor/ckeditor5/issues/8050.
-    '((?!www\\.)|(www\\.))' +
-    // Host & domain names.
-    '(?![-_])(?:[-_a-z0-9\\u00a1-\\uffff]{1,63}\\.)+' +
-    // TLD identifier name.
-    '(?:[a-z\\u00a1-\\uffff]{2,63})' +
-    ')' +
-    '|' +
-    // Allow localhost as a valid hostname
-    'localhost' +
-    ')' +
-    // port number (optional)
-    '(?::\\d{2,5})?' +
-    // resource path (optional)
-    '(?:[/?#]\\S*)?' +
-    ')' +
-    '|' +
-    // b. Short form (either www.example.com or example@example.com)
-    '(' +
-    '(www.|(\\S+@))' +
-    // Host & domain names.
-    '((?![-_])(?:[-_a-z0-9\\u00a1-\\uffff]{1,63}\\.))+' +
-    // TLD identifier name.
-    '(?:[a-z\\u00a1-\\uffff]{2,63})' +
-    ')' +
-    ')$', 'i');
-const URL_GROUP_IN_MATCH = 2;
-/**
- * The autolink plugin.
- */
-export class AutoLink extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [Delete, LinkEditing];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'AutoLink';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-    /**
-     * @inheritDoc
-     */
-    init() {
-        const editor = this.editor;
-        const selection = editor.model.document.selection;
-        selection.on('change:range', () => {
-            // Disable plugin when selection is inside a code block.
-            this.isEnabled = !selection.anchor.parent.is('element', 'codeBlock');
-        });
-        this._enableTypingHandling();
-    }
-    /**
-     * @inheritDoc
-     */
-    afterInit() {
-        this._enableEnterHandling();
-        this._enableShiftEnterHandling();
-        this._enablePasteLinking();
-    }
-    /**
-     * For given position, returns a range that includes the whole link that contains the position.
-     *
-     * If position is not inside a link, returns `null`.
-     */
-    _expandLinkRange(model, position) {
-        if (position.textNode && position.textNode.hasAttribute('linkHref')) {
-            return findAttributeRange(position, 'linkHref', position.textNode.getAttribute('linkHref'), model);
-        }
-        else {
-            return null;
-        }
-    }
-    /**
-     * Extends the document selection to includes all links that intersects with given `selectedRange`.
-     */
-    _selectEntireLinks(writer, selectedRange) {
-        const editor = this.editor;
-        const model = editor.model;
-        const selection = model.document.selection;
-        const selStart = selection.getFirstPosition();
-        const selEnd = selection.getLastPosition();
-        let updatedSelection = selectedRange.getJoined(this._expandLinkRange(model, selStart) || selectedRange);
-        if (updatedSelection) {
-            updatedSelection = updatedSelection.getJoined(this._expandLinkRange(model, selEnd) || selectedRange);
-        }
-        if (updatedSelection && (updatedSelection.start.isBefore(selStart) || updatedSelection.end.isAfter(selEnd))) {
-            // Only update the selection if it changed.
-            writer.setSelection(updatedSelection);
-        }
-    }
-    /**
-     * Enables autolinking on pasting a URL when some content is selected.
-     */
-    _enablePasteLinking() {
-        const editor = this.editor;
-        const model = editor.model;
-        const selection = model.document.selection;
-        const clipboardPipeline = editor.plugins.get('ClipboardPipeline');
-        const linkCommand = editor.commands.get('link');
-        clipboardPipeline.on('inputTransformation', (evt, data) => {
-            if (!this.isEnabled || !linkCommand.isEnabled || selection.isCollapsed || data.method !== 'paste') {
-                // Abort if we are disabled or the selection is collapsed.
-                return;
-            }
-            if (selection.rangeCount > 1) {
-                // Abort if there are multiple selection ranges.
-                return;
-            }
-            const selectedRange = selection.getFirstRange();
-            const newLink = data.dataTransfer.getData('text/plain');
-            if (!newLink) {
-                // Abort if there is no plain text on the clipboard.
-                return;
-            }
-            const matches = newLink.match(URL_REG_EXP);
-            // If the text in the clipboard has a URL, and that URL is the whole clipboard.
-            if (matches && matches[2] === newLink) {
-                model.change(writer => {
-                    this._selectEntireLinks(writer, selectedRange);
-                    linkCommand.execute(newLink);
-                });
-                evt.stop();
-            }
-        }, { priority: 'high' });
-    }
-    /**
-     * Enables autolinking on typing.
-     */
-    _enableTypingHandling() {
-        const editor = this.editor;
-        const watcher = new TextWatcher(editor.model, text => {
-            let mappedText = text;
-            // 1. Detect <kbd>Space</kbd> after a text with a potential link.
-            if (!isSingleSpaceAtTheEnd(mappedText)) {
-                return;
-            }
-            // 2. Remove the last space character.
-            mappedText = mappedText.slice(0, -1);
-            // 3. Remove punctuation at the end of the URL if it exists.
-            if ('!.:,;?'.includes(mappedText[mappedText.length - 1])) {
-                mappedText = mappedText.slice(0, -1);
-            }
-            // 4. Check text before last typed <kbd>Space</kbd> or punctuation.
-            const url = getUrlAtTextEnd(mappedText);
-            if (url) {
-                return {
-                    url,
-                    removedTrailingCharacters: text.length - mappedText.length
-                };
-            }
-        });
-        watcher.on('matched:data', (evt, data) => {
-            const { batch, range, url, removedTrailingCharacters } = data;
-            if (!batch.isTyping) {
-                return;
-            }
-            const linkEnd = range.end.getShiftedBy(-removedTrailingCharacters); // Executed after a space character or punctuation.
-            const linkStart = linkEnd.getShiftedBy(-url.length);
-            const linkRange = editor.model.createRange(linkStart, linkEnd);
-            this._applyAutoLink(url, linkRange);
-        });
-        watcher.bind('isEnabled').to(this);
-    }
-    /**
-     * Enables autolinking on the <kbd>Enter</kbd> key.
-     */
-    _enableEnterHandling() {
-        const editor = this.editor;
-        const model = editor.model;
-        const enterCommand = editor.commands.get('enter');
-        if (!enterCommand) {
-            return;
-        }
-        enterCommand.on('execute', () => {
-            const position = model.document.selection.getFirstPosition();
-            let rangeToCheck;
-            // Previous sibling might not be an element if enter was blocked due to be triggered in a limit element.
-            if (position.parent.previousSibling?.is('element')) {
-                rangeToCheck = model.createRangeIn(position.parent.previousSibling);
-            }
-            else {
-                rangeToCheck = model.createRange(model.createPositionAt(position.parent, 0), position);
-            }
-            this._checkAndApplyAutoLinkOnRange(rangeToCheck);
-        });
-    }
-    /**
-     * Enables autolinking on the <kbd>Shift</kbd>+<kbd>Enter</kbd> keyboard shortcut.
-     */
-    _enableShiftEnterHandling() {
-        const editor = this.editor;
-        const model = editor.model;
-        const shiftEnterCommand = editor.commands.get('shiftEnter');
-        if (!shiftEnterCommand) {
-            return;
-        }
-        shiftEnterCommand.on('execute', () => {
-            const position = model.document.selection.getFirstPosition();
-            const rangeToCheck = model.createRange(model.createPositionAt(position.parent, 0), position.getShiftedBy(-1));
-            this._checkAndApplyAutoLinkOnRange(rangeToCheck);
-        });
-    }
-    /**
-     * Checks if the passed range contains a linkable text.
-     */
-    _checkAndApplyAutoLinkOnRange(rangeToCheck) {
-        const model = this.editor.model;
-        const { text, range } = getLastTextLine(rangeToCheck, model);
-        const url = getUrlAtTextEnd(text);
-        if (url) {
-            const linkRange = model.createRange(range.end.getShiftedBy(-url.length), range.end);
-            this._applyAutoLink(url, linkRange);
-        }
-    }
-    /**
-     * Applies a link on a given range if the link should be applied.
-     *
-     * @param url The URL to link.
-     * @param range The text range to apply the link attribute to.
-     */
-    _applyAutoLink(url, range) {
-        const model = this.editor.model;
-        const defaultProtocol = this.editor.config.get('link.defaultProtocol');
-        const fullUrl = addLinkProtocolIfApplicable(url, defaultProtocol);
-        if (!this.isEnabled || !isLinkAllowedOnRange(range, model) || !linkHasProtocol(fullUrl) || linkIsAlreadySet(range)) {
-            return;
-        }
-        this._persistAutoLink(fullUrl, range);
-    }
-    /**
-     * Enqueues autolink changes in the model.
-     *
-     * @param url The URL to link.
-     * @param range The text range to apply the link attribute to.
-     */
-    _persistAutoLink(url, range) {
-        const model = this.editor.model;
-        const deletePlugin = this.editor.plugins.get('Delete');
-        // Enqueue change to make undo step.
-        model.enqueueChange(writer => {
-            writer.setAttribute('linkHref', url, range);
-            model.enqueueChange(() => {
-                deletePlugin.requestUndoOnBackspace();
-            });
-        });
-    }
-}
-// Check if text should be evaluated by the plugin in order to reduce number of RegExp checks on whole text.
-function isSingleSpaceAtTheEnd(text) {
-    return text.length > MIN_LINK_LENGTH_WITH_SPACE_AT_END && text[text.length - 1] === ' ' && text[text.length - 2] !== ' ';
-}
-function getUrlAtTextEnd(text) {
-    const match = URL_REG_EXP.exec(text);
-    return match ? match[URL_GROUP_IN_MATCH] : null;
-}
-function isLinkAllowedOnRange(range, model) {
-    return model.schema.checkAttributeInSelection(model.createSelection(range), 'linkHref');
-}
-function linkIsAlreadySet(range) {
-    const item = range.start.nodeAfter;
-    return !!item && item.hasAttribute('linkHref');
-}

package/src/index.js

@@ -1,25 +0,0 @@
-/**
- * @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 link
- */
-export { Link } from './link.js';
-export { LinkEditing } from './linkediting.js';
-export { LinkUI } from './linkui.js';
-export { LinkImage } from './linkimage.js';
-export { LinkImageEditing } from './linkimageediting.js';
-export { LinkImageUI } from './linkimageui.js';
-export { AutoLink } from './autolink.js';
-export { LinkFormView } from './ui/linkformview.js';
-export { LinkCommand } from './linkcommand.js';
-export { UnlinkCommand } from './unlinkcommand.js';
-export { LinkButtonView as _LinkButtonView } from './ui/linkbuttonview.js';
-export { LinkPreviewButtonView as _LinkPreviewButtonView } from './ui/linkpreviewbuttonview.js';
-export { LinkPropertiesView } from './ui/linkpropertiesview.js';
-export { LinkProviderItemsView } from './ui/linkprovideritemsview.js';
-export { addLinkProtocolIfApplicable, ensureSafeUrl, ensureSafeUrl as _ensureSafeLinkUrl, isLinkableElement, isLinkElement, LINK_KEYSTROKE as _LINK_KEYSTROKE, createLinkElement as _createLinkElement, getLocalizedDecorators as _getLocalizedLinkDecorators, normalizeDecorators as _normalizeLinkDecorators, isEmail as _isEmailLink, linkHasProtocol as _hasLinkProtocol, openLink as _openLink, extractTextFromLinkRange as _extractTextFromLinkRange } from './utils.js';
-export { AutomaticLinkDecorators } from './utils/automaticdecorators.js';
-export { LinkManualDecorator } from './utils/manualdecorator.js';
-import './augmentation.js';

package/src/link.js

@@ -1,37 +0,0 @@
-/**
- * @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 link/link
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { LinkEditing } from './linkediting.js';
-import { LinkUI } from './linkui.js';
-import { AutoLink } from './autolink.js';
-/**
- * The link plugin.
- *
- * This is a "glue" plugin that loads the {@link module:link/linkediting~LinkEditing link editing feature}
- * and {@link module:link/linkui~LinkUI link UI feature}.
- */
-export class Link extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [LinkEditing, LinkUI, AutoLink];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'Link';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-}