@oscarpalmer/atoms 0.175.0 → 0.176.0

package/dist/index.d.mts

@@ -2552,6 +2552,30 @@ declare function registerCloner<Instance>(constructor: Constructor<Instance>, ha
  */
 declare function unregisterCloner<Instance>(constructor: Constructor<Instance>): void;
 //#endregion
+//#region src/value/collection.d.ts
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+declare function inMap<Value>(map: Map<unknown, Value>, value: Value): boolean;
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @param key To return the key for the value
+ * @return The key for the value if it exists, otherwise `undefined`
+ */
+declare function inMap<Key, Value>(map: Map<Key, Value>, value: Value, key: true): Key;
+/**
+ * Does the value exist in a set?
+ * @param set Set to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+declare function inSet<Value>(set: Set<Value>, value: Value): boolean;
+//#endregion
 //#region src/value/diff.d.ts
 /**
  * Options for value comparison
@@ -4483,4 +4507,4 @@ declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { AnyResult, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayPosition, ArrayValueSorter, Asserter, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, ExtendedErr, ExtendedResult, Flow, FlowPromise, FulfilledPromise, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, HasValue, Key, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, Simplify, SizedMap, SizedSet, Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Time, ToString, TypedArray, Unsmushed, UnwrapValue, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { AnyResult, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayPosition, ArrayValueSorter, Asserter, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, ExtendedErr, ExtendedResult, Flow, FlowPromise, FulfilledPromise, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, HasValue, Key, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, Simplify, SizedMap, SizedSet, Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Time, ToString, TypedArray, Unsmushed, UnwrapValue, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/index.mjs

@@ -2464,6 +2464,26 @@ function tryStructuredClone(value, depth, references) {
 }
 const MAX_CLONE_DEPTH = 100;
 //#endregion
+//#region src/value/collection.ts
+function inMap(map, value, key) {
+	const getKey = key === true;
+	if (!(map instanceof Map)) return getKey ? void 0 : false;
+	if (!getKey) return inSet(new Set(map.values()), value);
+	for (const [key, item] of map) if (equal(item, value)) return key;
+}
+/**
+* Does the value exist in a set?
+* @param set Set to check in
+* @param value Value to check for
+* @returns `true` if the value exists, otherwise `false`
+*/
+function inSet(set, value) {
+	if (!(set instanceof Set)) return false;
+	if (set.has(value)) return true;
+	for (const item of set) if (equal(item, value)) return true;
+	return false;
+}
+//#endregion
 //#region src/value/diff.ts
 /**
 * Find the differences between two values
@@ -4588,4 +4608,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/value/collection.d.mts

@@ -0,0 +1,25 @@
+//#region src/value/collection.d.ts
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+declare function inMap<Value>(map: Map<unknown, Value>, value: Value): boolean;
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @param key To return the key for the value
+ * @return The key for the value if it exists, otherwise `undefined`
+ */
+declare function inMap<Key, Value>(map: Map<Key, Value>, value: Value, key: true): Key;
+/**
+ * Does the value exist in a set?
+ * @param set Set to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+declare function inSet<Value>(set: Set<Value>, value: Value): boolean;
+//#endregion
+export { inMap, inSet };

package/dist/value/collection.mjs

@@ -0,0 +1,22 @@
+import { equal } from "../internal/value/equal.mjs";
+//#region src/value/collection.ts
+function inMap(map, value, key) {
+	const getKey = key === true;
+	if (!(map instanceof Map)) return getKey ? void 0 : false;
+	if (!getKey) return inSet(new Set(map.values()), value);
+	for (const [key, item] of map) if (equal(item, value)) return key;
+}
+/**
+* Does the value exist in a set?
+* @param set Set to check in
+* @param value Value to check for
+* @returns `true` if the value exists, otherwise `false`
+*/
+function inSet(set, value) {
+	if (!(set instanceof Set)) return false;
+	if (set.has(value)) return true;
+	for (const item of set) if (equal(item, value)) return true;
+	return false;
+}
+//#endregion
+export { inMap, inSet };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.175.0",
+	"version": "0.176.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"helper",
@@ -200,6 +200,10 @@
 			"types": "./dist/value/clone.d.mts",
 			"default": "./dist/value/clone.mjs"
 		},
+		"./value/collection": {
+			"types": "./dist/value/collection.d.mts",
+			"default": "./dist/value/collection.mjs"
+		},
 		"./value/compare": {
 			"types": "./dist/internal/value/compare.d.mts",
 			"default": "./dist/internal/value/compare.mjs"

package/src/index.ts

@@ -29,6 +29,7 @@ export * from './string/match';
 export * from './string/template';
 
 export * from './value/clone';
+export * from './value/collection';
 export * from './value/diff';
 export * from './value/index';
 export * from './value/merge';

package/src/value/collection.ts

@@ -0,0 +1,60 @@
+import {equal} from '../internal/value/equal';
+
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+export function inMap<Value>(map: Map<unknown, Value>, value: Value): boolean;
+
+/**
+ * Does the value exist for a key in a map?
+ * @param map Map to check in
+ * @param value Value to check for
+ * @param key To return the key for the value
+ * @return The key for the value if it exists, otherwise `undefined`
+ */
+export function inMap<Key, Value>(map: Map<Key, Value>, value: Value, key: true): Key;
+
+export function inMap<Key, Value>(map: Map<Key, Value>, value: Value, key?: unknown): unknown {
+	const getKey = key === true;
+
+	if (!(map instanceof Map)) {
+		return getKey ? undefined : false;
+	}
+
+	if (!getKey) {
+		return inSet(new Set(map.values()), value);
+	}
+
+	for (const [key, item] of map) {
+		if (equal(item, value)) {
+			return key;
+		}
+	}
+}
+
+/**
+ * Does the value exist in a set?
+ * @param set Set to check in
+ * @param value Value to check for
+ * @returns `true` if the value exists, otherwise `false`
+ */
+export function inSet<Value>(set: Set<Value>, value: Value): boolean {
+	if (!(set instanceof Set)) {
+		return false;
+	}
+
+	if (set.has(value)) {
+		return true;
+	}
+
+	for (const item of set) {
+		if (equal(item, value)) {
+			return true;
+		}
+	}
+
+	return false;
+}