@nyaomaru/divider 2.0.16 → 2.0.18

package/dist/index.cjs

@@ -32,6 +32,38 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/utils/guards/primitives.ts
+function isString(value) {
+  return typeof value === "string";
+}
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function isPlainObject(value) {
+  if (!isObject(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === null || Object.getPrototypeOf(proto) === null;
+}
+function isPositiveInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isStringOrNumber(value) {
+  return isString(value) || isNumber(value);
+}
+
+// src/utils/guards/array.ts
+function isEmptyArray(value) {
+  return Array.isArray(value) && value.length === 0;
+}
+function isNestedStringArray(value) {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  const firstRow = value[0];
+  return Array.isArray(firstRow) && firstRow.every((item) => isString(item));
+}
+
 // src/constants/index.ts
 var DIVIDER_EXCLUDE_MODES = {
   NONE: "none",
@@ -71,43 +103,7 @@ var QUERY_DECODE_MODES = {
   RAW: "raw"
 };
 
-// src/utils/is.ts
-function isString(value) {
-  return typeof value === "string";
-}
-function isNumber(value) {
-  return typeof value === "number";
-}
-function isObject(value) {
-  return typeof value === "object" && value !== null;
-}
-function isPlainObject(value) {
-  if (!isObject(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === null || Object.getPrototypeOf(proto) === null;
-}
-function isOptions(value) {
-  if (!isPlainObject(value)) return false;
-  const options = value;
-  return DIVIDER_OPTION_KEYS.some((key) => Object.hasOwn(options, key));
-}
-function isEmptyArray(value) {
-  return Array.isArray(value) && value.length === 0;
-}
-function isPositiveInteger(value) {
-  return typeof value === "number" && Number.isInteger(value) && value > 0;
-}
-function isValidInput(value) {
-  return isString(value) || Array.isArray(value) && value.every(isString);
-}
-function isStringOrNumber(value) {
-  return isString(value) || isNumber(value);
-}
-function isNestedStringArray(value) {
-  if (!Array.isArray(value) || value.length === 0) return false;
-  const firstRow = value[0];
-  return Array.isArray(firstRow) && firstRow.every((item) => isString(item));
-}
+// src/utils/guards/whitespace.ts
 function isSpaceOrTab(value) {
   return value === WHITE_SPACE || value === TAB;
 }
@@ -117,9 +113,6 @@ function isWhitespaceOnly(value) {
 function isEmptyString(value) {
   return value === "";
 }
-function isNoneMode(value) {
-  return value === DIVIDER_EXCLUDE_MODES.NONE;
-}
 
 // src/utils/regex.ts
 function normalizeSeparators(separators) {
@@ -275,6 +268,11 @@ var assertValidNumSeparators = (numSeparators) => {
   }
 };
 
+// src/utils/guards/divider-input.ts
+function isValidInput(value) {
+  return isString(value) || Array.isArray(value) && value.every(isString);
+}
+
 // src/utils/array.ts
 function ensureStringArray(input) {
   return isString(input) ? [input] : input;
@@ -293,6 +291,16 @@ var excludePredicateMap = {
   whitespace: (s) => !isWhitespaceOnly(s)
 };
 
+// src/utils/guards/options.ts
+function isOptions(value) {
+  if (!isPlainObject(value)) return false;
+  const options = value;
+  return DIVIDER_OPTION_KEYS.some((key) => Object.hasOwn(options, key));
+}
+function isNoneMode(value) {
+  return value === DIVIDER_EXCLUDE_MODES.NONE;
+}
+
 // src/utils/option-exclude.ts
 function resolveExcludePredicate(exclude) {
   if (exclude == null || isNoneMode(exclude) || typeof exclude !== "string") {
@@ -651,11 +659,11 @@ var buildPathSegments = (input, collapse) => collapse ? divider(input, PATH_SEPA
 var trimSegments2 = (segments, trim) => trim ? segments.map((segment) => segment.trim()) : segments;
 var applyCollapseRules = (segments, collapse) => collapse ? segments.filter((segment) => !isEmptyString(segment)) : segments;
 
-// src/presets/query-divider.ts
-function tryExtractQuery(input) {
+// src/utils/query.ts
+function extractQuery(input) {
   try {
     const url = new URL(input);
-    return url.search.startsWith(QUERY_SEPARATORS.QUESTION_MARK) ? url.search.slice(1) : url.search;
+    return stripLeadingQuestionMark(url.search);
   } catch {
     return extractQueryFromQuestionMark(input);
   }
@@ -674,40 +682,47 @@ function extractQueryFromQuestionMark(input) {
   }
   const prefix = withoutFragment.slice(0, questionMarkIndex);
   const hasQuerySeparatorBefore = prefix.includes(QUERY_SEPARATORS.AMPERSAND) || prefix.includes(QUERY_SEPARATORS.EQUALS);
-  if (hasQuerySeparatorBefore) {
-    return withoutFragment;
-  }
-  return withoutFragment.slice(questionMarkIndex + 1);
+  return hasQuerySeparatorBefore ? withoutFragment : withoutFragment.slice(questionMarkIndex + 1);
 }
 function stripLeadingQuestionMark(query) {
   return query.startsWith(QUERY_SEPARATORS.QUESTION_MARK) ? query.slice(1) : query;
 }
-function splitOnFirstEquals(part) {
-  const kv = dividePreserve(part, QUERY_SEPARATORS.EQUALS);
-  if (kv.length === 1) return [kv[0] ?? "", ""];
-  return [kv[0] ?? "", kv.slice(1).join(QUERY_SEPARATORS.EQUALS)];
+function splitQueryPair(part) {
+  const keyValue = dividePreserve(part, QUERY_SEPARATORS.EQUALS);
+  if (keyValue.length === 1) return [keyValue[0] ?? "", ""];
+  return [
+    keyValue[0] ?? "",
+    keyValue.slice(1).join(QUERY_SEPARATORS.EQUALS)
+  ];
 }
-function decodeField(text, mode, trim) {
-  let t = text;
+function decodeQueryField(text, mode, trim) {
+  let decoded = text;
   if (mode === QUERY_DECODE_MODES.AUTO) {
-    t = t.replace(/\+/g, " ");
+    decoded = decoded.replace(/\+/g, " ");
     try {
-      t = decodeURIComponent(t);
+      decoded = decodeURIComponent(decoded);
     } catch {
     }
   }
-  if (trim) t = t.trim();
-  return t;
+  return trim ? decoded.trim() : decoded;
 }
-function queryDivider(input, { mode = QUERY_DECODE_MODES.AUTO, trim = false } = {}) {
+function parseQueryPairs(input, { mode = QUERY_DECODE_MODES.AUTO, trim = false } = {}) {
   if (input.length === 0) return [];
-  const query = stripLeadingQuestionMark(tryExtractQuery(input));
+  const query = stripLeadingQuestionMark(extractQuery(input));
   if (query.length === 0) return [];
   return dividePreserve(query, QUERY_SEPARATORS.AMPERSAND).map((part) => {
-    const [key, value] = splitOnFirstEquals(part);
-    return [decodeField(key, mode, trim), decodeField(value, mode, trim)];
+    const [key, value] = splitQueryPair(part);
+    return [
+      decodeQueryField(key, mode, trim),
+      decodeQueryField(value, mode, trim)
+    ];
   });
 }
+
+// src/presets/query-divider.ts
+function queryDivider(input, options = {}) {
+  return parseQueryPairs(input, options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   csvDivider,

package/dist/index.d.cts

@@ -278,6 +278,6 @@ declare function pathDivider(input: string, options?: PathDividerOptions): Divid
  * @param options Parsing options: { mode?: 'auto' | 'raw'; trim?: boolean }.
  * @returns Array of [key, value] string tuples in input order.
  */
-declare function queryDivider(input: string, { mode, trim }?: QueryDividerOptions): DividerArrayResult;
+declare function queryDivider(input: string, options?: QueryDividerOptions): DividerArrayResult;
 
 export { type CsvDividerOptions, type DividerArg, type DividerArgs, type DividerArrayResult, type DividerEmptyOptions, type DividerExcludeMode, type DividerInferredOptions, type DividerInput, type DividerLoopEmptyOptions, type DividerLoopOptions, type DividerLoopOptionsLike, type DividerOptions, type DividerResult, type DividerReturn, type DividerSeparator, type DividerSeparators, type DividerStringResult, type EmailDividerOptions, type ExtractedDividerOptions, type NumericSeparator, type PathDividerOptions, type QueryDecodeMode, type QueryDividerOptions, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider, queryDivider };

package/dist/index.d.ts

@@ -278,6 +278,6 @@ declare function pathDivider(input: string, options?: PathDividerOptions): Divid
  * @param options Parsing options: { mode?: 'auto' | 'raw'; trim?: boolean }.
  * @returns Array of [key, value] string tuples in input order.
  */
-declare function queryDivider(input: string, { mode, trim }?: QueryDividerOptions): DividerArrayResult;
+declare function queryDivider(input: string, options?: QueryDividerOptions): DividerArrayResult;
 
 export { type CsvDividerOptions, type DividerArg, type DividerArgs, type DividerArrayResult, type DividerEmptyOptions, type DividerExcludeMode, type DividerInferredOptions, type DividerInput, type DividerLoopEmptyOptions, type DividerLoopOptions, type DividerLoopOptionsLike, type DividerOptions, type DividerResult, type DividerReturn, type DividerSeparator, type DividerSeparators, type DividerStringResult, type EmailDividerOptions, type ExtractedDividerOptions, type NumericSeparator, type PathDividerOptions, type QueryDecodeMode, type QueryDividerOptions, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider, queryDivider };

package/dist/index.js

@@ -1,3 +1,35 @@
+// src/utils/guards/primitives.ts
+function isString(value) {
+  return typeof value === "string";
+}
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function isPlainObject(value) {
+  if (!isObject(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === null || Object.getPrototypeOf(proto) === null;
+}
+function isPositiveInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isStringOrNumber(value) {
+  return isString(value) || isNumber(value);
+}
+
+// src/utils/guards/array.ts
+function isEmptyArray(value) {
+  return Array.isArray(value) && value.length === 0;
+}
+function isNestedStringArray(value) {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  const firstRow = value[0];
+  return Array.isArray(firstRow) && firstRow.every((item) => isString(item));
+}
+
 // src/constants/index.ts
 var DIVIDER_EXCLUDE_MODES = {
   NONE: "none",
@@ -37,43 +69,7 @@ var QUERY_DECODE_MODES = {
   RAW: "raw"
 };
 
-// src/utils/is.ts
-function isString(value) {
-  return typeof value === "string";
-}
-function isNumber(value) {
-  return typeof value === "number";
-}
-function isObject(value) {
-  return typeof value === "object" && value !== null;
-}
-function isPlainObject(value) {
-  if (!isObject(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === null || Object.getPrototypeOf(proto) === null;
-}
-function isOptions(value) {
-  if (!isPlainObject(value)) return false;
-  const options = value;
-  return DIVIDER_OPTION_KEYS.some((key) => Object.hasOwn(options, key));
-}
-function isEmptyArray(value) {
-  return Array.isArray(value) && value.length === 0;
-}
-function isPositiveInteger(value) {
-  return typeof value === "number" && Number.isInteger(value) && value > 0;
-}
-function isValidInput(value) {
-  return isString(value) || Array.isArray(value) && value.every(isString);
-}
-function isStringOrNumber(value) {
-  return isString(value) || isNumber(value);
-}
-function isNestedStringArray(value) {
-  if (!Array.isArray(value) || value.length === 0) return false;
-  const firstRow = value[0];
-  return Array.isArray(firstRow) && firstRow.every((item) => isString(item));
-}
+// src/utils/guards/whitespace.ts
 function isSpaceOrTab(value) {
   return value === WHITE_SPACE || value === TAB;
 }
@@ -83,9 +79,6 @@ function isWhitespaceOnly(value) {
 function isEmptyString(value) {
   return value === "";
 }
-function isNoneMode(value) {
-  return value === DIVIDER_EXCLUDE_MODES.NONE;
-}
 
 // src/utils/regex.ts
 function normalizeSeparators(separators) {
@@ -241,6 +234,11 @@ var assertValidNumSeparators = (numSeparators) => {
   }
 };
 
+// src/utils/guards/divider-input.ts
+function isValidInput(value) {
+  return isString(value) || Array.isArray(value) && value.every(isString);
+}
+
 // src/utils/array.ts
 function ensureStringArray(input) {
   return isString(input) ? [input] : input;
@@ -259,6 +257,16 @@ var excludePredicateMap = {
   whitespace: (s) => !isWhitespaceOnly(s)
 };
 
+// src/utils/guards/options.ts
+function isOptions(value) {
+  if (!isPlainObject(value)) return false;
+  const options = value;
+  return DIVIDER_OPTION_KEYS.some((key) => Object.hasOwn(options, key));
+}
+function isNoneMode(value) {
+  return value === DIVIDER_EXCLUDE_MODES.NONE;
+}
+
 // src/utils/option-exclude.ts
 function resolveExcludePredicate(exclude) {
   if (exclude == null || isNoneMode(exclude) || typeof exclude !== "string") {
@@ -617,11 +625,11 @@ var buildPathSegments = (input, collapse) => collapse ? divider(input, PATH_SEPA
 var trimSegments2 = (segments, trim) => trim ? segments.map((segment) => segment.trim()) : segments;
 var applyCollapseRules = (segments, collapse) => collapse ? segments.filter((segment) => !isEmptyString(segment)) : segments;
 
-// src/presets/query-divider.ts
-function tryExtractQuery(input) {
+// src/utils/query.ts
+function extractQuery(input) {
   try {
     const url = new URL(input);
-    return url.search.startsWith(QUERY_SEPARATORS.QUESTION_MARK) ? url.search.slice(1) : url.search;
+    return stripLeadingQuestionMark(url.search);
   } catch {
     return extractQueryFromQuestionMark(input);
   }
@@ -640,40 +648,47 @@ function extractQueryFromQuestionMark(input) {
   }
   const prefix = withoutFragment.slice(0, questionMarkIndex);
   const hasQuerySeparatorBefore = prefix.includes(QUERY_SEPARATORS.AMPERSAND) || prefix.includes(QUERY_SEPARATORS.EQUALS);
-  if (hasQuerySeparatorBefore) {
-    return withoutFragment;
-  }
-  return withoutFragment.slice(questionMarkIndex + 1);
+  return hasQuerySeparatorBefore ? withoutFragment : withoutFragment.slice(questionMarkIndex + 1);
 }
 function stripLeadingQuestionMark(query) {
   return query.startsWith(QUERY_SEPARATORS.QUESTION_MARK) ? query.slice(1) : query;
 }
-function splitOnFirstEquals(part) {
-  const kv = dividePreserve(part, QUERY_SEPARATORS.EQUALS);
-  if (kv.length === 1) return [kv[0] ?? "", ""];
-  return [kv[0] ?? "", kv.slice(1).join(QUERY_SEPARATORS.EQUALS)];
+function splitQueryPair(part) {
+  const keyValue = dividePreserve(part, QUERY_SEPARATORS.EQUALS);
+  if (keyValue.length === 1) return [keyValue[0] ?? "", ""];
+  return [
+    keyValue[0] ?? "",
+    keyValue.slice(1).join(QUERY_SEPARATORS.EQUALS)
+  ];
 }
-function decodeField(text, mode, trim) {
-  let t = text;
+function decodeQueryField(text, mode, trim) {
+  let decoded = text;
   if (mode === QUERY_DECODE_MODES.AUTO) {
-    t = t.replace(/\+/g, " ");
+    decoded = decoded.replace(/\+/g, " ");
     try {
-      t = decodeURIComponent(t);
+      decoded = decodeURIComponent(decoded);
     } catch {
     }
   }
-  if (trim) t = t.trim();
-  return t;
+  return trim ? decoded.trim() : decoded;
 }
-function queryDivider(input, { mode = QUERY_DECODE_MODES.AUTO, trim = false } = {}) {
+function parseQueryPairs(input, { mode = QUERY_DECODE_MODES.AUTO, trim = false } = {}) {
   if (input.length === 0) return [];
-  const query = stripLeadingQuestionMark(tryExtractQuery(input));
+  const query = stripLeadingQuestionMark(extractQuery(input));
   if (query.length === 0) return [];
   return dividePreserve(query, QUERY_SEPARATORS.AMPERSAND).map((part) => {
-    const [key, value] = splitOnFirstEquals(part);
-    return [decodeField(key, mode, trim), decodeField(value, mode, trim)];
+    const [key, value] = splitQueryPair(part);
+    return [
+      decodeQueryField(key, mode, trim),
+      decodeQueryField(value, mode, trim)
+    ];
   });
 }
+
+// src/presets/query-divider.ts
+function queryDivider(input, options = {}) {
+  return parseQueryPairs(input, options);
+}
 export {
   csvDivider,
   divider,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nyaomaru/divider",
   "type": "module",
-  "version": "2.0.16",
+  "version": "2.0.18",
   "description": "To divide string or string[] with a given separator",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -35,9 +35,9 @@
   "author": "nyaomaru",
   "license": "MIT",
   "devDependencies": {
+    "@eslint/js": "^9.26.0",
     "@swc/core": "^1.15.21",
     "@swc/jest": "^0.2.39",
-    "@eslint/js": "^9.26.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.15.12",
     "@typescript-eslint/eslint-plugin": "^8.32.1",