@lytjs/common-query 6.5.0 → 6.7.0

package/README.md

@@ -1,93 +1,93 @@
-# @lytjs/common-query
-
-URL 查询字符串解析与构建工具，提供轻量级的 URL 处理能力。
-
-## 安装
-
-```bash
-pnpm add @lytjs/common-query
-```
-
-## API
-
-### `parseQueryString(search: string): Record<string, string>`
-
-解析 URL 查询字符串为对象。
-
-```typescript
-import { parseQueryString } from '@lytjs/common-query';
-
-parseQueryString('?key=value&key2=value2');
-// { key: 'value', key2: 'value2' }
-
-parseQueryString('key=value&key2=value2');
-// { key: 'value', key2: 'value2' }
-
-parseQueryString('?name=hello%20world');
-// { name: 'hello world' }
-```
-
-### `stringifyQueryString(params: Record<string, string | number | boolean>): string`
-
-将对象序列化为查询字符串。
-
-```typescript
-import { stringifyQueryString } from '@lytjs/common-query';
-
-stringifyQueryString({ a: '1', b: '2' });
-// 'a=1&b=2'
-
-stringifyQueryString({ name: 'hello world' });
-// 'name=hello%20world'
-```
-
-### `parseURL(url: string): ParsedURL`
-
-解析完整 URL，返回结构化信息。
-
-```typescript
-import { parseURL } from '@lytjs/common-query';
-
-parseURL('https://example.com:8080/path?name=test#section');
-// {
-//   protocol: 'https://',
-//   host: 'example.com:8080',
-//   hostname: 'example.com',
-//   port: '8080',
-//   pathname: '/path',
-//   search: '?name=test',
-//   hash: '#section',
-//   searchParams: { name: 'test' },
-//   origin: 'https://example.com:8080',
-//   href: 'https://example.com:8080/path?name=test#section'
-// }
-```
-
-### `buildURL(base: string, params?, hash?): string`
-
-构建完整 URL，支持合并已有查询参数。
-
-```typescript
-import { buildURL } from '@lytjs/common-query';
-
-buildURL('https://example.com/path', { a: '1', b: '2' });
-// 'https://example.com/path?a=1&b=2'
-
-buildURL('https://example.com/path?existing=1', { new: '2' });
-// 'https://example.com/path?existing=1&new=2'
-
-buildURL('/path', { page: 1 }, 'top');
-// '/path?page=1#top'
-```
-
-## 特性
-
-- 零运行时依赖
-- 体积 < 2KB（min+gzip）
-- 支持绝对 URL 和相对 URL
-- 自动编解码 URI 组件
-- TypeScript 类型完整
-
-## License
-
-MIT
+# @lytjs/common-query
+
+URL 查询字符串解析与构建工具，提供轻量级的 URL 处理能力。
+
+## 安装
+
+```bash
+pnpm add @lytjs/common-query
+```
+
+## API
+
+### `parseQueryString(search: string): Record<string, string>`
+
+解析 URL 查询字符串为对象。
+
+```typescript
+import { parseQueryString } from '@lytjs/common-query';
+
+parseQueryString('?key=value&key2=value2');
+// { key: 'value', key2: 'value2' }
+
+parseQueryString('key=value&key2=value2');
+// { key: 'value', key2: 'value2' }
+
+parseQueryString('?name=hello%20world');
+// { name: 'hello world' }
+```
+
+### `stringifyQueryString(params: Record<string, string | number | boolean>): string`
+
+将对象序列化为查询字符串。
+
+```typescript
+import { stringifyQueryString } from '@lytjs/common-query';
+
+stringifyQueryString({ a: '1', b: '2' });
+// 'a=1&b=2'
+
+stringifyQueryString({ name: 'hello world' });
+// 'name=hello%20world'
+```
+
+### `parseURL(url: string): ParsedURL`
+
+解析完整 URL，返回结构化信息。
+
+```typescript
+import { parseURL } from '@lytjs/common-query';
+
+parseURL('https://example.com:8080/path?name=test#section');
+// {
+//   protocol: 'https://',
+//   host: 'example.com:8080',
+//   hostname: 'example.com',
+//   port: '8080',
+//   pathname: '/path',
+//   search: '?name=test',
+//   hash: '#section',
+//   searchParams: { name: 'test' },
+//   origin: 'https://example.com:8080',
+//   href: 'https://example.com:8080/path?name=test#section'
+// }
+```
+
+### `buildURL(base: string, params?, hash?): string`
+
+构建完整 URL，支持合并已有查询参数。
+
+```typescript
+import { buildURL } from '@lytjs/common-query';
+
+buildURL('https://example.com/path', { a: '1', b: '2' });
+// 'https://example.com/path?a=1&b=2'
+
+buildURL('https://example.com/path?existing=1', { new: '2' });
+// 'https://example.com/path?existing=1&new=2'
+
+buildURL('/path', { page: 1 }, 'top');
+// '/path?page=1#top'
+```
+
+## 特性
+
+- 零运行时依赖
+- 体积 < 2KB（min+gzip）
+- 支持绝对 URL 和相对 URL
+- 自动编解码 URI 组件
+- TypeScript 类型完整
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1,10 +1,46 @@
 'use strict';
 
 // src/index.ts
-function parseQueryString(search) {
+function parseQueryString(search, options) {
   if (!search) return {};
   const str = search.startsWith("?") ? search.slice(1) : search;
   if (!str) return {};
+  const supportArrays = options?.supportArrays ?? false;
+  if (supportArrays) {
+    const result2 = {};
+    const pairs2 = str.split("&");
+    for (const pair of pairs2) {
+      if (!pair) continue;
+      const eqIndex = pair.indexOf("=");
+      let key;
+      let value;
+      if (eqIndex === -1) {
+        key = pair;
+        value = "";
+      } else {
+        key = pair.slice(0, eqIndex);
+        value = pair.slice(eqIndex + 1);
+      }
+      try {
+        key = decodeURIComponent(key);
+      } catch {
+      }
+      try {
+        value = decodeURIComponent(value);
+      } catch {
+      }
+      if (result2[key]) {
+        if (Array.isArray(result2[key])) {
+          result2[key].push(value);
+        } else {
+          result2[key] = [result2[key], value];
+        }
+      } else {
+        result2[key] = value;
+      }
+    }
+    return result2;
+  }
   const result = {};
   const pairs = str.split("&");
   for (const pair of pairs) {
@@ -31,19 +67,26 @@ function parseQueryString(search) {
   }
   return result;
 }
+function parseQueryStringWithArrays(search) {
+  return parseQueryString(search, { supportArrays: true });
+}
 function stringifyQueryString(params) {
   const keys = Object.keys(params);
   if (keys.length === 0) return "";
   const parts = [];
   for (const key of keys) {
     const value = params[key];
-    parts.push(
-      encodeURIComponent(key) + "=" + encodeURIComponent(String(value))
-    );
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        parts.push(encodeURIComponent(key) + "=" + encodeURIComponent(String(item)));
+      }
+    } else {
+      parts.push(encodeURIComponent(key) + "=" + encodeURIComponent(String(value)));
+    }
   }
   return parts.join("&");
 }
