@planarcat/js-toolkit 1.0.0

package/dist/date/formatDate.d.ts

@@ -0,0 +1,41 @@
+import { DateInput, DateFormatOptions } from '../types/date';
+/**
+ * 格式化日期对象
+ *
+ * @example
+ * ```typescript
+ * import { formatDate } from '@planarcat/js-toolkit';
+ *
+ * // 基本使用
+ * formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss');
+ * // 返回: "2023-12-25 14:30:45"
+ *
+ * // 自定义格式
+ * formatDate('2023-12-25', 'YYYY年MM月DD日');
+ * // 返回: "2023年12月25日"
+ *
+ * // 显示周几
+ * formatDate(new Date(), 'HH:mm', { showWeekday: true });
+ * // 返回: "周一 14:30"
+ *
+ * // 英文环境
+ * formatDate(new Date(), 'dd', { locale: 'en-US' });
+ * // 返回: "Mon"
+ *
+ * // 自定义格式化器
+ * formatDate(new Date(), '第Q季度', {
+ *   customFormatters: {
+ *     '第Q季度': (date) => `第${Math.floor((date.getMonth() + 3) / 3)}季度`
+ *   }
+ * });
+ * // 返回: "第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;
+//# sourceMappingURL=formatDate.d.ts.map

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

@@ -0,0 +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"}

package/dist/date/formatDate.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../utils/constants");
+/**
+ * 将各种输入类型安全地转换为 Date 对象
+ * @param input - 日期输入
+ * @returns 转换后的 Date 对象，无效输入返回当前时间
+ * @internal
+ */
+function safeParseDate(input) {
+    if (input instanceof Date && !isNaN(input.getTime())) {
+        return input;
+    }
+    if (typeof input === 'string' || typeof input === 'number') {
+        const date = new Date(input);
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    // 无效输入返回当前时间
+    console.warn(`Invalid date input: ${input}, using current date instead.`);
+    return new Date();
+}
+/**
+ * 计算一年中的第几周 (ISO 8601)
+ * @param date - 日期对象
+ * @returns 周数
+ * @internal
+ */
+function getWeekNumber(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const dayNum = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+}
+/**
+ * 获取本地化的星期几
+ * @param weekday - 星期几 (0-6)
+ * @param options - 格式化选项
+ * @returns 本地化的星期几字符串
+ * @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];
+}
+/**
+ * 格式化日期对象
+ *
+ * @example
+ * ```typescript
+ * import { formatDate } from '@planarcat/js-toolkit';
+ *
+ * // 基本使用
+ * formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss');
+ * // 返回: "2023-12-25 14:30:45"
+ *
+ * // 自定义格式
+ * formatDate('2023-12-25', 'YYYY年MM月DD日');
+ * // 返回: "2023年12月25日"
+ *
+ * // 显示周几
+ * formatDate(new Date(), 'HH:mm', { showWeekday: true });
+ * // 返回: "周一 14:30"
+ *
+ * // 英文环境
+ * formatDate(new Date(), 'dd', { locale: 'en-US' });
+ * // 返回: "Mon"
+ *
+ * // 自定义格式化器
+ * formatDate(new Date(), '第Q季度', {
+ *   customFormatters: {
+ *     '第Q季度': (date) => `第${Math.floor((date.getMonth() + 3) / 3)}季度`
+ *   }
+ * });
+ * // 返回: "第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 = {}) {
+    const date = safeParseDate(input);
+    const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
+    // 获取日期各部分
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+    const hours = date.getHours();
+    const minutes = date.getMinutes();
+    const seconds = date.getSeconds();
+    const milliseconds = date.getMilliseconds();
+    const weekday = date.getDay();
+    const quarter = Math.floor((date.getMonth() + 3) / 3);
+    const weekNumber = getWeekNumber(date);
+    // 12小时制
+    const hours12 = hours % 12 || 12;
+    const ampm = hours < 12 ? 'AM' : 'PM';
+    const ampmLower = ampm.toLowerCase();
+    // 1. 首先处理完整的单词标记（如 timestamp）
+    let result = formatStr;
+    // 优先替换 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');
+            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),
+    };
+    Object.entries(multiCharReplacements).forEach(([token, value]) => {
+        // 使用单词边界或字符串边界来确保精确匹配
+        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,
+    };
+    Object.entries(singleCharReplacements).forEach(([token, value]) => {
+        // 单字符需要更精确的匹配：前面是边界或特定字符，后面不是相同字符
+        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;
+//# sourceMappingURL=formatDate.js.map

package/dist/date/formatDate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @planarcat/js-toolkit - 现代化的 JavaScript/TypeScript 工具库
+ *
+ * @module @planarcat/js-toolkit
+ */
+export { default as formatDate } from './date/formatDate';
+export type { DateFormatOptions, DateInput } from './types/date';
+export declare const VERSION = "__VERSION__";
+export declare const LIBRARY_NAME = "@planarcat/js-toolkit";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @planarcat/js-toolkit - 现代化的 JavaScript/TypeScript 工具库
+ *
+ * @module @planarcat/js-toolkit
+ */
+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;
+// 日期相关工具
+var formatDate_1 = require("./date/formatDate");
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return __importDefault(formatDate_1).default; } });
+// 工具库元数据
+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

