@nyaomaru/divider 1.0.21 → 1.2.0

package/README.md

@@ -43,7 +43,7 @@ yarn add @nyaomaru/divider
 
 👉 [Check out the full documentation here!](https://divider-docs.vercel.app/)
 
-`divider` allows you to split a string or an array of strings using index positions or delimiters.
+`divider` allows you to divide a string or an array of strings using index positions or delimiters.
 
 ### 📌 Basic Usage
 
@@ -90,6 +90,34 @@ const flatArray = divider(['hello', 'new world'], ' ', 2, { flatten: true });
 // ['he', 'llo', 'ne', 'w', 'wor', 'ld']
 ```
 
+### 📌 `dividerFirst()` Usage
+
+`dividerFirst()` returns only the first divided element from the result.
+
+```ts
+import { dividerFirst } from '@nyaomaru/divider';
+
+const firstElement = dividerFirst('hello world', ' ');
+// 'hello'
+
+const firstArrayElement = dividerFirst(['hello', 'world'], 2);
+// 'he'
+```
+
+### 📌 `dividerLast()` Usage
+
+`dividerLast()` returns only the last divided element from the result.
+
+```ts
+import { dividerLast } from '@nyaomaru/divider';
+
+const firstElement = dividerLast('hello world', ' ');
+// 'world'
+
+const firstArrayElement = dividerLast(['hello', 'world'], 2);
+// 'rld'
+```
+
 ## 🎯 Options
 
 | Option    | Type      | Default | Description                                                               |
@@ -113,6 +141,8 @@ const result2 = divider(words, 2, { flatten: true });
 - 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()`**
 
 ## 🛠 Contributing
 

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dividerFirst = dividerFirst;
+const divider_1 = require("@/core/divider");
+function dividerFirst(input, ...args) {
+    var _a, _b;
+    const result = (0, divider_1.divider)(input, ...args);
+    if (Array.isArray(result[0])) {
+        return (_a = result[0][0]) !== null && _a !== void 0 ? _a : '';
+    }
+    return (_b = result[0]) !== null && _b !== void 0 ? _b : '';
+}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dividerLast = dividerLast;
+const divider_1 = require("@/core/divider");
+function dividerLast(input, ...args) {
+    var _a;
+    const result = (0, divider_1.divider)(input, ...args);
+    if (result.length === 0)
+        return '';
+    const lastElement = result[result.length - 1];
+    return Array.isArray(lastElement) ? ((_a = lastElement.at(-1)) !== null && _a !== void 0 ? _a : '') : lastElement;
+}

package/dist/cjs/index.js

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.divider = void 0;
+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; } });

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

@@ -0,0 +1,9 @@
+import { divider } from '@/core/divider';
+export function dividerFirst(input, ...args) {
+    var _a, _b;
+    const result = divider(input, ...args);
+    if (Array.isArray(result[0])) {
+        return (_a = result[0][0]) !== null && _a !== void 0 ? _a : '';
+    }
+    return (_b = result[0]) !== null && _b !== void 0 ? _b : '';
+}

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

@@ -0,0 +1,9 @@
+import { divider } from '@/core/divider';
+export function dividerLast(input, ...args) {
+    var _a;
+    const result = divider(input, ...args);
+    if (result.length === 0)
+        return '';
+    const lastElement = result[result.length - 1];
+    return Array.isArray(lastElement) ? ((_a = lastElement.at(-1)) !== null && _a !== void 0 ? _a : '') : lastElement;
+}

package/dist/esm/index.js

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

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

@@ -0,0 +1,2 @@
+import type { DividerArgs } from '@/core/types';
+export declare function dividerFirst<T extends string | string[], F extends boolean = false>(input: T, ...args: DividerArgs<F>): string;

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

@@ -0,0 +1,2 @@
+import type { DividerArgs } from '@/core/types';
+export declare function dividerLast<T extends string | string[], F extends boolean>(input: T, ...args: DividerArgs<F>): string;

package/dist/types/index.d.ts

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

package/package.json

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