@ckeditor/ckeditor5-engine 40.0.0 → 40.1.0

package/src/model/operation/rootattributeoperation.js

@@ -1,155 +1,155 @@
-/**
- * @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 engine/model/operation/rootattributeoperation
- */
-import Operation from './operation';
-import { CKEditorError } from '@ckeditor/ckeditor5-utils';
-/**
- * Operation to change root element's attribute. Using this class you can add, remove or change value of the attribute.
- *
- * This operation is needed, because root elements can't be changed through
- * {@link module:engine/model/operation/attributeoperation~AttributeOperation}.
- * It is because {@link module:engine/model/operation/attributeoperation~AttributeOperation}
- * requires a range to change and root element can't
- * be a part of range because every {@link module:engine/model/position~Position} has to be inside a root.
- * {@link module:engine/model/position~Position} can't be created before a root element.
- */
-export default class RootAttributeOperation extends Operation {
-    /**
-     * Creates an operation that changes, removes or adds attributes on root element.
-     *
-     * @see module:engine/model/operation/attributeoperation~AttributeOperation
-     * @param root Root element to change.
-     * @param key Key of an attribute to change or remove.
-     * @param oldValue Old value of the attribute with given key or `null`, if attribute was not set before.
-     * @param newValue New value of the attribute with given key or `null`, if operation should remove attribute.
-     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation
-     * can be applied or `null` if the operation operates on detached (non-document) tree.
-     */
-    constructor(root, key, oldValue, newValue, baseVersion) {
-        super(baseVersion);
-        this.root = root;
-        this.key = key;
-        this.oldValue = oldValue === undefined ? null : oldValue;
-        this.newValue = newValue === undefined ? null : newValue;
-    }
-    /**
-     * @inheritDoc
-     */
-    get type() {
-        if (this.oldValue === null) {
-            return 'addRootAttribute';
-        }
-        else if (this.newValue === null) {
-            return 'removeRootAttribute';
-        }
-        else {
-            return 'changeRootAttribute';
-        }
-    }
-    /**
-     * @inheritDoc
-     */
-    get affectedSelectable() {
-        return this.root;
-    }
-    /**
-     * Creates and returns an operation that has the same parameters as this operation.
-     *
-     * @returns Clone of this operation.
-     */
-    clone() {
-        return new RootAttributeOperation(this.root, this.key, this.oldValue, this.newValue, this.baseVersion);
-    }
-    /**
-     * See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
-     */
-    getReversed() {
-        return new RootAttributeOperation(this.root, this.key, this.newValue, this.oldValue, this.baseVersion + 1);
-    }
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    _validate() {
-        if (this.root != this.root.root || this.root.is('documentFragment')) {
-            /**
-             * The element to change is not a root element.
-             *
-             * @error rootattribute-operation-not-a-root
-             * @param root
-             * @param key
-             * @param value
-             */
-            throw new CKEditorError('rootattribute-operation-not-a-root', this, { root: this.root, key: this.key });
-        }
-        if (this.oldValue !== null && this.root.getAttribute(this.key) !== this.oldValue) {
-            /**
-             * The attribute which should be removed does not exist for the given node.
-             *
-             * @error rootattribute-operation-wrong-old-value
-             * @param root
-             * @param key
-             * @param value
-             */
-            throw new CKEditorError('rootattribute-operation-wrong-old-value', this, { root: this.root, key: this.key });
-        }
-        if (this.oldValue === null && this.newValue !== null && this.root.hasAttribute(this.key)) {
-            /**
-             * The attribute with given key already exists for the given node.
-             *
-             * @error rootattribute-operation-attribute-exists
-             * @param root
-             * @param key
-             */
-            throw new CKEditorError('rootattribute-operation-attribute-exists', this, { root: this.root, key: this.key });
-        }
-    }
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    _execute() {
-        if (this.newValue !== null) {
-            this.root._setAttribute(this.key, this.newValue);
-        }
-        else {
-            this.root._removeAttribute(this.key);
-        }
-    }
-    /**
-     * @inheritDoc
-     */
-    toJSON() {
-        const json = super.toJSON();
-        json.root = this.root.toJSON();
-        return json;
-    }
-    /**
-     * @inheritDoc
-     */
-    static get className() {
-        return 'RootAttributeOperation';
-    }
-    /**
-     * Creates `RootAttributeOperation` object from deserialized object, i.e. from parsed JSON string.
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json, document) {
-        if (!document.getRoot(json.root)) {
-            /**
-             * Cannot create RootAttributeOperation for document. Root with specified name does not exist.
-             *
-             * @error rootattribute-operation-fromjson-no-root
-             * @param rootName
-             */
-            throw new CKEditorError('rootattribute-operation-fromjson-no-root', this, { rootName: json.root });
-        }
-        return new RootAttributeOperation(document.getRoot(json.root), json.key, json.oldValue, json.newValue, json.baseVersion);
-    }
-}
+/**
+ * @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 engine/model/operation/rootattributeoperation
+ */
+import Operation from './operation';
+import { CKEditorError } from '@ckeditor/ckeditor5-utils';
+/**
+ * Operation to change root element's attribute. Using this class you can add, remove or change value of the attribute.
+ *
+ * This operation is needed, because root elements can't be changed through
+ * {@link module:engine/model/operation/attributeoperation~AttributeOperation}.
+ * It is because {@link module:engine/model/operation/attributeoperation~AttributeOperation}
+ * requires a range to change and root element can't
+ * be a part of range because every {@link module:engine/model/position~Position} has to be inside a root.
+ * {@link module:engine/model/position~Position} can't be created before a root element.
+ */
+export default class RootAttributeOperation extends Operation {
+    /**
+     * Creates an operation that changes, removes or adds attributes on root element.
+     *
+     * @see module:engine/model/operation/attributeoperation~AttributeOperation
+     * @param root Root element to change.
+     * @param key Key of an attribute to change or remove.
+     * @param oldValue Old value of the attribute with given key or `null`, if attribute was not set before.
+     * @param newValue New value of the attribute with given key or `null`, if operation should remove attribute.
+     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation
+     * can be applied or `null` if the operation operates on detached (non-document) tree.
+     */
+    constructor(root, key, oldValue, newValue, baseVersion) {
+        super(baseVersion);
+        this.root = root;
+        this.key = key;
+        this.oldValue = oldValue === undefined ? null : oldValue;
+        this.newValue = newValue === undefined ? null : newValue;
+    }
+    /**
+     * @inheritDoc
+     */
+    get type() {
+        if (this.oldValue === null) {
+            return 'addRootAttribute';
+        }
+        else if (this.newValue === null) {
+            return 'removeRootAttribute';
+        }
+        else {
+            return 'changeRootAttribute';
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    get affectedSelectable() {
+        return this.root;
+    }
+    /**
+     * Creates and returns an operation that has the same parameters as this operation.
+     *
+     * @returns Clone of this operation.
+     */
+    clone() {
+        return new RootAttributeOperation(this.root, this.key, this.oldValue, this.newValue, this.baseVersion);
+    }
+    /**
+     * See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
+     */
+    getReversed() {
+        return new RootAttributeOperation(this.root, this.key, this.newValue, this.oldValue, this.baseVersion + 1);
+    }
+    /**
+     * @inheritDoc
+     * @internal
+     */
+    _validate() {
+        if (this.root != this.root.root || this.root.is('documentFragment')) {
+            /**
+             * The element to change is not a root element.
+             *
+             * @error rootattribute-operation-not-a-root
+             * @param root
+             * @param key
+             * @param value
+             */
+            throw new CKEditorError('rootattribute-operation-not-a-root', this, { root: this.root, key: this.key });
+        }
+        if (this.oldValue !== null && this.root.getAttribute(this.key) !== this.oldValue) {
+            /**
+             * The attribute which should be removed does not exist for the given node.
+             *
+             * @error rootattribute-operation-wrong-old-value
+             * @param root
+             * @param key
+             * @param value
+             */
+            throw new CKEditorError('rootattribute-operation-wrong-old-value', this, { root: this.root, key: this.key });
+        }
+        if (this.oldValue === null && this.newValue !== null && this.root.hasAttribute(this.key)) {
+            /**
+             * The attribute with given key already exists for the given node.
+             *
+             * @error rootattribute-operation-attribute-exists
+             * @param root
+             * @param key
+             */
+            throw new CKEditorError('rootattribute-operation-attribute-exists', this, { root: this.root, key: this.key });
+        }
+    }
+    /**
+     * @inheritDoc
+     * @internal
+     */
+    _execute() {
+        if (this.newValue !== null) {
+            this.root._setAttribute(this.key, this.newValue);
+        }
+        else {
+            this.root._removeAttribute(this.key);
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.root = this.root.toJSON();
+        return json;
+    }
+    /**
+     * @inheritDoc
+     */
+    static get className() {
+        return 'RootAttributeOperation';
+    }
+    /**
+     * Creates `RootAttributeOperation` object from deserialized object, i.e. from parsed JSON string.
+     *
+     * @param json Deserialized JSON object.
+     * @param document Document on which this operation will be applied.
+     */
+    static fromJSON(json, document) {
+        if (!document.getRoot(json.root)) {
+            /**
+             * Cannot create RootAttributeOperation for document. Root with specified name does not exist.
+             *
+             * @error rootattribute-operation-fromjson-no-root
+             * @param rootName
+             */
+            throw new CKEditorError('rootattribute-operation-fromjson-no-root', this, { rootName: json.root });
+        }
+        return new RootAttributeOperation(document.getRoot(json.root), json.key, json.oldValue, json.newValue, json.baseVersion);
+    }
+}

package/src/model/operation/rootoperation.d.ts

@@ -1,76 +1,76 @@
-/**
- * @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 engine/model/operation/rootoperation
- */
-import Operation from './operation';
-import type Document from '../document';
-import type { Selectable } from '../selection';
-/**
- * Operation that creates (or attaches) or detaches a root element.
- */
-export default class RootOperation extends Operation {
-    /**
-     * Root name to create or detach.
-     */
-    readonly rootName: string;
-    /**
-     * Root element name.
-     */
-    readonly elementName: string;
-    /**
-     * Specifies whether the operation adds (`true`) or detaches the root (`false`).
-     */
-    readonly isAdd: boolean;
-    /**
-     * Document which owns the root.
-     */
-    private readonly _document;
-    /**
-     * Creates an operation that creates or removes a root element.
-     *
-     * @param rootName Root name to create or detach.
-     * @param elementName Root element name.
-     * @param isAdd Specifies whether the operation adds (`true`) or detaches the root (`false`).
-     * @param document Document which owns the root.
-     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation can be applied.
-     */
-    constructor(rootName: string, elementName: string, isAdd: boolean, document: Document, baseVersion: number);
-    /**
-     * @inheritDoc
-     */
-    get type(): 'addRoot' | 'detachRoot';
-    /**
-     * @inheritDoc
-     */
-    get affectedSelectable(): Selectable;
-    /**
-     * @inheritDoc
-     */
-    clone(): RootOperation;
-    /**
-     * @inheritDoc
-     */
-    getReversed(): RootOperation;
-    /**
-     * @inheritDoc
-     */
-    _execute(): void;
-    /**
-     * @inheritDoc
-     */
-    toJSON(): unknown;
-    /**
-     * @inheritDoc
-     */
-    static get className(): string;
-    /**
-     * Creates `RootOperation` object from deserialized object, i.e. from parsed JSON string.
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json: any, document: Document): RootOperation;
-}
+/**
+ * @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 engine/model/operation/rootoperation
+ */
+import Operation from './operation';
+import type Document from '../document';
+import type { Selectable } from '../selection';
+/**
+ * Operation that creates (or attaches) or detaches a root element.
+ */
+export default class RootOperation extends Operation {
+    /**
+     * Root name to create or detach.
+     */
+    readonly rootName: string;
+    /**
+     * Root element name.
+     */
+    readonly elementName: string;
+    /**
+     * Specifies whether the operation adds (`true`) or detaches the root (`false`).
+     */
+    readonly isAdd: boolean;
+    /**
+     * Document which owns the root.
+     */
+    private readonly _document;
+    /**
+     * Creates an operation that creates or removes a root element.
+     *
+     * @param rootName Root name to create or detach.
+     * @param elementName Root element name.
+     * @param isAdd Specifies whether the operation adds (`true`) or detaches the root (`false`).
+     * @param document Document which owns the root.
+     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation can be applied.
+     */
+    constructor(rootName: string, elementName: string, isAdd: boolean, document: Document, baseVersion: number);
+    /**
+     * @inheritDoc
+     */
+    get type(): 'addRoot' | 'detachRoot';
+    /**
+     * @inheritDoc
+     */
+    get affectedSelectable(): Selectable;
+    /**
+     * @inheritDoc
+     */
+    clone(): RootOperation;
+    /**
+     * @inheritDoc
+     */
+    getReversed(): RootOperation;
+    /**
+     * @inheritDoc
+     */
+    _execute(): void;
+    /**
+     * @inheritDoc
+     */
+    toJSON(): unknown;
+    /**
+     * @inheritDoc
+     */
+    static get className(): string;
+    /**
+     * Creates `RootOperation` object from deserialized object, i.e. from parsed JSON string.
+     *
+     * @param json Deserialized JSON object.
+     * @param document Document on which this operation will be applied.
+     */
+    static fromJSON(json: any, document: Document): RootOperation;
+}

package/src/model/operation/rootoperation.js

@@ -1,90 +1,90 @@
-/**
- * @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 engine/model/operation/rootoperation
- */
-import Operation from './operation';
-/**
- * Operation that creates (or attaches) or detaches a root element.
- */
-export default class RootOperation extends Operation {
-    /**
-     * Creates an operation that creates or removes a root element.
-     *
-     * @param rootName Root name to create or detach.
-     * @param elementName Root element name.
-     * @param isAdd Specifies whether the operation adds (`true`) or detaches the root (`false`).
-     * @param document Document which owns the root.
-     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation can be applied.
-     */
-    constructor(rootName, elementName, isAdd, document, baseVersion) {
-        super(baseVersion);
-        this.rootName = rootName;
-        this.elementName = elementName;
-        this.isAdd = isAdd;
-        this._document = document;
-        // Make sure that the root exists ASAP, this is important for RTC.
-        // If the root was dynamically added, there will be more operations that operate on/in this root.
-        // These operations will require root element instance (in operation property or in position instance).
-        // If the root is not created ahead of time, instantiating such operations may fail.
-        if (!this._document.getRoot(this.rootName)) {
-            const root = this._document.createRoot(this.elementName, this.rootName);
-            root._isAttached = false;
-        }
-    }
-    /**
-     * @inheritDoc
-     */
-    get type() {
-        return this.isAdd ? 'addRoot' : 'detachRoot';
-    }
-    /**
-     * @inheritDoc
-     */
-    get affectedSelectable() {
-        return this._document.getRoot(this.rootName);
-    }
-    /**
-     * @inheritDoc
-     */
-    clone() {
-        return new RootOperation(this.rootName, this.elementName, this.isAdd, this._document, this.baseVersion);
-    }
-    /**
-     * @inheritDoc
-     */
-    getReversed() {
-        return new RootOperation(this.rootName, this.elementName, !this.isAdd, this._document, this.baseVersion + 1);
-    }
-    /**
-     * @inheritDoc
-     */
-    _execute() {
-        this._document.getRoot(this.rootName)._isAttached = this.isAdd;
-    }
-    /**
-     * @inheritDoc
-     */
-    toJSON() {
-        const json = super.toJSON();
-        delete json._document;
-        return json;
-    }
-    /**
-     * @inheritDoc
-     */
-    static get className() {
-        return 'RootOperation';
-    }
-    /**
-     * Creates `RootOperation` object from deserialized object, i.e. from parsed JSON string.
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json, document) {
-        return new RootOperation(json.rootName, json.elementName, json.isAdd, document, json.baseVersion);
-    }
-}
+/**
+ * @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 engine/model/operation/rootoperation
+ */
+import Operation from './operation';
+/**
+ * Operation that creates (or attaches) or detaches a root element.
+ */
+export default class RootOperation extends Operation {
+    /**
+     * Creates an operation that creates or removes a root element.
+     *
+     * @param rootName Root name to create or detach.
+     * @param elementName Root element name.
+     * @param isAdd Specifies whether the operation adds (`true`) or detaches the root (`false`).
+     * @param document Document which owns the root.
+     * @param baseVersion Document {@link module:engine/model/document~Document#version} on which operation can be applied.
+     */
+    constructor(rootName, elementName, isAdd, document, baseVersion) {
+        super(baseVersion);
+        this.rootName = rootName;
+        this.elementName = elementName;
+        this.isAdd = isAdd;
+        this._document = document;
+        // Make sure that the root exists ASAP, this is important for RTC.
+        // If the root was dynamically added, there will be more operations that operate on/in this root.
+        // These operations will require root element instance (in operation property or in position instance).
+        // If the root is not created ahead of time, instantiating such operations may fail.
+        if (!this._document.getRoot(this.rootName)) {
+            const root = this._document.createRoot(this.elementName, this.rootName);
+            root._isAttached = false;
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    get type() {
+        return this.isAdd ? 'addRoot' : 'detachRoot';
+    }
+    /**
+     * @inheritDoc
+     */
+    get affectedSelectable() {
+        return this._document.getRoot(this.rootName);
+    }
+    /**
+     * @inheritDoc
+     */
+    clone() {
+        return new RootOperation(this.rootName, this.elementName, this.isAdd, this._document, this.baseVersion);
+    }
+    /**
+     * @inheritDoc
+     */
+    getReversed() {
+        return new RootOperation(this.rootName, this.elementName, !this.isAdd, this._document, this.baseVersion + 1);
+    }
+    /**
+     * @inheritDoc
+     */
+    _execute() {
+        this._document.getRoot(this.rootName)._isAttached = this.isAdd;
+    }
+    /**
+     * @inheritDoc
+     */
+    toJSON() {
+        const json = super.toJSON();
+        delete json._document;
+        return json;
+    }
+    /**
+     * @inheritDoc
+     */
+    static get className() {
+        return 'RootOperation';
+    }
+    /**
+     * Creates `RootOperation` object from deserialized object, i.e. from parsed JSON string.
+     *
+     * @param json Deserialized JSON object.
+     * @param document Document on which this operation will be applied.
+     */
+    static fromJSON(json, document) {
+        return new RootOperation(json.rootName, json.elementName, json.isAdd, document, json.baseVersion);
+    }
+}