@vpmedia/simplify 1.63.0 → 1.65.0

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+## [1.65.0] - 2026-01-30
+
+### 💼 Other
+
+- *(deps)* Bump dependency versions
+
+### 🚜 Refactor
+
+- Relax fixFloatPrecision error handling
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.65.0
+## [1.64.0] - 2026-01-30
+
+### 💼 Other
+
+- *(deps)* Bump dependency versions
+- *(deps)* Bump dependency versions
+
+### 🚜 Refactor
+
+- Improve error handling
+- Improve type guards and performance optimizations
+
+### 🧪 Testing
+
+- Improve test coverage
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.64.0
 ## [1.63.0] - 2026-01-28
 
 ### 💼 Other

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.63.0",
+  "version": "1.65.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -22,23 +22,23 @@
     "eventemitter3": "^5.0.4"
   },
   "optionalDependencies": {
-    "@sentry/browser": "^10.37.0"
+    "@sentry/browser": "^10.38.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",
     "@commitlint/config-conventional": "^20.3.1",
     "@eslint/js": "^9.39.2",
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.1.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
-    "eslint-plugin-jsdoc": "^62.4.1",
+    "eslint-plugin-jsdoc": "^62.5.0",
     "eslint-plugin-oxlint": "^1.42.0",
     "eslint-plugin-unicorn": "^62.0.0",
     "globals": "^17.2.0",
     "jsdom": "^27.4.0",
     "msw": "^2.12.7",
     "oxlint": "^1.42.0",
-    "oxlint-tsgolint": "^0.11.2",
+    "oxlint-tsgolint": "^0.11.3",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.54.0",

package/src/index.js

@@ -23,9 +23,7 @@ export { delayPromise, loadJSON } from './util/async.js';
 export { getErrorDetails, getTypedError } from './util/error.js';
 export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetch.js';
 export {
-  addFloat,
   deg2rad,
-  fixFloat,
   fixFloatPrecision,
   getRandomInt,
   isEqual,
@@ -34,9 +32,9 @@ export {
   isInRange,
   isLess,
   isLessOrEqual,
-  subFloat,
+  rad2deg,
 } from './util/number.js';
-export { purgeObject, deepMerge, getObjArrayPropSum, getObjValueByPath, setObjValueByPath } from './util/object.js';
+export { deepMerge, getObjArrayPropSum, getObjValueByPath, purgeObject, setObjValueByPath } from './util/object.js';
 export { getURLParam, sanitizeURLParam } from './util/query.js';
 export { serverDataToState } from './util/state.js';
 export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from './util/string.js';

package/src/logging/Logger.test.js

@@ -52,10 +52,13 @@ test('Tests Logger custom handler', () => {
   logger.info('info');
   expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_INFO);
   expect(testLogHandler.emitLogMessage).toBe('info');
-  // info
+  // warning
   logger.warn('warning');
   expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_WARNING);
   expect(testLogHandler.emitLogMessage).toBe('warning');
+  logger.warning('warning');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_WARNING);
+  expect(testLogHandler.emitLogMessage).toBe('warning');
   // error
   logger.error('error');
   expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_ERROR);

package/src/pagelifecycle/const.js

@@ -4,11 +4,27 @@ export const PAGE_LIFECYCLE_STATE_PASSIVE = 'passive';
 export const PAGE_LIFECYCLE_STATE_FROZEN = 'frozen';
 export const PAGE_LIFECYCLE_STATE_TERMINATED = 'terminated';
 
+export const PAGE_LIFECYCLE_STATES = new Set([
+  PAGE_LIFECYCLE_STATE_ACTIVE,
+  PAGE_LIFECYCLE_STATE_FROZEN,
+  PAGE_LIFECYCLE_STATE_HIDDEN,
+  PAGE_LIFECYCLE_STATE_PASSIVE,
+  PAGE_LIFECYCLE_STATE_TERMINATED,
+]);
+
 export const DOCUMENT_STATE_DOM_LOADED = 'domLoaded';
 export const DOCUMENT_STATE_FULLY_LOADED = 'fullyLoaded';
 export const DOCUMENT_STATE_COMPLETE = 'complete';
 export const DOCUMENT_STATE_INTERACTIVE = 'interactive';
 export const DOCUMENT_STATE_LOADING = 'loading';
 
