@ckeditor/ckeditor5-link 0.0.0-internal-20241017.0

package/src/unlinkcommand.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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 link/unlinkcommand
+ */
+import { Command } from 'ckeditor5/src/core.js';
+/**
+ * The unlink command. It is used by the {@link module:link/link~Link link plugin}.
+ */
+export default class UnlinkCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * When the selection is collapsed, it removes the `linkHref` attribute from each node with the same `linkHref` attribute value.
+     * When the selection is non-collapsed, it removes the `linkHref` attribute from each node in selected ranges.
+     *
+     * # Decorators
+     *
+     * If {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} is specified,
+     * all configured decorators are removed together with the `linkHref` attribute.
+     *
+     * @fires execute
+     */
+    execute(): void;
+}

package/src/unlinkcommand.js

@@ -0,0 +1,66 @@
+/**
+ * @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 link/unlinkcommand
+ */
+import { Command } from 'ckeditor5/src/core.js';
+import { findAttributeRange } from 'ckeditor5/src/typing.js';
+import { isLinkableElement } from './utils.js';
+/**
+ * The unlink command. It is used by the {@link module:link/link~Link link plugin}.
+ */
+export default class UnlinkCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const selectedElement = selection.getSelectedElement();
+        // A check for any integration that allows linking elements (e.g. `LinkImage`).
+        // Currently the selection reads attributes from text nodes only. See #7429 and #7465.
+        if (isLinkableElement(selectedElement, model.schema)) {
+            this.isEnabled = model.schema.checkAttribute(selectedElement, 'linkHref');
+        }
+        else {
+            this.isEnabled = model.schema.checkAttributeInSelection(selection, 'linkHref');
+        }
+    }
+    /**
+     * Executes the command.
+     *
+     * When the selection is collapsed, it removes the `linkHref` attribute from each node with the same `linkHref` attribute value.
+     * When the selection is non-collapsed, it removes the `linkHref` attribute from each node in selected ranges.
+     *
+     * # Decorators
+     *
+     * If {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} is specified,
+     * all configured decorators are removed together with the `linkHref` attribute.
+     *
+     * @fires execute
+     */
+    execute() {
+        const editor = this.editor;
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const linkCommand = editor.commands.get('link');
+        model.change(writer => {
+            // Get ranges to unlink.
+            const rangesToUnlink = selection.isCollapsed ?
+                [findAttributeRange(selection.getFirstPosition(), 'linkHref', selection.getAttribute('linkHref'), model)] :
+                model.schema.getValidRanges(selection.getRanges(), 'linkHref');
+            // Remove `linkHref` attribute from specified ranges.
+            for (const range of rangesToUnlink) {
+                writer.removeAttribute('linkHref', range);
+                // If there are registered custom attributes, then remove them during unlink.
+                if (linkCommand) {
+                    for (const manualDecorator of linkCommand.manualDecorators) {
+                        writer.removeAttribute(manualDecorator.id, range);
+                    }
+                }
+            }
+        });
+    }
+}

package/src/utils/automaticdecorators.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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 link/utils/automaticdecorators
+ */
+import { type ArrayOrItem } from 'ckeditor5/src/utils.js';
+import type { DowncastDispatcher } from 'ckeditor5/src/engine.js';
+import type { NormalizedLinkDecoratorAutomaticDefinition } from '../utils.js';
+/**
+ * Helper class that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition} and provides
+ * the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement downcast dispatchers} for them.
+ */
+export default class AutomaticDecorators {
+    /**
+     * Stores the definition of {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}.
+     * This data is used as a source for a downcast dispatcher to create a proper conversion to output data.
+     */
+    private _definitions;
+    /**
+     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticDecorators}
+     * instance.
+     */
+    get length(): number;
+    /**
+     * Adds automatic decorator objects or an array with them to be used during downcasting.
+     *
+     * @param item A configuration object of automatic rules for decorating links. It might also be an array of such objects.
+     */
+    add(item: ArrayOrItem<NormalizedLinkDecoratorAutomaticDefinition>): void;
+    /**
+     * Provides the conversion helper used in the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add} method.
+     *
+     * @returns A dispatcher function used as conversion helper in {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add}.
+     */
+    getDispatcher(): (dispatcher: DowncastDispatcher) => void;
+    /**
+     * Provides the conversion helper used in the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add} method
+     * when linking images.
+     *
+     * @returns A dispatcher function used as conversion helper in {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add}.
+     */
+    getDispatcherForLinkedImage(): (dispatcher: DowncastDispatcher) => void;
+}

