@ckeditor/ckeditor5-core 40.0.0 → 40.2.0

package/src/index.d.ts

@@ -1,62 +1,66 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module core
- */
-export { default as Plugin, type PluginDependencies, type PluginConstructor } from './plugin';
-export { default as Command, type CommandExecuteEvent } from './command';
-export { default as MultiCommand } from './multicommand';
-export type { CommandsMap } from './commandcollection';
-export type { PluginsMap, default as PluginCollection } from './plugincollection';
-export { default as Context, type ContextConfig } from './context';
-export { default as ContextPlugin, type ContextPluginDependencies } from './contextplugin';
-export { type EditingKeystrokeCallback } from './editingkeystrokehandler';
-export { default as Editor, type EditorReadyEvent, type EditorDestroyEvent } from './editor/editor';
-export type { EditorConfig, LanguageConfig, ToolbarConfig, ToolbarConfigItem, UiConfig } from './editor/editorconfig';
-export { default as attachToForm } from './editor/utils/attachtoform';
-export { default as DataApiMixin, type DataApi } from './editor/utils/dataapimixin';
-export { default as ElementApiMixin, type ElementApi } from './editor/utils/elementapimixin';
-export { default as secureSourceElement } from './editor/utils/securesourceelement';
-export { default as PendingActions, type PendingAction } from './pendingactions';
-export declare const icons: {
-    bold: string;
-    cancel: string;
-    caption: string;
-    check: string;
-    cog: string;
-    eraser: string;
-    history: string;
-    image: string;
-    lowVision: string;
-    loupe: string;
-    importExport: string;
-    paragraph: string;
-    plus: string;
-    text: string;
-    alignBottom: string;
-    alignMiddle: string;
-    alignTop: string;
-    alignLeft: string;
-    alignCenter: string;
-    alignRight: string;
-    alignJustify: string;
-    objectLeft: string;
-    objectCenter: string;
-    objectRight: string;
-    objectFullWidth: string;
-    objectInline: string;
-    objectBlockLeft: string;
-    objectBlockRight: string;
-    objectSizeFull: string;
-    objectSizeLarge: string;
-    objectSizeSmall: string;
-    objectSizeMedium: string;
-    pencil: string;
-    pilcrow: string;
-    quote: string;
-    threeVerticalDots: string;
-    dragIndicator: string;
-};
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module core
+ */
+export { default as Plugin, type PluginDependencies, type PluginConstructor } from './plugin';
+export { default as Command, type CommandExecuteEvent } from './command';
+export { default as MultiCommand } from './multicommand';
+export type { CommandsMap } from './commandcollection';
+export type { PluginsMap, default as PluginCollection } from './plugincollection';
+export { default as Context, type ContextConfig } from './context';
+export { default as ContextPlugin, type ContextPluginDependencies } from './contextplugin';
+export { type EditingKeystrokeCallback } from './editingkeystrokehandler';
+export { default as Editor, type EditorReadyEvent, type EditorDestroyEvent } from './editor/editor';
+export type { EditorConfig, LanguageConfig, ToolbarConfig, ToolbarConfigItem, UiConfig } from './editor/editorconfig';
+export { default as attachToForm } from './editor/utils/attachtoform';
+export { default as DataApiMixin, type DataApi } from './editor/utils/dataapimixin';
+export { default as ElementApiMixin, type ElementApi } from './editor/utils/elementapimixin';
+export { default as secureSourceElement } from './editor/utils/securesourceelement';
+export { default as PendingActions, type PendingAction } from './pendingactions';
+export declare const icons: {
+    bold: string;
+    cancel: string;
+    caption: string;
+    check: string;
+    cog: string;
+    eraser: string;
+    history: string;
+    image: string;
+    imageUpload: string;
+    imageAssetManager: string;
+    imageUrl: string;
+    lowVision: string;
+    textAlternative: string;
+    loupe: string;
+    importExport: string;
+    paragraph: string;
+    plus: string;
+    text: string;
+    alignBottom: string;
+    alignMiddle: string;
+    alignTop: string;
+    alignLeft: string;
+    alignCenter: string;
+    alignRight: string;
+    alignJustify: string;
+    objectLeft: string;
+    objectCenter: string;
+    objectRight: string;
+    objectFullWidth: string;
+    objectInline: string;
+    objectBlockLeft: string;
+    objectBlockRight: string;
+    objectSizeFull: string;
+    objectSizeLarge: string;
+    objectSizeSmall: string;
+    objectSizeMedium: string;
+    pencil: string;
+    pilcrow: string;
+    quote: string;
+    threeVerticalDots: string;
+    dragIndicator: string;
+};
+import './augmentation';

