@ckeditor/ckeditor5-link 48.8.1-alpha.4 → 49.0.0-alpha.0

package/dist/ui/linkformview.d.ts

@@ -1,154 +1,172 @@
 /**
- * @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/linkformview
- */
-import { ButtonView, LabeledFieldView, View, ViewCollection, type InputTextView } from '@ckeditor/ckeditor5-ui';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/linkform.css';
+* @module link/ui/linkformview
+*/
+import { ButtonView, LabeledFieldView, View, ViewCollection, type InputTextView } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The link form view.
- */
+* The link form view.
+*/
 export declare class LinkFormView extends View {
-    /**
-     * 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 Save button view.
-     */
-    saveButtonView: ButtonView;
-    /**
-     * The "Displayed text" input view.
-     */
-    displayedTextInputView: LabeledFieldView<InputTextView>;
-    /**
-     * The URL input view.
-     */
-    urlInputView: LabeledFieldView<InputTextView>;
-    /**
-     * A collection of child views.
-     */
-    readonly children: ViewCollection;
-    /**
-     * A collection of child views in the providers list.
-     */
-    readonly providersListChildren: ViewCollection<ButtonView>;
-    /**
-     * An array of form validators used by {@link #isValid}.
-     */
-    private readonly _validators;
-    /**
-     * 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/linkformview~LinkFormView} class.
-     *
-     * Also see {@link #render}.
-     *
-     * @param locale The localization services instance.
-     * @param validators  Form validators used by {@link #isValid}.
-     */
-    constructor(locale: Locale, validators: Array<LinkFormValidatorCallback>);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the fist {@link #_focusables} in the form.
-     */
-    focus(): void;
-    /**
-     * Validates the form and returns `false` when some fields are invalid.
-     */
-    isValid(): boolean;
-    /**
-     * Cleans up the supplementary error and information text of the {@link #urlInputView}
-     * bringing them back to the state when the form has been displayed for the first time.
-     *
-     * See {@link #isValid}.
-     */
-    resetFormStatus(): void;
-    /**
-     * Creates a back button view that cancels the form.
-     */
-    private _createBackButton;
-    /**
-     * Creates a save button view that inserts the link.
-     */
-    private _createSaveButton;
-    /**
-     * Creates a header view for the form.
-     */
-    private _createHeaderView;
-    /**
-     * Creates a view for the providers list.
-     */
-    private _createProvidersListView;
-    /**
-     * Creates a labeled input view for the "Displayed text" field.
-     */
-    private _createDisplayedTextInput;
-    /**
-     * Creates a labeled input view for the URL field.
-     *
-     * @returns Labeled field view instance.
-     */
-    private _createUrlInput;
-    /**
-     * Populates the {@link #children} collection of the form.
-     */
-    private _createFormChildren;
-    /**
-     * The native DOM `value` of the {@link #urlInputView} element.
-     *
-     * **Note**: Do not confuse it with the {@link module:ui/inputtext/inputtextview~InputTextView#value}
-     * which works one way only and may not represent the actual state of the component in the DOM.
-     */
-    get url(): string | null;
+	/**
+	* 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 Save button view.
+	*/
+	saveButtonView: ButtonView;
+	/**
+	* A button that opens the {@link module:link/ui/linkpropertiesview~LinkPropertiesView} allowing the user to
+	* configure manual decorators for the link handled by this form.
+	*/
+	manualDecoratorsButtonView: ButtonView;
+	/**
+	* The "Displayed text" input view.
+	*/
+	displayedTextInputView: LabeledFieldView<InputTextView>;
+	/**
+	* The URL input view.
+	*/
+	urlInputView: LabeledFieldView<InputTextView>;
+	/**
+	* A collection of child views.
+	*/
+	readonly children: ViewCollection;
+	/**
+	* A collection of child views in the providers list.
+	*/
+	readonly providersListChildren: ViewCollection<ButtonView>;
+	/**
+	* An array of form validators used by {@link #isValid}.
+	*/
+	private readonly _validators;
+	/**
+	* 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/linkformview~LinkFormView} class.
+	*
+	* Also see {@link #render}.
+	*
+	* @param locale The localization services instance.
+	* @param validators  Form validators used by {@link #isValid}.
+	*/
+	constructor(locale: Locale, validators: Array<LinkFormValidatorCallback>);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the fist {@link #_focusables} in the form.
+	*/
+	focus(): void;
+	/**
+	* Validates the form and returns `false` when some fields are invalid.
+	*/
+	isValid(): boolean;
+	/**
+	* Cleans up the supplementary error and information text of the {@link #urlInputView}
+	* bringing them back to the state when the form has been displayed for the first time.
+	*
+	* See {@link #isValid}.
+	*/
+	resetFormStatus(): void;
+	/**
+	* Creates a back button view that cancels the form.
+	*/
+	private _createBackButton;
+	/**
+	* Creates a save button view that inserts the link.
+	*/
+	private _createSaveButton;
+	/**
+	* Creates a button that opens the link properties view.
+	*/
+	private _createManualDecoratorsButton;
+	/**
+	* Creates a header view for the form.
+	*/
+	private _createHeaderView;
+	/**
+	* Creates a view for the providers list.
+	*/
+	private _createProvidersListView;
+	/**
+	* Creates a labeled input view for the "Displayed text" field.
+	*/
+	private _createDisplayedTextInput;
+	/**
+	* Creates a labeled input view for the URL field.
+	*
+	* @returns Labeled field view instance.
+	*/
+	private _createUrlInput;
+	/**
+	* Populates the {@link #children} collection of the form.
+	*/
+	private _createFormChildren;
+	/**
+	* The native DOM `value` of the {@link #urlInputView} element.
+	*
+	* **Note**: Do not confuse it with the {@link module:ui/inputtext/inputtextview~InputTextView#value}
+	* which works one way only and may not represent the actual state of the component in the DOM.
+	*/
+	get url(): string | null;
 }
 /**
- * Callback used by {@link ~LinkFormView} to check if passed form value is valid.
- *
- * 	* If `undefined` is returned, it is assumed that the form value is correct and there is no error.
- * 	* If string is returned, it is assumed that the form value is incorrect and the returned string is displayed in the error label
- */
+* Callback used by {@link ~LinkFormView} to check if passed form value is valid.
+*
+* 	* If `undefined` is returned, it is assumed that the form value is correct and there is no error.
+* 	* If string is returned, it is assumed that the form value is incorrect and the returned string is displayed in the error label
+*/
 export type LinkFormValidatorCallback = (form: LinkFormView) => string | undefined;
 /**
- * Fired when the form view is submitted (when one of the children triggered the submit event),
- * for example with a click on {@link ~LinkFormView#saveButtonView}.
- *
- * @eventName ~LinkFormView#submit
- */
+* Fired when the form view is submitted (when one of the children triggered the submit event),
+* for example with a click on {@link ~LinkFormView#saveButtonView}.
+*
+* @eventName ~LinkFormView#submit
+*/
 export type LinkFormSubmitEvent = {
-    name: 'submit';
-    args: [];
+	name: "submit";
+	args: [];
 };
 /**
- * Fired when the form view is canceled, for example with a click on {@link ~LinkFormView#backButtonView}.
- *
- * @eventName ~LinkFormView#cancel
- */
+* Fired when the form view is canceled, for example with a click on {@link ~LinkFormView#backButtonView}.
+*
+* @eventName ~LinkFormView#cancel
+*/
 export type LinkFormCancelEvent = {
-    name: 'cancel';
-    args: [];
+	name: "cancel";
+	args: [];
+};
+/**
+* Fired when the {@link ~LinkFormView#manualDecoratorsButtonView} is pressed, requesting the link properties
+* (manual decorators) view to be displayed.
+*
+* @eventName ~LinkFormView#showDecorators
+*/
+export type LinkFormShowDecoratorsEvent = {
+	name: "showDecorators";
+	args: [];
 };

package/dist/ui/linkpreviewbuttonview.d.ts

@@ -1,35 +1,35 @@
 /**
- * @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/linkpreviewbuttonview
- */
-import { ButtonView } from '@ckeditor/ckeditor5-ui';
-import type { Locale } from '@ckeditor/ckeditor5-utils';
+* @module link/ui/linkpreviewbuttonview
+*/
+import { ButtonView } from "@ckeditor/ckeditor5-ui";
+import type { Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The link button class. Rendered as an `<a>` tag with link opening in a new tab.
- *
- * Provides a custom `navigate` cancelable event.
- */
+* The link button class. Rendered as an `<a>` tag with link opening in a new tab.
+*
+* Provides a custom `navigate` cancelable event.
+*/
 export declare class LinkPreviewButtonView extends ButtonView {
-    /**
-     * The value of the "href" attribute of the link.
-     *
-     * @observable
-     */
-    href: string | undefined;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale);
+	/**
+	* The value of the "href" attribute of the link.
+	*
+	* @observable
+	*/
+	href: string | undefined;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale);
 }
 /**
- * Fired when the button view is clicked.
- *
- * @eventName ~LinkPreviewButtonView#navigate
- */
+* Fired when the button view is clicked.
+*
+* @eventName ~LinkPreviewButtonView#navigate
+*/
 export type LinkPreviewButtonNavigateEvent = {
-    name: 'navigate';
-    args: [href: string, cancel: () => void];
+	name: "navigate";
+	args: [href: string, cancel: () => void];
 };

package/dist/ui/linkpropertiesview.d.ts

@@ -1,88 +1,87 @@
 /**
- * @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/linkpropertiesview
- */
-import { ButtonView, View, ViewCollection, type SwitchButtonView } from '@ckeditor/ckeditor5-ui';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/linkproperties.css';
+* @module link/ui/linkpropertiesview
+*/
+import { ButtonView, View, ViewCollection, type SwitchButtonView } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The link properties view controller class.
- *
- * See {@link module:link/ui/linkpropertiesview~LinkPropertiesView}.
- */
+* The link properties view controller class.
+*
+* See {@link module:link/ui/linkpropertiesview~LinkPropertiesView}.
+*/
 export declare class LinkPropertiesView extends View {
-    /**
-     * 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;
-    /**
-     * A collection of child views.
-     */
-    readonly children: ViewCollection;
-    /**
-     * A collection of {@link module:ui/button/switchbuttonview~SwitchButtonView},
-     * which corresponds to {@link module:link/linkcommand~LinkCommand#manualDecorators manual decorators}
-     * configured in the editor.
-     */
-    readonly listChildren: ViewCollection<SwitchButtonView>;
-    /**
-     * 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/linkpropertiesview~LinkPropertiesView} 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 back button view.
-     */
-    private _createBackButton;
-    /**
-     * Creates a header view for the form.
-     */
-    private _createHeaderView;
-    /**
-     * Creates a form view that displays the {@link #listChildren} collection.
-     */
-    private _createListView;
+	/**
+	* 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;
+	/**
+	* A collection of child views.
+	*/
+	readonly children: ViewCollection;
+	/**
+	* A collection of {@link module:ui/button/switchbuttonview~SwitchButtonView},
+	* which corresponds to {@link module:link/linkcommand~LinkCommand#manualDecorators manual decorators}
+	* configured in the editor.
+	*/
+	readonly listChildren: ViewCollection<SwitchButtonView>;
+	/**
+	* 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/linkpropertiesview~LinkPropertiesView} 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 back button view.
+	*/
+	private _createBackButton;
+	/**
+	* Creates a header view for the form.
+	*/
+	private _createHeaderView;
+	/**
+	* Creates a form view that displays the {@link #listChildren} collection.
+	*/
+	private _createListView;
 }
 /**
- * Fired when the {@link ~LinkPropertiesView#backButtonView} is pressed.
- *
- * @eventName ~LinkPropertiesView#back
- */
+* Fired when the {@link ~LinkPropertiesView#backButtonView} is pressed.
+*
+* @eventName ~LinkPropertiesView#back
+*/
 export type LinkPropertiesBackEvent = {
-    name: 'back';
-    args: [];
+	name: "back";
+	args: [];
 };