-function parseURL(url) {
+function parseURL(url, _options) {
   let rest = url;
   let hash = "";
   const hashIndex = rest.indexOf("#");
@@ -99,7 +142,7 @@ function parseURL(url) {
   } else {
     pathname = rest;
   }
-  const searchParams = parseQueryString(search);
+  const searchParams = parseQueryString(search, { supportArrays: true });
   const origin = protocol ? protocol + host : "";
   return {
     protocol,
@@ -130,10 +173,17 @@ function buildURL(base, params, hash) {
     existingSearch = baseWithoutHash.slice(searchIdx + 1);
     baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);
   }
-  const mergedParams = parseQueryString(existingSearch);
+  const mergedParams = parseQueryStringWithArrays(existingSearch);
   if (params) {
     for (const key of Object.keys(params)) {
-      mergedParams[key] = String(params[key]);
+      const value = params[key];
+      if (value !== void 0 && value !== null) {
+        if (Array.isArray(value)) {
+          mergedParams[key] = value.map((v) => String(v));
+        } else {
+          mergedParams[key] = String(value);
+        }
+      }
     }
   }
   const queryString = stringifyQueryString(mergedParams);
@@ -150,6 +200,7 @@ function buildURL(base, params, hash) {
 
 exports.buildURL = buildURL;
 exports.parseQueryString = parseQueryString;
+exports.parseQueryStringWithArrays = parseQueryStringWithArrays;
 exports.parseURL = parseURL;
 exports.stringifyQueryString = stringifyQueryString;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @lytjs/common-query\r\n * URL 查询字符串解析与构建工具\r\n */\r\n\r\n/**\r\n * 解析后的 URL 结构\r\n */\r\nexport interface ParsedURL {\r\n  protocol: string;\r\n  host: string;\r\n  hostname: string;\r\n  port: string;\r\n  pathname: string;\r\n  search: string;\r\n  hash: string;\r\n  searchParams: Record<string, string>;\r\n  origin: string;\r\n  href: string;\r\n}\r\n\r\n/**\r\n * 解析 URL 查询字符串为对象\r\n *\r\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\r\n * @returns 解析后的键值对对象\r\n */\r\nexport function parseQueryString(search: string): Record<string, string> {\r\n  if (!search) return {};\r\n\r\n  const str = search.startsWith('?') ? search.slice(1) : search;\r\n  if (!str) return {};\r\n\r\n  const result: Record<string, string> = {};\r\n\r\n  const pairs = str.split('&');\r\n  for (const pair of pairs) {\r\n    if (!pair) continue;\r\n    const eqIndex = pair.indexOf('=');\r\n    let key: string;\r\n    let value: string;\r\n    if (eqIndex === -1) {\r\n      key = pair;\r\n      value = '';\r\n    } else {\r\n      key = pair.slice(0, eqIndex);\r\n      value = pair.slice(eqIndex + 1);\r\n    }\r\n    try {\r\n      key = decodeURIComponent(key);\r\n    } catch {\r\n      // keep key as-is if decode fails\r\n    }\r\n    try {\r\n      value = decodeURIComponent(value);\r\n    } catch {\r\n      // keep value as-is if decode fails\r\n    }\r\n    result[key] = value;\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * 将对象序列化为查询字符串\r\n *\r\n * @param params - 键值对对象\r\n * @returns 序列化后的查询字符串（不含前导 ?）\r\n */\r\nexport function stringifyQueryString(\r\n  params: Record<string, string | number | boolean>,\r\n): string {\r\n  const keys = Object.keys(params);\r\n  if (keys.length === 0) return '';\r\n\r\n  const parts: string[] = [];\r\n  for (const key of keys) {\r\n    const value = params[key];\r\n    parts.push(\r\n      encodeURIComponent(key) + '=' + encodeURIComponent(String(value)),\r\n    );\r\n  }\r\n\r\n  return parts.join('&');\r\n}\r\n\r\n/**\r\n * 解析完整 URL\r\n *\r\n * @param url - URL 字符串，支持绝对 URL 和相对 URL\r\n * @returns 解析后的 ParsedURL 对象\r\n */\r\nexport function parseURL(url: string): ParsedURL {\r\n  let rest = url;\r\n\r\n  // Extract hash\r\n  let hash = '';\r\n  const hashIndex = rest.indexOf('#');\r\n  if (hashIndex !== -1) {\r\n    hash = rest.slice(hashIndex);\r\n    rest = rest.slice(0, hashIndex);\r\n  }\r\n\r\n  // Extract search\r\n  let search = '';\r\n  const searchIndex = rest.indexOf('?');\r\n  if (searchIndex !== -1) {\r\n    search = rest.slice(searchIndex);\r\n    rest = rest.slice(0, searchIndex);\r\n  }\r\n\r\n  // Extract protocol\r\n  let protocol = '';\r\n  const protocolIndex = rest.indexOf('://');\r\n  if (protocolIndex !== -1) {\r\n    protocol = rest.slice(0, protocolIndex + 3);\r\n    rest = rest.slice(protocolIndex + 3);\r\n  }\r\n\r\n  // Extract pathname (everything after host)\r\n  let pathname = '';\r\n  let host = '';\r\n  let hostname = '';\r\n  let port = '';\r\n\r\n  if (protocol) {\r\n    // Absolute URL: extract host and pathname\r\n    const slashIndex = rest.indexOf('/');\r\n    if (slashIndex !== -1) {\r\n      host = rest.slice(0, slashIndex);\r\n      pathname = rest.slice(slashIndex);\r\n    } else {\r\n      host = rest;\r\n      pathname = '';\r\n    }\r\n\r\n    // Parse host into hostname and port\r\n    // Handle IPv6 addresses like [::1]:8080\r\n    if (host.startsWith('[')) {\r\n      const bracketEnd = host.indexOf(']');\r\n      if (bracketEnd !== -1) {\r\n        hostname = host.slice(0, bracketEnd + 1);\r\n        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {\r\n          port = host.slice(bracketEnd + 2);\r\n        }\r\n      } else {\r\n        hostname = host;\r\n      }\r\n    } else {\r\n      const colonIndex = host.lastIndexOf(':');\r\n      if (colonIndex !== -1) {\r\n        hostname = host.slice(0, colonIndex);\r\n        port = host.slice(colonIndex + 1);\r\n      } else {\r\n        hostname = host;\r\n        port = '';\r\n      }\r\n    }\r\n  } else {\r\n    // Relative URL\r\n    pathname = rest;\r\n  }\r\n\r\n  const searchParams = parseQueryString(search);\r\n  const origin = protocol ? protocol + host : '';\r\n\r\n  return {\r\n    protocol,\r\n    host,\r\n    hostname,\r\n    port,\r\n    pathname,\r\n    search,\r\n    hash,\r\n    searchParams,\r\n    origin,\r\n    href: url,\r\n  };\r\n}\r\n\r\n/**\r\n * 构建完整 URL\r\n *\r\n * @param base - 基础 URL\r\n * @param params - 查询参数（可选）\r\n * @param hash - hash 片段（可选，不含 #）\r\n * @returns 构建后的完整 URL\r\n */\r\nexport function buildURL(\r\n  base: string,\r\n  params?: Record<string, string | number | boolean>,\r\n  hash?: string,\r\n): string {\r\n  if (!params && !hash) return base;\r\n\r\n  // Extract and remove existing hash from base\r\n  let baseWithoutHash = base;\r\n  let existingHash = '';\r\n  const hashIdx = base.indexOf('#');\r\n  if (hashIdx !== -1) {\r\n    existingHash = base.slice(hashIdx);\r\n    baseWithoutHash = base.slice(0, hashIdx);\r\n  }\r\n\r\n  // Parse existing query params from base (without hash)\r\n  let existingSearch = '';\r\n  let baseWithoutSearch = baseWithoutHash;\r\n  const searchIdx = baseWithoutHash.indexOf('?');\r\n  if (searchIdx !== -1) {\r\n    existingSearch = baseWithoutHash.slice(searchIdx + 1);\r\n    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);\r\n  }\r\n\r\n  // Merge existing and new params\r\n  const mergedParams = parseQueryString(existingSearch);\r\n  if (params) {\r\n    for (const key of Object.keys(params)) {\r\n      mergedParams[key] = String(params[key]);\r\n    }\r\n  }\r\n\r\n  const queryString = stringifyQueryString(mergedParams);\r\n  let result = baseWithoutSearch;\r\n  if (queryString) {\r\n    result += '?' + queryString;\r\n  }\r\n  // Use provided hash, or keep existing hash if no new hash is given\r\n  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;\r\n  if (finalHash) {\r\n    result += finalHash;\r\n  }\r\n\r\n  return result;\r\n}\r\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["result","pairs"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lytjs/common-query\n * URL 查询字符串解析与构建工具\n */\n\n/**\n * 解析后的 URL 结构\n */\nexport interface ParsedURL {\n  protocol: string;\n  host: string;\n  hostname: string;\n  port: string;\n  pathname: string;\n  search: string;\n  hash: string;\n  searchParams: Record<string, string | string[]>;\n  origin: string;\n  href: string;\n}\n\n/**\n * 解析 URL 查询字符串为对象\n *\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\n * @param options - 解析选项\n * @returns 解析后的键值对对象\n */\nexport function parseQueryString(\n  search: string,\n  options?: { supportArrays?: boolean },\n): Record<string, string> | Record<string, string | string[]> {\n  if (!search) return {};\n\n  const str = search.startsWith('?') ? search.slice(1) : search;\n  if (!str) return {};\n\n  const supportArrays = options?.supportArrays ?? false;\n\n  if (supportArrays) {\n    const result: Record<string, string | string[]> = {};\n    const pairs = str.split('&');\n    for (const pair of pairs) {\n      if (!pair) continue;\n      const eqIndex = pair.indexOf('=');\n      let key: string;\n      let value: string;\n      if (eqIndex === -1) {\n        key = pair;\n        value = '';\n      } else {\n        key = pair.slice(0, eqIndex);\n        value = pair.slice(eqIndex + 1);\n      }\n      try {\n        key = decodeURIComponent(key);\n      } catch {\n        // keep key as-is if decode fails\n      }\n      try {\n        value = decodeURIComponent(value);\n      } catch {\n        // keep value as-is if decode fails\n      }\n\n      if (result[key]) {\n        if (Array.isArray(result[key])) {\n          (result[key] as string[]).push(value);\n        } else {\n          result[key] = [result[key] as string, value];\n        }\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n\n  // 保持原有的行为（向后兼容）\n  const result: Record<string, string> = {};\n  const pairs = str.split('&');\n  for (const pair of pairs) {\n    if (!pair) continue;\n    const eqIndex = pair.indexOf('=');\n    let key: string;\n    let value: string;\n    if (eqIndex === -1) {\n      key = pair;\n      value = '';\n    } else {\n      key = pair.slice(0, eqIndex);\n      value = pair.slice(eqIndex + 1);\n    }\n    try {\n      key = decodeURIComponent(key);\n    } catch {\n      // keep key as-is if decode fails\n    }\n    try {\n      value = decodeURIComponent(value);\n    } catch {\n      // keep value as-is if decode fails\n    }\n    result[key] = value;\n  }\n  return result;\n}\n\n/**\n * 解析 URL 查询字符串为对象，支持数组值（重复键）\n * 这是 parseQueryString 支持数组的便捷版本\n *\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\n * @returns 解析后的键值对对象\n */\nexport function parseQueryStringWithArrays(search: string): Record<string, string | string[]> {\n  return parseQueryString(search, { supportArrays: true }) as Record<string, string | string[]>;\n}\n\n/**\n * 将对象序列化为查询字符串\n *\n * @param params - 键值对对象，支持数组值\n * @returns 序列化后的查询字符串（不含前导 ?）\n */\nexport function stringifyQueryString(\n  params: Record<string, string | number | boolean | Array<string | number | boolean>>,\n): string {\n  const keys = Object.keys(params);\n  if (keys.length === 0) return '';\n\n  const parts: string[] = [];\n  for (const key of keys) {\n    const value = params[key];\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(item)));\n      }\n    } else {\n      parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(value)));\n    }\n  }\n\n  return parts.join('&');\n}\n\n/**\n * 解析完整 URL\n *\n * @param url - URL 字符串，支持绝对 URL 和相对 URL\n * @returns 解析后的 ParsedURL 对象\n */\nexport function parseURL(url: string, _options?: { supportArrays?: boolean }): ParsedURL {\n  let rest = url;\n\n  // Extract hash\n  let hash = '';\n  const hashIndex = rest.indexOf('#');\n  if (hashIndex !== -1) {\n    hash = rest.slice(hashIndex);\n    rest = rest.slice(0, hashIndex);\n  }\n\n  // Extract search\n  let search = '';\n  const searchIndex = rest.indexOf('?');\n  if (searchIndex !== -1) {\n    search = rest.slice(searchIndex);\n    rest = rest.slice(0, searchIndex);\n  }\n\n  // Extract protocol\n  let protocol = '';\n  const protocolIndex = rest.indexOf('://');\n  if (protocolIndex !== -1) {\n    protocol = rest.slice(0, protocolIndex + 3);\n    rest = rest.slice(protocolIndex + 3);\n  }\n\n  // Extract pathname (everything after host)\n  let pathname = '';\n  let host = '';\n  let hostname = '';\n  let port = '';\n\n  if (protocol) {\n    // Absolute URL: extract host and pathname\n    const slashIndex = rest.indexOf('/');\n    if (slashIndex !== -1) {\n      host = rest.slice(0, slashIndex);\n      pathname = rest.slice(slashIndex);\n    } else {\n      host = rest;\n      pathname = '';\n    }\n\n    // Parse host into hostname and port\n    // Handle IPv6 addresses like [::1]:8080\n    if (host.startsWith('[')) {\n      const bracketEnd = host.indexOf(']');\n      if (bracketEnd !== -1) {\n        hostname = host.slice(0, bracketEnd + 1);\n        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {\n          port = host.slice(bracketEnd + 2);\n        }\n      } else {\n        hostname = host;\n      }\n    } else {\n      const colonIndex = host.lastIndexOf(':');\n      if (colonIndex !== -1) {\n        hostname = host.slice(0, colonIndex);\n        port = host.slice(colonIndex + 1);\n      } else {\n        hostname = host;\n        port = '';\n      }\n    }\n  } else {\n    // Relative URL\n    pathname = rest;\n  }\n\n  const searchParams = parseQueryString(search, { supportArrays: true }) as Record<\n    string,\n    string | string[]\n  >;\n  const origin = protocol ? protocol + host : '';\n\n  return {\n    protocol,\n    host,\n    hostname,\n    port,\n    pathname,\n    search,\n    hash,\n    searchParams,\n    origin,\n    href: url,\n  };\n}\n\n/**\n * 构建完整 URL\n *\n * @param base - 基础 URL\n * @param params - 查询参数（可选）\n * @param hash - hash 片段（可选，不含 #）\n * @returns 构建后的完整 URL\n */\nexport function buildURL(\n  base: string,\n  params?: Record<string, string | number | boolean | Array<string | number | boolean>>,\n  hash?: string,\n): string {\n  if (!params && !hash) return base;\n\n  // Extract and remove existing hash from base\n  let baseWithoutHash = base;\n  let existingHash = '';\n  const hashIdx = base.indexOf('#');\n  if (hashIdx !== -1) {\n    existingHash = base.slice(hashIdx);\n    baseWithoutHash = base.slice(0, hashIdx);\n  }\n\n  // Parse existing query params from base (without hash)\n  let existingSearch = '';\n  let baseWithoutSearch = baseWithoutHash;\n  const searchIdx = baseWithoutHash.indexOf('?');\n  if (searchIdx !== -1) {\n    existingSearch = baseWithoutHash.slice(searchIdx + 1);\n    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);\n  }\n\n  // Merge existing and new params\n  const mergedParams = parseQueryStringWithArrays(existingSearch);\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key];\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          mergedParams[key] = value.map((v) => String(v));\n        } else {\n          mergedParams[key] = String(value);\n        }\n      }\n    }\n  }\n\n  const queryString = stringifyQueryString(mergedParams);\n  let result = baseWithoutSearch;\n  if (queryString) {\n    result += '?' + queryString;\n  }\n  // Use provided hash, or keep existing hash if no new hash is given\n  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;\n  if (finalHash) {\n    result += finalHash;\n  }\n\n  return result;\n}\n"]}

package/dist/index.d.mts

@@ -13,7 +13,7 @@ interface ParsedURL {
     pathname: string;
     search: string;
     hash: string;
-    searchParams: Record<string, string>;
+    searchParams: Record<string, string | string[]>;
     origin: string;
     href: string;
 }
@@ -21,23 +21,36 @@ interface ParsedURL {
  * 解析 URL 查询字符串为对象
  *
  * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @param options - 解析选项
  * @returns 解析后的键值对对象
  */
-declare function parseQueryString(search: string): Record<string, string>;
+declare function parseQueryString(search: string, options?: {
+    supportArrays?: boolean;
+}): Record<string, string> | Record<string, string | string[]>;
+/**
+ * 解析 URL 查询字符串为对象，支持数组值（重复键）
+ * 这是 parseQueryString 支持数组的便捷版本
+ *
+ * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @returns 解析后的键值对对象
+ */
+declare function parseQueryStringWithArrays(search: string): Record<string, string | string[]>;
 /**
  * 将对象序列化为查询字符串
  *
- * @param params - 键值对对象
+ * @param params - 键值对对象，支持数组值
  * @returns 序列化后的查询字符串（不含前导 ?）
  */
-declare function stringifyQueryString(params: Record<string, string | number | boolean>): string;
+declare function stringifyQueryString(params: Record<string, string | number | boolean | Array<string | number | boolean>>): string;
 /**
  * 解析完整 URL
  *
  * @param url - URL 字符串，支持绝对 URL 和相对 URL
  * @returns 解析后的 ParsedURL 对象
  */
-declare function parseURL(url: string): ParsedURL;
+declare function parseURL(url: string, _options?: {
+    supportArrays?: boolean;
+}): ParsedURL;
 /**
  * 构建完整 URL
  *
@@ -46,6 +59,6 @@ declare function parseURL(url: string): ParsedURL;
  * @param hash - hash 片段（可选，不含 #）
  * @returns 构建后的完整 URL
  */
-declare function buildURL(base: string, params?: Record<string, string | number | boolean>, hash?: string): string;
+declare function buildURL(base: string, params?: Record<string, string | number | boolean | Array<string | number | boolean>>, hash?: string): string;
 
-export { type ParsedURL, buildURL, parseQueryString, parseURL, stringifyQueryString };
+export { type ParsedURL, buildURL, parseQueryString, parseQueryStringWithArrays, parseURL, stringifyQueryString };

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface ParsedURL {
     pathname: string;
     search: string;
     hash: string;
-    searchParams: Record<string, string>;
+    searchParams: Record<string, string | string[]>;
     origin: string;
     href: string;
 }
@@ -21,23 +21,36 @@ interface ParsedURL {
  * 解析 URL 查询字符串为对象
  *
  * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @param options - 解析选项
  * @returns 解析后的键值对对象
  */
-declare function parseQueryString(search: string): Record<string, string>;
+declare function parseQueryString(search: string, options?: {
+    supportArrays?: boolean;
+}): Record<string, string> | Record<string, string | string[]>;
+/**
+ * 解析 URL 查询字符串为对象，支持数组值（重复键）
+ * 这是 parseQueryString 支持数组的便捷版本
+ *
+ * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @returns 解析后的键值对对象
+ */
+declare function parseQueryStringWithArrays(search: string): Record<string, string | string[]>;
 /**
  * 将对象序列化为查询字符串
  *
- * @param params - 键值对对象
+ * @param params - 键值对对象，支持数组值
  * @returns 序列化后的查询字符串（不含前导 ?）
  */
-declare function stringifyQueryString(params: Record<string, string | number | boolean>): string;
+declare function stringifyQueryString(params: Record<string, string | number | boolean | Array<string | number | boolean>>): string;
 /**
  * 解析完整 URL
  *
  * @param url - URL 字符串，支持绝对 URL 和相对 URL
  * @returns 解析后的 ParsedURL 对象
  */
-declare function parseURL(url: string): ParsedURL;
+declare function parseURL(url: string, _options?: {
+    supportArrays?: boolean;
+}): ParsedURL;
 /**
  * 构建完整 URL
  *
@@ -46,6 +59,6 @@ declare function parseURL(url: string): ParsedURL;
  * @param hash - hash 片段（可选，不含 #）
  * @returns 构建后的完整 URL
  */
-declare function buildURL(base: string, params?: Record<string, string | number | boolean>, hash?: string): string;
+declare function buildURL(base: string, params?: Record<string, string | number | boolean | Array<string | number | boolean>>, hash?: string): string;
 
-export { type ParsedURL, buildURL, parseQueryString, parseURL, stringifyQueryString };
+export { type ParsedURL, buildURL, parseQueryString, parseQueryStringWithArrays, parseURL, stringifyQueryString };

package/dist/index.mjs

@@ -1,8 +1,44 @@
 // src/index.ts
-function parseQueryString(search) {
+function parseQueryString(search, options) {
   if (!search) return {};
   const str = search.startsWith("?") ? search.slice(1) : search;
   if (!str) return {};
+  const supportArrays = options?.supportArrays ?? false;
+  if (supportArrays) {
+    const result2 = {};
+    const pairs2 = str.split("&");
+    for (const pair of pairs2) {
+      if (!pair) continue;
+      const eqIndex = pair.indexOf("=");
+      let key;
+      let value;
+      if (eqIndex === -1) {
+        key = pair;
+        value = "";
+      } else {
+        key = pair.slice(0, eqIndex);
+        value = pair.slice(eqIndex + 1);
+      }
+      try {
+        key = decodeURIComponent(key);
+      } catch {
+      }
+      try {
+        value = decodeURIComponent(value);
+      } catch {
+      }
+      if (result2[key]) {
+        if (Array.isArray(result2[key])) {
+          result2[key].push(value);
+        } else {
+          result2[key] = [result2[key], value];
+        }
+      } else {
+        result2[key] = value;
+      }
+    }
+    return result2;
+  }
   const result = {};
   const pairs = str.split("&");
   for (const pair of pairs) {
@@ -29,19 +65,26 @@ function parseQueryString(search) {
   }
   return result;
 }
+function parseQueryStringWithArrays(search) {
+  return parseQueryString(search, { supportArrays: true });
+}
 function stringifyQueryString(params) {
   const keys = Object.keys(params);
   if (keys.length === 0) return "";
   const parts = [];
   for (const key of keys) {
     const value = params[key];
-    parts.push(
-      encodeURIComponent(key) + "=" + encodeURIComponent(String(value))
-    );
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        parts.push(encodeURIComponent(key) + "=" + encodeURIComponent(String(item)));
+      }
+    } else {
+      parts.push(encodeURIComponent(key) + "=" + encodeURIComponent(String(value)));
+    }
   }
   return parts.join("&");
 }
-function parseURL(url) {
+function parseURL(url, _options) {
   let rest = url;
   let hash = "";
   const hashIndex = rest.indexOf("#");
@@ -97,7 +140,7 @@ function parseURL(url) {
   } else {
     pathname = rest;
   }
-  const searchParams = parseQueryString(search);
+  const searchParams = parseQueryString(search, { supportArrays: true });
   const origin = protocol ? protocol + host : "";
   return {
     protocol,
@@ -128,10 +171,17 @@ function buildURL(base, params, hash) {
     existingSearch = baseWithoutHash.slice(searchIdx + 1);
     baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);
   }
-  const mergedParams = parseQueryString(existingSearch);
+  const mergedParams = parseQueryStringWithArrays(existingSearch);
   if (params) {
     for (const key of Object.keys(params)) {
-      mergedParams[key] = String(params[key]);
+      const value = params[key];
+      if (value !== void 0 && value !== null) {
+        if (Array.isArray(value)) {
+          mergedParams[key] = value.map((v) => String(v));
+        } else {
+          mergedParams[key] = String(value);
+        }
+      }
     }
   }
   const queryString = stringifyQueryString(mergedParams);
@@ -146,6 +196,6 @@ function buildURL(base, params, hash) {
   return result;
 }
 
-export { buildURL, parseQueryString, parseURL, stringifyQueryString };
+export { buildURL, parseQueryString, parseQueryStringWithArrays, parseURL, stringifyQueryString };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * @lytjs/common-query\r\n * URL 查询字符串解析与构建工具\r\n */\r\n\r\n/**\r\n * 解析后的 URL 结构\r\n */\r\nexport interface ParsedURL {\r\n  protocol: string;\r\n  host: string;\r\n  hostname: string;\r\n  port: string;\r\n  pathname: string;\r\n  search: string;\r\n  hash: string;\r\n  searchParams: Record<string, string>;\r\n  origin: string;\r\n  href: string;\r\n}\r\n\r\n/**\r\n * 解析 URL 查询字符串为对象\r\n *\r\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\r\n * @returns 解析后的键值对对象\r\n */\r\nexport function parseQueryString(search: string): Record<string, string> {\r\n  if (!search) return {};\r\n\r\n  const str = search.startsWith('?') ? search.slice(1) : search;\r\n  if (!str) return {};\r\n\r\n  const result: Record<string, string> = {};\r\n\r\n  const pairs = str.split('&');\r\n  for (const pair of pairs) {\r\n    if (!pair) continue;\r\n    const eqIndex = pair.indexOf('=');\r\n    let key: string;\r\n    let value: string;\r\n    if (eqIndex === -1) {\r\n      key = pair;\r\n      value = '';\r\n    } else {\r\n      key = pair.slice(0, eqIndex);\r\n      value = pair.slice(eqIndex + 1);\r\n    }\r\n    try {\r\n      key = decodeURIComponent(key);\r\n    } catch {\r\n      // keep key as-is if decode fails\r\n    }\r\n    try {\r\n      value = decodeURIComponent(value);\r\n    } catch {\r\n      // keep value as-is if decode fails\r\n    }\r\n    result[key] = value;\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * 将对象序列化为查询字符串\r\n *\r\n * @param params - 键值对对象\r\n * @returns 序列化后的查询字符串（不含前导 ?）\r\n */\r\nexport function stringifyQueryString(\r\n  params: Record<string, string | number | boolean>,\r\n): string {\r\n  const keys = Object.keys(params);\r\n  if (keys.length === 0) return '';\r\n\r\n  const parts: string[] = [];\r\n  for (const key of keys) {\r\n    const value = params[key];\r\n    parts.push(\r\n      encodeURIComponent(key) + '=' + encodeURIComponent(String(value)),\r\n    );\r\n  }\r\n\r\n  return parts.join('&');\r\n}\r\n\r\n/**\r\n * 解析完整 URL\r\n *\r\n * @param url - URL 字符串，支持绝对 URL 和相对 URL\r\n * @returns 解析后的 ParsedURL 对象\r\n */\r\nexport function parseURL(url: string): ParsedURL {\r\n  let rest = url;\r\n\r\n  // Extract hash\r\n  let hash = '';\r\n  const hashIndex = rest.indexOf('#');\r\n  if (hashIndex !== -1) {\r\n    hash = rest.slice(hashIndex);\r\n    rest = rest.slice(0, hashIndex);\r\n  }\r\n\r\n  // Extract search\r\n  let search = '';\r\n  const searchIndex = rest.indexOf('?');\r\n  if (searchIndex !== -1) {\r\n    search = rest.slice(searchIndex);\r\n    rest = rest.slice(0, searchIndex);\r\n  }\r\n\r\n  // Extract protocol\r\n  let protocol = '';\r\n  const protocolIndex = rest.indexOf('://');\r\n  if (protocolIndex !== -1) {\r\n    protocol = rest.slice(0, protocolIndex + 3);\r\n    rest = rest.slice(protocolIndex + 3);\r\n  }\r\n\r\n  // Extract pathname (everything after host)\r\n  let pathname = '';\r\n  let host = '';\r\n  let hostname = '';\r\n  let port = '';\r\n\r\n  if (protocol) {\r\n    // Absolute URL: extract host and pathname\r\n    const slashIndex = rest.indexOf('/');\r\n    if (slashIndex !== -1) {\r\n      host = rest.slice(0, slashIndex);\r\n      pathname = rest.slice(slashIndex);\r\n    } else {\r\n      host = rest;\r\n      pathname = '';\r\n    }\r\n\r\n    // Parse host into hostname and port\r\n    // Handle IPv6 addresses like [::1]:8080\r\n    if (host.startsWith('[')) {\r\n      const bracketEnd = host.indexOf(']');\r\n      if (bracketEnd !== -1) {\r\n        hostname = host.slice(0, bracketEnd + 1);\r\n        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {\r\n          port = host.slice(bracketEnd + 2);\r\n        }\r\n      } else {\r\n        hostname = host;\r\n      }\r\n    } else {\r\n      const colonIndex = host.lastIndexOf(':');\r\n      if (colonIndex !== -1) {\r\n        hostname = host.slice(0, colonIndex);\r\n        port = host.slice(colonIndex + 1);\r\n      } else {\r\n        hostname = host;\r\n        port = '';\r\n      }\r\n    }\r\n  } else {\r\n    // Relative URL\r\n    pathname = rest;\r\n  }\r\n\r\n  const searchParams = parseQueryString(search);\r\n  const origin = protocol ? protocol + host : '';\r\n\r\n  return {\r\n    protocol,\r\n    host,\r\n    hostname,\r\n    port,\r\n    pathname,\r\n    search,\r\n    hash,\r\n    searchParams,\r\n    origin,\r\n    href: url,\r\n  };\r\n}\r\n\r\n/**\r\n * 构建完整 URL\r\n *\r\n * @param base - 基础 URL\r\n * @param params - 查询参数（可选）\r\n * @param hash - hash 片段（可选，不含 #）\r\n * @returns 构建后的完整 URL\r\n */\r\nexport function buildURL(\r\n  base: string,\r\n  params?: Record<string, string | number | boolean>,\r\n  hash?: string,\r\n): string {\r\n  if (!params && !hash) return base;\r\n\r\n  // Extract and remove existing hash from base\r\n  let baseWithoutHash = base;\r\n  let existingHash = '';\r\n  const hashIdx = base.indexOf('#');\r\n  if (hashIdx !== -1) {\r\n    existingHash = base.slice(hashIdx);\r\n    baseWithoutHash = base.slice(0, hashIdx);\r\n  }\r\n\r\n  // Parse existing query params from base (without hash)\r\n  let existingSearch = '';\r\n  let baseWithoutSearch = baseWithoutHash;\r\n  const searchIdx = baseWithoutHash.indexOf('?');\r\n  if (searchIdx !== -1) {\r\n    existingSearch = baseWithoutHash.slice(searchIdx + 1);\r\n    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);\r\n  }\r\n\r\n  // Merge existing and new params\r\n  const mergedParams = parseQueryString(existingSearch);\r\n  if (params) {\r\n    for (const key of Object.keys(params)) {\r\n      mergedParams[key] = String(params[key]);\r\n    }\r\n  }\r\n\r\n  const queryString = stringifyQueryString(mergedParams);\r\n  let result = baseWithoutSearch;\r\n  if (queryString) {\r\n    result += '?' + queryString;\r\n  }\r\n  // Use provided hash, or keep existing hash if no new hash is given\r\n  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;\r\n  if (finalHash) {\r\n    result += finalHash;\r\n  }\r\n\r\n  return result;\r\n}\r\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["result","pairs"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @lytjs/common-query\n * URL 查询字符串解析与构建工具\n */\n\n/**\n * 解析后的 URL 结构\n */\nexport interface ParsedURL {\n  protocol: string;\n  host: string;\n  hostname: string;\n  port: string;\n  pathname: string;\n  search: string;\n  hash: string;\n  searchParams: Record<string, string | string[]>;\n  origin: string;\n  href: string;\n}\n\n/**\n * 解析 URL 查询字符串为对象\n *\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\n * @param options - 解析选项\n * @returns 解析后的键值对对象\n */\nexport function parseQueryString(\n  search: string,\n  options?: { supportArrays?: boolean },\n): Record<string, string> | Record<string, string | string[]> {\n  if (!search) return {};\n\n  const str = search.startsWith('?') ? search.slice(1) : search;\n  if (!str) return {};\n\n  const supportArrays = options?.supportArrays ?? false;\n\n  if (supportArrays) {\n    const result: Record<string, string | string[]> = {};\n    const pairs = str.split('&');\n    for (const pair of pairs) {\n      if (!pair) continue;\n      const eqIndex = pair.indexOf('=');\n      let key: string;\n      let value: string;\n      if (eqIndex === -1) {\n        key = pair;\n        value = '';\n      } else {\n        key = pair.slice(0, eqIndex);\n        value = pair.slice(eqIndex + 1);\n      }\n      try {\n        key = decodeURIComponent(key);\n      } catch {\n        // keep key as-is if decode fails\n      }\n      try {\n        value = decodeURIComponent(value);\n      } catch {\n        // keep value as-is if decode fails\n      }\n\n      if (result[key]) {\n        if (Array.isArray(result[key])) {\n          (result[key] as string[]).push(value);\n        } else {\n          result[key] = [result[key] as string, value];\n        }\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n\n  // 保持原有的行为（向后兼容）\n  const result: Record<string, string> = {};\n  const pairs = str.split('&');\n  for (const pair of pairs) {\n    if (!pair) continue;\n    const eqIndex = pair.indexOf('=');\n    let key: string;\n    let value: string;\n    if (eqIndex === -1) {\n      key = pair;\n      value = '';\n    } else {\n      key = pair.slice(0, eqIndex);\n      value = pair.slice(eqIndex + 1);\n    }\n    try {\n      key = decodeURIComponent(key);\n    } catch {\n      // keep key as-is if decode fails\n    }\n    try {\n      value = decodeURIComponent(value);\n    } catch {\n      // keep value as-is if decode fails\n    }\n    result[key] = value;\n  }\n  return result;\n}\n\n/**\n * 解析 URL 查询字符串为对象，支持数组值（重复键）\n * 这是 parseQueryString 支持数组的便捷版本\n *\n * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式\n * @returns 解析后的键值对对象\n */\nexport function parseQueryStringWithArrays(search: string): Record<string, string | string[]> {\n  return parseQueryString(search, { supportArrays: true }) as Record<string, string | string[]>;\n}\n\n/**\n * 将对象序列化为查询字符串\n *\n * @param params - 键值对对象，支持数组值\n * @returns 序列化后的查询字符串（不含前导 ?）\n */\nexport function stringifyQueryString(\n  params: Record<string, string | number | boolean | Array<string | number | boolean>>,\n): string {\n  const keys = Object.keys(params);\n  if (keys.length === 0) return '';\n\n  const parts: string[] = [];\n  for (const key of keys) {\n    const value = params[key];\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(item)));\n      }\n    } else {\n      parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(value)));\n    }\n  }\n\n  return parts.join('&');\n}\n\n/**\n * 解析完整 URL\n *\n * @param url - URL 字符串，支持绝对 URL 和相对 URL\n * @returns 解析后的 ParsedURL 对象\n */\nexport function parseURL(url: string, _options?: { supportArrays?: boolean }): ParsedURL {\n  let rest = url;\n\n  // Extract hash\n  let hash = '';\n  const hashIndex = rest.indexOf('#');\n  if (hashIndex !== -1) {\n    hash = rest.slice(hashIndex);\n    rest = rest.slice(0, hashIndex);\n  }\n\n  // Extract search\n  let search = '';\n  const searchIndex = rest.indexOf('?');\n  if (searchIndex !== -1) {\n    search = rest.slice(searchIndex);\n    rest = rest.slice(0, searchIndex);\n  }\n\n  // Extract protocol\n  let protocol = '';\n  const protocolIndex = rest.indexOf('://');\n  if (protocolIndex !== -1) {\n    protocol = rest.slice(0, protocolIndex + 3);\n    rest = rest.slice(protocolIndex + 3);\n  }\n\n  // Extract pathname (everything after host)\n  let pathname = '';\n  let host = '';\n  let hostname = '';\n  let port = '';\n\n  if (protocol) {\n    // Absolute URL: extract host and pathname\n    const slashIndex = rest.indexOf('/');\n    if (slashIndex !== -1) {\n      host = rest.slice(0, slashIndex);\n      pathname = rest.slice(slashIndex);\n    } else {\n      host = rest;\n      pathname = '';\n    }\n\n    // Parse host into hostname and port\n    // Handle IPv6 addresses like [::1]:8080\n    if (host.startsWith('[')) {\n      const bracketEnd = host.indexOf(']');\n      if (bracketEnd !== -1) {\n        hostname = host.slice(0, bracketEnd + 1);\n        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {\n          port = host.slice(bracketEnd + 2);\n        }\n      } else {\n        hostname = host;\n      }\n    } else {\n      const colonIndex = host.lastIndexOf(':');\n      if (colonIndex !== -1) {\n        hostname = host.slice(0, colonIndex);\n        port = host.slice(colonIndex + 1);\n      } else {\n        hostname = host;\n        port = '';\n      }\n    }\n  } else {\n    // Relative URL\n    pathname = rest;\n  }\n\n  const searchParams = parseQueryString(search, { supportArrays: true }) as Record<\n    string,\n    string | string[]\n  >;\n  const origin = protocol ? protocol + host : '';\n\n  return {\n    protocol,\n    host,\n    hostname,\n    port,\n    pathname,\n    search,\n    hash,\n    searchParams,\n    origin,\n    href: url,\n  };\n}\n\n/**\n * 构建完整 URL\n *\n * @param base - 基础 URL\n * @param params - 查询参数（可选）\n * @param hash - hash 片段（可选，不含 #）\n * @returns 构建后的完整 URL\n */\nexport function buildURL(\n  base: string,\n  params?: Record<string, string | number | boolean | Array<string | number | boolean>>,\n  hash?: string,\n): string {\n  if (!params && !hash) return base;\n\n  // Extract and remove existing hash from base\n  let baseWithoutHash = base;\n  let existingHash = '';\n  const hashIdx = base.indexOf('#');\n  if (hashIdx !== -1) {\n    existingHash = base.slice(hashIdx);\n    baseWithoutHash = base.slice(0, hashIdx);\n  }\n\n  // Parse existing query params from base (without hash)\n  let existingSearch = '';\n  let baseWithoutSearch = baseWithoutHash;\n  const searchIdx = baseWithoutHash.indexOf('?');\n  if (searchIdx !== -1) {\n    existingSearch = baseWithoutHash.slice(searchIdx + 1);\n    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);\n  }\n\n  // Merge existing and new params\n  const mergedParams = parseQueryStringWithArrays(existingSearch);\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key];\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          mergedParams[key] = value.map((v) => String(v));\n        } else {\n          mergedParams[key] = String(value);\n        }\n      }\n    }\n  }\n\n  const queryString = stringifyQueryString(mergedParams);\n  let result = baseWithoutSearch;\n  if (queryString) {\n    result += '?' + queryString;\n  }\n  // Use provided hash, or keep existing hash if no new hash is given\n  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;\n  if (finalHash) {\n    result += finalHash;\n  }\n\n  return result;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lytjs/common-query",
-  "version": "6.5.0",
+  "version": "6.7.0",
   "description": "URL query string parsing and building utilities for LytJS",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/src/env.d.ts

@@ -1,4 +1,4 @@
-// 全局 __DEV__ 声明
-// 规范版本位于 @lytjs/shared-types/src/global.d.ts
-// 此处保留直接声明以确保 tsup DTS 构建时类型可用
-declare const __DEV__: boolean;
+// 全局 __DEV__ 声明
+// 规范版本位于 @lytjs/shared-types/src/global.d.ts
+// 此处保留直接声明以确保 tsup DTS 构建时类型可用
+declare const __DEV__: boolean;

package/src/index.ts

@@ -1,235 +1,304 @@
-/**
- * @lytjs/common-query
- * URL 查询字符串解析与构建工具
- */
-
-/**
- * 解析后的 URL 结构
- */
-export interface ParsedURL {
-  protocol: string;
-  host: string;
-  hostname: string;
-  port: string;
-  pathname: string;
-  search: string;
-  hash: string;
-  searchParams: Record<string, string>;
-  origin: string;
-  href: string;
-}
-
-/**
- * 解析 URL 查询字符串为对象
- *
- * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
- * @returns 解析后的键值对对象
- */
-export function parseQueryString(search: string): Record<string, string> {
-  if (!search) return {};
-
-  const str = search.startsWith('?') ? search.slice(1) : search;
-  if (!str) return {};
-
-  const result: Record<string, string> = {};
-
-  const pairs = str.split('&');
-  for (const pair of pairs) {
-    if (!pair) continue;
-    const eqIndex = pair.indexOf('=');
-    let key: string;
-    let value: string;
-    if (eqIndex === -1) {
-      key = pair;
-      value = '';
-    } else {
-      key = pair.slice(0, eqIndex);
-      value = pair.slice(eqIndex + 1);
-    }
-    try {
-      key = decodeURIComponent(key);
-    } catch {
-      // keep key as-is if decode fails
-    }
-    try {
-      value = decodeURIComponent(value);
-    } catch {
-      // keep value as-is if decode fails
-    }
-    result[key] = value;
-  }
-
-  return result;
-}
-
-/**
- * 将对象序列化为查询字符串
- *
- * @param params - 键值对对象
- * @returns 序列化后的查询字符串（不含前导 ?）
- */
-export function stringifyQueryString(
-  params: Record<string, string | number | boolean>,
-): string {
-  const keys = Object.keys(params);
-  if (keys.length === 0) return '';
-
-  const parts: string[] = [];
-  for (const key of keys) {
-    const value = params[key];
-    parts.push(
-      encodeURIComponent(key) + '=' + encodeURIComponent(String(value)),
-    );
-  }
-
-  return parts.join('&');
-}
-
-/**
- * 解析完整 URL
- *
- * @param url - URL 字符串，支持绝对 URL 和相对 URL
- * @returns 解析后的 ParsedURL 对象
- */
-export function parseURL(url: string): ParsedURL {
-  let rest = url;
-
-  // Extract hash
-  let hash = '';
-  const hashIndex = rest.indexOf('#');
-  if (hashIndex !== -1) {
-    hash = rest.slice(hashIndex);
-    rest = rest.slice(0, hashIndex);
-  }
-
-  // Extract search
-  let search = '';
-  const searchIndex = rest.indexOf('?');
-  if (searchIndex !== -1) {
-    search = rest.slice(searchIndex);
-    rest = rest.slice(0, searchIndex);
-  }
-
-  // Extract protocol
-  let protocol = '';
-  const protocolIndex = rest.indexOf('://');
-  if (protocolIndex !== -1) {
-    protocol = rest.slice(0, protocolIndex + 3);
-    rest = rest.slice(protocolIndex + 3);
-  }
-
-  // Extract pathname (everything after host)
-  let pathname = '';
-  let host = '';
-  let hostname = '';
-  let port = '';
-
-  if (protocol) {
-    // Absolute URL: extract host and pathname
-    const slashIndex = rest.indexOf('/');
-    if (slashIndex !== -1) {
-      host = rest.slice(0, slashIndex);
-      pathname = rest.slice(slashIndex);
-    } else {
-      host = rest;
-      pathname = '';
-    }
-
-    // Parse host into hostname and port
-    // Handle IPv6 addresses like [::1]:8080
-    if (host.startsWith('[')) {
-      const bracketEnd = host.indexOf(']');
-      if (bracketEnd !== -1) {
-        hostname = host.slice(0, bracketEnd + 1);
-        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {
-          port = host.slice(bracketEnd + 2);
-        }
-      } else {
-        hostname = host;
-      }
-    } else {
-      const colonIndex = host.lastIndexOf(':');
-      if (colonIndex !== -1) {
-        hostname = host.slice(0, colonIndex);
-        port = host.slice(colonIndex + 1);
-      } else {
-        hostname = host;
-        port = '';
-      }
-    }
-  } else {
-    // Relative URL
-    pathname = rest;
-  }
-
-  const searchParams = parseQueryString(search);
-  const origin = protocol ? protocol + host : '';
-
-  return {
-    protocol,
-    host,
-    hostname,
-    port,
-    pathname,
-    search,
-    hash,
-    searchParams,
-    origin,
-    href: url,
-  };
-}
-
-/**
- * 构建完整 URL
- *
- * @param base - 基础 URL
- * @param params - 查询参数（可选）
- * @param hash - hash 片段（可选，不含 #）
- * @returns 构建后的完整 URL
- */
-export function buildURL(
-  base: string,
-  params?: Record<string, string | number | boolean>,
-  hash?: string,
-): string {
-  if (!params && !hash) return base;
-
-  // Extract and remove existing hash from base
-  let baseWithoutHash = base;
-  let existingHash = '';
-  const hashIdx = base.indexOf('#');
-  if (hashIdx !== -1) {
-    existingHash = base.slice(hashIdx);
-    baseWithoutHash = base.slice(0, hashIdx);
-  }
-
-  // Parse existing query params from base (without hash)
-  let existingSearch = '';
-  let baseWithoutSearch = baseWithoutHash;
-  const searchIdx = baseWithoutHash.indexOf('?');
-  if (searchIdx !== -1) {
-    existingSearch = baseWithoutHash.slice(searchIdx + 1);
-    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);
-  }
-
-  // Merge existing and new params
-  const mergedParams = parseQueryString(existingSearch);
-  if (params) {
-    for (const key of Object.keys(params)) {
-      mergedParams[key] = String(params[key]);
-    }
-  }
-
-  const queryString = stringifyQueryString(mergedParams);
-  let result = baseWithoutSearch;
-  if (queryString) {
-    result += '?' + queryString;
-  }
-  // Use provided hash, or keep existing hash if no new hash is given
-  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;
-  if (finalHash) {
-    result += finalHash;
-  }
-
-  return result;
-}
+/**
+ * @lytjs/common-query
+ * URL 查询字符串解析与构建工具
+ */
+
+/**
+ * 解析后的 URL 结构
+ */
+export interface ParsedURL {
+  protocol: string;
+  host: string;
+  hostname: string;
+  port: string;
+  pathname: string;
+  search: string;
+  hash: string;
+  searchParams: Record<string, string | string[]>;
+  origin: string;
+  href: string;
+}
+
+/**
+ * 解析 URL 查询字符串为对象
+ *
+ * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @param options - 解析选项
+ * @returns 解析后的键值对对象
+ */
+export function parseQueryString(
+  search: string,
+  options?: { supportArrays?: boolean },
+): Record<string, string> | Record<string, string | string[]> {
+  if (!search) return {};
+
+  const str = search.startsWith('?') ? search.slice(1) : search;
+  if (!str) return {};
+
+  const supportArrays = options?.supportArrays ?? false;
+
+  if (supportArrays) {
+    const result: Record<string, string | string[]> = {};
+    const pairs = str.split('&');
+    for (const pair of pairs) {
+      if (!pair) continue;
+      const eqIndex = pair.indexOf('=');
+      let key: string;
+      let value: string;
+      if (eqIndex === -1) {
+        key = pair;
+        value = '';
+      } else {
+        key = pair.slice(0, eqIndex);
+        value = pair.slice(eqIndex + 1);
+      }
+      try {
+        key = decodeURIComponent(key);
+      } catch {
+        // keep key as-is if decode fails
+      }
+      try {
+        value = decodeURIComponent(value);
+      } catch {
+        // keep value as-is if decode fails
+      }
+
+      if (result[key]) {
+        if (Array.isArray(result[key])) {
+          (result[key] as string[]).push(value);
+        } else {
+          result[key] = [result[key] as string, value];
+        }
+      } else {
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+
+  // 保持原有的行为（向后兼容）
+  const result: Record<string, string> = {};
+  const pairs = str.split('&');
+  for (const pair of pairs) {
+    if (!pair) continue;
+    const eqIndex = pair.indexOf('=');
+    let key: string;
+    let value: string;
+    if (eqIndex === -1) {
+      key = pair;
+      value = '';
+    } else {
+      key = pair.slice(0, eqIndex);
+      value = pair.slice(eqIndex + 1);
+    }
+    try {
+      key = decodeURIComponent(key);
+    } catch {
+      // keep key as-is if decode fails
+    }
+    try {
+      value = decodeURIComponent(value);
+    } catch {
+      // keep value as-is if decode fails
+    }
+    result[key] = value;
+  }
+  return result;
+}
+
+/**
+ * 解析 URL 查询字符串为对象，支持数组值（重复键）
+ * 这是 parseQueryString 支持数组的便捷版本
+ *
+ * @param search - 查询字符串，支持 `?key=value` 和 `key=value` 格式
+ * @returns 解析后的键值对对象
+ */
+export function parseQueryStringWithArrays(search: string): Record<string, string | string[]> {
+  return parseQueryString(search, { supportArrays: true }) as Record<string, string | string[]>;
+}
+
+/**
+ * 将对象序列化为查询字符串
+ *
+ * @param params - 键值对对象，支持数组值
+ * @returns 序列化后的查询字符串（不含前导 ?）
+ */
+export function stringifyQueryString(
+  params: Record<string, string | number | boolean | Array<string | number | boolean>>,
+): string {
+  const keys = Object.keys(params);
+  if (keys.length === 0) return '';
+
+  const parts: string[] = [];
+  for (const key of keys) {
+    const value = params[key];
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(item)));
+      }
+    } else {
+      parts.push(encodeURIComponent(key) + '=' + encodeURIComponent(String(value)));
+    }
+  }
+
+  return parts.join('&');
+}
+
+/**
+ * 解析完整 URL
+ *
+ * @param url - URL 字符串，支持绝对 URL 和相对 URL
+ * @returns 解析后的 ParsedURL 对象
+ */
+export function parseURL(url: string, _options?: { supportArrays?: boolean }): ParsedURL {
+  let rest = url;
+
+  // Extract hash
+  let hash = '';
+  const hashIndex = rest.indexOf('#');
+  if (hashIndex !== -1) {
+    hash = rest.slice(hashIndex);
+    rest = rest.slice(0, hashIndex);
+  }
+
+  // Extract search
+  let search = '';
+  const searchIndex = rest.indexOf('?');
+  if (searchIndex !== -1) {
+    search = rest.slice(searchIndex);
+    rest = rest.slice(0, searchIndex);
+  }
+
+  // Extract protocol
+  let protocol = '';
+  const protocolIndex = rest.indexOf('://');
+  if (protocolIndex !== -1) {
+    protocol = rest.slice(0, protocolIndex + 3);
+    rest = rest.slice(protocolIndex + 3);
+  }
+
+  // Extract pathname (everything after host)
+  let pathname = '';
+  let host = '';
+  let hostname = '';
+  let port = '';
+
+  if (protocol) {
+    // Absolute URL: extract host and pathname
+    const slashIndex = rest.indexOf('/');
+    if (slashIndex !== -1) {
+      host = rest.slice(0, slashIndex);
+      pathname = rest.slice(slashIndex);
+    } else {
+      host = rest;
+      pathname = '';
+    }
+
+    // Parse host into hostname and port
+    // Handle IPv6 addresses like [::1]:8080
+    if (host.startsWith('[')) {
+      const bracketEnd = host.indexOf(']');
+      if (bracketEnd !== -1) {
+        hostname = host.slice(0, bracketEnd + 1);
+        if (host.length > bracketEnd + 1 && host[bracketEnd + 1] === ':') {
+          port = host.slice(bracketEnd + 2);
+        }
+      } else {
+        hostname = host;
+      }
+    } else {
+      const colonIndex = host.lastIndexOf(':');
+      if (colonIndex !== -1) {
+        hostname = host.slice(0, colonIndex);
+        port = host.slice(colonIndex + 1);
+      } else {
+        hostname = host;
+        port = '';
+      }
+    }
+  } else {
+    // Relative URL
+    pathname = rest;
+  }
+
+  const searchParams = parseQueryString(search, { supportArrays: true }) as Record<
+    string,
+    string | string[]
+  >;
+  const origin = protocol ? protocol + host : '';
+
+  return {
+    protocol,
+    host,
+    hostname,
+    port,
+    pathname,
+    search,
+    hash,
+    searchParams,
+    origin,
+    href: url,
+  };
+}
+
+/**
+ * 构建完整 URL
+ *
+ * @param base - 基础 URL
+ * @param params - 查询参数（可选）
+ * @param hash - hash 片段（可选，不含 #）
+ * @returns 构建后的完整 URL
+ */
+export function buildURL(
+  base: string,
+  params?: Record<string, string | number | boolean | Array<string | number | boolean>>,
+  hash?: string,
+): string {
+  if (!params && !hash) return base;
+
+  // Extract and remove existing hash from base
+  let baseWithoutHash = base;
+  let existingHash = '';
+  const hashIdx = base.indexOf('#');
+  if (hashIdx !== -1) {
+    existingHash = base.slice(hashIdx);
+    baseWithoutHash = base.slice(0, hashIdx);
+  }
+
+  // Parse existing query params from base (without hash)
+  let existingSearch = '';
+  let baseWithoutSearch = baseWithoutHash;
+  const searchIdx = baseWithoutHash.indexOf('?');
+  if (searchIdx !== -1) {
+    existingSearch = baseWithoutHash.slice(searchIdx + 1);
+    baseWithoutSearch = baseWithoutHash.slice(0, searchIdx);
+  }
+
+  // Merge existing and new params
+  const mergedParams = parseQueryStringWithArrays(existingSearch);
+  if (params) {
+    for (const key of Object.keys(params)) {
+      const value = params[key];
+      if (value !== undefined && value !== null) {
+        if (Array.isArray(value)) {
+          mergedParams[key] = value.map((v) => String(v));
+        } else {
+          mergedParams[key] = String(value);
+        }
+      }
+    }
+  }
+
+  const queryString = stringifyQueryString(mergedParams);
+  let result = baseWithoutSearch;
+  if (queryString) {
+    result += '?' + queryString;
+  }
+  // Use provided hash, or keep existing hash if no new hash is given
+  const finalHash = hash !== undefined ? '#' + encodeURIComponent(hash) : existingHash;
+  if (finalHash) {
+    result += finalHash;
+  }
+
+  return result;
+}