@nyaomaru/divider 1.9.12 → 1.9.14

package/README.md

@@ -9,7 +9,7 @@
         <img src="https://img.shields.io/npm/v/@nyaomaru/divider.svg?sanitize=true" alt="npm version">
     </a>
     <a href="https://jsr.io/@nyaomaru/divider">
-        <img src="https://img.shields.io/badge/JSR-@nyaomaru/divider-blue" alt="JSR">
+        <img src="https://img.shields.io/jsr/v/@nyaomaru/divider" alt="JSR">
     </a>
     <a href="https://github.com/nyaomaru/divider/blob/main/LICENSE">
         <img src="https://img.shields.io/npm/l/@nyaomaru/divider.svg?sanitize=true" alt="License">

package/dist/index.cjs

@@ -327,7 +327,10 @@ function divider(input, ...args) {
     preserveEmpty: options.preserveEmpty
   });
   const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
-  return applyDividerOptions(result, options);
+  return applyDividerOptions(
+    result,
+    options
+  );
 }
 
 // src/core/divider-first.ts
@@ -378,15 +381,15 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
-  const finalOptions = options ?? {};
+  const resolvedOptions = options ?? {};
   const {
     startOffset = PERFORMANCE_CONSTANTS.DEFAULT_START_OFFSET,
     maxChunks = PERFORMANCE_CONSTANTS.DEFAULT_MAX_CHUNKS
-  } = finalOptions;
+  } = resolvedOptions;
   const result = isString(input) ? createChunksFromString(input, size, startOffset, maxChunks) : input.map(
     (str) => createChunksFromString(str, size, startOffset, maxChunks)
   );
