@tanwan/utils 1.0.0 → 1.1.0

package/dist/url/parseQueryString.d.ts

@@ -0,0 +1,23 @@
+//#region src/url/parseQueryString/index.d.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+declare function parseQueryString(query?: string): Record<string, string | number | boolean | (string | number | boolean)[]>;
+//#endregion
+export { parseQueryString as default };
+//# sourceMappingURL=parseQueryString.d.ts.map

package/dist/url/parseQueryString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseQueryString.d.ts","names":[],"sources":["../../src/url/parseQueryString/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;iBAkBwB,gBAAA,CACtB,KAAA,YACC,MAAA"}

package/dist/url/parseQueryString.js

@@ -0,0 +1,50 @@
+//#region src/url/parseQueryString/index.ts
+/**
+* 解析 URL 查询字符串为对象
+*
+* 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean
+*
+* @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`
+* @returns 解析后的键值对对象
+*
+* @example
+* ```ts
+* import parseQueryString from '@tanwan/utils/parseQueryString'
+* parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }
+* parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }
+* parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }
+* parseQueryString('?active=true&count=0')         // { active: true, count: 0 }
+* parseQueryString('')                             // {}
+* ```
+*/
+function parseQueryString(query) {
+	const qs = query ?? (typeof location !== "undefined" ? location.search : "");
+	if (!qs) return {};
+	const str = qs.startsWith("?") ? qs.slice(1) : qs;
+	if (!str) return {};
+	const result = {};
+	for (const part of str.split("&")) {
+		if (!part) continue;
+		const [rawKey, rawValue = ""] = part.split("=");
+		const key = decodeURIComponent(rawKey);
+		const parsed = parseValue(decodeURIComponent(rawValue));
+		if (key in result) {
+			const existing = result[key];
+			if (Array.isArray(existing)) existing.push(parsed);
+			else result[key] = [existing, parsed];
+		} else result[key] = parsed;
+	}
+	return result;
+}
+function parseValue(value) {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	if (value === "") return "";
+	const num = Number(value);
+	if (!Number.isNaN(num) && String(num) === value) return num;
+	return value;
+}
+//#endregion
+export { parseQueryString as default };
+
+//# sourceMappingURL=parseQueryString.js.map

