es-toolkit 1.21.0-dev.684 → 1.21.0-dev.686

package/dist/compat/index.d.mts

@@ -139,6 +139,7 @@ export { mergeWith } from './object/mergeWith.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
 export { unset } from './object/unset.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { includes } from './object/includes.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';

package/dist/compat/index.d.ts

@@ -139,6 +139,7 @@ export { mergeWith } from './object/mergeWith.js';
 export { fromPairs } from './object/fromPairs.js';
 export { unset } from './object/unset.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { includes } from './object/includes.js';
 export { isPlainObject } from './predicate/isPlainObject.js';
 export { isArray } from './predicate/isArray.js';
 export { isArguments } from './predicate/isArguments.js';

package/dist/compat/index.js

@@ -1323,6 +1323,73 @@ function fromPairs(pairs) {
     return result;
 }
 
+function isString(value) {
+    return typeof value === 'string' || value instanceof String;
+}
+
+function toNumber(value) {
+    if (isSymbol(value)) {
+        return NaN;
+    }
+    return Number(value);
+}
+
+function toFinite(value) {
+    if (!value) {
+        return value === 0 ? value : 0;
+    }
+    value = toNumber(value);
+    if (value === Infinity || value === -Infinity) {
+        const sign = value < 0 ? -1 : 1;
+        return sign * Number.MAX_VALUE;
+    }
+    return value === value ? value : 0;
+}
+
+function toInteger(value) {
+    const finite = toFinite(value);
+    const remainder = finite % 1;
+    return remainder ? finite - remainder : finite;
+}
+
+function includes(source, target, fromIndex, guard) {
+    if (source == null) {
+        return false;
+    }
+    if (guard || !fromIndex) {
+        fromIndex = 0;
+    }
+    else {
+        fromIndex = toInteger(fromIndex);
+    }
+    if (isString(source)) {
+        if (fromIndex > source.length || target instanceof RegExp) {
+            return false;
+        }
+        if (fromIndex < 0) {
+            fromIndex = Math.max(0, source.length + fromIndex);
+        }
+        return source.includes(target, fromIndex);
+    }
+    if (Array.isArray(source)) {
+        return source.includes(target, fromIndex);
+    }
+    const keys = [];
+    for (const key in source) {
+        keys.push(key);
+    }
+    if (fromIndex < 0) {
+        fromIndex = Math.max(0, keys.length + fromIndex);
+    }
+    for (let i = fromIndex; i < keys.length; i++) {
+        const value = Reflect.get(source, keys[i]);
+        if (value === target || (Number.isNaN(value) && Number.isNaN(target))) {
+            return true;
+        }
+    }
+    return false;
+}
+
 function isObject(value) {
     return value !== null && (typeof value === 'object' || typeof value === 'function');
 }
@@ -1343,10 +1410,6 @@ function isRegExp(value) {
     return isWeakSet$1.isRegExp(value);
 }
 
-function isString(value) {
-    return typeof value === 'string' || value instanceof String;
-}
-
 function isWeakMap(value) {
     return isWeakSet$1.isWeakMap(value);
 }
@@ -1713,31 +1776,6 @@ function random(...args) {
     }
 }
 
-function toNumber(value) {
-    if (isSymbol(value)) {
-        return NaN;
-    }
-    return Number(value);
-}
-
-function toFinite(value) {
-    if (!value) {
-        return value === 0 ? value : 0;
-    }
-    value = toNumber(value);
-    if (value === Infinity || value === -Infinity) {
-        const sign = value < 0 ? -1 : 1;
-        return sign * Number.MAX_VALUE;
-    }
-    return value === value ? value : 0;
-}
-
-function toInteger(value) {
-    const finite = toFinite(value);
-    const remainder = finite % 1;
-    return remainder ? finite - remainder : finite;
-}
-
 exports.at = zipWith.at;
 exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
@@ -1869,6 +1907,7 @@ exports.fromPairs = fromPairs;
 exports.get = get;
 exports.has = has;
 exports.inRange = inRange;
+exports.includes = includes;
 exports.indexOf = indexOf;
 exports.isArguments = isArguments;
 exports.isArray = isArray;

package/dist/compat/index.mjs

@@ -140,6 +140,7 @@ export { mergeWith } from './object/mergeWith.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
 export { unset } from './object/unset.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { includes } from './object/includes.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';

package/dist/compat/object/includes.d.mts

