@oscarpalmer/atoms 0.180.0 → 0.182.0

package/dist/index.mjs

@@ -21,9 +21,12 @@ function findValue(type, array, parameters, reversed) {
 	if (!Array.isArray(array) || array.length === 0) return findIndex ? -1 : void 0;
 	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
-	if (callbacks?.bool == null && callbacks?.keyed == null) return findIndex ? array.indexOf(value) : array.find((item) => Object.is(item, value));
+	if (callbacks?.bool == null && callbacks?.keyed == null) {
+		if (findIndex) return reversed ? array.lastIndexOf(value) : array.indexOf(value);
+		return reversed ? array.findLast((item) => Object.is(item, value)) : array.find((item) => Object.is(item, value));
+	}
 	if (callbacks.bool != null) {
-		const index = array.findIndex(callbacks.bool);
+		const index = reversed ? array.findLastIndex(callbacks.bool) : array.findIndex(callbacks.bool);
 		return findIndex ? index : array[index];
 	}
 	return findValueInArray(array, callbacks.keyed, value, findIndex, reversed);
@@ -177,6 +180,10 @@ function compact(array, strict) {
 function indexOf(array, ...parameters) {
 	return findValue(FIND_VALUE_INDEX, array, parameters, false);
 }
+indexOf.last = lastIndexOf;
+function lastIndexOf(array, ...parameters) {
+	return findValue(FIND_VALUE_INDEX, array, parameters, true);
+}
 //#endregion
 //#region src/internal/is.ts
 /**
@@ -426,6 +433,10 @@ function exists(array, ...parameters) {
 function find(array, ...parameters) {
 	return findValue(FIND_VALUE_ITEM, array, parameters, false);
 }
+find.last = findLast;
+function findLast(array, ...parameters) {
+	return findValue(FIND_VALUE_ITEM, array, parameters, true);
+}
 //#endregion
 //#region src/array/flatten.ts
 /**
@@ -460,7 +471,7 @@ function times(length, value) {
 function getArray(value, indiced) {
 	if (Array.isArray(value)) return value;
 	if (value instanceof Map || value instanceof Set) return [...value.values()];
-	if (!isPlainObject(value)) return [value];
+	if (isNonPlainObject(value)) return [value];
 	if (indiced !== true) return Object.values(value);
 	const keys = Object.keys(value);
 	const { length } = keys;
@@ -609,10 +620,10 @@ function select(array, ...parameters) {
 //#region src/array/single.ts
 function single(array, ...parameters) {
 	const { matched } = findValues("all", array, parameters);
-	if (matched.length > 1) throw new Error(MESSAGE);
+	if (matched.length > 1) throw new Error(MESSAGE$1);
 	return matched[0];
 }
-const MESSAGE = "Multiple items were found";
+const MESSAGE$1 = "Multiple items were found";
 //#endregion
 //#region src/array/slice.ts
 function drop(array, first, second) {
@@ -831,7 +842,7 @@ function aggregate(type, array, key) {
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
 		const value = callback == null ? item : callback(item, index, array);
-		if (!isNumber(value)) continue;
+		if (isNonNumber(value)) continue;
 		aggregated = aggregator(aggregated, value, notNumber);
 		counted += 1;
 		notNumber = false;
@@ -881,13 +892,23 @@ function ignoreKey(key) {
 	return EXPRESSION_IGNORED.test(key);
 }
 /**
-* Join an array of values into a string
-* @param value Array of values
+* Join an array of values into a string _(while ignoring empty values)_
+*
+* _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+* @param array Array of values
 * @param delimiter Delimiter to use between values
 * @returns Joined string
 */
-function join(value, delimiter) {
-	return compact(value).map(getString).join(typeof delimiter === "string" ? delimiter : "");
+function join(array, delimiter) {
+	if (!Array.isArray(array)) return "";
+	const { length } = array;
+	if (length === 0) return "";
+	const values = [];
+	for (let index = 0; index < length; index += 1) {
+		const item = getString(array[index]);
+		if (item.trim().length > 0) values.push(item);
+	}
+	return values.join(typeof delimiter === "string" ? delimiter : "");
 }
 function tryCallback(value, callback) {
 	try {
@@ -940,7 +961,7 @@ function getHandlers(owner, options) {
 			if (isConstructable(first) && isConstructable(second) && first.constructor === second.constructor) return handlers.get(first.constructor);
 		},
 		register(constructor, handler) {
-			if (!isConstructor(constructor) || handler === owner) return;
+			if (isNonConstructor(constructor) || handler === owner) return;
 			let actual = handler ?? options.method;
 			if (typeof actual !== "function" && typeof actual !== "string") return;
 			if (typeof actual === "string") actual = typeof constructor.prototype[actual] === "function" ? actual : void 0;
@@ -1890,7 +1911,7 @@ const MESSAGE_FAILED = "Retry failed";
 //#endregion
 //#region src/internal/result.ts
 function _isResult(value, okValue) {
-	if (!isPlainObject(value)) return false;
+	if (isNonPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? PROPERTY_VALUE : PROPERTY_ERROR) in value;
 }
 function isError(value, extended) {
@@ -2106,7 +2127,7 @@ function getEqualOptions(input) {
 		options.ignoreCase = input;
 		return options;
 	}
-	if (!isPlainObject(input)) return options;
+	if (isNonPlainObject(input)) return options;
 	options.ignoreCase = typeof input.ignoreCase === "boolean" ? input.ignoreCase : false;
 	options.ignoreExpressions.values = (Array.isArray(input.ignoreKeys) ? input.ignoreKeys : [input.ignoreKeys]).filter((key) => key instanceof RegExp);
 	options.ignoreKeys.values = new Set((Array.isArray(input.ignoreKeys) ? input.ignoreKeys : [input.ignoreKeys]).filter((key) => typeof key === "string"));
@@ -2268,6 +2289,97 @@ function setValue(data, path, value, ignoreCase) {
 }
 const EXPRESSION_INDEX = /^\d+$/;
 //#endregion
+//#region src/kalas.ts
+var Events = class {
+	#kalas;
+	constructor(kalas) {
+		this.#kalas = kalas;
+	}
+	/**
+	* Subscribe to an event with a callback
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	subscribe(event, callback) {
+		return this.#kalas.subscribe(event, callback);
+	}
+	/**
+	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	unsubscribe(event, callback) {
+		return this.#kalas.unsubscribe(event, callback);
+	}
+};
+var Kalas = class {
+	#names;
+	#subscribers = /* @__PURE__ */ new Map();
+	constructor(names) {
+		this.#names = new Set(names);
+		Object.defineProperty(this, "events", { value: new Events(this) });
+	}
+	/**
+	* Remove all event subscribers
+	*/
+	clear() {
+		this.#subscribers.clear();
+	}
+	/**
+	* Emit an event with parameters
+	* @param event Event name
+	* @param parameters Event parameters
+	*/
+	emit(event, ...parameters) {
+		const subscribers = this.#subscribers.get(event);
+		if (subscribers == null) return;
+		for (const callback of subscribers) callback(...parameters);
+	}
+	/**
+	* Subscribe to an event with a callback
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	subscribe(event, callback) {
+		if (!this.#names.has(event) || typeof callback !== "function") return noop;
+		let subscribers = this.#subscribers.get(event);
+		if (subscribers == null) {
+			subscribers = /* @__PURE__ */ new Set();
+			this.#subscribers.set(event, subscribers);
+		}
+		subscribers.add(callback);
+		return () => {
+			subscribers?.delete(callback);
+		};
+	}
+	/**
+	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
+	* @param event Event name
+	* @param callback Callback function
+	*/
+	unsubscribe(event, callback) {
+		if (!this.#names.has(event) || (callback != null ? typeof callback !== "function" : false)) return;
+		const subscribers = this.#subscribers.get(event);
+		if (subscribers == null) return;
+		if (callback == null) subscribers.clear();
+		else subscribers.delete(callback);
+		if (callback == null || subscribers.size === 0) this.#subscribers.delete(event);
+	}
+};
+/**
+* Create a Kalas _(party)_ for named events
+* @param names Event names
+* @returns Kalas instance
+*/
+function kalas(names) {
+	if (!Array.isArray(names) || names.length === 0 || !names.every((name) => typeof name === "string")) throw new Error(MESSAGE);
+	return new Kalas(names);
+}
+const MESSAGE = "Kalas requires an array of event names.";
+//#endregion
 //#region src/string/case.ts
 /**
 * Convert a string to camel case _(thisIsCamelCase)_
@@ -2301,7 +2413,9 @@ function kebabCase(value) {
 * @returns Lower-cased string
 */
 function lowerCase(value) {
-	return typeof value === "string" ? value.toLocaleLowerCase() : "";
+	if (typeof value !== "string") return "";
+	memoizedLowerCase ??= memoize((v) => v.toLocaleLowerCase());
+	return memoizedLowerCase.run(value);
 }
 /**
 * Convert a string to pascal case _(ThisIsPascalCase)_
@@ -2325,8 +2439,8 @@ function snakeCase(value) {
 * @returns Title-cased string
 */
 function titleCase(value) {
-	if (typeof value !== "string") return "";
-	memoizedTitleCase ??= memoize((v) => v.length < 1 ? capitalize(v) : join(words(v).map(capitalize), " "));
+	if (typeof value !== "string" || value.length === 0) return "";
+	memoizedTitleCase ??= memoize((v) => v.length < 2 ? capitalize(v) : join(words(v).map(capitalize), " "));
 	return memoizedTitleCase.run(value);
 }
 function toCase(type, value, capitalizeAny, capitalizeFirst) {
@@ -2366,7 +2480,9 @@ function toCaseCallback(value) {
 * @returns Upper-cased string
 */
 function upperCase(value) {
-	return typeof value === "string" ? value.toLocaleUpperCase() : "";
+	if (typeof value !== "string" || value.length === 0) return "";
+	memoizedUpperCase ??= memoize((v) => v.toLocaleUpperCase());
+	return memoizedUpperCase.run(value);
 }
 const CASE_CAMEL = "camel";
 const CASE_KEBAB = "kebab";
@@ -2387,7 +2503,9 @@ const delimiters = {
 	[CASE_SNAKE]: DELIMITER_UNDERSCORE
 };
 let memoizedCapitalize;
+let memoizedLowerCase;
 let memoizedTitleCase;
+let memoizedUpperCase;
 //#endregion
 //#region src/is.ts
 /**
@@ -2801,6 +2919,95 @@ function truncate(value, length, suffix) {
 }
 const ZERO = "0";
 //#endregion
+//#region src/string/normalize.ts
+/**
+* Deburr a string, removing diacritical marks
+* @param value String to deburr
+* @returns Deburred string
+*/
+function deburr(value) {
+	if (typeof value !== "string") return "";
+	deburrMemoizer ??= memoize((value) => {
+		let deburred = value.normalize(DEBURR_NORMALIZATION).replace(DEBURR_PATTERN_SIMPLE, "");
+		deburred = deburred.replace(DEBURR_PATTERN_CHARACTERS, (_, character) => DEBURR_CHARACTERS[character]);
+		return deburred;
+	});
+	return deburrMemoizer.run(value);
+}
+function getNormalizeOptions(input) {
+	const options = isPlainObject(input) ? input : {};
+	return {
+		deburr: options.deburr !== false,
+		lowerCase: options.lowerCase !== false,
+		trim: options.trim !== false
+	};
+}
+/**
+* Initialize a string normalizer
+* @param options Normalization options
+* @returns Normalizer function
+*/
+function initializeNormalizer(options) {
+	const normalization = getNormalizeOptions(options);
+	return (value) => normalizeString(value, normalization);
+}
+/**
+* Normalize a string
+*
+* By default, the string will be trimmed, deburred, and then lowercased
+* @param value String to normalize
+* @param options Normalization options
+* @returns Normalized string
+*/
+function normalize(value, options) {
+	return normalizeString(value, getNormalizeOptions(options));
+}
+normalize.initialize = initializeNormalizer;
+function normalizeString(value, options) {
+	if (typeof value !== "string") return "";
+	let result = value;
+	if (options.trim) result = result.trim();
+	if (options.deburr) result = deburr(result);
+	if (options.lowerCase) result = lowerCase(result);
+	return result;
+}
+const DEBURR_CHARACTERS = {
+	Æ: "AE",
+	æ: "ae",
+	Ð: "D",
+	ð: "d",
+	Đ: "D",
+	đ: "d",
+	Ħ: "H",
+	ħ: "h",
+	IJ: "IJ",
+	ij: "ij",
+	İ: "I",
+	ı: "i",
+	ĸ: "k",
+	Ŀ: "L",
+	ŀ: "l",
+	Ł: "L",
+	ł: "l",
+	Ŋ: "N",
+	ŋ: "n",
+	ʼn: "'n",
+	Œ: "OE",
+	œ: "oe",
+	Ø: "O",
+	ø: "o",
+	ſ: "s",
+	ß: "ss",
+	Þ: "TH",
+	þ: "th",
+	Ŧ: "T",
+	ŧ: "t"
+};
+const DEBURR_NORMALIZATION = "NFD";
+const DEBURR_PATTERN_CHARACTERS = new RegExp(`(${Object.keys(DEBURR_CHARACTERS).join("|")})`, "g");
+const DEBURR_PATTERN_SIMPLE = /[\u0300-\u036f]/g;
+let deburrMemoizer;
+//#endregion
 //#region src/string/template.ts
 function getTemplateOptions(input) {
 	const options = isPlainObject(input) ? input : {};
@@ -3134,6 +3341,20 @@ function pick(value, keys) {
 	return partial(value, keys, false);
 }
 //#endregion
+//#region src/value/shake.ts
+function shake(value) {
+	const shaken = {};
+	if (isNonPlainObject(value)) return shaken;
+	const keys = Object.keys(value);
+	const { length } = keys;
+	for (let index = 0; index < length; index += 1) {
+		const key = keys[index];
+		const val = value[key];
+		if (val !== void 0) shaken[key] = val;
+	}
+	return shaken;
+}
+//#endregion
 //#region src/value/smush.ts
 function flattenObject(value, depth, smushed, prefix) {
 	if (depth >= MAX_DEPTH) return {};
@@ -3206,12 +3427,14 @@ function unsmush(value) {
 //#region src/value/merge.ts
 function getMergeOptions(options) {
 	const actual = {
+		assignValues: false,
 		replaceableObjects: void 0,
 		skipNullableAny: false,
 		skipNullableInArrays: false
 	};
 	if (typeof options !== "object" || options == null) return actual;
 	actual.replaceableObjects = getReplaceableObjects(options.replaceableObjects);
+	actual.assignValues = options.assignValues === true;
 	actual.skipNullableAny = options.skipNullableAny === true;
 	actual.skipNullableInArrays = options.skipNullableInArrays === true;
 	return actual;
@@ -3241,7 +3464,7 @@ merge.initialize = initializeMerger;
 function mergeObjects(values, options, prefix) {
 	const { length } = values;
 	const isArray = values.every(Array.isArray);
-	const merged = isArray ? [] : {};
+	const merged = options.assignValues ? values[0] : isArray ? [] : {};
 	for (let outerIndex = 0; outerIndex < length; outerIndex += 1) {
 		const item = values[outerIndex];
 		const keys = Object.keys(item);
@@ -5017,4 +5240,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, assertCondition, assertDefined, assertInstanceOf, assertIs, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, first, firstOrDefault, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeEqualizer, initializeMerger, initializeSorter, initializeTemplater, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, isTypedArray, join, kebabCase, last, lastOrDefault, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, 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, assertCondition, assertDefined, assertInstanceOf, assertIs, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, isTypedArray, join, kalas, kebabCase, last, lastIndexOf, lastOrDefault, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/array/find.d.mts

@@ -10,12 +10,13 @@ type Parameters = {
   key?: unknown;
   value?: unknown;
 };
-declare function findValue(type: FindValueType, array: unknown[], parameters: unknown[], reversed: boolean): unknown;
+declare function findValue(type: Exclude<FindValueType, 'item'>, array: unknown[], parameters: unknown[], reversed: boolean): number;
+declare function findValue(type: Exclude<FindValueType, 'index'>, array: unknown[], parameters: unknown[], reversed: boolean): unknown;
 declare function findAbsoluteValueOrDefault(array: unknown[], parameters: unknown[], defaultValue: unknown, useDefaultValue: boolean, reversed: boolean): unknown;
 declare function findValues(type: FindValuesType, array: unknown[], parameters: unknown[], mapper?: unknown): FindValuesResult;
 declare function getFindParameters(original: unknown[]): Parameters;
-declare const FIND_VALUE_INDEX: FindValueType;
-declare const FIND_VALUE_ITEM: FindValueType;
+declare const FIND_VALUE_INDEX = "index";
+declare const FIND_VALUE_ITEM = "item";
 declare const FIND_VALUES_ALL: FindValuesType;
 declare const FIND_VALUES_UNIQUE: FindValuesType;
 //#endregion

package/dist/internal/array/find.mjs

@@ -5,9 +5,12 @@ function findValue(type, array, parameters, reversed) {
 	if (!Array.isArray(array) || array.length === 0) return findIndex ? -1 : void 0;
 	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
-	if (callbacks?.bool == null && callbacks?.keyed == null) return findIndex ? array.indexOf(value) : array.find((item) => Object.is(item, value));
+	if (callbacks?.bool == null && callbacks?.keyed == null) {
+		if (findIndex) return reversed ? array.lastIndexOf(value) : array.indexOf(value);
+		return reversed ? array.findLast((item) => Object.is(item, value)) : array.find((item) => Object.is(item, value));
+	}
 	if (callbacks.bool != null) {
-		const index = array.findIndex(callbacks.bool);
+		const index = reversed ? array.findLastIndex(callbacks.bool) : array.findIndex(callbacks.bool);
 		return findIndex ? index : array[index];
 	}
 	return findValueInArray(array, callbacks.keyed, value, findIndex, reversed);

package/dist/internal/array/index-of.d.mts

@@ -31,5 +31,46 @@ declare function indexOf<Item>(array: Item[], filter: (item: Item, index: number
  * @returns Index of the first matching item, or `-1` if no match is found
  */
 declare function indexOf<Item>(array: Item[], item: Item): number;
+declare namespace indexOf {
+  var last: typeof lastIndexOf;
+}
+/**
+ * Get the index of the last matching item by callback
+ *
+ * Available as `lastIndexOf` and `indexOf.last`
+ * @param array Array to search in
+ * @param callback Callback to get an item's value
+ * @param value Value to match against
+ * @returns Index of the last matching item, or `-1` if no match is found
+ */
+declare function lastIndexOf<Item, Callback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], callback: Callback, value: ReturnType<Callback>): number;
+/**
+ * Get the index of the last matching item by key
+ *
+ * Available as `lastIndexOf` and `indexOf.last`
+ * @param array Array to search in
+ * @param key Key to match items by
+ * @param value Value to match against
+ * @returns Index of the last matching item, or `-1` if no match is found
+ */
+declare function lastIndexOf<Item extends PlainObject, ItemKey extends keyof Item>(array: Item[], key: ItemKey, value: Item[ItemKey]): number;
+/**
+ * Get the index of the last item matching the filter
+ *
+ * Available as `lastIndexOf` and `indexOf.last`
+ * @param array Array to search in
+ * @param filter Filter callback to match items
+ * @returns Index of the last matching item, or `-1` if no match is found
+ */
+declare function lastIndexOf<Item>(array: Item[], filter: (item: Item, index: number, array: Item[]) => boolean): number;
+/**
+ * Get the index of the last item matching the given item
+ *
+ * Available as `lastIndexOf` and `indexOf.last`
+ * @param array Array to search in
+ * @param item Item to match against
+ * @returns Index of the last matching item, or `-1` if no match is found
+ */
+declare function lastIndexOf<Item>(array: Item[], item: Item): number;
 //#endregion
-export { indexOf };
+export { indexOf, lastIndexOf };

package/dist/internal/array/index-of.mjs

@@ -3,5 +3,9 @@ import { FIND_VALUE_INDEX, findValue } from "./find.mjs";
 function indexOf(array, ...parameters) {
 	return findValue(FIND_VALUE_INDEX, array, parameters, false);
 }
+indexOf.last = lastIndexOf;
+function lastIndexOf(array, ...parameters) {
+	return findValue(FIND_VALUE_INDEX, array, parameters, true);
+}
 //#endregion
-export { indexOf };
+export { indexOf, lastIndexOf };

package/dist/internal/math/aggregate.mjs

@@ -1,4 +1,4 @@
-import { isNumber } from "../is.mjs";
+import { isNonNumber } from "../is.mjs";
 //#region src/internal/math/aggregate.ts
 function aggregate(type, array, key) {
 	const length = Array.isArray(array) ? array.length : 0;
@@ -14,7 +14,7 @@ function aggregate(type, array, key) {
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
 		const value = callback == null ? item : callback(item, index, array);
-		if (!isNumber(value)) continue;
+		if (isNonNumber(value)) continue;
 		aggregated = aggregator(aggregated, value, notNumber);
 		counted += 1;
 		notNumber = false;

package/dist/internal/result.mjs

@@ -1,7 +1,7 @@
-import { isPlainObject } from "./is.mjs";
+import { isNonPlainObject } from "./is.mjs";
 //#region src/internal/result.ts
 function _isResult(value, okValue) {
-	if (!isPlainObject(value)) return false;
+	if (isNonPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? PROPERTY_VALUE : PROPERTY_ERROR) in value;
 }
 function isError(value, extended) {

package/dist/internal/string.d.mts

@@ -7,12 +7,14 @@
 declare function getString(value: unknown): string;
 declare function ignoreKey(key: string): boolean;
 /**
- * Join an array of values into a string
- * @param value Array of values
+ * Join an array of values into a string _(while ignoring empty values)_
+ *
+ * _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+ * @param array Array of values
  * @param delimiter Delimiter to use between values
  * @returns Joined string
  */
-declare function join(value: unknown[], delimiter?: string): string;
+declare function join(array: unknown[], delimiter?: string): string;
 declare function tryDecode(value: string): string;
 declare function tryEncode(value: boolean | number | string): unknown;
 /**

package/dist/internal/string.mjs

@@ -1,4 +1,3 @@
-import { compact } from "./array/compact.mjs";
 //#region src/internal/string.ts
 /**
 * Get the string value from any value
@@ -17,13 +16,23 @@ function ignoreKey(key) {
 	return EXPRESSION_IGNORED.test(key);
 }
 /**
-* Join an array of values into a string
-* @param value Array of values
+* Join an array of values into a string _(while ignoring empty values)_
+*
+* _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+* @param array Array of values
 * @param delimiter Delimiter to use between values
 * @returns Joined string
 */
-function join(value, delimiter) {
-	return compact(value).map(getString).join(typeof delimiter === "string" ? delimiter : "");
+function join(array, delimiter) {
+	if (!Array.isArray(array)) return "";
+	const { length } = array;
+	if (length === 0) return "";
+	const values = [];
+	for (let index = 0; index < length; index += 1) {
+		const item = getString(array[index]);
+		if (item.trim().length > 0) values.push(item);
+	}
+	return values.join(typeof delimiter === "string" ? delimiter : "");
 }
 function tryCallback(value, callback) {
 	try {

package/dist/internal/value/equal.mjs

@@ -1,4 +1,4 @@
-import { isPlainObject, isPrimitive, isTypedArray } from "../is.mjs";
+import { isNonPlainObject, isPlainObject, isPrimitive, isTypedArray } from "../is.mjs";
 import { getCompareHandlers } from "./handlers.mjs";
 //#region src/internal/value/equal.ts
 /**
@@ -131,7 +131,7 @@ function getEqualOptions(input) {
 		options.ignoreCase = input;
 		return options;
 	}
-	if (!isPlainObject(input)) return options;
+	if (isNonPlainObject(input)) return options;
 	options.ignoreCase = typeof input.ignoreCase === "boolean" ? input.ignoreCase : false;
 	options.ignoreExpressions.values = (Array.isArray(input.ignoreKeys) ? input.ignoreKeys : [input.ignoreKeys]).filter((key) => key instanceof RegExp);
 	options.ignoreKeys.values = new Set((Array.isArray(input.ignoreKeys) ? input.ignoreKeys : [input.ignoreKeys]).filter((key) => typeof key === "string"));

package/dist/internal/value/handlers.mjs

@@ -1,4 +1,4 @@
-import { isConstructor } from "../is.mjs";
+import { isNonConstructor } from "../is.mjs";
 //#region src/internal/value/handlers.ts
 function getCompareHandlers(owner, options) {
 	const handlers = getHandlers(owner, options);
@@ -26,7 +26,7 @@ function getHandlers(owner, options) {
 			if (isConstructable(first) && isConstructable(second) && first.constructor === second.constructor) return handlers.get(first.constructor);
 		},
 		register(constructor, handler) {
-			if (!isConstructor(constructor) || handler === owner) return;
+			if (isNonConstructor(constructor) || handler === owner) return;
 			let actual = handler ?? options.method;
 			if (typeof actual !== "function" && typeof actual !== "string") return;
 			if (typeof actual === "string") actual = typeof constructor.prototype[actual] === "function" ? actual : void 0;