@nyaomaru/divider 2.0.5 → 2.0.7

package/dist/index.cjs

@@ -348,6 +348,13 @@ function classifySeparators(args) {
   );
 }
 
+// src/utils/transform-divider-input.ts
+function transformDividerInput(input, transform, options) {
+  const result = isString(input) ? transform(input) : input.map(transform);
+  const resolvedOptions = options ?? {};
+  return applyDividerOptions(result, resolvedOptions);
+}
+
 // src/core/divider.ts
 function divider(input, ...args) {
   if (!isValidInput(input)) {
@@ -364,8 +371,7 @@ function divider(input, ...args) {
   const applyDivision = (str) => divideString(str, numSeparators, strSeparators, {
     preserveEmpty: options.preserveEmpty
   });
-  const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
-  return applyDividerOptions(result, options);
+  return transformDividerInput(input, applyDivision, options);
 }
 
 // src/core/divider-first.ts
@@ -416,15 +422,15 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
-  const resolvedOptions = options ?? {};
   const {
     startOffset = PERFORMANCE_CONSTANTS.DEFAULT_START_OFFSET,
     maxChunks = PERFORMANCE_CONSTANTS.DEFAULT_MAX_CHUNKS
-  } = resolvedOptions;
-  const result = isString(input) ? createChunksFromString(input, size, startOffset, maxChunks) : input.map(
-    (str) => createChunksFromString(str, size, startOffset, maxChunks)
+  } = options ?? {};
+  return transformDividerInput(
+    input,
+    (str) => createChunksFromString(str, size, startOffset, maxChunks),
+    options
   );
-  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/divide.ts
@@ -434,9 +440,7 @@ function divideNumberString(str) {
 
 // src/core/divider-number-string.ts
 function dividerNumberString(input, options) {
-  const result = isString(input) ? divideNumberString(input) : input.map(divideNumberString);
-  const resolvedOptions = options ?? {};
-  return applyDividerOptions(result, resolvedOptions);
+  return transformDividerInput(input, divideNumberString, options);
 }
 
 // src/utils/quoted.ts

package/dist/index.d.cts

@@ -21,21 +21,42 @@ declare const QUERY_DECODE_MODES: {
     readonly RAW: "raw";
 };
 
+/**
+ * Supported exclusion modes used to filter divider output.
+ */
 type DividerExcludeMode = (typeof DIVIDER_EXCLUDE_MODES)[keyof typeof DIVIDER_EXCLUDE_MODES];
+/**
+ * Single string input accepted by divider functions.
+ */
 type StringInput = string;
+/**
+ * Readonly string array input accepted by divider functions.
+ */
 type StringArrayInput = readonly string[];
+/**
+ * Supported input shapes for divider functions.
+ */
 type DividerInput = StringInput | StringArrayInput;
+/**
+ * Flat divider result.
+ */
 type DividerStringResult = string[];
+/**
+ * Nested divider result for `string[]` inputs when `flatten` is not enabled.
+ */
 type DividerArrayResult = string[][];
+/**
+ * Shared options supported by divider functions.
+ */
 type DividerOptions = {
     /** If true, flattens nested arrays into a single array */
-    flatten?: boolean;
+    readonly flatten?: boolean;
     /** If true, trims whitespace from each divided segment */
-    trim?: boolean;
+    readonly trim?: boolean;
     /** If true, retains empty segments produced by division */
-    preserveEmpty?: boolean;
+    readonly preserveEmpty?: boolean;
     /** Controls how empty or whitespace segments are handled */
-    exclude?: DividerExcludeMode;
+    readonly exclude?: DividerExcludeMode;
 };
 /**
  * Represents the absence of user-specified divider options while retaining
@@ -52,37 +73,76 @@ type DividerEmptyOptions = {
     readonly exclude?: never;
 };
 type DividerInferredOptions = DividerOptions | DividerEmptyOptions;
-type HasFlattenOption<TOptions extends DividerInferredOptions> = TOptions extends {
+/**
+ * Computes whether the provided options explicitly enable `flatten`.
+ */
+type IsFlattenEnabled<TOptions extends DividerInferredOptions> = TOptions extends {
     readonly flatten?: infer Flag;
-} ? Flag extends true ? true : false : false;
-type DividerResult<T extends DividerInput, TOptions extends DividerInferredOptions = DividerEmptyOptions> = T extends StringInput ? DividerStringResult : HasFlattenOption<TOptions> extends true ? DividerStringResult : DividerArrayResult;
+} ? [Flag] extends [true] ? true : false : false;
+/**
+ * Resolves the divider output shape from the input and options.
+ */
+type DividerResult<T extends DividerInput, TOptions extends DividerInferredOptions = DividerEmptyOptions> = T extends StringInput ? DividerStringResult : IsFlattenEnabled<TOptions> extends true ? DividerStringResult : DividerArrayResult;
+/**
+ * Numeric separator interpreted as an index.
+ */
+type NumericSeparator = number;
+/**
+ * String separator interpreted as a delimiter.
+ */
+type StringSeparator = string;
+/**
+ * Any supported divider separator.
+ */
+type DividerSeparator = NumericSeparator | StringSeparator;
+/**
+ * A readonly list of separators without options.
+ */
+type DividerSeparators = readonly DividerSeparator[];
+/**
+ * Any single divider argument.
+ */
+type DividerArg = DividerSeparator | DividerOptions;
+/**
+ * Divider arguments with an optional trailing options object.
+ *
+ * WHY: Runtime only consumes options when they are passed last. This tuple
+ * shape keeps the public type contract aligned with that behavior.
+ */
+type DividerArgs = DividerSeparators | readonly [...DividerSeparator[], DividerOptions];
+/**
+ * Extracts trailing divider options from a variadic argument tuple.
+ */
+type ExtractedDividerOptions<TArgs extends readonly unknown[]> = TArgs extends readonly [...unknown[], infer Last] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions;
 /**
  * Computes the divider return type based on the input and provided arguments.
  *
  * WHY: When no arguments are provided, divider returns the input as-is for
  * string arrays. This type keeps the signature aligned with runtime behavior.
  */
-type DividerReturn<T extends DividerInput, TArgs extends DividerArgs> = T extends StringInput ? DividerStringResult : TArgs['length'] extends 0 ? T : HasFlattenOption<ExtractedDividerOptions<TArgs>> extends true ? DividerStringResult : DividerArrayResult;
-type ExtractedDividerOptions<TArgs extends DividerArgs> = TArgs extends readonly [...infer Rest, infer Last] ? Rest extends DividerArg[] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions : DividerEmptyOptions;
+type DividerReturn<T extends DividerInput, TArgs extends DividerArgs> = T extends StringInput ? DividerStringResult : TArgs['length'] extends 0 ? T : IsFlattenEnabled<ExtractedDividerOptions<TArgs>> extends true ? DividerStringResult : DividerArrayResult;
+/**
+ * Additional options supported by `dividerLoop`.
+ */
 type DividerLoopOptions = DividerOptions & {
     /** Starting position for the division (0-based) */
-    startOffset?: number;
+    readonly startOffset?: number;
     /** Maximum number of chunks to produce */
-    maxChunks?: number;
+    readonly maxChunks?: number;
 };
+/**
+ * Represents the absence of loop-specific options while preserving inference.
+ */
 type DividerLoopEmptyOptions = DividerEmptyOptions & {
     /** Placeholder to signal startOffset is intentionally absent */
     readonly startOffset?: never;
     /** Placeholder to signal maxChunks is intentionally absent */
     readonly maxChunks?: never;
 };
+/**
+ * Accepted option shapes for `dividerLoop`.
+ */
 type DividerLoopOptionsLike = DividerLoopOptions | DividerLoopEmptyOptions;
-type NumericSeparator = number;
-type StringSeparator = string;
-type DividerSeparator = NumericSeparator | StringSeparator;
-type DividerSeparators = readonly DividerSeparator[];
-type DividerArg = DividerSeparator | DividerOptions;
-type DividerArgs = readonly DividerArg[];
 
 /**
  * Main divider function that splits input based on numeric positions or string delimiters.
@@ -96,7 +156,7 @@ type DividerArgs = readonly DividerArg[];
  * @param args - Array of separators (numbers/strings) and optional options object
  * @returns Divided string segments based on input type and options
  */
-declare function divider<T extends DividerInput, const TArgs extends readonly DividerArg[]>(input: T, ...args: TArgs): DividerReturn<T, TArgs>;
+declare function divider<T extends DividerInput, const TArgs extends DividerArgs>(input: T, ...args: TArgs): DividerReturn<T, TArgs>;
 
 /**
  * Extracts the first segment after dividing the input using specified separators.
@@ -160,22 +220,22 @@ declare function dividerNumberString<T extends DividerInput, O extends DividerIn
 
 type EmailDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Split top-level domain from the rest of the email address. */
-    splitTLD?: boolean;
+    readonly splitTLD?: boolean;
 };
 type CsvDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Character used for quoting values. */
-    quoteChar?: string;
+    readonly quoteChar?: string;
     /** Character used to separate CSV fields. */
-    delimiter?: string;
+    readonly delimiter?: string;
 };
 type PathDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Collapse empty segments produced by leading/trailing or repeated separators. */