@@ -0,0 +1,62 @@
+/**
+ * Checks if an item is included in an array.
+ *
+ * @param {T[]} arr - The array to search in.
+ * @param {T} item - The item to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the array.
+ * @returns {boolean} `true` if the item is found in the array, `false` otherwise.
+ *
+ * @example
+ * includes([1, 2, 3], 2); // true
+ * includes([1, 2, 3], 4); // false
+ * includes([1, 2, 3], 3, -1); // true
+ */
+declare function includes<T>(arr: readonly T[], item: T, fromIndex?: number): boolean;
+/**
+ * Checks if a value is included in an object.
+ *
+ * @param {T} obj - The object to search in.
+ * @param {T[keyof T]} value - The value to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the array.
+ * @returns {boolean} `true` if the value is found in the object, `false` otherwise.
+ *
+ * @example
+ * includes({ a: 1, b: 'a', c: NaN }, 1); // true
+ * includes({ a: 1, b: 'a', c: NaN }, 'a'); // true
+ * includes({ a: 1, b: 'a', c: NaN }, NaN); // true
+ * includes({ [Symbol('sym1')]: 1 }, 1); // false
+ */
+declare function includes<T extends Record<string, any>>(obj: T, value: T[keyof T], fromIndex?: number): boolean;
+/**
+ * Checks if a substring is included in a string.
+ *
+ * @param {string} str - The string to search in.
+ * @param {string} substr - The substring to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the string.
+ * @returns {boolean} `true` if the substring is found in the string, `false` otherwise.
+ *
+ * @example
+ * includes('hello world', 'world'); // true
+ * includes('hello world', 'test'); // false
+ * includes('hello world', 'o', 5); // true
+ */
+declare function includes(str: string, substr: string, fromIndex?: number): boolean;
+/**
+ * Checks if a specified value exists within a given source, which can be an array, an object, or a string.
+ *
+ * The comparison uses SameValueZero to check for inclusion.
+ *
+ * @param {T[] | Record<string, any> | string} source - The source to search in. It can be an array, an object, or a string.
+ * @param {T} [target] - The value to search for in the source.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the source.
+ * @returns {boolean} `true` if the value is found in the source, `false` otherwise.
+ *
+ * @example
+ * includes([1, 2, 3], 2); // true
+ * includes({ a: 1, b: 'a', c: NaN }, 'a'); // true
+ * includes('hello world', 'world'); // true
+ * includes('hello world', 'test'); // false
+ */
+declare function includes<T>(source: readonly T[] | Record<string, any> | string, target?: T, fromIndex?: number): boolean;
+
+export { includes };

package/dist/compat/object/includes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Checks if an item is included in an array.
+ *
+ * @param {T[]} arr - The array to search in.
+ * @param {T} item - The item to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the array.
+ * @returns {boolean} `true` if the item is found in the array, `false` otherwise.
+ *
+ * @example
+ * includes([1, 2, 3], 2); // true
+ * includes([1, 2, 3], 4); // false
+ * includes([1, 2, 3], 3, -1); // true
+ */
+declare function includes<T>(arr: readonly T[], item: T, fromIndex?: number): boolean;
+/**
+ * Checks if a value is included in an object.
+ *
+ * @param {T} obj - The object to search in.
+ * @param {T[keyof T]} value - The value to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the array.
+ * @returns {boolean} `true` if the value is found in the object, `false` otherwise.
+ *
+ * @example
+ * includes({ a: 1, b: 'a', c: NaN }, 1); // true
+ * includes({ a: 1, b: 'a', c: NaN }, 'a'); // true
+ * includes({ a: 1, b: 'a', c: NaN }, NaN); // true
+ * includes({ [Symbol('sym1')]: 1 }, 1); // false
+ */
+declare function includes<T extends Record<string, any>>(obj: T, value: T[keyof T], fromIndex?: number): boolean;
+/**
+ * Checks if a substring is included in a string.
+ *
+ * @param {string} str - The string to search in.
+ * @param {string} substr - The substring to search for.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the string.
+ * @returns {boolean} `true` if the substring is found in the string, `false` otherwise.
+ *
+ * @example
+ * includes('hello world', 'world'); // true
+ * includes('hello world', 'test'); // false
+ * includes('hello world', 'o', 5); // true
+ */
+declare function includes(str: string, substr: string, fromIndex?: number): boolean;
+/**
+ * Checks if a specified value exists within a given source, which can be an array, an object, or a string.
+ *
+ * The comparison uses SameValueZero to check for inclusion.
+ *
+ * @param {T[] | Record<string, any> | string} source - The source to search in. It can be an array, an object, or a string.
+ * @param {T} [target] - The value to search for in the source.
+ * @param {number} [fromIndex=0] - The index to start searching from. If negative, it is treated as an offset from the end of the source.
+ * @returns {boolean} `true` if the value is found in the source, `false` otherwise.
+ *
+ * @example
+ * includes([1, 2, 3], 2); // true
+ * includes({ a: 1, b: 'a', c: NaN }, 'a'); // true
+ * includes('hello world', 'world'); // true
+ * includes('hello world', 'test'); // false
+ */
+declare function includes<T>(source: readonly T[] | Record<string, any> | string, target?: T, fromIndex?: number): boolean;
+
+export { includes };

package/dist/compat/object/includes.mjs

@@ -0,0 +1,42 @@
+import { isString } from '../predicate/isString.mjs';
+import { toInteger } from '../util/toInteger.mjs';
+
+function includes(source, target, fromIndex, guard) {
+    if (source == null) {
+        return false;
+    }
+    if (guard || !fromIndex) {
+        fromIndex = 0;
+    }
+    else {
+        fromIndex = toInteger(fromIndex);
+    }
+    if (isString(source)) {
+        if (fromIndex > source.length || target instanceof RegExp) {
+            return false;
+        }
+        if (fromIndex < 0) {
+            fromIndex = Math.max(0, source.length + fromIndex);
+        }
+        return source.includes(target, fromIndex);
+    }
+    if (Array.isArray(source)) {
+        return source.includes(target, fromIndex);
+    }
+    const keys = [];
+    for (const key in source) {
+        keys.push(key);
+    }
+    if (fromIndex < 0) {
+        fromIndex = Math.max(0, keys.length + fromIndex);
+    }
+    for (let i = fromIndex; i < keys.length; i++) {
+        const value = Reflect.get(source, keys[i]);
+        if (value === target || (Number.isNaN(value) && Number.isNaN(target))) {
+            return true;
+        }
+    }
+    return false;
+}
+
+export { includes };

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.21.0-dev.684+6e3226e2",
+  "version": "1.21.0-dev.686+dd30980a",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {