@hairy/utils 1.0.21 → 1.5.0

package/dist/index.js

@@ -0,0 +1,312 @@
+// src/number/index.ts
+import Bignumber from "bignumber.js";
+var BIG_INTS = {
+  t: { v: 10 ** 12, d: 13, n: "t" },
+  b: { v: 10 ** 9, d: 10, n: "b" },
+  m: { v: 10 ** 6, d: 7, n: "m" },
+  k: { v: 10 ** 3, d: 4, n: "k" }
+};
+function unum(num = "0") {
+  return new Bignumber(numerfix(num));
+}
+function gte(num, n) {
+  return unum(num).gte(unum(n));
+}
+function gt(num, n) {
+  return unum(num).gt(unum(n));
+}
+function lte(num, n) {
+  return unum(num).lte(unum(n));
+}
+function lt(num, n) {
+  return unum(num).lt(unum(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);
+}
+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);
+}
+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))
+    return "0";
+  return unum(count).div(unum(total)).times(100).toFixed(decimal2, rounding);
+}
+function zerofill(value, n = 2, type = "positive") {
+  const _value = integer(value);
+  if (_value.length >= n)
+    return value;
+  const zero = "0".repeat(n - _value.length);
+  if (type === "positive")
+    return zero + value;
+  if (type === "reverse")
+    return zero + value;
+  return "";
+}
+function zeromove(value) {
+  return value.toString().replace(/\.?0+$/, "");
+}
+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) {
+  return new Bignumber(numerfix(value)).toFixed(0);
+}
+function decimal(value, n = 2) {
+  let [integer2, decimal2] = numerfix(value).split(".");
+  if (n <= 0)
+    return integer2;
+  if (!decimal2)
+    decimal2 = "0";
+  decimal2 = decimal2.slice(0, n);
+  decimal2 = decimal2 + "0".repeat(n - decimal2.length);
+  return `${integer2}.${decimal2}`;
+}
+function parseNumeric(num, delimiters = ["t", "b", "m"]) {
+  const mappings = [
+    delimiters.includes("t") && ((n) => gte(n, BIG_INTS.t.v) && BIG_INTS.t),
+    delimiters.includes("b") && ((n) => gte(n, BIG_INTS.b.v) && lt(n, BIG_INTS.t.v) && BIG_INTS.b),
+    delimiters.includes("m") && ((n) => gte(n, BIG_INTS.m.v) && lt(n, BIG_INTS.b.v) && BIG_INTS.m),
+    delimiters.includes("k") && ((n) => gte(n, BIG_INTS.k.v) && lt(n, BIG_INTS.m.v) && BIG_INTS.k)
+  ];
+  let options;
+  for (const analy of mappings) {
+    const opts = analy && analy(unum(num).toFixed(0));
+    opts && (options = opts);
+  }
+  return options || { v: 1, d: 0, n: "" };
+}
+function formatNumeric(value = "0", options) {
+  const {
+    rounding = Bignumber.ROUND_DOWN,
+    delimiters,
+    format,
+    decimals = 2
+  } = options || {};
+  const config = parseNumeric(value, delimiters || []);
+  let number = unum(value).div(config.v).toFormat(decimals, rounding, {
+    decimalSeparator: ".",
+    groupSeparator: ",",
+    groupSize: 3,
+    secondaryGroupSize: 0,
+    fractionGroupSeparator: " ",
+    fractionGroupSize: 0,
+    ...format
+  });
+  number = options?.zeromove ? zeromove(number) : number;
+  return `${number}${config.n}`;
+}
+
+// src/util/compose.ts
+var compose = (...fns) => fns.reduceRight((v, f) => f(v));
+
+// src/util/converts.ts
+function formToObject(formData) {
+  return Object.fromEntries(formData.entries());
+}
+function objectToForm(object) {
+  const formData = new FormData();
+  for (const [key, value] of Object.entries(object)) formData.append(key, value);
+  return formData;
+}
+
+// src/util/deferred.ts
+var Deferred = class extends Promise {
+  resolve;
+  reject;
+  constructor() {
+    let _resolve, _reject;
+    super((resolve_, reject_) => {
+      _resolve = resolve_;
+      _reject = reject_;
+    });
+    this.resolve = (value) => {
+      _resolve(value);
+      return this;
+    };
+    this.reject = (reason) => {
+      _reject(reason);
+      return this;
+    };
+  }
+};
+
+// src/util/delay.ts
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/util/is.ts
+var isBrowser = () => typeof window !== "undefined";
+var isWeex = () => typeof WXEnvironment !== "undefined" && !!WXEnvironment.platform;
+var weexPlatform = () => isWeex() && WXEnvironment.platform.toLowerCase();
+var UA = () => isBrowser() && window.navigator.userAgent.toLowerCase() || "";
+var isIE = () => UA() && /msie|trident/.test(UA());
+var isIE9 = () => UA() && UA().indexOf("msie 9.0") > 0;
+var isIE11 = () => isBrowser() && navigator.userAgent.includes("Trident") && navigator.userAgent.includes("rv:11.0");
+var isEdge = () => UA() && UA().indexOf("edge/") > 0;
+var isAndroid = () => UA() && UA().indexOf("android") > 0 || weexPlatform() === "android";
+var isIOS = () => UA() && /iphone|ipad|ipod|ios/.test(UA()) || weexPlatform() === "ios";
+var isChrome = () => UA() && /chrome\/\d+/.test(UA()) && !isEdge();
+var isPhantomJS = () => UA() && /phantomjs/.test(UA());
+var isFF = () => typeof UA() === "string" && UA().match(/firefox\/(\d+)/);
+var isMobile = () => isBrowser() && navigator.userAgent.toLowerCase().includes("mobile");
+var isObject = (value) => typeof value === "object" && !Array.isArray(value);
+var isNumber = (value) => typeof value === "number";
+var isString = (value) => typeof value === "string";
+var isArray = (value) => Array.isArray(value);
+var isNull = (value) => value === null;
+var isPlainObject = (value) => typeof value === "object" && value !== null && value.constructor === Object;
+var isFormData = (value) => isObject(value) && isBrowser() && value instanceof FormData;
+var isWindow = (value) => typeof window !== "undefined" && toString.call(value) === "[object Window]";
+
+// src/util/noop.ts
+var noop = () => {
+};
+
+// src/util/p-pipe.ts
+function pPipe(...functions) {
+  if (functions.length === 0)
+    throw new Error("Expected at least one argument");
+  return async (input) => {
+    let currentValue = input;
+    for (const function_ of functions)
+      currentValue = await function_(currentValue);
+    return currentValue;
+  };
+}
+
+// src/util/pipe.ts
+var pipe = (...fns) => fns.reduce((v, f) => f(v));
+
+// src/util/util.ts
+function arange(x1, x2, stp = 1, z = [], z0 = z.length) {
+  if (!x2)
+    x1 -= x2 = x1;
+  for (let z1 = z0 + Math.max(Math.ceil((++x2 - x1) / stp), 0); z0 < z1; x1 += stp)
+    z[z0++] = x1;
+  return z;
+}
+function loop(fn) {
+  async function next(ms) {
+    await delay(ms);
+    return fn(next);
+  }
+  return fn(next);
+}
+function riposte(...args) {
+  for (const [cond, value] of args) {
+    if (cond)
+      return value;
+  }
+  return void 0;
+}
+function unwrap(value) {
+  return typeof value === "function" ? value() : value;
+}
+function whenever(value, callback) {
+  return value ? callback(value) : void 0;
+}
+
+// src/size/index.ts
+function formatUnit(value, unit = "px") {
+  if (!(isString(value) || isNumber(value)))
+    return "";
+  value = String(value);
+  return /\D/.test(value) ? value : value + unit;
+}
+function formatSize(dimension, unit) {
+  const _formatUnit = (value) => formatUnit(value, unit);
+  if (typeof dimension === "string" || typeof dimension === "number")
+    return { width: _formatUnit(dimension), height: _formatUnit(dimension) };
+  if (Array.isArray(dimension))
+    return { width: _formatUnit(dimension[0]), height: _formatUnit(dimension[1]) };
+  if (typeof dimension === "object")
+    return { width: _formatUnit(dimension.width), height: _formatUnit(dimension.height) };
+  return { width: "", height: "" };
+}
+
+// src/string/index.ts
+function cover(value, mode, symbol = "*") {
+  return value.slice(0, mode[0]) + symbol.repeat(mode[1]) + value.slice(-mode[2]);
+}
+
+// src/typeof/index.ts
+function getTypeof(target) {
+  const value = Object.prototype.toString.call(target).slice(8, -1).toLocaleLowerCase();
+  return value;
+}
+function isTypeof(target, type) {
+  return getTypeof(target) === type;
+}
+export {
+  BIG_INTS,
+  Bignumber,
+  Deferred,
+  UA,
+  arange,
+  average,
+  compose,
+  cover,
+  decimal,
+  delay,
+  formToObject,
+  formatNumeric,
+  formatSize,
+  formatUnit,
+  getTypeof,
+  gt,
+  gte,
+  integer,
+  isAndroid,
+  isArray,
+  isBrowser,
+  isChrome,
+  isEdge,
+  isFF,
+  isFormData,
+  isIE,
+  isIE11,
+  isIE9,
+  isIOS,
+  isMobile,
+  isNull,
+  isNumber,
+  isObject,
+  isPhantomJS,
+  isPlainObject,
+  isString,
+  isTypeof,
+  isWeex,
+  isWindow,
+  loop,
+  lt,
+  lte,
+  noop,
+  numerfix,
+  objectToForm,
+  pPipe,
+  parseNumeric,
+  percentage,
+  pipe,
+  plus,
+  riposte,
+  unum,
+  unwrap,
+  weexPlatform,
+  whenever,
+  zerofill,
+  zeromove
+};

