@ckeditor/ckeditor5-utils 47.6.1 → 48.0.0-alpha.0

package/LICENSE.md

@@ -18,7 +18,7 @@ Where not otherwise indicated, all CKEditor 5 content is authored by CKSour
 
 The following libraries are included in CKEditor 5 under the [MIT license](https://opensource.org/licenses/MIT):
 
-* es-toolkit - Copyright (c) 2024 Viva Republica, Inc.
+* es-toolkit - Copyright (c) 2024 Viva Republica, Inc and Copyright OpenJS Foundation and other contributors.
 
 Trademarks
 ----------

package/{src → dist}/dom/global.d.ts

@@ -18,7 +18,7 @@ export interface GlobalType {
  * testing, i.e. stubbing native properties:
  *
  * ```ts
- * import { global } from 'ckeditor5/utils';
+ * import { global } from 'ckeditor5';
  *
  * // This stub will work for any code using global module.
  * testUtils.sinon.stub( global, 'window', {

package/{src → dist}/dom/rect.d.ts

@@ -166,10 +166,18 @@ export declare class Rect {
     /**
      * Returns an array of rects of the given native DOM Range.
      *
+     * Also see {@link module:utils/dom/rect~Rect.getDomElementRects}.
+     *
      * @param range A native DOM range.
      * @returns DOM Range rects.
      */
     static getDomRangeRects(range: Range): Array<Rect>;
+    /**
+     * Returns an array of Rects of the given DOM Element based on its native `getClientRects()` method.
+     *
+     * Also see {@link module:utils/dom/rect~Rect.getDomRangeRects}.
+     */
+    static getDomElementRects(element: HTMLElement): Array<Rect>;
     /**
      * Returns a bounding rectangle that contains all the given `rects`.
      *

package/dist/index.css

@@ -2,3 +2,6 @@
  * @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
  */
+
+
+/*# sourceMappingURL=index.css.map */

package/dist/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index.css"],"names":[],"mappings":";;;;;;AAEA,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC","file":"index.css.map","sourcesContent":["\n\n/*# sourceMappingURL=index.css.map */"]}

package/dist/index.js

@@ -18,7 +18,7 @@ import { isObject as isObject$1, isString, isPlainObject, cloneDeepWith, isEleme
  * testing, i.e. stubbing native properties:
  *
  * ```ts
- * import { global } from 'ckeditor5/utils';
+ * import { global } from 'ckeditor5';
  *
  * // This stub will work for any code using global module.
  * testUtils.sinon.stub( global, 'window', {
@@ -987,9 +987,9 @@ function isObject(structure) {
     ];
 }
 
-const version = '47.6.1';
+const version = '48.0.0-alpha.0';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2026, 2, 11);
+const releaseDate = new Date(2026, 2, 19);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * This error is thrown when, due to a mistake in the way CKEditor 5 was installed,
@@ -1097,7 +1097,7 @@ const releaseDate = new Date(2026, 2, 11);
 	 * <details>
 	 * <summary>(Legacy) Default imports and `src` imports</summary>
 	 *
-	 * If you use the {@glink getting-started/legacy/installation-methods/quick-start-other legacy customized installation}
+	 * If you use the legacy customized installation
 	 * method, you should only import { code from the `@ckeditor/ckeditor5-<NAME>` packages. While you can import code } from
 	 * the `@ckeditor/ckeditor5-<NAME>/src/*` files, it is not recommended as it can make migration to the new installation
 	 * methods more difficult.
@@ -1119,7 +1119,7 @@ const releaseDate = new Date(2026, 2, 11);
 	 * <details>
 	 * <summary>(Legacy) DLL builds</summary>
 	 *
-	 * If you are using the {@glink getting-started/legacy/advanced/alternative-setups/dll-builds legacy DLL builds},
+	 * If you are using the {@glink updating/nim-migration/dll-builds legacy DLL builds},
 	 * you should not import any non-DLL modules.
 	 *
 	 * Examples of valid and invalid import paths:
@@ -3204,6 +3204,8 @@ const POSITIONING_VALUES = new Set([
     /**
 	 * Returns an array of rects of the given native DOM Range.
 	 *
+	 * Also see {@link module:utils/dom/rect~Rect.getDomElementRects}.
+	 *
 	 * @param range A native DOM range.
 	 * @returns DOM Range rects.
 	 */ static getDomRangeRects(range) {
@@ -3230,6 +3232,19 @@ const POSITIONING_VALUES = new Set([
         }
         return rects;
     }
+    /**
+	 * Returns an array of Rects of the given DOM Element based on its native `getClientRects()` method.
+	 *
+	 * Also see {@link module:utils/dom/rect~Rect.getDomRangeRects}.
+	 */ static getDomElementRects(element) {
+        return Array.from(element.getClientRects()).map((clientRect)=>{
+            const rect = new Rect(clientRect);
+            // Point the rect source to the DOM element instead of of the DOM client rect to allow proper clipping,
+            // in `Rect#getVisible()` method.
+            rect._source = element;
+            return rect;
+        });
+    }
     /**
 	 * Returns a bounding rectangle that contains all the given `rects`.
 	 *
@@ -6378,6 +6393,10 @@ function isFocusedView(subTreeRoot, view) {
             name: 'thead',
             isVoid: false
         },
+        {
+            name: 'tfoot',
+            isVoid: false
+        },
         {
             name: 'tr',
             isVoid: false