jiezhangxin-utils 0.0.1

package/LICENSE

@@ -0,0 +1,194 @@
+木兰宽松许可证，第2版
+
+木兰宽松许可证，第2版
+
+2020年1月 http://license.coscl.org.cn/MulanPSL2
+
+您对“软件”的复制、使用、修改及分发受木兰宽松许可证，第2版（“本许可证”）的如下条款的约束：
+
+0.   定义
+
+“软件” 是指由“贡献”构成的许可在“本许可证”下的程序和相关文档的集合。
+
+“贡献” 是指由任一“贡献者”许可在“本许可证”下的受版权法保护的作品。
+
+“贡献者” 是指将受版权法保护的作品许可在“本许可证”下的自然人或“法人实体”。
+
+“法人实体” 是指提交贡献的机构及其“关联实体”。
+
+“关联实体” 是指，对“本许可证”下的行为方而言，控制、受控制或与其共同受控制的机构，此处的控制是
+指有受控方或共同受控方至少50%直接或间接的投票权、资金或其他有价证券。
+
+1.   授予版权许可
+
+每个“贡献者”根据“本许可证”授予您永久性的、全球性的、免费的、非独占的、不可撤销的版权许可，您可
+以复制、使用、修改、分发其“贡献”，不论修改与否。
+
+2.   授予专利许可
+
+每个“贡献者”根据“本许可证”授予您永久性的、全球性的、免费的、非独占的、不可撤销的（根据本条规定
+撤销除外）专利许可，供您制造、委托制造、使用、许诺销售、销售、进口其“贡献”或以其他方式转移其“贡
+献”。前述专利许可仅限于“贡献者”现在或将来拥有或控制的其“贡献”本身或其“贡献”与许可“贡献”时的“软
+件”结合而将必然会侵犯的专利权利要求，不包括对“贡献”的修改或包含“贡献”的其他结合。如果您或您的“
+关联实体”直接或间接地，就“软件”或其中的“贡献”对任何人发起专利侵权诉讼（包括反诉或交叉诉讼）或
+其他专利维权行动，指控其侵犯专利权，则“本许可证”授予您对“软件”的专利许可自您提起诉讼或发起维权
+行动之日终止。
+
+3.   无商标许可
+
+“本许可证”不提供对“贡献者”的商品名称、商标、服务标志或产品名称的商标许可，但您为满足第4条规定
+的声明义务而必须使用除外。
+
+4.   分发限制
+
+您可以在任何媒介中将“软件”以源程序形式或可执行形式重新分发，不论修改与否，但您必须向接收者提供“
+本许可证”的副本，并保留“软件”中的版权、商标、专利及免责声明。
+
+5.   免责声明与责任限制
+
+“软件”及其中的“贡献”在提供时不带任何明示或默示的担保。在任何情况下，“贡献者”或版权所有者不对
+任何人因使用“软件”或其中的“贡献”而引发的任何直接或间接损失承担责任，不论因何种原因导致或者基于
+何种法律理论，即使其曾被建议有此种损失的可能性。
+
+6.   语言
+
+“本许可证”以中英文双语表述，中英文版本具有同等法律效力。如果中英文版本存在任何冲突不一致，以中文
+版为准。
+
+条款结束
+
+如何将木兰宽松许可证，第2版，应用到您的软件
+
+如果您希望将木兰宽松许可证，第2版，应用到您的新软件，为了方便接收者查阅，建议您完成如下三步：
+
+1， 请您补充如下声明中的空白，包括软件名、软件的首次发表年份以及您作为版权人的名字；
+
+2， 请您在软件包的一级目录下创建以“LICENSE”为名的文件，将整个许可证文本放入该文件中；
+
+3， 请将如下声明文本放入每个源文件的头部注释中。
+
+Copyright (c) [Year] [name of copyright holder]
+[Software Name] is licensed under Mulan PSL v2.
+You can use this software according to the terms and conditions of the Mulan
+PSL v2.
+You may obtain a copy of Mulan PSL v2 at:
+         http://license.coscl.org.cn/MulanPSL2
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+See the Mulan PSL v2 for more details.
+
+Mulan Permissive Software License，Version 2
+
+Mulan Permissive Software License，Version 2 (Mulan PSL v2)
+
+January 2020 http://license.coscl.org.cn/MulanPSL2
+
+Your reproduction, use, modification and distribution of the Software shall
+be subject to Mulan PSL v2 (this License) with the following terms and
+conditions:
+
+0. Definition
+
+Software means the program and related documents which are licensed under
+this License and comprise all Contribution(s).
+
+Contribution means the copyrightable work licensed by a particular
+Contributor under this License.
+
+Contributor means the Individual or Legal Entity who licenses its
+copyrightable work under this License.
+
+Legal Entity means the entity making a Contribution and all its
+Affiliates.
+
+Affiliates means entities that control, are controlled by, or are under
+common control with the acting entity under this License, ‘control’ means
+direct or indirect ownership of at least fifty percent (50%) of the voting
+power, capital or other securities of controlled or commonly controlled
+entity.
+
+1. Grant of Copyright License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to you a perpetual, worldwide, royalty-free, non-exclusive,
+irrevocable copyright license to reproduce, use, modify, or distribute its
+Contribution, with modification or not.
+
+2. Grant of Patent License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to you a perpetual, worldwide, royalty-free, non-exclusive,
+irrevocable (except for revocation under this Section) patent license to
+make, have made, use, offer for sale, sell, import or otherwise transfer its
+Contribution, where such patent license is only limited to the patent claims
+owned or controlled by such Contributor now or in future which will be
+necessarily infringed by its Contribution alone, or by combination of the
+Contribution with the Software to which the Contribution was contributed.
+The patent license shall not apply to any modification of the Contribution,
+and any other combination which includes the Contribution. If you or your
+Affiliates directly or indirectly institute patent litigation (including a
+cross claim or counterclaim in a litigation) or other patent enforcement
+activities against any individual or entity by alleging that the Software or
+any Contribution in it infringes patents, then any patent license granted to
+you under this License for the Software shall terminate as of the date such
+litigation or activity is filed or taken.
+
+3. No Trademark License
+
+No trademark license is granted to use the trade names, trademarks, service
+marks, or product names of Contributor, except as required to fulfill notice
+requirements in section 4.
+
+4. Distribution Restriction
+
+You may distribute the Software in any medium with or without modification,
+whether in source or executable forms, provided that you provide recipients
+with a copy of this License and retain copyright, patent, trademark and
+disclaimer statements in the Software.
+
+5. Disclaimer of Warranty and Limitation of Liability
+
+THE SOFTWARE AND CONTRIBUTION IN IT ARE PROVIDED WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL ANY CONTRIBUTOR OR
+COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT
+LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING
+FROM YOUR USE OR INABILITY TO USE THE SOFTWARE OR THE CONTRIBUTION IN IT, NO
+MATTER HOW IT’S CAUSED OR BASED ON WHICH LEGAL THEORY, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGES.
+
+6. Language
+
+THIS LICENSE IS WRITTEN IN BOTH CHINESE AND ENGLISH, AND THE CHINESE VERSION
+AND ENGLISH VERSION SHALL HAVE THE SAME LEGAL EFFECT. IN THE CASE OF
+DIVERGENCE BETWEEN THE CHINESE AND ENGLISH VERSIONS, THE CHINESE VERSION
+SHALL PREVAIL.
+
+END OF THE TERMS AND CONDITIONS
+
+How to Apply the Mulan Permissive Software License，Version 2
+(Mulan PSL v2) to Your Software
+
+To apply the Mulan PSL v2 to your work, for easy identification by
+recipients, you are suggested to complete following three steps:
+
+i. Fill in the blanks in following statement, including insert your software
+name, the year of the first publication of your software, and your name
+identified as the copyright owner;
+
+ii. Create a file named "LICENSE" which contains the whole context of this
+License in the first directory of your software package;
+
+iii. Attach the statement to the appropriate annotated syntax at the
+beginning of each source file.
+
+Copyright (c) [Year] [name of copyright holder]
+[Software Name] is licensed under Mulan PSL v2.
+You can use this software according to the terms and conditions of the Mulan
+PSL v2.
+You may obtain a copy of Mulan PSL v2 at:
+         http://license.coscl.org.cn/MulanPSL2
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+See the Mulan PSL v2 for more details.