package/dist/url/parseQueryString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseQueryString.js","names":[],"sources":["../../src/url/parseQueryString/index.ts"],"sourcesContent":["/**\n * 解析 URL 查询字符串为对象\n *\n * 支持重复 key 解析为数组，数字字符串自动转为 number，布尔字符串自动转为 boolean\n *\n * @param query - 查询字符串（可带或不带前导 `?`），默认为当前页面 `location.search`\n * @returns 解析后的键值对对象\n *\n * @example\n * ```ts\n * import parseQueryString from '@tanwan/utils/parseQueryString'\n * parseQueryString('?name=John&age=25')           // { name: 'John', age: 25 }\n * parseQueryString('name=John&age=25')             // { name: 'John', age: 25 }\n * parseQueryString('?ids=1&ids=2')                 // { ids: [1, 2] }\n * parseQueryString('?active=true&count=0')         // { active: true, count: 0 }\n * parseQueryString('')                             // {}\n * ```\n */\nexport default function parseQueryString(\n  query?: string,\n): Record<string, string | number | boolean | (string | number | boolean)[]> {\n  const qs = query ?? (typeof location !== 'undefined' ? location.search : '');\n\n  if (!qs) {\n    return {};\n  }\n\n  const str = qs.startsWith('?') ? qs.slice(1) : qs;\n  if (!str) {\n    return {};\n  }\n\n  const result: Record<string, string | number | boolean | (string | number | boolean)[]> = {};\n\n  for (const part of str.split('&')) {\n    if (!part) continue;\n\n    const [rawKey, rawValue = ''] = part.split('=');\n    const key = decodeURIComponent(rawKey);\n    const value = decodeURIComponent(rawValue);\n\n    const parsed = parseValue(value);\n\n    if (key in result) {\n      const existing = result[key];\n      if (Array.isArray(existing)) {\n        existing.push(parsed);\n      } else {\n        result[key] = [existing, parsed];\n      }\n    } else {\n      result[key] = parsed;\n    }\n  }\n\n  return result;\n}\n\nfunction parseValue(value: string): string | number | boolean {\n  if (value === 'true') return true;\n  if (value === 'false') return false;\n  if (value === '') return '';\n  const num = Number(value);\n  if (!Number.isNaN(num) && String(num) === value) return num;\n  return value;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAwB,iBACtB,OAC2E;CAC3E,MAAM,KAAK,UAAU,OAAO,aAAa,cAAc,SAAS,SAAS;AAEzE,KAAI,CAAC,GACH,QAAO,EAAE;CAGX,MAAM,MAAM,GAAG,WAAW,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG;AAC/C,KAAI,CAAC,IACH,QAAO,EAAE;CAGX,MAAM,SAAoF,EAAE;AAE5F,MAAK,MAAM,QAAQ,IAAI,MAAM,IAAI,EAAE;AACjC,MAAI,CAAC,KAAM;EAEX,MAAM,CAAC,QAAQ,WAAW,MAAM,KAAK,MAAM,IAAI;EAC/C,MAAM,MAAM,mBAAmB,OAAO;EAGtC,MAAM,SAAS,WAFD,mBAAmB,SAEF,CAAC;AAEhC,MAAI,OAAO,QAAQ;GACjB,MAAM,WAAW,OAAO;AACxB,OAAI,MAAM,QAAQ,SAAS,CACzB,UAAS,KAAK,OAAO;OAErB,QAAO,OAAO,CAAC,UAAU,OAAO;QAGlC,QAAO,OAAO;;AAIlB,QAAO;;AAGT,SAAS,WAAW,OAA0C;AAC5D,KAAI,UAAU,OAAQ,QAAO;AAC7B,KAAI,UAAU,QAAS,QAAO;AAC9B,KAAI,UAAU,GAAI,QAAO;CACzB,MAAM,MAAM,OAAO,MAAM;AACzB,KAAI,CAAC,OAAO,MAAM,IAAI,IAAI,OAAO,IAAI,KAAK,MAAO,QAAO;AACxD,QAAO"}

package/dist/url/stringifyQueryString.cjs

@@ -0,0 +1,38 @@
+//#region src/url/stringifyQueryString/index.ts
+/**
+* 将对象序列化为 URL 查询字符串
+*
+* 支持嵌套对象用 `encodeURIComponent` 编码，数组值生成重复 key
+*
+* @param params - 要序列化的键值对对象
+* @returns 查询字符串（不含前导 `?`），无参数时返回空字符串
+*
+* @example
+* ```ts
+* import stringifyQueryString from '@tanwan/utils/stringifyQueryString'
+* stringifyQueryString({ name: 'John', age: 25 })     // 'name=John&age=25'
+* stringifyQueryString({ ids: [1, 2, 3] })            // 'ids=1&ids=2&ids=3'
+* stringifyQueryString({ q: 'hello world' })          // 'q=hello%20world'
+* stringifyQueryString({ a: null, b: undefined })     // 'a='
+* stringifyQueryString({})                            // ''
+* ```
+*/
+function stringifyQueryString(params) {
+	const parts = [];
+	for (const key of Object.keys(params)) {
+		const value = params[key];
+		if (value === void 0) continue;
+		if (value === null) {
+			parts.push(`${encodeURIComponent(key)}=`);
+			continue;
+		}
+		if (Array.isArray(value)) {
+			for (const item of value) parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+			continue;
+		}
+		parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+	}
+	return parts.join("&");
+}
+//#endregion
+module.exports = stringifyQueryString;

package/dist/url/stringifyQueryString.d.cts

@@ -0,0 +1,22 @@
+//#region src/url/stringifyQueryString/index.d.ts
+/**
+* 将对象序列化为 URL 查询字符串
+*
+* 支持嵌套对象用 `encodeURIComponent` 编码，数组值生成重复 key
+*
+* @param params - 要序列化的键值对对象
+* @returns 查询字符串（不含前导 `?`），无参数时返回空字符串
+*
+* @example
+* ```ts
+* import stringifyQueryString from '@tanwan/utils/stringifyQueryString'
+* stringifyQueryString({ name: 'John', age: 25 })     // 'name=John&age=25'
+* stringifyQueryString({ ids: [1, 2, 3] })            // 'ids=1&ids=2&ids=3'
+* stringifyQueryString({ q: 'hello world' })          // 'q=hello%20world'
+* stringifyQueryString({ a: null, b: undefined })     // 'a='
+* stringifyQueryString({})                            // ''
+* ```
+*/
+declare function stringifyQueryString(params: Record<string, unknown>): string;
+export = stringifyQueryString;
+//# sourceMappingURL=stringifyQueryString.d.cts.map

package/dist/url/stringifyQueryString.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyQueryString.d.cts","names":[],"sources":["../../src/url/stringifyQueryString/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;iBAkBwB,oBAAA,CAAqB,MAAA,EAAQ,MAAA;AAAA"}

package/dist/url/stringifyQueryString.d.ts

@@ -0,0 +1,23 @@
+//#region src/url/stringifyQueryString/index.d.ts
+/**
+* 将对象序列化为 URL 查询字符串
+*
+* 支持嵌套对象用 `encodeURIComponent` 编码，数组值生成重复 key
+*
+* @param params - 要序列化的键值对对象
+* @returns 查询字符串（不含前导 `?`），无参数时返回空字符串
+*
+* @example
+* ```ts
+* import stringifyQueryString from '@tanwan/utils/stringifyQueryString'
+* stringifyQueryString({ name: 'John', age: 25 })     // 'name=John&age=25'
+* stringifyQueryString({ ids: [1, 2, 3] })            // 'ids=1&ids=2&ids=3'
+* stringifyQueryString({ q: 'hello world' })          // 'q=hello%20world'
+* stringifyQueryString({ a: null, b: undefined })     // 'a='
+* stringifyQueryString({})                            // ''
+* ```
+*/
+declare function stringifyQueryString(params: Record<string, unknown>): string;
+//#endregion
+export { stringifyQueryString as default };
+//# sourceMappingURL=stringifyQueryString.d.ts.map

package/dist/url/stringifyQueryString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyQueryString.d.ts","names":[],"sources":["../../src/url/stringifyQueryString/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;iBAkBwB,oBAAA,CAAqB,MAAA,EAAQ,MAAA"}

package/dist/url/stringifyQueryString.js

@@ -0,0 +1,40 @@
+//#region src/url/stringifyQueryString/index.ts
+/**
+* 将对象序列化为 URL 查询字符串
+*
+* 支持嵌套对象用 `encodeURIComponent` 编码，数组值生成重复 key
+*
+* @param params - 要序列化的键值对对象
+* @returns 查询字符串（不含前导 `?`），无参数时返回空字符串
+*
+* @example
+* ```ts
+* import stringifyQueryString from '@tanwan/utils/stringifyQueryString'
+* stringifyQueryString({ name: 'John', age: 25 })     // 'name=John&age=25'
+* stringifyQueryString({ ids: [1, 2, 3] })            // 'ids=1&ids=2&ids=3'
+* stringifyQueryString({ q: 'hello world' })          // 'q=hello%20world'
+* stringifyQueryString({ a: null, b: undefined })     // 'a='
+* stringifyQueryString({})                            // ''
+* ```
+*/
+function stringifyQueryString(params) {
+	const parts = [];
+	for (const key of Object.keys(params)) {
+		const value = params[key];
+		if (value === void 0) continue;
+		if (value === null) {
+			parts.push(`${encodeURIComponent(key)}=`);
+			continue;
+		}
+		if (Array.isArray(value)) {
+			for (const item of value) parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+			continue;
+		}
+		parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+	}
+	return parts.join("&");
+}
+//#endregion
+export { stringifyQueryString as default };
+
+//# sourceMappingURL=stringifyQueryString.js.map

package/dist/url/stringifyQueryString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyQueryString.js","names":[],"sources":["../../src/url/stringifyQueryString/index.ts"],"sourcesContent":["/**\n * 将对象序列化为 URL 查询字符串\n *\n * 支持嵌套对象用 `encodeURIComponent` 编码，数组值生成重复 key\n *\n * @param params - 要序列化的键值对对象\n * @returns 查询字符串（不含前导 `?`），无参数时返回空字符串\n *\n * @example\n * ```ts\n * import stringifyQueryString from '@tanwan/utils/stringifyQueryString'\n * stringifyQueryString({ name: 'John', age: 25 })     // 'name=John&age=25'\n * stringifyQueryString({ ids: [1, 2, 3] })            // 'ids=1&ids=2&ids=3'\n * stringifyQueryString({ q: 'hello world' })          // 'q=hello%20world'\n * stringifyQueryString({ a: null, b: undefined })     // 'a='\n * stringifyQueryString({})                            // ''\n * ```\n */\nexport default function stringifyQueryString(params: Record<string, unknown>): string {\n  const parts: string[] = [];\n\n  for (const key of Object.keys(params)) {\n    const value = params[key];\n\n    if (value === undefined) {\n      continue;\n    }\n\n    if (value === null) {\n      parts.push(`${encodeURIComponent(key)}=`);\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);\n      }\n      continue;\n    }\n\n    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n\n  return parts.join('&');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAwB,qBAAqB,QAAyC;CACpF,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,EAAE;EACrC,MAAM,QAAQ,OAAO;AAErB,MAAI,UAAU,KAAA,EACZ;AAGF,MAAI,UAAU,MAAM;AAClB,SAAM,KAAK,GAAG,mBAAmB,IAAI,CAAC,GAAG;AACzC;;AAGF,MAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAK,MAAM,QAAQ,MACjB,OAAM,KAAK,GAAG,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,OAAO,KAAK,CAAC,GAAG;AAE9E;;AAGF,QAAM,KAAK,GAAG,mBAAmB,IAAI,CAAC,GAAG,mBAAmB,OAAO,MAAM,CAAC,GAAG;;AAG/E,QAAO,MAAM,KAAK,IAAI"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@tanwan/utils",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "前端纯JS工具函数库",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.cts",
-  "unpkg": "./dist/index.global.js",
-  "jsdelivr": "./dist/index.global.js",
+  "unpkg": "./dist/index.iife.js",
+  "jsdelivr": "./dist/index.iife.js",
   "sideEffects": false,
   "files": [
     "dist"
@@ -26,6 +26,14 @@
       "import": "./dist/array/flatten.js",
       "require": "./dist/array/flatten.cjs"
     },
+    "./array/groupBy": {
+      "import": "./dist/array/groupBy.js",
+      "require": "./dist/array/groupBy.cjs"
+    },
+    "./array/range": {
+      "import": "./dist/array/range.js",
+      "require": "./dist/array/range.cjs"
+    },
     "./array/shuffle": {
       "import": "./dist/array/shuffle.js",
       "require": "./dist/array/shuffle.cjs"
@@ -42,6 +50,10 @@
       "import": "./dist/base/isArray.js",
       "require": "./dist/base/isArray.cjs"
     },
+    "./base/isEmpty": {
+      "import": "./dist/base/isEmpty.js",
+      "require": "./dist/base/isEmpty.cjs"
+    },
     "./base/isObject": {
       "import": "./dist/base/isObject.js",
       "require": "./dist/base/isObject.cjs"
@@ -62,6 +74,10 @@
       "import": "./dist/function/debounce.js",
       "require": "./dist/function/debounce.cjs"
     },
+    "./function/delay": {
+      "import": "./dist/function/delay.js",
+      "require": "./dist/function/delay.cjs"
+    },
     "./function/throttle": {
       "import": "./dist/function/throttle.js",
       "require": "./dist/function/throttle.cjs"
@@ -78,6 +94,14 @@
       "import": "./dist/number/randomInt.js",
       "require": "./dist/number/randomInt.cjs"
     },
+    "./object/omit": {
+      "import": "./dist/object/omit.js",
+      "require": "./dist/object/omit.cjs"
+    },
+    "./object/pick": {
+      "import": "./dist/object/pick.js",
+      "require": "./dist/object/pick.cjs"
+    },
     "./string/camelCase": {
       "import": "./dist/string/camelCase.js",
       "require": "./dist/string/camelCase.cjs"
@@ -90,6 +114,18 @@
       "import": "./dist/string/kebabCase.js",
       "require": "./dist/string/kebabCase.cjs"
     },
+    "./string/uuid": {
+      "import": "./dist/string/uuid.js",
+      "require": "./dist/string/uuid.cjs"
+    },
+    "./url/parseQueryString": {
+      "import": "./dist/url/parseQueryString.js",
+      "require": "./dist/url/parseQueryString.cjs"
+    },
+    "./url/stringifyQueryString": {
+      "import": "./dist/url/stringifyQueryString.js",
+      "require": "./dist/url/stringifyQueryString.cjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {