@zlikemario/helper 1.0.0 → 1.0.1

package/dist/number.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const i=require("bignumber.js");i.config({EXPONENTIAL_AT:99});function s(e,t=!1){if(!["string","number","bigint"].includes(typeof e))return!1;try{e=i(e).toFixed()}catch{return!1}return t?/^-?\d+$/.test(e):/^-?\d+(\.\d+)?$/.test(e)}function l(e,t=3,n=i.ROUND_HALF_UP){if(!s(e))return String(e);const r=1e3;let o=i(e);if(o.abs().lt(r))return o.toFixed(t,n).replace(/\.0+$/,"");const u=["","K","M","B"];let a=0;for(;++a<u.length&&(o=o.div(r),!o.abs().lt(r)););return o.toFixed(1,n)+u[a]}function c(e){return s(e)?i(e).toFormat({decimalSeparator:".",groupSeparator:",",groupSize:3}):String(e)}function f(e,t=2,n=!1){if(!s(e))return String(e);const r=i(e).times(100).toFixed(t);return parseFloat(r)+(n?"":"%")}function g(e,t=4){return s(e)?i(e).dp(t).toString():String(e)}const d=(e,t=4)=>{if(!s(e))return String(e);const n=i(e).toFixed().match(/(-?)(\d+)\.(0+)(\d+)/);if(!n)return c(i(e).dp(t).toFixed());const[,r,o,u,a]=n;return u.length>3?`${r}${c(o)}.0{${u.length}}${a.slice(0,t-2).replace(/0+$/,"")}`:`${r}${c(o)}.${u}${a.slice(0,t-2).replace(/0+$/,"")}`},b=e=>e.reduce((t,n)=>t.plus(n),i(0)).toString();function p(e,t){const n=typeof t=="function"?r=>t(r):r=>r?.[t]??"0";return e.reduce((r,o)=>r.plus(n(o)),i(0)).toString()}exports.BigNumber=i;exports.default=i;exports.formatPrecision=g;exports.isNumber=s;exports.readabilityNumber=c;exports.readableNumber=d;exports.simplifyNumber=l;exports.sum=b;exports.sumBy=p;exports.toPercentage=f;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const n=require("bignumber.js");n.config({EXPONENTIAL_AT:99});function c(t){const e=String(t);if(!e.includes(".")||/e/i.test(e))return e;const r=e.replace(/(\.\d*?)0+$/,"$1");return r.endsWith(".")?r.slice(0,-1):r}function s(t,e=!1){if(typeof t=="object"&&t!==null)return!1;try{const r=n(t);return e?r.isInteger():r.isFinite()}catch{return!1}}function f(t,e=3,r=n.ROUND_HALF_UP){if(!s(t))return String(t);const i=1e3;let o=n(t);if(o.abs().lt(i))return c(o.toFixed(e,r));const u=["","K","M","B"];let a=0;for(;++a<u.length&&(o=o.div(i),!o.abs().lt(i)););return c(o.toFixed(1,r))+u[a]}function l(t){return s(t)?n(t).toFormat({decimalSeparator:".",groupSeparator:",",groupSize:3}):String(t)}function d(t,e=2,r=!1){if(!s(t))return String(t);const i=n(t).times(100).toFixed(e);return parseFloat(i)+(r?"":"%")}const g=(t,e=4)=>{if(!s(t))return String(t);const r=n(t).toFixed().match(/(-?)(\d+)\.(0+)(\d+)/);if(!r)return l(n(t).dp(e).toFixed());const[,i,o,u,a]=r;return u.length>3?`${i}${l(o)}.0{${u.length}}${a.slice(0,e-2).replace(/0+$/,"")}`:`${i}${l(o)}.${u}${a.slice(0,e-2).replace(/0+$/,"")}`},b=t=>t.reduce((e,r)=>e.plus(r),n(0)).toString();function p(t,e){const r=typeof e=="function"?i=>e(i):i=>i?.[e]??"0";return t.reduce((i,o)=>i.plus(r(o)),n(0)).toString()}exports.BigNumber=n;exports.default=n;exports.isComputableNumber=s;exports.readabilityNumber=l;exports.readableNumber=g;exports.sum=b;exports.sumBy=p;exports.toPercentage=d;exports.trimFloatEndZero=c;exports.unitFormat=f;

package/dist/number.d.ts

@@ -5,21 +5,35 @@ import BigNumber from "bignumber.js";
 import type { Numberish, NumberString, MaybeUndefined } from "./types";
 export { BigNumber };
 export default BigNumber;
+/**
+ * 删除结尾不该出现的 0
+ * @returns {string}
+ * @eg [
+ *   1234.0000        =>  1234
+ *   1234.00001       =>  1234.00001
+ *   1234.100100      =>  1234.1001
+ *   1234.            =>  1234
+ * ]
+ */
+export declare function trimFloatEndZero(num: Numberish): string;
 /**
  * 判断是否为有效数字
  * @param num - 待判断的值
  * @param isInt - 是否要求为整数
  * @returns 是否为数字
+ *
+ * false：Infinity, -Infinity, NaN
+ * true： "1e10000"（非常大但有限）
  */
-export declare function isNumber(num: any, isInt?: boolean): boolean;
+export declare function isComputableNumber(num: unknown, isInt?: boolean): boolean;
 /**
  * 数字简化显示（如 1.2K, 3.4M）
  * @param num - 数字
- * @param decimal - 保留小数位
+ * @param decimals - 保留小数位
  * @param rm - 舍入模式
  * @returns 简化后的字符串
  */