package/README.md

@@ -0,0 +1,62 @@
+# jiezhangxin-utils
+
+A utility toolkit for Vue 3 projects, providing common functions for date handling, string manipulation, array processing, and storage management.
+
+## Installation
+npm install jiezhangxin-utils --save
+## Usage
+
+### In Vue 3 project
+// Import all utilities
+import * as jiezhangxinUtils from 'jiezhangxin-utils';
+
+// Or import specific utilities
+import { formatDate, capitalize } from 'jiezhangxin-utils';
+### Example
+// Format date
+console.log(formatDate(new Date(), 'yyyy-MM-dd HH:mm:ss'));
+
+// Capitalize string
+console.log(capitalize('hello world')); // Output: 'Hello world'
+
+// Array deduplication
+console.log(uniqueArray([1, 2, 2, 3, 3, 3])); // Output: [1, 2, 3]
+
+// Local storage
+setLocalStorage('userInfo', { name: 'John', age: 30 });
+console.log(getLocalStorage('userInfo'));
+## API Documentation
+
+### Date Utilities
+
+- `formatDate(date, format)`: Format date into string
+- `getDaysBetween(startDate, endDate)`: Get days between two dates
+- `isToday(date)`: Check if date is today
+
+### String Utilities
+
+- `trim(str)`: Remove whitespace from both ends of string
+- `capitalize(str)`: Capitalize the first letter of string
+- `maskStr(str, startLen, endLen, replaceChar)`: Mask string for privacy
+- `isEmail(str)`: Check if string is a valid email
+- `isPhone(str)`: Check if string is a valid phone number
+
+### Array Utilities
+
+- `uniqueArray(arr)`: Remove duplicates from array
+- `sortArray(arr, key, isAsc)`: Sort array
+- `groupArray(arr, key)`: Group array by key
+- `flattenArray(arr)`: Flatten nested array
+
+### Storage Utilities
+
+- `getLocalStorage(key)`: Get item from localStorage
+- `setLocalStorage(key, value)`: Set item to localStorage
+- `removeLocalStorage(key)`: Remove item from localStorage
+- `getSessionStorage(key)`: Get item from sessionStorage
+- `setSessionStorage(key, value)`: Set item to sessionStorage
+- `removeSessionStorage(key)`: Remove item from sessionStorage
+
+## License
+
+MIT

