@nyaomaru/divider 1.5.2 → 1.6.0

package/README.md

@@ -155,6 +155,7 @@ const result3 = dividerNumberString(['abc123', '45z'], { flatten: true });
 | Option    | Type      | Default | Description                                                               |
 | --------- | --------- | ------- | ------------------------------------------------------------------------- |
 | `flatten` | `boolean` | `false` | If `true`, the resulting nested arrays are flattened into a single array. |
+| `trim`    | `boolean` | `false` | If `true`, trims whitespace from each divided segment.                    |
 
 ### `flatten` (default: `false`)
 
@@ -167,6 +168,19 @@ const result2 = divider(words, 2, { flatten: true });
 // ['he', 'llo', 'wo', 'rld']
 ```
 
+### `trim` (default: `false`)
+
+```ts
+const result = divider('  hello world  ', 7, { trim: true });
+// ['hello', 'world']
+
+const result2 = divider(['  a  ', ' b  c '], ' ', {
+  flatten: true,
+  trim: true,
+});
+// ['a', 'b', 'c']
+```
+
 ## 💡 Features
 
 ### 🧩 Flexible Division
@@ -174,7 +188,7 @@ const result2 = divider(words, 2, { flatten: true });
 - Supports both `index-based` and `string-based` division
 - Supports `multiple separators` (mixing indexes and characters)
 - Works with both `string` and `string[]` input
-- Optional `flatten` behavior to control nested results
+- Optional `flatten` and `trim` behaviors to control output format
 - Includes `dividerNumberString()` to separate digits and letters
 
 ### 🎯 Targeted Extraction

package/dist/index.cjs

@@ -42,6 +42,12 @@ function isPositiveInteger(value) {
 function isValidInput(input) {
   return isString(input) || Array.isArray(input) && input.every(isString);
 }
+function isStringArray(input) {
+  return Array.isArray(input) && input.every(isString);
+}
+function isNestedStringArray(input) {
+  return Array.isArray(input) && input.length > 0 && Array.isArray(input[0]) && input[0].length > 0 && isStringArray(input[0]);
+}
 
 // src/utils/regex.ts
 var regexCache = /* @__PURE__ */ new Map();
@@ -124,6 +130,23 @@ function classifySeparators(args) {
   );
 }
 
+// src/utils/option.ts
+function applyDividerOptions(result, options) {
+  let output = result;
+  if (options.trim) {
+    const trimPart = (s) => s.trim();
+    if (isNestedStringArray(result)) {
+      output = result.map((row) => row.map(trimPart).filter(Boolean));
+    } else {
+      output = result.map(trimPart).filter(Boolean);
+    }
+  }
+  if (options.flatten) {
+    output = output.flat();
+  }
+  return output;
+}
+
 // src/core/divider.ts
 function divider(input, ...args) {
   if (!isValidInput(input)) {
@@ -137,13 +160,9 @@ function divider(input, ...args) {
   }
   const { cleanedArgs, options } = extractOptions(args);
   const { numSeparators, strSeparators } = classifySeparators(cleanedArgs);
-  if (isString(input)) {
-    return divideString(input, numSeparators, strSeparators);
-  }
-  const result = input.map(
-    (item) => divideString(item, numSeparators, strSeparators)
-  );
-  return options.flatten ? result.flat() : result;
+  const applyDivision = (str) => divideString(str, numSeparators, strSeparators);
+  const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
+  return applyDividerOptions(result, options);
 }
 
 // src/core/divider-first.ts
@@ -173,16 +192,13 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
+  const applyChunking = (str) => divider(str, ...generateIndexes(str, size));
   if (isString(input)) {
-    const indexes = generateIndexes(input, size);
-    return divider(input, ...indexes);
+    const result2 = applyChunking(input);
+    return applyDividerOptions(result2, options ?? {});
   }
-  const result = input.map((item) => {
-    const indexes = generateIndexes(item, size);
-    return divider(item, ...indexes);
-  });
-  const flatten = options?.flatten ?? false;
-  return flatten ? result.flat() : result;
+  const result = input.map(applyChunking);
+  return applyDividerOptions(result, options ?? {});
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -1,7 +1,5 @@
 type DividerResult<T extends string | string[], F extends boolean = false> = T extends string ? string[] : F extends true ? string[] : string[][];
-type DividerOptions<F extends boolean> = {
-    flatten?: F;
-};
+type DividerOptions<F extends boolean> = Partial<Record<'flatten' | 'trim', F>>;
 type DividerSeparators = (number | string)[];
 type DividerArgs<F extends boolean> = DividerSeparators | [...DividerSeparators, DividerOptions<F>];
 

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 type DividerResult<T extends string | string[], F extends boolean = false> = T extends string ? string[] : F extends true ? string[] : string[][];
-type DividerOptions<F extends boolean> = {
-    flatten?: F;
-};
+type DividerOptions<F extends boolean> = Partial<Record<'flatten' | 'trim', F>>;
 type DividerSeparators = (number | string)[];
 type DividerArgs<F extends boolean> = DividerSeparators | [...DividerSeparators, DividerOptions<F>];
 

package/dist/index.js

@@ -13,6 +13,12 @@ function isPositiveInteger(value) {
 function isValidInput(input) {
   return isString(input) || Array.isArray(input) && input.every(isString);
 }
+function isStringArray(input) {
+  return Array.isArray(input) && input.every(isString);
+}
+function isNestedStringArray(input) {
+  return Array.isArray(input) && input.length > 0 && Array.isArray(input[0]) && input[0].length > 0 && isStringArray(input[0]);
+}
 
 // src/utils/regex.ts
 var regexCache = /* @__PURE__ */ new Map();
@@ -95,6 +101,23 @@ function classifySeparators(args) {
   );
 }
 
+// src/utils/option.ts
+function applyDividerOptions(result, options) {
+  let output = result;
+  if (options.trim) {
+    const trimPart = (s) => s.trim();
+    if (isNestedStringArray(result)) {
+      output = result.map((row) => row.map(trimPart).filter(Boolean));
+    } else {
+      output = result.map(trimPart).filter(Boolean);
+    }
+  }
+  if (options.flatten) {
+    output = output.flat();
+  }
+  return output;
+}
+
 // src/core/divider.ts
 function divider(input, ...args) {
   if (!isValidInput(input)) {
@@ -108,13 +131,9 @@ function divider(input, ...args) {
   }
   const { cleanedArgs, options } = extractOptions(args);
   const { numSeparators, strSeparators } = classifySeparators(cleanedArgs);
-  if (isString(input)) {
-    return divideString(input, numSeparators, strSeparators);
-  }
-  const result = input.map(
-    (item) => divideString(item, numSeparators, strSeparators)
-  );
-  return options.flatten ? result.flat() : result;
+  const applyDivision = (str) => divideString(str, numSeparators, strSeparators);
+  const result = isString(input) ? applyDivision(input) : input.map(applyDivision);
+  return applyDividerOptions(result, options);
 }
 
 // src/core/divider-first.ts
@@ -144,16 +163,13 @@ function dividerLoop(input, size, options) {
     console.warn("dividerLoop: chunk size must be a positive number");
     return [];
   }
+  const applyChunking = (str) => divider(str, ...generateIndexes(str, size));
   if (isString(input)) {
-    const indexes = generateIndexes(input, size);
-    return divider(input, ...indexes);
+    const result2 = applyChunking(input);
+    return applyDividerOptions(result2, options ?? {});
   }
-  const result = input.map((item) => {
-    const indexes = generateIndexes(item, size);
-    return divider(item, ...indexes);
-  });
-  const flatten = options?.flatten ?? false;
-  return flatten ? result.flat() : result;
+  const result = input.map(applyChunking);
+  return applyDividerOptions(result, options ?? {});
 }
 export {
   divider,

package/package.json

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