@ckeditor/ckeditor5-utils 43.0.0 → 43.1.0-alpha.0

package/dist/dom/getrangefrommouseevent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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
+ */
+/**
+ * @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
+ */
+/**
+ * @module utils/dom/getrangefrommouseevent
+ */
+/**
+ * Returns a DOM range from a given point specified by a mouse event.
+ *
+ * @param domEvent The mouse event.
+ * @returns The DOM range.
+ */
+export default function getRangeFromMouseEvent(domEvent: MouseEvent & {
+    rangeParent?: HTMLElement;
+    rangeOffset?: number;
+}): Range | null;

package/dist/dom/isvisible.d.ts

@@ -6,9 +6,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
  */
-/**
- * @module utils/dom/isvisible
- */
 /**
  * Checks whether the element is visible to the user in DOM:
  *
@@ -19,4 +16,4 @@
  * **Note**: This helper does not check whether the element is hidden by cropping, overflow, etc..
  * To check that, use {@link module:utils/dom/rect~Rect} instead.
  */
-export default function isVisible(element: HTMLElement | null | undefined): boolean;
+export default function isVisible(element: Text | HTMLElement | null | undefined): boolean;

package/dist/focustracker.d.ts

@@ -52,6 +52,10 @@ export default class FocusTracker extends /* #__PURE__ */ FocusTracker_base {
      */
     private _nextEventLoopTimeout;
     constructor();
+    /**
+     * List of registered elements.
+     */
+    get elements(): Array<Element>;
     /**
      * Starts tracking the specified element.
      */

package/dist/index.d.ts

@@ -32,6 +32,7 @@ export { default as global } from './dom/global.js';
 export { default as getAncestors } from './dom/getancestors.js';
 export { default as getDataFromElement } from './dom/getdatafromelement.js';
 export { default as getBorderWidths } from './dom/getborderwidths.js';
+export { default as getRangeFromMouseEvent } from './dom/getrangefrommouseevent.js';
 export { default as isText } from './dom/istext.js';
 export { default as Rect, type RectSource } from './dom/rect.js';
 export { default as ResizeObserver } from './dom/resizeobserver.js';

package/dist/index.js

@@ -732,19 +732,7 @@ diff.fastDiff = fastDiff;
  * @returns An unique id string.
  */ function uid() {
     // Let's create some positive random 32bit integers first.
-    //
-    // 1. Math.random() is a float between 0 and 1.
-    // 2. 0x100000000 is 2^32 = 4294967296.
-    // 3. >>> 0 enforces integer (in JS all numbers are floating point).
-    //
-    // For instance:
-    //		Math.random() * 0x100000000 = 3366450031.853859
-    // but
-    //		Math.random() * 0x100000000 >>> 0 = 3366450031.
-    const r1 = Math.random() * 0x100000000 >>> 0;
-    const r2 = Math.random() * 0x100000000 >>> 0;
-    const r3 = Math.random() * 0x100000000 >>> 0;
-    const r4 = Math.random() * 0x100000000 >>> 0;
+    const [r1, r2, r3, r4] = crypto.getRandomValues(new Uint32Array(4));
     // Make sure that id does not start with number.
     return 'e' + HEX_NUMBERS[r1 >> 0 & 0xFF] + HEX_NUMBERS[r1 >> 8 & 0xFF] + HEX_NUMBERS[r1 >> 16 & 0xFF] + HEX_NUMBERS[r1 >> 24 & 0xFF] + HEX_NUMBERS[r2 >> 0 & 0xFF] + HEX_NUMBERS[r2 >> 8 & 0xFF] + HEX_NUMBERS[r2 >> 16 & 0xFF] + HEX_NUMBERS[r2 >> 24 & 0xFF] + HEX_NUMBERS[r3 >> 0 & 0xFF] + HEX_NUMBERS[r3 >> 8 & 0xFF] + HEX_NUMBERS[r3 >> 16 & 0xFF] + HEX_NUMBERS[r3 >> 24 & 0xFF] + HEX_NUMBERS[r4 >> 0 & 0xFF] + HEX_NUMBERS[r4 >> 8 & 0xFF] + HEX_NUMBERS[r4 >> 16 & 0xFF] + HEX_NUMBERS[r4 >> 24 & 0xFF];
 }
@@ -965,9 +953,9 @@ diff.fastDiff = fastDiff;
     ];
 }
 