package/dist/jiezhangxin-utils.cjs.js

@@ -0,0 +1,370 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 格式化日期
+ * @param {Date|string|number} date - 日期
+ * @param {string} format - 格式字符串，例如：'yyyy-MM-dd HH:mm:ss'
+ * @returns {string} 格式化后的日期字符串
+ */
+function formatDate(date, format = 'yyyy-MM-dd') {
+  if (!date) {
+    return '';
+  }
+
+  // 处理日期参数
+  if (!(date instanceof Date)) {
+    date = new Date(date);
+  }
+
+  // 检查日期是否有效
+  if (isNaN(date.getTime())) {
+    return '';
+  }
+  const o = {
+    'M+': date.getMonth() + 1,
+    // 月份
+    'd+': date.getDate(),
+    // 日
+    'H+': date.getHours(),
+    // 小时
+    'm+': date.getMinutes(),
+    // 分
+    's+': date.getSeconds(),
+    // 秒
+    'q+': Math.floor((date.getMonth() + 3) / 3),
+    // 季度
+    'S': date.getMilliseconds() // 毫秒
+  };
+  if (/(y+)/.test(format)) {
+    format = format.replace(RegExp.$1, (date.getFullYear() + '').substr(4 - RegExp.$1.length));
+  }
+  for (const k in o) {
+    if (new RegExp('(' + k + ')').test(format)) {
+      format = format.replace(RegExp.$1, RegExp.$1.length === 1 ? o[k] : ('00' + o[k]).substr(('' + o[k]).length));
+    }
+  }
+  return format;
+}
+
+/**
+ * 获取两个日期之间的天数差
+ * @param {Date|string|number} startDate - 开始日期
+ * @param {Date|string|number} endDate - 结束日期
+ * @returns {number} 天数差
+ */
+function getDaysBetween(startDate, endDate) {
+  const start = new Date(startDate);
+  const end = new Date(endDate);
+  if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+    return 0;
+  }
+  const oneDay = 24 * 60 * 60 * 1000; // 毫秒
+  return Math.round(Math.abs((end - start) / oneDay));
+}
+
+/**
+ * 判断是否为今天
+ * @param {Date|string|number} date - 日期
+ * @returns {boolean} 是否为今天
+ */
+function isToday(date) {
+  const target = new Date(date);
+  const today = new Date();
+  return target.getDate() === today.getDate() && target.getMonth() === today.getMonth() && target.getFullYear() === today.getFullYear();
+}
+
+/**
+ * 去除字符串首尾空格
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+function trim(str) {
+  if (typeof str !== 'string') {
+    return '';
+  }
+  return str.trim();
+}
+
+/**
+ * 首字母大写
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+function capitalize(str) {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * 字符串脱敏处理
+ * @param {string} str - 输入字符串
+ * @param {number} startLen - 保留开始长度
+ * @param {number} endLen - 保留结束长度
+ * @param {string} replaceChar - 替换字符
+ * @returns {string} 脱敏后的字符串
+ */
+function maskStr(str, startLen = 3, endLen = 4, replaceChar = '*') {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  const len = str.length;
+  if (startLen + endLen >= len) {
+    return str;
+  }
+  const maskLen = len - startLen - endLen;
+  const mask = replaceChar.repeat(maskLen);
+  return str.substring(0, startLen) + mask + str.substring(len - endLen);
+}
+
+/**
+ * 判断字符串是否为邮箱格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为邮箱
+ */
+function isEmail(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/;
+  return reg.test(str);
+}
+
+/**
+ * 判断字符串是否为手机号格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为手机号
+ */
+function isPhone(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^1[3-9]\d{9}$/;
+  return reg.test(str);
+}
+
+/**
+ * 数组去重
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 去重后的数组
+ */
+function uniqueArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  return [...new Set(arr)];
+}
+
+/**
+ * 数组排序
+ * @param {Array} arr - 输入数组
+ * @param {string} key - 排序的键名（对象数组时使用）
+ * @param {boolean} isAsc - 是否升序
+ * @returns {Array} 排序后的数组
+ */
+function sortArray(arr, key, isAsc = true) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+
+  // 复制数组避免修改原数组
+  const newArr = [...arr];
+  newArr.sort((a, b) => {
+    let valueA = a;
+    let valueB = b;
+
+    // 如果指定了key，说明是对象数组
+    if (key) {
+      valueA = a[key];
+      valueB = b[key];
+    }
+
+    // 处理数字情况
+    if (typeof valueA === 'number' && typeof valueB === 'number') {
+      return isAsc ? valueA - valueB : valueB - valueA;
+    }
+
+    // 处理字符串情况
+    const strA = String(valueA).toLowerCase();
+    const strB = String(valueB).toLowerCase();
+    if (strA < strB) {
+      return isAsc ? -1 : 1;
+    }
+    if (strA > strB) {
+      return isAsc ? 1 : -1;
+    }
+    return 0;
+  });
+  return newArr;
+}
+
+/**
+ * 数组分组
+ * @param {Array} arr - 输入数组
+ * @param {Function|string} key - 分组依据的函数或键名
+ * @returns {Object} 分组后的对象
+ */
+function groupArray(arr, key) {
+  if (!Array.isArray(arr)) {
+    return {};
+  }
+  return arr.reduce((result, item) => {
+    let groupKey;
+    if (typeof key === 'function') {
+      groupKey = key(item);
+    } else if (typeof key === 'string') {
+      groupKey = item[key];
+    } else {
+      groupKey = item;
+    }
+    if (!result[groupKey]) {
+      result[groupKey] = [];
+    }
+    result[groupKey].push(item);
+    return result;
+  }, {});
+}
+
+/**
+ * 数组扁平化
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 扁平化后的数组
+ */
+function flattenArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  return arr.reduce((result, item) => {
+    return result.concat(Array.isArray(item) ? flattenArray(item) : item);
+  }, []);
+}
+
+/**
+ * 从localStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+function getLocalStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  try {
+    const value = localStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return localStorage.getItem(key);
+  }
+}
+
+/**
+ * 向localStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+function setLocalStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  try {
+    // 转换为JSON字符串存储
+    localStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从localStorage删除数据
+ * @param {string} key - 存储键名
+ */
+function removeLocalStorage(key) {
+  if (key && typeof key === 'string') {
+    localStorage.removeItem(key);
+  }
+}
+
+/**
+ * 从sessionStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+function getSessionStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  try {
+    const value = sessionStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return sessionStorage.getItem(key);
+  }
+}
+
+/**
+ * 向sessionStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+function setSessionStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  try {
+    // 转换为JSON字符串存储
+    sessionStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从sessionStorage删除数据
+ * @param {string} key - 存储键名
+ */
+function removeSessionStorage(key) {
+  if (key && typeof key === 'string') {
+    sessionStorage.removeItem(key);
+  }
+}
+
+// 导出日期工具
+
+// 工具包版本信息
+const version = '1.0.0';
+
+exports.capitalize = capitalize;
+exports.flattenArray = flattenArray;
+exports.formatDate = formatDate;
+exports.getDaysBetween = getDaysBetween;
+exports.getLocalStorage = getLocalStorage;
+exports.getSessionStorage = getSessionStorage;
+exports.groupArray = groupArray;
+exports.isEmail = isEmail;
+exports.isPhone = isPhone;
+exports.isToday = isToday;
+exports.maskStr = maskStr;
+exports.removeLocalStorage = removeLocalStorage;
+exports.removeSessionStorage = removeSessionStorage;
+exports.setLocalStorage = setLocalStorage;
+exports.setSessionStorage = setSessionStorage;
+exports.sortArray = sortArray;
+exports.trim = trim;
+exports.uniqueArray = uniqueArray;
+exports.version = version;