+export const DOCUMENT_STATES = new Set([
+  DOCUMENT_STATE_COMPLETE,
+  DOCUMENT_STATE_DOM_LOADED,
+  DOCUMENT_STATE_FULLY_LOADED,
+  DOCUMENT_STATE_INTERACTIVE,
+  DOCUMENT_STATE_LOADING,
+]);
+
 export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT = 'pageLifecycleStateChange';
 export const DOCUMENT_STATE_CHANGE_EVENT = 'documentStateChange';

package/src/pagelifecycle/util.test.js

@@ -0,0 +1,102 @@
+import { beforeAll, describe, expect, it } from 'vitest';
+import {
+  DOCUMENT_STATE_CHANGE_EVENT,
+  DOCUMENT_STATES,
+  PAGE_LIFECYCLE_STATE_CHANGE_EVENT,
+  PAGE_LIFECYCLE_STATE_HIDDEN,
+  PAGE_LIFECYCLE_STATES,
+} from './const.js';
+import {
+  addPageLifecycleCallback,
+  getDocumentState,
+  getPageLifecycleEventEmitter,
+  getPageLifecycleState,
+  initPageLifecycle,
+  isPageLifecycleInitialized,
+} from './util.js';
+import { delayPromise } from '../util/async.js';
+
+describe('Page Lifecycle', () => {
+  beforeAll(() => {
+    initPageLifecycle();
+  });
+
+  it('should initialize page lifecycle', () => {
+    expect(isPageLifecycleInitialized()).toBe(true);
+  });
+
+  it('should return current page lifecycle state', () => {
+    const state = getPageLifecycleState();
+    expect(state).toBeOneOf(PAGE_LIFECYCLE_STATES);
+  });
+
+  it('should return current document state', () => {
+    const state = getDocumentState();
+    expect(state).toBeOneOf(DOCUMENT_STATES);
+  });
+
+  it('should return event emitter instance', () => {
+    const emitter = getPageLifecycleEventEmitter();
+    expect(emitter).toBeDefined();
+  });
+
+  it('should handle page lifecycle state changes', () => {
+    const emitter = getPageLifecycleEventEmitter();
+    let stateChanged = false;
+
+    emitter.on(PAGE_LIFECYCLE_STATE_CHANGE_EVENT, (data) => {
+      stateChanged = true;
+      expect(data).toHaveProperty('previousState');
+      expect(data).toHaveProperty('nextState');
+    });
+
+    // Trigger visibility change
+    const originalVisibilityState = document.visibilityState;
+    Object.defineProperty(document, 'visibilityState', {
+      value: originalVisibilityState === 'visible' ? 'hidden' : 'visible',
+      writable: true,
+      configurable: true,
+    });
+
+    document.dispatchEvent(new Event('visibilitychange'));
+
+    // Restore original state
+    Object.defineProperty(document, 'visibilityState', {
+      value: originalVisibilityState,
+      writable: true,
+      configurable: true,
+    });
+
+    expect(stateChanged).toBe(true);
+  });
+
+  it('should handle document state changes', () => {
+    const emitter = getPageLifecycleEventEmitter();
+    let stateChanged = false;
+
+    emitter.on(DOCUMENT_STATE_CHANGE_EVENT, (data) => {
+      stateChanged = true;
+      expect(data).toHaveProperty('previousState');
+      expect(data).toHaveProperty('nextState');
+    });
+
+    // Trigger ready state change
+    const originalReadyState = document.readyState;
+    Object.defineProperty(document, 'readyState', {
+      value: originalReadyState === 'complete' ? 'interactive' : 'complete',
+      writable: true,
+      configurable: true,
+    });
+
+    document.dispatchEvent(new Event('readystatechange'));
+
+    // Restore original state
+    Object.defineProperty(document, 'readyState', {
+      value: originalReadyState,
+      writable: true,
+      configurable: true,
+    });
+
+    expect(stateChanged).toBe(true);
+  });
+});

package/src/typecheck/TypeCheckError.js

