@oscarpalmer/atoms 0.212.0 → 0.214.0

package/dist/random.mjs

@@ -1,6 +1,7 @@
 import { getRandomFloatingNumber, getRandomInteger } from "./internal/random.mjs";
 import { shuffle } from "./internal/array/shuffle.mjs";
 import { join } from "./internal/string/misc.mjs";
+import { RANDOM_ALPHABET, RANDOM_BOOLEAN_MODIFIER, RANDOM_HEX_CHARACTERS } from "./models/random.model.mjs";
 //#region src/random.ts
 /**
 * Get a random boolean
@@ -39,7 +40,7 @@ function getRandomColor(prefix) {
 * @returns Random hexadecimal character from `0-9` and `A-F`
 */
 function getRandomHex() {
-	return RANDOM_HEX_CHARACTERS[getRandomInteger(0, RANDOM_HEX_MAXIMUM)];
+	return RANDOM_HEX_CHARACTERS[getRandomInteger(0, 15)];
 }
 /**
 * Get a random item from an array
@@ -57,9 +58,5 @@ function getRandomItems(array, amount) {
 	if (amount === 1) return [array[getRandomInteger(0, array.length - 1)]];
 	return typeof amount !== "number" || amount <= 0 || amount >= array.length ? shuffle(array) : shuffle(array).slice(0, amount);
 }
-const RANDOM_ALPHABET = "abcdefghijklmnopqrstuvwxyz";
-const RANDOM_BOOLEAN_MODIFIER = .5;
-const RANDOM_HEX_CHARACTERS = "0123456789ABCDEF";
-const RANDOM_HEX_MAXIMUM = 15;
 //#endregion
 export { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems };

package/dist/result/match.d.mts

@@ -1,4 +1,4 @@
-import { AnyResult, ResultMatch } from "../internal/models/result.model.mjs";
+import { AnyResult, ResultMatch } from "../models/result.model.mjs";
 //#region src/result/match.d.ts
 /**
  * Handles a _Result_ with match callbacks

package/dist/result/match.mjs

@@ -1,27 +1,39 @@
+import { isPlainObject } from "../internal/is.mjs";
 import { isOk, isResult } from "../internal/result/misc.mjs";
 //#region src/result/match.ts
-async function asyncMatchResult(result, first, error) {
+async function asyncMatchResult(result, first, second) {
 	let value;
 	if (typeof result === "function") value = await result();
 	else if (result instanceof Promise) value = await result;
 	else value = result;
-	if (!isResult(value)) throw new Error(MATCH_MESSAGE);
-	const hasObj = typeof first === "object" && first !== null;
-	const okHandler = hasObj ? first.ok : first;
-	const errorHandler = hasObj ? first.error : error;
-	if (isOk(value)) return okHandler(value.value);
-	return errorHandler(value.error, value.original);
+	if (!isResult(value)) throw new Error(MATCH_MESSAGE_RESULT);
+	return handleResult(value, first, second);
 }
-function matchResult(result, first, error) {
+function handleResult(result, first, second) {
+	let error;
+	let ok;
+	if (isPlainObject(first)) {
+		ok = first.ok;
+		error = first.error;
+	} else {
+		ok = first;
+		error = second;
+	}
+	if (isOk(result)) {
+		if (typeof ok !== "function") throw new Error(MATCH_MESSAGE_OK);
+		return ok(result.value);
+	}
+	if (typeof error !== "function") throw new Error(MATCH_MESSAGE_ERROR);
+	return error(result.error, result.original);
+}
+function matchResult(result, first, second) {
 	const value = typeof result === "function" ? result() : result;
-	if (!isResult(value)) throw new Error(MATCH_MESSAGE);
-	const hasObj = typeof first === "object" && first !== null;
-	const okHandler = hasObj ? first.ok : first;
-	const errorHandler = hasObj ? first.error : error;
-	if (isOk(value)) return okHandler(value.value);
-	return errorHandler(value.error, value.original);
+	if (!isResult(value)) throw new Error(MATCH_MESSAGE_RESULT);
+	return handleResult(value, first, second);
 }
-const MATCH_MESSAGE = "`result.match` expected a Result or a function that returns a Result";
+const MATCH_MESSAGE_ERROR = "`result.match` expected an Error callback";
+const MATCH_MESSAGE_OK = "`result.match` expected an Ok callback";
+const MATCH_MESSAGE_RESULT = "`result.match` expected a Result or a function that returns a Result";
 matchResult.async = asyncMatchResult;
 //#endregion
 export { asyncMatchResult, matchResult };

package/dist/result/misc.d.mts

@@ -1,4 +1,4 @@
-import { AnyResult } from "../internal/models/result.model.mjs";
+import { AnyResult } from "../models/result.model.mjs";
 import { error, isError, isOk, isResult, ok, unwrap } from "../internal/result/misc.mjs";
 //#region src/result/misc.d.ts
 /**

package/dist/result/work/flow.d.mts

@@ -1,14 +1,6 @@
-import { GenericCallback } from "../../models.mjs";
-import { Result, UnwrapValue } from "../../internal/models/result.model.mjs";
+import { GenericCallback } from "../../models/index.mjs";
+import { AttemptAsyncFlow, AttemptFlow, Result, UnwrapValue } from "../../models/result.model.mjs";
 //#region src/result/work/flow.d.ts
-/**
- * A synchronous _Flow_, a function that attempts to pipe values through a series of functions
- */
-export type AttemptFlow<Callback extends GenericCallback, Value> = (...args: Parameters<Callback>) => Result<UnwrapValue<Value>>;
-/**
- * An asynchronous _Flow_, a function that attempts to pipe values through a series of functions
- */
-export type AttemptFlowPromise<Callback extends GenericCallback, Value> = (...args: Parameters<Callback>) => Promise<Result<UnwrapValue<Value>>>;
 /**
  * Create an asynchronous _Flow_, a function that attempts to pipe a value through a series of functions
  *
@@ -16,7 +8,7 @@ export type AttemptFlowPromise<Callback extends GenericCallback, Value> = (...ar
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<Fn extends GenericCallback>(fn: Fn): AttemptFlowPromise<Fn, ReturnType<Fn>>;
+export declare function attemptAsyncFlow<Fn extends GenericCallback>(fn: Fn): AttemptAsyncFlow<Fn, ReturnType<Fn>>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -24,7 +16,7 @@ export declare function attemptAsyncFlow<Fn extends GenericCallback>(fn: Fn): At
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second): AttemptFlowPromise<First, Second>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second): AttemptAsyncFlow<First, Second>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -32,7 +24,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second>(
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third): AttemptFlowPromise<First, Third>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third): AttemptAsyncFlow<First, Third>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -40,7 +32,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth): AttemptFlowPromise<First, Fourth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth): AttemptAsyncFlow<First, Fourth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -48,7 +40,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth): AttemptFlowPromise<First, Fifth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth): AttemptAsyncFlow<First, Fifth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -56,7 +48,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth): AttemptFlowPromise<First, Sixth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth): AttemptAsyncFlow<First, Sixth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -64,7 +56,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh): AttemptFlowPromise<First, Seventh>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh): AttemptAsyncFlow<First, Seventh>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -72,7 +64,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth): AttemptFlowPromise<First, Eighth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth): AttemptAsyncFlow<First, Eighth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -80,7 +72,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth, Ninth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth, ninth: (value: Awaited<UnwrapValue<Eighth>>) => Ninth): AttemptFlowPromise<First, Ninth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth, Ninth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth, ninth: (value: Awaited<UnwrapValue<Eighth>>) => Ninth): AttemptAsyncFlow<First, Ninth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -88,7 +80,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth, Ninth, Tenth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth, ninth: (value: Awaited<UnwrapValue<Eighth>>) => Ninth, tenth: (value: Awaited<UnwrapValue<Ninth>>) => Tenth): AttemptFlowPromise<First, Tenth>;
+export declare function attemptAsyncFlow<First extends GenericCallback, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth, Ninth, Tenth>(first: First, second: (value: Awaited<UnwrapValue<ReturnType<First>>>) => Second, third: (value: Awaited<UnwrapValue<Second>>) => Third, fourth: (value: Awaited<UnwrapValue<Third>>) => Fourth, fifth: (value: Awaited<UnwrapValue<Fourth>>) => Fifth, sixth: (value: Awaited<UnwrapValue<Fifth>>) => Sixth, seventh: (value: Awaited<UnwrapValue<Sixth>>) => Seventh, eighth: (value: Awaited<UnwrapValue<Seventh>>) => Eighth, ninth: (value: Awaited<UnwrapValue<Eighth>>) => Ninth, tenth: (value: Awaited<UnwrapValue<Ninth>>) => Tenth): AttemptAsyncFlow<First, Tenth>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *
@@ -96,7 +88,7 @@ export declare function attemptAsyncFlow<First extends GenericCallback, Second,
  *
  * @returns _Flow_ function
  */
