@base-web-kits/base-tools-ts 0.8.6 → 0.8.8

package/README.md

@@ -1,32 +1,43 @@
-# Base Tools
-
-web前端团队常用工具库，包含`ts`、`web`、`react`、`vue`、`uni`模块。
-
-**安装**
-
-用哪个模块就安装哪个,模块之间不会相互依赖
-
-- `npm i @base-web-kits/base-tools-ts`
-- `npm i @base-web-kits/base-tools-web`
-- `npm i @base-web-kits/base-tools-react`
-- `npm i @base-web-kits/base-tools-vue`
-- `npm i @base-web-kits/base-tools-uni`
-
-**快速使用**
-
-```ts
-// 通用 TS 模块
-import { toDayjs, getUrlParam, toMaskPhone } from '@base-web-kits/base-tools-ts';
-
-// Web 模块
-import { copyText, isPC, download, setCookie } from '@base-web-kits/base-tools-web';
-
-// React 模块
-import { useCountDown } from '@base-web-kits/base-tools-react';
-
-// Vue 模块
-import { useResizeObserver } from '@base-web-kits/base-tools-vue';
-
-// Uni 模块
-import { chooseMedia, toPayWx } from '@base-web-kits/base-tools-uni';
-```
+# Base Tools
+
+web前端团队常用工具库，包含`ts`、`web`、`react`、`vue`、`uni`模块。
+
+**安装**
+
+按需安装即可,模块之间不相互依赖
+
+```js
+// 通用 TS 模块
+npm i @base-web-kits/base-tools-ts
+
+// Web 模块
+npm i @base-web-kits/base-tools-web
+
+// React 模块
+npm i @base-web-kits/base-tools-react
+
+// Vue 模块
+npm i @base-web-kits/base-tools-vue
+
+// Uni 模块
+npm i @base-web-kits/base-tools-uni
+```
+
+**快速使用**
+
+```ts
+// 通用 TS 模块
+import { toDayjs, getUrlParam, toMaskPhone } from '@base-web-kits/base-tools-ts';
+
+// Web 模块
+import { copyText, isPC, download, setCookie } from '@base-web-kits/base-tools-web';
+
+// React 模块
+import { useCountDown } from '@base-web-kits/base-tools-react';
+
+// Vue 模块
+import { useResizeObserver } from '@base-web-kits/base-tools-vue';
+
+// Uni 模块
+import { chooseMedia, toPayWx } from '@base-web-kits/base-tools-uni';
+```

package/dist/day/index.d.ts

@@ -22,7 +22,7 @@ type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
  * d.startOf('day').valueOf(); // 当日零点
  * d.startOf('month').format('YYYY-MM-DD HH:mm:ss'); // 月初 "2025-12-01 00:00:00"
  * d.endOf('month').format('YYYY-MM-DD HH:mm:ss'); // 月末 "2025-12-31 23:59:59"
- * d.fromNow(); // 相对时间文案: “刚刚”、“x分钟前/后”、“x小时前/后”、“x天前/后”、“x月前/后”、“x年前/后”
+ * d.fromNow(); // “刚刚”、“x分钟前/后”、“x小时前/后”、“x天前/后”、“x月前/后”、“x年前/后”
  * d.isSame(t, 'day'); // 是否与t在同一天
  * d.diff(); // 与当前时间相差的毫秒数
  * d.diff(t); // 与t相差的毫秒数

package/dist/index.cjs