@@ -2,9 +2,11 @@ export class TypeCheckError extends TypeError {
   /**
    * Creates a new `TypeCheckError` instance.
    * @param {string} message - Error message.
+   * @param {{ cause?: unknown, value?: unknown }} [options] - Error options.
    */
-  constructor(message) {
-    super(message);
+  constructor(message, options) {
+    super(message, options);
     this.name = 'TypeCheckError';
+    this.value = options?.value;
   }
 }

package/src/typecheck/TypeChecker.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest';
+import { typeChecker } from './TypeChecker.js';
+import { TypeCheckError } from './TypeCheckError.js';
+
+const stringValidator = (value) => typeof value === 'string';
+
+describe('TypeChecker', () => {
+  it('should check value type correctly', () => {
+    const result = typeChecker.check('test', stringValidator);
+    expect(result).toBe('test');
+  });
+
+  it('should throw TypeCheckError for invalid type', () => {
+    expect(() => typeChecker.check(123, stringValidator)).toThrow(TypeCheckError);
+  });
+
+  it('should swallow errors when enabled', () => {
+    typeChecker.setSwallowErrors(true);
+    const result = typeChecker.check(123, stringValidator);
+    expect(result).toBe(123);
+    typeChecker.setSwallowErrors(false);
+  });
+
+  it('should check array type correctly', () => {
+    const result = typeChecker.checkArray(['a', 'b', 'c'], stringValidator);
+    expect(result).toEqual(['a', 'b', 'c']);
+  });
+
+  it('should throw TypeCheckError for invalid array type', () => {
+    expect(() => typeChecker.checkArray([1, 2, 3], stringValidator)).toThrow(TypeCheckError);
+  });
+
+  it('should swallow array errors when enabled', () => {
+    typeChecker.setSwallowErrors(true);
+    const result = typeChecker.checkArray([1, 2, 3], stringValidator);
+    expect(result).toEqual([1, 2, 3]);
+    typeChecker.setSwallowErrors(false);
+  });
+
+  it('should check enum value correctly', () => {
+    const choices = ['option1', 'option2', 'option3'];
+    const result = typeChecker.checkEnum('option2', choices);
+    expect(result).toBe('option2');
+  });
+
+  it('should throw TypeCheckError for invalid enum value', () => {
+    const choices = ['option1', 'option2', 'option3'];
+    expect(() => typeChecker.checkEnum('invalid', choices)).toThrow(TypeCheckError);
+  });
+
+  it('should swallow enum errors when enabled', () => {
+    typeChecker.setSwallowErrors(true);
+    const choices = ['option1', 'option2', 'option3'];
+    const result = typeChecker.checkEnum('invalid', choices);
+    expect(result).toBe('invalid');
+    typeChecker.setSwallowErrors(false);
+  });
+
+  it('should handle number enum values', () => {
+    const choices = [1, 2, 3];
+    const result = typeChecker.checkEnum(2, choices);
+    expect(result).toBe(2);
+  });
+
+  it('should handle mixed string and number enum values', () => {
+    const choices = ['option1', 2, 'option3'];
+    const result = typeChecker.checkEnum(2, choices);
+    expect(result).toBe(2);
+  });
+});

package/src/util/async.js

@@ -11,9 +11,12 @@ export const delayPromise = (delayMS) =>
 /**
  * Load JSON file using a fetch GET request.
  * @param {string} url - URL to load.
- * @returns {Promise<string>} The parsed JSON data.
+ * @returns {Promise<unknown>} The parsed JSON data.
  */
 export const loadJSON = async (url) => {
   const response = await fetch(url);
-  return await response.json();
+  if (!response.ok) {
+    throw new DOMException(`Fetch error ${response.status}`, 'FetchError');
+  }
+  return response.json();
 };

package/src/util/async.test.js

@@ -1,4 +1,4 @@
-import { delayPromise } from './async.js';
+import { delayPromise, loadJSON } from './async.js';
 
 describe('delayPromise', () => {
   test('Returns a promise that resolves after specified delay', async () => {
@@ -19,3 +19,13 @@ describe('delayPromise', () => {
     expect(end - start).toBeGreaterThanOrEqual(0);
   });
 });
+
+describe('loadJSON', () => {
+  test('Load JSON data', async () => {
+    const data = await loadJSON('/test.json');
+    expect(data).toMatchObject({
+      method: 'GET',
+      success: true,
+    });
+  });
+});

package/src/util/error.js

@@ -1,10 +1,12 @@
+const DEFAULT_EXCLUDES = new Set(['stack']);
+
 /**
  * Retrieves detailed information from an error object.
  * @param {Error} error - The error to extract details from.
- * @param {string[]} [excludes] - An array of property names to exclude from the result.
+ * @param {null | undefined | string[]} [excludes] - An array of property names to exclude from the result.
  * @returns {object} - An object containing the error details.
  */
-export const getErrorDetails = (error, excludes = ['stack']) => {
+export const getErrorDetails = (error, excludes) => {
   const errorDetails = {
     name: error.name,
     type: error.constructor?.name ?? typeof error,
@@ -16,7 +18,7 @@ export const getErrorDetails = (error, excludes = ['stack']) => {
     errorDetails.cause = error.cause;
   }
   for (const key of Object.getOwnPropertyNames(error)) {
-    if (!excludes.includes(key)) {
+    if (!excludes?.includes(key) && !DEFAULT_EXCLUDES.has(key)) {
       errorDetails[key] = error[key];
     }
   }

package/src/util/error.test.js

@@ -9,6 +9,7 @@ describe('error', () => {
     expect(errorDetails.type).toBe('Error');
     expect(errorDetails.message).toBe('Test error');
     expect(errorDetails.cause).toBe('Test cause');
+    expect(errorDetails.stack).toBe(undefined);
   });
 
   test('getErrorDetails with Error cause', () => {

package/src/util/fetch.js

@@ -1,4 +1,3 @@
-/* eslint-disable jsdoc/no-undefined-types */
 /* oxlint-disable no-await-in-loop */
 
 import {

package/src/util/fetch.test.js

@@ -1,9 +1,19 @@
 import { HTTP_404_NOT_FOUND } from '../const/http_status.js';
 import { fetchRetry, FetchError } from './fetch.js';
 
+describe('FetchError', () => {
+  test('constructor', () => {
+    const error = new FetchError('message', 'url', { method: 'GET' }, null);
+    expect(error.message).toEqual('message');
+    expect(error.resource).toEqual('url');
+    expect(error.fetchOptions).toMatchObject({ method: 'GET' });
+    expect(error.response).toBe(null);
+  });
+});
+
 describe('fetchRetry', () => {
   test('fetch OK', async () => {
-    const response = await fetchRetry('https://jsonplaceholder.typicode.com/todos/1', {
+    const response = await fetchRetry('/test.json', {
       cache: 'no-cache',
       keepalive: false,
       method: 'GET',
@@ -11,16 +21,14 @@ describe('fetchRetry', () => {
     });
     const json = await response.json();
     const expectedJSON = {
-      completed: false,
-      id: 1,
-      title: 'delectus aut autem',
-      userId: 1,
+      success: true,
+      method: 'GET',
     };
     expect(json).toEqual(expectedJSON);
   });
   test('fetch unknown scheme', async () => {
     try {
-      await fetchRetry('htps://jsonplaceholder', {});
+      await fetchRetry('htps://', {});
     } catch (error) {
       const typedError = error instanceof Error ? error : new Error(String(error));
       expect(typedError.message).toEqual('fetch failed');
@@ -32,7 +40,7 @@ describe('fetchRetry', () => {
   test('fetch 404 error with retry', async () => {
     try {
       await fetchRetry(
-        'https://jsonplaceholder.typicode.com/todos/1',
+        '/test_error.json',
         {
           cache: 'no-cache',
           keepalive: false,

package/src/util/number.js

@@ -1,63 +1,65 @@
-/**
- * Converts degrees to radians.
- * @param {number} deg - Degree value.
- * @returns {number} Radian value.
- */
-export const deg2rad = (deg) => deg * (Math.PI / 180);
+import { TypeCheckError } from '../typecheck/TypeCheckError.js';
 
-/**
- * Returns random integer in range.
- * @param {number} min - Min value.
- * @param {number} max - Max value.
- * @returns {number} Random integer in given range.
- */
-export const getRandomInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+const DEG_TO_RAD = Math.PI / 180;
+const RAD_TO_DEG = 180 / Math.PI;
+
+const PRECISION = 12;
+const EPSILON = 1e-11;
 
 /**
- * Fixes floating point number (0.20000000000000004 -> 0.2).
- * @param {number | string} value - Number to fix.
- * @returns {number} The fixed number.
+ * Converts degrees to radians.
+ * @param {number} degrees - Angle in degrees.
+ * @returns {number} Angle in radians.
+ * @throws {TypeCheckError}
  */
-export const fixFloatPrecision = (value) => {
-  // Handle string inputs by converting to number first
-  if (typeof value === 'string') {
-    value = Number(value);
+export const deg2rad = (degrees) => {
+  if (!Number.isFinite(degrees)) {
+    throw new TypeCheckError('Argument degrees must be a finite number', { value: degrees });
   }
-  if (value >= 0 && value < 0.00000000001) {
-    const valuePlusOne = value + 1;
-    return Number.parseFloat(valuePlusOne.toPrecision(12)) - 1;
-  }
-  return Number.parseFloat(value.toPrecision(12));
+  return degrees * DEG_TO_RAD;
 };
 
 /**
- * Convenience method for floating point precision handling.
- * @param {number} value - The number to process.
- * @param {number} p - The precision. Defaults to 2.
- * @returns {number} The processed value.
+ * Converts radians to degrees.
+ * @param {number} radians - Angle in radians.
+ * @returns {number} Angle in degrees.
+ * @throws {TypeCheckError}
  */
-export const fixFloat = (value, p = 2) => Number.parseFloat(value.toFixed(p));
+export const rad2deg = (radians) => {
+  if (!Number.isFinite(radians)) {
+    throw new TypeCheckError('Argument radians must be a finite number', { value: radians });
+  }
+  return radians * RAD_TO_DEG;
+};
 
 /**
- * Adds two value with floating point precision.
- * @param {number} a - The number a.
- * @param {number} b - The number b.
- * @returns {number} The processed value.
+ * Returns random integer in range.
+ * @param {number} min - Min value.
+ * @param {number} max - Max value.
+ * @returns {number} Random integer in given range.
+ * @throws {TypeError}
  */
-export const addFloat = (a, b) => {
-  const p = 100;
-  return fixFloat((a * p + b * p) / p);
+export const getRandomInt = (min, max) => {
+  if (!Number.isFinite(min)) {
+    throw new TypeCheckError('Argument min must be finite number', { value: min });
+  }
+  if (!Number.isFinite(max)) {
+    throw new TypeCheckError('Argument max must be finite number', { value: max });
+  }
+  return Math.floor(Math.random() * (max - min + 1)) + min;
 };
 
 /**
- * Substracts two value with floating point precision.
- * @param {number} a - The number a.
- * @param {number} b - The number b.
- * @returns {number} The processed value.
+ * Normalizes floating point precision (e.g. 0.20000000000000004 → 0.2).
+ * @param {number | string} value - Input value.
+ * @returns {number} Fixed float precision value.
  */
-export const subFloat = (a, b) => {
-  const p = 100;
-  return fixFloat((a * p - b * p) / p);
+export const fixFloatPrecision = (value) => {
+  const parsedValue = typeof value === 'string' ? Number(value) : value;
+  if (!Number.isFinite(parsedValue)) {
+    return Number.NaN;
+  }
+  return Math.abs(parsedValue) < EPSILON ? 0 : Number(parsedValue.toPrecision(PRECISION));
 };
 
 /**

package/src/util/number.test.js

@@ -1,6 +1,7 @@
+/* eslint-disable unicorn/no-useless-undefined */
+
+import { TypeCheckError } from '../typecheck/TypeCheckError.js';
 import {
-  addFloat,
-  fixFloat,
   fixFloatPrecision,
   getRandomInt,
   isEqual,
@@ -9,12 +10,20 @@ import {
   isInRange,
   isLess,
   isLessOrEqual,
-  subFloat,
   deg2rad,
+  rad2deg,
 } from './number.js';
 
-test('Converts degrees to radians', () => {
+test('Converts angle in degrees to radians', () => {
   expect(deg2rad(90)).toBe(1.5707963267948966);
+  // @ts-expect-error
+  expect(() => deg2rad('')).toThrowError(TypeCheckError);
+});
+
+test('Converts angle in radians to degrees', () => {
+  expect(rad2deg(1.5707963267948966)).toBe(90);
+  // @ts-expect-error
+  expect(() => rad2deg('')).toThrowError(TypeCheckError);
 });
 
 describe('fixFloatPrecision', () => {
@@ -32,18 +41,32 @@ describe('fixFloatPrecision', () => {
 
   test('Handles very small numbers', () => {
     expect(fixFloatPrecision(0.0000000000001)).toBe(0);
+    expect(fixFloatPrecision(-0.0000000000001)).toBe(0);
   });
 
   test('Handles integer numbers', () => {
     expect(fixFloatPrecision(5)).toBe(5);
   });
 
-  test('Handles string input', () => {
+  test('Handles string number input', () => {
     expect(fixFloatPrecision('5.123456789')).toBe(5.123456789);
   });
+
+  test('Throws error for invalid input', () => {
+    expect(fixFloatPrecision('abc')).toBe(Number.NaN);
+    expect(fixFloatPrecision(null)).toBe(Number.NaN);
+    expect(fixFloatPrecision(undefined)).toBe(Number.NaN);
+  });
 });
 
 describe('getRandomInt', () => {
+  test('Throws error if min or max is not finite number', () => {
+    // @ts-expect-error
+    expect(() => getRandomInt('', 1)).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => getRandomInt(1, '')).toThrowError(TypeCheckError);
+  });
+
   test('Returns random integer within range when min equals max', () => {
     expect(getRandomInt(1, 1)).toBe(1);
   });
@@ -66,18 +89,6 @@ describe('getRandomInt', () => {
   });
 });
 
-test('fixFloat()', () => {
-  expect(fixFloat(0.20000000000000004)).toBe(0.2);
-});
-
-test('addFloat()', () => {
-  expect(addFloat(0.20000000000000004, 0.1000001)).toBe(0.3);
-});
-
-test('subFloat()', () => {
-  expect(subFloat(0.20000000000000004, 0.1000001)).toBe(0.1);
-});
-
 describe('number', () => {
   test('isEq', () => {
     expect(isEqual(1, 0)).toBe(false);

package/src/util/validate.js

@@ -1,4 +1,4 @@
-/* eslint-disable jsdoc/reject-any-type, jsdoc/no-undefined-types */
+/* eslint-disable jsdoc/reject-any-type */
 
 import { isEqual, isGreater, isGreaterOrEqual, isInRange, isLess, isLessOrEqual } from './number.js';
 

package/tests/mocks/handlers/fetch.js

@@ -0,0 +1,34 @@
+import { http, HttpResponse } from 'msw';
+
+export const fetchHandlers = [
+  http.get('/test.json', () => {
+    const response = HttpResponse.json(
+      {
+        success: true,
+        method: 'GET',
+      },
+      { status: 200 }
+    );
+    return response;
+  }),
+  http.post('/test.json', () => {
+    const response = HttpResponse.json(
+      {
+        success: true,
+        method: 'POST',
+      },
+      { status: 200 }
+    );
+    return response;
+  }),
+  http.post('/test_error.json', () => {
+    const response = HttpResponse.json(
+      {
+        success: false,
+        method: 'POST',
+      },
+      { status: 404 }
+    );
+    return response;
+  }),
+];

package/tests/mocks/handlers.js

@@ -0,0 +1,3 @@
+import { fetchHandlers } from './handlers/fetch.js';
+
+export const handlers = [...fetchHandlers];

package/types/index.d.ts

@@ -17,8 +17,8 @@ export { typeCheck, typeCheckArray, typeCheckEnum } from "./typecheck/util.js";
 export { delayPromise, loadJSON } from "./util/async.js";
 export { getErrorDetails, getTypedError } from "./util/error.js";
 export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetch.js";
-export { addFloat, deg2rad, fixFloat, fixFloatPrecision, getRandomInt, isEqual, isGreater, isGreaterOrEqual, isInRange, isLess, isLessOrEqual, subFloat } from "./util/number.js";
-export { purgeObject, deepMerge, getObjArrayPropSum, getObjValueByPath, setObjValueByPath } from "./util/object.js";
+export { deg2rad, fixFloatPrecision, getRandomInt, isEqual, isGreater, isGreaterOrEqual, isInRange, isLess, isLessOrEqual, rad2deg } from "./util/number.js";
+export { deepMerge, getObjArrayPropSum, getObjValueByPath, purgeObject, setObjValueByPath } from "./util/object.js";
 export { getURLParam, sanitizeURLParam } from "./util/query.js";
 export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from "./util/string.js";
 //# sourceMappingURL=index.d.ts.map

package/types/pagelifecycle/const.d.ts

@@ -3,11 +3,13 @@ export const PAGE_LIFECYCLE_STATE_ACTIVE: "active";
 export const PAGE_LIFECYCLE_STATE_PASSIVE: "passive";
 export const PAGE_LIFECYCLE_STATE_FROZEN: "frozen";
 export const PAGE_LIFECYCLE_STATE_TERMINATED: "terminated";
+export const PAGE_LIFECYCLE_STATES: Set<string>;
 export const DOCUMENT_STATE_DOM_LOADED: "domLoaded";
 export const DOCUMENT_STATE_FULLY_LOADED: "fullyLoaded";
 export const DOCUMENT_STATE_COMPLETE: "complete";
 export const DOCUMENT_STATE_INTERACTIVE: "interactive";
 export const DOCUMENT_STATE_LOADING: "loading";
+export const DOCUMENT_STATES: Set<string>;
 export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT: "pageLifecycleStateChange";
 export const DOCUMENT_STATE_CHANGE_EVENT: "documentStateChange";
 //# sourceMappingURL=const.d.ts.map

package/types/pagelifecycle/const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/const.js"],"names":[],"mappings":"AAAA,0CAA2C,QAAQ,CAAC;AACpD,0CAA2C,QAAQ,CAAC;AACpD,2CAA4C,SAAS,CAAC;AACtD,0CAA2C,QAAQ,CAAC;AACpD,8CAA+C,YAAY,CAAC;AAE5D,wCAAyC,WAAW,CAAC;AACrD,0CAA2C,aAAa,CAAC;AACzD,sCAAuC,UAAU,CAAC;AAClD,yCAA0C,aAAa,CAAC;AACxD,qCAAsC,SAAS,CAAC;AAEhD,gDAAiD,0BAA0B,CAAC;AAC5E,0CAA2C,qBAAqB,CAAC"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/const.js"],"names":[],"mappings":"AAAA,0CAA2C,QAAQ,CAAC;AACpD,0CAA2C,QAAQ,CAAC;AACpD,2CAA4C,SAAS,CAAC;AACtD,0CAA2C,QAAQ,CAAC;AACpD,8CAA+C,YAAY,CAAC;AAE5D,gDAMG;AAEH,wCAAyC,WAAW,CAAC;AACrD,0CAA2C,aAAa,CAAC;AACzD,sCAAuC,UAAU,CAAC;AAClD,yCAA0C,aAAa,CAAC;AACxD,qCAAsC,SAAS,CAAC;AAEhD,0CAMG;AAEH,gDAAiD,0BAA0B,CAAC;AAC5E,0CAA2C,qBAAqB,CAAC"}

package/types/typecheck/TypeCheckError.d.ts

@@ -2,7 +2,12 @@ export class TypeCheckError extends TypeError {
     /**
      * Creates a new `TypeCheckError` instance.
      * @param {string} message - Error message.
+     * @param {{ cause?: unknown, value?: unknown }} [options] - Error options.
      */
-    constructor(message: string);
+    constructor(message: string, options?: {
+        cause?: unknown;
+        value?: unknown;
+    });
+    value: unknown;
 }
 //# sourceMappingURL=TypeCheckError.d.ts.map

package/types/typecheck/TypeCheckError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeCheckError.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeCheckError.js"],"names":[],"mappings":"AAAA;IACE;;;OAGG;IACH,qBAFW,MAAM,EAKhB;CACF"}
+{"version":3,"file":"TypeCheckError.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeCheckError.js"],"names":[],"mappings":"AAAA;IACE;;;;OAIG;IACH,qBAHW,MAAM,YACN;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAM9C;IADC,eAA2B;CAE9B"}

package/types/util/async.d.ts

@@ -1,3 +1,3 @@
 export function delayPromise(delayMS: number): Promise<void>;
-export function loadJSON(url: string): Promise<string>;
+export function loadJSON(url: string): Promise<unknown>;
 //# sourceMappingURL=async.d.ts.map

package/types/util/async.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/util/async.js"],"names":[],"mappings":"AAKO,sCAHI,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKtB;AAOG,8BAHI,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAK3B"}
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/util/async.js"],"names":[],"mappings":"AAKO,sCAHI,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKtB;AAOG,8BAHI,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAQ5B"}

package/types/util/error.d.ts

@@ -1,3 +1,3 @@
-export function getErrorDetails(error: Error, excludes?: string[]): object;
+export function getErrorDetails(error: Error, excludes?: null | undefined | string[]): object;
 export function getTypedError(error: unknown): Error;
 //# sourceMappingURL=error.d.ts.map

package/types/util/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.js"],"names":[],"mappings":"AAMO,uCAJI,KAAK,aACL,MAAM,EAAE,GACN,MAAM,CAmBlB;AAOM,qCAHI,OAAO,GACL,KAAK,CAEiF"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.js"],"names":[],"mappings":"AAQO,uCAJI,KAAK,aACL,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,GACzB,MAAM,CAmBlB;AAOM,qCAHI,OAAO,GACL,KAAK,CAEiF"}

package/types/util/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.js"],"names":[],"mappings":"AAeA,yBAA0B,CAAC,CAAC;AAE5B;IACE;;;;;;OAMG;IACH,qBALW,MAAM,YACN,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,YACX,QAAQ,EASlB;IAJC,iCAAwB;IACxB,0BAAgC;IAChC,mBAAwB;IACxB,cAAqC;CAExC;AASM,qCALI,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC9E,OAAO,CAAC,QAAQ,CAAC,CAkD7B"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.js"],"names":[],"mappings":"AAcA,yBAA0B,CAAC,CAAC;AAE5B;IACE;;;;;;OAMG;IACH,qBALW,MAAM,YACN,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,YACX,QAAQ,EASlB;IAJC,iCAAwB;IACxB,0BAAgC;IAChC,mBAAwB;IACxB,cAAqC;CAExC;AASM,qCALI,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC9E,OAAO,CAAC,QAAQ,CAAC,CAkD7B"}

package/types/util/number.d.ts

@@ -1,9 +1,7 @@
-export function deg2rad(deg: number): number;
+export function deg2rad(degrees: number): number;
+export function rad2deg(radians: number): number;
 export function getRandomInt(min: number, max: number): number;
 export function fixFloatPrecision(value: number | string): number;
-export function fixFloat(value: number, p?: number): number;
-export function addFloat(a: number, b: number): number;
-export function subFloat(a: number, b: number): number;
 export function isGreater(value: number, min: number): boolean;
 export function isGreaterOrEqual(value: number, min: number): boolean;
 export function isLess(value: number, min: number): boolean;

package/types/util/number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/util/number.js"],"names":[],"mappings":"AAKO,6BAHI,MAAM,GACJ,MAAM,CAEkC;AAQ9C,kCAJI,MAAM,OACN,MAAM,GACJ,MAAM,CAEwE;AAOpF,yCAHI,MAAM,GAAG,MAAM,GACb,MAAM,CAYlB;AAQM,gCAJI,MAAM,MACN,MAAM,GACJ,MAAM,CAE0D;AAQtE,4BAJI,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;AAQM,4BAJI,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;AASM,iCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGgC;AAS7C,wCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGwC;AASrD,8BALI,MAAM,OACN,MAAM,GACJ,OAAO,CAG6B;AAS1C,qCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGqC;AAUlD,iCANI,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAGsD;AASnE,+BALI,MAAM,YACN,MAAM,GACJ,OAAO,CAG0C"}
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/util/number.js"],"names":[],"mappings":"AAcO,iCAJI,MAAM,GACJ,MAAM,CAQlB;AAQM,iCAJI,MAAM,GACJ,MAAM,CAQlB;AASM,kCALI,MAAM,OACN,MAAM,GACJ,MAAM,CAWlB;AAOM,yCAHI,MAAM,GAAG,MAAM,GACb,MAAM,CAQlB;AASM,iCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGgC;AAS7C,wCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGwC;AASrD,8BALI,MAAM,OACN,MAAM,GACJ,OAAO,CAG6B;AAS1C,qCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGqC;AAUlD,iCANI,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAGsD;AASnE,+BALI,MAAM,YACN,MAAM,GACJ,OAAO,CAG0C"}

package/vitest.setup.js

@@ -0,0 +1,17 @@
+import { setupServer } from 'msw/node';
+import { beforeAll } from 'vitest';
+import { handlers } from './tests/mocks/handlers.js';
+
+const server = setupServer(...handlers);
+
+beforeAll(() => {
+  server.listen();
+});
+
+afterEach(() => {
+  server.resetHandlers();
+});
+
+afterAll(() => {
+  server.close();
+});