@ckeditor/ckeditor5-utils 40.1.0 → 41.0.0

package/src/index.d.ts

@@ -1,61 +1,64 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-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 getDataFromElement } from './dom/getdatafromelement';
-export { default as getBorderWidths } from './dom/getborderwidths';
-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';
+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 abortableDebounce, type AbortableFunc } from './abortabledebounce.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 getBorderWidths } from './dom/getborderwidths.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, type DomPoint } 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 retry, exponentialDelay } from './retry.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 { default as wait } from './wait.js';
+export * from './unicode.js';
+export { default as version, releaseDate } from './version.js';

package/src/index.js

@@ -1,60 +1,63 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-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 getDataFromElement } from './dom/getdatafromelement';
-export { default as getBorderWidths } from './dom/getborderwidths';
-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';
+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 abortableDebounce } from './abortabledebounce.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 getBorderWidths } from './dom/getborderwidths.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 retry, exponentialDelay } from './retry.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 { default as wait } from './wait.js';
+export * from './unicode.js';
+export { default as version, releaseDate } from './version.js';

package/src/inserttopriorityarray.d.ts

@@ -1,8 +1,8 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import { type PriorityString } from './priorities';
+import { type PriorityString } from './priorities.js';
 /**
  * @module utils/inserttopriorityarray
  */

package/src/inserttopriorityarray.js

@@ -1,8 +1,8 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import priorities from './priorities';
+import priorities from './priorities.js';
 /**
  * Inserts any object with priority at correct index by priority so registered objects are always sorted from highest to lowest priority.
  *

package/src/isiterable.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/isiterable.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/keyboard.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**
@@ -7,7 +7,7 @@
  *
  * @module utils/keyboard
  */
-import type { LanguageDirection } from './language';
+import type { LanguageDirection } from './language.js';
 /**
  * An object with `keyName => keyCode` pairs for a set of known keys.
  *

package/src/keyboard.js

@@ -1,9 +1,9 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import CKEditorError from './ckeditorerror';
-import env from './env';
+import CKEditorError from './ckeditorerror.js';
+import env from './env.js';
 const modifiersToGlyphsMac = {
     ctrl: '⌃',
     cmd: '⌘',

package/src/keystrokehandler.d.ts

@@ -1,10 +1,10 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import type { Emitter } from './emittermixin';
-import { type KeystrokeInfo } from './keyboard';
-import type { PriorityString } from './priorities';
+import type { Emitter } from './emittermixin.js';
+import { type KeystrokeInfo } from './keyboard.js';
+import type { PriorityString } from './priorities.js';
 /**
  * Keystroke handler allows registering callbacks for given keystrokes.
  *

package/src/keystrokehandler.js

@@ -1,12 +1,12 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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/keystrokehandler
  */
-import DomEmitterMixin from './dom/emittermixin';
-import { getCode, parseKeystroke } from './keyboard';
+import DomEmitterMixin from './dom/emittermixin.js';
+import { getCode, parseKeystroke } from './keyboard.js';
 /**
  * Keystroke handler allows registering callbacks for given keystrokes.
  *

package/src/language.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/language.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 const RTL_LANGUAGE_CODES = [

package/src/locale.d.ts

@@ -1,9 +1,9 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
-import { type Message } from './translation-service';
-import { type LanguageDirection } from './language';
+import { type Message } from './translation-service.js';
+import { type LanguageDirection } from './language.js';
 /**
  * Represents the localization services.
  */

package/src/locale.js

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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/locale
  */
 /* globals console */
-import toArray from './toarray';
-import { _translate } from './translation-service';
-import { getLanguageDirection } from './language';
+import toArray from './toarray.js';
+import { _translate } from './translation-service.js';
+import { getLanguageDirection } from './language.js';
 /**
  * Represents the localization services.
  */

package/src/mapsequal.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/mapsequal.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/mix.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/mix.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/nth.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/nth.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/objecttomap.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/objecttomap.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/observablemixin.d.ts

@@ -1,12 +1,12 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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/observablemixin
  */
-import { type Emitter } from './emittermixin';
-import type { Constructor, Mixed } from './mix';
+import { type Emitter } from './emittermixin.js';
+import type { Constructor, Mixed } from './mix.js';
 /**
  * A mixin that injects the "observable properties" and data binding functionality described in the
  * {@link ~Observable} interface.

package/src/observablemixin.js

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /**
  * @module utils/observablemixin
  */
-import EmitterMixin from './emittermixin';
-import CKEditorError from './ckeditorerror';
+import EmitterMixin from './emittermixin.js';
+import CKEditorError from './ckeditorerror.js';
 import { isObject } from 'lodash-es';
 const observablePropertiesSymbol = Symbol('observableProperties');
 const boundObservablesSymbol = Symbol('boundObservables');

package/src/priorities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/priorities.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/retry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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
+ */
+/**
+ * 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-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/retry
+ */
+import wait from './wait.js';
+/**
+ * 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/splicearray.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**

package/src/splicearray.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @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
  */
 /**