@ckeditor/ckeditor5-link 48.2.0 → 48.3.0-alpha.1

package/dist/linkediting.d.ts

@@ -1,96 +1,96 @@
 /**
- * @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
- */
+* @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/linkediting
- */
-import { Plugin, type Editor } from '@ckeditor/ckeditor5-core';
-import { Input, TwoStepCaretMovement } from '@ckeditor/ckeditor5-typing';
-import { ClipboardPipeline } from '@ckeditor/ckeditor5-clipboard';
-import '../theme/link.css';
+* @module link/linkediting
+*/
+import { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { Input, TwoStepCaretMovement } from "@ckeditor/ckeditor5-typing";
+import { ClipboardPipeline } from "@ckeditor/ckeditor5-clipboard";
+import "../theme/link.css";
 /**
- * The link engine feature.
- *
- * It introduces the `linkHref="url"` attribute in the model which renders to the view as a `<a href="url">` element
- * as well as `'link'` and `'unlink'` commands.
- */
+* The link engine feature.
+*
+* It introduces the `linkHref="url"` attribute in the model which renders to the view as a `<a href="url">` element
+* as well as `'link'` and `'unlink'` commands.
+*/
 export declare class LinkEditing extends Plugin {
-    /**
-     * A list of functions that handles opening links. If any of them returns `true`, the link is considered to be opened.
-     */
-    private readonly _linkOpeners;
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "LinkEditing";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TwoStepCaretMovement, typeof Input, typeof ClipboardPipeline];
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Registers a function that opens links in a new browser tab.
-     *
-     * @param linkOpener The function that opens a link in a new browser tab.
-     * @internal
-     */
-    _registerLinkOpener(linkOpener: LinkOpener): void;
-    /**
-     * Processes an array of configured {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}
-     * and registers a {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher downcast dispatcher}
-     * for each one of them. Downcast dispatchers are obtained using the
-     * {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators#getDispatcher} method.
-     *
-     * **Note**: This method also activates the automatic external link decorator if enabled with
-     * {@link module:link/linkconfig~LinkConfig#addTargetToExternalLinks `config.link.addTargetToExternalLinks`}.
-     */
-    private _enableAutomaticDecorators;
-    /**
-     * Processes an array of configured {@link module:link/linkconfig~LinkDecoratorManualDefinition manual decorators},
-     * transforms them into {@link module:link/utils/manualdecorator~LinkManualDecorator} instances and stores them in the
-     * {@link module:link/linkcommand~LinkCommand#manualDecorators} collection (a model for manual decorators state).
-     *
-     * Also registers an {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement attribute-to-element}
-     * converter for each manual decorator and extends the {@link module:engine/model/schema~ModelSchema model's schema}
-     * with adequate model attributes.
-     */
-    private _enableManualDecorators;
-    /**
-     * Attaches handlers for {@link module:engine/view/document~ViewDocument#event:enter} and
-     * {@link module:engine/view/document~ViewDocument#event:click} to enable link following.
-     */
-    private _enableLinkOpen;
-    /**
-     * Watches the ModelDocumentSelection attribute changes and removes link decorator attributes when the linkHref attribute is removed.
-     *
-     * This is to ensure that there is no left-over link decorator attributes on the document selection that is no longer in a link.
-     */
-    private _enableSelectionAttributesFixer;
-    /**
-     * Enables URL fixing on pasting.
-     */
-    private _enableClipboardIntegration;
-    /**
-     * Registers a postfixer that resolves conflicting decorator attributes on elements.
-     */
-    private _enableDecoratorConflictPostfixer;
+	/**
+	* A list of functions that handles opening links. If any of them returns `true`, the link is considered to be opened.
+	*/
+	private readonly _linkOpeners;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "LinkEditing";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[TwoStepCaretMovement, Input, ClipboardPipeline]>;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Registers a function that opens links in a new browser tab.
+	*
+	* @param linkOpener The function that opens a link in a new browser tab.
+	* @internal
+	*/
+	_registerLinkOpener(linkOpener: LinkOpener): void;
+	/**
+	* Processes an array of configured {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}
+	* and registers a {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher downcast dispatcher}
+	* for each one of them. Downcast dispatchers are obtained using the
+	* {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators#getDispatcher} method.
+	*
+	* **Note**: This method also activates the automatic external link decorator if enabled with
+	* {@link module:link/linkconfig~LinkConfig#addTargetToExternalLinks `config.link.addTargetToExternalLinks`}.
+	*/
+	private _enableAutomaticDecorators;
+	/**
+	* Processes an array of configured {@link module:link/linkconfig~LinkDecoratorManualDefinition manual decorators},
+	* transforms them into {@link module:link/utils/manualdecorator~LinkManualDecorator} instances and stores them in the
+	* {@link module:link/linkcommand~LinkCommand#manualDecorators} collection (a model for manual decorators state).
+	*
+	* Also registers an {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement attribute-to-element}
+	* converter for each manual decorator and extends the {@link module:engine/model/schema~ModelSchema model's schema}
+	* with adequate model attributes.
+	*/
+	private _enableManualDecorators;
+	/**
+	* Attaches handlers for {@link module:engine/view/document~ViewDocument#event:enter} and
+	* {@link module:engine/view/document~ViewDocument#event:click} to enable link following.
+	*/
+	private _enableLinkOpen;
+	/**
+	* Watches the ModelDocumentSelection attribute changes and removes link decorator attributes when the linkHref attribute is removed.
+	*
+	* This is to ensure that there is no left-over link decorator attributes on the document selection that is no longer in a link.
+	*/
+	private _enableSelectionAttributesFixer;
+	/**
+	* Enables URL fixing on pasting.
+	*/
+	private _enableClipboardIntegration;
+	/**
+	* Registers a postfixer that resolves conflicting decorator attributes on elements.
+	*/
+	private _enableDecoratorConflictPostfixer;
 }
 /**
- * A function that handles opening links. It may be used to define custom link handlers.
- *
- * @returns `true` if the link was opened successfully.
- */
+* A function that handles opening links. It may be used to define custom link handlers.
+*
+* @returns `true` if the link was opened successfully.
+*/
 type LinkOpener = (url: string) => boolean;
 export {};