package/src/utils/automaticdecorators.js

@@ -0,0 +1,140 @@
+/**
+ * @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 link/utils/automaticdecorators
+ */
+import { toMap } from 'ckeditor5/src/utils.js';
+/**
+ * Helper class that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition} and provides
+ * the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement downcast dispatchers} for them.
+ */
+export default class AutomaticDecorators {
+    constructor() {
+        /**
+         * Stores the definition of {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}.
+         * This data is used as a source for a downcast dispatcher to create a proper conversion to output data.
+         */
+        this._definitions = new Set();
+    }
+    /**
+     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticDecorators}
+     * instance.
+     */
+    get length() {
+        return this._definitions.size;
+    }
+    /**
+     * Adds automatic decorator objects or an array with them to be used during downcasting.
+     *
+     * @param item A configuration object of automatic rules for decorating links. It might also be an array of such objects.
+     */
+    add(item) {
+        if (Array.isArray(item)) {
+            item.forEach(item => this._definitions.add(item));
+        }
+        else {
+            this._definitions.add(item);
+        }
+    }
+    /**
+     * Provides the conversion helper used in the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add} method.
+     *
+     * @returns A dispatcher function used as conversion helper in {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add}.
+     */
+    getDispatcher() {
+        return dispatcher => {
+            dispatcher.on('attribute:linkHref', (evt, data, conversionApi) => {
+                // There is only test as this behavior decorates links and
+                // it is run before dispatcher which actually consumes this node.
+                // This allows on writing own dispatcher with highest priority,
+                // which blocks both native converter and this additional decoration.
+                if (!conversionApi.consumable.test(data.item, 'attribute:linkHref')) {
+                    return;
+                }
+                // Automatic decorators for block links are handled e.g. in LinkImageEditing.
+                if (!(data.item.is('selection') || conversionApi.schema.isInline(data.item))) {
+                    return;
+                }
+                const viewWriter = conversionApi.writer;
+                const viewSelection = viewWriter.document.selection;
+                for (const item of this._definitions) {
+                    const viewElement = viewWriter.createAttributeElement('a', item.attributes, {
+                        priority: 5
+                    });
+                    if (item.classes) {
+                        viewWriter.addClass(item.classes, viewElement);
+                    }
+                    for (const key in item.styles) {
+                        viewWriter.setStyle(key, item.styles[key], viewElement);
+                    }
+                    viewWriter.setCustomProperty('link', true, viewElement);
+                    if (item.callback(data.attributeNewValue)) {
+                        if (data.item.is('selection')) {
+                            viewWriter.wrap(viewSelection.getFirstRange(), viewElement);
+                        }
+                        else {
+                            viewWriter.wrap(conversionApi.mapper.toViewRange(data.range), viewElement);
+                        }
+                    }
+                    else {
+                        viewWriter.unwrap(conversionApi.mapper.toViewRange(data.range), viewElement);
+                    }
+                }
+            }, { priority: 'high' });
+        };
+    }
+    /**
+     * Provides the conversion helper used in the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add} method
+     * when linking images.
+     *
+     * @returns A dispatcher function used as conversion helper in {@link module:engine/conversion/downcasthelpers~DowncastHelpers#add}.
+     */
+    getDispatcherForLinkedImage() {
+        return dispatcher => {
+            dispatcher.on('attribute:linkHref:imageBlock', (evt, data, { writer, mapper }) => {
+                const viewFigure = mapper.toViewElement(data.item);
+                const linkInImage = Array.from(viewFigure.getChildren())
+                    .find((child) => child.is('element', 'a'));
+                for (const item of this._definitions) {
+                    const attributes = toMap(item.attributes);
+                    if (item.callback(data.attributeNewValue)) {
+                        for (const [key, val] of attributes) {
+                            // Left for backward compatibility. Since v30 decorator should
+                            // accept `classes` and `styles` separately from `attributes`.
+                            if (key === 'class') {
+                                writer.addClass(val, linkInImage);
+                            }
+                            else {
+                                writer.setAttribute(key, val, linkInImage);
+                            }
+                        }
+                        if (item.classes) {
+                            writer.addClass(item.classes, linkInImage);
+                        }
+                        for (const key in item.styles) {
+                            writer.setStyle(key, item.styles[key], linkInImage);
+                        }
+                    }
+                    else {
+                        for (const [key, val] of attributes) {
+                            if (key === 'class') {
+                                writer.removeClass(val, linkInImage);
+                            }
+                            else {
+                                writer.removeAttribute(key, linkInImage);
+                            }
+                        }
+                        if (item.classes) {
+                            writer.removeClass(item.classes, linkInImage);
+                        }
+                        for (const key in item.styles) {
+                            writer.removeStyle(key, linkInImage);
+                        }
+                    }
+                }
+            });
+        };
+    }
+}

