@nyaomaru/divider 1.3.7 → 1.4.0

package/README.md

@@ -118,6 +118,20 @@ const firstArrayElement = dividerLast(['hello', 'world'], 2);
 // 'rld'
 ```
 
+### 📌 `dividerLoop()` Usage
+
+```ts
+import { dividerLoop } from '@nyaomaru/divider';
+
+// Divide string into chunks of given size
+const result = dividerLoop('abcdefghij', 3);
+// ['abc', 'def', 'ghi', 'j']
+
+// Supports flatten option for string[]
+const result2 = dividerLoop(['hello', 'world'], 2, { flatten: true });
+// ['he', 'll', 'ow', 'or', 'ld']
+```
+
 ## 🎯 Options
 
 | Option    | Type      | Default | Description                                                               |
@@ -137,12 +151,21 @@ const result2 = divider(words, 2, { flatten: true });
 
 ## 💡 Features
 
+### 🧩 Flexible Division
+
 - Supports both `index-based` and `string-based` division
-- Works with both `strings` and `arrays of strings`
-- Supports `multiple separators` (mixing indexes and characters).
-- Provides an `optional flattening` feature for array results.
-- **Get only the first divided element using `dividerFirst()`**
-- **Get only the last divided element using `dividerLast()`**
+- Supports `multiple separators` (mixing indexes and characters)
+- Works with both `string` and `string[]` input
+- Optional `flatten` behavior to control nested results
+
+### 🎯 Targeted Extraction
+
+- `dividerFirst()`: Get only the first divided element
+- `dividerLast()`: Get only the last divided element
+
+### 🔁 Repeated Division
+
+- `dividerLoop()`: Automatically divide into fixed-size chunks
 
 ## 🛠 Contributing
 

package/dist/cjs/core/divider-loop.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dividerLoop = dividerLoop;
+const is_1 = require("@/utils/is");
+const chunk_1 = require("@/utils/chunk");
+const divider_1 = require("@/core/divider");
+function dividerLoop(input, size, options) {
+    var _a;
+    if (!(0, is_1.isNumber)(size) || size <= 0) {
+        console.warn('dividerLoop: chunk size must be a positive number');
+        return [];
+    }
+    const flatten = (_a = options === null || options === void 0 ? void 0 : options.flatten) !== null && _a !== void 0 ? _a : false;
+    if ((0, is_1.isString)(input)) {
+        const indexes = (0, chunk_1.generateIndexes)(input, size);
+        return (0, divider_1.divider)(input, ...indexes, { flatten });
+    }
+    const result = input.map((item) => {
+        const indexes = (0, chunk_1.generateIndexes)(item, size);
+        return (0, divider_1.divider)(item, ...indexes);
+    });
+    return (flatten ? result.flat() : result);
+}

package/dist/cjs/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dividerLast = exports.dividerFirst = exports.divider = void 0;
+exports.dividerLoop = exports.dividerLast = exports.dividerFirst = exports.divider = void 0;
 var divider_1 = require("@/core/divider");
 Object.defineProperty(exports, "divider", { enumerable: true, get: function () { return divider_1.divider; } });
 var divider_first_1 = require("@/core/divider-first");
 Object.defineProperty(exports, "dividerFirst", { enumerable: true, get: function () { return divider_first_1.dividerFirst; } });
 var divider_last_1 = require("@/core/divider-last");
 Object.defineProperty(exports, "dividerLast", { enumerable: true, get: function () { return divider_last_1.dividerLast; } });
+var divider_loop_1 = require("@/core/divider-loop");
+Object.defineProperty(exports, "dividerLoop", { enumerable: true, get: function () { return divider_loop_1.dividerLoop; } });

package/dist/cjs/utils/chunk.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateIndexes = generateIndexes;
+function generateIndexes(text, size) {
+    const indexes = [];
+    for (let i = size; i < text.length; i += size) {
+        indexes.push(i);
+    }
+    return indexes;
+}

package/dist/esm/core/divider-loop.js

@@ -0,0 +1,20 @@
+import { isString, isNumber } from '@/utils/is';
+import { generateIndexes } from '@/utils/chunk';
+import { divider } from '@/core/divider';
+export function dividerLoop(input, size, options) {
+    var _a;
+    if (!isNumber(size) || size <= 0) {
+        console.warn('dividerLoop: chunk size must be a positive number');
+        return [];
+    }
+    const flatten = (_a = options === null || options === void 0 ? void 0 : options.flatten) !== null && _a !== void 0 ? _a : false;
+    if (isString(input)) {
+        const indexes = generateIndexes(input, size);
+        return divider(input, ...indexes, { flatten });
+    }
+    const result = input.map((item) => {
+        const indexes = generateIndexes(item, size);
+        return divider(item, ...indexes);
+    });
+    return (flatten ? result.flat() : result);
+}

package/dist/esm/index.js

@@ -1,3 +1,4 @@
 export { divider } from '@/core/divider';
 export { dividerFirst } from '@/core/divider-first';
 export { dividerLast } from '@/core/divider-last';
+export { dividerLoop } from '@/core/divider-loop';

package/dist/esm/utils/chunk.js

@@ -0,0 +1,7 @@
+export function generateIndexes(text, size) {
+    const indexes = [];
+    for (let i = size; i < text.length; i += size) {
+        indexes.push(i);
+    }
+    return indexes;
+}

package/dist/types/core/divider-loop.d.ts

@@ -0,0 +1,2 @@
+import type { DividerOptions, DividerResult } from '@/core/types';
+export declare function dividerLoop<T extends string | string[], F extends boolean>(input: T, size: number, options?: DividerOptions<F>): DividerResult<T, F>;

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export { divider } from '@/core/divider';
 export { dividerFirst } from '@/core/divider-first';
 export { dividerLast } from '@/core/divider-last';
+export { dividerLoop } from '@/core/divider-loop';
 export type { DividerResult } from '@/core/types';

package/dist/types/utils/chunk.d.ts

@@ -0,0 +1 @@
+export declare function generateIndexes(text: string, size: number): number[];

package/package.json

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