package/src/index.js

@@ -1,95 +1,103 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module core
- */
-export { default as Plugin } from './plugin';
-export { default as Command } from './command';
-export { default as MultiCommand } from './multicommand';
-export { default as Context } from './context';
-export { default as ContextPlugin } from './contextplugin';
-export { default as Editor } from './editor/editor';
-export { default as attachToForm } from './editor/utils/attachtoform';
-export { default as DataApiMixin } from './editor/utils/dataapimixin';
-export { default as ElementApiMixin } from './editor/utils/elementapimixin';
-export { default as secureSourceElement } from './editor/utils/securesourceelement';
-export { default as PendingActions } from './pendingactions';
-import cancel from './../theme/icons/cancel.svg';
-import caption from './../theme/icons/caption.svg';
-import check from './../theme/icons/check.svg';
-import cog from './../theme/icons/cog.svg';
-import eraser from './../theme/icons/eraser.svg';
-import history from './../theme/icons/history.svg';
-import lowVision from './../theme/icons/low-vision.svg';
-import loupe from './../theme/icons/loupe.svg';
-import image from './../theme/icons/image.svg';
-import alignBottom from './../theme/icons/align-bottom.svg';
-import alignMiddle from './../theme/icons/align-middle.svg';
-import alignTop from './../theme/icons/align-top.svg';
-import alignLeft from './../theme/icons/align-left.svg';
-import alignCenter from './../theme/icons/align-center.svg';
-import alignRight from './../theme/icons/align-right.svg';
-import alignJustify from './../theme/icons/align-justify.svg';
-import objectBlockLeft from './../theme/icons/object-left.svg';
-import objectCenter from './../theme/icons/object-center.svg';
-import objectBlockRight from './../theme/icons/object-right.svg';
-import objectFullWidth from './../theme/icons/object-full-width.svg';
-import objectInline from './../theme/icons/object-inline.svg';
-import objectLeft from './../theme/icons/object-inline-left.svg';
-import objectRight from './../theme/icons/object-inline-right.svg';
-import objectSizeFull from './../theme/icons/object-size-full.svg';
-import objectSizeLarge from './../theme/icons/object-size-large.svg';
-import objectSizeSmall from './../theme/icons/object-size-small.svg';
-import objectSizeMedium from './../theme/icons/object-size-medium.svg';
-import pencil from './../theme/icons/pencil.svg';
-import pilcrow from './../theme/icons/pilcrow.svg';
-import quote from './../theme/icons/quote.svg';
-import threeVerticalDots from './../theme/icons/three-vertical-dots.svg';
-import dragIndicator from './../theme/icons/drag-indicator.svg';
-import bold from './../theme/icons/bold.svg';
-import paragraph from './../theme/icons/paragraph.svg';
-import plus from './../theme/icons/plus.svg';
-import text from './../theme/icons/text.svg';
-import importExport from './../theme/icons/importexport.svg';
-export const icons = {
-    bold,
-    cancel,
-    caption,
-    check,
-    cog,
-    eraser,
-    history,
-    image,
-    lowVision,
-    loupe,
-    importExport,
-    paragraph,
-    plus,
-    text,
-    alignBottom,
-    alignMiddle,
-    alignTop,
-    alignLeft,
-    alignCenter,
-    alignRight,
-    alignJustify,
-    objectLeft,
-    objectCenter,
-    objectRight,
-    objectFullWidth,
-    objectInline,
-    objectBlockLeft,
-    objectBlockRight,
-    objectSizeFull,
-    objectSizeLarge,
-    objectSizeSmall,
-    objectSizeMedium,
-    pencil,
-    pilcrow,
-    quote,
-    threeVerticalDots,
-    dragIndicator
-};
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module core
+ */
+export { default as Plugin } from './plugin';
+export { default as Command } from './command';
+export { default as MultiCommand } from './multicommand';
+export { default as Context } from './context';
+export { default as ContextPlugin } from './contextplugin';
+export { default as Editor } from './editor/editor';
+export { default as attachToForm } from './editor/utils/attachtoform';
+export { default as DataApiMixin } from './editor/utils/dataapimixin';
+export { default as ElementApiMixin } from './editor/utils/elementapimixin';
+export { default as secureSourceElement } from './editor/utils/securesourceelement';
+export { default as PendingActions } from './pendingactions';
+import cancel from './../theme/icons/cancel.svg';
+import caption from './../theme/icons/caption.svg';
+import check from './../theme/icons/check.svg';
+import cog from './../theme/icons/cog.svg';
+import eraser from './../theme/icons/eraser.svg';
+import history from './../theme/icons/history.svg';
+import lowVision from './../theme/icons/low-vision.svg';
+import textAlternative from './../theme/icons/text-alternative.svg';
+import loupe from './../theme/icons/loupe.svg';
+import image from './../theme/icons/image.svg';
+import imageUpload from './../theme/icons/image-upload.svg';
+import imageAssetManager from './../theme/icons/image-asset-manager.svg';
+import imageUrl from './../theme/icons/image-url.svg';
+import alignBottom from './../theme/icons/align-bottom.svg';
+import alignMiddle from './../theme/icons/align-middle.svg';
+import alignTop from './../theme/icons/align-top.svg';
+import alignLeft from './../theme/icons/align-left.svg';
+import alignCenter from './../theme/icons/align-center.svg';
+import alignRight from './../theme/icons/align-right.svg';
+import alignJustify from './../theme/icons/align-justify.svg';
+import objectBlockLeft from './../theme/icons/object-left.svg';
+import objectCenter from './../theme/icons/object-center.svg';
+import objectBlockRight from './../theme/icons/object-right.svg';
+import objectFullWidth from './../theme/icons/object-full-width.svg';
+import objectInline from './../theme/icons/object-inline.svg';
+import objectLeft from './../theme/icons/object-inline-left.svg';
+import objectRight from './../theme/icons/object-inline-right.svg';
+import objectSizeFull from './../theme/icons/object-size-full.svg';
+import objectSizeLarge from './../theme/icons/object-size-large.svg';
+import objectSizeSmall from './../theme/icons/object-size-small.svg';
+import objectSizeMedium from './../theme/icons/object-size-medium.svg';
+import pencil from './../theme/icons/pencil.svg';
+import pilcrow from './../theme/icons/pilcrow.svg';
+import quote from './../theme/icons/quote.svg';
+import threeVerticalDots from './../theme/icons/three-vertical-dots.svg';
+import dragIndicator from './../theme/icons/drag-indicator.svg';
+import bold from './../theme/icons/bold.svg';
+import paragraph from './../theme/icons/paragraph.svg';
+import plus from './../theme/icons/plus.svg';
+import text from './../theme/icons/text.svg';
+import importExport from './../theme/icons/importexport.svg';
+export const icons = {
+    bold,
+    cancel,
+    caption,
+    check,
+    cog,
+    eraser,
+    history,
+    image,
+    imageUpload,
+    imageAssetManager,
+    imageUrl,
+    lowVision,
+    textAlternative,
+    loupe,
+    importExport,
+    paragraph,
+    plus,
+    text,
+    alignBottom,
+    alignMiddle,
+    alignTop,
+    alignLeft,
+    alignCenter,
+    alignRight,
+    alignJustify,
+    objectLeft,
+    objectCenter,
+    objectRight,
+    objectFullWidth,
+    objectInline,
+    objectBlockLeft,
+    objectBlockRight,
+    objectSizeFull,
+    objectSizeLarge,
+    objectSizeSmall,
+    objectSizeMedium,
+    pencil,
+    pilcrow,
+    quote,
+    threeVerticalDots,
+    dragIndicator
+};
+import './augmentation';