package/src/utils/manualdecorator.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @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 link/utils/manualdecorator
+ */
+import { type ArrayOrItem } from 'ckeditor5/src/utils.js';
+import type { MatcherObjectPattern } from 'ckeditor5/src/engine.js';
+import type { NormalizedLinkDecoratorManualDefinition } from '../utils.js';
+declare const ManualDecorator_base: {
+    new (): import("ckeditor5/src/utils.js").Observable;
+    prototype: import("ckeditor5/src/utils.js").Observable;
+};
+/**
+ * Helper class that stores manual decorators with observable {@link module:link/utils/manualdecorator~ManualDecorator#value}
+ * to support integration with the UI state. An instance of this class is a model with the state of individual manual decorators.
+ * These decorators are kept as collections in {@link module:link/linkcommand~LinkCommand#manualDecorators}.
+ */
+export default class ManualDecorator extends /* #__PURE__ */ ManualDecorator_base {
+    /**
+     * An ID of a manual decorator which is the name of the attribute in the model, for example: 'linkManualDecorator0'.
+     */
+    id: string;
+    /**
+     * The value of the current manual decorator. It reflects its state from the UI.
+     *
+     * @observable
+     */
+    value: boolean | undefined;
+    /**
+     * The default value of manual decorator.
+     */
+    defaultValue?: boolean;
+    /**
+     * The label used in the user interface to toggle the manual decorator.
+     */
+    label: string;
+    /**
+     * A set of attributes added to downcasted data when the decorator is activated for a specific link.
+     * Attributes should be added in a form of attributes defined in {@link module:engine/view/elementdefinition~ElementDefinition}.
+     */
+    attributes?: Record<string, string>;
+    /**
+     * A set of classes added to downcasted data when the decorator is activated for a specific link.
+     * Classes should be added in a form of classes defined in {@link module:engine/view/elementdefinition~ElementDefinition}.
+     */
+    classes?: ArrayOrItem<string>;
+    /**
+     * A set of styles added to downcasted data when the decorator is activated for a specific link.
+     * Styles should be added in a form of styles defined in {@link module:engine/view/elementdefinition~ElementDefinition}.
+     */
+    styles?: Record<string, string>;
+    /**
+     * Creates a new instance of {@link module:link/utils/manualdecorator~ManualDecorator}.
+     *
+     * @param config.id The name of the attribute used in the model that represents a given manual decorator.
+     * For example: `'linkIsExternal'`.
+     * @param config.label The label used in the user interface to toggle the manual decorator.
+     * @param config.attributes A set of attributes added to output data when the decorator is active for a specific link.
+     * Attributes should keep the format of attributes defined in {@link module:engine/view/elementdefinition~ElementDefinition}.
+     * @param [config.defaultValue] Controls whether the decorator is "on" by default.
+     */
+    constructor({ id, label, attributes, classes, styles, defaultValue }: NormalizedLinkDecoratorManualDefinition);
+    /**
+     * Returns {@link module:engine/view/matcher~MatcherPattern} with decorator attributes.
+     *
+     * @internal
+     */
+    _createPattern(): MatcherObjectPattern;
+}
+export {};