package/dist/jiezhangxin-utils.esm.js

@@ -0,0 +1,348 @@
+/**
+ * 格式化日期
+ * @param {Date|string|number} date - 日期
+ * @param {string} format - 格式字符串，例如：'yyyy-MM-dd HH:mm:ss'
+ * @returns {string} 格式化后的日期字符串
+ */
+function formatDate(date, format = 'yyyy-MM-dd') {
+  if (!date) {
+    return '';
+  }
+
+  // 处理日期参数
+  if (!(date instanceof Date)) {
+    date = new Date(date);
+  }
+
+  // 检查日期是否有效
+  if (isNaN(date.getTime())) {
+    return '';
+  }
+  const o = {
+    'M+': date.getMonth() + 1,
+    // 月份
+    'd+': date.getDate(),
+    // 日
+    'H+': date.getHours(),
+    // 小时
+    'm+': date.getMinutes(),
+    // 分
+    's+': date.getSeconds(),
+    // 秒
+    'q+': Math.floor((date.getMonth() + 3) / 3),
+    // 季度
+    'S': date.getMilliseconds() // 毫秒
+  };
+  if (/(y+)/.test(format)) {
+    format = format.replace(RegExp.$1, (date.getFullYear() + '').substr(4 - RegExp.$1.length));
+  }
+  for (const k in o) {
+    if (new RegExp('(' + k + ')').test(format)) {
+      format = format.replace(RegExp.$1, RegExp.$1.length === 1 ? o[k] : ('00' + o[k]).substr(('' + o[k]).length));
+    }
+  }
+  return format;
+}
+
+/**
+ * 获取两个日期之间的天数差
+ * @param {Date|string|number} startDate - 开始日期
+ * @param {Date|string|number} endDate - 结束日期
+ * @returns {number} 天数差
+ */
+function getDaysBetween(startDate, endDate) {
+  const start = new Date(startDate);
+  const end = new Date(endDate);
+  if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+    return 0;
+  }
+  const oneDay = 24 * 60 * 60 * 1000; // 毫秒
+  return Math.round(Math.abs((end - start) / oneDay));
+}
+
+/**
+ * 判断是否为今天
+ * @param {Date|string|number} date - 日期
+ * @returns {boolean} 是否为今天
+ */
+function isToday(date) {
+  const target = new Date(date);
+  const today = new Date();
+  return target.getDate() === today.getDate() && target.getMonth() === today.getMonth() && target.getFullYear() === today.getFullYear();
+}
+
+/**
+ * 去除字符串首尾空格
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+function trim(str) {
+  if (typeof str !== 'string') {
+    return '';
+  }
+  return str.trim();
+}
+
+/**
+ * 首字母大写
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+function capitalize(str) {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * 字符串脱敏处理
+ * @param {string} str - 输入字符串
+ * @param {number} startLen - 保留开始长度
+ * @param {number} endLen - 保留结束长度
+ * @param {string} replaceChar - 替换字符
+ * @returns {string} 脱敏后的字符串
+ */
+function maskStr(str, startLen = 3, endLen = 4, replaceChar = '*') {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  const len = str.length;
+  if (startLen + endLen >= len) {
+    return str;
+  }
+  const maskLen = len - startLen - endLen;
+  const mask = replaceChar.repeat(maskLen);
+  return str.substring(0, startLen) + mask + str.substring(len - endLen);
+}
+
+/**
+ * 判断字符串是否为邮箱格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为邮箱
+ */
+function isEmail(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/;
+  return reg.test(str);
+}
+
+/**
+ * 判断字符串是否为手机号格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为手机号
+ */
+function isPhone(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^1[3-9]\d{9}$/;
+  return reg.test(str);
+}
+
+/**
+ * 数组去重
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 去重后的数组
+ */
+function uniqueArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  return [...new Set(arr)];
+}
+
+/**
+ * 数组排序
+ * @param {Array} arr - 输入数组
+ * @param {string} key - 排序的键名（对象数组时使用）
+ * @param {boolean} isAsc - 是否升序
+ * @returns {Array} 排序后的数组
+ */
+function sortArray(arr, key, isAsc = true) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+
+  // 复制数组避免修改原数组
+  const newArr = [...arr];
+  newArr.sort((a, b) => {
+    let valueA = a;
+    let valueB = b;
+
+    // 如果指定了key，说明是对象数组
+    if (key) {
+      valueA = a[key];
+      valueB = b[key];
+    }
+
+    // 处理数字情况
+    if (typeof valueA === 'number' && typeof valueB === 'number') {
+      return isAsc ? valueA - valueB : valueB - valueA;
+    }
+
+    // 处理字符串情况
+    const strA = String(valueA).toLowerCase();
+    const strB = String(valueB).toLowerCase();
+    if (strA < strB) {
+      return isAsc ? -1 : 1;
+    }
+    if (strA > strB) {
+      return isAsc ? 1 : -1;
+    }
+    return 0;
+  });
+  return newArr;
+}
+
+/**
+ * 数组分组
+ * @param {Array} arr - 输入数组
+ * @param {Function|string} key - 分组依据的函数或键名
+ * @returns {Object} 分组后的对象
+ */
+function groupArray(arr, key) {
+  if (!Array.isArray(arr)) {
+    return {};
+  }
+  return arr.reduce((result, item) => {
+    let groupKey;
+    if (typeof key === 'function') {
+      groupKey = key(item);
+    } else if (typeof key === 'string') {
+      groupKey = item[key];
+    } else {
+      groupKey = item;
+    }
+    if (!result[groupKey]) {
+      result[groupKey] = [];
+    }
+    result[groupKey].push(item);
+    return result;
+  }, {});
+}
+
+/**
+ * 数组扁平化
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 扁平化后的数组
+ */
+function flattenArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  return arr.reduce((result, item) => {
+    return result.concat(Array.isArray(item) ? flattenArray(item) : item);
+  }, []);
+}
+
+/**
+ * 从localStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+function getLocalStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  try {
+    const value = localStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return localStorage.getItem(key);
+  }
+}
+
+/**
+ * 向localStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+function setLocalStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  try {
+    // 转换为JSON字符串存储
+    localStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从localStorage删除数据
+ * @param {string} key - 存储键名
+ */
+function removeLocalStorage(key) {
+  if (key && typeof key === 'string') {
+    localStorage.removeItem(key);
+  }
+}
+
+/**
+ * 从sessionStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+function getSessionStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  try {
+    const value = sessionStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return sessionStorage.getItem(key);
+  }
+}
+
+/**
+ * 向sessionStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+function setSessionStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  try {
+    // 转换为JSON字符串存储
+    sessionStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从sessionStorage删除数据
+ * @param {string} key - 存储键名
+ */
+function removeSessionStorage(key) {
+  if (key && typeof key === 'string') {
+    sessionStorage.removeItem(key);
+  }
+}
+
+// 导出日期工具
+
+// 工具包版本信息
+const version = '1.0.0';
+
+export { capitalize, flattenArray, formatDate, getDaysBetween, getLocalStorage, getSessionStorage, groupArray, isEmail, isPhone, isToday, maskStr, removeLocalStorage, removeSessionStorage, setLocalStorage, setSessionStorage, sortArray, trim, uniqueArray, version };