-    collapse?: boolean;
+    readonly collapse?: boolean;
 };
 type QueryDecodeMode = (typeof QUERY_DECODE_MODES)[keyof typeof QUERY_DECODE_MODES];
 type QueryDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Decoding mode: 'auto' applies standard URL decoding; 'raw' leaves values untouched. */
-    mode?: QueryDecodeMode;
+    readonly mode?: QueryDecodeMode;
 };
 
 /**

package/dist/index.d.ts

@@ -21,21 +21,42 @@ declare const QUERY_DECODE_MODES: {
     readonly RAW: "raw";
 };
 
+/**
+ * Supported exclusion modes used to filter divider output.
+ */
 type DividerExcludeMode = (typeof DIVIDER_EXCLUDE_MODES)[keyof typeof DIVIDER_EXCLUDE_MODES];
+/**
+ * Single string input accepted by divider functions.
+ */
 type StringInput = string;
+/**
+ * Readonly string array input accepted by divider functions.
+ */
 type StringArrayInput = readonly string[];
+/**
+ * Supported input shapes for divider functions.
+ */
 type DividerInput = StringInput | StringArrayInput;
+/**
+ * Flat divider result.
+ */
 type DividerStringResult = string[];
+/**
+ * Nested divider result for `string[]` inputs when `flatten` is not enabled.
+ */
 type DividerArrayResult = string[][];
+/**
+ * Shared options supported by divider functions.
+ */
 type DividerOptions = {
     /** If true, flattens nested arrays into a single array */
-    flatten?: boolean;
+    readonly flatten?: boolean;
     /** If true, trims whitespace from each divided segment */
-    trim?: boolean;
+    readonly trim?: boolean;
     /** If true, retains empty segments produced by division */
-    preserveEmpty?: boolean;
+    readonly preserveEmpty?: boolean;
     /** Controls how empty or whitespace segments are handled */
-    exclude?: DividerExcludeMode;
+    readonly exclude?: DividerExcludeMode;
 };
 /**
  * Represents the absence of user-specified divider options while retaining
@@ -52,37 +73,76 @@ type DividerEmptyOptions = {
     readonly exclude?: never;
 };
 type DividerInferredOptions = DividerOptions | DividerEmptyOptions;
-type HasFlattenOption<TOptions extends DividerInferredOptions> = TOptions extends {
+/**
+ * Computes whether the provided options explicitly enable `flatten`.
+ */
+type IsFlattenEnabled<TOptions extends DividerInferredOptions> = TOptions extends {
     readonly flatten?: infer Flag;
-} ? Flag extends true ? true : false : false;
-type DividerResult<T extends DividerInput, TOptions extends DividerInferredOptions = DividerEmptyOptions> = T extends StringInput ? DividerStringResult : HasFlattenOption<TOptions> extends true ? DividerStringResult : DividerArrayResult;
+} ? [Flag] extends [true] ? true : false : false;
+/**
+ * Resolves the divider output shape from the input and options.
+ */
+type DividerResult<T extends DividerInput, TOptions extends DividerInferredOptions = DividerEmptyOptions> = T extends StringInput ? DividerStringResult : IsFlattenEnabled<TOptions> extends true ? DividerStringResult : DividerArrayResult;
+/**
+ * Numeric separator interpreted as an index.
+ */
+type NumericSeparator = number;
+/**
+ * String separator interpreted as a delimiter.
+ */
+type StringSeparator = string;
+/**
+ * Any supported divider separator.
+ */
+type DividerSeparator = NumericSeparator | StringSeparator;
+/**
+ * A readonly list of separators without options.
+ */
+type DividerSeparators = readonly DividerSeparator[];
+/**
+ * Any single divider argument.
+ */
+type DividerArg = DividerSeparator | DividerOptions;
+/**
+ * Divider arguments with an optional trailing options object.
+ *
+ * WHY: Runtime only consumes options when they are passed last. This tuple
+ * shape keeps the public type contract aligned with that behavior.
+ */
+type DividerArgs = DividerSeparators | readonly [...DividerSeparator[], DividerOptions];
+/**
+ * Extracts trailing divider options from a variadic argument tuple.
+ */
+type ExtractedDividerOptions<TArgs extends readonly unknown[]> = TArgs extends readonly [...unknown[], infer Last] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions;
 /**
  * Computes the divider return type based on the input and provided arguments.
  *
  * WHY: When no arguments are provided, divider returns the input as-is for
  * string arrays. This type keeps the signature aligned with runtime behavior.
  */