package/src/utils/manualdecorator.js

@@ -0,0 +1,47 @@
+/**
+ * @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 link/utils/manualdecorator
+ */
+import { ObservableMixin } from 'ckeditor5/src/utils.js';
+/**
+ * Helper class that stores manual decorators with observable {@link module:link/utils/manualdecorator~ManualDecorator#value}
+ * to support integration with the UI state. An instance of this class is a model with the state of individual manual decorators.
+ * These decorators are kept as collections in {@link module:link/linkcommand~LinkCommand#manualDecorators}.
+ */
+export default class ManualDecorator extends /* #__PURE__ */ ObservableMixin() {
+    /**
+     * Creates a new instance of {@link module:link/utils/manualdecorator~ManualDecorator}.
+     *
+     * @param config.id The name of the attribute used in the model that represents a given manual decorator.
+     * For example: `'linkIsExternal'`.
+     * @param config.label The label used in the user interface to toggle the manual decorator.
+     * @param config.attributes A set of attributes added to output data when the decorator is active for a specific link.
+     * Attributes should keep the format of attributes defined in {@link module:engine/view/elementdefinition~ElementDefinition}.
+     * @param [config.defaultValue] Controls whether the decorator is "on" by default.
+     */
+    constructor({ id, label, attributes, classes, styles, defaultValue }) {
+        super();
+        this.id = id;
+        this.set('value', undefined);
+        this.defaultValue = defaultValue;
+        this.label = label;
+        this.attributes = attributes;
+        this.classes = classes;
+        this.styles = styles;
+    }
+    /**
+     * Returns {@link module:engine/view/matcher~MatcherPattern} with decorator attributes.
+     *
+     * @internal
+     */
+    _createPattern() {
+        return {
+            attributes: this.attributes,
+            classes: this.classes,
+            styles: this.styles
+        };
+    }
+}