@@ -0,0 +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"}

package/dist/types/date.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 日期格式化选项接口
+ */
+export interface DateFormatOptions {
+    /**
+     * 时区设置
+     * @default 'local'
+     */
+    timeZone?: 'local' | 'utc';
+    /**
+     * 语言环境
+     * @default 'zh-CN'
+     */
+    locale?: string;
+    /**
+     * 是否显示周几
+     * @default false
+     */
+    showWeekday?: boolean;
+    /**
+     * 自定义周几显示格式
+     * @default '周'
+     */
+    weekdayFormat?: string;
+    /**
+     * 自定义格式化处理器
+     */
+    customFormatters?: Record<string, (date: Date) => string>;
+}
+/**
+ * 支持的格式化标记
+ */
+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 DateInput = Date | string | number | null | undefined;
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/date.js

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

package/dist/types/date.js.map

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

package/dist/types/index.d.ts

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

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

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

package/dist/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// 导出所有类型
+__exportStar(require("./date"), exports);
+// 后续添加更多类型
+// export * from './number';
+// export * from './function';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 默认格式化选项
+ */
+export declare const DEFAULT_DATE_FORMAT_OPTIONS: {
+    timeZone: "local";
+    locale: string;
+    showWeekday: boolean;
+    weekdayFormat: string;
+};
+/**
+ * 周几中英文映射
+ */
+export declare const WEEKDAY_MAP: Record<string, string[]>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEEKDAY_MAP = exports.DEFAULT_DATE_FORMAT_OPTIONS = void 0;
+/**
+ * 默认格式化选项
+ */
+exports.DEFAULT_DATE_FORMAT_OPTIONS = {
+    timeZone: 'local',
+    locale: 'zh-CN',
+    showWeekday: false,
+    weekdayFormat: '周',
+};
+/**
+ * 周几中英文映射
+ */
+exports.WEEKDAY_MAP = {
+    zh: ['日', '一', '二', '三', '四', '五', '六'],
+    en: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+};
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@planarcat/js-toolkit",
+  "version": "1.0.0",
+  "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" \"__tests__/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "prepare": "husky",
+    "prepublishOnly": "npm run lint && npm test && npm run build",
+    "clean": "rimraf dist coverage"
+  },
+  "keywords": [
+    "javascript",
+    "typescript",
+    "utility",
+    "toolkit",
+    "format-date",
+    "type-safe"
+  ],
+  "author": "planarcat",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/planarcat/js-toolkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/planarcat/js-toolkit/issues"
+  },
+  "homepage": "https://github.com/planarcat/js-toolkit#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^25.0.7",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "lint-staged": "^13.3.0",
+    "prettier": "^3.7.4",
+    "rimraf": "^5.0.10",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.3.3"
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "\"*.{js,ts,tsx}\"": "[\"eslint --fix\", \"prettier --write\"]"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}