package/dist/jiezhangxin-utils.umd.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).jiezhangxinUtils={})}(this,function(t){"use strict";t.capitalize=function(t){return"string"!=typeof t||0===t.length?"":t.charAt(0).toUpperCase()+t.slice(1)},t.flattenArray=function t(e){return Array.isArray(e)?e.reduce((e,r)=>e.concat(Array.isArray(r)?t(r):r),[]):[]},t.formatDate=function(t,e="yyyy-MM-dd"){if(!t)return"";if(t instanceof Date||(t=new Date(t)),isNaN(t.getTime()))return"";const r={"M+":t.getMonth()+1,"d+":t.getDate(),"H+":t.getHours(),"m+":t.getMinutes(),"s+":t.getSeconds(),"q+":Math.floor((t.getMonth()+3)/3),S:t.getMilliseconds()};/(y+)/.test(e)&&(e=e.replace(RegExp.$1,(t.getFullYear()+"").substr(4-RegExp.$1.length)));for(const t in r)new RegExp("("+t+")").test(e)&&(e=e.replace(RegExp.$1,1===RegExp.$1.length?r[t]:("00"+r[t]).substr((""+r[t]).length)));return e},t.getDaysBetween=function(t,e){const r=new Date(t),n=new Date(e);return isNaN(r.getTime())||isNaN(n.getTime())?0:Math.round(Math.abs((n-r)/864e5))},t.getLocalStorage=function(t){if(!t||"string"!=typeof t)return null;try{const e=localStorage.getItem(t);return null===e?null:JSON.parse(e)}catch(e){return localStorage.getItem(t)}},t.getSessionStorage=function(t){if(!t||"string"!=typeof t)return null;try{const e=sessionStorage.getItem(t);return null===e?null:JSON.parse(e)}catch(e){return sessionStorage.getItem(t)}},t.groupArray=function(t,e){return Array.isArray(t)?t.reduce((t,r)=>{let n;return n="function"==typeof e?e(r):"string"==typeof e?r[e]:r,t[n]||(t[n]=[]),t[n].push(r),t},{}):{}},t.isEmail=function(t){return"string"==typeof t&&/^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/.test(t)},t.isPhone=function(t){return"string"==typeof t&&/^1[3-9]\d{9}$/.test(t)},t.isToday=function(t){const e=new Date(t),r=new Date;return e.getDate()===r.getDate()&&e.getMonth()===r.getMonth()&&e.getFullYear()===r.getFullYear()},t.maskStr=function(t,e=3,r=4,n="*"){if("string"!=typeof t||0===t.length)return"";const o=t.length;if(e+r>=o)return t;const s=o-e-r,i=n.repeat(s);return t.substring(0,e)+i+t.substring(o-r)},t.removeLocalStorage=function(t){t&&"string"==typeof t&&localStorage.removeItem(t)},t.removeSessionStorage=function(t){t&&"string"==typeof t&&sessionStorage.removeItem(t)},t.setLocalStorage=function(t,e){if(!t||"string"!=typeof t)return!1;try{return localStorage.setItem(t,JSON.stringify(e)),!0}catch(t){return!1}},t.setSessionStorage=function(t,e){if(!t||"string"!=typeof t)return!1;try{return sessionStorage.setItem(t,JSON.stringify(e)),!0}catch(t){return!1}},t.sortArray=function(t,e,r=!0){if(!Array.isArray(t))return[];const n=[...t];return n.sort((t,n)=>{let o=t,s=n;if(e&&(o=t[e],s=n[e]),"number"==typeof o&&"number"==typeof s)return r?o-s:s-o;const i=String(o).toLowerCase(),a=String(s).toLowerCase();return i<a?r?-1:1:i>a?r?1:-1:0}),n},t.trim=function(t){return"string"!=typeof t?"":t.trim()},t.uniqueArray=function(t){return Array.isArray(t)?[...new Set(t)]:[]},t.version="1.0.0",Object.defineProperty(t,"__esModule",{value:!0})});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "jiezhangxin-utils",
+  "version": "0.0.1",
+  "description": "A utility toolkit for Vue 3 projects",
+  "main": "dist/jiezhangxin-utils.cjs.js",
+  "module": "dist/jiezhangxin-utils.esm.js",
+  "browser": "dist/jiezhangxin-utils.umd.js",
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "utils",
+    "tools",
+    "vue3",
+    "jiezhangxin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-babel": "^5.3.1",
+    "@rollup/plugin-commonjs": "^22.0.2",
+    "@rollup/plugin-node-resolve": "^14.1.0",
+    "rollup": "^2.79.1",
+    "rollup-plugin-terser": "^7.0.2"
+  }
+}