package/src/utils.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @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 link/utils
+ */
+import type { DowncastConversionApi, Element, Schema, ViewAttributeElement, ViewNode, ViewDocumentFragment } from 'ckeditor5/src/engine.js';
+import type { LocaleTranslate } from 'ckeditor5/src/utils.js';
+import type { LinkDecoratorAutomaticDefinition, LinkDecoratorDefinition, LinkDecoratorManualDefinition } from './linkconfig.js';
+/**
+ * A keystroke used by the {@link module:link/linkui~LinkUI link UI feature}.
+ */
+export declare const LINK_KEYSTROKE = "Ctrl+K";
+/**
+ * Returns `true` if a given view node is the link element.
+ */
+export declare function isLinkElement(node: ViewNode | ViewDocumentFragment): boolean;
+/**
+ * Creates a link {@link module:engine/view/attributeelement~AttributeElement} with the provided `href` attribute.
+ */
+export declare function createLinkElement(href: string, { writer }: DowncastConversionApi): ViewAttributeElement;
+/**
+ * Returns a safe URL based on a given value.
+ *
+ * A URL is considered safe if it is safe for the user (does not contain any malicious code).
+ *
+ * If a URL is considered unsafe, a simple `"#"` is returned.
+ *
+ * @internal
+ */
+export declare function ensureSafeUrl(url: unknown, allowedProtocols?: Array<string>): string;
+/**
+ * Returns the {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} configuration processed
+ * to respect the locale of the editor, i.e. to display the {@link module:link/linkconfig~LinkDecoratorManualDefinition label}
+ * in the correct language.
+ *
+ * **Note**: Only the few most commonly used labels are translated automatically. Other labels should be manually
+ * translated in the {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} configuration.
+ *
+ * @param t Shorthand for {@link module:utils/locale~Locale#t Locale#t}.
+ * @param decorators The decorator reference where the label values should be localized.
+ */
+export declare function getLocalizedDecorators(t: LocaleTranslate, decorators: Array<NormalizedLinkDecoratorDefinition>): Array<NormalizedLinkDecoratorDefinition>;
+/**
+ * Converts an object with defined decorators to a normalized array of decorators. The `id` key is added for each decorator and
+ * is used as the attribute's name in the model.
+ */
+export declare function normalizeDecorators(decorators?: Record<string, LinkDecoratorDefinition>): Array<NormalizedLinkDecoratorDefinition>;
+/**
+ * Returns `true` if the specified `element` can be linked (the element allows the `linkHref` attribute).
+ */
+export declare function isLinkableElement(element: Element | null, schema: Schema): element is Element;
+/**
+ * Returns `true` if the specified `value` is an email.
+ */
+export declare function isEmail(value: string): boolean;
+/**
+ * Adds the protocol prefix to the specified `link` when:
+ *
+ * * it does not contain it already, and there is a {@link module:link/linkconfig~LinkConfig#defaultProtocol `defaultProtocol` }
+ * configuration value provided,
+ * * or the link is an email address.
+ */
+export declare function addLinkProtocolIfApplicable(link: string, defaultProtocol?: string): string;
+/**
+ * Checks if protocol is already included in the link.
+ */
+export declare function linkHasProtocol(link: string): boolean;
+/**
+ * Opens the link in a new browser tab.
+ */
+export declare function openLink(link: string): void;
+export type NormalizedLinkDecoratorAutomaticDefinition = LinkDecoratorAutomaticDefinition & {
+    id: string;
+};
+export type NormalizedLinkDecoratorManualDefinition = LinkDecoratorManualDefinition & {
+    id: string;
+};
+export type NormalizedLinkDecoratorDefinition = NormalizedLinkDecoratorAutomaticDefinition | NormalizedLinkDecoratorManualDefinition;

package/src/utils.js