package/dist/linkimage.d.ts

@@ -1,31 +1,31 @@
 /**
- * @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
- */
+* @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/linkimage
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { LinkImageEditing } from './linkimageediting.js';
-import { LinkImageUI } from './linkimageui.js';
-import '../theme/linkimage.css';
+* @module link/linkimage
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { LinkImageEditing } from "./linkimageediting.js";
+import { LinkImageUI } from "./linkimageui.js";
+import "../theme/linkimage.css";
 /**
- * The `LinkImage` plugin.
- *
- * This is a "glue" plugin that loads the {@link module:link/linkimageediting~LinkImageEditing link image editing feature}
- * and {@link module:link/linkimageui~LinkImageUI link image UI feature}.
- */
+* The `LinkImage` plugin.
+*
+* This is a "glue" plugin that loads the {@link module:link/linkimageediting~LinkImageEditing link image editing feature}
+* and {@link module:link/linkimageui~LinkImageUI link image UI feature}.
+*/
 export declare class LinkImage extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof LinkImageEditing, typeof LinkImageUI];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "LinkImage";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[LinkImageEditing, LinkImageUI]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "LinkImage";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
 }

package/dist/linkimageediting.d.ts

@@ -1,44 +1,44 @@
 /**
- * @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
- */
+* @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/linkimageediting
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { LinkEditing } from './linkediting.js';
-import { ImageEditing, ImageUtils } from '@ckeditor/ckeditor5-image';
+* @module link/linkimageediting
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { LinkEditing } from "./linkediting.js";
+import { ImageEditing, ImageUtils } from "@ckeditor/ckeditor5-image";
 /**
- * The link image engine feature.
- *
- * It accepts the `linkHref="url"` attribute in the model for the {@link module:image/image~Image `<imageBlock>`} element
- * which allows linking images.
- */
+* The link image engine feature.
+*
+* It accepts the `linkHref="url"` attribute in the model for the {@link module:image/image~Image `<imageBlock>`} element
+* which allows linking images.
+*/
 export declare class LinkImageEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageEditing, typeof ImageUtils, typeof LinkEditing];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "LinkImageEditing";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
-    /**
-     * Processes {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators} definitions and
-     * attaches proper converters that will work when linking an image.`
-     */
-    private _enableAutomaticDecorators;
-    /**
-     * Processes transformed {@link module:link/utils/manualdecorator~LinkManualDecorator} instances and attaches proper converters
-     * that will work when linking an image.
-     */
-    private _enableManualDecorators;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[ImageEditing, ImageUtils, LinkEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "LinkImageEditing";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
+	/**
+	* Processes {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators} definitions and
+	* attaches proper converters that will work when linking an image.`
+	*/
+	private _enableAutomaticDecorators;
+	/**
+	* Processes transformed {@link module:link/utils/manualdecorator~LinkManualDecorator} instances and attaches proper converters
+	* that will work when linking an image.
+	*/
+	private _enableManualDecorators;
 }

package/dist/linkimageui.d.ts

@@ -1,45 +1,45 @@
 /**
- * @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
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { ImageBlockEditing } from '@ckeditor/ckeditor5-image';
-import { LinkUI } from './linkui.js';
-import { LinkEditing } from './linkediting.js';
+* @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
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { ImageBlockEditing } from "@ckeditor/ckeditor5-image";
+import { LinkUI } from "./linkui.js";
+import { LinkEditing } from "./linkediting.js";
 /**
- * The link image UI plugin.
- *
- * This plugin provides the `'linkImage'` button that can be displayed in the {@link module:image/imagetoolbar~ImageToolbar}.
- * It can be used to wrap images in links.
- */
+* The link image UI plugin.
+*
+* This plugin provides the `'linkImage'` button that can be displayed in the {@link module:image/imagetoolbar~ImageToolbar}.
+* It can be used to wrap images in links.
+*/
 export declare class LinkImageUI extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof LinkEditing, typeof LinkUI, typeof ImageBlockEditing];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "LinkImageUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Creates a `LinkImageUI` button view.
-     *
-     * Clicking this button shows a {@link module:link/linkui~LinkUI#_balloon} attached to the selection.
-     * When an image is already linked, the view shows {@link module:link/linkui~LinkUI#toolbarView} or
-     * {@link module:link/linkui~LinkUI#formView} if it is not.
-     */
-    private _createToolbarLinkImageButton;
-    /**
-     * Returns true if a linked image (either block or inline) is the only selected element
-     * in the model document.
-     */
-    private _isSelectedLinkedImage;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[LinkEditing, LinkUI, ImageBlockEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "LinkImageUI";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Creates a `LinkImageUI` button view.
+	*
+	* Clicking this button shows a {@link module:link/linkui~LinkUI#_balloon} attached to the selection.
+	* When an image is already linked, the view shows {@link module:link/linkui~LinkUI#toolbarView} or
+	* {@link module:link/linkui~LinkUI#formView} if it is not.
+	*/
+	private _createToolbarLinkImageButton;
+	/**
+	* Returns true if a linked image (either block or inline) is the only selected element
+	* in the model document.
+	*/
+	private _isSelectedLinkedImage;
 }