@zdepot/utils 1.1.0 → 1.2.1

package/README.md

@@ -1,206 +1,207 @@
-# @zdepot/utils
-
-Safe type conversion tool library, which provides the method of type judgment and conversion with bottom value, to ensure that your code will not throw exceptions because of type problems.
-
-## Features
-
-✅ **Type Safety** - Accurate type detection based on `Object.prototype.toString`  
-✅ **Fallback Protection** - All conversion methods have default fallback values to prevent runtime errors  
-✅ **JSON Parsing** - Smart JSON parsing with automatic type detection  
-✅ **Circular References** - Safe JSON serialization with automatic circular reference and function handling  
-✅ **TypeScript Support** - Complete TypeScript type definitions  
-✅ **Tree-shaking** - Side-effect free, compatible with bundler optimization  
-
-## Installation
-
-```bash
-npm install @zdepot/utils
-```
-
-## Usage
-
-```ts
-import safe from '@zdepot/utils'
-
-// Or import only what you need
-import { safe } from '@zdepot/utils'
-```
-
-## API
-
-### isSameType(a, b)
-
-Checks if two values are of the same type, using `Object.prototype.toString` for precise detection.
-
-```ts
-safe.isSameType([], [])     // true
-safe.isSameType({}, [])     // false
-safe.isSameType(1, '1')     // false
-```
-
-### array(value)
-
-Ensures an array is returned. Returns the input directly if it's an array; parses JSON strings automatically; otherwise returns an empty array `[]`.
-
-```ts
-safe.array([1, 2])          // [1, 2]
-safe.array('[1,2]')         // [1, 2]
-safe.array('hello')         // []
-safe.array(null)            // []
-```
-
-### string(value, fallback?)
-
-Ensures a string is returned. Returns the input directly if it's a string, otherwise returns the fallback value (default `""`).
-
-```ts
-safe.string('hello')        // 'hello'
-safe.string(123)            // ''
-safe.string(123, 'default') // 'default'
-```
-
-### number(value, fallback?)
-
-Ensures a number is returned. Uses `Number()` for conversion, returns fallback value (default `0`) if result is NaN or Infinity.
-
-```ts
-safe.number(123)            // 123
-safe.number('456')          // 456
-safe.number('abc')          // 0
-safe.number('abc', -1)      // -1
-safe.number(Infinity)       // 0
-```
-
-### jsonParse(value, fallback)
-
-`JSON.parse` with fallback value. Returns fallback if parsing fails or result type doesn't match fallback type.
-
-```ts
-safe.jsonParse('{"a":1}', {})   // { a: 1 }
-safe.jsonParse('invalid', {})  // {}
-safe.jsonParse('"hello"', [])   // []  (type mismatch)
-safe.jsonParse(null, {})        // {}
-```
-
-### jsonParseObj(value, fallback)
-
-Enhanced `jsonParse` that only processes strings starting with `[` or `{` (objects/arrays), otherwise returns fallback directly. Built-in length limit prevents DoS attacks.
-
-```ts
-safe.jsonParseObj('{"a":1}', {})    // { a: 1 }
-safe.jsonParseObj('[1,2]', [])      // [1, 2]
-safe.jsonParseObj('"hello"', {})    // {}  (doesn't start with [ or {)
-safe.jsonParseObj('invalid', {})    // {}
-```
-
-### split(value, splitStr)
-
-Safe `String.split`. Empty strings return `[]` instead of `['']`, errors also return `[]`.
-
-```ts
-safe.split('a,b,c', ',')   // ['a', 'b', 'c']
-safe.split('', ',')        // []
-safe.split(null, ',')      // []
-```
-
-### boolean(value, fallback?)
-
-Ensures a boolean is returned. Supports `true/false` strings (case-insensitive) and `0/1` numbers.
-
-```ts
-safe.boolean(true)          // true
-safe.boolean('TRUE')         // true
-safe.boolean(1)              // true
-safe.boolean('false')        // false
-safe.boolean(0)              // false
-safe.boolean('hello')        // false  (fallback value)
-```
-
-### date(value, fallback?)
-
-Ensures a Date object is returned. Supports Date objects, timestamps, and date strings.
-
-```ts
-safe.date(new Date())           // returns as-is
-safe.date(1700000000000)         // new Date(1700000000000)
-safe.date('2023-01-01')          // new Date('2023-01-01')
-safe.date('invalid')             // new Date()  (current time)
-safe.date('invalid', fallback)   // fallback
-```
-
-### function(value, fallback?)
-
-Ensures a function is returned. Returns the input directly if it's a function, otherwise returns the fallback value (default empty function).
-
-```ts
-safe.function(fn)               // fn
-safe.function(null)             // () => undefined
-safe.function(null, () => 'hi') // () => 'hi'
-```
-
-### nonEmptyString(value, fallback?)
-
-Ensures a non-empty string is returned. Returns the input if it's a non-empty string, otherwise returns the fallback value.
-
-```ts
-safe.nonEmptyString('hello')    // 'hello'
-safe.nonEmptyString('  ')       // ''  (whitespace only)
-safe.nonEmptyString('')         // ''
-safe.nonEmptyString(123, 'N/A') // 'N/A'
-```
-
-### email(value, fallback?)
-
-Ensures a valid email string is returned.
-
-```ts
-safe.email('user@example.com')  // 'user@example.com'
-safe.email('invalid')           // ''
-safe.email('bad', 'a@b.com')    // 'a@b.com'
-```
-
-### timestamp(value, fallback?)
-
-Ensures a valid timestamp is returned.
-
-```ts
-safe.timestamp(1700000000000)   // 1700000000000
-safe.timestamp(new Date())      // date.getTime()
-safe.timestamp('2023-01-01')    // 1672531200000
-safe.timestamp('invalid', 0)    // 0
-```
-
-### jsonStringify(value, indent?)
-
-Safe JSON serialization. Automatically handles circular references and functions without throwing.
-
-```ts
-safe.jsonStringify({ a: 1 })              // '{"a":1}'
-safe.jsonStringify({ fn: () => {} })      // '{"fn":"[Function]"}'
-
-const obj: any = { name: 'test' }
-obj.self = obj
-safe.jsonStringify(obj)                   // '{"name":"test","self":"[Circular]"}'
-```
-
-## Use Cases
-
-```ts
-// API response handling
-const data = safe.jsonParse(response.data, defaultValue)
-const items = safe.array(data.items)
-
-// Config file parsing
-const config = safe.jsonParseObj(fs.readFileSync('config.json', 'utf-8'), {})
-
-// User input processing
-const username = safe.string(input.username, 'guest')
-const age = safe.number(input.age, 0)
-
-// String splitting
-const parts = safe.split(input.tags, ',') // avoids split(',a', ',') returning ['', 'a']
-```
-
-## License
-
-MIT
+# @zdepot/utils
+
+Safe type conversion tool library, which provides the method of type judgment and conversion with bottom value, to ensure that your code will not throw exceptions because of type problems.
+
+## Features
+
+✅ **Type Safety** - Accurate type detection based on `Object.prototype.toString`  
+✅ **Fallback Protection** - All conversion methods have default fallback values to prevent runtime errors  
+✅ **JSON Parsing** - Smart JSON parsing with automatic type detection  
+✅ **Circular References** - Safe JSON serialization with automatic circular reference and function handling  
+✅ **TypeScript Support** - Complete TypeScript type definitions  
+✅ **Tree-shaking** - Side-effect free, compatible with bundler optimization  
+
+## Installation
+
+```bash
+npm install @zdepot/utils
+```
+
+## Usage
+
+```ts
+// 默认导入
+import safe from '@zdepot/utils'
+
+// 或命名导入
+import { safe } from '@zdepot/utils'
+```
+
+## API
+
+### isSameType(a, b)
+
+Checks if two values are of the same type, using `Object.prototype.toString` for precise detection.
+
+```ts
+safe.isSameType([], [])     // true
+safe.isSameType({}, [])     // false
+safe.isSameType(1, '1')     // false
+```
+
+### array(value)
+
+Ensures an array is returned. Returns the input directly if it's an array; parses JSON strings automatically; otherwise returns an empty array `[]`.
+
+```ts
+safe.array([1, 2])          // [1, 2]
+safe.array('[1,2]')         // [1, 2]
+safe.array('hello')         // []
+safe.array(null)            // []
+```
+
+### string(value, fallback?)
+
+Ensures a string is returned. Returns the input directly if it's a string, otherwise returns the fallback value (default `""`).
+
+```ts
+safe.string('hello')        // 'hello'
+safe.string(123)            // ''
+safe.string(123, 'default') // 'default'
+```
+
+### number(value, fallback?)
+
+Ensures a number is returned. Uses `Number()` for conversion, returns fallback value (default `0`) if result is NaN or Infinity.
+
+```ts
+safe.number(123)            // 123
+safe.number('456')          // 456
+safe.number('abc')          // 0
+safe.number('abc', -1)      // -1
+safe.number(Infinity)       // 0
+```
+
+### jsonParse(value, fallback)
+
+`JSON.parse` with fallback value. Returns fallback if parsing fails or result type doesn't match fallback type.
+
+```ts
+safe.jsonParse('{"a":1}', {})   // { a: 1 }
+safe.jsonParse('invalid', {})  // {}
+safe.jsonParse('"hello"', [])   // []  (type mismatch)
+safe.jsonParse(null, {})        // {}
+```
+
+### jsonParseObj(value, fallback)
+
+Enhanced `jsonParse` that only processes strings starting with `[` or `{` (objects/arrays), otherwise returns fallback directly. Built-in length limit prevents DoS attacks.
+
+```ts
+safe.jsonParseObj('{"a":1}', {})    // { a: 1 }
+safe.jsonParseObj('[1,2]', [])      // [1, 2]
+safe.jsonParseObj('"hello"', {})    // {}  (doesn't start with [ or {)
+safe.jsonParseObj('invalid', {})    // {}
+```
+
+### split(value, splitStr)
+
+Safe `String.split`. Empty strings return `[]` instead of `['']`, errors also return `[]`.
+
+```ts
+safe.split('a,b,c', ',')   // ['a', 'b', 'c']
+safe.split('', ',')        // []
+safe.split(null, ',')      // []
+```
+
+### boolean(value, fallback?)
+
+Ensures a boolean is returned. Supports `true/false` strings (case-insensitive) and `0/1` numbers.
+
+```ts
+safe.boolean(true)          // true
+safe.boolean('TRUE')         // true
+safe.boolean(1)              // true
+safe.boolean('false')        // false
+safe.boolean(0)              // false
+safe.boolean('hello')        // false  (fallback value)
+```
+
+### date(value, fallback?)
+
+Ensures a Date object is returned. Supports Date objects, timestamps, and date strings.
+
+```ts
+safe.date(new Date())           // returns as-is
+safe.date(1700000000000)         // new Date(1700000000000)
+safe.date('2023-01-01')          // new Date('2023-01-01')
+safe.date('invalid')             // new Date()  (current time)
+safe.date('invalid', fallback)   // fallback
+```
+
+### function(value, fallback?)
+
+Ensures a function is returned. Returns the input directly if it's a function, otherwise returns the fallback value (default empty function).
+
+```ts
+safe.function(fn)               // fn
+safe.function(null)             // () => undefined
+safe.function(null, () => 'hi') // () => 'hi'
+```
+
+### nonEmptyString(value, fallback?)
+
+Ensures a non-empty string is returned. Returns the input if it's a non-empty string, otherwise returns the fallback value.
+
+```ts
+safe.nonEmptyString('hello')    // 'hello'
+safe.nonEmptyString('  ')       // ''  (whitespace only)
+safe.nonEmptyString('')         // ''
+safe.nonEmptyString(123, 'N/A') // 'N/A'
+```
+
+### email(value, fallback?)
+
+Ensures a valid email string is returned.
+
+```ts
+safe.email('user@example.com')  // 'user@example.com'
+safe.email('invalid')           // ''
+safe.email('bad', 'a@b.com')    // 'a@b.com'
+```
+
+### timestamp(value, fallback?)
+
+Ensures a valid timestamp is returned.
+
+```ts
+safe.timestamp(1700000000000)   // 1700000000000
+safe.timestamp(new Date())      // date.getTime()
+safe.timestamp('2023-01-01')    // 1672531200000
+safe.timestamp('invalid', 0)    // 0
+```
+
+### jsonStringify(value, indent?)
+
+Safe JSON serialization. Automatically handles circular references and functions without throwing.
+
+```ts
+safe.jsonStringify({ a: 1 })              // '{"a":1}'
+safe.jsonStringify({ fn: () => {} })      // '{"fn":"[Function]"}'
+
+const obj: any = { name: 'test' }
+obj.self = obj
+safe.jsonStringify(obj)                   // '{"name":"test","self":"[Circular]"}'
+```
+
+## Use Cases
+
+```ts
+// API response handling
+const data = safe.jsonParse(response.data, defaultValue)
+const items = safe.array(data.items)
+
+// Config file parsing
+const config = safe.jsonParseObj(fs.readFileSync('config.json', 'utf-8'), {})
+
+// User input processing
+const username = safe.string(input.username, 'guest')
+const age = safe.number(input.age, 0)
+
+// String splitting
+const parts = safe.split(input.tags, ',') // avoids split(',a', ',') returning ['', 'a']
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -67,7 +67,7 @@ interface SafeUtils {
      * @param fallback 兜底值
      * @returns 函数
      */
-    function: <T extends (...args: any[]) => any>(value: unknown, fallback?: T) => T;
+    function: <T extends (...args: unknown[]) => unknown>(value: unknown, fallback?: T) => T;
     /**
      * 确保返回非空字符串。如果是非空字符串则返回，否则返回兜底值。
      * @param value 输入值

package/dist/index.global.js

@@ -1 +1 @@
-"use strict";var safeUtils=(()=>{var u=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,t)=>{for(var r in t)u(n,r,{get:t[r],enumerable:!0})},N=(n,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of y(t))!m.call(n,e)&&e!==r&&u(n,e,{get:()=>t[e],enumerable:!(s=T(t,e))||s.enumerable});return n};var S=n=>N(u({},"__esModule",{value:!0}),n);var R={};d(R,{default:()=>P,safe:()=>p});var k=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,a=/^[\[{]/,h=()=>{},c=n=>Object.prototype.toString.call(n),o=(n,t)=>c(n)===c(t),g=(n,t)=>{if(n==null)return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},x=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2)return t;try{if(!a.test(n))throw new Error;let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},E=n=>o(n,[])?n:o(n,"")?g(n,[]):[],i=(n,t="")=>typeof n=="string"?n:t??"",f=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},O=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),D=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},w=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},_=(n,t=h)=>typeof n=="function"?n:t,b=(n,t="")=>{let r=i(n,t);return r.trim()!==""?r:t},J=(n,t="")=>{let r=i(n,t);return k.test(r)?r:t},j=(n,t=Date.now())=>w(n,new Date(t)).getTime(),F=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(s,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},L=(n,t=1)=>{let r=f(n,NaN);return r>0?r:t},M=(n,t="")=>{let r=i(n,t);try{let s=new URL(r);return s.protocol==="http:"||s.protocol==="https:"?r:t}catch{return t}},p={isSameType:o,array:E,string:i,number:f,jsonParse:g,jsonParseObj:x,split:O,boolean:D,date:w,function:_,nonEmptyString:b,email:J,timestamp:j,jsonStringify:F,positive:L,url:M},P=p;return S(R);})();
+"use strict";var safeUtils=(()=>{var u=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,t)=>{for(var r in t)u(n,r,{get:t[r],enumerable:!0})},N=(n,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of y(t))!m.call(n,e)&&e!==r&&u(n,e,{get:()=>t[e],enumerable:!(s=T(t,e))||s.enumerable});return n};var S=n=>N(u({},"__esModule",{value:!0}),n);var R={};d(R,{default:()=>P,safe:()=>w});var k=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,h=/^[\[{]/,x=()=>{},c=n=>Object.prototype.toString.call(n),o=(n,t)=>c(n)===c(t),f=(n,t)=>{if(n==null||typeof n!="string")return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},D=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2||!h.test(n))return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},O=n=>o(n,[])?n:o(n,"")?f(n,[]):[],i=(n,t="")=>typeof n=="string"?n:t,g=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},E=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),_=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},p=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},F=(n,t=x)=>typeof n=="function"?n:t,J=(n,t="")=>{let r=i(n,t);return r.trim()!==""?r:t},b=(n,t="")=>{let r=i(n,t);return k.test(r)?r:t},j=(n,t=Date.now())=>{let r=Number.isFinite(t)?t:Date.now();return p(n,new Date(r)).getTime()},a=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(s,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},L=(n,t=1)=>{let r=g(n,NaN);return r>0?r:t},M=(n,t="")=>{let r=i(n,t);try{let s=new URL(r);return s.protocol==="http:"||s.protocol==="https:"?r:t}catch{return t}},w={isSameType:o,array:O,string:i,number:g,jsonParse:f,jsonParseObj:D,split:E,boolean:_,date:p,function:F,nonEmptyString:J,email:b,timestamp:j,jsonStringify:a,positive:L,url:M},P=w;return S(R);})();

package/dist/index.js

@@ -1 +1 @@
-"use strict";var u=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,t)=>{for(var r in t)u(n,r,{get:t[r],enumerable:!0})},N=(n,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of y(t))!m.call(n,e)&&e!==r&&u(n,e,{get:()=>t[e],enumerable:!(s=T(t,e))||s.enumerable});return n};var S=n=>N(u({},"__esModule",{value:!0}),n);var R={};d(R,{default:()=>P,safe:()=>p});module.exports=S(R);var k=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,a=/^[\[{]/,h=()=>{},c=n=>Object.prototype.toString.call(n),o=(n,t)=>c(n)===c(t),g=(n,t)=>{if(n==null)return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},x=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2)return t;try{if(!a.test(n))throw new Error;let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},E=n=>o(n,[])?n:o(n,"")?g(n,[]):[],i=(n,t="")=>typeof n=="string"?n:t??"",f=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},O=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),D=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},w=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},_=(n,t=h)=>typeof n=="function"?n:t,b=(n,t="")=>{let r=i(n,t);return r.trim()!==""?r:t},J=(n,t="")=>{let r=i(n,t);return k.test(r)?r:t},j=(n,t=Date.now())=>w(n,new Date(t)).getTime(),F=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(s,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},L=(n,t=1)=>{let r=f(n,NaN);return r>0?r:t},M=(n,t="")=>{let r=i(n,t);try{let s=new URL(r);return s.protocol==="http:"||s.protocol==="https:"?r:t}catch{return t}},p={isSameType:o,array:E,string:i,number:f,jsonParse:g,jsonParseObj:x,split:O,boolean:D,date:w,function:_,nonEmptyString:b,email:J,timestamp:j,jsonStringify:F,positive:L,url:M},P=p;0&&(module.exports={safe});
+"use strict";var u=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,t)=>{for(var r in t)u(n,r,{get:t[r],enumerable:!0})},N=(n,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of y(t))!m.call(n,e)&&e!==r&&u(n,e,{get:()=>t[e],enumerable:!(s=T(t,e))||s.enumerable});return n};var S=n=>N(u({},"__esModule",{value:!0}),n);var R={};d(R,{default:()=>P,safe:()=>w});module.exports=S(R);var k=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,h=/^[\[{]/,x=()=>{},c=n=>Object.prototype.toString.call(n),o=(n,t)=>c(n)===c(t),f=(n,t)=>{if(n==null||typeof n!="string")return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},D=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2||!h.test(n))return t;try{let r=JSON.parse(n);return o(r,t)?r:t}catch{return t}},O=n=>o(n,[])?n:o(n,"")?f(n,[]):[],i=(n,t="")=>typeof n=="string"?n:t,g=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},E=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),_=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},p=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},F=(n,t=x)=>typeof n=="function"?n:t,J=(n,t="")=>{let r=i(n,t);return r.trim()!==""?r:t},b=(n,t="")=>{let r=i(n,t);return k.test(r)?r:t},j=(n,t=Date.now())=>{let r=Number.isFinite(t)?t:Date.now();return p(n,new Date(r)).getTime()},a=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(s,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},L=(n,t=1)=>{let r=g(n,NaN);return r>0?r:t},M=(n,t="")=>{let r=i(n,t);try{let s=new URL(r);return s.protocol==="http:"||s.protocol==="https:"?r:t}catch{return t}},w={isSameType:o,array:O,string:i,number:g,jsonParse:f,jsonParseObj:D,split:E,boolean:_,date:p,function:F,nonEmptyString:J,email:b,timestamp:j,jsonStringify:a,positive:L,url:M},P=w;0&&(module.exports={safe});

package/dist/index.mjs

@@ -1 +1 @@
-var w=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,p=/^[\[{]/,T=()=>{},u=n=>Object.prototype.toString.call(n),s=(n,t)=>u(n)===u(t),c=(n,t)=>{if(n==null)return t;try{let r=JSON.parse(n);return s(r,t)?r:t}catch{return t}},y=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2)return t;try{if(!p.test(n))throw new Error;let r=JSON.parse(n);return s(r,t)?r:t}catch{return t}},m=n=>s(n,[])?n:s(n,"")?c(n,[]):[],o=(n,t="")=>typeof n=="string"?n:t??"",g=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},d=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),N=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},f=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},S=(n,t=T)=>typeof n=="function"?n:t,k=(n,t="")=>{let r=o(n,t);return r.trim()!==""?r:t},a=(n,t="")=>{let r=o(n,t);return w.test(r)?r:t},h=(n,t=Date.now())=>f(n,new Date(t)).getTime(),x=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(i,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},E=(n,t=1)=>{let r=g(n,NaN);return r>0?r:t},O=(n,t="")=>{let r=o(n,t);try{let i=new URL(r);return i.protocol==="http:"||i.protocol==="https:"?r:t}catch{return t}},D={isSameType:s,array:m,string:o,number:g,jsonParse:c,jsonParseObj:y,split:d,boolean:N,date:f,function:S,nonEmptyString:k,email:a,timestamp:h,jsonStringify:x,positive:E,url:O},_=D;export{_ as default,D as safe};
+var p=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,w=/^[\[{]/,T=()=>{},u=n=>Object.prototype.toString.call(n),s=(n,t)=>u(n)===u(t),c=(n,t)=>{if(n==null||typeof n!="string")return t;try{let r=JSON.parse(n);return s(r,t)?r:t}catch{return t}},y=(n,t)=>{if(typeof n!="string"||n.length>10485760||n.length<2||!w.test(n))return t;try{let r=JSON.parse(n);return s(r,t)?r:t}catch{return t}},m=n=>s(n,[])?n:s(n,"")?c(n,[]):[],i=(n,t="")=>typeof n=="string"?n:t,f=(n,t=0)=>{let r=Number(n);return Number.isFinite(r)?r:Number.isFinite(t)?t:0},d=(n,t)=>typeof n!="string"||n===""?[]:n.split(t),N=(n,t=!1)=>{if(n===!0||n===1)return!0;if(n===!1||n===0)return!1;let r=String(n).toLowerCase();return r==="true"?!0:r==="false"?!1:t},g=(n,t)=>{if(n instanceof Date)return n;if(typeof n=="number"||typeof n=="string"){let r=new Date(n);return isNaN(r.getTime())?t??new Date:r}return t??new Date},S=(n,t=T)=>typeof n=="function"?n:t,k=(n,t="")=>{let r=i(n,t);return r.trim()!==""?r:t},h=(n,t="")=>{let r=i(n,t);return p.test(r)?r:t},x=(n,t=Date.now())=>{let r=Number.isFinite(t)?t:Date.now();return g(n,new Date(r)).getTime()},D=(n,t)=>{let r=new WeakSet;try{return JSON.stringify(n,(o,e)=>{if(typeof e=="function")return"[Function]";if(typeof e=="object"&&e!==null){if(r.has(e))return"[Circular]";r.add(e)}return e},t)}catch{return"{}"}},O=(n,t=1)=>{let r=f(n,NaN);return r>0?r:t},E=(n,t="")=>{let r=i(n,t);try{let o=new URL(r);return o.protocol==="http:"||o.protocol==="https:"?r:t}catch{return t}},_={isSameType:s,array:m,string:i,number:f,jsonParse:c,jsonParseObj:y,split:d,boolean:N,date:g,function:S,nonEmptyString:k,email:h,timestamp:x,jsonStringify:D,positive:O,url:E},F=_;export{F as default,_ as safe};

package/package.json

@@ -1,66 +1,66 @@
-{
-  "name": "@zdepot/utils",
-  "version": "1.1.0",
-  "description": "安全类型转换工具库，提供带兜底值的类型判断与转换方法",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "browser": "dist/index.iife.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "browser": "./dist/index.iife.js",
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup --config tsup.config.ts && node scripts/clean-dmts.js",
-    "prepublishOnly": "npm run build",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:coverage:report": "vitest run --coverage --reporter=text --reporter=html",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "format": "prettier --write src/**/*.ts"
-  },
-  "keywords": [
-    "utils",
-    "safe",
-    "type-check",
-    "fallback",
-    "json-parse",
-    "type-conversion",
-    "typescript",
-    "ts"
-  ],
-  "author": "dalongzhu",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/DLwebweb/zdepot-utils",
-    "directory": ""
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "@vitest/coverage-v8": "^1.0.0",
-    "eslint": "^8.0.0",
-    "jsdom": "^29.1.1",
-    "prettier": "^3.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.4.0",
-    "vitest": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  }
-}
+{
+  "name": "@zdepot/utils",
+  "version": "1.2.1",
+  "description": "Safety Type Conversion Utility Library, providing type judgment and conversion methods with fallback values",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "browser": "dist/index.global.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && node scripts/clean-dmts.js",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:coverage:report": "vitest run --coverage --reporter=text --reporter=html",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "utils",
+    "safe",
+    "type-check",
+    "fallback",
+    "json-parse",
+    "type-conversion",
+    "typescript",
+    "ts"
+  ],
+  "author": "Mr.Z",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "",
+    "directory": ""
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.0.0",
+    "jsdom": "^29.1.1",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}