@@ -0,0 +1,135 @@
+/**
+ * @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
+ */
+import { upperFirst } from 'lodash-es';
+const ATTRIBUTE_WHITESPACES = /[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205f\u3000]/g; // eslint-disable-line no-control-regex
+const SAFE_URL_TEMPLATE = '^(?:(?:<protocols>):|[^a-z]|[a-z+.-]+(?:[^a-z+.:-]|$))';
+// Simplified email test - should be run over previously found URL.
+const EMAIL_REG_EXP = /^[\S]+@((?![-_])(?:[-\w\u00a1-\uffff]{0,63}[^-_]\.))+(?:[a-z\u00a1-\uffff]{2,})$/i;
+// The regex checks for the protocol syntax ('xxxx://' or 'xxxx:')
+// or non-word characters at the beginning of the link ('/', '#' etc.).
+const PROTOCOL_REG_EXP = /^((\w+:(\/{2,})?)|(\W))/i;
+const DEFAULT_LINK_PROTOCOLS = [
+    'https?',
+    'ftps?',
+    'mailto'
+];
+/**
+ * A keystroke used by the {@link module:link/linkui~LinkUI link UI feature}.
+ */
+export const LINK_KEYSTROKE = 'Ctrl+K';
+/**
+ * Returns `true` if a given view node is the link element.
+ */
+export function isLinkElement(node) {
+    return node.is('attributeElement') && !!node.getCustomProperty('link');
+}
+/**
+ * Creates a link {@link module:engine/view/attributeelement~AttributeElement} with the provided `href` attribute.
+ */
+export function createLinkElement(href, { writer }) {
+    // Priority 5 - https://github.com/ckeditor/ckeditor5-link/issues/121.
+    const linkElement = writer.createAttributeElement('a', { href }, { priority: 5 });
+    writer.setCustomProperty('link', true, linkElement);
+    return linkElement;
+}
+/**
+ * Returns a safe URL based on a given value.
+ *
+ * A URL is considered safe if it is safe for the user (does not contain any malicious code).
+ *
+ * If a URL is considered unsafe, a simple `"#"` is returned.
+ *
+ * @internal
+ */
+export function ensureSafeUrl(url, allowedProtocols = DEFAULT_LINK_PROTOCOLS) {
+    const urlString = String(url);
+    const protocolsList = allowedProtocols.join('|');
+    const customSafeRegex = new RegExp(`${SAFE_URL_TEMPLATE.replace('<protocols>', protocolsList)}`, 'i');
+    return isSafeUrl(urlString, customSafeRegex) ? urlString : '#';
+}
+/**
+ * Checks whether the given URL is safe for the user (does not contain any malicious code).
+ */
+function isSafeUrl(url, customRegexp) {
+    const normalizedUrl = url.replace(ATTRIBUTE_WHITESPACES, '');
+    return !!normalizedUrl.match(customRegexp);
+}
+/**
+ * Returns the {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} configuration processed
+ * to respect the locale of the editor, i.e. to display the {@link module:link/linkconfig~LinkDecoratorManualDefinition label}
+ * in the correct language.
+ *
+ * **Note**: Only the few most commonly used labels are translated automatically. Other labels should be manually
+ * translated in the {@link module:link/linkconfig~LinkConfig#decorators `config.link.decorators`} configuration.
+ *
+ * @param t Shorthand for {@link module:utils/locale~Locale#t Locale#t}.
+ * @param decorators The decorator reference where the label values should be localized.
+ */
+export function getLocalizedDecorators(t, decorators) {
+    const localizedDecoratorsLabels = {
+        'Open in a new tab': t('Open in a new tab'),
+        'Downloadable': t('Downloadable')
+    };
+    decorators.forEach(decorator => {
+        if ('label' in decorator && localizedDecoratorsLabels[decorator.label]) {
+            decorator.label = localizedDecoratorsLabels[decorator.label];
+        }
+        return decorator;
+    });
+    return decorators;
+}
+/**
+ * Converts an object with defined decorators to a normalized array of decorators. The `id` key is added for each decorator and
+ * is used as the attribute's name in the model.
+ */
+export function normalizeDecorators(decorators) {
+    const retArray = [];
+    if (decorators) {
+        for (const [key, value] of Object.entries(decorators)) {
+            const decorator = Object.assign({}, value, { id: `link${upperFirst(key)}` });
+            retArray.push(decorator);
+        }
+    }
+    return retArray;
+}
+/**
+ * Returns `true` if the specified `element` can be linked (the element allows the `linkHref` attribute).
+ */
+export function isLinkableElement(element, schema) {
+    if (!element) {
+        return false;
+    }
+    return schema.checkAttribute(element.name, 'linkHref');
+}
+/**
+ * Returns `true` if the specified `value` is an email.
+ */
+export function isEmail(value) {
+    return EMAIL_REG_EXP.test(value);
+}
+/**
+ * Adds the protocol prefix to the specified `link` when:
+ *
+ * * it does not contain it already, and there is a {@link module:link/linkconfig~LinkConfig#defaultProtocol `defaultProtocol` }
+ * configuration value provided,
+ * * or the link is an email address.
+ */
+export function addLinkProtocolIfApplicable(link, defaultProtocol) {
+    const protocol = isEmail(link) ? 'mailto:' : defaultProtocol;
+    const isProtocolNeeded = !!protocol && !linkHasProtocol(link);
+    return link && isProtocolNeeded ? protocol + link : link;
+}
+/**
+ * Checks if protocol is already included in the link.
+ */
+export function linkHasProtocol(link) {
+    return PROTOCOL_REG_EXP.test(link);
+}
+/**
+ * Opens the link in a new browser tab.
+ */
+export function openLink(link) {
+    window.open(link, '_blank', 'noopener');
+}

