npm - @ckeditor/ckeditor5-utils - Versions diffs - 47.4.0 → 47.5.0-alpha.1 - Mend

@ckeditor/ckeditor5-utils 47.4.0 → 47.5.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.js CHANGED Viewed

@@ -987,9 +987,9 @@ function isObject(structure) {
     ];
 }
-const version = '47.4.0';
+const version = '47.5.0-alpha.1';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2026, 0, 14);
+const releaseDate = new Date(2026, 1, 5);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * This error is thrown when, due to a mistake in the way CKEditor&nbsp;5 was installed,
@@ -2877,7 +2877,7 @@ function DomEmitterMixin(base) {
     return Object.prototype.toString.apply(obj) == '[object Range]';
 }
-const rectProperties = [
+const RECT_PROPERTIES = [
     'top',
     'right',
     'bottom',
@@ -2885,6 +2885,12 @@ const rectProperties = [
     'width',
     'height'
 ];
+const POSITIONING_VALUES = new Set([
+    'relative',
+    'absolute',
+    'fixed',
+    'sticky'
+]);
 /**
  * A helper class representing a `ClientRect` object, e.g. value returned by
  * the native `object.getBoundingClientRect()` method. Provides a set of methods
@@ -3088,48 +3094,20 @@ const rectProperties = [
         }
         let child = source;
         let parent = source.parentNode || source.commonAncestorContainer;
-        let absolutelyPositionedChildElement;
+        let lastPositionedChildElement;
         // Check the ancestors all the way up to the <body>.
         while(parent && !isBody(parent)){
-            const isParentOverflowVisible = getElementOverflow(parent) === 'visible';
-            if (child instanceof HTMLElement && getElementPosition(child) === 'absolute') {
-                absolutelyPositionedChildElement = child;
+            const isNonClippingParent = getElementOverflow(parent) === 'visible';
+            if (isPositioned(child)) {
+                lastPositionedChildElement = child;
             }
-            const parentElementPosition = getElementPosition(parent);
-            // The child will be cropped only if it has `position: absolute` and the parent has `position: relative` + some overflow.
-            // Otherwise there's no chance of visual clipping and the parent can be skipped
-            // https://github.com/ckeditor/ckeditor5/issues/14107.
-            //
-            // condition: isParentOverflowVisible
-            // 		+---------------------------+
-            //		| #parent					|
-            //		| (overflow: visible)		|
-            //		|				+-----------+---------------+
-            //		|				| child						|
-            //		|				+-----------+---------------+
-            //		+---------------------------+
+            // 1. If a parent has overflow: visible, it can be safely skipped in consideration for any parent-child configuration.
+            // 2. If a parent has any other overflow (it clips), for the actual clipping to happen the following must be true:
+            // * the last positioned child must have `position: absolute`,
+            // * the parent must have a position other than `position: static`.
             //
-            // condition: absolutelyPositionedChildElement && parentElementPosition === 'relative' && isParentOverflowVisible
-            // 		+---------------------------+
-            //		| parent					|
-            //		| (position: relative;)		|
-            //		| (overflow: visible;)		|
-            //		|				+-----------+---------------+
-            //		|				| child  					|
-            //		|				| (position: absolute;)		|
-            //		|				+-----------+---------------+
-            //		+---------------------------+
-            //
-            // condition: absolutelyPositionedChildElement && parentElementPosition !== 'relative'
-            // 		+---------------------------+
-            //		| parent					|
-            //		| (position: static;)		|
-            //		|				+-----------+---------------+
-            //		|				| child  					|
-            //		|				| (position: absolute;)		|
-            //		|				+-----------+---------------+
-            //		+---------------------------+
-            if (isParentOverflowVisible || absolutelyPositionedChildElement && (parentElementPosition === 'relative' && isParentOverflowVisible || parentElementPosition !== 'relative')) {
+            // https://github.com/ckeditor/ckeditor5/issues/14107.
+            if (isNonClippingParent || lastPositionedChildElement && getElementPosition(lastPositionedChildElement) === 'absolute' && !isPositioned(parent)) {
                 child = parent;
                 parent = parent.parentNode;
                 continue;
@@ -3158,7 +3136,7 @@ const rectProperties = [
 	 * @param anotherRect A rect instance to compare with.
 	 * @returns `true` when Rects are equal. `false` otherwise.
 	 */ isEqual(anotherRect) {
-        for (const prop of rectProperties){
+        for (const prop of RECT_PROPERTIES){
             if (this[prop] !== anotherRect[prop]) {
                 return false;
             }
@@ -3234,7 +3212,11 @@ const rectProperties = [
         const clientRects = Array.from(range.getClientRects());
         if (clientRects.length) {
             for (const rect of clientRects){
-                rects.push(new Rect(rect));
+                const r = new Rect(rect);
+                // Point the rect source to the DOM range instead of of the DOM client rect to allow proper clipping,
+                // in `Rect#getVisible()` method.
+                r._source = range;
+                rects.push(r);
             }
         } else {
             let startContainer = range.startContainer;
@@ -3281,7 +3263,7 @@ const rectProperties = [
 /**
  * Acquires all the rect properties from the passed source.
  */ function copyRectProperties(rect, source) {
-    for (const p of rectProperties){
+    for (const p of RECT_PROPERTIES){
         rect[p] = source[p];
     }
 }
@@ -3303,13 +3285,18 @@ const rectProperties = [
 /**
  * Returns the value of the `position` style of an `HTMLElement`.
  */ function getElementPosition(element) {
-    return element instanceof HTMLElement ? element.ownerDocument.defaultView.getComputedStyle(element).position : 'static';
+    return element.ownerDocument.defaultView.getComputedStyle(element).position;
 }
 /**
  * Returns the value of the `overflow` style of an `HTMLElement` or a `Range`.
  */ function getElementOverflow(element) {
     return element instanceof HTMLElement ? element.ownerDocument.defaultView.getComputedStyle(element).overflow : 'visible';
 }
+/**
+ * Checks if the given node is positioned in any other way than `position: static`.
+ */ function isPositioned(node) {
+    return node instanceof HTMLElement && POSITIONING_VALUES.has(getElementPosition(node));
+}
 /**
  * For a given absolute Rect coordinates object and a positioned element ancestor, it updates its
  * coordinates that make up for the position and the scroll of the ancestor.
@@ -4040,13 +4027,21 @@ const rectProperties = [
  * to be maintained while scrolling.
  * @param limiterElement The outermost ancestor that should be scrolled. If specified, it can prevent
  * scrolling the whole page.
- */ function scrollAncestorsToShowTarget(target, ancestorOffset, limiterElement) {
+ * @param alignToTop When set `true`, the function will make sure the `target` is scrolled up
+ * to the top boundary of the scrollable ancestors if scrolled up. When not set (default), the `target`
+ * will be revealed by scrolling as little as possible. This option will not affect target elements that must be
+ * scrolled down because they will appear at the top of the boundary anyway.
+ * @param forceScroll When set `true`, the `target` will be aligned to the top of scrollable ancestors
+ * whether it is already visible or not. This option will only work when `alignToTop` is `true`
+ */ function scrollAncestorsToShowTarget(target, ancestorOffset, limiterElement, alignToTop, forceScroll) {
     const targetParent = getParentElement(target);
     scrollAncestorsToShowRect({
         parent: targetParent,
         getRect: ()=>new Rect(target),
         ancestorOffset,
-        limiterElement
+        limiterElement,
+        alignToTop,
+        forceScroll
     });
 }
 /**