@ckeditor/ckeditor5-utils 38.2.0-alpha.1 → 39.0.0

package/README.md

@@ -4,7 +4,6 @@ CKEditor 5 utilities
 [![npm version](https://badge.fury.io/js/%40ckeditor%2Fckeditor5-utils.svg)](https://www.npmjs.com/package/@ckeditor/ckeditor5-utils)
 [![Coverage Status](https://coveralls.io/repos/github/ckeditor/ckeditor5/badge.svg?branch=master)](https://coveralls.io/github/ckeditor/ckeditor5?branch=master)
 [![Build Status](https://travis-ci.com/ckeditor/ckeditor5.svg?branch=master)](https://app.travis-ci.com/github/ckeditor/ckeditor5)
-![Dependency Status](https://img.shields.io/librariesio/release/npm/@ckeditor/ckeditor5-utils)
 
 Various utilities used by CKEditor 5 and its features. This is a sort of  CKEditor 5's standard library.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-utils",
-  "version": "38.2.0-alpha.1",
+  "version": "39.0.0",
   "description": "Miscellaneous utilities used by CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -10,9 +10,8 @@
     "ckeditor5-dll"
   ],
   "main": "src/index.js",
-  "type": "module",
   "dependencies": {
-    "lodash-es": "^4.17.15"
+    "lodash-es": "4.17.21"
   },
   "engines": {
     "node": ">=16.0.0",

package/src/collection.d.ts

@@ -3,8 +3,8 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 declare const Collection_base: {
-    new (): import("./emittermixin.js").Emitter;
-    prototype: import("./emittermixin.js").Emitter;
+    new (): import("./emittermixin").Emitter;
+    prototype: import("./emittermixin").Emitter;
 };
 /**
  * Collections are ordered sets of objects. Items in the collection can be retrieved by their indexes

package/src/collection.js

@@ -5,10 +5,10 @@
 /**
  * @module utils/collection
  */
-import EmitterMixin from './emittermixin.js';
-import CKEditorError from './ckeditorerror.js';
-import uid from './uid.js';
-import isIterable from './isiterable.js';
+import EmitterMixin from './emittermixin';
+import CKEditorError from './ckeditorerror';
+import uid from './uid';
+import isIterable from './isiterable';
 /**
  * Collections are ordered sets of objects. Items in the collection can be retrieved by their indexes
  * in the collection (like in an array) or by their ids.

package/src/diff.d.ts

@@ -22,7 +22,7 @@
  */
 declare function diff<T>(a: ArrayLike<T>, b: ArrayLike<T>, cmp?: (a: T, b: T) => boolean): Array<DiffResult>;
 declare namespace diff {
-    var fastDiff: typeof import("./fastdiff.js").default;
+    var fastDiff: typeof import("./fastdiff").default;
 }
 export default diff;
 /**

package/src/diff.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/diff
  */
-import fastDiff from './fastdiff.js';
+import fastDiff from './fastdiff';
 // The following code is based on the "O(NP) Sequence Comparison Algorithm"
 // by Sun Wu, Udi Manber, Gene Myers, Webb Miller.
 /**

package/src/difftochanges.d.ts

@@ -2,7 +2,7 @@
  * @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
  */
-import type { DiffResult } from './diff.js';
+import type { DiffResult } from './diff';
 /**
  * @module utils/difftochanges
  */

package/src/dom/createelement.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/createelement
  */
-import isIterable from '../isiterable.js';
+import isIterable from '../isiterable';
 import { isString } from 'lodash-es';
 /**
  * Creates an HTML or SVG element with attributes and children elements.

package/src/dom/emittermixin.d.ts

@@ -5,9 +5,9 @@
 /**
  * @module utils/dom/emittermixin
  */
-import { type Emitter, type CallbackOptions, type BaseEvent, type GetCallback } from '../emittermixin.js';
-import type EventInfo from '../eventinfo.js';
-import type { Constructor, Mixed } from '../mix.js';
+import { type Emitter, type CallbackOptions, type BaseEvent, type GetCallback } from '../emittermixin';
+import type EventInfo from '../eventinfo';
+import type { Constructor, Mixed } from '../mix';
 /**
  * Mixin that injects the DOM events API into its host. It provides the API
  * compatible with {@link module:utils/emittermixin~Emitter}.

package/src/dom/emittermixin.js

@@ -5,10 +5,10 @@
 /**
  * @module utils/dom/emittermixin
  */
-import EmitterMixin, { _getEmitterListenedTo, _setEmitterId } from '../emittermixin.js';
-import uid from '../uid.js';
-import isNode from './isnode.js';
-import isWindow from './iswindow.js';
+import EmitterMixin, { _getEmitterListenedTo, _setEmitterId } from '../emittermixin';
+import uid from '../uid';
+import isNode from './isnode';
+import isWindow from './iswindow';
 const defaultEmitterClass = DomEmitterMixin(EmitterMixin());
 export default function DomEmitterMixin(base) {
     if (!base) {

package/src/dom/findclosestscrollableancestor.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/findclosestscrollableancestor
  */
-import global from './global.js';
+import global from './global';
 /**
  * Returns the closest scrollable ancestor of a DOM element.
  *

package/src/dom/getcommonancestor.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/getcommonancestor
  */
-import getAncestors from './getancestors.js';
+import getAncestors from './getancestors';
 /**
  * Searches and returns the lowest common ancestor of two given nodes.
  *

package/src/dom/getelementsintersectionrect.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @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 utils/dom/getelementsintersectionrect
+ */
+import Rect from './rect';
+/**
+ * Calculates the intersection `Rect` of a given set of elements (and/or a `document`).
+ * Also, takes into account the viewport top offset configuration.
+ *
+ * @internal
+ * @param elements
+ * @param viewportTopOffset
+ */
+export default function getElementsIntersectionRect(elements: Array<HTMLElement | Document>, viewportTopOffset?: number): Rect | null;

package/src/dom/getelementsintersectionrect.js

@@ -0,0 +1,42 @@
+/**
+ * @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 utils/dom/getelementsintersectionrect
+ */
+import Rect from './rect';
+/**
+ * Calculates the intersection `Rect` of a given set of elements (and/or a `document`).
+ * Also, takes into account the viewport top offset configuration.
+ *
+ * @internal
+ * @param elements
+ * @param viewportTopOffset
+ */
+export default function getElementsIntersectionRect(elements, viewportTopOffset = 0) {
+    const elementRects = elements.map(element => {
+        // The document (window) is yet another "element", but cropped by the top offset.
+        if (element instanceof Document) {
+            const windowRect = new Rect(global.window);
+            windowRect.top += viewportTopOffset;
+            windowRect.height -= viewportTopOffset;
+            return windowRect;
+        }
+        else {
+            return new Rect(element);
+        }
+    });
+    let intersectionRect = elementRects[0];
+    // @if CK_DEBUG_GETELEMENTSINTERSECTIONRECT // for ( const rect of elementRects ) {
+    // @if CK_DEBUG_GETELEMENTSINTERSECTIONRECT // 	RectDrawer.draw( rect, {
+    // @if CK_DEBUG_GETELEMENTSINTERSECTIONRECT // 		outlineWidth: '1px', opacity: '.7', outlineStyle: 'dashed'
+    // @if CK_DEBUG_GETELEMENTSINTERSECTIONRECT // 	}, 'Scrollable element' );
+    // @if CK_DEBUG_GETELEMENTSINTERSECTIONRECT // }
+    for (const rect of elementRects.slice(1)) {
+        if (intersectionRect) {
+            intersectionRect = intersectionRect.getIntersection(rect);
+        }
+    }
+    return intersectionRect;
+}

package/src/dom/getpositionedancestor.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/getpositionedancestor
  */
-import global from './global.js';
+import global from './global';
 /**
  * For a given element, returns the nearest ancestor element which CSS position is not "static".
  *

package/src/dom/getscrollableancestors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @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
+ */
+/**
+ * Loops over the given element's ancestors to find all the scrollable elements.
+ *
+ * **Note**: The `document` is always included in the returned array.
+ *
+ * @internal
+ * @param element
+ * @returns An array of scrollable element's ancestors (including the `document`).
+ */
+export default function getScrollableAncestors(element: HTMLElement): Array<HTMLElement | Document>;

package/src/dom/getscrollableancestors.js

@@ -0,0 +1,28 @@
+/**
+ * @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 utils/dom/getscrollableancestors
+ */
+import global from './global';
+import findClosestScrollableAncestor from './findclosestscrollableancestor';
+/**
+ * Loops over the given element's ancestors to find all the scrollable elements.
+ *
+ * **Note**: The `document` is always included in the returned array.
+ *
+ * @internal
+ * @param element
+ * @returns An array of scrollable element's ancestors (including the `document`).
+ */
+export default function getScrollableAncestors(element) {
+    const scrollableAncestors = [];
+    let scrollableAncestor = findClosestScrollableAncestor(element);
+    while (scrollableAncestor && scrollableAncestor !== global.document.body) {
+        scrollableAncestors.push(scrollableAncestor);
+        scrollableAncestor = findClosestScrollableAncestor(scrollableAncestor);
+    }
+    scrollableAncestors.push(global.document);
+    return scrollableAncestors;
+}

package/src/dom/isvalidattributename.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/isvalidattributename
  */
-import global from './global.js';
+import global from './global';
 /**
  * Checks if the given attribute name is valid in terms of HTML.
  *

package/src/dom/position.d.ts

@@ -2,7 +2,7 @@
  * @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
  */
-import Rect, { type RectSource } from './rect.js';
+import Rect, { type RectSource } from './rect';
 /**
  * Calculates the `position: absolute` coordinates of a given element so it can be positioned with respect to the
  * target in the visually most efficient way, taking various restrictions like viewport or limiter geometry

package/src/dom/position.js

@@ -5,10 +5,10 @@
 /**
  * @module utils/dom/position
  */
-import global from './global.js';
-import Rect from './rect.js';
-import getPositionedAncestor from './getpositionedancestor.js';
-import getBorderWidths from './getborderwidths.js';
+import global from './global';
+import Rect from './rect';
+import getPositionedAncestor from './getpositionedancestor';
+import getBorderWidths from './getborderwidths';
 import { isFunction } from 'lodash-es';
 // @if CK_DEBUG_POSITION // const RectDrawer = require( '@ckeditor/ckeditor5-utils/tests/_utils/rectdrawer' ).default
 /**

package/src/dom/rect.js

@@ -5,10 +5,10 @@
 /**
  * @module utils/dom/rect
  */
-import isRange from './isrange.js';
-import isWindow from './iswindow.js';
-import getBorderWidths from './getborderwidths.js';
-import isText from './istext.js';
+import isRange from './isrange';
+import isWindow from './iswindow';
+import getBorderWidths from './getborderwidths';
+import isText from './istext';
 const rectProperties = ['top', 'right', 'bottom', 'left', 'width', 'height'];
 /**
  * A helper class representing a `ClientRect` object, e.g. value returned by

package/src/dom/resizeobserver.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/resizeobserver
  */
-import global from './global.js';
+import global from './global';
 /**
  * A helper class which instances allow performing custom actions when native DOM elements are resized.
  *

package/src/dom/scroll.d.ts

@@ -66,6 +66,8 @@ export declare function scrollViewportToShowTarget<T extends boolean, U extends
  * @param target A target, which supposed to become visible to the user.
  * @param ancestorOffset An offset between the target and the boundary of scrollable ancestors
  * to be maintained while scrolling.
+ * @param limiterElement The outermost ancestor that should be scrolled. If specified, it can prevent
+ * scrolling the whole page.
  */
-export declare function scrollAncestorsToShowTarget(target: HTMLElement | Range, ancestorOffset?: number): void;
+export declare function scrollAncestorsToShowTarget(target: HTMLElement | Range, ancestorOffset?: number, limiterElement?: HTMLElement): void;
 export {};

package/src/dom/scroll.js

@@ -5,9 +5,9 @@
 /**
  * @module utils/dom/scroll
  */
-import isRange from './isrange.js';
-import Rect from './rect.js';
-import isText from './istext.js';
+import isRange from './isrange';
+import Rect from './rect';
+import isText from './istext';
 /**
  * Makes any page `HTMLElement` or `Range` (`target`) visible inside the browser viewport.
  * This helper will scroll all `target` ancestors and the web browser viewport to reveal the target to
@@ -124,13 +124,16 @@ export function scrollViewportToShowTarget({ target, viewportOffset = 0, ancesto
  * @param target A target, which supposed to become visible to the user.
  * @param ancestorOffset An offset between the target and the boundary of scrollable ancestors
  * to be maintained while scrolling.
+ * @param limiterElement The outermost ancestor that should be scrolled. If specified, it can prevent
+ * scrolling the whole page.
  */
-export function scrollAncestorsToShowTarget(target, ancestorOffset) {
+export function scrollAncestorsToShowTarget(target, ancestorOffset, limiterElement) {
     const targetParent = getParentElement(target);
     scrollAncestorsToShowRect({
         parent: targetParent,
         getRect: () => new Rect(target),
-        ancestorOffset
+        ancestorOffset,
+        limiterElement
     });
 }
 /**
@@ -246,12 +249,14 @@ function scrollWindowToShowRect({ window, rect, alignToTop, forceScroll, viewpor
  * anyway.
  * @param options.forceScroll When set `true`, the `rect` 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`
+ * @param options.limiterElement The outermost ancestor that should be scrolled. Defaults to the `<body>` element.
  */
-function scrollAncestorsToShowRect({ parent, getRect, alignToTop, forceScroll, ancestorOffset = 0 }) {
+function scrollAncestorsToShowRect({ parent, getRect, alignToTop, forceScroll, ancestorOffset = 0, limiterElement }) {
     const parentWindow = getWindow(parent);
     const forceScrollToTop = alignToTop && forceScroll;
     let parentRect, targetRect, targetFitsInTarget;
-    while (parent != parentWindow.document.body) {
+    const limiter = limiterElement || parentWindow.document.body;
+    while (parent != limiter) {
         targetRect = getRect();
         parentRect = new Rect(parent).excludeScrollbarsAndBorders();
         targetFitsInTarget = parentRect.contains(targetRect);

package/src/emittermixin.d.ts

@@ -5,10 +5,10 @@
 /**
  * @module utils/emittermixin
  */
-import EventInfo from './eventinfo.js';
-import { type PriorityString } from './priorities.js';
-import type { Constructor, Mixed } from './mix.js';
-import './version.js';
+import EventInfo from './eventinfo';
+import { type PriorityString } from './priorities';
+import type { Constructor, Mixed } from './mix';
+import './version';
 /**
  * Mixin that injects the {@link ~Emitter events API} into its host.
  *

package/src/emittermixin.js

@@ -5,13 +5,13 @@
 /**
  * @module utils/emittermixin
  */
-import EventInfo from './eventinfo.js';
-import uid from './uid.js';
-import priorities from './priorities.js';
-import insertToPriorityArray from './inserttopriorityarray.js';
+import EventInfo from './eventinfo';
+import uid from './uid';
+import priorities from './priorities';
+import insertToPriorityArray from './inserttopriorityarray';
 // To check if component is loaded more than once.
-import './version.js';
-import CKEditorError from './ckeditorerror.js';
+import './version';
+import CKEditorError from './ckeditorerror';
 const _listeningTo = Symbol('listeningTo');
 const _emitterId = Symbol('emitterId');
 const _delegations = Symbol('delegations');

package/src/eventinfo.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/eventinfo
  */
-import spy from './spy.js';
+import spy from './spy';
 /**
  * The event object passed to event callbacks. It is used to provide information about the event as well as a tool to
  * manipulate it.

package/src/fastdiff.d.ts

@@ -2,8 +2,8 @@
  * @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
  */
-import type { DiffResult } from './diff.js';
-import type { Change } from './difftochanges.js';
+import type { DiffResult } from './diff';
+import type { Change } from './difftochanges';
 /**
  * @module utils/fastdiff
  */

package/src/focustracker.d.ts

@@ -2,10 +2,10 @@
  * @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
  */
-declare const FocusTracker_base: import("./mix.js").Mixed<{
-    new (): import("./observablemixin.js").Observable;
-    prototype: import("./observablemixin.js").Observable;
-}, import("./dom/emittermixin.js").DomEmitter>;
+declare const FocusTracker_base: import("./mix").Mixed<{
+    new (): import("./observablemixin").Observable;
+    prototype: import("./observablemixin").Observable;
+}, import("./dom/emittermixin").DomEmitter>;
 /**
  * Allows observing a group of `Element`s whether at least one of them is focused.
  *

package/src/focustracker.js

@@ -6,9 +6,9 @@
 /**
  * @module utils/focustracker
  */
-import DomEmitterMixin from './dom/emittermixin.js';
-import ObservableMixin from './observablemixin.js';
-import CKEditorError from './ckeditorerror.js';
+import DomEmitterMixin from './dom/emittermixin';
+import ObservableMixin from './observablemixin';
+import CKEditorError from './ckeditorerror';
 /**
  * Allows observing a group of `Element`s whether at least one of them is focused.
  *

package/src/index.d.ts

@@ -5,56 +5,58 @@
 /**
  * @module utils
  */
-export { default as env } from './env.js';
-export { default as diff, type DiffResult } from './diff.js';
-export { default as fastDiff } from './fastdiff.js';
-export { default as diffToChanges } from './difftochanges.js';
-export { default as mix } from './mix.js';
-export type { Constructor, Mixed } from './mix.js';
-export { default as EmitterMixin, type Emitter, type BaseEvent, type CallbackOptions, type EmitterMixinDelegateChain, type GetCallback, type GetCallbackOptions, type GetEventInfo, type GetNameOrEventInfo } from './emittermixin.js';
-export { default as EventInfo } from './eventinfo.js';
-export { default as ObservableMixin, type Observable, type DecoratedMethodEvent, type ObservableChangeEvent, type ObservableSetEvent } from './observablemixin.js';
-export { default as CKEditorError, logError, logWarning } from './ckeditorerror.js';
-export { default as ElementReplacer } from './elementreplacer.js';
-export { default as count } from './count.js';
-export { default as compareArrays } from './comparearrays.js';
-export { default as createElement } from './dom/createelement.js';
-export { default as Config } from './config.js';
-export { default as isIterable } from './isiterable.js';
-export { default as DomEmitterMixin, type DomEmitter } from './dom/emittermixin.js';
-export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor.js';
-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 isText } from './dom/istext.js';
-export { default as Rect, type RectSource } from './dom/rect.js';
-export { default as ResizeObserver } from './dom/resizeobserver.js';
-export { default as setDataInElement } from './dom/setdatainelement.js';
-export { default as toUnit } from './dom/tounit.js';
-export { default as indexOf } from './dom/indexof.js';
-export { default as insertAt } from './dom/insertat.js';
-export { default as isComment } from './dom/iscomment.js';
-export { default as isNode } from './dom/isnode.js';
-export { default as isRange } from './dom/isrange.js';
-export { default as isValidAttributeName } from './dom/isvalidattributename.js';
-export { default as isVisible } from './dom/isvisible.js';
-export { getOptimalPosition, type Options as PositionOptions, type PositioningFunction } from './dom/position.js';
-export { default as remove } from './dom/remove.js';
-export * from './dom/scroll.js';
-export * from './keyboard.js';
-export * from './language.js';
-export { default as Locale, type LocaleTranslate } from './locale.js';
-export { default as Collection, type CollectionAddEvent, type CollectionChangeEvent, type CollectionRemoveEvent } from './collection.js';
-export { default as first } from './first.js';
-export { default as FocusTracker } from './focustracker.js';
-export { default as KeystrokeHandler } from './keystrokehandler.js';
-export { default as toArray, type ArrayOrItem, type ReadonlyArrayOrItem } from './toarray.js';
-export { default as toMap } from './tomap.js';
-export { default as priorities, type PriorityString } from './priorities.js';
-export { default as insertToPriorityArray } from './inserttopriorityarray.js';
-export { default as spliceArray } from './splicearray.js';
-export { default as uid } from './uid.js';
-export { default as delay, type DelayedFunc } from './delay.js';
-export { default as verifyLicense } from './verifylicense.js';
-export * from './unicode.js';
-export { default as version, releaseDate } from './version.js';
+export { default as env } from './env';
+export { default as diff, type DiffResult } from './diff';
+export { default as fastDiff } from './fastdiff';
+export { default as diffToChanges } from './difftochanges';
+export { default as mix } from './mix';
+export type { Constructor, Mixed } from './mix';
+export { default as EmitterMixin, type Emitter, type BaseEvent, type CallbackOptions, type EmitterMixinDelegateChain, type GetCallback, type GetCallbackOptions, type GetEventInfo, type GetNameOrEventInfo } from './emittermixin';
+export { default as EventInfo } from './eventinfo';
+export { default as ObservableMixin, type Observable, type DecoratedMethodEvent, type ObservableChangeEvent, type ObservableSetEvent } from './observablemixin';
+export { default as CKEditorError, logError, logWarning } from './ckeditorerror';
+export { default as ElementReplacer } from './elementreplacer';
+export { default as count } from './count';
+export { default as compareArrays } from './comparearrays';
+export { default as createElement } from './dom/createelement';
+export { default as Config } from './config';
+export { default as isIterable } from './isiterable';
+export { default as DomEmitterMixin, type DomEmitter } from './dom/emittermixin';
+export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor';
+export { default as global } from './dom/global';
+export { default as getAncestors } from './dom/getancestors';
+export { default as getElementsIntersectionRect } from './dom/getelementsintersectionrect';
+export { default as getScrollableAncestors } from './dom/getscrollableancestors';
+export { default as getDataFromElement } from './dom/getdatafromelement';
+export { default as isText } from './dom/istext';
+export { default as Rect, type RectSource } from './dom/rect';
+export { default as ResizeObserver } from './dom/resizeobserver';
+export { default as setDataInElement } from './dom/setdatainelement';
+export { default as toUnit } from './dom/tounit';
+export { default as indexOf } from './dom/indexof';
+export { default as insertAt } from './dom/insertat';
+export { default as isComment } from './dom/iscomment';
+export { default as isNode } from './dom/isnode';
+export { default as isRange } from './dom/isrange';
+export { default as isValidAttributeName } from './dom/isvalidattributename';
+export { default as isVisible } from './dom/isvisible';
+export { getOptimalPosition, type Options as PositionOptions, type PositioningFunction, type Position } from './dom/position';
+export { default as remove } from './dom/remove';
+export * from './dom/scroll';
+export * from './keyboard';
+export * from './language';
+export { default as Locale, type LocaleTranslate } from './locale';
+export { default as Collection, type CollectionAddEvent, type CollectionChangeEvent, type CollectionRemoveEvent } from './collection';
+export { default as first } from './first';
+export { default as FocusTracker } from './focustracker';
+export { default as KeystrokeHandler } from './keystrokehandler';
+export { default as toArray, type ArrayOrItem, type ReadonlyArrayOrItem } from './toarray';
+export { default as toMap } from './tomap';
+export { default as priorities, type PriorityString } from './priorities';
+export { default as insertToPriorityArray } from './inserttopriorityarray';
+export { default as spliceArray } from './splicearray';
+export { default as uid } from './uid';
+export { default as delay, type DelayedFunc } from './delay';
+export { default as verifyLicense } from './verifylicense';
+export * from './unicode';
+export { default as version, releaseDate } from './version';

package/src/index.js

@@ -5,55 +5,57 @@
 /**
  * @module utils
  */
-export { default as env } from './env.js';
-export { default as diff } from './diff.js';
-export { default as fastDiff } from './fastdiff.js';
-export { default as diffToChanges } from './difftochanges.js';
-export { default as mix } from './mix.js';
-export { default as EmitterMixin } from './emittermixin.js';
-export { default as EventInfo } from './eventinfo.js';
-export { default as ObservableMixin } from './observablemixin.js';
-export { default as CKEditorError, logError, logWarning } from './ckeditorerror.js';
-export { default as ElementReplacer } from './elementreplacer.js';
-export { default as count } from './count.js';
-export { default as compareArrays } from './comparearrays.js';
-export { default as createElement } from './dom/createelement.js';
-export { default as Config } from './config.js';
-export { default as isIterable } from './isiterable.js';
-export { default as DomEmitterMixin } from './dom/emittermixin.js';
-export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor.js';
-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 isText } from './dom/istext.js';
-export { default as Rect } from './dom/rect.js';
-export { default as ResizeObserver } from './dom/resizeobserver.js';
-export { default as setDataInElement } from './dom/setdatainelement.js';
-export { default as toUnit } from './dom/tounit.js';
-export { default as indexOf } from './dom/indexof.js';
-export { default as insertAt } from './dom/insertat.js';
-export { default as isComment } from './dom/iscomment.js';
-export { default as isNode } from './dom/isnode.js';
-export { default as isRange } from './dom/isrange.js';
-export { default as isValidAttributeName } from './dom/isvalidattributename.js';
-export { default as isVisible } from './dom/isvisible.js';
-export { getOptimalPosition } from './dom/position.js';
-export { default as remove } from './dom/remove.js';
-export * from './dom/scroll.js';
-export * from './keyboard.js';
-export * from './language.js';
-export { default as Locale } from './locale.js';
-export { default as Collection } from './collection.js';
-export { default as first } from './first.js';
-export { default as FocusTracker } from './focustracker.js';
-export { default as KeystrokeHandler } from './keystrokehandler.js';
-export { default as toArray } from './toarray.js';
-export { default as toMap } from './tomap.js';
-export { default as priorities } from './priorities.js';
-export { default as insertToPriorityArray } from './inserttopriorityarray.js';
-export { default as spliceArray } from './splicearray.js';
-export { default as uid } from './uid.js';
-export { default as delay } from './delay.js';
-export { default as verifyLicense } from './verifylicense.js';
-export * from './unicode.js';
-export { default as version, releaseDate } from './version.js';
+export { default as env } from './env';
+export { default as diff } from './diff';
+export { default as fastDiff } from './fastdiff';
+export { default as diffToChanges } from './difftochanges';
+export { default as mix } from './mix';
+export { default as EmitterMixin } from './emittermixin';
+export { default as EventInfo } from './eventinfo';
+export { default as ObservableMixin } from './observablemixin';
+export { default as CKEditorError, logError, logWarning } from './ckeditorerror';
+export { default as ElementReplacer } from './elementreplacer';
+export { default as count } from './count';
+export { default as compareArrays } from './comparearrays';
+export { default as createElement } from './dom/createelement';
+export { default as Config } from './config';
+export { default as isIterable } from './isiterable';
+export { default as DomEmitterMixin } from './dom/emittermixin';
+export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor';
+export { default as global } from './dom/global';
+export { default as getAncestors } from './dom/getancestors';
+export { default as getElementsIntersectionRect } from './dom/getelementsintersectionrect';
+export { default as getScrollableAncestors } from './dom/getscrollableancestors';
+export { default as getDataFromElement } from './dom/getdatafromelement';
+export { default as isText } from './dom/istext';
+export { default as Rect } from './dom/rect';
+export { default as ResizeObserver } from './dom/resizeobserver';
+export { default as setDataInElement } from './dom/setdatainelement';
+export { default as toUnit } from './dom/tounit';
+export { default as indexOf } from './dom/indexof';
+export { default as insertAt } from './dom/insertat';
+export { default as isComment } from './dom/iscomment';
+export { default as isNode } from './dom/isnode';
+export { default as isRange } from './dom/isrange';
+export { default as isValidAttributeName } from './dom/isvalidattributename';
+export { default as isVisible } from './dom/isvisible';
+export { getOptimalPosition } from './dom/position';
+export { default as remove } from './dom/remove';
+export * from './dom/scroll';
+export * from './keyboard';
+export * from './language';
+export { default as Locale } from './locale';
+export { default as Collection } from './collection';
+export { default as first } from './first';
+export { default as FocusTracker } from './focustracker';
+export { default as KeystrokeHandler } from './keystrokehandler';
+export { default as toArray } from './toarray';
+export { default as toMap } from './tomap';
+export { default as priorities } from './priorities';
+export { default as insertToPriorityArray } from './inserttopriorityarray';
+export { default as spliceArray } from './splicearray';
+export { default as uid } from './uid';
+export { default as delay } from './delay';
+export { default as verifyLicense } from './verifylicense';
+export * from './unicode';
+export { default as version, releaseDate } from './version';

package/src/inserttopriorityarray.d.ts

@@ -2,7 +2,7 @@
  * @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
  */
-import { type PriorityString } from './priorities.js';
+import { type PriorityString } from './priorities';
 /**
  * @module utils/inserttopriorityarray
  */

package/src/inserttopriorityarray.js

@@ -2,7 +2,7 @@
  * @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
  */
-import priorities from './priorities.js';
+import priorities from './priorities';
 /**
  * Inserts any object with priority at correct index by priority so registered objects are always sorted from highest to lowest priority.
  *

package/src/keyboard.d.ts

@@ -7,7 +7,7 @@
  *
  * @module utils/keyboard
  */
-import type { LanguageDirection } from './language.js';
+import type { LanguageDirection } from './language';
 /**
  * An object with `keyName => keyCode` pairs for a set of known keys.
  *

package/src/keyboard.js

@@ -2,8 +2,8 @@
  * @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
  */
-import CKEditorError from './ckeditorerror.js';
-import env from './env.js';
+import CKEditorError from './ckeditorerror';
+import env from './env';
 const modifiersToGlyphsMac = {
     ctrl: '⌃',
     cmd: '⌘',

package/src/keystrokehandler.d.ts

@@ -2,9 +2,9 @@
  * @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
  */
-import type { Emitter } from './emittermixin.js';
-import { type KeystrokeInfo } from './keyboard.js';
-import type { PriorityString } from './priorities.js';
+import type { Emitter } from './emittermixin';
+import { type KeystrokeInfo } from './keyboard';
+import type { PriorityString } from './priorities';
 /**
  * Keystroke handler allows registering callbacks for given keystrokes.
  *

package/src/keystrokehandler.js

@@ -5,8 +5,8 @@
 /**
  * @module utils/keystrokehandler
  */
-import DomEmitterMixin from './dom/emittermixin.js';
-import { getCode, parseKeystroke } from './keyboard.js';
+import DomEmitterMixin from './dom/emittermixin';
+import { getCode, parseKeystroke } from './keyboard';
 /**
  * Keystroke handler allows registering callbacks for given keystrokes.
  *

package/src/locale.d.ts

@@ -2,8 +2,8 @@
  * @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
  */
-import { type Message } from './translation-service.js';
-import { type LanguageDirection } from './language.js';
+import { type Message } from './translation-service';
+import { type LanguageDirection } from './language';
 /**
  * Represents the localization services.
  */

package/src/locale.js

@@ -6,9 +6,9 @@
  * @module utils/locale
  */
 /* globals console */
-import toArray from './toarray.js';
-import { _translate } from './translation-service.js';
-import { getLanguageDirection } from './language.js';
+import toArray from './toarray';
+import { _translate } from './translation-service';
+import { getLanguageDirection } from './language';
 /**
  * Represents the localization services.
  */

package/src/observablemixin.d.ts

@@ -5,8 +5,8 @@
 /**
  * @module utils/observablemixin
  */
-import { type Emitter } from './emittermixin.js';
-import type { Constructor, Mixed } from './mix.js';
+import { type Emitter } from './emittermixin';
+import type { Constructor, Mixed } from './mix';
 /**
  * A mixin that injects the "observable properties" and data binding functionality described in the
  * {@link ~Observable} interface.
@@ -531,6 +531,8 @@ interface SingleBindChain<TKey extends string, TVal> {
     to<O1 extends Observable, K1 extends keyof O1, O2 extends Observable, K2 extends keyof O2, O3 extends Observable, K3 extends keyof O3>(observable1: O1, key1: K1, observable2: O2, key2: K2, observable3: O3, key3: K3, callback: (value1: O1[K1], value2: O2[K2], value3: O3[K3]) => TVal): void;
     to<O1 extends ObservableWithProperty<TKey>, O2 extends ObservableWithProperty<TKey>, O3 extends ObservableWithProperty<TKey>, O4 extends ObservableWithProperty<TKey>>(observable1: O1, observable2: O2, observable3: O3, observable4: O4, callback: (value1: O1[TKey], value2: O2[TKey], value3: O3[TKey], value4: O4[TKey]) => TVal): void;
     to<O1 extends Observable, K1 extends keyof O1, O2 extends Observable, K2 extends keyof O2, O3 extends Observable, K3 extends keyof O3, O4 extends Observable, K4 extends keyof O4>(observable1: O1, key1: K1, observable2: O2, key2: K2, observable3: O3, key3: K3, observable4: O4, key4: K4, callback: (value1: O1[K1], value2: O2[K2], value3: O3[K3], value4: O4[K4]) => TVal): void;
+    to<O1 extends ObservableWithProperty<TKey>, O2 extends ObservableWithProperty<TKey>, O3 extends ObservableWithProperty<TKey>, O4 extends ObservableWithProperty<TKey>, O5 extends ObservableWithProperty<TKey>>(observable1: O1, observable2: O2, observable3: O3, observable4: O4, observable5: O5, callback: (value1: O1[TKey], value2: O2[TKey], value3: O3[TKey], value4: O4[TKey], value5: O5[TKey]) => TVal): void;
+    to<O1 extends Observable, K1 extends keyof O1, O2 extends Observable, K2 extends keyof O2, O3 extends Observable, K3 extends keyof O3, O4 extends Observable, K4 extends keyof O4, O5 extends Observable, K5 extends keyof O5>(observable1: O1, key1: K1, observable2: O2, key2: K2, observable3: O3, key3: K3, observable4: O4, key4: K4, observable5: O5, key5: K5, callback: (value1: O1[K1], value2: O2[K2], value3: O3[K3], value4: O4[K4], value5: O5[K5]) => TVal): void;
 }
 /**
  * A helper type that can be used as a constraint, ensuring the type is both observable and have the given property.

package/src/observablemixin.js

@@ -6,8 +6,8 @@
 /**
  * @module utils/observablemixin
  */
-import EmitterMixin from './emittermixin.js';
-import CKEditorError from './ckeditorerror.js';
+import EmitterMixin from './emittermixin';
+import CKEditorError from './ckeditorerror';
 import { isObject } from 'lodash-es';
 const observablePropertiesSymbol = Symbol('observableProperties');
 const boundObservablesSymbol = Symbol('boundObservables');

package/src/tomap.js

@@ -5,8 +5,8 @@
 /**
  * @module utils/tomap
  */
-import objectToMap from './objecttomap.js';
-import isIterable from './isiterable.js';
+import objectToMap from './objecttomap';
+import isIterable from './isiterable';
 /**
  * Transforms object or iterable to map. Iterable needs to be in the format acceptable by the `Map` constructor.
  *

package/src/translation-service.js

@@ -6,8 +6,8 @@
 /**
  * @module utils/translation-service
  */
-import CKEditorError from './ckeditorerror.js';
-import global from './dom/global.js';
+import CKEditorError from './ckeditorerror';
+import global from './dom/global';
 /* istanbul ignore else -- @preserve */
 if (!global.window.CKEDITOR_TRANSLATIONS) {
     global.window.CKEDITOR_TRANSLATIONS = {};

package/src/verifylicense.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/verifylicense
  */
-import { releaseDate } from './version.js';
+import { releaseDate } from './version';
 /**
  * Checks whether the given string contains information that allows you to verify the license status.
  *

package/src/version.d.ts

@@ -2,7 +2,7 @@
  * @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
  */
-declare const version = "38.2.0-alpha.0";
+declare const version = "39.0.0";
 export default version;
 export declare const releaseDate: Date;
 declare global {

package/src/version.js

@@ -6,11 +6,11 @@
  * @module utils/version
  */
 /* globals window, global */
-import CKEditorError from './ckeditorerror.js';
-const version = '38.2.0-alpha.0';
+import CKEditorError from './ckeditorerror';
+const version = '39.0.0';
 export default version;
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-export const releaseDate = new Date(2023, 6, 17);
+export const releaseDate = new Date(2023, 7, 2);
 /* istanbul ignore next -- @preserve */
 const windowOrGlobal = typeof window === 'object' ? window : global;
 /* istanbul ignore next -- @preserve */
@@ -29,7 +29,7 @@ if (windowOrGlobal.CKEDITOR_VERSION) {
      *
      * ```ts
      * import ClassicEditor from '@ckeditor/ckeditor5-build-classic';
-     * import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight.js';
+     * import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight';
      * ```
      *
      * Then your project loads some CKEditor 5 packages twice. How does it happen?
@@ -59,11 +59,11 @@ if (windowOrGlobal.CKEDITOR_VERSION) {
      * The correct way to do so is to import an editor and plugins and run them together like this:
      *
      * ```ts
-     * import ClassicEditor from '@ckeditor/ckeditor5-editor-classic/src/classiceditor.js';
-     * import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials.js';
-     * import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph.js';
-     * import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold.js';
-     * import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic.js';
+     * import ClassicEditor from '@ckeditor/ckeditor5-editor-classic/src/classiceditor';
+     * import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials';
+     * import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph';
+     * import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold';
+     * import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic';
      *
      * ClassicEditor
      * 	.create( document.querySelector( '#editor' ), {
@@ -83,10 +83,10 @@ if (windowOrGlobal.CKEDITOR_VERSION) {
      *
      * ```ts
      * import ClassicEditor from '@ckeditor/ckeditor5-build-classic';
-     * import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials.js';
-     * import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph.js';
-     * import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold.js';
-     * import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic.js';
+     * import Essentials from '@ckeditor/ckeditor5-essentials/src/essentials';
+     * import Paragraph from '@ckeditor/ckeditor5-paragraph/src/paragraph';
+     * import Bold from '@ckeditor/ckeditor5-basic-styles/src/bold';
+     * import Italic from '@ckeditor/ckeditor5-basic-styles/src/italic';
      * ```
      *
      * This creates the same situation as in the previous section because you use a build together with source plugins.