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

package/dist/ui/linkprovideritemsview.d.ts

@@ -1,114 +1,114 @@
 /**
- * @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/ui/linkprovideritemsview
- */
-import { ButtonView, View, ListView, ViewCollection } from '@ckeditor/ckeditor5-ui';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/linkprovideritems.css';
+* @module link/ui/linkprovideritemsview
+*/
+import { ButtonView, View, ListView, ViewCollection } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import "../../theme/linkprovideritems.css";
 /**
- * The link provider items view.
- */
+* The link provider items view.
+*/
 export declare class LinkProviderItemsView extends View {
-    /**
-     * Tracks information about the list of links.
-     *
-     * @observable
-     */
-    hasItems: boolean;
-    /**
-     * The header label of the view.
-     *
-     * @observable
-     */
-    title: string;
-    /**
-     * The text displayed when no links are available.
-     *
-     * @observable
-     */
-    emptyListPlaceholder: string;
-    /**
-     * Tracks information about DOM focus in the form.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * The Back button view displayed in the header.
-     */
-    backButtonView: ButtonView;
-    /**
-     * The List view of links buttons.
-     */
-    listView: ListView;
-    /**
-     * The collection of child views, which is bind with the `listView`.
-     */
-    readonly listChildren: ViewCollection<ButtonView>;
-    /**
-     * The view displayed when the list is empty.
-     */
-    emptyListInformation: View;
-    /**
-     * A collection of child views.
-     */
-    children: ViewCollection;
-    /**
-     * A collection of views that can be focused in the form.
-     */
-    private readonly _focusables;
-    /**
-     * Helps cycling over {@link #_focusables} in the form.
-     */
-    private readonly _focusCycler;
-    /**
-     * Creates an instance of the {@link module:link/ui/linkprovideritemsview~LinkProviderItemsView} class.
-     *
-     * Also see {@link #render}.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the fist {@link #_focusables} in the form.
-     */
-    focus(): void;
-    /**
-     * Creates a view for the list at the bottom.
-     */
-    private _createListView;
-    /**
-     * Creates a back button view that cancels the form.
-     */
-    private _createBackButton;
-    /**
-     * Creates a header view for the form.
-     */
-    private _createHeaderView;
-    /**
-     * Creates an info view for an empty list.
-     */
-    private _createEmptyLinksListItemView;
+	/**
+	* Tracks information about the list of links.
+	*
+	* @observable
+	*/
+	hasItems: boolean;
+	/**
+	* The header label of the view.
+	*
+	* @observable
+	*/
+	title: string;
+	/**
+	* The text displayed when no links are available.
+	*
+	* @observable
+	*/
+	emptyListPlaceholder: string;
+	/**
+	* Tracks information about DOM focus in the form.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* The Back button view displayed in the header.
+	*/
+	backButtonView: ButtonView;
+	/**
+	* The List view of links buttons.
+	*/
+	listView: ListView;
+	/**
+	* The collection of child views, which is bind with the `listView`.
+	*/
+	readonly listChildren: ViewCollection<ButtonView>;
+	/**
+	* The view displayed when the list is empty.
+	*/
+	emptyListInformation: View;
+	/**
+	* A collection of child views.
+	*/
+	children: ViewCollection;
+	/**
+	* A collection of views that can be focused in the form.
+	*/
+	private readonly _focusables;
+	/**
+	* Helps cycling over {@link #_focusables} in the form.
+	*/
+	private readonly _focusCycler;
+	/**
+	* Creates an instance of the {@link module:link/ui/linkprovideritemsview~LinkProviderItemsView} class.
+	*
+	* Also see {@link #render}.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the fist {@link #_focusables} in the form.
+	*/
+	focus(): void;
+	/**
+	* Creates a view for the list at the bottom.
+	*/
+	private _createListView;
+	/**
+	* Creates a back button view that cancels the form.
+	*/
+	private _createBackButton;
+	/**
+	* Creates a header view for the form.
+	*/
+	private _createHeaderView;
+	/**
+	* Creates an info view for an empty list.
+	*/
+	private _createEmptyLinksListItemView;
 }
 /**
- * Fired when the links view is canceled, for example with a click on {@link ~LinkProviderItemsView#backButtonView}.
- *
- * @eventName ~LinkProviderItemsView#cancel
- */
+* Fired when the links view is canceled, for example with a click on {@link ~LinkProviderItemsView#backButtonView}.
+*
+* @eventName ~LinkProviderItemsView#cancel
+*/
 export type LinkProvidersCancelEvent = {
-    name: 'cancel';
-    args: [];
+	name: "cancel";
+	args: [];
 };

package/dist/unlinkcommand.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/unlinkcommand
- */
-import { Command } from '@ckeditor/ckeditor5-core';
+* @module link/unlinkcommand
+*/
+import { Command } from "@ckeditor/ckeditor5-core";
 /**
- * The unlink command. It is used by the {@link module:link/link~Link link plugin}.
- */
+* The unlink command. It is used by the {@link module:link/link~Link link plugin}.
+*/
 export declare 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;
+	/**
+	* @inheritDoc
+	*/
+	override 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
+	*/
+	override execute(): void;
 }