-export declare function attemptAsyncFlow<Fn extends GenericCallback>(fn: Fn, ...fns: Array<(value: Awaited<UnwrapValue<ReturnType<Fn>>>) => unknown>): AttemptFlowPromise<Fn, ReturnType<Fn>>;
+export declare function attemptAsyncFlow<Fn extends GenericCallback>(fn: Fn, ...fns: Array<(value: Awaited<UnwrapValue<ReturnType<Fn>>>) => unknown>): AttemptAsyncFlow<Fn, ReturnType<Fn>>;
 /**
  * Create an asynchronous _Flow_, a function that pipes values through a series of functions
  *

package/dist/result/work/flow.mjs

@@ -1,7 +1,6 @@
 import { isError, isOk } from "../../internal/result/misc.mjs";
 import { asyncAttempt, attempt } from "../../internal/result/attempt.mjs";
 import { asyncFlow, flow } from "../../internal/function/work.mjs";
-import "../index.mjs";
 //#region src/result/work/flow.ts
 function attemptAsyncFlow(...fns) {
 	let Flow;

package/dist/result/work/pipe.d.mts

@@ -1,5 +1,5 @@
-import { GenericCallback } from "../../models.mjs";
-import { Result, UnwrapValue } from "../../internal/models/result.model.mjs";
+import { GenericCallback } from "../../models/index.mjs";
+import { Result, UnwrapValue } from "../../models/result.model.mjs";
 //#region src/result/work/pipe.d.ts
 type WrapValue<Value> = Result<UnwrapValue<Value>>;
 /**

package/dist/result/work/pipe.mjs

@@ -1,7 +1,6 @@
 import { isError, isOk } from "../../internal/result/misc.mjs";
 import { asyncAttempt, attempt } from "../../internal/result/attempt.mjs";
 import { asyncPipe, pipe } from "../../internal/function/work.mjs";
-import "../index.mjs";
 //#region src/result/work/pipe.ts
 async function attemptAsyncPipe(initial, first, ...seconds) {
 	return asyncAttempt(() => {

package/dist/string/fuzzy.d.mts

@@ -1,90 +1,7 @@
-import { PlainObject } from "../models.mjs";
+import { PlainObject } from "../models/index.mjs";
+import { Fuzzy, FuzzyConfiguration, FuzzyItem, FuzzyOptions, FuzzyResult, FuzzyState } from "../models/string/string.fuzzy.model.mjs";
 //#region src/string/fuzzy.d.ts
-/**
- * Fuzzy searcher for an array of items
- */
-export type Fuzzy<Item> = {
-  /**
-   * Get items currently being searched through
-   *
-   * @returns Original items
-   */
-  get items(): Item[];
-  /**
-   * Set new items to search through
-   *
-   * @param items New items to search through
-   */
-  set items(items: Item[]);
-  /**
-   * Get strings currently being searched through _(the stringified version of `items`)_
-   *
-   * @returns Stringified items
-   */
-  get strings(): string[];
-  /**
-   * Search for items matching the given value
-   *
-   * @param value Value to search for
-   * @param options Search options
-   * @returns Search results, with exact matches _(ordered)_ and similar matches _(ordered by relevance)_
-   */
-  search(value: string, options?: FuzzyOptions): FuzzyResult<Item>;
-  /**
-   * Search for items matching the given value
-   *
-   * @param value Value to search for
-   * @param limit Maximum number of combined items to return in `exact` and `similar`
-   * @returns Search results, with exact matches _(ordered)_ and similar matches _(ordered by relevance)_
-   */
-  search(value: string, limit: number): FuzzyResult<Item>;
-};
-export type FuzzyConfiguration<Item> = {
-  /**
-   * Handler to stringify items
-   *
-   * - May be a function that takes an item and returns a string, or if items are plain objects, a key of the item to use to grab a string value from
-   * - Defaults to `getString`
-   */
-  handler?: (item: Item) => string;
-} & (Item extends PlainObject ? {
-  /**
-   * Key to use to stringify items
-   *
-   * _Prioritized over `handler`_
-   */
-  key?: keyof Item;
-} : {}) & FuzzyOptions;
-export type FuzzyOptions = {
-  /**
-   * Maximum number of combined items to return in `exact` and `similar` _(defaults to all matches)_
-   */
-  limit?: number;
-  /**
-   * Maximum score difference between the best and worst similar matches included in results
-   *
-   * - Higher values cast a wider net
-   * - Defaults to `5`
-   */
-  tolerance?: number;
-};
-/**
- * Search results from a fuzzy search, with exact and similar matches
- */
-export type FuzzyResult<Item> = {
-  /**
-   * Ordered items that exactly match the search value
-   */
-  exact: Item[];
-  /**
-   * Ordered items that are similar to the search value, ranked by relevance
-   */
-  similar: Item[];
-};
-/**
- * Options for fuzzy searching
- */
-export type FuzzySearchOptions = FuzzyOptions;
+declare function Fuzzy(this: any, state: FuzzyState<unknown>): void;
 /**
  * Create a fuzzy searcher for an array of items
  *
@@ -132,4 +49,5 @@ export declare namespace fuzzy {
   export var is: typeof isFuzzy;
   export var match: typeof fuzzyMatch;
 }
-//#endregion
+//#endregion
+export type { Fuzzy, FuzzyItem, FuzzyOptions, FuzzyResult };

package/dist/string/fuzzy.mjs

@@ -3,10 +3,9 @@ import { floor } from "../internal/math/misc.mjs";
 import { max } from "../internal/math/aggregate.mjs";
 import { getString } from "../internal/string/misc.mjs";
 import { lowerCase } from "../internal/string/case.mjs";
+import { FUZZY_MESSAGE_ARRAY, FUZZY_MESSAGE_HANDLER, FUZZY_PROPERTY, FUZZY_SYMBOL } from "../models/string/string.fuzzy.model.mjs";
 import { includes } from "./match.mjs";
 //#region src/string/fuzzy.ts
-const FUZZY_PROPERTY = "$fuzzy";
-const FUZZY_SYMBOL = Symbol(FUZZY_PROPERTY);
 function Fuzzy(state) {
 	this[FUZZY_SYMBOL] = state;
 }
@@ -94,19 +93,19 @@ function getScore(haystack, needle) {
 			if (haystackIndex === 0) score += 1;
 			if (previousMatchIndex !== -1) {
 				const gap = haystackIndex - previousMatchIndex - 1;
-				score += max([0, FUZZY_PROXIMITY_THRESHOLD - gap]);
+				score += max([0, 5 - gap]);
 			}
 			previousMatchIndex = haystackIndex;
 			needleIndex += 1;
 		}
 		if (needleIndex === needleLength) break;
 	}
-	score -= floor(lowerCaseHaystack.length / FUZZY_LENGTH_DIVISOR);
+	score -= floor(lowerCaseHaystack.length / 3);
 	return max([0, score]);
 }
 function getTolerance(input, state) {
 	if (typeof input === "number" && !Number.isNaN(input)) return input < 0 ? 0 : floor(input);
-	return state?.tolerance ?? FUZZY_PROXIMITY_THRESHOLD;
+	return state?.tolerance ?? 5;
 }
 /**
 * Is the value a fuzzy searcher?
@@ -117,7 +116,7 @@ function getTolerance(input, state) {
 * @returns `true` if the value is a fuzzy searcher, otherwise `false`
 */
 function isFuzzy(value) {
-	return typeof value === "object" && value !== null && FUZZY_PROPERTY in value && value[FUZZY_PROPERTY] === true;
+	return typeof value === "object" && value !== null && "$fuzzy" in value && value["$fuzzy"] === true;
 }
 function isSubsequence(haystack, needle) {
 	const lowerCaseHaystack = lowerCase(haystack);
@@ -185,12 +184,8 @@ function setFuzzyItems(value) {
 	if (!Array.isArray(value)) throw new TypeError(FUZZY_MESSAGE_ARRAY);
 	const state = this[FUZZY_SYMBOL];
 	state.items = value.slice();
-	state.strings = value.map(state.handler);
+	state.strings = value.map((item) => state.handler(item));
 }
-const FUZZY_LENGTH_DIVISOR = 3;
-const FUZZY_MESSAGE_ARRAY = "Fuzzy requires an array of items";
-const FUZZY_MESSAGE_HANDLER = "Fuzzy requires a key or function to stringify items";
-const FUZZY_PROXIMITY_THRESHOLD = 5;
 fuzzy.is = isFuzzy;
 fuzzy.match = fuzzyMatch;
 //#endregion

package/dist/string/index.mjs

@@ -1,6 +1,8 @@
 import { isTemplateStringsArray } from "../internal/is.mjs";
 import { min } from "../internal/math/aggregate.mjs";
+import { STRING_EXPRESSION_WHITESPACE_PREFIX } from "../models/string/string.misc.model.mjs";
 import { getString, interpolate, join, words } from "../internal/string/misc.mjs";
+import { EXPRESSION_NUMERICAL_PREFIX } from "../models/misc.model.mjs";
 //#region src/string/index.ts
 function dedent(value, ...values) {
 	let actual;
@@ -13,7 +15,7 @@ function dedent(value, ...values) {
 	const lastIndex = length - 1;
 	const lengths = [];
 	for (let index = 0; index < length; index += 1) {
-		const [, indentation] = /^(\s+)/.exec(lines[index]) ?? [];
+		const [, indentation] = STRING_EXPRESSION_WHITESPACE_PREFIX.exec(lines[index]) ?? [];
 		if (indentation != null) lengths.push(indentation.length);
 	}
 	if (lengths.length === 0) return actual.trim();
@@ -38,16 +40,16 @@ function getUuid(html) {
 		crypto.getRandomValues(bytes);
 		bytes[6] = bytes[6] & 15 | 64;
 		bytes[8] = bytes[8] & 63 | 128;
-		const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, STRING_ZERO)).join("");
+		const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 		const first = hex.substring(0, 8);
-		if (forHTML && STRING_NUMERICAL_PREFIX_PATTERN.test(first)) continue;
+		if (forHTML && EXPRESSION_NUMERICAL_PREFIX.test(first)) continue;
 		return [
 			first,
 			hex.substring(8, 12),
 			hex.substring(12, 16),
 			hex.substring(16, 20),
 			hex.substring(20, 32)
-		].join(forHTML ? STRING_DELIMITER_UUID_HTML : STRING_DELIMITER_UUID_DEFAULT);
+		].join(forHTML ? "_" : "-");
 	}
 }
 /**
@@ -90,9 +92,5 @@ function truncate(value, length, suffix) {
 	const truncatedLength = length - actualSuffixLength;
 	return `${value.slice(0, truncatedLength)}${actualSuffix}`;
 }
-const STRING_DELIMITER_UUID_DEFAULT = "-";
-const STRING_DELIMITER_UUID_HTML = "_";
-const STRING_NUMERICAL_PREFIX_PATTERN = /^\d/;
-const STRING_ZERO = "0";
 //#endregion
 export { dedent, getString, getUuid, join, parse, trim, truncate, words };

package/dist/string/match.mjs

@@ -1,3 +1,4 @@
+import { STRING_MATCH_ENDS_WITH, STRING_MATCH_INCLUDES, STRING_MATCH_STARTS_WITH } from "../models/string/string.misc.model.mjs";
 import { memoize } from "../internal/function/memoize.mjs";
 //#region src/string/match.ts
 /**
@@ -9,7 +10,7 @@ import { memoize } from "../internal/function/memoize.mjs";
 * @returns `true` if the string ends with the given substring, otherwise `false`
 */
 function endsWith(haystack, needle, ignoreCase) {
-	return match(MATCH_ENDS_WITH, haystack, needle, ignoreCase === true);
+	return match(STRING_MATCH_ENDS_WITH, haystack, needle, ignoreCase === true);
 }
 /**
 * Check if a string includes a specified substring
@@ -20,7 +21,7 @@ function endsWith(haystack, needle, ignoreCase) {
 * @returns `true` if the string includes the given substring, otherwise `false`
 */
 function includes(haystack, needle, ignoreCase) {
-	return match(MATCH_INCLUDES, haystack, needle, ignoreCase === true);
+	return match(STRING_MATCH_INCLUDES, haystack, needle, ignoreCase === true);
 }
 function match(type, haystack, needle, ignoreCase) {
 	if (typeof haystack !== "string" || typeof needle !== "string") return false;
@@ -39,11 +40,8 @@ function matchCallback(haystack, needle, ignoreCase) {
 * @returns `true` if the string starts with the given substring, otherwise `false`
 */
 function startsWith(haystack, needle, ignoreCase) {
-	return match(MATCH_STARTS_WITH, haystack, needle, ignoreCase === true);
+	return match(STRING_MATCH_STARTS_WITH, haystack, needle, ignoreCase === true);
 }
-const MATCH_ENDS_WITH = "endsWith";
-const MATCH_INCLUDES = "includes";
-const MATCH_STARTS_WITH = "startsWith";
 const matchMemoizers = {};
 //#endregion
 export { endsWith, includes, startsWith };

package/dist/string/normalize.d.mts

@@ -1,43 +1,6 @@
+import { NormalizeOptions, Normalizer, NormalizerOptions } from "../models/string/string.normalize.model.mjs";
 //#region src/string/normalize.d.ts
-/**
- * Options for normalizing a string
- */
-export type NormalizeOptions = {
-  /**
-   * Remove diacritical marks from the string? _(defaults to `true`)_
-   */
-  deburr?: boolean;
-  /**
-   * Convert the string to lower case? _(defaults to `true`)_
-   */
-  lowerCase?: boolean;
-  /**
-   * Remove special characters from the string? _(defaults to `false`)_
-   *
-   * _(Punctuation and symbol characters are considered special)_
-   */
-  special?: boolean;
-  /**
-   * Trim the string? _(defaults to `true`)_
-   */
-  trim?: boolean;
-  /**
-   * Shorten consecutive whitespace characters to a single space? _(defaults to `true`)_
-   */
-  whitespace?: boolean;
-};
-/**
- * String normalizer function
- */
-export type Normalizer = {
-  /**
-   * Normalize a string
-   *
-   * @param value String to normalize
-   * @returns Normalized string
-   */
-  normalize(value: string): string;
-};
+declare function Normalizer(this: any, options: NormalizerOptions): void;
 /**
  * Deburr a string, removing diacritical marks
  *
@@ -67,4 +30,5 @@ export declare function normalize(value: string, options?: NormalizeOptions): st
 export declare namespace normalize {
   export var initialize: typeof initializeNormalizer;
 }
-//#endregion
+//#endregion
+export type { NormalizeOptions, Normalizer };

package/dist/string/normalize.mjs

@@ -1,12 +1,14 @@
 import { isPlainObject } from "../internal/is.mjs";
+import { EXPRESSION_WHITESPACE_MULTIPLE } from "../models/misc.model.mjs";
 import { memoize } from "../internal/function/memoize.mjs";
 import { lowerCase } from "../internal/string/case.mjs";
+import { NORMALIZE_DEBURR_CHARACTERS, NORMALIZE_DEBURR_PATTERN_CHARACTERS, NORMALIZE_DEBURR_PATTERN_SIMPLE, NORMALIZE_SPECIAL_PATTERN, NORMALIZE_SYMBOL } from "../models/string/string.normalize.model.mjs";
 //#region src/string/normalize.ts
 function Normalizer(options) {
 	this[NORMALIZE_SYMBOL] = options;
 }
 Normalizer.prototype.normalize = normalizeString;
-function createNormalizeOptions(input) {
+function createNormalizerOptions(input) {
 	const options = isPlainObject(input) ? input : {};
 	return {
 		deburr: options.deburr !== false,
@@ -25,7 +27,7 @@ function createNormalizeOptions(input) {
 function deburr(value) {
 	if (typeof value !== "string") return "";
 	deburrMemoizer ??= memoize((value) => {
-		let deburred = value.normalize(NORMALIZE_DEBURR_NORMALIZATION).replace(NORMALIZE_DEBURR_PATTERN_SIMPLE, "");
+		let deburred = value.normalize("NFD").replace(NORMALIZE_DEBURR_PATTERN_SIMPLE, "");
 		deburred = deburred.replace(NORMALIZE_DEBURR_PATTERN_CHARACTERS, (_, character) => NORMALIZE_DEBURR_CHARACTERS[character]);
 		return deburred;
 	});
@@ -40,7 +42,7 @@ function deburr(value) {
 * @returns Normalizer function
 */
 function initializeNormalizer(options) {
-	return new Normalizer(createNormalizeOptions(options));
+	return new Normalizer(createNormalizerOptions(options));
 }
 /**
 * Normalize a string
@@ -52,60 +54,19 @@ function initializeNormalizer(options) {
 * @returns Normalized string
 */
 function normalize(value, options) {
-	return normalizeString.call(createNormalizeOptions(options), value);
+	return normalizeString.call(createNormalizerOptions(options), value);
 }
 function normalizeString(value) {
 	if (typeof value !== "string") return "";
 	const options = NORMALIZE_SYMBOL in this ? this[NORMALIZE_SYMBOL] : this;
 	let result = value;
 	if (options.trim) result = result.trim();
-	if (options.whitespace) result = result.replace(NORMALIZE_WHITESPACE_PATTERN, NORMALIZE_WHITESPACE_REPLACEMENT);
+	if (options.whitespace) result = result.replace(EXPRESSION_WHITESPACE_MULTIPLE, " ");
 	if (options.deburr) result = deburr(result);
 	if (options.lowerCase) result = lowerCase(result);
-	if (options.special) result = result.replace(NORMALIZE_SPECIAL_PATTERN, NORMALIZE_SPECIAL_REPLACEMENT);
-	return result.normalize(NORMALIZE_NORMALIZATION_NORMALIZATION);
+	if (options.special) result = result.replace(NORMALIZE_SPECIAL_PATTERN, "");
+	return result.normalize("NFC");
 }
-const NORMALIZE_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 NORMALIZE_DEBURR_NORMALIZATION = "NFD";
-const NORMALIZE_DEBURR_PATTERN_CHARACTERS = new RegExp(`(${Object.keys(NORMALIZE_DEBURR_CHARACTERS).join("|")})`, "g");
-const NORMALIZE_DEBURR_PATTERN_SIMPLE = /[\u0300-\u036f]/g;
-const NORMALIZE_NORMALIZATION_NORMALIZATION = "NFC";
-const NORMALIZE_SPECIAL_PATTERN = /[\p{P}\p{S}]/gu;
-const NORMALIZE_SPECIAL_REPLACEMENT = "";
-const NORMALIZE_SYMBOL = Symbol("normalize");
-const NORMALIZE_WHITESPACE_PATTERN = /\s+/g;
-const NORMALIZE_WHITESPACE_REPLACEMENT = " ";
 let deburrMemoizer;
 normalize.initialize = initializeNormalizer;
 //#endregion