package/src/multicommand.d.ts

@@ -1,66 +1,66 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module core/multicommand
- */
-import Command from './command';
-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.
- * ```
- */
-export default 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;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module core/multicommand
+ */
+import Command from './command';
+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.
+ * ```
+ */
+export default 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;
+}

package/src/multicommand.js

@@ -1,82 +1,82 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module core/multicommand
- */
-import Command from './command';
-import { insertToPriorityArray } 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.
- * ```
- */
-export default class MultiCommand extends Command {
-    constructor() {
-        super(...arguments);
-        /**
-         * Registered child commands definitions.
-         */
-        this._childCommandsDefinitions = [];
-    }
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        // Override base command refresh(): the command's state is changed when one of child commands changes states.
-    }
-    /**
-     * 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) {
-        const command = this._getFirstEnabledCommand();
-        return !!command && command.execute(args);
-    }
-    /**
-     * Registers a child command.
-     *
-     * @param options An object with configuration options.
-     * @param options.priority Priority of a command to register.
-     */
-    registerChildCommand(command, options = {}) {
-        insertToPriorityArray(this._childCommandsDefinitions, { command, priority: options.priority || 'normal' });
-        // Change multi-command enabled state when one of registered commands changes state.
-        command.on('change:isEnabled', () => this._checkEnabled());
-        this._checkEnabled();
-    }
-    /**
-     * Checks if any of child commands is enabled.
-     */
-    _checkEnabled() {
-        this.isEnabled = !!this._getFirstEnabledCommand();
-    }
-    /**
-     * Returns a first enabled command with the highest priority or `undefined` if none of them is enabled.
-     */
-    _getFirstEnabledCommand() {
-        const commandDefinition = this._childCommandsDefinitions.find(({ command }) => command.isEnabled);
-        return commandDefinition && commandDefinition.command;
-    }
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module core/multicommand
+ */
+import Command from './command';
+import { insertToPriorityArray } 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.
+ * ```
+ */
+export default class MultiCommand extends Command {
+    constructor() {
+        super(...arguments);
+        /**
+         * Registered child commands definitions.
+         */
+        this._childCommandsDefinitions = [];
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        // Override base command refresh(): the command's state is changed when one of child commands changes states.
+    }
+    /**
+     * 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) {
+        const command = this._getFirstEnabledCommand();
+        return !!command && command.execute(args);
+    }
+    /**
+     * Registers a child command.
+     *
+     * @param options An object with configuration options.
+     * @param options.priority Priority of a command to register.
+     */
+    registerChildCommand(command, options = {}) {
+        insertToPriorityArray(this._childCommandsDefinitions, { command, priority: options.priority || 'normal' });
+        // Change multi-command enabled state when one of registered commands changes state.
+        command.on('change:isEnabled', () => this._checkEnabled());
+        this._checkEnabled();
+    }
+    /**
+     * Checks if any of child commands is enabled.
+     */
+    _checkEnabled() {
+        this.isEnabled = !!this._getFirstEnabledCommand();
+    }
+    /**
+     * Returns a first enabled command with the highest priority or `undefined` if none of them is enabled.
+     */
+    _getFirstEnabledCommand() {
+        const commandDefinition = this._childCommandsDefinitions.find(({ command }) => command.isEnabled);
+        return commandDefinition && commandDefinition.command;
+    }
+}