@nyaomaru/divider 1.1.0 → 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
 
@@ -104,6 +104,20 @@ 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                                                               |
@@ -128,6 +142,7 @@ const result2 = divider(words, 2, { flatten: true });
 - 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-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,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dividerFirst = 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-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,2 +1,3 @@
 export { divider } from '@/core/divider';
 export { dividerFirst } from '@/core/divider-first';
+export { dividerLast } from '@/core/divider-last';

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,3 +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.1.0",
+  "version": "1.2.0",
   "description": "To divide string or string[] with a given separator",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",