@oscarpalmer/atoms 0.180.0 → 0.182.0

package/dist/array/find.d.mts

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

package/dist/array/find.mjs

@@ -3,5 +3,9 @@ import { FIND_VALUE_ITEM, findValue } from "../internal/array/find.mjs";
 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
-export { find };
+export { find, findLast };

package/dist/array/get.mjs

@@ -1,9 +1,9 @@
-import { isPlainObject } from "../internal/is.mjs";
+import { isNonPlainObject } from "../internal/is.mjs";
 //#region src/array/get.ts
 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;

package/dist/array/index.d.mts

@@ -1,12 +1,12 @@
 import { difference } from "./difference.mjs";
 import { exists } from "./exists.mjs";
-import { find } from "./find.mjs";
+import { find, findLast } from "./find.mjs";
 import { flatten } from "./flatten.mjs";
 import { range, times } from "./from.mjs";
 import { getArray } from "./get.mjs";
 import { chunk } from "../internal/array/chunk.mjs";
 import { compact } from "../internal/array/compact.mjs";
-import { indexOf } from "../internal/array/index-of.mjs";
+import { indexOf, lastIndexOf } from "../internal/array/index-of.mjs";
 import { shuffle } from "../internal/array/shuffle.mjs";
 import { insert } from "./insert.mjs";
 import { intersection } from "./intersection.mjs";
@@ -23,4 +23,4 @@ import { toggle } from "./toggle.mjs";
 import { union } from "./union.mjs";
 import { unique } from "./unique.mjs";
 import { update } from "./update.mjs";
-export { ArrayPosition, chunk, compact, difference, drop, endsWithArray, exists, find, flatten, getArray, getArrayPosition, includesArray, indexOf, indexOfArray, insert, intersection, partition, push, range, reverse, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };
+export { ArrayPosition, chunk, compact, difference, drop, endsWithArray, exists, find, findLast, flatten, getArray, getArrayPosition, includesArray, indexOf, indexOfArray, insert, intersection, lastIndexOf, partition, push, range, reverse, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };

package/dist/array/index.mjs

@@ -1,10 +1,10 @@
 import { chunk } from "../internal/array/chunk.mjs";
 import { compact } from "../internal/array/compact.mjs";
-import { indexOf } from "../internal/array/index-of.mjs";
+import { indexOf, lastIndexOf } from "../internal/array/index-of.mjs";
 import { shuffle } from "../internal/array/shuffle.mjs";
 import { difference } from "./difference.mjs";
 import { exists } from "./exists.mjs";
-import { find } from "./find.mjs";
+import { find, findLast } from "./find.mjs";
 import { flatten } from "./flatten.mjs";
 import { range, times } from "./from.mjs";
 import { getArray } from "./get.mjs";
@@ -23,4 +23,4 @@ import { toggle } from "./toggle.mjs";
 import { union } from "./union.mjs";
 import { unique } from "./unique.mjs";
 import { update } from "./update.mjs";
-export { chunk, compact, difference, drop, endsWithArray, exists, find, flatten, getArray, getArrayPosition, includesArray, indexOf, indexOfArray, insert, intersection, partition, push, range, reverse, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };
+export { chunk, compact, difference, drop, endsWithArray, exists, find, findLast, flatten, getArray, getArrayPosition, includesArray, indexOf, indexOfArray, insert, intersection, lastIndexOf, partition, push, range, reverse, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };

package/dist/index.d.mts

@@ -49,7 +49,7 @@ type GenericCallback = (...args: any[]) => any;
 /**
  * A generic key type
  */
-type Key = number | string;
+type Key$1 = number | string;
 type KeyedValue<Item, ItemKey extends keyof Item> = Item[ItemKey] extends PropertyKey ? Item[ItemKey] : never;
 /**
  * A nested array
@@ -303,7 +303,7 @@ declare function firstOrDefault<Item>(array: Item[], defaultValue: Item): Item;
  * @param value Callback to get an item's value
  * @returns Record of keyed values
  */