package/src/array/arrayUtils.js

@@ -0,0 +1,103 @@
+/**
+ * 数组去重
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 去重后的数组
+ */
+export function uniqueArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  return [...new Set(arr)];
+}
+
+/**
+ * 数组排序
+ * @param {Array} arr - 输入数组
+ * @param {string} key - 排序的键名（对象数组时使用）
+ * @param {boolean} isAsc - 是否升序
+ * @returns {Array} 排序后的数组
+ */
+export function sortArray(arr, key, isAsc = true) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  
+  // 复制数组避免修改原数组
+  const newArr = [...arr];
+  
+  newArr.sort((a, b) => {
+    let valueA = a;
+    let valueB = b;
+    
+    // 如果指定了key，说明是对象数组
+    if (key) {
+      valueA = a[key];
+      valueB = b[key];
+    }
+    
+    // 处理数字情况
+    if (typeof valueA === 'number' && typeof valueB === 'number') {
+      return isAsc ? valueA - valueB : valueB - valueA;
+    }
+    
+    // 处理字符串情况
+    const strA = String(valueA).toLowerCase();
+    const strB = String(valueB).toLowerCase();
+    
+    if (strA < strB) {
+      return isAsc ? -1 : 1;
+    }
+    if (strA > strB) {
+      return isAsc ? 1 : -1;
+    }
+    return 0;
+  });
+  
+  return newArr;
+}
+
+/**
+ * 数组分组
+ * @param {Array} arr - 输入数组
+ * @param {Function|string} key - 分组依据的函数或键名
+ * @returns {Object} 分组后的对象
+ */
+export function groupArray(arr, key) {
+  if (!Array.isArray(arr)) {
+    return {};
+  }
+  
+  return arr.reduce((result, item) => {
+    let groupKey;
+    
+    if (typeof key === 'function') {
+      groupKey = key(item);
+    } else if (typeof key === 'string') {
+      groupKey = item[key];
+    } else {
+      groupKey = item;
+    }
+    
+    if (!result[groupKey]) {
+      result[groupKey] = [];
+    }
+    
+    result[groupKey].push(item);
+    return result;
+  }, {});
+}
+
+/**
+ * 数组扁平化
+ * @param {Array} arr - 输入数组
+ * @returns {Array} 扁平化后的数组
+ */
+export function flattenArray(arr) {
+  if (!Array.isArray(arr)) {
+    return [];
+  }
+  
+  return arr.reduce((result, item) => {
+    return result.concat(Array.isArray(item) ? flattenArray(item) : item);
+  }, []);
+}

