@ckeditor/ckeditor5-utils 41.4.0 → 41.4.2

package/dist/types/env.d.ts

@@ -6,9 +6,6 @@
  * @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/env
- */
 /**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
@@ -35,7 +32,7 @@ export interface EnvType {
      */
     readonly isSafari: boolean;
     /**
-     * Indicates the the application is running in iOS.
+     * Indicates that the application is running in iOS.
      */
     readonly isiOS: boolean;
     /**
@@ -47,11 +44,17 @@ export interface EnvType {
      */
     readonly isBlink: boolean;
     /**
-     * Indicates that the the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
+     * Indicates that the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
+     *
+     * Note that the value of this property is evaluated each time it is accessed, and it may change over time, if the environment
+     * settings have changed.
      */
     readonly isMediaForcedColors: boolean;
     /**
      * Indicates that "prefer reduced motion" browser setting is active.
+     *
+     * Note that the value of this property is evaluated each time it is accessed, and it may change over time, if the environment
+     * settings have changed.
      */
     readonly isMotionReduced: boolean;
     /**
@@ -129,9 +132,13 @@ export declare function isBlink(userAgent: string): boolean;
 export declare function isRegExpUnicodePropertySupported(): boolean;
 /**
  * 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.
  */
 export declare function isMediaForcedColors(): boolean;
 /**
- * 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.
  */
 export declare function isMotionReduced(): boolean;

package/dist/types/version.d.ts

@@ -6,7 +6,7 @@
  * @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
  */
-declare const version = "41.4.0";
+declare const version = "41.4.2";
 export default version;
 export declare const releaseDate: Date;
 declare global {

package/package.json

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

package/src/env.d.ts

@@ -2,9 +2,6 @@
  * @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/env
- */
 /**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
@@ -31,7 +28,7 @@ export interface EnvType {
      */
     readonly isSafari: boolean;
     /**
-     * Indicates the the application is running in iOS.
+     * Indicates that the application is running in iOS.
      */
     readonly isiOS: boolean;
     /**
@@ -43,11 +40,17 @@ export interface EnvType {
      */
     readonly isBlink: boolean;
     /**
-     * Indicates that the the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
+     * Indicates that the user agent has enabled a forced colors mode (e.g. Windows High Contrast mode).
+     *
+     * Note that the value of this property is evaluated each time it is accessed, and it may change over time, if the environment
+     * settings have changed.
      */
     readonly isMediaForcedColors: boolean;
     /**
      * Indicates that "prefer reduced motion" browser setting is active.
+     *
+     * Note that the value of this property is evaluated each time it is accessed, and it may change over time, if the environment
+     * settings have changed.
      */
     readonly isMotionReduced: boolean;
     /**
@@ -125,9 +128,13 @@ export declare function isBlink(userAgent: string): boolean;
 export declare function isRegExpUnicodePropertySupported(): boolean;
 /**
  * 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.
  */
 export declare function isMediaForcedColors(): boolean;
 /**
- * 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.
  */
 export declare function isMotionReduced(): boolean;

package/src/env.js

@@ -6,6 +6,7 @@
 /**
  * @module utils/env
  */
+import global from './dom/global.js';
 /**
  * Safely returns `userAgent` from browser's navigator API in a lower case.
  * If navigator API is not available it will return an empty string.
@@ -31,7 +32,9 @@ const env = {
     isiOS: isiOS(userAgent),
     isAndroid: isAndroid(userAgent),
     isBlink: isBlink(userAgent),
-    isMediaForcedColors: isMediaForcedColors(),
+    get isMediaForcedColors() {
+        return isMediaForcedColors();
+    },
     get isMotionReduced() {
         return isMotionReduced();
     },
@@ -126,13 +129,17 @@ export function isRegExpUnicodePropertySupported() {
 }
 /**
  * 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.
  */
 export 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.
  */
 export function isMotionReduced() {
-    return window.matchMedia('(prefers-reduced-motion)').matches;
+    return global.window.matchMedia ? global.window.matchMedia('(prefers-reduced-motion)').matches : false;
 }

package/src/version.d.ts

@@ -2,7 +2,7 @@
  * @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
  */
-declare const version = "41.4.0";
+declare const version = "41.4.2";
 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.js';
-const version = '41.4.0';
+const version = '41.4.2';
 export default version;
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-export const releaseDate = new Date(2024, 4, 15);
+export const releaseDate = new Date(2024, 4, 17);
 /* istanbul ignore next -- @preserve */
 if (globalThis.CKEDITOR_VERSION) {
     /**