package/dist/utils/automaticdecorators.d.ts

@@ -1,61 +1,61 @@
 /**
- * @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/utils/automaticdecorators
- */
-import { type ArrayOrItem } from '@ckeditor/ckeditor5-utils';
-import type { DowncastDispatcher, ModelDocumentSelection, ModelItem, ModelSelection } from '@ckeditor/ckeditor5-engine';
-import type { NormalizedLinkDecoratorAutomaticDefinition } from '../utils.js';
+* @module link/utils/automaticdecorators
+*/
+import { type ArrayOrItem } from "@ckeditor/ckeditor5-utils";
+import type { DowncastDispatcher, ModelDocumentSelection, ModelItem, ModelSelection } from "@ckeditor/ckeditor5-engine";
+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.
- */
+* 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 declare class AutomaticLinkDecorators {
-    /**
-     * 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;
-    /**
-     * A callback that checks if a decorator can be applied to a given element.
-     * Returns `true` if there is a conflict preventing the decorator from being applied.
-     */
-    private _conflictChecker?;
-    /**
-     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators}
-     * instance.
-     */
-    get length(): number;
-    /**
-     * Sets a callback that checks if a decorator can be applied to a given element.
-     *
-     * @param checker A function that returns `true` if there is a conflict preventing the decorator from being applied.
-     */
-    setConflictChecker(checker: LinkDecoratorConflictChecker): void;
-    /**
-     * 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;
+	/**
+	* 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;
+	/**
+	* A callback that checks if a decorator can be applied to a given element.
+	* Returns `true` if there is a conflict preventing the decorator from being applied.
+	*/
+	private _conflictChecker?;
+	/**
+	* Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators}
+	* instance.
+	*/
+	get length(): number;
+	/**
+	* Sets a callback that checks if a decorator can be applied to a given element.
+	*
+	* @param checker A function that returns `true` if there is a conflict preventing the decorator from being applied.
+	*/
+	setConflictChecker(checker: LinkDecoratorConflictChecker): void;
+	/**
+	* 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;
 }
 /**
- * A callback that checks if a decorator can be applied to a given element.
- * Returns `true` if there is a conflict preventing the decorator from being applied.
- */
+* A callback that checks if a decorator can be applied to a given element.
+* Returns `true` if there is a conflict preventing the decorator from being applied.
+*/
 export type LinkDecoratorConflictChecker = (decorator: NormalizedLinkDecoratorAutomaticDefinition, modelItem: ModelItem | ModelSelection | ModelDocumentSelection) => boolean | undefined;

package/dist/utils/conflictingdecorators.d.ts

@@ -1,43 +1,43 @@
 /**
- * @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/utils/conflictingdecorators
- */
+* @module link/utils/conflictingdecorators
+*/
 /**
- * Checks if two decorators conflict with each other.
- *
- * Decorators conflict when they share the same HTML attribute names (excluding mergeable attributes)
- * or style properties.
- *
- * @internal
- * @param a The first decorator.
- * @param b The second decorator.
- */
+* Checks if two decorators conflict with each other.
+*
+* Decorators conflict when they share the same HTML attribute names (excluding mergeable attributes)
+* or style properties.
+*
+* @internal
+* @param a The first decorator.
+* @param b The second decorator.
+*/
 export declare function areDecoratorsConflicting(a: DecoratorLike, b: DecoratorLike): boolean;
 /**
- * Resolves conflicting manual decorators by automatically disabling decorators that share
- * the same HTML attributes with newly enabled decorators.
- *
- * @internal
- * @param options Configuration object.
- * @param options.decoratorStates Initial decorator states.
- * @param options.allDecorators Collection of all manual decorators.
- * @returns Updated decorator states with conflicts resolved.
- */
+* Resolves conflicting manual decorators by automatically disabling decorators that share
+* the same HTML attributes with newly enabled decorators.
+*
+* @internal
+* @param options Configuration object.
+* @param options.decoratorStates Initial decorator states.
+* @param options.allDecorators Collection of all manual decorators.
+* @returns Updated decorator states with conflicts resolved.
+*/
 export declare function resolveConflictingDecorators({ decoratorStates, allDecorators }: {
-    decoratorStates: Record<string, boolean>;
-    allDecorators: Array<DecoratorLike & {
-        value?: boolean;
-    }>;
+	decoratorStates: Record<string, boolean>;
+	allDecorators: Array<DecoratorLike & {
+		value?: boolean;
+	}>;
 }): Record<string, boolean>;
 /**
- * Decorator-like object representing attributes and styles.
- */
+* Decorator-like object representing attributes and styles.
+*/
 type DecoratorLike = {
-    id: string;
-    attributes?: Record<string, string>;
-    styles?: Record<string, string>;
+	id: string;
+	attributes?: Record<string, string>;
+	styles?: Record<string, string>;
 };
 export {};

package/dist/utils/manualdecorator.d.ts

@@ -1,67 +1,64 @@
 /**
- * @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/utils/manualdecorator
- */
-import { type ArrayOrItem } from '@ckeditor/ckeditor5-utils';
-import type { MatcherObjectPattern } from '@ckeditor/ckeditor5-engine';
-import type { NormalizedLinkDecoratorManualDefinition } from '../utils.js';
-declare const LinkManualDecorator_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Observable;
-    prototype: import("@ckeditor/ckeditor5-utils").Observable;
-};
+* @module link/utils/manualdecorator
+*/
+import { type ArrayOrItem, type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
+import type { MatcherObjectPattern } from "@ckeditor/ckeditor5-engine";
+import type { NormalizedLinkDecoratorManualDefinition } from "../utils.js";
+declare const LinkManualDecoratorBase: ObservableMixinConstructor;
 /**
- * Helper class that stores manual decorators with observable {@link module:link/utils/manualdecorator~LinkManualDecorator#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 declare class LinkManualDecorator extends /* #__PURE__ */ LinkManualDecorator_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~ViewElementDefinition}.
-     */
-    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~ViewElementDefinition}.
-     */
-    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~ViewElementDefinition}.
-     */
-    styles?: Record<string, string>;
-    /**
-     * Creates a new instance of {@link module:link/utils/manualdecorator~LinkManualDecorator}.
-     *
-     * @param options The configuration object.
-     */
-    constructor({ id, label, attributes, classes, styles, defaultValue }: NormalizedLinkDecoratorManualDefinition);
-    /**
-     * Returns {@link module:engine/view/matcher~MatcherPattern} with decorator attributes.
-     *
-     * @internal
-     */
-    _createPattern(): MatcherObjectPattern;
+* Helper class that stores manual decorators with observable {@link module:link/utils/manualdecorator~LinkManualDecorator#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 declare class LinkManualDecorator extends LinkManualDecoratorBase {
+	/**
+	* 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~ViewElementDefinition}.
+	*/
+	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~ViewElementDefinition}.
+	*/
+	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~ViewElementDefinition}.
+	*/
+	styles?: Record<string, string>;
+	/**
+	* Creates a new instance of {@link module:link/utils/manualdecorator~LinkManualDecorator}.
+	*
+	* @param options The configuration object.
+	*/
+	constructor({ id, label, attributes, classes, styles, defaultValue }: NormalizedLinkDecoratorManualDefinition);
+	/**
+	* Returns {@link module:engine/view/matcher~MatcherPattern} with decorator attributes.
+	*
+	* @internal
+	*/
+	_createPattern(): MatcherObjectPattern;
 }
 export {};