@ckeditor/ckeditor5-basic-styles 40.0.0 → 40.2.0

package/CHANGELOG.md

@@ -5,17 +5,17 @@ All changes in the package are documented in the main repository. See: https://g
 
 Changes for the past releases are available below.
 
-## [19.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v18.0.0...v19.0.0) (2020-04-29)
+## [19.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v18.0.0...v19.0.0) (April 29, 2020)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [18.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v17.0.0...v18.0.0) (2020-03-19)
+## [18.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v17.0.0...v18.0.0) (March 19, 2020)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [17.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v16.0.0...v17.0.0) (2020-02-18)
+## [17.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v16.0.0...v17.0.0) (February 18, 2020)
 
 ### Bug fixes
 
@@ -26,14 +26,14 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([4def017](https://github.com/ckeditor/ckeditor5-basic-styles/commit/4def017))
 
 
-## [16.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v15.0.0...v16.0.0) (2019-12-04)
+## [16.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v15.0.0...v16.0.0) (December 4, 2019)
 
 ### Other changes
 
 * Updated translations. ([9dfd52c](https://github.com/ckeditor/ckeditor5-basic-styles/commit/9dfd52c))
 
 
-## [15.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.4...v15.0.0) (2019-10-23)
+## [15.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.4...v15.0.0) (October 23, 2019)
 
 ### Features
 
@@ -45,7 +45,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([56d6060](https://github.com/ckeditor/ckeditor5-basic-styles/commit/56d6060))
 
 
-## [11.1.4](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.3...v11.1.4) (2019-08-26)
+## [11.1.4](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.3...v11.1.4) (August 26, 2019)
 
 ### Bug fixes
 
@@ -58,26 +58,26 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([52de3fe](https://github.com/ckeditor/ckeditor5-basic-styles/commit/52de3fe))
 
 
-## [11.1.3](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.2...v11.1.3) (2019-07-10)
+## [11.1.3](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.2...v11.1.3) (July 10, 2019)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [11.1.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.1...v11.1.2) (2019-07-04)
+## [11.1.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.1...v11.1.2) (July 4, 2019)
 
 ### Other changes
 
 * Updated translations. ([8914cfc](https://github.com/ckeditor/ckeditor5-basic-styles/commit/8914cfc)) ([fb07a45](https://github.com/ckeditor/ckeditor5-basic-styles/commit/fb07a45))
 
 
-## [11.1.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.0...v11.1.1) (2019-06-05)
+## [11.1.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.1.0...v11.1.1) (June 6, 2019)
 
 ### Other changes
 
 * Updated translations. ([c9cdc44](https://github.com/ckeditor/ckeditor5-basic-styles/commit/c9cdc44))
 
 
-## [11.1.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.0.0...v11.1.0) (2019-04-10)
+## [11.1.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v11.0.0...v11.1.0) (April 4, 2019)
 
 ### Features
 
@@ -89,7 +89,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([4365251](https://github.com/ckeditor/ckeditor5-basic-styles/commit/4365251))
 
 
-## [11.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.1.0...v11.0.0) (2019-02-28)
+## [11.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.1.0...v11.0.0) (February 28, 2019)
 
 ### Other changes
 
@@ -100,7 +100,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Upgraded minimal versions of Node to `8.0.0` and npm to `5.7.1`. See: [ckeditor/ckeditor5#1507](https://github.com/ckeditor/ckeditor5/issues/1507). ([612ea3c](https://github.com/ckeditor/ckeditor5-cloud-services/commit/612ea3c))
 
 
-## [10.1.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.3...v10.1.0) (2018-12-05)
+## [10.1.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.3...v10.1.0) (December 5, 2018)
 
 ### Features
 
@@ -114,14 +114,14 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([f9d3d07](https://github.com/ckeditor/ckeditor5-basic-styles/commit/f9d3d07)) ([67fb2e2](https://github.com/ckeditor/ckeditor5-basic-styles/commit/67fb2e2))
 
 
-## [10.0.3](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.2...v10.0.3) (2018-10-08)
+## [10.0.3](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.2...v10.0.3) (October 8, 2018)
 
 ### Other changes
 
 * Updated translations. ([cf4e657](https://github.com/ckeditor/ckeditor5-basic-styles/commit/cf4e657))
 
 
-## [10.0.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.1...v10.0.2) (2018-07-18)
+## [10.0.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.1...v10.0.2) (July 18, 2018)
 
 ### Bug fixes
 
@@ -132,14 +132,14 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([df8bcc4](https://github.com/ckeditor/ckeditor5-basic-styles/commit/df8bcc4))
 
 
-## [10.0.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.0...v10.0.1) (2018-06-21)
+## [10.0.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v10.0.0...v10.0.1) (June 21, 2018)
 
 ### Other changes
 
 * Updated translations.
 
 
-## [10.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.4...v10.0.0) (2018-04-25)
+## [10.0.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.4...v10.0.0) (April 25, 2018)
 
 ### Other changes
 
@@ -151,7 +151,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The license under which CKEditor 5 is released has been changed from a triple GPL, LGPL and MPL license to a GPL2+ only. See [ckeditor/ckeditor5#991](https://github.com/ckeditor/ckeditor5/issues/991) for more information.
 
 
-## [1.0.0-beta.4](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.2...v1.0.0-beta.4) (2018-04-19)
+## [1.0.0-beta.4](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.2...v1.0.0-beta.4) (April 19, 2018)
 
 ### Other changes
 
@@ -159,12 +159,12 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([b4c8419](https://github.com/ckeditor/ckeditor5-basic-styles/commit/b4c8419))
 
 
-## [1.0.0-beta.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.1...v1.0.0-beta.2) (2018-04-10)
+## [1.0.0-beta.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-beta.1...v1.0.0-beta.2) (April 10, 2018)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [1.0.0-beta.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-alpha.2...v1.0.0-beta.1) (2018-03-15)
+## [1.0.0-beta.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-alpha.2...v1.0.0-beta.1) (March 15, 2018)
 
 ### Features
 
@@ -180,21 +180,21 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([1ff4312](https://github.com/ckeditor/ckeditor5-basic-styles/commit/1ff4312))
 
 
-## [1.0.0-alpha.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2017-11-14)
+## [1.0.0-alpha.2](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (November 14, 2017)
 
 ### Other changes
 
 * Updated translations. ([398054d](https://github.com/ckeditor/ckeditor5-basic-styles/commit/398054d))
 
 
-## [1.0.0-alpha.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.9.0...v1.0.0-alpha.1) (2017-10-03)
+## [1.0.0-alpha.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.9.0...v1.0.0-alpha.1) (October 3, 2017)
 
 ### Features
 
 * Introduced the `Code` plugin. Closes [#52](https://github.com/ckeditor/ckeditor5-basic-styles/issues/52). ([d720cb9](https://github.com/ckeditor/ckeditor5-basic-styles/commit/d720cb9))
 
 
-## [0.9.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.8.1...v0.9.0) (2017-09-03)
+## [0.9.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.8.1...v0.9.0) (September 3, 2017)
 
 ### Bug fixes
 
@@ -218,7 +218,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The command API has been changed.
 
 
-## [0.8.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.8.0...v0.8.1) (2017-05-07)
+## [0.8.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.8.0...v0.8.1) (May 7, 2017)
 
 ### Bug fixes
 
@@ -229,7 +229,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([5250bec](https://github.com/ckeditor/ckeditor5-basic-styles/commit/5250bec))
 
 
-## [0.8.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.7.1...v0.8.0) (2017-04-05)
+## [0.8.0](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.7.1...v0.8.0) (April 5, 2017)
 
 ### Features
 
@@ -240,7 +240,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Updated translations. ([2aa33fd](https://github.com/ckeditor/ckeditor5-basic-styles/commit/2aa33fd))
 
 
-## [0.7.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.7.0...v0.7.1) (2017-03-06)
+## [0.7.1](https://github.com/ckeditor/ckeditor5-basic-styles/compare/v0.7.0...v0.7.1) (March 6, 2017)
 
 ### Other changes
 

package/LICENSE.md

@@ -2,7 +2,7 @@ Software License Agreement
 ==========================
 
 **CKEditor&nbsp;5 basic styles feature** – https://github.com/ckeditor/ckeditor5-basic-styles <br>
-Copyright (c) 2003-2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
+Copyright (c) 2003–2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
 
 Licensed under the terms of [GNU General Public License Version 2 or later](http://www.gnu.org/licenses/gpl.html).
 
@@ -14,4 +14,4 @@ Where not otherwise indicated, all CKEditor content is authored by CKSource engi
 Trademarks
 ----------
 
-**CKEditor** is a trademark of [CKSource Holding sp. z o.o.](https://cksource.com) All other brand and product names are trademarks, registered trademarks or service marks of their respective holders.
+**CKEditor** is a trademark of [CKSource Holding sp. z o.o.](https://cksource.com) All other brand and product names are trademarks, registered trademarks, or service marks of their respective holders.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-basic-styles",
-  "version": "40.0.0",
+  "version": "40.2.0",
   "description": "Basic styles feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,7 +12,7 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "40.0.0"
+    "ckeditor5": "40.2.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "GPL-2.0-or-later",

package/src/attributecommand.d.ts

@@ -1,74 +1,74 @@
-/**
- * @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 basic-styles/attributecommand
- */
-import { Command, type Editor } from 'ckeditor5/src/core';
-/**
- * An extension of the base {@link module:core/command~Command} class, which provides utilities for a command
- * that toggles a single attribute on a text or an element.
- *
- * `AttributeCommand` uses {@link module:engine/model/document~Document#selection}
- * to decide which nodes (if any) should be changed, and applies or removes the attribute from them.
- *
- * The command checks the {@link module:engine/model/model~Model#schema} to decide if it can be enabled
- * for the current selection and to which nodes the attribute can be applied.
- */
-export default class AttributeCommand extends Command {
-    /**
-     * Flag indicating whether the command is active. The command is active when the
-     * {@link module:engine/model/selection~Selection#hasAttribute selection has the attribute} which means that:
-     *
-     * * If the selection is not empty – That the attribute is set on the first node in the selection that allows this attribute.
-     * * If the selection is empty – That the selection has the attribute itself (which means that newly typed
-     * text will have this attribute, too).
-     *
-     * @observable
-     * @readonly
-     */
-    value: boolean;
-    /**
-     * The attribute that will be set by the command.
-     */
-    readonly attributeKey: string;
-    /**
-     * @param attributeKey Attribute that will be set by the command.
-     */
-    constructor(editor: Editor, attributeKey: string);
-    /**
-     * Updates the command's {@link #value} and {@link #isEnabled} based on the current selection.
-     */
-    refresh(): void;
-    /**
-     * Executes the command — applies the attribute to the selection or removes it from the selection.
-     *
-     * If the command is active (`value == true`), it will remove attributes. Otherwise, it will set attributes.
-     *
-     * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
-     *
-     * * If the selection is on a range, the command applies the attribute to all nodes in that range
-     * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
-     * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
-     * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
-     * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
-     * that the selection inherits all attributes from a node if it is in an empty node).
-     *
-     * @fires execute
-     * @param options Command options.
-     * @param options.forceValue If set, it will force the command behavior. If `true`,
-     * the command will apply the attribute, otherwise the command will remove the attribute.
-     * If not set, the command will look for its current value to decide what it should do.
-     */
-    execute(options?: {
-        forceValue?: boolean;
-    }): void;
-    /**
-     * Checks the attribute value of the first node in the selection that allows the attribute.
-     * For the collapsed selection returns the selection attribute.
-     *
-     * @returns The attribute value.
-     */
-    private _getValueFromFirstAllowedNode;
-}
+/**
+ * @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 basic-styles/attributecommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+/**
+ * An extension of the base {@link module:core/command~Command} class, which provides utilities for a command
+ * that toggles a single attribute on a text or an element.
+ *
+ * `AttributeCommand` uses {@link module:engine/model/document~Document#selection}
+ * to decide which nodes (if any) should be changed, and applies or removes the attribute from them.
+ *
+ * The command checks the {@link module:engine/model/model~Model#schema} to decide if it can be enabled
+ * for the current selection and to which nodes the attribute can be applied.
+ */
+export default class AttributeCommand extends Command {
+    /**
+     * Flag indicating whether the command is active. The command is active when the
+     * {@link module:engine/model/selection~Selection#hasAttribute selection has the attribute} which means that:
+     *
+     * * If the selection is not empty – That the attribute is set on the first node in the selection that allows this attribute.
+     * * If the selection is empty – That the selection has the attribute itself (which means that newly typed
+     * text will have this attribute, too).
+     *
+     * @observable
+     * @readonly
+     */
+    value: boolean;
+    /**
+     * The attribute that will be set by the command.
+     */
+    readonly attributeKey: string;
+    /**
+     * @param attributeKey Attribute that will be set by the command.
+     */
+    constructor(editor: Editor, attributeKey: string);
+    /**
+     * Updates the command's {@link #value} and {@link #isEnabled} based on the current selection.
+     */
+    refresh(): void;
+    /**
+     * Executes the command – applies the attribute to the selection or removes it from the selection.
+     *
+     * If the command is active (`value == true`), it will remove attributes. Otherwise, it will set attributes.
+     *
+     * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
+     *
+     * * If the selection is on a range, the command applies the attribute to all nodes in that range
+     * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
+     * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
+     * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
+     * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
+     * that the selection inherits all attributes from a node if it is in an empty node).
+     *
+     * @fires execute
+     * @param options Command options.
+     * @param options.forceValue If set, it will force the command behavior. If `true`,
+     * the command will apply the attribute, otherwise the command will remove the attribute.
+     * If not set, the command will look for its current value to decide what it should do.
+     */
+    execute(options?: {
+        forceValue?: boolean;
+    }): void;
+    /**
+     * Checks the attribute value of the first node in the selection that allows the attribute.
+     * For the collapsed selection returns the selection attribute.
+     *
+     * @returns The attribute value.
+     */
+    private _getValueFromFirstAllowedNode;
+}

package/src/attributecommand.js

@@ -1,105 +1,105 @@
-/**
- * @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 basic-styles/attributecommand
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * An extension of the base {@link module:core/command~Command} class, which provides utilities for a command
- * that toggles a single attribute on a text or an element.
- *
- * `AttributeCommand` uses {@link module:engine/model/document~Document#selection}
- * to decide which nodes (if any) should be changed, and applies or removes the attribute from them.
- *
- * The command checks the {@link module:engine/model/model~Model#schema} to decide if it can be enabled
- * for the current selection and to which nodes the attribute can be applied.
- */
-export default class AttributeCommand extends Command {
-    /**
-     * @param attributeKey Attribute that will be set by the command.
-     */
-    constructor(editor, attributeKey) {
-        super(editor);
-        this.attributeKey = attributeKey;
-    }
-    /**
-     * Updates the command's {@link #value} and {@link #isEnabled} based on the current selection.
-     */
-    refresh() {
-        const model = this.editor.model;
-        const doc = model.document;
-        this.value = this._getValueFromFirstAllowedNode();
-        this.isEnabled = model.schema.checkAttributeInSelection(doc.selection, this.attributeKey);
-    }
-    /**
-     * Executes the command — applies the attribute to the selection or removes it from the selection.
-     *
-     * If the command is active (`value == true`), it will remove attributes. Otherwise, it will set attributes.
-     *
-     * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
-     *
-     * * If the selection is on a range, the command applies the attribute to all nodes in that range
-     * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
-     * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
-     * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
-     * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
-     * that the selection inherits all attributes from a node if it is in an empty node).
-     *
-     * @fires execute
-     * @param options Command options.
-     * @param options.forceValue If set, it will force the command behavior. If `true`,
-     * the command will apply the attribute, otherwise the command will remove the attribute.
-     * If not set, the command will look for its current value to decide what it should do.
-     */
-    execute(options = {}) {
-        const model = this.editor.model;
-        const doc = model.document;
-        const selection = doc.selection;
-        const value = (options.forceValue === undefined) ? !this.value : options.forceValue;
-        model.change(writer => {
-            if (selection.isCollapsed) {
-                if (value) {
-                    writer.setSelectionAttribute(this.attributeKey, true);
-                }
-                else {
-                    writer.removeSelectionAttribute(this.attributeKey);
-                }
-            }
-            else {
-                const ranges = model.schema.getValidRanges(selection.getRanges(), this.attributeKey);
-                for (const range of ranges) {
-                    if (value) {
-                        writer.setAttribute(this.attributeKey, value, range);
-                    }
-                    else {
-                        writer.removeAttribute(this.attributeKey, range);
-                    }
-                }
-            }
-        });
-    }
-    /**
-     * Checks the attribute value of the first node in the selection that allows the attribute.
-     * For the collapsed selection returns the selection attribute.
-     *
-     * @returns The attribute value.
-     */
-    _getValueFromFirstAllowedNode() {
-        const model = this.editor.model;
-        const schema = model.schema;
-        const selection = model.document.selection;
-        if (selection.isCollapsed) {
-            return selection.hasAttribute(this.attributeKey);
-        }
-        for (const range of selection.getRanges()) {
-            for (const item of range.getItems()) {
-                if (schema.checkAttribute(item, this.attributeKey)) {
-                    return item.hasAttribute(this.attributeKey);
-                }
-            }
-        }
-        return false;
-    }
-}
+/**
+ * @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 basic-styles/attributecommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * An extension of the base {@link module:core/command~Command} class, which provides utilities for a command
+ * that toggles a single attribute on a text or an element.
+ *
+ * `AttributeCommand` uses {@link module:engine/model/document~Document#selection}
+ * to decide which nodes (if any) should be changed, and applies or removes the attribute from them.
+ *
+ * The command checks the {@link module:engine/model/model~Model#schema} to decide if it can be enabled
+ * for the current selection and to which nodes the attribute can be applied.
+ */
+export default class AttributeCommand extends Command {
+    /**
+     * @param attributeKey Attribute that will be set by the command.
+     */
+    constructor(editor, attributeKey) {
+        super(editor);
+        this.attributeKey = attributeKey;
+    }
+    /**
+     * Updates the command's {@link #value} and {@link #isEnabled} based on the current selection.
+     */
+    refresh() {
+        const model = this.editor.model;
+        const doc = model.document;
+        this.value = this._getValueFromFirstAllowedNode();
+        this.isEnabled = model.schema.checkAttributeInSelection(doc.selection, this.attributeKey);
+    }
+    /**
+     * Executes the command – applies the attribute to the selection or removes it from the selection.
+     *
+     * If the command is active (`value == true`), it will remove attributes. Otherwise, it will set attributes.
+     *
+     * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
+     *
+     * * If the selection is on a range, the command applies the attribute to all nodes in that range
+     * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
+     * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
+     * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
+     * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
+     * that the selection inherits all attributes from a node if it is in an empty node).
+     *
+     * @fires execute
+     * @param options Command options.
+     * @param options.forceValue If set, it will force the command behavior. If `true`,
+     * the command will apply the attribute, otherwise the command will remove the attribute.
+     * If not set, the command will look for its current value to decide what it should do.
+     */
+    execute(options = {}) {
+        const model = this.editor.model;
+        const doc = model.document;
+        const selection = doc.selection;
+        const value = (options.forceValue === undefined) ? !this.value : options.forceValue;
+        model.change(writer => {
+            if (selection.isCollapsed) {
+                if (value) {
+                    writer.setSelectionAttribute(this.attributeKey, true);
+                }
+                else {
+                    writer.removeSelectionAttribute(this.attributeKey);
+                }
+            }
+            else {
+                const ranges = model.schema.getValidRanges(selection.getRanges(), this.attributeKey);
+                for (const range of ranges) {
+                    if (value) {
+                        writer.setAttribute(this.attributeKey, value, range);
+                    }
+                    else {
+                        writer.removeAttribute(this.attributeKey, range);
+                    }
+                }
+            }
+        });
+    }
+    /**
+     * Checks the attribute value of the first node in the selection that allows the attribute.
+     * For the collapsed selection returns the selection attribute.
+     *
+     * @returns The attribute value.
+     */
+    _getValueFromFirstAllowedNode() {
+        const model = this.editor.model;
+        const schema = model.schema;
+        const selection = model.document.selection;
+        if (selection.isCollapsed) {
+            return selection.hasAttribute(this.attributeKey);
+        }
+        for (const range of selection.getRanges()) {
+            for (const item of range.getItems()) {
+                if (schema.checkAttribute(item, this.attributeKey)) {
+                    return item.hasAttribute(this.attributeKey);
+                }
+            }
+        }
+        return false;
+    }
+}