package/package.json

@@ -1,38 +1,44 @@
-{
-  "name": "@hairy/utils",
-  "version": "1.0.21",
-  "license": "MIT",
-  "dependencies": {
-    "dayjs": "^1.10.6",
-    "lodash-es": "^4"
-  },
-  "devDependencies": {
-    "@types/lodash-es": "^4"
-  },
-  "main": "./index.cjs.js",
-  "types": "./index.d.ts",
-  "module": "./index.esm.js",
-  "unpkg": "./index.iife.min.js",
-  "jsdelivr": "./index.iife.min.js",
-  "author": "Anthony Fu<https://github.com/TuiMao233>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/TuiMao233/hairylib.git"
-  },
-  "bugs": {
-    "url": "https://github.com/TuiMao233/hairylib/issues"
-  },
-  "homepage": "https://github.com/TuiMao233/hairylib#readme",
-  "description": "Utilities core for Mr.Mao",
-  "exports": {
-    ".": {
-      "import": "./index.esm.js",
-      "require": "./index.cjs.js"
-    },
-    "./*": "./*"
-  },
-  "gitHead": "9682f0fdcb39beaab4b6b44a3d6eba020f98bd39",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@hairy/utils",
+  "type": "module",
+  "version": "1.5.0",
+  "description": "Library for anywhere",
+  "author": "Hairyf <wwu710632@gmail.com>",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/hairyf",
+  "homepage": "https://github.com/hairyf/hairylib#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hairyf/hairylib.git"
+  },
+  "bugs": "https://github.com/hairyf/hairylib/issues",
+  "keywords": [],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "jsdelivr": "./dist/index.global.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "bignumber.js": "^9.1.2",
+    "p-pipe": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "tsx src/index.ts"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.global.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./*": "./*"
+  }
+}

package/index.cjs.js

@@ -1,130 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var lodashEs = require('lodash-es');
-
-const formDataToObject = (formData) => {
-  return Object.fromEntries(formData.entries());
-};
-const objectToFormData = (object) => {
-  const formData = new FormData();
-  for (const [key, value] of Object.entries(object)) {
-    formData.append(key, String(value));
-  }
-  return formData;
-};
-const pickByParams = (params, filter, deep = false) => {
-  deep && lodashEs.forIn(params, (value, key) => {
-    if (lodashEs.isObject(value))
-      params[key] = pickByParams(params[key], filter, deep);
-  });
-  const pickValue = lodashEs.pickBy(params, (value) => !filter.includes(value));
-  if (Array.isArray(params)) {
-    return Object.values(pickValue);
-  }
-  return pickValue;
-};
-const objectFlat = (object, deep = 1) => {
-  const flatDeep = (object2, deep2 = 1) => {
-    let _object = {};
-    for (const [key, value] of Object.entries(object2)) {
-      if (lodashEs.isPlainObject(value)) {
-        _object = { ..._object, ...deep2 > 0 ? flatDeep(value, deep2 - 1) : value };
-        continue;
-      }
-      _object[key] = value;
-    }
-    return _object;
-  };
-  return flatDeep(object, deep);
-};
-
-const toUnit = (value, unit = "px") => {
-  const empty = !(lodashEs.isString(value) || lodashEs.isNumber(value));
-  if (empty)
-    return "";
-  return lodashEs.isString(value) && /\D/g.test(value) ? value : value + unit;
-};
-const toSize = (size, unit) => {
-  if (typeof size === "string" || typeof size === "number") {
-    return { width: toUnit(size, unit), height: toUnit(size, unit) };
-  }
-  if (Array.isArray(size)) {
-    return { width: toUnit(size[0], unit), height: toUnit(size[1], unit) };
-  }
-  if (typeof size === "object") {
-    return { width: toUnit(size.width, unit), height: toUnit(size.height, unit) };
-  }
-  return { width: "", height: "" };
-};
-
-const urlParamsAnaly = (url, params) => {
-  const queryString = Object.keys(params).map((key) => `${key}=${params[key]}`);
-  if (queryString.length > 0)
-    url += "?" + queryString.join("&");
-  return url;
-};
-const awaitPromise = (ms = 1e3) => {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-};
-const generateArray = (start, end) => {
-  start = Number(start);
-  end = Number(end);
-  end = end > start ? end : start;
-  return [...new Array(end + 1).keys()].slice(start);
-};
-const checkedTypeof = (target) => {
-  const value = Object.prototype.toString.call(target).slice(8, -1).toLocaleLowerCase();
-  return value;
-};
-const assert = (condition, ...infos) => {
-  if (!condition)
-    console.warn(...infos);
-  return condition;
-};
-
-const isBrowser = typeof window !== "undefined";
-const isWeex = typeof WXEnvironment !== "undefined" && !!WXEnvironment.platform;
-const weexPlatform = isWeex && WXEnvironment.platform.toLowerCase();
-const UA = isBrowser && window.navigator.userAgent.toLowerCase();
-const isIE = UA && /msie|trident/.test(UA);
-const isIE9 = UA && UA.indexOf("msie 9.0") > 0;
-const isIE11 = isBrowser && navigator.userAgent.includes("Trident") && navigator.userAgent.includes("rv:11.0");
-const isEdge = UA && UA.indexOf("edge/") > 0;
-const isAndroid = UA && UA.indexOf("android") > 0 || weexPlatform === "android";
-const isIOS = UA && /iphone|ipad|ipod|ios/.test(UA) || weexPlatform === "ios";
-const isChrome = UA && /chrome\/\d+/.test(UA) && !isEdge;
-const isPhantomJS = UA && /phantomjs/.test(UA);
-const isFF = typeof UA == "string" && UA.match(/firefox\/(\d+)/);
-const isMobile = isBrowser && navigator.userAgent.toLowerCase().includes("mobile");
-const isFormData = (value) => lodashEs.isObject(value) && value instanceof FormData;
-const isWindow = (value) => typeof window !== "undefined" && toString.call(value) === "[object Window]";
-
-exports.UA = UA;
-exports.assert = assert;
-exports.awaitPromise = awaitPromise;
-exports.checkedTypeof = checkedTypeof;
-exports.formDataToObject = formDataToObject;
-exports.generateArray = generateArray;
-exports.isAndroid = isAndroid;
-exports.isBrowser = isBrowser;
-exports.isChrome = isChrome;
-exports.isEdge = isEdge;
-exports.isFF = isFF;
-exports.isFormData = isFormData;
-exports.isIE = isIE;
-exports.isIE11 = isIE11;
-exports.isIE9 = isIE9;
-exports.isIOS = isIOS;
-exports.isMobile = isMobile;
-exports.isPhantomJS = isPhantomJS;
-exports.isWeex = isWeex;
-exports.isWindow = isWindow;
-exports.objectFlat = objectFlat;
-exports.objectToFormData = objectToFormData;
-exports.pickByParams = pickByParams;
-exports.toSize = toSize;
-exports.toUnit = toUnit;
-exports.urlParamsAnaly = urlParamsAnaly;
-exports.weexPlatform = weexPlatform;

package/index.d.ts

@@ -1,121 +0,0 @@
-/**
- * 将 formData 转换为 object
- * @param formData
- */
-declare const formDataToObject: (formData: FormData) => Record<string, string>;
-/**
- * 将 object 转换为 formData
- * @param object
- */
-declare const objectToFormData: (object: Record<string, string | number>) => FormData;
-/**
- * 过滤对象|数组中 filter 中的值
- * @param params
- * @param filter
- */
-declare const pickByParams: <T extends object>(params: T, filter: any[], deep?: boolean) => Partial<T>;
-/**
- * 对象扁平化处理
- * @param object 对象
- * @param deep 深度
- */
-declare const objectFlat: (object: Record<string, any>, deep?: number) => Record<string, any>;
-
-declare type PlainObject = {
-    [key: string]: any;
-};
-declare type LooseNumber = string | number;
-declare type Key = string | number | symbol;
-declare type DeepReadonly<T> = {
-    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
-};
-declare type DeepRequired<T> = {
-    [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : T[P];
-};
-declare type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-declare type DeepKeyof<T> = T extends object ? keyof T | DeepKeyof<T[keyof T]> : never;
-declare type DeepReplace<T, K = unknown, V = unknown> = {
-    [P in keyof T]: K extends P ? V : DeepReplace<T[P], K, V>;
-};
-declare type Option<L extends Key = 'label', V extends Key = 'value', C extends Key = 'children'> = {
-    [P in L]?: string;
-} & {
-    [P in V]?: LooseNumber;
-} & {
-    [P in C]?: Option<L, V, C>[];
-};
-
-/**
- * 如果有单位，如百分比，px单位等，直接返回，如果是纯粹的数值，则加上px单位
- * @param value 尺寸
- * @param unit 单位
- * @returns string
- */
-declare const toUnit: (value: LooseNumber, unit?: string) => string;
-/** size 转换配置 */
-declare type toSizeOption = LooseNumber | [LooseNumber, LooseNumber] | {
-    width: LooseNumber;
-    height: LooseNumber;
-};
-/**
- * 将 size 转换为宽高
- * @param size { toSizeOption }
- * @returns
- */
-declare const toSize: (size: toSizeOption, unit?: string | undefined) => {
-    width: string;
-    height: string;
-};
-
-/**
- * 地址参数计算
- * @param url 传入url
- * @param params 请求参数
- * @returns 拼接url
- */
-declare const urlParamsAnaly: (url: string, params: Record<string, any>) => string;
-/**
- * 自定义 Promise 等待
- * @param code 等待时间
- */
-declare const awaitPromise: (ms?: number) => Promise<unknown>;
-/**
- * 生成递进的数组
- * @param start 开始数值
- * @param end 结束数值
- * @returns 递进的数组
- */
-declare const generateArray: (start: number, end: number) => number[];
-/**
- * 获取数据类型
- * @param target 检测对象
- * @returns 返回字符串
- */
-declare const checkedTypeof: (target: any) => "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function" | "null" | "regexp";
-/**
- * 不符合预期则弹出警告
- * @param condition
- * @param infos
- */
-declare const assert: (condition: boolean, ...infos: any[]) => boolean;
-
-declare const isBrowser: boolean;
-declare const isWeex: boolean;
-declare const weexPlatform: any;
-declare const UA: string | false;
-declare const isIE: boolean | "";
-declare const isIE9: boolean | "";
-declare const isIE11: boolean;
-declare const isEdge: boolean | "";
-declare const isAndroid: boolean;
-declare const isIOS: boolean;
-declare const isChrome: boolean | "";
-declare const isPhantomJS: boolean | "";
-declare const isFF: false | RegExpMatchArray | null;
-declare const isMobile: boolean;
-declare const isFormData: (value: any) => value is FormData;
-declare const isWindow: (value: any) => value is Window;
-
-export { DeepKeyof, DeepPartial, DeepReadonly, DeepReplace, DeepRequired, Key, LooseNumber, Option, PlainObject, UA, assert, awaitPromise, checkedTypeof, formDataToObject, generateArray, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isWeex, isWindow, objectFlat, objectToFormData, pickByParams, toSize, toSizeOption, toUnit, urlParamsAnaly, weexPlatform };