-declare function groupBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Simplify<Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>>>;
+declare function groupBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Simplify<Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>>>;
 /**
  * Create a record from an array of items using a specific key and value
  *
@@ -313,7 +313,7 @@ declare function groupBy<Item, KeyCallback extends (item: Item, index: number, a
  * @param value Key to use for value
  * @returns Record of keyed values
  */
-declare function groupBy<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Record<ReturnType<KeyCallback>, Item[ItemValue]>;
+declare function groupBy<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Record<ReturnType<KeyCallback>, Item[ItemValue]>;
 /**
  * Create a record from an array of items using a specific key and value
  *
@@ -342,7 +342,7 @@ declare function groupBy<Item extends PlainObject, ItemKey extends keyof Item, I
  * @param callback Callback to get an item's grouping key
  * @returns Record of keyed items
  */
-declare function groupBy<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item>;
+declare function groupBy<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item>;
 /**
  * Create a record from an array of items using a specific key
  *
@@ -370,7 +370,7 @@ declare namespace groupBy {
  * @param value Callback to get an item's value
  * @returns Record of keyed values
  */
-declare function groupArraysBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+declare function groupArraysBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
 /**
  * Create a record from an array of items using a specific key and value, grouping values into arrays
  *
@@ -380,7 +380,7 @@ declare function groupArraysBy<Item, KeyCallback extends (item: Item, index: num
  * @param value Key to use for value
  * @returns Record of keyed values
  */
-declare function groupArraysBy<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Record<ReturnType<KeyCallback>, Item[ItemValue][]>;
+declare function groupArraysBy<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Record<ReturnType<KeyCallback>, Item[ItemValue][]>;
 /**
  * Create a record from an array of items using a specific key and value, grouping values into arrays
  *
@@ -409,7 +409,7 @@ declare function groupArraysBy<Item extends PlainObject, ItemKey extends keyof I
  * @param callback Callback to get an item's grouping key
  * @returns Record of keyed items
  */
-declare function groupArraysBy<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item[]>;
+declare function groupArraysBy<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item[]>;
 /**
  * Create a record from an array of items using a specific key, grouping items into arrays
  *
@@ -475,6 +475,47 @@ 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
 //#region src/internal/array/shuffle.d.ts
 /**
@@ -572,6 +613,47 @@ declare function find<Item>(array: Item[], filter: (item: Item, index: number, a
  * @returns First item that matches the value, or `undefined` if no match is found
  */
 declare function find<Item>(array: Item[], value: Item): Item | undefined;
+declare namespace find {
+  var last: typeof findLast;
+}
+/**
+ * Get the last item matching the given value
+ *
+ * Available as `findLast` and `find.last`
+ * @param array Array to search in
+ * @param callback Callback to get an item's value for matching
+ * @param value Value to match against
+ * @returns Last item that matches the value, or `undefined` if no match is found
+ */
+declare function findLast<Item, Callback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], callback: Callback, value: ReturnType<Callback>): Item | undefined;
+/**
+ * Get the last item matching the given value by key
+ *
+ * Available as `findLast` and `find.last`
+ * @param array Array to search in
+ * @param key Key to get an item's value for matching
+ * @param value Value to match against
+ * @returns Last item that matches the value, or `undefined` if no match is found
+ */
+declare function findLast<Item extends PlainObject, ItemKey extends keyof Item>(array: Item[], key: ItemKey, value: Item[ItemKey]): Item | undefined;
+/**
+ * Get the last item matching the filter
+ *
+ * Available as `findLast` and `find.last`
+ * @param array Array to search in
+ * @param filter Filter callback to match items
+ * @returns Last item that matches the filter, or `undefined` if no match is found
+ */
+declare function findLast<Item>(array: Item[], filter: (item: Item, index: number, array: Item[]) => boolean): Item | undefined;
+/**
+ * Get the last item matching the given value
+ *
+ * Available as `findLast` and `find.last`
+ * @param array Array to search in
+ * @param value Value to match against
+ * @returns Last item that matches the value, or `undefined` if no match is found
+ */
+declare function findLast<Item>(array: Item[], value: Item): Item | undefined;
 //#endregion
 //#region src/array/flatten.d.ts
 /**
@@ -1685,7 +1767,7 @@ declare function swapIndices<Item>(array: Item[], first: number, second: number)
  * @param value Callback to get an item's value
  * @returns Map of keyed values
  */
-declare function toMap<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, ReturnType<ValueCallback>>;
+declare function toMap<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, ReturnType<ValueCallback>>;
 /**
  * Create a Map from an array of items using a callback and value
  *
@@ -1695,7 +1777,7 @@ declare function toMap<Item, KeyCallback extends (item: Item, index: number, arr
  * @param value Key to use for value
  * @returns Map of keyed values
  */
-declare function toMap<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Map<ReturnType<KeyCallback>, Item[ItemValue]>;
+declare function toMap<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Map<ReturnType<KeyCallback>, Item[ItemValue]>;
 /**
  * Create a Map from an array of items using a key and callback
  *
@@ -1724,7 +1806,7 @@ declare function toMap<Item extends PlainObject, ItemKey extends keyof Item, Ite
  * @param callback Callback to get an item's grouping key
  * @returns Map of keyed items
  */
-declare function toMap<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Map<ReturnType<Callback>, Item>;
+declare function toMap<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Map<ReturnType<Callback>, Item>;
 /**
  * Create a Map from an array of items using a key
  *
@@ -1752,7 +1834,7 @@ declare namespace toMap {
  * @param value Callback to get an item's value
  * @returns Map of keyed arrays of values
  */
-declare function toMapArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+declare function toMapArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
 /**
  * Create a Map from an array of items using a callback and value, grouping values into arrays
  *
@@ -1762,7 +1844,7 @@ declare function toMapArrays<Item, KeyCallback extends (item: Item, index: numbe
  * @param value Key to use for value
  * @returns Map of keyed arrays of values
  */
-declare function toMapArrays<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Map<ReturnType<KeyCallback>, Item[ItemValue][]>;
+declare function toMapArrays<Item extends PlainObject, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], key: KeyCallback, value: ItemValue): Map<ReturnType<KeyCallback>, Item[ItemValue][]>;
 /**
  * Create a Map from an array of items using a key and callback, grouping values into arrays
  *
@@ -1791,7 +1873,7 @@ declare function toMapArrays<Item extends PlainObject, ItemKey extends keyof Ite
  * @param callback Callback to get an item's grouping key
  * @returns Map of keyed arrays of items
  */
-declare function toMapArrays<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Map<ReturnType<Callback>, Item[]>;
+declare function toMapArrays<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Map<ReturnType<Callback>, Item[]>;
 /**
  * Create a Map from an array of items using a key, grouping items into arrays
  *
@@ -1812,7 +1894,7 @@ declare function toMapArrays<Item extends PlainObject, ItemKey extends keyof Ite
  * @param value Callback to get an item's value
  * @returns Record of keyed values
  */
-declare function toRecord<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>>;
+declare function toRecord<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>>;
 /**
  * Create a record from an array of items using a callback and value
  *
@@ -1822,7 +1904,7 @@ declare function toRecord<Item, KeyCallback extends (item: Item, index: number,
  * @param value Key to use for value
  * @returns Record with keys
  */
-declare function toRecord<Item extends PlainObject, Callback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], callback: Callback, value: ItemValue): Record<ReturnType<Callback>, Item[ItemValue]>;
+declare function toRecord<Item extends PlainObject, Callback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], callback: Callback, value: ItemValue): Record<ReturnType<Callback>, Item[ItemValue]>;
 /**
  * Create a record from an array of items using a key and callback
  *
@@ -1851,7 +1933,7 @@ declare function toRecord<Item extends PlainObject, ItemKey extends keyof Item,
  * @param callback Callback to get an item's grouping key
  * @returns Record of keyed values
  */
-declare function toRecord<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item>;
+declare function toRecord<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item>;
 /**
  * Create a record from an array of items using a key
  *
@@ -1879,7 +1961,7 @@ declare namespace toRecord {
  * @param value Callback to get an item's value
  * @returns Record of keyed arrays of values
  */
-declare function toRecordArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+declare function toRecordArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
 /**
  * Create a record from an array of items using a callback and value, grouping values into arrays
  *
@@ -1889,7 +1971,7 @@ declare function toRecordArrays<Item, KeyCallback extends (item: Item, index: nu
  * @param value Key to use for value
  * @returns Record of keyed arrays of values
  */