package/src/date/dateUtils.js

@@ -0,0 +1,75 @@
+/**
+ * 格式化日期
+ * @param {Date|string|number} date - 日期
+ * @param {string} format - 格式字符串，例如：'yyyy-MM-dd HH:mm:ss'
+ * @returns {string} 格式化后的日期字符串
+ */
+export function formatDate(date, format = 'yyyy-MM-dd') {
+  if (!date) {
+    return '';
+  }
+  
+  // 处理日期参数
+  if (!(date instanceof Date)) {
+    date = new Date(date);
+  }
+  
+  // 检查日期是否有效
+  if (isNaN(date.getTime())) {
+    return '';
+  }
+  
+  const o = {
+    'M+': date.getMonth() + 1, // 月份
+    'd+': date.getDate(), // 日
+    'H+': date.getHours(), // 小时
+    'm+': date.getMinutes(), // 分
+    's+': date.getSeconds(), // 秒
+    'q+': Math.floor((date.getMonth() + 3) / 3), // 季度
+    'S': date.getMilliseconds() // 毫秒
+  };
+  
+  if (/(y+)/.test(format)) {
+    format = format.replace(RegExp.$1, (date.getFullYear() + '').substr(4 - RegExp.$1.length));
+  }
+  
+  for (const k in o) {
+    if (new RegExp('(' + k + ')').test(format)) {
+      format = format.replace(RegExp.$1, (RegExp.$1.length === 1) ? (o[k]) : (('00' + o[k]).substr(('' + o[k]).length)));
+    }
+  }
+  
+  return format;
+}
+
+/**
+ * 获取两个日期之间的天数差
+ * @param {Date|string|number} startDate - 开始日期
+ * @param {Date|string|number} endDate - 结束日期
+ * @returns {number} 天数差
+ */
+export function getDaysBetween(startDate, endDate) {
+  const start = new Date(startDate);
+  const end = new Date(endDate);
+  
+  if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+    return 0;
+  }
+  
+  const oneDay = 24 * 60 * 60 * 1000; // 毫秒
+  return Math.round(Math.abs((end - start) / oneDay));
+}
+
+/**
+ * 判断是否为今天
+ * @param {Date|string|number} date - 日期
+ * @returns {boolean} 是否为今天
+ */
+export function isToday(date) {
+  const target = new Date(date);
+  const today = new Date();
+  
+  return target.getDate() === today.getDate() &&
+    target.getMonth() === today.getMonth() &&
+    target.getFullYear() === today.getFullYear();
+}

