@ckeditor/ckeditor5-engine 44.0.0 → 44.1.0-alpha.0

package/src/view/stylesmap.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * Styles map. Allows handling (adding, removing, retrieving) a set of style rules (usually, of an element).
@@ -13,6 +13,14 @@ export default class StylesMap {
      * When no style processor rules are defined it acts as simple key-value storage.
      */
     private _styles;
+    /**
+     * Cached list of style names for faster access.
+     */
+    private _cachedStyleNames;
+    /**
+     * Cached list of expanded style names for faster access.
+     */
+    private _cachedExpandedStyleNames;
     /**
      * An instance of the {@link module:engine/view/stylesmap~StylesProcessor}.
      */

package/src/view/stylesmap.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/stylesmap
@@ -14,6 +14,14 @@ export default class StylesMap {
      * Creates Styles instance.
      */
     constructor(styleProcessor) {
+        /**
+         * Cached list of style names for faster access.
+         */
+        this._cachedStyleNames = null;
+        /**
+         * Cached list of expanded style names for faster access.
+         */
+        this._cachedExpandedStyleNames = null;
         this._styles = {};
         this._styleProcessor = styleProcessor;
     }
@@ -88,6 +96,8 @@ export default class StylesMap {
         return Array.isArray(propertyDescriptor);
     }
     set(nameOrObject, valueOrObject) {
+        this._cachedStyleNames = null;
+        this._cachedExpandedStyleNames = null;
         if (isObject(nameOrObject)) {
             for (const [key, value] of Object.entries(nameOrObject)) {
                 this._styleProcessor.toNormalizedForm(key, value, this._styles);
@@ -126,6 +136,8 @@ export default class StylesMap {
      * @param name Style name.
      */
     remove(name) {
+        this._cachedStyleNames = null;
+        this._cachedExpandedStyleNames = null;
         const path = toPath(name);
         unset(this._styles, path);
         delete this._styles[name];
@@ -286,16 +298,19 @@ export default class StylesMap {
             return [];
         }
         if (expand) {
-            return this._styleProcessor.getStyleNames(this._styles);
+            this._cachedExpandedStyleNames = this._cachedExpandedStyleNames || this._styleProcessor.getStyleNames(this._styles);
+            return this._cachedExpandedStyleNames;
         }
-        const entries = this.getStylesEntries();
-        return entries.map(([key]) => key);
+        this._cachedStyleNames = this._cachedStyleNames || this.getStylesEntries().map(([key]) => key);
+        return this._cachedStyleNames;
     }
     /**
      * Removes all styles.
      */
     clear() {
         this._styles = {};
+        this._cachedStyleNames = null;
+        this._cachedExpandedStyleNames = null;
     }
     /**
      * Returns normalized styles entries for further processing.

package/src/view/text.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/text

package/src/view/text.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/text

package/src/view/textproxy.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/textproxy

package/src/view/textproxy.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/textproxy

package/src/view/treewalker.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import Position from './position.js';
 import type Item from './item.js';

package/src/view/treewalker.js

@@ -1,12 +1,7 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-/**
- * @module engine/view/treewalker
- */
-import Element from './element.js';
-import Text from './text.js';
 import TextProxy from './textproxy.js';
 import Position from './position.js';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
@@ -120,7 +115,7 @@ export default class TreeWalker {
         // Get node just after current position.
         let node;
         // Text is a specific parent because it contains string instead of child nodes.
-        if (parent instanceof Text) {
+        if (parent && parent.is('view:$text')) {
             if (position.isAtEnd) {
                 // Prevent returning "elementEnd" for Text node. Skip that value and return the next walker step.
                 this._position = Position._createAfter(parent);
@@ -131,7 +126,22 @@ export default class TreeWalker {
         else {
             node = parent.getChild(position.offset);
         }
-        if (node instanceof Element) {
+        if (typeof node == 'string') {
+            let textLength;
+            if (this.singleCharacters) {
+                textLength = 1;
+            }
+            else {
+                // Check if text stick out of walker range.
+                const endOffset = parent === this._boundaryEndParent ? this.boundaries.end.offset : parent.data.length;
+                textLength = endOffset - position.offset;
+            }
+            const textProxy = new TextProxy(parent, position.offset, textLength);
+            position.offset += textLength;
+            this._position = position;
+            return this._formatReturnValue('text', textProxy, previousPosition, position, textLength);
+        }
+        if (node && node.is('view:element')) {
             if (!this.shallow) {
                 position = new Position(node, 0);
             }
@@ -145,7 +155,7 @@ export default class TreeWalker {
             this._position = position;
             return this._formatReturnValue('elementStart', node, previousPosition, position, 1);
         }
-        if (node instanceof Text) {
+        if (node && node.is('view:$text')) {
             if (this.singleCharacters) {
                 position = new Position(node, 0);
                 this._position = position;
@@ -167,21 +177,6 @@ export default class TreeWalker {
             this._position = position;
             return this._formatReturnValue('text', item, previousPosition, position, charactersCount);
         }
-        if (typeof node == 'string') {
-            let textLength;
-            if (this.singleCharacters) {
-                textLength = 1;
-            }
-            else {
-                // Check if text stick out of walker range.
-                const endOffset = parent === this._boundaryEndParent ? this.boundaries.end.offset : parent.data.length;
-                textLength = endOffset - position.offset;
-            }
-            const textProxy = new TextProxy(parent, position.offset, textLength);
-            position.offset += textLength;
-            this._position = position;
-            return this._formatReturnValue('text', textProxy, previousPosition, position, textLength);
-        }
         // `node` is not set, we reached the end of current `parent`.
         position = Position._createAfter(parent);
         this._position = position;
@@ -208,7 +203,7 @@ export default class TreeWalker {
         // Get node just before current position.
         let node;
         // Text {@link module:engine/view/text~Text} element is a specific parent because contains string instead of child nodes.
-        if (parent instanceof Text) {
+        if (parent.is('view:$text')) {
             if (position.isAtStart) {
                 // Prevent returning "elementStart" for Text node. Skip that value and return the next walker step.
                 this._position = Position._createBefore(parent);
@@ -219,7 +214,22 @@ export default class TreeWalker {
         else {
             node = parent.getChild(position.offset - 1);
         }
-        if (node instanceof Element) {
+        if (typeof node == 'string') {
+            let textLength;
+            if (!this.singleCharacters) {
+                // Check if text stick out of walker range.
+                const startOffset = parent === this._boundaryStartParent ? this.boundaries.start.offset : 0;
+                textLength = position.offset - startOffset;
+            }
+            else {
+                textLength = 1;
+            }
+            position.offset -= textLength;
+            const textProxy = new TextProxy(parent, position.offset, textLength);
+            this._position = position;
+            return this._formatReturnValue('text', textProxy, previousPosition, position, textLength);
+        }
+        if (node && node.is('view:element')) {
             if (this.shallow) {
                 position.offset--;
                 this._position = position;
@@ -232,7 +242,7 @@ export default class TreeWalker {
             }
             return this._formatReturnValue('elementEnd', node, previousPosition, position);
         }
-        if (node instanceof Text) {
+        if (node && node.is('view:$text')) {
             if (this.singleCharacters) {
                 position = new Position(node, node.data.length);
                 this._position = position;
@@ -255,21 +265,6 @@ export default class TreeWalker {
             this._position = position;
             return this._formatReturnValue('text', item, previousPosition, position, charactersCount);
         }
-        if (typeof node == 'string') {
-            let textLength;
-            if (!this.singleCharacters) {
-                // Check if text stick out of walker range.
-                const startOffset = parent === this._boundaryStartParent ? this.boundaries.start.offset : 0;
-                textLength = position.offset - startOffset;
-            }
-            else {
-                textLength = 1;
-            }
-            position.offset -= textLength;
-            const textProxy = new TextProxy(parent, position.offset, textLength);
-            this._position = position;
-            return this._formatReturnValue('text', textProxy, previousPosition, position, textLength);
-        }
         // `node` is not set, we reached the beginning of current `parent`.
         position = Position._createBefore(parent);
         this._position = position;
@@ -289,7 +284,7 @@ export default class TreeWalker {
         // Walker doesn't enter to the Text except situations when walker is iterating over every single character,
         // or the bound starts/ends inside the Text. So when the position is at the beginning or at the end of the Text
         // we move it just before or just after Text.
-        if (item instanceof TextProxy) {
+        if (item.is('view:$textProxy')) {
             // Position is at the end of Text.
             if (item.offsetInText + item.data.length == item.textNode.data.length) {
                 if (this.direction == 'forward' && !(this.boundaries && this.boundaries.end.isEqual(this.position))) {

package/src/view/typecheckable.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type AttributeElement from './attributeelement.js';
 import type ContainerElement from './containerelement.js';

package/src/view/typecheckable.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/typecheckable

package/src/view/uielement.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/uielement

package/src/view/uielement.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/uielement

package/src/view/upcastwriter.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/upcastwriter

package/src/view/upcastwriter.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/upcastwriter

package/src/view/view.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/view

package/src/view/view.js

@@ -1,6 +1,6 @@
 /**
  * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module engine/view/view

package/theme/placeholder.css

@@ -1,6 +1,6 @@
 /*
  * Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 
 /* See ckeditor/ckeditor5#936. */

package/theme/renderer.css

@@ -1,6 +1,6 @@
 /*
  * Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 
 /* Elements marked by the Renderer as hidden should be invisible in the editor. */