-declare function toRecordArrays<Item extends PlainObject, Callback extends (item: Item, index: number, array: Item[]) => Key, ItemValue extends keyof Item>(array: Item[], callback: Callback, value: ItemValue): Record<ReturnType<Callback>, Item[ItemValue][]>;
+declare function toRecordArrays<Item extends PlainObject, Callback extends (item: Item, index: number, array: Item[]) => Key$1, ItemValue extends keyof Item>(array: Item[], callback: Callback, value: ItemValue): Record<ReturnType<Callback>, Item[ItemValue][]>;
 /**
  * Create a record from an array of items using a key and callback, grouping values into arrays
  *
@@ -1918,7 +2000,7 @@ declare function toRecordArrays<Item extends PlainObject, ItemKey extends keyof
  * @param callback Callback to get an item's grouping key
  * @returns Record of keyed arrays of items
  */
-declare function toRecordArrays<Item, Callback extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item[]>;
+declare function toRecordArrays<Item, Callback extends (item: Item, index: number, array: Item[]) => Key$1>(array: Item[], callback: Callback): Record<ReturnType<Callback>, Item[]>;
 /**
  * Create a record from an array of items using a key, grouping items into arrays
  *
@@ -2564,12 +2646,14 @@ declare namespace pipe {
 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;
 /**
@@ -2792,6 +2876,64 @@ declare function setValue<Data extends PlainObject, Path extends NestedKeys<Data
  */
 declare function setValue<Data extends PlainObject>(data: Data, path: string, value: unknown, ignoreCase?: boolean): Data;
 //#endregion