package/theme/icons/link.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="m11.077 15 .991-1.416a.75.75 0 1 1 1.229.86l-1.148 1.64a.748.748 0 0 1-.217.206 5.251 5.251 0 0 1-8.503-5.955.741.741 0 0 1 .12-.274l1.147-1.639a.75.75 0 1 1 1.228.86L4.933 10.7l.006.003a3.75 3.75 0 0 0 6.132 4.294l.006.004zm5.494-5.335a.748.748 0 0 1-.12.274l-1.147 1.639a.75.75 0 1 1-1.228-.86l.86-1.23a3.75 3.75 0 0 0-6.144-4.301l-.86 1.229a.75.75 0 0 1-1.229-.86l1.148-1.64a.748.748 0 0 1 .217-.206 5.251 5.251 0 0 1 8.503 5.955zm-4.563-2.532a.75.75 0 0 1 .184 1.045l-3.155 4.505a.75.75 0 1 1-1.229-.86l3.155-4.506a.75.75 0 0 1 1.045-.184z"/></svg>

package/theme/icons/unlink.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="m11.077 15 .991-1.416a.75.75 0 1 1 1.229.86l-1.148 1.64a.748.748 0 0 1-.217.206 5.251 5.251 0 0 1-8.503-5.955.741.741 0 0 1 .12-.274l1.147-1.639a.75.75 0 1 1 1.228.86L4.933 10.7l.006.003a3.75 3.75 0 0 0 6.132 4.294l.006.004zm5.494-5.335a.748.748 0 0 1-.12.274l-1.147 1.639a.75.75 0 1 1-1.228-.86l.86-1.23a3.75 3.75 0 0 0-6.144-4.301l-.86 1.229a.75.75 0 0 1-1.229-.86l1.148-1.64a.748.748 0 0 1 .217-.206 5.251 5.251 0 0 1 8.503 5.955zm-4.563-2.532a.75.75 0 0 1 .184 1.045l-3.155 4.505a.75.75 0 1 1-1.229-.86l3.155-4.506a.75.75 0 0 1 1.045-.184zm4.919 10.562-1.414 1.414a.75.75 0 1 1-1.06-1.06l1.414-1.415-1.415-1.414a.75.75 0 0 1 1.061-1.06l1.414 1.414 1.414-1.415a.75.75 0 0 1 1.061 1.061l-1.414 1.414 1.414 1.415a.75.75 0 0 1-1.06 1.06l-1.415-1.414z"/></svg>

package/theme/link.css

@@ -0,0 +1,10 @@
+/*
+ * 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
+ */
+
+/*
+ * Note: This file should contain the wireframe styles only. But since there are no such styles,
+ * it acts as a message to the builder telling that it should look for the corresponding styles
+ * **in the theme** when compiling the editor.
+ */

package/theme/linkactions.css

@@ -0,0 +1,32 @@
+/*
+ * 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
+ */
+
+@import "@ckeditor/ckeditor5-ui/theme/mixins/_rwd.css";
+
+.ck.ck-link-actions {
+	display: flex;
+	flex-direction: row;
+	flex-wrap: nowrap;
+
+	& .ck-link-actions__preview {
+		display: inline-block;
+
+		& .ck-button__label {
+			overflow: hidden;
+		}
+	}
+
+	@mixin ck-media-phone {
+		flex-wrap: wrap;
+
+		& .ck-link-actions__preview {
+			flex-basis: 100%;
+		}
+
+		& .ck-button:not(.ck-link-actions__preview) {
+			flex-basis: 50%;
+		}
+	}
+}