@w3ux/utils 2.0.8 → 2.0.10

package/base.cjs

@@ -34,7 +34,8 @@ __export(base_exports, {
   rmCommas: () => rmCommas,
   rmDecimals: () => rmDecimals,
   shuffle: () => shuffle,
-  withTimeout: () => withTimeout
+  withTimeout: () => withTimeout,
+  withTimeoutThrow: () => withTimeoutThrow
 });
 module.exports = __toCommonJS(base_exports);
 var import_utils = require("dedot/utils");
@@ -136,6 +137,17 @@ var withTimeout = (ms, promise, options) => {
   );
   return Promise.race([promise, timeout]);
 };
+var withTimeoutThrow = (ms, promise, options) => {
+  const timeout = new Promise(
+    (reject) => setTimeout(async () => {
+      if (typeof options?.onTimeout === "function") {
+        options.onTimeout();
+      }
+      reject("Function timeout");
+    }, ms)
+  );
+  return Promise.race([promise, timeout]);
+};
 var appendOrEmpty = (condition, value) => condition ? ` ${value}` : "";
 var appendOr = (condition, value, fallback) => condition ? ` ${value}` : ` ${fallback}`;
 var formatAccountSs58 = (address, ss58Prefix) => {
@@ -174,7 +186,8 @@ var minBigInt = (...values) => values.reduce((min, current) => current < min ? c
   rmCommas,
   rmDecimals,
   shuffle,
-  withTimeout
+  withTimeout,
+  withTimeoutThrow
 });
 /* @license Copyright 2024 w3ux authors & contributors
 SPDX-License-Identifier: GPL-3.0-only */

package/base.d.cts

@@ -58,6 +58,13 @@ declare const shuffle: <T>(array: T[]) => T[];
 declare const withTimeout: (ms: number, promise: Promise<unknown>, options?: {
     onTimeout?: () => void;
 }) => Promise<unknown>;
+/**
+ * @name withTimeoutThrow
+ * @summary Timeout a promise after a specified number of milliseconds by throwing an error
+ */
+declare const withTimeoutThrow: <T>(ms: number, promise: Promise<T>, options?: {
+    onTimeout?: () => void;
+}) => Promise<unknown>;
 /**
  * @name appendOrEmpty
  * @summary Returns ` value` if a condition is truthy, or an empty string otherwise.
@@ -104,4 +111,4 @@ declare const maxBigInt: (...values: bigint[]) => bigint;
  */
 declare const minBigInt: (...values: bigint[]) => bigint;
 
-export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout };
+export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout, withTimeoutThrow };

package/base.d.ts

@@ -58,6 +58,13 @@ declare const shuffle: <T>(array: T[]) => T[];
 declare const withTimeout: (ms: number, promise: Promise<unknown>, options?: {
     onTimeout?: () => void;
 }) => Promise<unknown>;
+/**
+ * @name withTimeoutThrow
+ * @summary Timeout a promise after a specified number of milliseconds by throwing an error
+ */
+declare const withTimeoutThrow: <T>(ms: number, promise: Promise<T>, options?: {
+    onTimeout?: () => void;
+}) => Promise<unknown>;
 /**
  * @name appendOrEmpty
  * @summary Returns ` value` if a condition is truthy, or an empty string otherwise.
@@ -104,4 +111,4 @@ declare const maxBigInt: (...values: bigint[]) => bigint;
  */
 declare const minBigInt: (...values: bigint[]) => bigint;
 
-export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout };
+export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout, withTimeoutThrow };

package/base.js

@@ -98,6 +98,17 @@ var withTimeout = (ms, promise, options) => {
   );
   return Promise.race([promise, timeout]);
 };