-  return applyDividerOptions(result, finalOptions);
+  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/divide.ts
@@ -397,7 +400,8 @@ function divideNumberString(str) {
 // src/core/divider-number-string.ts
 function dividerNumberString(input, options) {
   const result = isString(input) ? divideNumberString(input) : input.map(divideNumberString);
-  return applyDividerOptions(result, options ?? {});
+  const resolvedOptions = options ?? {};
+  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/quoted.ts

package/dist/index.d.cts

@@ -20,7 +20,6 @@ type StringArrayInput = readonly string[];
 type DividerInput = StringInput | StringArrayInput;
 type DividerStringResult = string[];
 type DividerArrayResult = string[][];
-type DividerResult<T extends DividerInput> = T extends StringInput ? DividerStringResult : DividerArrayResult;
 type DividerOptions = {
     /** If true, flattens nested arrays into a single array */
     flatten?: boolean;
@@ -31,17 +30,43 @@ type DividerOptions = {
     /** Controls how empty or whitespace segments are handled */
     exclude?: DividerExcludeMode;
 };
+/**
+ * Represents the absence of user-specified divider options while retaining
+ * property knowledge for conditional typing.
+ */
+type DividerEmptyOptions = {
+    /** Explicitly omits flatten while preserving literal inference */
+    readonly flatten?: never;
+    /** Explicitly omits trim while preserving literal inference */
+    readonly trim?: never;
+    /** Explicitly omits preserveEmpty while preserving literal inference */
+    readonly preserveEmpty?: never;
+    /** Explicitly omits exclude while preserving literal inference */
+    readonly exclude?: never;
+};
+type DividerInferredOptions = DividerOptions | DividerEmptyOptions;
+type HasFlattenOption<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;
+type ExtractedDividerOptions<TArgs extends readonly (string | number | DividerOptions)[]> = TArgs extends readonly [...infer _Rest, infer Last] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions;
 type DividerLoopOptions = DividerOptions & {
     /** Starting position for the division (0-based) */
     startOffset?: number;
     /** Maximum number of chunks to produce */
     maxChunks?: number;
 };
+type DividerLoopEmptyOptions = DividerEmptyOptions & {
+    /** Placeholder to signal startOffset is intentionally absent */
+    readonly startOffset?: never;
+    /** Placeholder to signal maxChunks is intentionally absent */
+    readonly maxChunks?: never;
+};
+type DividerLoopOptionsLike = DividerLoopOptions | DividerLoopEmptyOptions;
 type NumericSeparator = number;
 type StringSeparator = string;
 type DividerSeparator = NumericSeparator | StringSeparator;
 type DividerSeparators = DividerSeparator[];
-type DividerArgs = DividerSeparators | [...DividerSeparators, DividerOptions];
 
 /**
  * Main divider function that splits input based on numeric positions or string delimiters.
@@ -55,7 +80,7 @@ type DividerArgs = DividerSeparators | [...DividerSeparators, DividerOptions];
  * @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>(input: T, ...args: DividerArgs): DividerResult<T>;
+declare function divider<T extends DividerInput, const TArgs extends readonly (DividerSeparator | DividerOptions)[]>(input: T, ...args: TArgs): DividerResult<T, ExtractedDividerOptions<TArgs>>;
 
 /**
  * Extracts the first segment after dividing the input using specified separators.
@@ -100,7 +125,7 @@ declare function dividerLast(input: DividerInput, ...args: DividerSeparators): s
  * dividerLoop("abcdef", 2) // returns ["ab", "cd", "ef"]
  * dividerLoop("abcdef", 2, { maxChunks: 2 }) // returns ["ab", "cdef"]
  */
-declare function dividerLoop<T extends DividerInput>(input: T, size: number, options?: DividerLoopOptions): DividerResult<T>;
+declare function dividerLoop<T extends DividerInput, O extends DividerLoopOptionsLike = DividerLoopEmptyOptions>(input: T, size: number, options?: O): DividerResult<T, O>;
 
 /**
  * Divides a string or array of strings by separating numbers from non-numbers.
@@ -115,7 +140,7 @@ declare function dividerLoop<T extends DividerInput>(input: T, size: number, opt
  * dividerNumberString("abc123def") // returns ["abc", "123", "def"]
  * dividerNumberString("test42") // returns ["test", "42"]
  */
-declare function dividerNumberString<T extends DividerInput>(input: T, options?: DividerOptions): DividerResult<T>;
+declare function dividerNumberString<T extends DividerInput, O extends DividerInferredOptions = DividerEmptyOptions>(input: T, options?: O): DividerResult<T, O>;
 
 type EmailDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Split top-level domain from the rest of the email address. */
@@ -163,4 +188,4 @@ declare function emailDivider(input: string, options?: EmailDividerOptions): Div
  */
 declare function pathDivider(input: string, options?: PathDividerOptions): DividerStringResult;
 
-export { type DividerArgs, type DividerArrayResult, type DividerExcludeMode, type DividerInput, type DividerLoopOptions, type DividerOptions, type DividerResult, type DividerSeparator, type DividerSeparators, type DividerStringResult, type NumericSeparator, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider };
+export { type DividerArrayResult, type DividerEmptyOptions, type DividerExcludeMode, type DividerInferredOptions, type DividerInput, type DividerLoopEmptyOptions, type DividerLoopOptions, type DividerLoopOptionsLike, type DividerOptions, type DividerResult, type DividerSeparator, type DividerSeparators, type DividerStringResult, type ExtractedDividerOptions, type NumericSeparator, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider };

package/dist/index.d.ts

@@ -20,7 +20,6 @@ type StringArrayInput = readonly string[];
 type DividerInput = StringInput | StringArrayInput;
 type DividerStringResult = string[];
 type DividerArrayResult = string[][];
-type DividerResult<T extends DividerInput> = T extends StringInput ? DividerStringResult : DividerArrayResult;
 type DividerOptions = {
     /** If true, flattens nested arrays into a single array */
     flatten?: boolean;
@@ -31,17 +30,43 @@ type DividerOptions = {
     /** Controls how empty or whitespace segments are handled */
     exclude?: DividerExcludeMode;
 };
+/**
+ * Represents the absence of user-specified divider options while retaining
+ * property knowledge for conditional typing.
+ */
+type DividerEmptyOptions = {
+    /** Explicitly omits flatten while preserving literal inference */
+    readonly flatten?: never;
+    /** Explicitly omits trim while preserving literal inference */
+    readonly trim?: never;
+    /** Explicitly omits preserveEmpty while preserving literal inference */
+    readonly preserveEmpty?: never;
+    /** Explicitly omits exclude while preserving literal inference */
+    readonly exclude?: never;
+};
+type DividerInferredOptions = DividerOptions | DividerEmptyOptions;
+type HasFlattenOption<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;
+type ExtractedDividerOptions<TArgs extends readonly (string | number | DividerOptions)[]> = TArgs extends readonly [...infer _Rest, infer Last] ? Last extends DividerOptions ? Last : DividerEmptyOptions : DividerEmptyOptions;
 type DividerLoopOptions = DividerOptions & {
     /** Starting position for the division (0-based) */
     startOffset?: number;
     /** Maximum number of chunks to produce */
     maxChunks?: number;
 };
+type DividerLoopEmptyOptions = DividerEmptyOptions & {
+    /** Placeholder to signal startOffset is intentionally absent */
+    readonly startOffset?: never;
+    /** Placeholder to signal maxChunks is intentionally absent */
+    readonly maxChunks?: never;
+};
+type DividerLoopOptionsLike = DividerLoopOptions | DividerLoopEmptyOptions;
 type NumericSeparator = number;
 type StringSeparator = string;
 type DividerSeparator = NumericSeparator | StringSeparator;
 type DividerSeparators = DividerSeparator[];
-type DividerArgs = DividerSeparators | [...DividerSeparators, DividerOptions];
 
 /**
  * Main divider function that splits input based on numeric positions or string delimiters.
@@ -55,7 +80,7 @@ type DividerArgs = DividerSeparators | [...DividerSeparators, DividerOptions];
  * @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>(input: T, ...args: DividerArgs): DividerResult<T>;
+declare function divider<T extends DividerInput, const TArgs extends readonly (DividerSeparator | DividerOptions)[]>(input: T, ...args: TArgs): DividerResult<T, ExtractedDividerOptions<TArgs>>;
 
 /**
  * Extracts the first segment after dividing the input using specified separators.
@@ -100,7 +125,7 @@ declare function dividerLast(input: DividerInput, ...args: DividerSeparators): s
  * dividerLoop("abcdef", 2) // returns ["ab", "cd", "ef"]
  * dividerLoop("abcdef", 2, { maxChunks: 2 }) // returns ["ab", "cdef"]
  */
-declare function dividerLoop<T extends DividerInput>(input: T, size: number, options?: DividerLoopOptions): DividerResult<T>;
+declare function dividerLoop<T extends DividerInput, O extends DividerLoopOptionsLike = DividerLoopEmptyOptions>(input: T, size: number, options?: O): DividerResult<T, O>;
 
 /**
  * Divides a string or array of strings by separating numbers from non-numbers.
@@ -115,7 +140,7 @@ declare function dividerLoop<T extends DividerInput>(input: T, size: number, opt
  * dividerNumberString("abc123def") // returns ["abc", "123", "def"]
  * dividerNumberString("test42") // returns ["test", "42"]
  */
-declare function dividerNumberString<T extends DividerInput>(input: T, options?: DividerOptions): DividerResult<T>;
+declare function dividerNumberString<T extends DividerInput, O extends DividerInferredOptions = DividerEmptyOptions>(input: T, options?: O): DividerResult<T, O>;
 
 type EmailDividerOptions = Pick<DividerOptions, 'trim'> & {
     /** Split top-level domain from the rest of the email address. */
@@ -163,4 +188,4 @@ declare function emailDivider(input: string, options?: EmailDividerOptions): Div
  */
 declare function pathDivider(input: string, options?: PathDividerOptions): DividerStringResult;
 
-export { type DividerArgs, type DividerArrayResult, type DividerExcludeMode, type DividerInput, type DividerLoopOptions, type DividerOptions, type DividerResult, type DividerSeparator, type DividerSeparators, type DividerStringResult, type NumericSeparator, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider };
+export { type DividerArrayResult, type DividerEmptyOptions, type DividerExcludeMode, type DividerInferredOptions, type DividerInput, type DividerLoopEmptyOptions, type DividerLoopOptions, type DividerLoopOptionsLike, type DividerOptions, type DividerResult, type DividerSeparator, type DividerSeparators, type DividerStringResult, type ExtractedDividerOptions, type NumericSeparator, type StringArrayInput, type StringInput, type StringSeparator, csvDivider, divider, dividerFirst, dividerLast, dividerLoop, dividerNumberString, emailDivider, pathDivider };

package/dist/index.js

@@ -294,7 +294,10 @@ function divider(input, ...args) {
     preserveEmpty: options.preserveEmpty
   });
   const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
-  return applyDividerOptions(result, options);
+  return applyDividerOptions(
+    result,
+    options
+  );
 }
 
 // src/core/divider-first.ts
@@ -345,15 +348,15 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
-  const finalOptions = options ?? {};
+  const resolvedOptions = options ?? {};
   const {
     startOffset = PERFORMANCE_CONSTANTS.DEFAULT_START_OFFSET,
     maxChunks = PERFORMANCE_CONSTANTS.DEFAULT_MAX_CHUNKS
-  } = finalOptions;
+  } = resolvedOptions;
   const result = isString(input) ? createChunksFromString(input, size, startOffset, maxChunks) : input.map(
     (str) => createChunksFromString(str, size, startOffset, maxChunks)
   );
-  return applyDividerOptions(result, finalOptions);
+  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/divide.ts
@@ -364,7 +367,8 @@ function divideNumberString(str) {
 // src/core/divider-number-string.ts
 function dividerNumberString(input, options) {
   const result = isString(input) ? divideNumberString(input) : input.map(divideNumberString);
-  return applyDividerOptions(result, options ?? {});
+  const resolvedOptions = options ?? {};
+  return applyDividerOptions(result, resolvedOptions);
 }
 
 // src/utils/quoted.ts

package/package.json

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