+//#region src/kalas.d.ts
+declare class Events<Map extends Record<string, GenericCallback>> {
+  #private;
+  constructor(kalas: Kalas<Map>);
+  /**
+   * Subscribe to an event with a callback
+   * @param event Event name
+   * @param callback Callback function
+   * @returns Unsubscriber function
+   */
+  subscribe<Event extends keyof Map>(event: Event, callback: Map[Event]): Unsubscriber;
+  /**
+   * 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 extends keyof Map>(event: Event, callback?: Map[Event]): void;
+}
+declare class Kalas<Map extends Record<string, GenericCallback>> {
+  #private;
+  /**
+   * Events interface for subscribing and unsubscribing to events
+   */
+  readonly events: Events<Map>;
+  constructor(names: (keyof Map)[]);
+  /**
+   * Remove all event subscribers
+   */
+  clear(): void;
+  /**
+   * Emit an event with parameters
+   * @param event Event name
+   * @param parameters Event parameters
+   */
+  emit<Event extends keyof Map>(event: Event, ...parameters: Parameters<Map[Event]>): void;
+  /**
+   * Subscribe to an event with a callback
+   * @param event Event name
+   * @param callback Callback function
+   * @returns Unsubscriber function
+   */
+  subscribe<Event extends keyof Map>(event: Event, callback: Map[Event]): Unsubscriber;
+  /**
+   * 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 extends keyof Map>(event: Event, callback?: Map[Event]): void;
+}
+type Unsubscriber = () => void;
+/**
+ * Create a Kalas _(party)_ for named events
+ * @param names Event names
+ * @returns Kalas instance
+ */
+declare function kalas<Events extends Record<string, GenericCallback>>(names: (keyof Events)[]): Kalas<Events>;
+//#endregion
 //#region src/string/case.d.ts
 /**
  * Convert a string to camel case _(thisIsCamelCase)_
@@ -3015,6 +3157,60 @@ declare function includes(haystack: string, needle: string, ignoreCase?: boolean
  */
 declare function startsWith(haystack: string, needle: string, ignoreCase?: boolean): boolean;
 //#endregion
+//#region src/string/normalize.d.ts
+/**
+ * Options for normalizing a string
+ */
+type NormalizeOptions = {
+  /**
+   * Remove diacritical marks from the string? _(defaults to `true`)_
+   */
+  deburr?: boolean;
+  /**
+   * Convert the string to lower case? _(defaults to `true`)_
+   */
+  lowerCase?: boolean;
+  /**
+   * Trim the string? _(defaults to `true`)_
+   */
+  trim?: boolean;
+};
+/**
+ * String normalizer function
+ */
+type Normalizer = {
+  /**
+   * Normalize a string
+   * @param value String to normalize
+   * @returns Normalized string
+   */
+  (value: string): string;
+};
+/**
+ * Deburr a string, removing diacritical marks
+ * @param value String to deburr
+ * @returns Deburred string
+ */
+declare function deburr(value: string): string;
+/**
+ * Initialize a string normalizer
+ * @param options Normalization options
+ * @returns Normalizer function
+ */
+declare function initializeNormalizer(options?: NormalizeOptions): Normalizer;
+/**
+ * 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
+ */
+declare function normalize(value: string, options?: NormalizeOptions): string;
+declare namespace normalize {
+  var initialize: typeof initializeNormalizer;
+}
+//#endregion
 //#region src/string/template.d.ts
 /**
  * Options for templating strings
@@ -3182,6 +3378,10 @@ declare function omit<Value extends PlainObject, ValueKey extends keyof Value>(v
  */
 declare function pick<Value extends PlainObject, ValueKey extends keyof Value>(value: Value, keys: ValueKey[]): Pick<Value, ValueKey>;
 //#endregion
+//#region src/value/shake.d.ts
+type Shaken<Value extends PlainObject> = { [Key in keyof Value]: Value[Key] extends undefined ? never : Value[Key] };
+declare function shake<Value extends PlainObject>(value: Value): Shaken<Value>;
+//#endregion
 //#region src/value/smush.d.ts
 type Smushed<Value extends PlainObject> = Simplify<{ [NestedKey in NestedKeys<Value>]: NestedValue<Value, ToString<NestedKey>> }>;
 /**
@@ -3213,16 +3413,29 @@ declare function unsmush<Value extends PlainObject>(value: Value): Unsmushed<Val
  * Options for merging values
  */
 type MergeOptions = {
+  /**
+   * Assign values to the first array or object instead of creating a new one?
+   */
+  assignValues?: boolean;
   /**
    * Key _(or key epxressions)_ for values that should be replaced
+   *
    * ```ts
    * merge([{items: [1, 2, 3]}, {items: [99]}]); // {items: [99]}
    * ```
    */
   replaceableObjects?: string | RegExp | Array<string | RegExp>;
+  /**
+   * Skip nullable values when merging objects?
+   *
+   * ```ts
+   * merge({a: 1, b: 2}, {b: null, c: 3}, {d: null}); // {a: 1, b: 2, c: 3}
+   * ```
+   */
   skipNullableAny?: boolean;
   /**
    * Skip nullable values when merging arrays?
+   *
    * ```ts
    * merge([1, 2, 3], [null, null, 99]); // [1, 2, 99]
    * ```
@@ -3645,7 +3858,7 @@ declare function isInstanceOf<Instance>(constructor: Constructor<Instance>, valu
  * @param value Value to check
  * @returns `true` if the value is a `Key` _(`number` or `string`)_, otherwise `false`
  */
-declare function isKey(value: unknown): value is Key;
+declare function isKey(value: unknown): value is Key$1;
 /**
  * Is the value not an array or a plain object?
  * @param value Value to check
@@ -3670,7 +3883,7 @@ declare function isNonInstanceOf<Instance, Value>(constructor: Constructor<Insta
  * @param value Value to check
  * @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
  */
-declare function isNonKey<Value>(value: Value): value is Exclude<Value, Key>;
+declare function isNonKey<Value>(value: Value): value is Exclude<Value, Key$1>;
 /**
  * Is the value not a number?
  * @param value Value to check
@@ -5106,4 +5319,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, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, 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, 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 { 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, type Events, ExtendedErr, ExtendedResult, Flow, FlowPromise, FulfilledPromise, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, type Kalas, Key$1 as Key, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NormalizeOptions, Normalizer, 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, Shaken, Simplify, SizedMap, SizedSet, Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Time, ToString, TypedArray, Unsmushed, Unsubscriber, UnwrapValue, 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 };