-type DividerReturn<T extends DividerInput, TArgs extends DividerArgs> = T extends StringInput ? DividerStringResult : TArgs['length'] extends 0 ? T : HasFlattenOption<ExtractedDividerOptions<TArgs>> extends true ? DividerStringResult : DividerArrayResult;
-type ExtractedDividerOptions<TArgs extends DividerArgs> = TArgs extends readonly [...infer Rest, infer Last] ? Rest extends DividerArg[] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions : DividerEmptyOptions;
+type DividerReturn<T extends DividerInput, TArgs extends DividerArgs> = T extends StringInput ? DividerStringResult : TArgs['length'] extends 0 ? T : IsFlattenEnabled<ExtractedDividerOptions<TArgs>> extends true ? DividerStringResult : DividerArrayResult;
+/**
+ * Additional options supported by `dividerLoop`.
+ */
 type DividerLoopOptions = DividerOptions & {
     /** Starting position for the division (0-based) */
-    startOffset?: number;
+    readonly startOffset?: number;
     /** Maximum number of chunks to produce */
-    maxChunks?: number;
+    readonly maxChunks?: number;
 };
+/**
+ * Represents the absence of loop-specific options while preserving inference.
+ */
 type DividerLoopEmptyOptions = DividerEmptyOptions & {
     /** Placeholder to signal startOffset is intentionally absent */
     readonly startOffset?: never;
     /** Placeholder to signal maxChunks is intentionally absent */
     readonly maxChunks?: never;
 };
+/**
+ * Accepted option shapes for `dividerLoop`.
+ */
 type DividerLoopOptionsLike = DividerLoopOptions | DividerLoopEmptyOptions;