@@ -59,7 +59,7 @@ __export(index_exports, {
   bind: () => bind_default,
   bindAll: () => bindAll_default,
   bindKey: () => bindKey_default,
-  buildOssUrl: () => buildOssUrl,
+  buildOSSUrl: () => buildOSSUrl,
   camelCase: () => camelCase_default,
   capitalize: () => capitalize_default,
   castArray: () => castArray_default,
@@ -82,7 +82,7 @@ __export(index_exports, {
   create: () => create_default,
   createRandId: () => createRandId,
   createTimeRandId: () => createTimeRandId,
-  createUuid: () => createUuid,
+  createUUID: () => createUUID,
   curry: () => curry_default,
   curryRight: () => curryRight_default,
   dayjs: () => import_dayjs.default,
@@ -147,11 +147,11 @@ __export(index_exports, {
   getDateRangeBefore: () => getDateRangeBefore,
   getFileSuffix: () => getFileSuffix,
   getFileType: () => getFileType,
+  getOSSAudio: () => getOSSAudio,
+  getOSSHls: () => getOSSHls,
+  getOSSImg: () => getOSSImg,
+  getOSSVideo: () => getOSSVideo,
   getObjectKeys: () => getObjectKeys,
-  getOssAudio: () => getOssAudio,
-  getOssHls: () => getOssHls,
-  getOssImg: () => getOssImg,
-  getOssVideo: () => getOssVideo,
   getQnAudio: () => getQnAudio,
   getQnHls: () => getQnHls,
   getQnImg: () => getQnImg,
@@ -7935,7 +7935,7 @@ function toMaskName(name) {
 }
 
 // src/ts/string/random.ts
-function createUuid() {
+function createUUID() {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
     const r = Math.random() * 16 | 0, v = c === "x" ? r : r & 3 | 8;
     return v.toString(16);
@@ -7999,32 +7999,32 @@ function getFileType(fileName) {
 }
 
 // src/ts/url/oss/index.ts
-function getOssImg(src, option) {
-  return buildOssUrl(src, "image", option);
+function getOSSImg(src, option) {
+  return buildOSSUrl(src, "image", option);
 }
-function getOssVideo(src, option) {
-  return buildOssUrl(src, "video", option);
+function getOSSVideo(src, option) {
+  return buildOSSUrl(src, "video", option);
 }
-function getOssAudio(src, option) {
-  return buildOssUrl(src, "audio", option);
+function getOSSAudio(src, option) {
+  return buildOSSUrl(src, "audio", option);
 }
-function getOssHls(src, option) {
-  return buildOssUrl(src, "hls", option);
+function getOSSHls(src, option) {
+  return buildOSSUrl(src, "hls", option);
 }
-function buildOssUrl(src, type, option) {
+function buildOSSUrl(src, type, option) {
   if (!src || !option) return src;
   if (src.startsWith("blob:")) return src;
   if (src.includes(".svg")) return src;
   const segs = [];
   for (const [k, v] of Object.entries(option)) {
-    const seg = k === "watermark" ? getWatermark(v) : getOssSegs(k, v);
+    const seg = k === "watermark" ? getWatermark(v) : getOSSSegs(k, v);
     if (seg) segs.push(seg);
   }
   if (!segs.length) return src;
   const base = src.split("?")[0];
   return `${base}?x-oss-process=${type}/${segs.join("/")}`;
 }
-function getOssSegs(type, option) {
+function getOSSSegs(type, option) {
   if (!option && option !== 0) return "";
   if (option === true) return type;
   if (typeof option === "number" || typeof option === "string") return `${type},${option}`;
@@ -8036,7 +8036,7 @@ function getWatermark(w) {
   if (w.image) w.image = toBase64Url(w.image);
   if (w.text) w.text = toBase64Url(w.text);
   if (w.type) w.type = toBase64Url(w.type);
-  return getOssSegs("watermark", w);
+  return getOSSSegs("watermark", w);
 }
 function toBase64Url(s) {
   let b64 = "";
@@ -8559,7 +8559,7 @@ function isLongitude(s) {
   bind,
   bindAll,
   bindKey,
-  buildOssUrl,
+  buildOSSUrl,
   camelCase,
   capitalize,
   castArray,
@@ -8582,7 +8582,7 @@ function isLongitude(s) {
   create,
   createRandId,
   createTimeRandId,
-  createUuid,
+  createUUID,
   curry,
   curryRight,
   dayjs,
@@ -8647,11 +8647,11 @@ function isLongitude(s) {
   getDateRangeBefore,
   getFileSuffix,
   getFileType,
+  getOSSAudio,
+  getOSSHls,
+  getOSSImg,
+  getOSSVideo,
   getObjectKeys,
-  getOssAudio,
-  getOssHls,
-  getOssImg,
-  getOssVideo,
   getQnAudio,
   getQnHls,
   getQnImg,

package/dist/index.js

@@ -7495,7 +7495,7 @@ function toMaskName(name) {
 }
 
 // src/ts/string/random.ts
-function createUuid() {
+function createUUID() {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
     const r = Math.random() * 16 | 0, v = c === "x" ? r : r & 3 | 8;
     return v.toString(16);
@@ -7559,32 +7559,32 @@ function getFileType(fileName) {
 }
 
 // src/ts/url/oss/index.ts
-function getOssImg(src, option) {
-  return buildOssUrl(src, "image", option);
+function getOSSImg(src, option) {
+  return buildOSSUrl(src, "image", option);
 }
-function getOssVideo(src, option) {
-  return buildOssUrl(src, "video", option);
+function getOSSVideo(src, option) {
+  return buildOSSUrl(src, "video", option);
 }
-function getOssAudio(src, option) {
-  return buildOssUrl(src, "audio", option);
+function getOSSAudio(src, option) {
+  return buildOSSUrl(src, "audio", option);
 }
-function getOssHls(src, option) {
-  return buildOssUrl(src, "hls", option);
+function getOSSHls(src, option) {
+  return buildOSSUrl(src, "hls", option);
 }
-function buildOssUrl(src, type, option) {
+function buildOSSUrl(src, type, option) {
   if (!src || !option) return src;
   if (src.startsWith("blob:")) return src;
   if (src.includes(".svg")) return src;
   const segs = [];
   for (const [k, v] of Object.entries(option)) {
-    const seg = k === "watermark" ? getWatermark(v) : getOssSegs(k, v);
+    const seg = k === "watermark" ? getWatermark(v) : getOSSSegs(k, v);
     if (seg) segs.push(seg);
   }
   if (!segs.length) return src;
   const base = src.split("?")[0];
   return `${base}?x-oss-process=${type}/${segs.join("/")}`;
 }
-function getOssSegs(type, option) {
+function getOSSSegs(type, option) {
   if (!option && option !== 0) return "";
   if (option === true) return type;
   if (typeof option === "number" || typeof option === "string") return `${type},${option}`;
@@ -7596,7 +7596,7 @@ function getWatermark(w) {
   if (w.image) w.image = toBase64Url(w.image);
   if (w.text) w.text = toBase64Url(w.text);
   if (w.type) w.type = toBase64Url(w.type);
-  return getOssSegs("watermark", w);
+  return getOSSSegs("watermark", w);
 }
 function toBase64Url(s) {
   let b64 = "";
@@ -8118,7 +8118,7 @@ export {
   bind_default as bind,
   bindAll_default as bindAll,
   bindKey_default as bindKey,
-  buildOssUrl,
+  buildOSSUrl,
   camelCase_default as camelCase,
   capitalize_default as capitalize,
   castArray_default as castArray,
@@ -8141,7 +8141,7 @@ export {
   create_default as create,
   createRandId,
   createTimeRandId,
-  createUuid,
+  createUUID,
   curry_default as curry,
   curryRight_default as curryRight,
   dayjs,
@@ -8206,11 +8206,11 @@ export {
   getDateRangeBefore,
   getFileSuffix,
   getFileType,
+  getOSSAudio,
+  getOSSHls,
+  getOSSImg,
+  getOSSVideo,
   getObjectKeys,
-  getOssAudio,
-  getOssHls,
-  getOssImg,
-  getOssVideo,
   getQnAudio,
   getQnHls,
   getQnImg,

package/dist/string/random.d.ts

@@ -2,9 +2,9 @@
  * 生成UUID
  * @returns UUID字符串
  * @example
- * const uuid = createUuid() // '7982fcfe-5721-4632-bede-6000885be57d'
+ * const uuid = createUUID() // '7982fcfe-5721-4632-bede-6000885be57d'
  */
-export declare function createUuid(): string;
+export declare function createUUID(): string;
 /**
  * 生成随机字符串id
  * - 常用于生成元素标签的id (默认加上'id_'前缀, 避免小程序中数字开头的id导致查询节点信息失败)

package/dist/url/oss/index.d.ts

@@ -1,4 +1,4 @@
-import type { OssOption, OssAudioOption, OssHlsOption, OssImgOption, OssVideoOption } from './index.d';
+import type { OSSOption, OSSAudioOption, OSSHlsOption, OSSImgOption, OSSVideoOption } from './index.d';
 export * from './index.d';
 /**
  * oss图片处理
@@ -7,26 +7,26 @@ export * from './index.d';
  * @param option 图片处理选项
  * @returns 处理后的图片URL（格式: `{src}?x-oss-process=image/xx`）
  * @example
- * 缩放: getOssImg('xx.jpg', { resize: { w: 100, h: 100 } })
- * 水印: getOssImg('xx.jpg', { watermark: { text: '水印' } });
- * 翻转: getOssImg('xx.jpg', { flip: 1 });
- * 裁剪: getOssImg('xx.jpg', { crop: { w: 100, h: 100 } });
- * 质量: getOssImg('xx.jpg', { quality: { q: 80 } });
- * 格式转换: getOssImg('xx.jpg', { format: 'jpg' });
- * 获取信息: getOssImg('xx.jpg', { info: true });
- * 自适应方向: getOssImg('xx.jpg', { 'auto-orient': 1 });
- * 内切圆: getOssImg('xx.jpg', { circle: { r: 100 } });
- * 索引切割: getOssImg('xx.jpg', { indexcrop: { x: 100 } });
- * 圆角: getOssImg('xx.jpg', { 'rounded-corners': { r: 10 } });
- * 模糊: getOssImg('xx.jpg', { blur: { r: 10, s: 10 } });
- * 旋转: getOssImg('xx.jpg', { rotate: 90 });
- * 渐进显示: getOssImg('xx.jpg', { interlace: 1 });
- * 主色调: getOssImg('xx.jpg', { 'average-hue': true });
- * 亮度: getOssImg('xx.jpg', { bright: 10 });
- * 锐化: getOssImg('xx.jpg', { sharpen: 100 });
- * 对比度: getOssImg('xx.jpg', { contrast: 100 });
+ * 缩放: getOSSImg('xx.jpg', { resize: { w: 100, h: 100 } })
+ * 水印: getOSSImg('xx.jpg', { watermark: { text: '水印' } });
+ * 翻转: getOSSImg('xx.jpg', { flip: 1 });
+ * 裁剪: getOSSImg('xx.jpg', { crop: { w: 100, h: 100 } });
+ * 质量: getOSSImg('xx.jpg', { quality: { q: 80 } });
+ * 格式转换: getOSSImg('xx.jpg', { format: 'jpg' });
+ * 获取信息: getOSSImg('xx.jpg', { info: true });
+ * 自适应方向: getOSSImg('xx.jpg', { 'auto-orient': 1 });
+ * 内切圆: getOSSImg('xx.jpg', { circle: { r: 100 } });
+ * 索引切割: getOSSImg('xx.jpg', { indexcrop: { x: 100 } });
+ * 圆角: getOSSImg('xx.jpg', { 'rounded-corners': { r: 10 } });
+ * 模糊: getOSSImg('xx.jpg', { blur: { r: 10, s: 10 } });
+ * 旋转: getOSSImg('xx.jpg', { rotate: 90 });
+ * 渐进显示: getOSSImg('xx.jpg', { interlace: 1 });
+ * 主色调: getOSSImg('xx.jpg', { 'average-hue': true });
+ * 亮度: getOSSImg('xx.jpg', { bright: 10 });
+ * 锐化: getOSSImg('xx.jpg', { sharpen: 100 });
+ * 对比度: getOSSImg('xx.jpg', { contrast: 100 });
  */
-export declare function getOssImg(src: string, option: OssImgOption): string;
+export declare function getOSSImg(src: string, option: OSSImgOption): string;
 /**
  * oss视频处理
  * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
@@ -34,15 +34,15 @@ export declare function getOssImg(src: string, option: OssImgOption): string;
  * @param option 视频处理选项
  * @returns 处理后的URL（格式: `{src}?x-oss-process=video/xx`）
  * @example
- * 视频转码: getOssVideo('xx.mp4', { convert: { format: 'mp4' } })
- * 转为动图: getOssVideo('xx.mp4', { animation: { format: 'gif' } })
- * 雪碧图: getOssVideo('xx.mp4', { sprite: { format: 'png' } })
- * 多帧截取: getOssVideo('xx.mp4', { snapshots: { count: 3 } })
- * 视频拼接: getOssVideo('xx.mp4', { concat: { list: 'a.mp4,b.mp4' } })
- * 信息查询: getOssVideo('xx.mp4', { info: true })
- * 组合操作: getOssVideo('xx.mp4', { convert: { format: 'mp4' }, snapshots: { count: 3 } })
+ * 视频转码: getOSSVideo('xx.mp4', { convert: { format: 'mp4' } })
+ * 转为动图: getOSSVideo('xx.mp4', { animation: { format: 'gif' } })
+ * 雪碧图: getOSSVideo('xx.mp4', { sprite: { format: 'png' } })
+ * 多帧截取: getOSSVideo('xx.mp4', { snapshots: { count: 3 } })
+ * 视频拼接: getOSSVideo('xx.mp4', { concat: { list: 'a.mp4,b.mp4' } })
+ * 信息查询: getOSSVideo('xx.mp4', { info: true })
+ * 组合操作: getOSSVideo('xx.mp4', { convert: { format: 'mp4' }, snapshots: { count: 3 } })
  */
-export declare function getOssVideo(src: string, option: OssVideoOption): string;
+export declare function getOSSVideo(src: string, option: OSSVideoOption): string;
 /**
  * oss音频处理
  * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
@@ -50,11 +50,11 @@ export declare function getOssVideo(src: string, option: OssVideoOption): string
  * @param option 音频处理选项
  * @returns 处理后的URL（格式: `{src}?x-oss-process=audio/xx`）
  * @example
- * 音频转码: getOssAudio('xx.mp3', { 'convert': { format: 'mp3' } })
- * 音频拼接: getOssAudio('xx.mp3', { 'concat': { list: 'a.mp3,b.mp3' } })
- * 信息查询: getOssAudio('xx.mp3', { 'info': true })
+ * 音频转码: getOSSAudio('xx.mp3', { 'convert': { format: 'mp3' } })
+ * 音频拼接: getOSSAudio('xx.mp3', { 'concat': { list: 'a.mp3,b.mp3' } })
+ * 信息查询: getOSSAudio('xx.mp3', { 'info': true })
  */
-export declare function getOssAudio(src: string, option: OssAudioOption): string;
+export declare function getOSSAudio(src: string, option: OSSAudioOption): string;
 /**
  * oss直播处理（边转边播 HLS）
  * 参考官方文档: https://help.aliyun.com/zh/oss/user-guide/audio-and-video-processing/
@@ -62,10 +62,10 @@ export declare function getOssAudio(src: string, option: OssAudioOption): string
  * @param option HLS 选项（或布尔）
  * @returns 处理后的URL（格式: `{src}?x-oss-process=hls/xx`）
  * @example
- * 生成播放列表: getOssHls('xx.mp4', { 'm3u8': true })
- * 配置参数: getOssHls('xx.mp4', { 'm3u8': { playlist: 1, segtime: 6 } })
+ * 生成播放列表: getOSSHls('xx.mp4', { 'm3u8': true })
+ * 配置参数: getOSSHls('xx.mp4', { 'm3u8': { playlist: 1, segtime: 6 } })
  */
-export declare function getOssHls(src: string, option: OssHlsOption): string;
+export declare function getOSSHls(src: string, option: OSSHlsOption): string;
 /**
  * 构造oss处理地址
  * @param src 原始地址
@@ -73,5 +73,5 @@ export declare function getOssHls(src: string, option: OssHlsOption): string;
  * @param option oss处理选项
  * @returns 处理后的URL（格式: `{src}?x-oss-process={type}/{segs.join('/')}`）
  */
-export declare function buildOssUrl(src: string, type: string, option: OssOption): string;
+export declare function buildOSSUrl(src: string, type: string, option: OSSOption): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/validator/index.d.ts

@@ -180,7 +180,7 @@ export declare function isMilitaryId(s: string): boolean;
  * @param s 银行卡号
  * @returns 是否通过 Luhn 校验
  * @example
- * isBankCard('6222 0201 2345 6789') // true/false
+ * isBankCard('6222 0201 2345 6789') // true
  */
 export declare function isBankCard(s: string): boolean;
 /**

package/package.json

@@ -1,59 +1,60 @@
-{
-  "name": "@base-web-kits/base-tools-ts",
-  "version": "0.8.6",
-  "type": "module",
-  "sideEffects": false,
-  "description": "Independent TS utilities package built from src/ts.",
-  "keywords": [
-    "base-tools",
-    "ts",
-    "utilities",
-    "thin-wrapper"
-  ],
-  "license": "MIT",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": {
-        "import": "./dist/index.d.ts",
-        "require": "./dist/index.d.ts",
-        "default": "./dist/index.d.ts"
-      },
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
-      },
-      "default": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "typesVersions": {
-    "*": {
-      "*": [
-        "./dist/*"
-      ],
-      "index": [
-        "./dist/index.d.ts"
-      ]
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "lodash-es": "^4.17.21",
-    "@types/lodash-es": "^4.17.12",
-    "bignumber.js": "^9.1.2",
-    "dayjs": "^1.11.19"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org"
-  }
-}
+{
+  "name": "@base-web-kits/base-tools-ts",
+  "version": "0.8.8",
+  "sideEffects": false,
+  "description": "Independent TS utilities package built from src/ts.",
+  "keywords": [
+    "base-tools",
+    "ts",
+    "utilities",
+    "thin-wrapper"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./index": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./index.js": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*"
+      ],
+      "index": [
+        "./dist/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "lodash-es": "^4.17.21",
+    "@types/lodash-es": "^4.17.12",
+    "bignumber.js": "^9.1.2",
+    "dayjs": "^1.11.19"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  }
+}