+var withTimeoutThrow = (ms, promise, options) => {
+  const timeout = new Promise(
+    (reject) => setTimeout(async () => {
+      if (typeof options?.onTimeout === "function") {
+        options.onTimeout();
+      }
+      reject("Function timeout");
+    }, ms)
+  );
+  return Promise.race([promise, timeout]);
+};
 var appendOrEmpty = (condition, value) => condition ? ` ${value}` : "";
 var appendOr = (condition, value, fallback) => condition ? ` ${value}` : ` ${fallback}`;
 var formatAccountSs58 = (address, ss58Prefix) => {
@@ -135,7 +146,8 @@ export {
   rmCommas,
   rmDecimals,
   shuffle,
-  withTimeout
+  withTimeout,
+  withTimeoutThrow
 };
 /* @license Copyright 2024 w3ux authors & contributors
 SPDX-License-Identifier: GPL-3.0-only */

package/index.cjs

@@ -57,7 +57,8 @@ __export(index_exports, {
   unimplemented: () => unimplemented,
   unitToPlanck: () => unitToPlanck,
   varToUrlHash: () => varToUrlHash,
-  withTimeout: () => withTimeout
+  withTimeout: () => withTimeout,
+  withTimeoutThrow: () => withTimeoutThrow
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -161,6 +162,17 @@ var withTimeout = (ms, promise, options) => {
   );
   return Promise.race([promise, timeout]);
 };
+var withTimeoutThrow = (ms, promise, options) => {
+  const timeout = new Promise(
+    (reject) => setTimeout(async () => {
+      if (typeof options?.onTimeout === "function") {
+        options.onTimeout();
+      }
+      reject("Function timeout");
+    }, ms)
+  );
+  return Promise.race([promise, timeout]);
+};
 var appendOrEmpty = (condition, value) => condition ? ` ${value}` : "";
 var appendOr = (condition, value, fallback) => condition ? ` ${value}` : ` ${fallback}`;
 var formatAccountSs58 = (address, ss58Prefix) => {
@@ -432,7 +444,8 @@ var mergeDeep = (target, ...sources) => {
   unimplemented,
   unitToPlanck,
   varToUrlHash,
-  withTimeout
+  withTimeout,
+  withTimeoutThrow
 });
 /* @license Copyright 2024 w3ux authors & contributors
 SPDX-License-Identifier: GPL-3.0-only */

package/index.d.cts

@@ -1,4 +1,4 @@
-export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout } from './base.cjs';
+export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout, withTimeoutThrow } from './base.cjs';
 export { u8aConcat } from './convert.cjs';
 export { addedTo, applyWidthAsPadding, capitalizeFirstLetter, extractUrlValue, inChrome, isValidAddress, isValidHttpUrl, localStorageOrDefault, makeCancelable, matchedProperties, mergeDeep, planckToUnit, remToUnit, removeVarFromUrlHash, removedFrom, setStateWithRef, snakeToCamel, sortWithNull, unescape, unimplemented, unitToPlanck, varToUrlHash } from './unit.cjs';
 import 'react';

package/index.d.ts

@@ -1,4 +1,4 @@
-export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout } from './base.js';
+export { appendOr, appendOrEmpty, camelize, ellipsisFn, eqSet, formatAccountSs58, isSuperset, maxBigInt, minBigInt, minDecimalPlaces, pageFromUri, removeHexPrefix, rmCommas, rmDecimals, shuffle, withTimeout, withTimeoutThrow } from './base.js';
 export { u8aConcat } from './convert.js';
 export { addedTo, applyWidthAsPadding, capitalizeFirstLetter, extractUrlValue, inChrome, isValidAddress, isValidHttpUrl, localStorageOrDefault, makeCancelable, matchedProperties, mergeDeep, planckToUnit, remToUnit, removeVarFromUrlHash, removedFrom, setStateWithRef, snakeToCamel, sortWithNull, unescape, unimplemented, unitToPlanck, varToUrlHash } from './unit.js';
 import 'react';

package/index.js

@@ -98,6 +98,17 @@ var withTimeout = (ms, promise, options) => {
   );
   return Promise.race([promise, timeout]);
 };
+var withTimeoutThrow = (ms, promise, options) => {
+  const timeout = new Promise(
+    (reject) => setTimeout(async () => {
+      if (typeof options?.onTimeout === "function") {
+        options.onTimeout();
+      }
+      reject("Function timeout");
+    }, ms)
+  );
+  return Promise.race([promise, timeout]);
+};
 var appendOrEmpty = (condition, value) => condition ? ` ${value}` : "";
 var appendOr = (condition, value, fallback) => condition ? ` ${value}` : ` ${fallback}`;
 var formatAccountSs58 = (address, ss58Prefix) => {
@@ -368,7 +379,8 @@ export {
   unimplemented,
   unitToPlanck,
   varToUrlHash,
-  withTimeout
+  withTimeout,
+  withTimeoutThrow
 };
 /* @license Copyright 2024 w3ux authors & contributors
 SPDX-License-Identifier: GPL-3.0-only */

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "@w3ux/utils",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "license": "GPL-3.0-only",
-  "dependencies": {
-    "dedot": "^0.8.1"
-  },
-  "main": "index.cjs",
-  "module": "index.js",
+  "type": "module",
   "exports": {
     ".": {
       "import": "./index.js",
       "require": "./index.cjs"
     }
+  },
+  "dependencies": {
+    "dedot": "^0.8.1"
   }
 }

package/unit.d.cts

@@ -1,4 +1,4 @@
-import { MutableRefObject, RefObject } from 'react';
+import { RefObject } from 'react';
 import { AnyObject } from './types.cjs';
 
 /**
@@ -44,7 +44,7 @@ declare const snakeToCamel: (str: string) => string;
  * @name setStateWithRef
  * @summary Synchronize React state and its reference with the provided value.
  */
-declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: MutableRefObject<T>) => void;
+declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: RefObject<T>) => void;
 /**
  * @name localStorageOrDefault
  * @summary Retrieve the local stroage value with the key, return defult value if it is not

package/unit.d.ts

@@ -1,4 +1,4 @@
-import { MutableRefObject, RefObject } from 'react';
+import { RefObject } from 'react';
 import { AnyObject } from './types.js';
 
 /**
@@ -44,7 +44,7 @@ declare const snakeToCamel: (str: string) => string;
  * @name setStateWithRef
  * @summary Synchronize React state and its reference with the provided value.
  */
-declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: MutableRefObject<T>) => void;
+declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: RefObject<T>) => void;
 /**
  * @name localStorageOrDefault
  * @summary Retrieve the local stroage value with the key, return defult value if it is not