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

package/dist/legacyerrors.d.ts

@@ -1,5 +1 @@
-/**
- * @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
- */
 export {};

package/dist/multicommand.d.ts

@@ -1,66 +1,66 @@
 /**
- * @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 core/multicommand
- */
-import { Command } from './command.js';
-import { type PriorityString } from '@ckeditor/ckeditor5-utils';
+* @module core/multicommand
+*/
+import { Command } from "./command.js";
+import { type PriorityString } from "@ckeditor/ckeditor5-utils";
 /**
- * A CKEditor command that aggregates other commands.
- *
- * This command is used to proxy multiple commands. The multi-command is enabled when
- * at least one of its registered child commands is enabled.
- * When executing a multi-command, the first enabled command with highest priority will be executed.
- *
- * ```ts
- * const multiCommand = new MultiCommand( editor );
- *
- * const commandFoo = new Command( editor );
- * const commandBar = new Command( editor );
- *
- * // Register a child command.
- * multiCommand.registerChildCommand( commandFoo );
- * // Register a child command with a low priority.
- * multiCommand.registerChildCommand( commandBar, { priority: 'low' } );
- *
- * // Enable one of the commands.
- * commandBar.isEnabled = true;
- *
- * multiCommand.execute(); // Will execute commandBar.
- * ```
- */
+* A CKEditor command that aggregates other commands.
+*
+* This command is used to proxy multiple commands. The multi-command is enabled when
+* at least one of its registered child commands is enabled.
+* When executing a multi-command, the first enabled command with highest priority will be executed.
+*
+* ```ts
+* const multiCommand = new MultiCommand( editor );
+*
+* const commandFoo = new Command( editor );
+* const commandBar = new Command( editor );
+*
+* // Register a child command.
+* multiCommand.registerChildCommand( commandFoo );
+* // Register a child command with a low priority.
+* multiCommand.registerChildCommand( commandBar, { priority: 'low' } );
+*
+* // Enable one of the commands.
+* commandBar.isEnabled = true;
+*
+* multiCommand.execute(); // Will execute commandBar.
+* ```
+*/
 export declare class MultiCommand extends Command {
-    /**
-     * Registered child commands definitions.
-     */
-    private _childCommandsDefinitions;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Executes the first enabled command which has the highest priority of all registered child commands.
-     *
-     * @returns The value returned by the {@link module:core/command~Command#execute `command.execute()`}.
-     */
-    execute(...args: Array<unknown>): unknown;
-    /**
-     * Registers a child command.
-     *
-     * @param options An object with configuration options.
-     * @param options.priority Priority of a command to register.
-     */
-    registerChildCommand(command: Command, options?: {
-        priority?: PriorityString;
-    }): void;
-    /**
-     * Checks if any of child commands is enabled.
-     */
-    private _checkEnabled;
-    /**
-     * Returns a first enabled command with the highest priority or `undefined` if none of them is enabled.
-     */
-    private _getFirstEnabledCommand;
+	/**
+	* Registered child commands definitions.
+	*/
+	private _childCommandsDefinitions;
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* Executes the first enabled command which has the highest priority of all registered child commands.
+	*
+	* @returns The value returned by the {@link module:core/command~Command#execute `command.execute()`}.
+	*/
+	override execute(...args: Array<unknown>): unknown;
+	/**
+	* Registers a child command.
+	*
+	* @param options An object with configuration options.
+	* @param options.priority Priority of a command to register.
+	*/
+	registerChildCommand(command: Command, options?: {
+		priority?: PriorityString;
+	}): void;
+	/**
+	* Checks if any of child commands is enabled.
+	*/
+	private _checkEnabled;
+	/**
+	* Returns a first enabled command with the highest priority or `undefined` if none of them is enabled.
+	*/
+	private _getFirstEnabledCommand;
 }

package/dist/pendingactions.d.ts

@@ -1,122 +1,122 @@
 /**
- * @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 core/pendingactions
- */
-import { ContextPlugin } from './contextplugin.js';
-import { type CollectionAddEvent, type CollectionRemoveEvent, type Observable } from '@ckeditor/ckeditor5-utils';
+* @module core/pendingactions
+*/
+import { ContextPlugin } from "./contextplugin.js";
+import { type CollectionAddEvent, type CollectionRemoveEvent, type Observable } from "@ckeditor/ckeditor5-utils";
 /**
- * The list of pending editor actions.
- *
- * This plugin should be used to synchronise plugins that execute long-lasting actions
- * (e.g. file upload) with the editor integration. It gives the developer who integrates the editor
- * an easy way to check if there are any actions pending whenever such information is needed.
- * All plugins that register a pending action also provide a message about the action that is ongoing
- * which can be displayed to the user. This lets them decide if they want to interrupt the action or wait.
- *
- * Adding and updating a pending action:
- *
- * ```ts
- * const pendingActions = editor.plugins.get( 'PendingActions' );
- * const action = pendingActions.add( 'Upload in progress: 0%.' );
- *
- * // You can update the message:
- * action.message = 'Upload in progress: 10%.';
- * ```
- *
- * Removing a pending action:
- *
- * ```ts
- * const pendingActions = editor.plugins.get( 'PendingActions' );
- * const action = pendingActions.add( 'Unsaved changes.' );
- *
- * pendingActions.remove( action );
- * ```
- *
- * Getting pending actions:
- *
- * ```ts
- * const pendingActions = editor.plugins.get( 'PendingActions' );
- *
- * const action1 = pendingActions.add( 'Action 1' );
- * const action2 = pendingActions.add( 'Action 2' );
- *
- * pendingActions.first; // Returns action1
- * Array.from( pendingActions ); // Returns [ action1, action2 ]
- * ```
- *
- * This plugin is used by features like {@link module:upload/filerepository~FileRepository} to register their ongoing actions
- * and by features like {@link module:autosave/autosave~Autosave} to detect whether there are any ongoing actions.
- * Read more about saving the data in the
- * {@glink getting-started/setup/getting-and-setting-data Saving and getting data} guide.
- */
+* The list of pending editor actions.
+*
+* This plugin should be used to synchronise plugins that execute long-lasting actions
+* (e.g. file upload) with the editor integration. It gives the developer who integrates the editor
+* an easy way to check if there are any actions pending whenever such information is needed.
+* All plugins that register a pending action also provide a message about the action that is ongoing
+* which can be displayed to the user. This lets them decide if they want to interrupt the action or wait.
+*
+* Adding and updating a pending action:
+*
+* ```ts
+* const pendingActions = editor.plugins.get( 'PendingActions' );
+* const action = pendingActions.add( 'Upload in progress: 0%.' );
+*
+* // You can update the message:
+* action.message = 'Upload in progress: 10%.';
+* ```
+*
+* Removing a pending action:
+*
+* ```ts
+* const pendingActions = editor.plugins.get( 'PendingActions' );
+* const action = pendingActions.add( 'Unsaved changes.' );
+*
+* pendingActions.remove( action );
+* ```
+*
+* Getting pending actions:
+*
+* ```ts
+* const pendingActions = editor.plugins.get( 'PendingActions' );
+*
+* const action1 = pendingActions.add( 'Action 1' );
+* const action2 = pendingActions.add( 'Action 2' );
+*
+* pendingActions.first; // Returns action1
+* Array.from( pendingActions ); // Returns [ action1, action2 ]
+* ```
+*
+* This plugin is used by features like {@link module:upload/filerepository~FileRepository} to register their ongoing actions
+* and by features like {@link module:autosave/autosave~Autosave} to detect whether there are any ongoing actions.
+* Read more about saving the data in the
+* {@glink getting-started/setup/getting-and-setting-data Saving and getting data} guide.
+*/
 export declare class PendingActions extends ContextPlugin implements Iterable<PendingAction> {
-    /**
-     * Defines whether there is any registered pending action.
-     *
-     * @readonly
-     * @observable
-     */
-    hasAny: boolean;
-    /**
-     * A list of pending actions.
-     */
-    private _actions;
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "PendingActions";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Adds an action to the list of pending actions.
-     *
-     * This method returns an action object with an observable message property.
-     * The action object can be later used in the {@link #remove} method. It also allows you to change the message.
-     *
-     * @param message The action message.
-     * @returns An observable object that represents a pending action.
-     */
-    add(message: string): PendingAction;
-    /**
-     * Removes an action from the list of pending actions.
-     *
-     * @param action An action object.
-     */
-    remove(action: PendingAction): void;
-    /**
-     * Returns the first action from the list or null if the list is empty
-     *
-     * @returns The pending action object.
-     */
-    get first(): PendingAction | null;
-    /**
-     * Iterable interface.
-     */
-    [Symbol.iterator](): Iterator<PendingAction>;
+	/**
+	* Defines whether there is any registered pending action.
+	*
+	* @readonly
+	* @observable
+	*/
+	hasAny: boolean;
+	/**
+	* A list of pending actions.
+	*/
+	private _actions;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "PendingActions";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Adds an action to the list of pending actions.
+	*
+	* This method returns an action object with an observable message property.
+	* The action object can be later used in the {@link #remove} method. It also allows you to change the message.
+	*
+	* @param message The action message.
+	* @returns An observable object that represents a pending action.
+	*/
+	add(message: string): PendingAction;
+	/**
+	* Removes an action from the list of pending actions.
+	*
+	* @param action An action object.
+	*/
+	remove(action: PendingAction): void;
+	/**
+	* Returns the first action from the list or null if the list is empty
+	*
+	* @returns The pending action object.
+	*/
+	get first(): PendingAction | null;
+	/**
+	* Iterable interface.
+	*/
+	[Symbol.iterator](): Iterator<PendingAction>;
 }
 export interface PendingAction extends Observable {
-    message: string;
+	message: string;
 }
 /**
- * Fired when an action is added to the list.
- *
- * @eventName ~PendingActions#add
- * @param action The added action.
- */
+* Fired when an action is added to the list.
+*
+* @eventName ~PendingActions#add
+* @param action The added action.
+*/
 export type PendingActionsAddEvent = CollectionAddEvent<PendingAction>;
 /**
- * Fired when an action is removed from the list.
- *
- * @eventName ~PendingActions#remove
- * @param action The removed action.
- */
+* Fired when an action is removed from the list.
+*
+* @eventName ~PendingActions#remove
+* @param action The removed action.
+*/
 export type PendingActionsRemoveEvent = CollectionRemoveEvent<PendingAction>;