@ckeditor/ckeditor5-utils 45.0.0 → 45.1.0-alpha.1

package/dist/index.js

@@ -959,9 +959,9 @@ diff.fastDiff = fastDiff;
     ];
 }
 
-const version = '45.0.0';
+const version = '45.1.0-alpha.1';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2025, 3, 7);
+const releaseDate = new Date(2025, 4, 8);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
 	 * This error is thrown when, due to a mistake in the way CKEditor 5 was installed,
@@ -1711,8 +1711,8 @@ function ObservableMixin(base) {
 				 * Cannot decorate an undefined method.
 				 *
 				 * @error observablemixin-cannot-decorate-undefined
-				 * @param {Object} object The object which method should be decorated.
-				 * @param {String} methodName Name of the method which does not exist.
+				 * @param {object} object The object which method should be decorated.
+				 * @param {string} methodName Name of the method which does not exist.
 				 */ throw new CKEditorError('observablemixin-cannot-decorate-undefined', this, {
                     object: this,
                     methodName
@@ -3895,6 +3895,24 @@ const rectProperties = [
     }
 }
 
+/**
+ * Returns the visual viewport offsets to adjust elements with `position: fixed` style.
+ */ function getVisualViewportOffset() {
+    const visualViewport = global.window.visualViewport;
+    if (!visualViewport || !(env.isiOS || env.isSafari)) {
+        return {
+            left: 0,
+            top: 0
+        };
+    }
+    const left = Math.max(Math.round(visualViewport.offsetLeft), 0);
+    const top = Math.max(Math.round(visualViewport.offsetTop), 0);
+    return {
+        left,
+        top
+    };
+}
+
 /**
  * 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
@@ -4323,7 +4341,7 @@ const keyCodeNames = /* #__PURE__ */ Object.fromEntries(/* #__PURE__ */ Object.e
 			 * Unknown key name. Only key names included in the {@link module:utils/keyboard#keyCodes} can be used.
 			 *
 			 * @error keyboard-unknown-key
-			 * @param {String} key
+			 * @param {string} key Ths specified key name.
 			 */ throw new CKEditorError('keyboard-unknown-key', null, {
                 key
             });
@@ -4517,7 +4535,9 @@ function splitKeystrokeText(keystroke) {
     'ku',
     'kur',
     'ug',
-    'uig' // Uighur, Uyghur
+    'uig',
+    'ur',
+    'urd' // Urdu
 ];
 /**
  * Helps determine whether a language text direction is LTR or RTL.
@@ -4817,7 +4837,7 @@ function getNumberOfLanguages(translations) {
 	 * @param options.contentLanguage The editor content language code in the
 	 * [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format. If not specified, the same as `options.language`.
 	 * See {@link #contentLanguage}.
-	 * @param translations Translations passed as a editor config parameter.
+	 * @param options.translations Translations passed as a editor config parameter.
 	 */ constructor({ uiLanguage = 'en', contentLanguage, translations } = {}){
         this.uiLanguage = uiLanguage;
         this.contentLanguage = contentLanguage || this.uiLanguage;
@@ -5940,11 +5960,12 @@ function isFocusedView(subTreeRoot, view) {
 /**
  * Tries calling the given callback until it sucessfully resolves.
  *
- * If the callback fails `maxRetries` times, the returned promise is rejected with the last error.
+ * If the callback fails `maxAttempts` 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 Configuration options.
+ * @param options.maxAttempts Maximum number of attempts.
  * @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.
  */ async function retry(callback, options = {}) {
@@ -5993,10 +6014,9 @@ function isFocusedView(subTreeRoot, view) {
  * spliceArray( [ 1, 2 ], [],       0 );	// [ 1, 2 ]
  * ```
  *
- * @param target Array to be spliced.
- * @param source Array of elements to be inserted to target.
- * @param start Index at which nodes should be inserted/removed.
- * @param count Number of items.
+ * @param targetArray Array to be spliced.
+ * @param insertArray Array of elements to be inserted to target.
+ * @param index Index at which nodes should be inserted.
  *
  * @returns New spliced array.
  */ function spliceArray(targetArray, insertArray, index) {
@@ -6241,5 +6261,5 @@ function buildEmojiRegexp() {
     return new RegExp(sequence, 'ug');
 }
 
-export { CKEditorError, Collection, Config, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, abortableDebounce, add, collectStylesheets, compareArrays, count, crc32, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, getAncestors, getBorderWidths, getCode, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, getRangeFromMouseEvent, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isViewWithFocusTracker, isVisible, keyCodes, logError, logWarning, mix, parseBase64EncodedObject, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, toArray, toMap, toUnit, uid, version, wait };
+export { CKEditorError, Collection, Config, DomEmitterMixin, ElementReplacer, EmitterMixin, EventInfo, FocusTracker, KeystrokeHandler, Locale, ObservableMixin, Rect, ResizeObserver, abortableDebounce, add, collectStylesheets, compareArrays, count, crc32, createElement, delay, diff, diffToChanges, env, exponentialDelay, fastDiff, findClosestScrollableAncestor, first, getAncestors, getBorderWidths, getCode, getDataFromElement, getEnvKeystrokeText, getLanguageDirection, getLocalizedArrowKeyCodeDirection, getOptimalPosition, getRangeFromMouseEvent, getVisualViewportOffset, global, indexOf, insertAt, insertToPriorityArray, isArrowKeyCode, isCombiningMark, isComment, isForwardArrowKeyCode, isHighSurrogateHalf, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isLowSurrogateHalf, isNode, isRange, isText, isValidAttributeName, isViewWithFocusTracker, isVisible, keyCodes, logError, logWarning, mix, parseBase64EncodedObject, parseKeystroke, priorities, releaseDate, remove, retry, scrollAncestorsToShowTarget, scrollViewportToShowTarget, setDataInElement, spliceArray, toArray, toMap, toUnit, uid, version, wait };
 //# sourceMappingURL=index.js.map