@ckeditor/ckeditor5-utils 40.1.0 → 40.2.0

package/CHANGELOG.md

@@ -5,7 +5,7 @@ All changes in the package are documented in the main repository. See: https://g
 
 Changes for the past releases are available below.
 
-## [19.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v18.0.0...v19.0.0) (2020-04-29)
+## [19.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v18.0.0...v19.0.0) (April 29, 2020)
 
 ### MINOR BREAKING CHANGES
 
@@ -35,12 +35,12 @@ Changes for the past releases are available below.
 * The `getPositionedAncestor()` helper should use `offsetParent` instead of `getComputedStyle()` for performance reasons. Closes [ckeditor/ckeditor5#6573](https://github.com/ckeditor/ckeditor5/issues/6573). ([7939756](https://github.com/ckeditor/ckeditor5-utils/commit/7939756))
 
 
-## [18.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v17.0.0...v18.0.0) (2020-03-19)
+## [18.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v17.0.0...v18.0.0) (March 19, 2020)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [17.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v16.0.0...v17.0.0) (2020-02-19)
+## [17.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v16.0.0...v17.0.0) (February 19, 2020)
 
 ### MINOR BREAKING CHANGES
 
@@ -57,14 +57,14 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The `uid()` helper should be a lot faster. Closes [ckeditor/ckeditor5#6188](https://github.com/ckeditor/ckeditor5/issues/6188). ([b57fc3f](https://github.com/ckeditor/ckeditor5-utils/commit/b57fc3f))
 
 
-## [16.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v15.0.0...v16.0.0) (2019-12-04)
+## [16.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v15.0.0...v16.0.0) (December 4, 2019)
 
 ### Bug fixes
 
 * Improved error rethrowing by replacing the error stack. Closes [ckeditor/ckeditor5#5595](https://github.com/ckeditor/ckeditor5/issues/5595). ([7685c0d](https://github.com/ckeditor/ckeditor5-utils/commit/7685c0d))
 
 
-## [15.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v14.0.0...v15.0.0) (2019-10-23)
+## [15.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v14.0.0...v15.0.0) (October 23, 2019)
 
 ### Features
 
@@ -83,7 +83,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Introduced the `CKEditorError.rethrowUnexpectedError()` helper. Added custom error handling for the `Emitter#fire()` function. Part of [ckeditor/ckeditor5#1304](https://github.com/ckeditor/ckeditor5/issues/1304). ([1d84705](https://github.com/ckeditor/ckeditor5-utils/commit/1d84705))
 
 
-## [14.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v13.0.1...v14.0.0) (2019-08-26)
+## [14.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v13.0.1...v14.0.0) (August 26, 2019)
 
 ### Features
 
@@ -102,12 +102,12 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Removed the CKEditor 5 logger utility.
 
 
-## [13.0.1](https://github.com/ckeditor/ckeditor5-utils/compare/v13.0.0...v13.0.1) (2019-07-10)
+## [13.0.1](https://github.com/ckeditor/ckeditor5-utils/compare/v13.0.0...v13.0.1) (July 10, 2019)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [13.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v12.1.1...v13.0.0) (2019-07-04)
+## [13.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v12.1.1...v13.0.0) (July 4, 2019)
 
 ### Features
 
@@ -122,12 +122,12 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The list of `CKEditorError()`'s parameters was changed – now it requires the message, context and then data. The `isCKEditorError()` method was renamed to `is()`.
 
 
-## [12.1.1](https://github.com/ckeditor/ckeditor5-utils/compare/v12.1.0...v12.1.1) (2019-06-05)
+## [12.1.1](https://github.com/ckeditor/ckeditor5-utils/compare/v12.1.0...v12.1.1) (June 6, 2019)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [12.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v12.0.0...v12.1.0) (2019-04-10)
+## [12.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v12.0.0...v12.1.0) (April 4, 2019)
 
 ### Features
 
@@ -135,7 +135,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Made `FocusTracker#focusedElement` observable to bring support for multi-root editors (see [ckeditor/ckeditor5#1599](https://github.com/ckeditor/ckeditor5/issues/1599)). ([952d440](https://github.com/ckeditor/ckeditor5-utils/commit/952d440))
 
 
-## [12.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v11.1.0...v12.0.0) (2019-02-28)
+## [12.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v11.1.0...v12.0.0) (February 28, 2019)
 
 ### Features
 
@@ -158,7 +158,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Upgraded minimal versions of Node to `8.0.0` and npm to `5.7.1`. See: [ckeditor/ckeditor5#1507](https://github.com/ckeditor/ckeditor5/issues/1507). ([612ea3c](https://github.com/ckeditor/ckeditor5-cloud-services/commit/612ea3c))
 
 
-## [11.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v11.0.0...v11.1.0) (2018-12-05)
+## [11.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v11.0.0...v11.1.0) (December 5, 2018)
 
 ### Features
 
@@ -169,7 +169,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Various fixes in the API docs. Thanks to [@denisname](https://github.com/denisname)!
 
 
-## [11.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.2.1...v11.0.0) (2018-10-08)
+## [11.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.2.1...v11.0.0) (October 8, 2018)
 
 ### Other changes
 
@@ -180,12 +180,12 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Removed the `lodash` library from this package (a modular `lodash` build has been kept under `src/lib/lodash/`). We now recommend using `lodash-es` directly.
 
 
-## [10.2.1](https://github.com/ckeditor/ckeditor5-utils/compare/v10.2.0...v10.2.1) (2018-07-18)
+## [10.2.1](https://github.com/ckeditor/ckeditor5-utils/compare/v10.2.0...v10.2.1) (July 18, 2018)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [10.2.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.1.0...v10.2.0) (2018-07-18)
+## [10.2.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.1.0...v10.2.0) (July 18, 2018)
 
 ### Features
 
@@ -197,7 +197,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The `isWindow()` helper should work in the Electron environment. Closes [ckeditor/ckeditor5#879](https://github.com/ckeditor/ckeditor5/issues/879). ([d561151](https://github.com/ckeditor/ckeditor5-utils/commit/d561151))
 
 
-## [10.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.0.0...v10.1.0) (2018-06-21)
+## [10.1.0](https://github.com/ckeditor/ckeditor5-utils/compare/v10.0.0...v10.1.0) (June 21, 2018)
 
 ### Features
 
@@ -209,7 +209,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Error should not be thrown when scrolling the viewport from within an iframe in a different domain. Closes [ckeditor/ckeditor5#930](https://github.com/ckeditor/ckeditor5/issues/930). ([ad4656e](https://github.com/ckeditor/ckeditor5-utils/commit/ad4656e))
 
 
-## [10.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.4...v10.0.0) (2018-04-25)
+## [10.0.0](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.4...v10.0.0) (April 25, 2018)
 
 ### Other changes
 
@@ -220,17 +220,17 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The license under which CKEditor 5 is released has been changed from a triple GPL, LGPL and MPL license to a GPL2+ only. See [ckeditor/ckeditor5#991](https://github.com/ckeditor/ckeditor5/issues/991) for more information.
 
 
-## [1.0.0-beta.4](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.2...v1.0.0-beta.4) (2018-04-19)
+## [1.0.0-beta.4](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.2...v1.0.0-beta.4) (April 19, 2018)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [1.0.0-beta.2](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.1...v1.0.0-beta.2) (2018-04-10)
+## [1.0.0-beta.2](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-beta.1...v1.0.0-beta.2) (April 10, 2018)
 
 Internal changes only (updated dependencies, documentation, etc.).
 
 
-## [1.0.0-beta.1](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-alpha.2...v1.0.0-beta.1) (2018-03-15)
+## [1.0.0-beta.1](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-alpha.2...v1.0.0-beta.1) (March 15, 2018)
 
 ### Features
 
@@ -260,14 +260,14 @@ Internal changes only (updated dependencies, documentation, etc.).
 * `isDomNode()` was renamed to `isNode()`.
 
 
-## [1.0.0-alpha.2](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2017-11-14)
+## [1.0.0-alpha.2](https://github.com/ckeditor/ckeditor5-utils/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (November 14, 2017)
 
 ### Bug fixes
 
 * Removed a period at the end of an error message because some browsers included the period in links to errors. Closes [#193](https://github.com/ckeditor/ckeditor5-utils/issues/193). ([fdebc2f](https://github.com/ckeditor/ckeditor5-utils/commit/fdebc2f))
 
 
-## [1.0.0-alpha.1](https://github.com/ckeditor/ckeditor5-utils/compare/v0.10.0...v1.0.0-alpha.1) (2017-10-03)
+## [1.0.0-alpha.1](https://github.com/ckeditor/ckeditor5-utils/compare/v0.10.0...v1.0.0-alpha.1) (October 3, 2017)
 
 ### Features
 
@@ -278,7 +278,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * `CKEditorError#message`, `log.error()` and `log.warn()` will contain a link to the error documentation. Closes [#185](https://github.com/ckeditor/ckeditor5-utils/issues/185). ([b7a00c9](https://github.com/ckeditor/ckeditor5-utils/commit/b7a00c9))
 
 
-## [0.10.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.9.1...v0.10.0) (2017-09-03)
+## [0.10.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.9.1...v0.10.0) (September 3, 2017)
 
 ### Bug fixes
 
@@ -296,7 +296,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The `getOptimalPosition()` utility should accept the target option defined as a function. Closes [#157](https://github.com/ckeditor/ckeditor5-utils/issues/157). ([d63abae](https://github.com/ckeditor/ckeditor5-utils/commit/d63abae))
 
 
-## [0.9.1](https://github.com/ckeditor/ckeditor5-utils/compare/v0.9.0...v0.9.1) (2017-05-07)
+## [0.9.1](https://github.com/ckeditor/ckeditor5-utils/compare/v0.9.0...v0.9.1) (May 7, 2017)
 
 ### Bug fixes
 
@@ -304,7 +304,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * The `getOptimalPosition()` utility should consider limiter ancestors with CSS overflow. Closes [#148](https://github.com/ckeditor/ckeditor5-utils/issues/148). ([6bf1741](https://github.com/ckeditor/ckeditor5-utils/commit/6bf1741))
 
 
-## [0.9.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.8.0...v0.9.0) (2017-04-05)
+## [0.9.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.8.0...v0.9.0) (April 5, 2017)
 
 ### Bug fixes
 
@@ -317,7 +317,7 @@ Internal changes only (updated dependencies, documentation, etc.).
 * Two–way data binding between `Collection` instances. Closes [#132](https://github.com/ckeditor/ckeditor5-utils/issues/132). ([6b79624](https://github.com/ckeditor/ckeditor5-utils/commit/6b79624))
 
 
-## [0.8.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.7.0...v0.8.0) (2017-03-06)
+## [0.8.0](https://github.com/ckeditor/ckeditor5-utils/compare/v0.7.0...v0.8.0) (March 6, 2017)
 
 ### Features
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-utils",
-  "version": "40.1.0",
+  "version": "40.2.0",
   "description": "Miscellaneous utilities used by CKEditor 5.",
   "keywords": [
     "ckeditor",

package/src/abortabledebounce.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/abortabledebounce
+ */
+/**
+ * Returns a function wrapper that will execute the provided function and abort any previous call that is still in progress.
+ *
+ * @param func The function to be called. It will be provided with `AbortSignal` as the first parameter.
+ */
+export default function abortableDebounce<Args extends Array<any>, Ret>(func: (signal: AbortSignal, ...args: Args) => Ret): AbortableFunc<Args, Ret>;
+export interface AbortableFunc<Args extends Array<any>, Ret> {
+    (...args: Args): Ret;
+    abort(): void;
+}

package/src/abortabledebounce.js

@@ -0,0 +1,22 @@
+/**
+ * @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/abortabledebounce
+ */
+/**
+ * Returns a function wrapper that will execute the provided function and abort any previous call that is still in progress.
+ *
+ * @param func The function to be called. It will be provided with `AbortSignal` as the first parameter.
+ */
+export default function abortableDebounce(func) {
+    let controller = new AbortController();
+    function abortable(...args) {
+        controller.abort();
+        controller = new AbortController();
+        return func(controller.signal, ...args);
+    }
+    abortable.abort = () => controller.abort();
+    return abortable;
+}

package/src/index.d.ts

@@ -16,6 +16,7 @@ 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 abortableDebounce, type AbortableFunc } from './abortabledebounce';
 export { default as count } from './count';
 export { default as compareArrays } from './comparearrays';
 export { default as createElement } from './dom/createelement';
@@ -52,10 +53,12 @@ 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 retry, exponentialDelay } from './retry';
 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 { default as wait } from './wait';
 export * from './unicode';
 export { default as version, releaseDate } from './version';

package/src/index.js

@@ -15,6 +15,7 @@ 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 abortableDebounce } from './abortabledebounce';
 export { default as count } from './count';
 export { default as compareArrays } from './comparearrays';
 export { default as createElement } from './dom/createelement';
@@ -51,10 +52,12 @@ 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 retry, exponentialDelay } from './retry';
 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 { default as wait } from './wait';
 export * from './unicode';
 export { default as version, releaseDate } from './version';

package/src/retry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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
+ */
+/**
+ * Tries calling the given callback until it sucessfully resolves.
+ *
+ * If the callback fails `maxRetries` times, the returned promise is rejected with the last error.
+ *
+ * @typeParam TResult The result of a successful callback invocation.
+ * @param callback The function to call until it succeeds.
+ * @param options.maxRetries Maximum number of retries.
+ * @param options.retryDelay The time in milliseconds between attempts. By default it implements exponential back-off policy.
+ * @param options.signal The signal to abort further retries. The callback itself is not aborted automatically.
+ */
+export default function retry<TResult>(callback: () => Promise<TResult>, options?: {
+    maxAttempts?: number;
+    retryDelay?: (attempt: number) => number;
+    signal?: AbortSignal;
+}): Promise<TResult>;
+/**
+ * Creates a function that calculates exponential back-off delay. Pass it as `options.retryDelay` to {@link ~retry}.
+ *
+ * @param options.delay Base delay between invocations. Defaults to 1s.
+ * @param options.factor How much to increase the delay. Defaults to 2x.
+ * @param options.maxDelay Maximum timeout. Even if higher timeout is calculated, it cannot get higher than this value. Default to 10s.
+ * @returns The function calculating the delay.
+ */
+export declare function exponentialDelay(options?: {
+    delay?: number;
+    factor?: number;
+    maxDelay?: number;
+}): (attempt: number) => number;

package/src/retry.js

@@ -0,0 +1,47 @@
+/**
+ * @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/retry
+ */
+import wait from './wait';
+/**
+ * Tries calling the given callback until it sucessfully resolves.
+ *
+ * If the callback fails `maxRetries` times, the returned promise is rejected with the last error.
+ *
+ * @typeParam TResult The result of a successful callback invocation.
+ * @param callback The function to call until it succeeds.
+ * @param options.maxRetries Maximum number of retries.
+ * @param options.retryDelay The time in milliseconds between attempts. By default it implements exponential back-off policy.
+ * @param options.signal The signal to abort further retries. The callback itself is not aborted automatically.
+ */
+export default async function retry(callback, options = {}) {
+    const { maxAttempts = 4, retryDelay = exponentialDelay(), signal = (new AbortController()).signal } = options;
+    signal.throwIfAborted();
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await callback();
+        }
+        catch (err) {
+            const isLast = attempt + 1 >= maxAttempts;
+            if (isLast) {
+                throw err;
+            }
+        }
+        await wait(retryDelay(attempt), { signal });
+    }
+}
+/**
+ * Creates a function that calculates exponential back-off delay. Pass it as `options.retryDelay` to {@link ~retry}.
+ *
+ * @param options.delay Base delay between invocations. Defaults to 1s.
+ * @param options.factor How much to increase the delay. Defaults to 2x.
+ * @param options.maxDelay Maximum timeout. Even if higher timeout is calculated, it cannot get higher than this value. Default to 10s.
+ * @returns The function calculating the delay.
+ */
+export function exponentialDelay(options = {}) {
+    const { delay = 1000, factor = 2, maxDelay = 10000 } = options;
+    return attempt => Math.min(factor ** attempt * delay, maxDelay);
+}

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 = "40.1.0";
+declare const version = "40.2.0";
 export default version;
 export declare const releaseDate: Date;
 declare global {

package/src/version.js

@@ -6,10 +6,10 @@
  * @module utils/version
  */
 import CKEditorError from './ckeditorerror';
-const version = '40.1.0';
+const version = '40.2.0';
 export default version;
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-export const releaseDate = new Date(2023, 10, 15);
+export const releaseDate = new Date(2023, 11, 12);
 /* istanbul ignore next -- @preserve */
 if (globalThis.CKEDITOR_VERSION) {
     /**
@@ -35,7 +35,7 @@ if (globalThis.CKEDITOR_VERSION) {
      * that it contains all the necessary code from e.g. `@ckeditor/ckeditor5-engine` and `@ckeditor/ckeditor5-utils`.
      *
      * However, the `Highlight` plugin imports some of the modules from these packages, too. If you ask webpack to
-     * build such a project, you will end up with the modules being included (and run) twice — first, because they are
+     * build such a project, you will end up with the modules being included (and run) twice – first, because they are
      * included inside the build package, and second, because they are required by the `Highlight` plugin.
      *
      * Therefore, **you must never add plugins to an existing build** unless your plugin has no dependencies.
@@ -120,7 +120,7 @@ if (globalThis.CKEDITOR_VERSION) {
      * asking the author of the third-party package to upgrade its depdendencies (or forking their project and doing this yourself).
      *
      * **Note:** All official CKEditor 5 packages (excluding integrations and `ckeditor5-dev-*` packages) are released in the
-     * same major version. This is — in the `x.y.z`, the `x` is the same for all packages. This is the simplest way to check
+     * same major version. This means that in the `x.y.z` version, the `x` is the same for all packages. This is the simplest way to check
      * whether you use packages coming from the same CKEditor 5 version. You can read more about versioning in the
      * {@glink updating/versioning-policy Versioning policy} guide.
      *

package/src/wait.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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/wait
+ */
+/**
+ * Returns a promise that is resolved after the specified time.
+ *
+ * @param timeout The time in milliseconds to wait.
+ * @param options.signal A signal to abort the waiting.
+ */
+export default function wait(timeout: number, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;

package/src/wait.js

@@ -0,0 +1,29 @@
+/**
+ * @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/wait
+ */
+/**
+ * Returns a promise that is resolved after the specified time.
+ *
+ * @param timeout The time in milliseconds to wait.
+ * @param options.signal A signal to abort the waiting.
+ */
+export default function wait(timeout, options = {}) {
+    return new Promise((resolve, reject) => {
+        const signal = options.signal || (new AbortController()).signal;
+        signal.throwIfAborted();
+        const timer = setTimeout(timeoutHandler, timeout);
+        signal.addEventListener('abort', abortHandler, { once: true });
+        function timeoutHandler() {
+            signal.removeEventListener('abort', abortHandler);
+            resolve();
+        }
+        function abortHandler() {
+            clearTimeout(timer);
+            reject(signal.reason);
+        }
+    });
+}