@planarcat/js-toolkit 1.0.0 → 1.2.0

package/README.md

@@ -0,0 +1,164 @@
+# @planarcat/js-toolkit
+
+一个现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数。
+
+## 特性
+
+- 🚀 **类型安全**: 完整的 TypeScript 支持，提供完整的类型定义
+- 📦 **轻量级**: 零依赖，体积小巧
+- 🎯 **高性能**: 优化的算法实现
+- 🔧 **现代化**: 使用最新的 JavaScript/TypeScript 特性
+- 📚 **学习性质**: 代码清晰，适合学习和参考
+
+## 安装
+
+```bash
+# 使用 npm
+npm install @planarcat/js-toolkit
+
+# 使用 yarn
+yarn add @planarcat/js-toolkit
+
+# 使用 pnpm
+pnpm add @planarcat/js-toolkit
+```
+
+## 快速开始
+
+### 日期格式化
+
+```typescript
+import { formatDate } from '@planarcat/js-toolkit';
+
+// 基本使用
+console.log(formatDate(new Date()));
+// 输出: "2023-12-25 14:30:45"
+
+// 自定义格式
+console.log(formatDate('2023-12-25', 'YYYY年MM月DD日'));
+// 输出: "2023年12月25日"
+
+// 使用 dd 标记显示周几
+console.log(formatDate(new Date(), 'dd HH:mm'));
+// 输出: "周一 14:30"
+
+// 英文环境
+console.log(formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' }));
+// 输出: "Monday 14:30"
+```
+
+### 函数防抖
+
+```typescript
+import { debounce } from '@planarcat/js-toolkit';
+
+// 创建防抖函数
+const debouncedFn = debounce(() => {
+  console.log('函数执行了！');
+}, { delay: 500 });
+
+// 多次调用，只会执行最后一次
+debouncedFn();
+debouncedFn();
+debouncedFn();
+// 500ms 后执行一次
+```
+
+## API 文档
+
+详细的 API 文档请查看 [docs/](docs/) 目录下的模块文档：
+
+- [日期格式化](docs/functions/formatDate.md)
+- [函数防抖](docs/functions/debounce.md)
+- [类型定义](docs/interfaces/)
+
+### 生成文档
+
+```bash
+# 生成 API 文档
+npm run docs
+
+# 监听模式生成文档
+npm run docs:watch
+```
+
+## 开发
+
+### 项目结构
+
+```
+src/
+├── date/
+│   └── formatDate.ts      # 日期格式化函数
+├── types/
+│   ├── date.ts            # 日期相关类型定义
+│   └── index.ts           # 类型导出
+├── utils/
+│   └── constants.ts       # 常量定义
+└── index.ts               # 主入口文件
+```
+
+### 开发命令
+
+```bash
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+
+# 运行测试
+npm test
+
+# 运行测试（监听模式）
+npm run test:watch
+
+# 代码检查
+npm run lint
+
+# 代码格式化
+npm run format
+
+# 清理构建文件
+npm run clean
+```
+
+### 测试
+
+项目使用 Jest 进行单元测试，测试文件位于 `__tests__/` 目录。
+
+```bash
+# 运行所有测试
+npm test
+
+# 生成测试覆盖率报告
+npm run test:coverage
+```
+
+## 贡献
+
+欢迎贡献代码！请遵循以下步骤：
+
+1. Fork 本仓库
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add some amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 许可证
+
+本项目基于 MIT 许可证开源 - 查看 [LICENSE](LICENSE) 文件了解详情。
+
+## 作者
+
+- **planarcat** - [GitHub](https://github.com/planarcat)
+
+## 更新日志
+
+### v1.0.0
+
+- ✨ 初始版本发布
+- ✨ 实现日期格式化功能 `formatDate`
+- ✨ 完整的 TypeScript 类型支持
+- ✨ 单元测试覆盖
+- ✨ 构建和发布配置

package/dist/date/formatDate.d.ts

@@ -1,26 +1,34 @@
-import { DateInput, DateFormatOptions } from '../types/date';
+import { DateInput, DateFormatOptions } from "../types/date";
 /**
  * 格式化日期对象
  *
+ * @param input - 要格式化的日期输入，可以是 Date 对象、时间戳、日期字符串
+ * @param formatStr - 格式化字符串，支持 YYYY-MM-DD HH:mm:ss 等标记，默认为 'YYYY-MM-DD HH:mm:ss'
+ * @param options - 格式化选项
+ * @param options.timeZone - 时区设置，默认为 'local'
+ * @param options.locale - 语言环境，默认为 'zh-CN'
+ * @param options.customFormatters - 自定义格式化处理器
+ * @returns 格式化后的日期字符串
+ *
  * @example
  * ```typescript
  * import { formatDate } from '@planarcat/js-toolkit';
  *
- * // 基本使用
- * formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss');
+ * // 基本使用（默认格式 'YYYY-MM-DD HH:mm:ss'）
+ * formatDate(new Date());
  * // 返回: "2023-12-25 14:30:45"
  *
  * // 自定义格式
  * formatDate('2023-12-25', 'YYYY年MM月DD日');
  * // 返回: "2023年12月25日"
  *
- * // 显示周几
- * formatDate(new Date(), 'HH:mm', { showWeekday: true });
+ * // 使用 dd 标记显示周几
+ * formatDate(new Date(), 'dd HH:mm');
  * // 返回: "周一 14:30"
  *
- * // 英文环境
- * formatDate(new Date(), 'dd', { locale: 'en-US' });
- * // 返回: "Mon"
+ * // 英文环境显示周几
+ * formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' });
+ * // 返回: "Monday 14:30"
  *
  * // 自定义格式化器
  * formatDate(new Date(), '第Q季度', {
@@ -30,11 +38,6 @@ import { DateInput, DateFormatOptions } from '../types/date';
  * });
  * // 返回: "第4季度"
  * ```
- *
- * @param input - 要格式化的日期输入，可以是 Date 对象、时间戳、日期字符串
- * @param formatStr - 格式化字符串，支持 YYYY-MM-DD HH:mm:ss 等标记
- * @param options - 格式化选项
- * @returns 格式化后的日期字符串
  */
 declare function formatDate(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
 export default formatDate;

package/dist/date/formatDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA2D7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,iBAAS,UAAU,CACjB,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,MAAM,CAwFR;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA4D7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,UAAU,CACjB,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,MAAM,CAuFR;AAED,eAAe,UAAU,CAAC"}

package/dist/date/formatDate.js

@@ -11,7 +11,7 @@ function safeParseDate(input) {
     if (input instanceof Date && !isNaN(input.getTime())) {
         return input;
     }
-    if (typeof input === 'string' || typeof input === 'number') {
+    if (typeof input === "string" || typeof input === "number") {
         const date = new Date(input);
         if (!isNaN(date.getTime())) {
             return date;
@@ -42,32 +42,40 @@ function getWeekNumber(date) {
  * @internal
  */
 function getLocalizedWeekday(weekday, options) {
-    const lang = options.locale?.split('-')[0] || 'zh';
-    return constants_1.WEEKDAY_MAP[lang]?.[weekday]
-        || constants_1.WEEKDAY_MAP.zh[weekday];
+    const lang = options.locale?.split("-")[0] || "zh";
+    return (constants_1.WEEKDAY_MAP[lang]?.[weekday] ||
+        constants_1.WEEKDAY_MAP.zh[weekday]);
 }
 /**
  * 格式化日期对象
  *
+ * @param input - 要格式化的日期输入，可以是 Date 对象、时间戳、日期字符串
+ * @param formatStr - 格式化字符串，支持 YYYY-MM-DD HH:mm:ss 等标记，默认为 'YYYY-MM-DD HH:mm:ss'
+ * @param options - 格式化选项
+ * @param options.timeZone - 时区设置，默认为 'local'
+ * @param options.locale - 语言环境，默认为 'zh-CN'
+ * @param options.customFormatters - 自定义格式化处理器
+ * @returns 格式化后的日期字符串
+ *
  * @example
  * ```typescript
  * import { formatDate } from '@planarcat/js-toolkit';
  *
- * // 基本使用
- * formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss');
+ * // 基本使用（默认格式 'YYYY-MM-DD HH:mm:ss'）
+ * formatDate(new Date());
  * // 返回: "2023-12-25 14:30:45"
  *
  * // 自定义格式
  * formatDate('2023-12-25', 'YYYY年MM月DD日');
  * // 返回: "2023年12月25日"
  *
- * // 显示周几
- * formatDate(new Date(), 'HH:mm', { showWeekday: true });
+ * // 使用 dd 标记显示周几
+ * formatDate(new Date(), 'dd HH:mm');
  * // 返回: "周一 14:30"
  *
- * // 英文环境
- * formatDate(new Date(), 'dd', { locale: 'en-US' });
- * // 返回: "Mon"
+ * // 英文环境显示周几
+ * formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' });
+ * // 返回: "Monday 14:30"
  *
  * // 自定义格式化器
  * formatDate(new Date(), '第Q季度', {
@@ -77,13 +85,8 @@ function getLocalizedWeekday(weekday, options) {
  * });
  * // 返回: "第4季度"
  * ```
- *
- * @param input - 要格式化的日期输入，可以是 Date 对象、时间戳、日期字符串
- * @param formatStr - 格式化字符串，支持 YYYY-MM-DD HH:mm:ss 等标记
- * @param options - 格式化选项
- * @returns 格式化后的日期字符串
  */
-function formatDate(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
+function formatDate(input, formatStr = "YYYY-MM-DD HH:mm:ss", options = {}) {
     const date = safeParseDate(input);
     const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
     // 获取日期各部分
@@ -99,66 +102,61 @@ function formatDate(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
     const weekNumber = getWeekNumber(date);
     // 12小时制
     const hours12 = hours % 12 || 12;
-    const ampm = hours < 12 ? 'AM' : 'PM';
+    const ampm = hours < 12 ? "AM" : "PM";
     const ampmLower = ampm.toLowerCase();
     // 1. 首先处理完整的单词标记（如 timestamp）
     let result = formatStr;
     // 优先替换 timestamp，避免被拆解
-    if (result.includes('timestamp')) {
+    if (result.includes("timestamp")) {
         result = result.replace(/timestamp/g, date.getTime().toString());
     }
     // 2. 应用自定义格式化器（优先级最高）
     if (mergedOptions.customFormatters) {
         Object.entries(mergedOptions.customFormatters).forEach(([token, formatter]) => {
-            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
+            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, "g");
             result = result.replace(regex, formatter(date));
         });
     }
     // 3. 替换多字符标记（2-4个字符）
     const multiCharReplacements = {
-        'YYYY': year.toString().padStart(4, '0'),
-        'YY': year.toString().slice(-2),
-        'MM': month.toString().padStart(2, '0'),
-        'DD': day.toString().padStart(2, '0'),
-        'HH': hours.toString().padStart(2, '0'),
-        'hh': hours12.toString().padStart(2, '0'),
-        'mm': minutes.toString().padStart(2, '0'),
-        'ss': seconds.toString().padStart(2, '0'),
-        'SSS': milliseconds.toString().padStart(3, '0'),
-        'WW': weekNumber.toString().padStart(2, '0'),
-        'dd': getLocalizedWeekday(weekday, mergedOptions),
+        YYYY: year.toString().padStart(4, "0"),
+        YY: year.toString().slice(-2),
+        MM: month.toString().padStart(2, "0"),
+        DD: day.toString().padStart(2, "0"),
+        HH: hours.toString().padStart(2, "0"),
+        hh: hours12.toString().padStart(2, "0"),
+        mm: minutes.toString().padStart(2, "0"),
+        ss: seconds.toString().padStart(2, "0"),
+        SSS: milliseconds.toString().padStart(3, "0"),
+        WW: weekNumber.toString().padStart(2, "0"),
+        dd: getLocalizedWeekday(weekday, mergedOptions),
     };
     Object.entries(multiCharReplacements).forEach(([token, value]) => {
         // 使用单词边界或字符串边界来确保精确匹配
-        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
+        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, "g");
         result = result.replace(regex, value);
     });
     // 4. 替换单字符标记（使用更精确的匹配）
     const singleCharReplacements = {
-        'Y': year.toString(),
-        'M': month.toString(),
-        'D': day.toString(),
-        'H': hours.toString(),
-        'h': hours12.toString(),
-        'm': minutes.toString(),
-        's': seconds.toString(),
-        'W': weekNumber.toString(),
-        'd': weekday.toString(),
-        'Q': quarter.toString(),
-        'A': ampm,
-        'a': ampmLower,
+        Y: year.toString(),
+        M: month.toString(),
+        D: day.toString(),
+        H: hours.toString(),
+        h: hours12.toString(),
+        m: minutes.toString(),
+        s: seconds.toString(),
+        W: weekNumber.toString(),
+        d: weekday.toString(),
+        Q: quarter.toString(),
+        A: ampm,
+        a: ampmLower,
     };
     Object.entries(singleCharReplacements).forEach(([token, value]) => {
         // 单字符需要更精确的匹配：前面是边界或特定字符，后面不是相同字符
-        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
+        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, "g");
         result = result.replace(regex, value);
     });
-    // 添加周几前缀
-    if (mergedOptions.showWeekday) {
-        const weekdayStr = getLocalizedWeekday(weekday, mergedOptions);
-        result = `${mergedOptions.weekdayFormat}${weekdayStr} ${result}`;
-    }
     return result;
 }
 exports.default = formatDate;

package/dist/date/formatDate.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"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"}

package/dist/function/debounce.d.ts

@@ -0,0 +1,11 @@
+import { DebounceOptions, DebouncedFunction } from "@/types/debounce";
+/**
+ * 将函数进行防抖处理
+ * @param fn - 需要防抖处理的函数
+ * @param options - 配置选项
+ * @param options.delay - 防抖延迟时间，默认500ms
+ * @returns 防抖处理后的函数，带有cancel方法
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, options?: DebounceOptions): DebouncedFunction<T>;
+export default debounce;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/function/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/function/debounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;;;GAMG;AACH,iBAAS,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACzD,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,CAAC,CAAC,CAAC,CA4BtB;AAED,eAAe,QAAQ,CAAC"}

package/dist/function/debounce.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 将函数进行防抖处理
+ * @param fn - 需要防抖处理的函数
+ * @param options - 配置选项
+ * @param options.delay - 防抖延迟时间，默认500ms
+ * @returns 防抖处理后的函数，带有cancel方法
+ */
+function debounce(fn, options = {}) {
+    const { delay = 500 } = options;
+    let timer = null;
+    const debounced = function (...args) {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        const self = this;
+        timer = setTimeout(() => {
+            fn.apply(self, args);
+        }, delay);
+    };
+    debounced.cancel = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    return debounced;
+}
+exports.default = debounce;
+//# sourceMappingURL=debounce.js.map

package/dist/function/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/function/debounce.ts"],"names":[],"mappings":";;AAEA;;;;;;GAMG;AACH,SAAS,QAAQ,CACf,EAAK,EACL,UAA2B,EAAE;IAE7B,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAEhC,IAAI,KAAK,GAA0B,IAAI,CAAC;IAExC,MAAM,SAAS,GAAG,UAEhB,GAAG,IAAmB;QAEtB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAyB,CAAC;IAE1B,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACtB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kBAAe,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -3,8 +3,10 @@
  *
  * @module @planarcat/js-toolkit
  */
-export { default as formatDate } from './date/formatDate';
-export type { DateFormatOptions, DateInput } from './types/date';
+export { default as formatDate } from "./date/formatDate";
+export type { DateFormatOptions, DateInput } from "./types/date";
+export { default as debounce } from "./function/debounce";
+export type { DebounceOptions, DebouncedFunction } from "./types/debounce";
 export declare const VERSION = "__VERSION__";
 export declare const LIBRARY_NAME = "@planarcat/js-toolkit";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjE,eAAO,MAAM,OAAO,gBAAgB,CAAC;AACrC,eAAO,MAAM,YAAY,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,eAAO,MAAM,OAAO,gBAAgB,CAAC;AACrC,eAAO,MAAM,YAAY,0BAA0B,CAAC"}

package/dist/index.js

@@ -8,14 +8,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIBRARY_NAME = exports.VERSION = exports.formatDate = void 0;
+exports.LIBRARY_NAME = exports.VERSION = exports.debounce = exports.formatDate = void 0;
 // 日期相关工具
 var formatDate_1 = require("./date/formatDate");
 Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return __importDefault(formatDate_1).default; } });
+// 函数相关工具
+var debounce_1 = require("./function/debounce");
+Object.defineProperty(exports, "debounce", { enumerable: true, get: function () { return __importDefault(debounce_1).default; } });
 // 工具库元数据
-exports.VERSION = '__VERSION__'; // 构建时替换
-exports.LIBRARY_NAME = '@planarcat/js-toolkit';
+exports.VERSION = "__VERSION__"; // 构建时替换
+exports.LIBRARY_NAME = "@planarcat/js-toolkit";
 // 工具函数（后续添加）
 // export { default as toNumber } from './number/toNumber';
-// export { default as debounce } from './function/debounce';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,SAAS;AACT,gDAA0D;AAAjD,yHAAA,OAAO,OAAc;AAG9B,SAAS;AACI,QAAA,OAAO,GAAG,aAAa,CAAC,CAAC,QAAQ;AACjC,QAAA,YAAY,GAAG,uBAAuB,CAAC;AAEpD,aAAa;AACb,2DAA2D;AAC3D,6DAA6D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,SAAS;AACT,gDAA0D;AAAjD,yHAAA,OAAO,OAAc;AAG9B,SAAS;AACT,gDAA0D;AAAjD,qHAAA,OAAO,OAAY;AAG5B,SAAS;AACI,QAAA,OAAO,GAAG,aAAa,CAAC,CAAC,QAAQ;AACjC,QAAA,YAAY,GAAG,uBAAuB,CAAC;AAEpD,aAAa;AACb,2DAA2D"}

package/dist/types/date.d.ts

@@ -6,22 +6,12 @@ export interface DateFormatOptions {
      * 时区设置
      * @default 'local'
      */
-    timeZone?: 'local' | 'utc';
+    timeZone?: "local" | "utc";
     /**
      * 语言环境
      * @default 'zh-CN'
      */
     locale?: string;
-    /**
-     * 是否显示周几
-     * @default false
-     */
-    showWeekday?: boolean;
-    /**
-     * 自定义周几显示格式
-     * @default '周'
-     */
-    weekdayFormat?: string;
     /**
      * 自定义格式化处理器
      */
@@ -30,7 +20,7 @@ export interface DateFormatOptions {
 /**
  * 支持的格式化标记
  */
-export type DateFormatToken = 'YYYY' | 'YY' | 'MM' | 'M' | 'DD' | 'D' | 'HH' | 'H' | 'hh' | 'h' | 'mm' | 'm' | 'ss' | 's' | 'SSS' | 'A' | 'a' | 'd' | 'dd' | 'WW' | 'W' | 'Q' | 'timestamp';
+export type DateFormatToken = "YYYY" | "YY" | "MM" | "M" | "DD" | "D" | "HH" | "H" | "hh" | "h" | "mm" | "m" | "ss" | "s" | "SSS" | "A" | "a" | "d" | "dd" | "WW" | "W" | "Q" | "timestamp";
 /**
  * 可接受的日期输入类型
  */

package/dist/types/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/types/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GAAG,IAAI,GACb,IAAI,GAAG,GAAG,GACV,IAAI,GAAG,GAAG,GACV,IAAI,GAAG,GAAG,GACV,IAAI,GAAG,GAAG,GACV,IAAI,GAAG,GAAG,GACV,IAAI,GAAG,GAAG,GACV,KAAK,GACL,GAAG,GAAG,GAAG,GACT,GAAG,GACH,IAAI,GACJ,IAAI,GAAG,GAAG,GACV,GAAG,GACH,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/types/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,KAAK,GACL,GAAG,GACH,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,GAAG,GACH,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/dist/types/debounce.d.ts

@@ -0,0 +1,18 @@
+export interface DebounceOptions {
+    /**
+     * 防抖延迟时间，默认500ms
+     */
+    delay?: number;
+}
+/**
+ * 防抖处理后的函数接口
+ * @template T - 函数类型
+ */
+export interface DebouncedFunction<T extends (...args: unknown[]) => unknown> {
+    (...args: Parameters<T>): void;
+    /**
+     * 取消当前正在执行的函数调用
+     */
+    cancel(): void;
+}
+//# sourceMappingURL=debounce.d.ts.map

package/dist/types/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/types/debounce.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO;IAC1E,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB"}

package/dist/types/debounce.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=debounce.js.map

package/dist/types/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/types/debounce.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
-export * from './date';
+export * from "./date";
+export * from "./debounce";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/dist/types/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // 导出所有类型
 __exportStar(require("./date"), exports);
+__exportStar(require("./debounce"), exports);
 // 后续添加更多类型
 // export * from './number';
 // export * from './function';

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS;AACT,yCAAuB;AACvB,WAAW;AACX,4BAA4B;AAC5B,8BAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS;AACT,yCAAuB;AACvB,6CAA2B;AAC3B,WAAW;AACX,4BAA4B;AAC5B,8BAA8B"}

package/dist/utils/constants.d.ts

@@ -4,8 +4,6 @@
 export declare const DEFAULT_DATE_FORMAT_OPTIONS: {
     timeZone: "local";
     locale: string;
-    showWeekday: boolean;
-    weekdayFormat: string;
 };
 /**
  * 周几中英文映射

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;CAKvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGhD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAGvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAWhD,CAAC"}

package/dist/utils/constants.js

@@ -5,16 +5,22 @@ exports.WEEKDAY_MAP = exports.DEFAULT_DATE_FORMAT_OPTIONS = void 0;
  * 默认格式化选项
  */
 exports.DEFAULT_DATE_FORMAT_OPTIONS = {
-    timeZone: 'local',
-    locale: 'zh-CN',
-    showWeekday: false,
-    weekdayFormat: '周',
+    timeZone: "local",
+    locale: "zh-CN",
 };
 /**
  * 周几中英文映射
  */
 exports.WEEKDAY_MAP = {
-    zh: ['日', '一', '二', '三', '四', '五', '六'],
-    en: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+    zh: ["周日", "周一", "周二", "周三", "周四", "周五", "周六"],
+    en: [
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday",
+    ],
 };
 //# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,QAAQ,EAAE,OAAgB;IAC1B,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,GAAG;CACnB,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA6B;IACnD,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACvC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;CACtD,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,QAAQ,EAAE,OAAgB;IAC1B,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA6B;IACnD,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAC9C,EAAE,EAAE;QACF,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,WAAW;QACX,UAAU;QACV,QAAQ;QACR,UAAU;KACX;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planarcat/js-toolkit",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,9 @@
     "format:check": "prettier --check \"src/**/*.ts\" \"__tests__/**/*.ts\"",
     "prepare": "husky",
     "prepublishOnly": "npm run lint && npm test && npm run build",
-    "clean": "rimraf dist coverage"
+    "clean": "rimraf dist coverage",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch"
   },
   "keywords": [
     "javascript",
@@ -57,6 +59,8 @@
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "ts-node-dev": "^2.0.0",
+    "typedoc": "^0.28.16",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.3.3"
   },
   "lint-staged": {