-const version = '43.0.0';
+const version = '43.1.0-alpha.0';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2024, 7, 7);
+const releaseDate = new Date(2024, 7, 28);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * The best solution to avoid this error is migrating your CKEditor 5 instance to
@@ -2804,6 +2792,35 @@ function DomEmitterMixin(base) {
     };
 }
 
+/**
+ * @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
+ */ /**
+ * @module utils/dom/getrangefrommouseevent
+ */ /**
+ * Returns a DOM range from a given point specified by a mouse event.
+ *
+ * @param domEvent The mouse event.
+ * @returns The DOM range.
+ */ function getRangeFromMouseEvent(domEvent) {
+    if (!domEvent.target) {
+        return null;
+    }
+    const domDoc = domEvent.target.ownerDocument;
+    const x = domEvent.clientX;
+    const y = domEvent.clientY;
+    let domRange = null;
+    // Webkit & Blink.
+    if (domDoc.caretRangeFromPoint && domDoc.caretRangeFromPoint(x, y)) {
+        domRange = domDoc.caretRangeFromPoint(x, y);
+    } else if (domEvent.rangeParent) {
+        domRange = domDoc.createRange();
+        domRange.setStart(domEvent.rangeParent, domEvent.rangeOffset);
+        domRange.collapse(true);
+    }
+    return domRange;
+}
+
 /**
  * @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
@@ -3513,11 +3530,6 @@ const rectProperties = [
 }
 
 /**
- * @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
- */ /**
- * @module utils/dom/isvisible
- */ /**
  * Checks whether the element is visible to the user in DOM:
  *
  * * connected to the root of the document,
@@ -3527,7 +3539,16 @@ const rectProperties = [
  * **Note**: This helper does not check whether the element is hidden by cropping, overflow, etc..
  * To check that, use {@link module:utils/dom/rect~Rect} instead.
  */ function isVisible(element) {
-    return !!(element && element.getClientRects && element.getClientRects().length);
+    if (!element) {
+        return false;
+    }
+    if (isText(element)) {
+        return isVisible(element.parentElement);
+    }
+    if (element.getClientRects) {
+        return !!element.getClientRects().length;
+    }
+    return false;
 }
 
 // @if CK_DEBUG_POSITION // const {
@@ -5321,6 +5342,11 @@ function getNumberOfLanguages(translations) {
         this.set('isFocused', false);
         this.set('focusedElement', null);
     }
+    /**
+	 * List of registered elements.
+	 */ get elements() {
+        return Array.from(this._elements.values());
+    }
     /**
 	 * Starts tracking the specified element.
 	 */ add(element) {
@@ -5812,5 +5838,5 @@ function buildEmojiRegexp() {
     return new RegExp(sequence, 'ug');
 }
 
-export { CKEditorError, Collection, Config, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, abortableDebounce, compareArrays, count, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, getAncestors, getBorderWidths, getCode, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isVisible, keyCodes, logError, logWarning, mix, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, toArray, toMap, toUnit, uid, verifyLicense, version, wait };
+export { CKEditorError, Collection, Config, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, abortableDebounce, compareArrays, count, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, getAncestors, getBorderWidths, getCode, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, getRangeFromMouseEvent, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isVisible, keyCodes, logError, logWarning, mix, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, toArray, toMap, toUnit, uid, verifyLicense, version, wait };
 //# sourceMappingURL=index.js.map