@hairy/utils 1.12.0 → 1.13.0

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BIG_INTS: () => BIG_INTS,
+  BigNum: () => BigNum,
   Bignumber: () => import_bignumber.default,
   Deferred: () => Deferred,
   arange: () => arange,
@@ -110,6 +111,8 @@ __export(index_exports, {
   percentage: () => percentage,
   pipe: () => pipe,
   plus: () => plus,
+  randomArray: () => randomArray,
+  randomNumer: () => randomNumer,
   riposte: () => riposte,
   sentenceCase: () => sentenceCase,
   snakeCase: () => snakeCase,
@@ -118,7 +121,6 @@ __export(index_exports, {
   uniq: () => uniq_default,
   uniqBy: () => uniqBy_default,
   uniqWith: () => uniqWith_default,
-  unum: () => unum,
   unwrap: () => unwrap,
   values: () => values_default,
   whenever: () => whenever,
@@ -3012,40 +3014,40 @@ var BIG_INTS = {
   m: { v: 10 ** 6, d: 7, n: "m" },
   k: { v: 10 ** 3, d: 4, n: "k" }
 };
-function unum(num = "0") {
+function BigNum(num = "0") {
   return new import_bignumber.default(numerfix(num));
 }
 function gte(num, n) {
-  return unum(num).gte(unum(n));
+  return BigNum(num).gte(BigNum(n));
 }
 function gt(num, n) {
-  return unum(num).gt(unum(n));
+  return BigNum(num).gt(BigNum(n));
 }
 function lte(num, n) {
-  return unum(num).lte(unum(n));
+  return BigNum(num).lte(BigNum(n));
 }
 function lt(num, n) {
-  return unum(num).lt(unum(n));
+  return BigNum(num).lt(BigNum(n));
 }
 function plus(array, options) {
   const rounding = options?.r || import_bignumber.default.ROUND_DOWN;
   const decimal2 = options?.d || 0;
-  return array.filter((v) => unum(v).gt(0)).reduce((t, v) => t.plus(unum(v)), unum(0)).toFixed(decimal2, rounding);
+  return array.filter((v) => BigNum(v).gt(0)).reduce((t, v) => t.plus(BigNum(v)), BigNum(0)).toFixed(decimal2, rounding);
 }
 function average(array, options) {
   const rounding = options?.r || import_bignumber.default.ROUND_DOWN;
   const decimal2 = options?.d || 0;
   if (array.length === 0)
     return "0";
-  return unum(plus(array)).div(array.length).toFixed(decimal2, rounding);
+  return BigNum(plus(array)).div(array.length).toFixed(decimal2, rounding);
 }
 function percentage(total, count, options) {
   options ??= { d: 3, r: import_bignumber.default.ROUND_DOWN };
   const rounding = options?.r || import_bignumber.default.ROUND_DOWN;
   const decimal2 = options?.d || 3;
-  if (unum(total).lte(0) || unum(count).lte(0))
+  if (BigNum(total).lte(0) || BigNum(count).lte(0))
     return "0";
-  return unum(count).div(unum(total)).times(100).toFixed(decimal2, rounding);
+  return BigNum(count).div(BigNum(total)).times(100).toFixed(decimal2, rounding);
 }
 function zerofill(value, n = 2, type = "positive") {
   const _value = integer(value);
@@ -3063,8 +3065,6 @@ function zeromove(value) {
 }
 function numerfix(value) {
   const _isNaN = Number.isNaN(Number(value)) || value.toString() === "NaN";
-  if (_isNaN)
-    console.warn(`numerfix(${value}): value is not the correct value. To ensure the normal operation of the program, it will be converted to zero`);
   return _isNaN ? "0" : String(value);
 }
 function integer(value) {
@@ -3089,7 +3089,7 @@ function parseNumeric(num, delimiters = ["t", "b", "m"]) {
   ];
   let options;
   for (const analy of mappings) {
-    const opts = analy && analy(unum(num).toFixed(0));
+    const opts = analy && analy(BigNum(num).toFixed(0));
     opts && (options = opts);
   }
   return options || { v: 1, d: 0, n: "" };
@@ -3102,7 +3102,7 @@ function formatNumeric(value = "0", options) {
     decimals = 2
   } = options || {};
   const config = parseNumeric(value, delimiters || []);
-  let number = unum(value).div(config.v).toFormat(decimals, rounding, {
+  let number = BigNum(value).div(config.v).toFormat(decimals, rounding, {
     decimalSeparator: ".",
     groupSeparator: ",",
     groupSize: 3,
@@ -3233,6 +3233,14 @@ function pPipe(...functions) {
 // src/util/pipe.ts
 var pipe = (...fns) => fns.reduce((v, f) => f(v));
 
+// src/util/random.ts
+function randomNumer(min, max) {
+  return Math.random() * (max - min) + min;
+}
+function randomArray(array) {
+  return array[Math.floor(Math.random() * array.length)];
+}
+
 // src/util/util.ts
 function arange(x1, x2, stp = 1, z = [], z0 = z.length) {
   if (!x2)
@@ -3264,6 +3272,7 @@ function whenever(value, callback) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BIG_INTS,
+  BigNum,
   Bignumber,
   Deferred,
   arange,
@@ -3343,6 +3352,8 @@ function whenever(value, callback) {
   percentage,
   pipe,
   plus,
+  randomArray,
+  randomNumer,
   riposte,
   sentenceCase,
   snakeCase,
@@ -3351,7 +3362,6 @@ function whenever(value, callback) {
   uniq,
   uniqBy,
   uniqWith,
-  unum,
   unwrap,
   values,
   whenever,

package/dist/index.d.ts

@@ -162,19 +162,19 @@ interface FormatNumericOptions {
     zeromove?: boolean;
     format?: Bignumber.Format;
 }
-declare function unum(num?: Numeric): Bignumber;
-declare function gte(num: Numeric, n: Numeric): boolean;
-declare function gt(num: Numeric, n: Numeric): boolean;
-declare function lte(num: Numeric, n: Numeric): boolean;
-declare function lt(num: Numeric, n: Numeric): boolean;
-declare function plus(array: Numeric[], options?: DecimalOptions): string;
-declare function average(array: Numeric[], options?: DecimalOptions): string;
+declare function BigNum(num?: Numberish): Bignumber;
+declare function gte(num: Numberish, n: Numberish): boolean;
+declare function gt(num: Numberish, n: Numberish): boolean;
+declare function lte(num: Numberish, n: Numberish): boolean;
+declare function lt(num: Numberish, n: Numberish): boolean;
+declare function plus(array: Numberish[], options?: DecimalOptions): string;
+declare function average(array: Numberish[], options?: DecimalOptions): string;
 /**
  * calculate percentage
  * @param total
  * @param count
  */
-declare function percentage(total: Numeric, count: Numeric, options?: DecimalOptions): string;
+declare function percentage(total: Numberish, count: Numberish, options?: DecimalOptions): string;
 /**
  * leading zeros
  * @param value
@@ -195,7 +195,7 @@ declare function integer(value: Numberish): string;
  * @param n
  */
 declare function decimal(value: Numberish, n?: number): string;
-declare function parseNumeric(num: Numeric, delimiters?: Delimiter[]): {
+declare function parseNumeric(num: Numberish, delimiters?: Delimiter[]): {
     v: number;
     d: number;
     n: string;
@@ -206,7 +206,7 @@ declare function parseNumeric(num: Numeric, delimiters?: Delimiter[]): {
  * @param options
  * @returns
  */
-declare function formatNumeric(value?: Numeric, options?: FormatNumericOptions): string;
+declare function formatNumeric(value?: Numberish, options?: FormatNumericOptions): string;
 
 type Dimension = Numeric | [Numeric, Numeric] | {
     width: Numeric;
@@ -312,10 +312,13 @@ declare function pPipe<ValueType, ResultValue1, ResultValue2, ResultValue3, Resu
 
 declare const pipe: (...fns: any[]) => any;
 
+declare function randomNumer(min: number, max: number): number;
+declare function randomArray<T>(array: T[]): T;
+
 declare function arange(x1: number, x2?: number, stp?: number, z?: number[], z0?: number): number[];
 declare function loop<T = void>(fn: (next: (ms: number) => Promise<T>) => Promise<T>): Promise<T>;
 declare function riposte<T>(...args: [cond: boolean, value: T][]): T;
 declare function unwrap<T extends object>(value: T | (() => T)): T;
 declare function whenever<T, C extends (value: Exclude<T, null | undefined>) => any>(value: T, callback: C): ReturnType<C> | undefined;
 
-export { type Arrayable, type Awaitable, BIG_INTS, type BooleanLike, type DecimalOptions, type DeepKeyof, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type FormatGroupOptions, type FormatNumericOptions, type Key, type Noop, type NumberObject, type Numberish, type Numeric, type NumericObject, type Option, type Pipeline, type StringObject, type SymbolObject, type Typeof, type UnaryFunction, arange, average, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dotCase, formToObject, formatNumeric, formatSize, formatUnit, getTypeof, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTypeof, isWeex, isWindow, jsonTryParse, kebabCase, loop, lt, lte, noCase, noop, numerfix, objectToForm, pPipe, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, riposte, sentenceCase, snakeCase, trainCase, unum, unwrap, whenever, zerofill, zeromove };
+export { type Arrayable, type Awaitable, BIG_INTS, BigNum, type BooleanLike, type DecimalOptions, type DeepKeyof, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type FormatGroupOptions, type FormatNumericOptions, type Key, type Noop, type NumberObject, type Numberish, type Numeric, type NumericObject, type Option, type Pipeline, type StringObject, type SymbolObject, type Typeof, type UnaryFunction, arange, average, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dotCase, formToObject, formatNumeric, formatSize, formatUnit, getTypeof, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTypeof, isWeex, isWindow, jsonTryParse, kebabCase, loop, lt, lte, noCase, noop, numerfix, objectToForm, pPipe, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, randomArray, randomNumer, riposte, sentenceCase, snakeCase, trainCase, unwrap, whenever, zerofill, zeromove };

package/dist/index.global.js

@@ -4228,40 +4228,40 @@
     m: { v: 10 ** 6, d: 7, n: "m" },
     k: { v: 10 ** 3, d: 4, n: "k" }
   };
-  function unum(num = "0") {
+  function BigNum(num = "0") {
     return new bignumber_default(numerfix(num));
   }
   function gte(num, n) {
-    return unum(num).gte(unum(n));
+    return BigNum(num).gte(BigNum(n));
   }
   function gt(num, n) {
-    return unum(num).gt(unum(n));
+    return BigNum(num).gt(BigNum(n));
   }
   function lte(num, n) {
-    return unum(num).lte(unum(n));
+    return BigNum(num).lte(BigNum(n));
   }
   function lt(num, n) {
-    return unum(num).lt(unum(n));
+    return BigNum(num).lt(BigNum(n));
   }
   function plus(array, options) {
     const rounding = options?.r || bignumber_default.ROUND_DOWN;
     const decimal2 = options?.d || 0;
-    return array.filter((v) => unum(v).gt(0)).reduce((t, v) => t.plus(unum(v)), unum(0)).toFixed(decimal2, rounding);
+    return array.filter((v) => BigNum(v).gt(0)).reduce((t, v) => t.plus(BigNum(v)), BigNum(0)).toFixed(decimal2, rounding);
   }
   function average(array, options) {
     const rounding = options?.r || bignumber_default.ROUND_DOWN;
     const decimal2 = options?.d || 0;
     if (array.length === 0)
       return "0";
-    return unum(plus(array)).div(array.length).toFixed(decimal2, rounding);
+    return BigNum(plus(array)).div(array.length).toFixed(decimal2, rounding);
   }
   function percentage(total, count, options) {
     options ??= { d: 3, r: bignumber_default.ROUND_DOWN };
     const rounding = options?.r || bignumber_default.ROUND_DOWN;
     const decimal2 = options?.d || 3;
-    if (unum(total).lte(0) || unum(count).lte(0))
+    if (BigNum(total).lte(0) || BigNum(count).lte(0))
       return "0";
-    return unum(count).div(unum(total)).times(100).toFixed(decimal2, rounding);
+    return BigNum(count).div(BigNum(total)).times(100).toFixed(decimal2, rounding);
   }
   function zerofill(value, n = 2, type = "positive") {
     const _value = integer(value);
@@ -4279,8 +4279,6 @@
   }
   function numerfix(value) {
     const _isNaN = Number.isNaN(Number(value)) || value.toString() === "NaN";
-    if (_isNaN)
-      console.warn(`numerfix(${value}): value is not the correct value. To ensure the normal operation of the program, it will be converted to zero`);
     return _isNaN ? "0" : String(value);
   }
   function integer(value) {
@@ -4305,7 +4303,7 @@
     ];
     let options;
     for (const analy of mappings) {
-      const opts = analy && analy(unum(num).toFixed(0));
+      const opts = analy && analy(BigNum(num).toFixed(0));
       opts && (options = opts);
     }
     return options || { v: 1, d: 0, n: "" };
@@ -4318,7 +4316,7 @@
       decimals = 2
     } = options || {};
     const config = parseNumeric(value, delimiters || []);
-    let number = unum(value).div(config.v).toFormat(decimals, rounding, {
+    let number = BigNum(value).div(config.v).toFormat(decimals, rounding, {
       decimalSeparator: ".",
       groupSeparator: ",",
       groupSize: 3,
@@ -4449,6 +4447,14 @@
   // src/util/pipe.ts
   var pipe = (...fns) => fns.reduce((v, f) => f(v));
 
+  // src/util/random.ts
+  function randomNumer(min, max) {
+    return Math.random() * (max - min) + min;
+  }
+  function randomArray(array) {
+    return array[Math.floor(Math.random() * array.length)];
+  }
+
   // src/util/util.ts
   function arange(x1, x2, stp = 1, z = [], z0 = z.length) {
     if (!x2)

package/dist/index.js

@@ -2883,40 +2883,40 @@ var BIG_INTS = {
   m: { v: 10 ** 6, d: 7, n: "m" },
   k: { v: 10 ** 3, d: 4, n: "k" }
 };
-function unum(num = "0") {
+function BigNum(num = "0") {
   return new Bignumber(numerfix(num));
 }
 function gte(num, n) {
-  return unum(num).gte(unum(n));
+  return BigNum(num).gte(BigNum(n));
 }
 function gt(num, n) {
-  return unum(num).gt(unum(n));
+  return BigNum(num).gt(BigNum(n));
 }
 function lte(num, n) {
-  return unum(num).lte(unum(n));
+  return BigNum(num).lte(BigNum(n));
 }
 function lt(num, n) {
-  return unum(num).lt(unum(n));
+  return BigNum(num).lt(BigNum(n));
 }
 function plus(array, options) {
   const rounding = options?.r || Bignumber.ROUND_DOWN;
   const decimal2 = options?.d || 0;
-  return array.filter((v) => unum(v).gt(0)).reduce((t, v) => t.plus(unum(v)), unum(0)).toFixed(decimal2, rounding);
+  return array.filter((v) => BigNum(v).gt(0)).reduce((t, v) => t.plus(BigNum(v)), BigNum(0)).toFixed(decimal2, rounding);
 }
 function average(array, options) {
   const rounding = options?.r || Bignumber.ROUND_DOWN;
   const decimal2 = options?.d || 0;
   if (array.length === 0)
     return "0";
-  return unum(plus(array)).div(array.length).toFixed(decimal2, rounding);
+  return BigNum(plus(array)).div(array.length).toFixed(decimal2, rounding);
 }
 function percentage(total, count, options) {
   options ??= { d: 3, r: Bignumber.ROUND_DOWN };
   const rounding = options?.r || Bignumber.ROUND_DOWN;
   const decimal2 = options?.d || 3;
-  if (unum(total).lte(0) || unum(count).lte(0))
+  if (BigNum(total).lte(0) || BigNum(count).lte(0))
     return "0";
-  return unum(count).div(unum(total)).times(100).toFixed(decimal2, rounding);
+  return BigNum(count).div(BigNum(total)).times(100).toFixed(decimal2, rounding);
 }
 function zerofill(value, n = 2, type = "positive") {
   const _value = integer(value);
@@ -2934,8 +2934,6 @@ function zeromove(value) {
 }
 function numerfix(value) {
   const _isNaN = Number.isNaN(Number(value)) || value.toString() === "NaN";
-  if (_isNaN)
-    console.warn(`numerfix(${value}): value is not the correct value. To ensure the normal operation of the program, it will be converted to zero`);
   return _isNaN ? "0" : String(value);
 }
 function integer(value) {
@@ -2960,7 +2958,7 @@ function parseNumeric(num, delimiters = ["t", "b", "m"]) {
   ];
   let options;
   for (const analy of mappings) {
-    const opts = analy && analy(unum(num).toFixed(0));
+    const opts = analy && analy(BigNum(num).toFixed(0));
     opts && (options = opts);
   }
   return options || { v: 1, d: 0, n: "" };
@@ -2973,7 +2971,7 @@ function formatNumeric(value = "0", options) {
     decimals = 2
   } = options || {};
   const config = parseNumeric(value, delimiters || []);
-  let number = unum(value).div(config.v).toFormat(decimals, rounding, {
+  let number = BigNum(value).div(config.v).toFormat(decimals, rounding, {
     decimalSeparator: ".",
     groupSeparator: ",",
     groupSize: 3,
@@ -3104,6 +3102,14 @@ function pPipe(...functions) {
 // src/util/pipe.ts
 var pipe = (...fns) => fns.reduce((v, f) => f(v));
 
+// src/util/random.ts
+function randomNumer(min, max) {
+  return Math.random() * (max - min) + min;
+}
+function randomArray(array) {
+  return array[Math.floor(Math.random() * array.length)];
+}
+
 // src/util/util.ts
 function arange(x1, x2, stp = 1, z = [], z0 = z.length) {
   if (!x2)
@@ -3134,6 +3140,7 @@ function whenever(value, callback) {
 }
 export {
   BIG_INTS,
+  BigNum,
   Bignumber,
   Deferred,
   arange,
@@ -3213,6 +3220,8 @@ export {
   percentage,
   pipe,
   plus,
+  randomArray,
+  randomNumer,
   riposte,
   sentenceCase,
   snakeCase,
@@ -3221,7 +3230,6 @@ export {
   uniq_default as uniq,
   uniqBy_default as uniqBy,
   uniqWith_default as uniqWith,
-  unum,
   unwrap,
   values_default as values,
   whenever,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hairy/utils",
   "type": "module",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Library for anywhere",
   "author": "Hairyf <wwu710632@gmail.com>",
   "license": "MIT",