package/src/index.js

@@ -0,0 +1,14 @@
+// 导出日期工具
+export * from './date/dateUtils';
+
+// 导出字符串工具
+export * from './string/stringUtils';
+
+// 导出数组工具
+export * from './array/arrayUtils';
+
+// 导出存储工具
+export * from './storage/storageUtils';
+
+// 工具包版本信息
+export const version = '1.0.0';

package/src/storage/storageUtils.js

@@ -0,0 +1,105 @@
+/**
+ * 从localStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+export function getLocalStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  
+  try {
+    const value = localStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return localStorage.getItem(key);
+  }
+}
+
+/**
+ * 向localStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+export function setLocalStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  
+  try {
+    // 转换为JSON字符串存储
+    localStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从localStorage删除数据
+ * @param {string} key - 存储键名
+ */
+export function removeLocalStorage(key) {
+  if (key && typeof key === 'string') {
+    localStorage.removeItem(key);
+  }
+}
+
+/**
+ * 从sessionStorage获取数据
+ * @param {string} key - 存储键名
+ * @returns {any} 存储的值
+ */
+export function getSessionStorage(key) {
+  if (!key || typeof key !== 'string') {
+    return null;
+  }
+  
+  try {
+    const value = sessionStorage.getItem(key);
+    if (value === null) {
+      return null;
+    }
+    // 尝试解析JSON
+    return JSON.parse(value);
+  } catch (e) {
+    // 如果解析失败，直接返回原始值
+    return sessionStorage.getItem(key);
+  }
+}
+
+/**
+ * 向sessionStorage存储数据
+ * @param {string} key - 存储键名
+ * @param {any} value - 存储的值
+ * @returns {boolean} 是否存储成功
+ */
+export function setSessionStorage(key, value) {
+  if (!key || typeof key !== 'string') {
+    return false;
+  }
+  
+  try {
+    // 转换为JSON字符串存储
+    sessionStorage.setItem(key, JSON.stringify(value));
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 从sessionStorage删除数据
+ * @param {string} key - 存储键名
+ */
+export function removeSessionStorage(key) {
+  if (key && typeof key === 'string') {
+    sessionStorage.removeItem(key);
+  }
+}

package/src/string/stringUtils.js

@@ -0,0 +1,73 @@
+/**
+ * 去除字符串首尾空格
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+export function trim(str) {
+  if (typeof str !== 'string') {
+    return '';
+  }
+  return str.trim();
+}
+
+/**
+ * 首字母大写
+ * @param {string} str - 输入字符串
+ * @returns {string} 处理后的字符串
+ */
+export function capitalize(str) {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * 字符串脱敏处理
+ * @param {string} str - 输入字符串
+ * @param {number} startLen - 保留开始长度
+ * @param {number} endLen - 保留结束长度
+ * @param {string} replaceChar - 替换字符
+ * @returns {string} 脱敏后的字符串
+ */
+export function maskStr(str, startLen = 3, endLen = 4, replaceChar = '*') {
+  if (typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+  
+  const len = str.length;
+  if (startLen + endLen >= len) {
+    return str;
+  }
+  
+  const maskLen = len - startLen - endLen;
+  const mask = replaceChar.repeat(maskLen);
+  
+  return str.substring(0, startLen) + mask + str.substring(len - endLen);
+}
+
+/**
+ * 判断字符串是否为邮箱格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为邮箱
+ */
+export function isEmail(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/;
+  return reg.test(str);
+}
+
+/**
+ * 判断字符串是否为手机号格式
+ * @param {string} str - 输入字符串
+ * @returns {boolean} 是否为手机号
+ */
+export function isPhone(str) {
+  if (typeof str !== 'string') {
+    return false;
+  }
+  const reg = /^1[3-9]\d{9}$/;
+  return reg.test(str);
+}