-export declare function simplifyNumber(num: Numberish, decimal?: number, rm?: BigNumber.RoundingMode): string;
+export declare function unitFormat(num: Numberish, decimals?: number, rm?: BigNumber.RoundingMode): string;
 /**
  * 数字千分位分隔显示
  * @param num - 数字
@@ -34,13 +48,6 @@ export declare function readabilityNumber(num: Numberish): string;
  * @returns 百分比字符串
  */
 export declare function toPercentage(num: Numberish, precision?: number, isHiddenUnit?: boolean): string;
-/**
- * 保留指定精度
- * @param num - 数字
- * @param precision - 保留小数位
- * @returns 格式化后的字符串
- */
-export declare function formatPrecision(num: Numberish, precision?: number): string;
 /**
  * 高级可读性数字格式化（如 1,234.0{4}1）
  * @param number - 数字

package/dist/number.js

@@ -1,25 +1,31 @@
 import o from "bignumber.js";
-import { default as N, default as x } from "bignumber.js";
+import { default as h, default as m } from "bignumber.js";
 o.config({ EXPONENTIAL_AT: 99 });
+function l(t) {
+  const e = String(t);
+  if (!e.includes(".") || /e/i.test(e)) return e;
+  const r = e.replace(/(\.\d*?)0+$/, "$1");
+  return r.endsWith(".") ? r.slice(0, -1) : r;
+}
 function a(t, e = !1) {
-  if (!["string", "number", "bigint"].includes(typeof t)) return !1;
+  if (typeof t == "object" && t !== null) return !1;
   try {
-    t = o(t).toFixed();
+    const r = o(t);
+    return e ? r.isInteger() : r.isFinite();
   } catch {
     return !1;
   }
-  return e ? /^-?\d+$/.test(t) : /^-?\d+(\.\d+)?$/.test(t);
 }
-function l(t, e = 3, i = o.ROUND_HALF_UP) {
+function g(t, e = 3, r = o.ROUND_HALF_UP) {
   if (!a(t)) return String(t);
-  const r = 1e3;
+  const i = 1e3;
   let n = o(t);
-  if (n.abs().lt(r)) return n.toFixed(e, i).replace(/\.0+$/, "");
-  const s = ["", "K", "M", "B"];
-  let u = 0;
-  for (; ++u < s.length && (n = n.div(r), !n.abs().lt(r)); )
+  if (n.abs().lt(i)) return l(n.toFixed(e, r));
+  const u = ["", "K", "M", "B"];
+  let s = 0;
+  for (; ++s < u.length && (n = n.div(i), !n.abs().lt(i)); )
     ;
-  return n.toFixed(1, i) + s[u];
+  return l(n.toFixed(1, r)) + u[s];
 }
 function c(t) {
   return a(t) ? o(t).toFormat({
@@ -28,35 +34,32 @@ function c(t) {
     groupSize: 3
   }) : String(t);
 }
-function g(t, e = 2, i = !1) {
+function d(t, e = 2, r = !1) {
   if (!a(t)) return String(t);
-  const r = o(t).times(100).toFixed(e);
-  return parseFloat(r) + (i ? "" : "%");
-}
-function d(t, e = 4) {
-  return a(t) ? o(t).dp(e).toString() : String(t);
+  const i = o(t).times(100).toFixed(e);
+  return parseFloat(i) + (r ? "" : "%");
 }
 const p = (t, e = 4) => {
   if (!a(t)) return String(t);
-  const i = o(t).toFixed().match(/(-?)(\d+)\.(0+)(\d+)/);
-  if (!i)
+  const r = o(t).toFixed().match(/(-?)(\d+)\.(0+)(\d+)/);
+  if (!r)
     return c(o(t).dp(e).toFixed());
-  const [, r, n, s, u] = i;
-  return s.length > 3 ? `${r}${c(n)}.0{${s.length}}${u.slice(0, e - 2).replace(/0+$/, "")}` : `${r}${c(n)}.${s}${u.slice(0, e - 2).replace(/0+$/, "")}`;
-}, $ = (t) => t.reduce((e, i) => e.plus(i), o(0)).toString();
-function b(t, e) {
-  const i = typeof e == "function" ? (r) => e(r) : (r) => r?.[e] ?? "0";
-  return t.reduce((r, n) => r.plus(i(n)), o(0)).toString();
+  const [, i, n, u, s] = r;
+  return u.length > 3 ? `${i}${c(n)}.0{${u.length}}${s.slice(0, e - 2).replace(/0+$/, "")}` : `${i}${c(n)}.${u}${s.slice(0, e - 2).replace(/0+$/, "")}`;
+}, b = (t) => t.reduce((e, r) => e.plus(r), o(0)).toString();
+function $(t, e) {
+  const r = typeof e == "function" ? (i) => e(i) : (i) => i?.[e] ?? "0";
+  return t.reduce((i, n) => i.plus(r(n)), o(0)).toString();
 }
 export {
-  N as BigNumber,
-  x as default,
-  d as formatPrecision,
-  a as isNumber,
+  h as BigNumber,
+  m as default,
+  a as isComputableNumber,
   c as readabilityNumber,
   p as readableNumber,
-  l as simplifyNumber,
-  $ as sum,
-  b as sumBy,
-  g as toPercentage
+  b as sum,
+  $ as sumBy,
+  d as toPercentage,
+  l as trimFloatEndZero,
+  g as unitFormat
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlikemario/helper",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A utility library with number operations and common helper functions",
   "keywords": [
     "utility",