-type NumericSeparator = number;
-type StringSeparator = string;
-type DividerSeparator = NumericSeparator | StringSeparator;
-type DividerSeparators = readonly DividerSeparator[];
-type DividerArg = DividerSeparator | DividerOptions;
-type DividerArgs = readonly DividerArg[];
 
 /**
  * Main divider function that splits input based on numeric positions or string delimiters.
@@ -96,7 +156,7 @@ type DividerArgs = readonly DividerArg[];
  * @param args - Array of separators (numbers/strings) and optional options object
  * @returns Divided string segments based on input type and options
  */
-declare function divider<T extends DividerInput, const TArgs extends readonly DividerArg[]>(input: T, ...args: TArgs): DividerReturn<T, TArgs>;
+declare function divider<T extends DividerInput, const TArgs extends DividerArgs>(input: T, ...args: TArgs): DividerReturn<T, TArgs>;
 
 /**
  * Extracts the first segment after dividing the input using specified separators.
@@ -160,22 +220,22 @@ declare function dividerNumberString<T extends DividerInput, O extends DividerIn
 
 type EmailDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Split top-level domain from the rest of the email address. */
-    splitTLD?: boolean;
+    readonly splitTLD?: boolean;
 };
 type CsvDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Character used for quoting values. */
-    quoteChar?: string;
+    readonly quoteChar?: string;
     /** Character used to separate CSV fields. */
-    delimiter?: string;
+    readonly delimiter?: string;
 };
 type PathDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Collapse empty segments produced by leading/trailing or repeated separators. */
-    collapse?: boolean;
+    readonly collapse?: boolean;
 };
 type QueryDecodeMode = (typeof QUERY_DECODE_MODES)[keyof typeof QUERY_DECODE_MODES];
 type QueryDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Decoding mode: 'auto' applies standard URL decoding; 'raw' leaves values untouched. */
-    mode?: QueryDecodeMode;
+    readonly mode?: QueryDecodeMode;
 };
 
 /**

package/dist/index.js

@@ -314,6 +314,13 @@ function classifySeparators(args) {
   );
 }
 
+// src/utils/transform-divider-input.ts
+function transformDividerInput(input, transform, options) {
+  const result = isString(input) ? transform(input) : input.map(transform);
+  const resolvedOptions = options ?? {};
+  return applyDividerOptions(result, resolvedOptions);
+}
+
 // src/core/divider.ts
 function divider(input, ...args) {
   if (!isValidInput(input)) {
@@ -330,8 +337,7 @@ function divider(input, ...args) {
   const applyDivision = (str) => divideString(str, numSeparators, strSeparators, {
     preserveEmpty: options.preserveEmpty
   });
-  const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
-  return applyDividerOptions(result, options);
+  return transformDividerInput(input, applyDivision, options);
 }
 
 // src/core/divider-first.ts
@@ -382,15 +388,15 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
-  const resolvedOptions = options ?? {};
   const {
     startOffset = PERFORMANCE_CONSTANTS.DEFAULT_START_OFFSET,
     maxChunks = PERFORMANCE_CONSTANTS.DEFAULT_MAX_CHUNKS
-  } = resolvedOptions;
-  const result = isString(input) ? createChunksFromString(input, size, startOffset, maxChunks) : input.map(
-    (str) => createChunksFromString(str, size, startOffset, maxChunks)
+  } = options ?? {};
+  return transformDividerInput(
+    input,
+    (str) => createChunksFromString(str, size, startOffset, maxChunks),
+    options
   );
-  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/divide.ts
@@ -400,9 +406,7 @@ function divideNumberString(str) {
 
 // src/core/divider-number-string.ts
 function dividerNumberString(input, options) {
-  const result = isString(input) ? divideNumberString(input) : input.map(divideNumberString);
-  const resolvedOptions = options ?? {};
-  return applyDividerOptions(result, resolvedOptions);
+  return transformDividerInput(input, divideNumberString, options);
 }
 
 // src/utils/quoted.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nyaomaru/divider",
   "type": "module",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "To divide string or string[] with a given separator",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",