es-toolkit 1.37.2-dev.1258 → 1.37.2-dev.1259

package/dist/compat/array/sortedLastIndexOf.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Finds the index of the last occurrence of a value in a sorted array.
+ * This function is similar to `Array#lastIndexOf` but is specifically designed for sorted arrays.
+ *
+ * Make sure to provide a sorted array to this function, as it uses a binary search to quickly find the index.
+ *
+ * @param {ArrayLike<T> | null | undefined} array The sorted array to inspect.
+ * @param {T} value The value to search for.
+ * @returns {number} Returns the index of the last matched value, else -1.
+ *
+ * @example
+ * const numbers = [1, 2, 3, 4, 5];
+ * sortedLastIndexOf(numbers, 3); // Return value: 2
+ * sortedLastIndexOf(numbers, 6); // Return value: -1
+ *
+ * // If the value is duplicated, it returns the last index of the value.
+ * const duplicateNumbers = [1, 2, 2, 3, 3, 3, 4];
+ * sortedLastIndexOf(duplicateNumbers, 3); // Return value: 5
+ *
+ * // If the array is unsorted, it can return the wrong index.
+ * const unSortedArray = [55, 33, 22, 11, 44];
+ * sortedLastIndexOf(unSortedArray, 11); // Return value: -1
+ *
+ * // -0 and 0 are treated the same
+ * const mixedZeroArray = [-0, 0];
+ * sortedLastIndexOf(mixedZeroArray, 0); // Return value: 1
+ * sortedLastIndexOf(mixedZeroArray, -0); // Return value: 1
+ *
+ * // It works with array-like objects
+ * const arrayLike = { length: 3, 0: 10, 1: 20, 2: 20 };
+ * sortedLastIndexOf(arrayLike, 20); // Return value: 2
+ */
+declare function sortedLastIndexOf<T>(array: ArrayLike<T> | null | undefined, value: T): number;
+
+export { sortedLastIndexOf };

package/dist/compat/array/sortedLastIndexOf.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Finds the index of the last occurrence of a value in a sorted array.
+ * This function is similar to `Array#lastIndexOf` but is specifically designed for sorted arrays.
+ *
+ * Make sure to provide a sorted array to this function, as it uses a binary search to quickly find the index.
+ *
+ * @param {ArrayLike<T> | null | undefined} array The sorted array to inspect.
+ * @param {T} value The value to search for.
+ * @returns {number} Returns the index of the last matched value, else -1.
+ *
+ * @example
+ * const numbers = [1, 2, 3, 4, 5];
+ * sortedLastIndexOf(numbers, 3); // Return value: 2
+ * sortedLastIndexOf(numbers, 6); // Return value: -1
+ *
+ * // If the value is duplicated, it returns the last index of the value.
+ * const duplicateNumbers = [1, 2, 2, 3, 3, 3, 4];
+ * sortedLastIndexOf(duplicateNumbers, 3); // Return value: 5
+ *
+ * // If the array is unsorted, it can return the wrong index.
+ * const unSortedArray = [55, 33, 22, 11, 44];
+ * sortedLastIndexOf(unSortedArray, 11); // Return value: -1
+ *
+ * // -0 and 0 are treated the same
+ * const mixedZeroArray = [-0, 0];
+ * sortedLastIndexOf(mixedZeroArray, 0); // Return value: 1
+ * sortedLastIndexOf(mixedZeroArray, -0); // Return value: 1
+ *
+ * // It works with array-like objects
+ * const arrayLike = { length: 3, 0: 10, 1: 20, 2: 20 };
+ * sortedLastIndexOf(arrayLike, 20); // Return value: 2
+ */
+declare function sortedLastIndexOf<T>(array: ArrayLike<T> | null | undefined, value: T): number;
+
+export { sortedLastIndexOf };

package/dist/compat/array/sortedLastIndexOf.mjs

@@ -0,0 +1,15 @@
+import { sortedLastIndex } from './sortedLastIndex.mjs';
+import { eq } from '../util/eq.mjs';
+
+function sortedLastIndexOf(array, value) {
+    if (!array?.length) {
+        return -1;
+    }
+    const index = sortedLastIndex(array, value) - 1;
+    if (index >= 0 && eq(array[index], value)) {
+        return index;
+    }
+    return -1;
+}
+
+export { sortedLastIndexOf };

package/dist/compat/compat.d.mts

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.mjs';
 export { sortedIndexOf } from './array/sortedIndexOf.mjs';
 export { sortedLastIndex } from './array/sortedLastIndex.mjs';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.mjs';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';

package/dist/compat/compat.d.ts

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.js';
 export { sortedIndexOf } from './array/sortedIndexOf.js';
 export { sortedLastIndex } from './array/sortedLastIndex.js';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.js';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.js';
 export { tail } from './array/tail.js';
 export { take } from './array/take.js';
 export { takeRight } from './array/takeRight.js';

package/dist/compat/compat.mjs

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.mjs';
 export { sortedIndexOf } from './array/sortedIndexOf.mjs';
 export { sortedLastIndex } from './array/sortedLastIndex.mjs';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.mjs';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';

package/dist/compat/index.d.mts

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.mjs';
 export { sortedIndexOf } from './array/sortedIndexOf.mjs';
 export { sortedLastIndex } from './array/sortedLastIndex.mjs';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.mjs';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';

package/dist/compat/index.d.ts

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.js';
 export { sortedIndexOf } from './array/sortedIndexOf.js';
 export { sortedLastIndex } from './array/sortedLastIndex.js';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.js';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.js';
 export { tail } from './array/tail.js';
 export { take } from './array/take.js';
 export { takeRight } from './array/takeRight.js';

package/dist/compat/index.js

@@ -1825,6 +1825,17 @@ function sortedLastIndex(array, value) {
     return high;
 }
 
+function sortedLastIndexOf(array, value) {
+    if (!array?.length) {
+        return -1;
+    }
+    const index = sortedLastIndex(array, value) - 1;
+    if (index >= 0 && isWeakSet$1.eq(array[index], value)) {
+        return index;
+    }
+    return -1;
+}
+
 function tail(arr) {
     if (!isArrayLike(arr)) {
         return [];
@@ -4403,6 +4414,7 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     sortedIndexOf,
     sortedLastIndex,
     sortedLastIndexBy,
+    sortedLastIndexOf,
     split,
     spread,
     startCase,
@@ -4702,6 +4714,7 @@ exports.sortedIndexBy = sortedIndexBy;
 exports.sortedIndexOf = sortedIndexOf;
 exports.sortedLastIndex = sortedLastIndex;
 exports.sortedLastIndexBy = sortedLastIndexBy;
+exports.sortedLastIndexOf = sortedLastIndexOf;
 exports.split = split;
 exports.spread = spread;
 exports.startCase = startCase;

package/dist/compat/index.mjs

@@ -61,6 +61,7 @@ export { sortedIndexBy } from './array/sortedIndexBy.mjs';
 export { sortedIndexOf } from './array/sortedIndexOf.mjs';
 export { sortedLastIndex } from './array/sortedLastIndex.mjs';
 export { sortedLastIndexBy } from './array/sortedLastIndexBy.mjs';
+export { sortedLastIndexOf } from './array/sortedLastIndexOf.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.37.2-dev.1258+28a1f69a",
+  "version": "1.37.2-dev.1259+81f34d80",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {