@ckeditor/ckeditor5-utils 41.4.0 → 41.4.2

package/dist/index.js

@@ -7,9 +7,42 @@ import { isObject, isString, isPlainObject, cloneDeepWith, isElement, isFunction
 /**
  * @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
- */ /* globals navigator:false */ /**
- * @module utils/env
  */ /**
+ * A helper (module) giving an access to the global DOM objects such as `window` and
+ * `document`. Accessing these objects using this helper allows easy and bulletproof
+ * testing, i.e. stubbing native properties:
+ *
+ * ```ts
+ * import { global } from 'ckeditor5/utils';
+ *
+ * // This stub will work for any code using global module.
+ * testUtils.sinon.stub( global, 'window', {
+ * 	innerWidth: 10000
+ * } );
+ *
+ * console.log( global.window.innerWidth );
+ * ```
+ */ let globalVar; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
+// In some environments window and document API might not be available.
+try {
+    globalVar = {
+        window,
+        document
+    };
+} catch (e) {
+    // It's not possible to mock a window object to simulate lack of a window object without writing extremely convoluted code.
+    /* istanbul ignore next -- @preserve */ // Let's cast it to not change module's API.
+    // We only handle this so loading editor in environments without window and document doesn't fail.
+    // For better DX we shouldn't introduce mixed types and require developers to check the type manually.
+    // This module should not be used on purpose in any environment outside browser.
+    globalVar = {
+        window: {},
+        document: {}
+    };
+}
+var global = globalVar;
+
+/**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
  */ function getUserAgent() {
@@ -31,7 +64,9 @@ const userAgent = getUserAgent();
     isiOS: isiOS(userAgent),
     isAndroid: isAndroid(userAgent),
     isBlink: isBlink(userAgent),
-    isMediaForcedColors: isMediaForcedColors(),
+    get isMediaForcedColors () {
+        return isMediaForcedColors();
+    },
     get isMotionReduced () {
         return isMotionReduced();
     },
@@ -116,13 +151,17 @@ const userAgent = getUserAgent();
 }
 /**
  * Checks if the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
+ *
+ * Returns `false` in environments where `window` global object is not available.
  */ function isMediaForcedColors() {
-    return window.matchMedia('(forced-colors: active)').matches;
+    return global.window.matchMedia ? global.window.matchMedia('(forced-colors: active)').matches : false;
 }
 /**
- * Checks if user enabled "prefers reduced motion" setting in browser.
+ * Checks if the user enabled "prefers reduced motion" setting in browser.
+ *
+ * Returns `false` in environments where `window` global object is not available.
  */ function isMotionReduced() {
-    return window.matchMedia('(prefers-reduced-motion)').matches;
+    return global.window.matchMedia ? global.window.matchMedia('(prefers-reduced-motion)').matches : false;
 }
 
 /**
@@ -850,9 +889,9 @@ class CKEditorError extends Error {
     ];
 }
 
-const version = '41.4.0';
+const version = '41.4.2';
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-const releaseDate = new Date(2024, 4, 15);
+const releaseDate = new Date(2024, 4, 17);
 /* istanbul ignore next -- @preserve */ if (globalThis.CKEDITOR_VERSION) {
     /**
      * This error is thrown when due to a mistake in how CKEditor 5 was installed or initialized, some
@@ -2582,44 +2621,6 @@ function DomEmitterMixin(base) {
     return id;
 }
 
-/**
- * @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
- */ /**
- * A helper (module) giving an access to the global DOM objects such as `window` and
- * `document`. Accessing these objects using this helper allows easy and bulletproof
- * testing, i.e. stubbing native properties:
- *
- * ```ts
- * import { global } from 'ckeditor5/utils';
- *
- * // This stub will work for any code using global module.
- * testUtils.sinon.stub( global, 'window', {
- * 	innerWidth: 10000
- * } );
- *
- * console.log( global.window.innerWidth );
- * ```
- */ let globalVar; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
-// In some environments window and document API might not be available.
-try {
-    globalVar = {
-        window,
-        document
-    };
-} catch (e) {
-    // It's not possible to mock a window object to simulate lack of a window object without writing extremely convoluted code.
-    /* istanbul ignore next -- @preserve */ // Let's cast it to not change module's API.
-    // We only handle this so loading editor in environments without window and document doesn't fail.
-    // For better DX we shouldn't introduce mixed types and require developers to check the type manually.
-    // This module should not be used on purpose in any environment outside browser.
-    globalVar = {
-        window: {},
-        document: {}
-    };
-}
-var global = globalVar;
-
 /**
  * Returns the closest scrollable ancestor of a DOM element.
  *