@oscarpalmer/atoms 0.173.2 → 0.174.0

package/dist/array/sort.d.mts

@@ -65,7 +65,20 @@ type ComparisonSorter<Item> = (first: Item, second: Item) => number;
  * Direction to sort by
  */
 type SortDirection = 'ascending' | 'descending';
-type Sorter<Item> = (array: Item[]) => Item[];
+type Sorter<Item> = {
+  /**
+   * Sort an array of items
+   * @param array Array to sort
+   * @returns Sorted array
+   */
+  (array: Item[]): Item[];
+  /**
+   * Is the array sorted?
+   * @param array Array to check
+   * @returns `true` if sorted, otherwise `false`
+   */
+  is(array: Item[]): boolean;
+};
 /**
  * Initialize a sort handler with sorters _(and an optional default direction)_
  * @param sorters Sorters to use for sorting
@@ -86,6 +99,29 @@ declare function initializeSort<Item>(sorter: ArraySorter<Item>, descending?: bo
  * @returns Sort handler
  */
 declare function initializeSort<Item>(descending?: boolean): Sorter<Item>;
+/**
+ * Is the array sorted according to the sorters _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorters Sorters to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], sorters: Array<ArraySorter<Item>>, descending?: boolean): boolean;
+/**
+ * Is the array sorted according to the sorter _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorter Sorter to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], sorter: ArraySorter<Item>, descending?: boolean): boolean;
+/**
+ * Is the array sorted?
+ * @param array Array to check
+ * @param descending Sorted in descending order? _(defaults to `false)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], descending?: boolean): boolean;
 /**
  * Sort an array of items, using multiple sorters to sort by specific values
  * @param array Array to sort
@@ -111,6 +147,7 @@ declare function sort<Item>(array: Item[], sorter: ArraySorter<Item>, descending
 declare function sort<Item>(array: Item[], descending?: boolean): Item[];
 declare namespace sort {
   var initialize: typeof initializeSort;
+  var is: typeof isSorted;
 }
 declare const SORT_DIRECTION_ASCENDING: SortDirection;
 declare const SORT_DIRECTION_DESCENDING: SortDirection;

package/dist/array/sort.mjs

@@ -9,6 +9,15 @@ function getComparisonSorter(callback, modifier) {
 		identifier: String(callback)
 	};
 }
+function getComparisonValue(first, second, sorters, length) {
+	for (let index = 0; index < length; index += 1) {
+		const sorter = sorters[index];
+		const values = [sorter.get ? sorter.value(first) : first, sorter.get ? sorter.value(second) : second];
+		const comparison = (sorter.compare?.complex?.(first, values[0], second, values[1]) ?? sorter.compare?.simple?.(values[0], values[1]) ?? compare(values[0], values[1])) * sorter.modifier;
+		if (comparison !== 0) return comparison;
+	}
+	return 0;
+}
 function getModifier(first, second) {
 	return modifiers[first === true || second === true ? SORT_DIRECTION_DESCENDING : SORT_DIRECTION_ASCENDING];
 }
@@ -39,6 +48,11 @@ function getSorters(value, modifier) {
 		const sorter = getSorter(item, modifier);
 		if (sorter != null) sorters.push(sorter);
 	}
+	if (sorters.length === 0) return [{
+		modifier,
+		get: false,
+		identifier: "default"
+	}];
 	return sorters.filter((value, index, array) => array.findIndex((next) => next.identifier === value.identifier) === index);
 }
 function getValueSorter(value, modifier) {
@@ -50,30 +64,50 @@ function getValueSorter(value, modifier) {
 	};
 }
 function initializeSort(first, second) {
-	const modifier = getModifier(first, second);
-	const sorters = getSorters(first, modifier);
-	return (array) => work(array, sorters, modifier);
+	const sorters = getSorters(first, getModifier(first, second));
+	const sorter = (array) => sortArray(array, sorters);
+	sorter.is = (array) => isSortedArray(array, sorters);
+	return sorter;
+}
+function isSorted(array, first, second) {
+	return isSortedArray(array, getSorters(first, getModifier(first, second)));
+}
+function isSortedArray(array, sorters) {
+	if (!Array.isArray(array)) return false;
+	const { length } = array;
+	if (length < 2) return true;
+	const sortersLength = sorters.length;
+	let offset = 0;
+	if (length >= ARRAY_THRESHOLD) {
+		offset = Math.round(length / ARRAY_PEEK_PERCENTAGE);
+		offset = offset > ARRAY_THRESHOLD ? ARRAY_THRESHOLD : offset;
+		for (let index = 0; index < offset; index += 1) {
+			const [firstItem, firstOffset] = [array[index], array[index + 1]];
+			const [secondItem, secondOffset] = [array[length - index - 2], array[length - index - 1]];
+			const [firstComparison, secondComparison] = [getComparisonValue(firstItem, firstOffset, sorters, sortersLength), getComparisonValue(secondItem, secondOffset, sorters, sortersLength)];
+			if (firstComparison > 0 || secondComparison > 0) return false;
+		}
+	}
+	const end = length - offset - 1;
+	for (let index = offset; index < end; index += 1) {
+		const first = array[index];
+		const second = array[index + 1];
+		if (getComparisonValue(first, second, sorters, sortersLength) > 0) return false;
+	}
+	return true;
 }
 function sort(array, first, second) {
-	const modifier = getModifier(first, second);
-	return work(array, getSorters(first, modifier), modifier);
+	return sortArray(array, getSorters(first, getModifier(first, second)));
 }
-function work(array, sorters, modifier) {
+function sortArray(array, sorters) {
 	if (!Array.isArray(array)) return [];
-	if (array.length < 2) return array;
 	const { length } = sorters;
-	if (length === 0) return array.sort((first, second) => compare(first, second) * modifier);
-	return array.sort((first, second) => {
-		for (let index = 0; index < length; index += 1) {
-			const sorter = sorters[index];
-			const values = [sorter.get ? sorter.value(first) : first, sorter.get ? sorter.value(second) : second];
-			const comparison = (sorter.compare?.complex?.(first, values[0], second, values[1]) ?? sorter.compare?.simple?.(values[0], values[1]) ?? compare(values[0], values[1])) * sorter.modifier;
-			if (comparison !== 0) return comparison;
-		}
-		return 0;
-	});
+	return array.length > 1 ? array.sort((first, second) => getComparisonValue(first, second, sorters, length)) : array;
 }
 sort.initialize = initializeSort;
+sort.is = isSorted;
+const ARRAY_PEEK_PERCENTAGE = 10;
+const ARRAY_THRESHOLD = 100;
 const SORT_DIRECTION_ASCENDING = "ascending";
 const SORT_DIRECTION_DESCENDING = "descending";
 const modifiers = {

package/dist/index.d.mts

@@ -1166,7 +1166,20 @@ type ComparisonSorter<Item> = (first: Item, second: Item) => number;
  * Direction to sort by
  */
 type SortDirection = 'ascending' | 'descending';
-type Sorter<Item> = (array: Item[]) => Item[];
+type Sorter<Item> = {
+  /**
+   * Sort an array of items
+   * @param array Array to sort
+   * @returns Sorted array
+   */
+  (array: Item[]): Item[];
+  /**
+   * Is the array sorted?
+   * @param array Array to check
+   * @returns `true` if sorted, otherwise `false`
+   */
+  is(array: Item[]): boolean;
+};
 /**
  * Initialize a sort handler with sorters _(and an optional default direction)_
  * @param sorters Sorters to use for sorting
@@ -1187,6 +1200,29 @@ declare function initializeSort<Item>(sorter: ArraySorter<Item>, descending?: bo
  * @returns Sort handler
  */
 declare function initializeSort<Item>(descending?: boolean): Sorter<Item>;
+/**
+ * Is the array sorted according to the sorters _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorters Sorters to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], sorters: Array<ArraySorter<Item>>, descending?: boolean): boolean;
+/**
+ * Is the array sorted according to the sorter _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorter Sorter to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], sorter: ArraySorter<Item>, descending?: boolean): boolean;
+/**
+ * Is the array sorted?
+ * @param array Array to check
+ * @param descending Sorted in descending order? _(defaults to `false)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+declare function isSorted<Item>(array: Item[], descending?: boolean): boolean;
 /**
  * Sort an array of items, using multiple sorters to sort by specific values
  * @param array Array to sort
@@ -1212,6 +1248,7 @@ declare function sort<Item>(array: Item[], sorter: ArraySorter<Item>, descending
 declare function sort<Item>(array: Item[], descending?: boolean): Item[];
 declare namespace sort {
   var initialize: typeof initializeSort;
+  var is: typeof isSorted;
 }
 declare const SORT_DIRECTION_ASCENDING: SortDirection;
 declare const SORT_DIRECTION_DESCENDING: SortDirection;

package/dist/index.mjs

@@ -869,26 +869,11 @@ compare.handlers = getCompareHandlers(compare, {
 });
 compare.register = registerComparator;
 compare.unregister = unregisterComparator;
-/**
-* Register a custom comparison handler for a class
-* @param constructor Class constructor
-* @param handler Method name or comparison function _(defaults to `compare`)_
-*/
-function registerComparator(constructor, handler) {
-	compare.handlers.register(constructor, handler);
-}
-/**
-* Unregister a custom comparison handler for a class
-* @param constructor Class constructor
-*/
-function unregisterComparator(constructor) {
-	compare.handlers.unregister(constructor);
-}
 function compareNumbers(first, second) {
-	const firstNumber = Number(first);
-	const secondNumber = Number(second);
-	if (Object.is(firstNumber, secondNumber)) return 0;
-	return firstNumber > secondNumber ? 1 : -1;
+	if (Object.is(first, second)) return 0;
+	if (Number.isNaN(first)) return -1;
+	if (Number.isNaN(second)) return 1;
+	return first > second ? 1 : -1;
 }
 function compareSymbols(first, second) {
 	return getString(first.description ?? first).localeCompare(getString(second.description ?? second));
@@ -903,9 +888,24 @@ function getComparisonParts(value) {
 	if (Array.isArray(value)) return value;
 	return typeof value === "object" ? [value] : words(getString(value));
 }
+/**
+* Register a custom comparison handler for a class
+* @param constructor Class constructor
+* @param handler Method name or comparison function _(defaults to `compare`)_
+*/
+function registerComparator(constructor, handler) {
+	compare.handlers.register(constructor, handler);
+}
+/**
+* Unregister a custom comparison handler for a class
+* @param constructor Class constructor
+*/
+function unregisterComparator(constructor) {
+	compare.handlers.unregister(constructor);
+}
 const comparators = {
 	bigint: compareNumbers,
-	boolean: compareNumbers,
+	boolean: (first, second) => compareNumbers(first ? 1 : 0, second ? 1 : 0),
 	number: compareNumbers,
 	symbol: compareSymbols
 };
@@ -919,6 +919,15 @@ function getComparisonSorter(callback, modifier) {
 		identifier: String(callback)
 	};
 }
+function getComparisonValue(first, second, sorters, length) {
+	for (let index = 0; index < length; index += 1) {
+		const sorter = sorters[index];
+		const values = [sorter.get ? sorter.value(first) : first, sorter.get ? sorter.value(second) : second];
+		const comparison = (sorter.compare?.complex?.(first, values[0], second, values[1]) ?? sorter.compare?.simple?.(values[0], values[1]) ?? compare(values[0], values[1])) * sorter.modifier;
+		if (comparison !== 0) return comparison;
+	}
+	return 0;
+}
 function getModifier(first, second) {
 	return modifiers[first === true || second === true ? SORT_DIRECTION_DESCENDING : SORT_DIRECTION_ASCENDING];
 }
@@ -949,6 +958,11 @@ function getSorters(value, modifier) {
 		const sorter = getSorter(item, modifier);
 		if (sorter != null) sorters.push(sorter);
 	}
+	if (sorters.length === 0) return [{
+		modifier,
+		get: false,
+		identifier: "default"
+	}];
 	return sorters.filter((value, index, array) => array.findIndex((next) => next.identifier === value.identifier) === index);
 }
 function getValueSorter(value, modifier) {
@@ -960,30 +974,50 @@ function getValueSorter(value, modifier) {
 	};
 }
 function initializeSort(first, second) {
-	const modifier = getModifier(first, second);
-	const sorters = getSorters(first, modifier);
-	return (array) => work$1(array, sorters, modifier);
+	const sorters = getSorters(first, getModifier(first, second));
+	const sorter = (array) => sortArray(array, sorters);
+	sorter.is = (array) => isSortedArray(array, sorters);
+	return sorter;
+}
+function isSorted(array, first, second) {
+	return isSortedArray(array, getSorters(first, getModifier(first, second)));
+}
+function isSortedArray(array, sorters) {
+	if (!Array.isArray(array)) return false;
+	const { length } = array;
+	if (length < 2) return true;
+	const sortersLength = sorters.length;
+	let offset = 0;
+	if (length >= ARRAY_THRESHOLD$1) {
+		offset = Math.round(length / ARRAY_PEEK_PERCENTAGE$1);
+		offset = offset > ARRAY_THRESHOLD$1 ? ARRAY_THRESHOLD$1 : offset;
+		for (let index = 0; index < offset; index += 1) {
+			const [firstItem, firstOffset] = [array[index], array[index + 1]];
+			const [secondItem, secondOffset] = [array[length - index - 2], array[length - index - 1]];
+			const [firstComparison, secondComparison] = [getComparisonValue(firstItem, firstOffset, sorters, sortersLength), getComparisonValue(secondItem, secondOffset, sorters, sortersLength)];
+			if (firstComparison > 0 || secondComparison > 0) return false;
+		}
+	}
+	const end = length - offset - 1;
+	for (let index = offset; index < end; index += 1) {
+		const first = array[index];
+		const second = array[index + 1];
+		if (getComparisonValue(first, second, sorters, sortersLength) > 0) return false;
+	}
+	return true;
 }
 function sort(array, first, second) {
-	const modifier = getModifier(first, second);
-	return work$1(array, getSorters(first, modifier), modifier);
+	return sortArray(array, getSorters(first, getModifier(first, second)));
 }
-function work$1(array, sorters, modifier) {
+function sortArray(array, sorters) {
 	if (!Array.isArray(array)) return [];
-	if (array.length < 2) return array;
 	const { length } = sorters;
-	if (length === 0) return array.sort((first, second) => compare(first, second) * modifier);
-	return array.sort((first, second) => {
-		for (let index = 0; index < length; index += 1) {
-			const sorter = sorters[index];
-			const values = [sorter.get ? sorter.value(first) : first, sorter.get ? sorter.value(second) : second];
-			const comparison = (sorter.compare?.complex?.(first, values[0], second, values[1]) ?? sorter.compare?.simple?.(values[0], values[1]) ?? compare(values[0], values[1])) * sorter.modifier;
-			if (comparison !== 0) return comparison;
-		}
-		return 0;
-	});
+	return array.length > 1 ? array.sort((first, second) => getComparisonValue(first, second, sorters, length)) : array;
 }
 sort.initialize = initializeSort;
+sort.is = isSorted;
+const ARRAY_PEEK_PERCENTAGE$1 = 10;
+const ARRAY_THRESHOLD$1 = 100;
 const SORT_DIRECTION_ASCENDING = "ascending";
 const SORT_DIRECTION_DESCENDING = "descending";
 const modifiers = {
@@ -1198,12 +1232,10 @@ function getNumber(value) {
 	if (EXPRESSION_ZEROISH.test(parsed)) return 0;
 	const isBinary = EXPRESSION_BINARY.test(trimmed);
 	if (isBinary || EXPRESSION_OCTAL.test(trimmed)) return Number.parseInt(trimmed.slice(2), isBinary ? 2 : OCTAL_VALUE);
-	return Number(EXPRESSION_HEX.test(trimmed) ? trimmed : trimmed.replace(EXPRESSION_UNDERSCORE, ""));
+	return Number(trimmed);
 }
 const EXPRESSION_BINARY = /^0b[01]+$/i;
-const EXPRESSION_HEX = /^0x[0-9a-f]+$/i;
 const EXPRESSION_OCTAL = /^0o[0-7]+$/i;
-const EXPRESSION_UNDERSCORE = /_/g;
 const EXPRESSION_ZEROISH = /^\s*0+\s*$/;
 const OCTAL_VALUE = 8;
 //#endregion
@@ -4058,11 +4090,11 @@ async function resultPromises(items, signal) {
 */
 function fromQuery(query) {
 	if (typeof query !== "string" || query.trim().length === 0) return {};
-	const parts = query.split("&");
+	const parts = query.split(AMPERSAND);
 	const { length } = parts;
 	const parameters = {};
 	for (let index = 0; index < length; index += 1) {
-		const decoded = parts[index].split("=").map(tryDecode);
+		const decoded = parts[index].split(EQUAL).map(tryDecode);
 		const key = decoded[0].replace(EXPRESSION_ARRAY_SUFFIX, "");
 		if (!ignoreKey(key)) setQueryValue(parameters, key, decoded[1]);
 	}
@@ -4085,7 +4117,6 @@ function getParts(value, fromArray, prefix) {
 }
 function getQueryValue(value) {
 	if (EXPRESSION_BOOLEAN.test(value)) return value === TRUE;
-	if (EXPRESSION_NOPARSE.test(value)) return value;
 	const asNumber = getNumber(value);
 	if (!Number.isNaN(asNumber)) return asNumber;
 	const parsed = Date.parse(value);
@@ -4097,7 +4128,7 @@ function isDecodable(value) {
 	return TYPES.has(typeof value);
 }
 function setQueryValue(parameters, key, value) {
-	if (key.includes(".")) setValue(parameters, key, getQueryValue(value));
+	if (EXPRESSION_DOT.test(key)) setValue(parameters, key, getQueryValue(value));
 	else if (key in parameters) {
 		if (!Array.isArray(parameters[key])) parameters[key] = [parameters[key]];
 		parameters[key].push(getQueryValue(value));
@@ -4109,11 +4140,13 @@ function setQueryValue(parameters, key, value) {
 * @returns Query string representation of the object
 */
 function toQuery(parameters) {
-	return isPlainObject(parameters) ? join(getParts(parameters, false).filter((part) => part.length > 0), "&") : "";
+	return isPlainObject(parameters) ? join(getParts(parameters, false).filter((part) => part.length > 0), AMPERSAND) : "";
 }
+const AMPERSAND = "&";
+const EQUAL = "=";
 const EXPRESSION_ARRAY_SUFFIX = /\[\]$/;
 const EXPRESSION_BOOLEAN = /^(false|true)$/;
-const EXPRESSION_NOPARSE = /[_]/;
+const EXPRESSION_DOT = /\./g;
 const TRUE = "true";
 const TYPES = new Set([
 	"boolean",

package/dist/internal/number.mjs

@@ -51,12 +51,10 @@ function getNumber(value) {
 	if (EXPRESSION_ZEROISH.test(parsed)) return 0;
 	const isBinary = EXPRESSION_BINARY.test(trimmed);
 	if (isBinary || EXPRESSION_OCTAL.test(trimmed)) return Number.parseInt(trimmed.slice(2), isBinary ? 2 : OCTAL_VALUE);
-	return Number(EXPRESSION_HEX.test(trimmed) ? trimmed : trimmed.replace(EXPRESSION_UNDERSCORE, ""));
+	return Number(trimmed);
 }
 const EXPRESSION_BINARY = /^0b[01]+$/i;
-const EXPRESSION_HEX = /^0x[0-9a-f]+$/i;
 const EXPRESSION_OCTAL = /^0o[0-7]+$/i;
-const EXPRESSION_UNDERSCORE = /_/g;
 const EXPRESSION_ZEROISH = /^\s*0+\s*$/;
 const OCTAL_VALUE = 8;
 //#endregion

package/dist/internal/value/compare.mjs

@@ -39,26 +39,11 @@ compare.handlers = getCompareHandlers(compare, {
 });
 compare.register = registerComparator;
 compare.unregister = unregisterComparator;
-/**
-* Register a custom comparison handler for a class
-* @param constructor Class constructor
-* @param handler Method name or comparison function _(defaults to `compare`)_
-*/
-function registerComparator(constructor, handler) {
-	compare.handlers.register(constructor, handler);
-}
-/**
-* Unregister a custom comparison handler for a class
-* @param constructor Class constructor
-*/
-function unregisterComparator(constructor) {
-	compare.handlers.unregister(constructor);
-}
 function compareNumbers(first, second) {
-	const firstNumber = Number(first);
-	const secondNumber = Number(second);
-	if (Object.is(firstNumber, secondNumber)) return 0;
-	return firstNumber > secondNumber ? 1 : -1;
+	if (Object.is(first, second)) return 0;
+	if (Number.isNaN(first)) return -1;
+	if (Number.isNaN(second)) return 1;
+	return first > second ? 1 : -1;
 }
 function compareSymbols(first, second) {
 	return getString(first.description ?? first).localeCompare(getString(second.description ?? second));
@@ -73,9 +58,24 @@ function getComparisonParts(value) {
 	if (Array.isArray(value)) return value;
 	return typeof value === "object" ? [value] : words(getString(value));
 }
+/**
+* Register a custom comparison handler for a class
+* @param constructor Class constructor
+* @param handler Method name or comparison function _(defaults to `compare`)_
+*/
+function registerComparator(constructor, handler) {
+	compare.handlers.register(constructor, handler);
+}
+/**
+* Unregister a custom comparison handler for a class
+* @param constructor Class constructor
+*/
+function unregisterComparator(constructor) {
+	compare.handlers.unregister(constructor);
+}
 const comparators = {
 	bigint: compareNumbers,
-	boolean: compareNumbers,
+	boolean: (first, second) => compareNumbers(first ? 1 : 0, second ? 1 : 0),
 	number: compareNumbers,
 	symbol: compareSymbols
 };

package/dist/query.mjs

@@ -10,11 +10,11 @@ import { setValue } from "./internal/value/set.mjs";
 */
 function fromQuery(query) {
 	if (typeof query !== "string" || query.trim().length === 0) return {};
-	const parts = query.split("&");
+	const parts = query.split(AMPERSAND);
 	const { length } = parts;
 	const parameters = {};
 	for (let index = 0; index < length; index += 1) {
-		const decoded = parts[index].split("=").map(tryDecode);
+		const decoded = parts[index].split(EQUAL).map(tryDecode);
 		const key = decoded[0].replace(EXPRESSION_ARRAY_SUFFIX, "");
 		if (!ignoreKey(key)) setQueryValue(parameters, key, decoded[1]);
 	}
@@ -37,7 +37,6 @@ function getParts(value, fromArray, prefix) {
 }
 function getQueryValue(value) {
 	if (EXPRESSION_BOOLEAN.test(value)) return value === TRUE;
-	if (EXPRESSION_NOPARSE.test(value)) return value;
 	const asNumber = getNumber(value);
 	if (!Number.isNaN(asNumber)) return asNumber;
 	const parsed = Date.parse(value);
@@ -49,7 +48,7 @@ function isDecodable(value) {
 	return TYPES.has(typeof value);
 }
 function setQueryValue(parameters, key, value) {
-	if (key.includes(".")) setValue(parameters, key, getQueryValue(value));
+	if (EXPRESSION_DOT.test(key)) setValue(parameters, key, getQueryValue(value));
 	else if (key in parameters) {
 		if (!Array.isArray(parameters[key])) parameters[key] = [parameters[key]];
 		parameters[key].push(getQueryValue(value));
@@ -61,11 +60,13 @@ function setQueryValue(parameters, key, value) {
 * @returns Query string representation of the object
 */
 function toQuery(parameters) {
-	return isPlainObject(parameters) ? join(getParts(parameters, false).filter((part) => part.length > 0), "&") : "";
+	return isPlainObject(parameters) ? join(getParts(parameters, false).filter((part) => part.length > 0), AMPERSAND) : "";
 }
+const AMPERSAND = "&";
+const EQUAL = "=";
 const EXPRESSION_ARRAY_SUFFIX = /\[\]$/;
 const EXPRESSION_BOOLEAN = /^(false|true)$/;
-const EXPRESSION_NOPARSE = /[_]/;
+const EXPRESSION_DOT = /\./g;
 const TRUE = "true";
 const TYPES = new Set([
 	"boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.173.2",
+	"version": "0.174.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"helper",
@@ -230,7 +230,7 @@
 	},
 	"devDependencies": {
 		"@oxlint/plugins": "^1.59",
-		"@types/node": "^25.5",
+		"@types/node": "^25.6",
 		"@vitest/coverage-istanbul": "^4.1",
 		"eslint": "^10.2",
 		"jsdom": "^29.0",

package/src/array/sort.ts

@@ -104,7 +104,21 @@ type InternalSorterCompare = {
  */
 export type SortDirection = 'ascending' | 'descending';
 
-export type Sorter<Item> = (array: Item[]) => Item[];
+export type Sorter<Item> = {
+	/**
+	 * Sort an array of items
+	 * @param array Array to sort
+	 * @returns Sorted array
+	 */
+	(array: Item[]): Item[];
+
+	/**
+	 * Is the array sorted?
+	 * @param array Array to check
+	 * @returns `true` if sorted, otherwise `false`
+	 */
+	is(array: Item[]): boolean;
+};
 
 // #endregion
 
@@ -121,6 +135,33 @@ function getComparisonSorter(callback: Function, modifier: number): InternalSort
 	};
 }
 
+function getComparisonValue(
+	first: unknown,
+	second: unknown,
+	sorters: InternalSorter[],
+	length: number,
+): number {
+	for (let index = 0; index < length; index += 1) {
+		const sorter = sorters[index];
+
+		const values = [
+			sorter.get ? sorter.value!(first as PlainObject) : first,
+			sorter.get ? sorter.value!(second as PlainObject) : second,
+		];
+
+		const comparison =
+			(sorter.compare?.complex?.(first, values[0], second, values[1]) ??
+				sorter.compare?.simple?.(values[0], values[1]) ??
+				compare(values[0], values[1])) * sorter.modifier;
+
+		if (comparison !== 0) {
+			return comparison;
+		}
+	}
+
+	return 0;
+}
+
 function getModifier(first: unknown, second: unknown): number {
 	const direction =
 		first === true || second === true ? SORT_DIRECTION_DESCENDING : SORT_DIRECTION_ASCENDING;
@@ -184,6 +225,16 @@ function getSorters(value: unknown, modifier: number): InternalSorter[] {
 		}
 	}
 
+	if (sorters.length === 0) {
+		return [
+			{
+				modifier,
+				get: false,
+				identifier: 'default',
+			},
+		];
+	}
+
 	return sorters.filter(
 		(value, index, array) =>
 			array.findIndex(next => next.identifier === value.identifier) === index,
@@ -226,10 +277,97 @@ function initializeSort<Item>(sorter: ArraySorter<Item>, descending?: boolean):
 function initializeSort<Item>(descending?: boolean): Sorter<Item>;
 
 function initializeSort(first?: unknown, second?: unknown): Sorter<unknown> {
-	const modifier = getModifier(first, second);
-	const sorters = getSorters(first, modifier);
+	const sorters = getSorters(first, getModifier(first, second));
+
+	const sorter = (array: unknown[]) => sortArray(array, sorters);
+
+	sorter.is = (array: unknown[]) => isSortedArray(array, sorters);
 
-	return array => work(array, sorters, modifier);
+	return sorter as unknown as Sorter<unknown>;
+}
+
+/**
+ * Is the array sorted according to the sorters _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorters Sorters to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+function isSorted<Item>(
+	array: Item[],
+	sorters: Array<ArraySorter<Item>>,
+	descending?: boolean,
+): boolean;
+
+/**
+ * Is the array sorted according to the sorter _(and the optional default direction)_?
+ * @param array Array to check
+ * @param sorter Sorter to use
+ * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+function isSorted<Item>(array: Item[], sorter: ArraySorter<Item>, descending?: boolean): boolean;
+
+/**
+ * Is the array sorted?
+ * @param array Array to check
+ * @param descending Sorted in descending order? _(defaults to `false)_
+ * @returns `true` if sorted, otherwise `false`
+ */
+function isSorted<Item>(array: Item[], descending?: boolean): boolean;
+
+function isSorted(array: unknown[], first?: unknown, second?: unknown): boolean {
+	return isSortedArray(array, getSorters(first, getModifier(first, second)));
+}
+
+function isSortedArray(array: unknown[], sorters: InternalSorter[]): boolean {
+	if (!Array.isArray(array)) {
+		return false;
+	}
+
+	const {length} = array;
+
+	if (length < 2) {
+		return true;
+	}
+
+	const sortersLength = sorters.length;
+
+	let offset = 0;
+
+	if (length >= ARRAY_THRESHOLD) {
+		offset = Math.round(length / ARRAY_PEEK_PERCENTAGE);
+		offset = offset > ARRAY_THRESHOLD ? ARRAY_THRESHOLD : offset;
+
+		for (let index = 0; index < offset; index += 1) {
+			const [firstItem, firstOffset] = [array[index], array[index + 1]];
+			const [secondItem, secondOffset] = [array[length - index - 2], array[length - index - 1]];
+
+			const [firstComparison, secondComparison] = [
+				getComparisonValue(firstItem, firstOffset, sorters, sortersLength),
+				getComparisonValue(secondItem, secondOffset, sorters, sortersLength),
+			];
+
+			if (firstComparison > 0 || secondComparison > 0) {
+				return false;
+			}
+		}
+	}
+
+	const end = length - offset - 1;
+
+	for (let index = offset; index < end; index += 1) {
+		const first = array[index];
+		const second = array[index + 1];
+
+		const comparison = getComparisonValue(first, second, sorters, sortersLength);
+
+		if (comparison > 0) {
+			return false;
+		}
+	}
+
+	return true;
 }
 
 /**
@@ -263,55 +401,33 @@ export function sort<Item>(array: Item[], sorter: ArraySorter<Item>, descending?
 export function sort<Item>(array: Item[], descending?: boolean): Item[];
 
 export function sort(array: unknown[], first?: unknown, second?: unknown): unknown[] {
-	const modifier = getModifier(first, second);
-
-	return work(array, getSorters(first, modifier), modifier);
+	return sortArray(array, getSorters(first, getModifier(first, second)));
 }
 
-function work(array: unknown[], sorters: InternalSorter[], modifier: number): unknown[] {
+function sortArray(array: unknown[], sorters: InternalSorter[]): unknown[] {
 	if (!Array.isArray(array)) {
 		return [];
 	}
 
-	if (array.length < 2) {
-		return array;
-	}
-
 	const {length} = sorters;
 
-	if (length === 0) {
-		return array.sort((first, second) => compare(first, second) * modifier);
-	}
-
-	return array.sort((first, second) => {
-		for (let index = 0; index < length; index += 1) {
-			const sorter = sorters[index];
-
-			const values = [
-				sorter.get ? sorter.value!(first as PlainObject) : first,
-				sorter.get ? sorter.value!(second as PlainObject) : second,
-			];
-
-			const comparison =
-				(sorter.compare?.complex?.(first, values[0], second, values[1]) ??
-					sorter.compare?.simple?.(values[0], values[1]) ??
-					compare(values[0], values[1])) * sorter.modifier;
-
-			if (comparison !== 0) {
-				return comparison;
-			}
-		}
-
-		return 0;
-	});
+	return array.length > 1
+		? array.sort((first, second) => getComparisonValue(first, second, sorters, length))
+		: array;
 }
 
 sort.initialize = initializeSort;
 
+sort.is = isSorted;
+
 // #endregion
 
 // #region Variables
 
+const ARRAY_PEEK_PERCENTAGE = 10;
+
+const ARRAY_THRESHOLD = 100;
+
 export const SORT_DIRECTION_ASCENDING: SortDirection = 'ascending';
 
 export const SORT_DIRECTION_DESCENDING: SortDirection = 'descending';

package/src/internal/number.ts

@@ -94,9 +94,7 @@ export function getNumber(value: unknown): number {
 		return Number.parseInt(trimmed.slice(2), isBinary ? 2 : OCTAL_VALUE);
 	}
 
-	return Number(
-		EXPRESSION_HEX.test(trimmed) ? trimmed : trimmed.replace(EXPRESSION_UNDERSCORE, ''),
-	);
+	return Number(trimmed);
 }
 
 // #endregion
@@ -105,12 +103,8 @@ export function getNumber(value: unknown): number {
 
 const EXPRESSION_BINARY = /^0b[01]+$/i;
 
-const EXPRESSION_HEX = /^0x[0-9a-f]+$/i;
-
 const EXPRESSION_OCTAL = /^0o[0-7]+$/i;
 
-const EXPRESSION_UNDERSCORE = /_/g;
-
 const EXPRESSION_ZEROISH = /^\s*0+\s*$/;
 
 const OCTAL_VALUE = 8;

package/src/internal/value/compare.ts

@@ -80,38 +80,20 @@ compare.register = registerComparator;
 
 compare.unregister = unregisterComparator;
 
-/**
- * Register a custom comparison handler for a class
- * @param constructor Class constructor
- * @param handler Method name or comparison function _(defaults to `compare`)_
- */
-function registerComparator<Instance>(
-	constructor: Constructor<Instance>,
-	handler?: string | ((first: Instance, second: Instance) => number),
-): void {
-	compare.handlers.register(constructor, handler);
-}
-
-/**
- * Unregister a custom comparison handler for a class
- * @param constructor Class constructor
- */
-function unregisterComparator<Instance>(constructor: Constructor<Instance>): void {
-	compare.handlers.unregister(constructor);
-}
+function compareNumbers(first: bigint | number, second: bigint | number): number {
+	if (Object.is(first, second)) {
+		return 0;
+	}
 
-function compareNumbers(
-	first: bigint | boolean | number,
-	second: bigint | boolean | number,
-): number {
-	const firstNumber = Number(first);
-	const secondNumber = Number(second);
+	if (Number.isNaN(first)) {
+		return -1;
+	}
 
-	if (Object.is(firstNumber, secondNumber)) {
-		return 0;
+	if (Number.isNaN(second)) {
+		return 1;
 	}
 
-	return firstNumber > secondNumber ? 1 : -1;
+	return first > second ? 1 : -1;
 }
 
 function compareSymbols(first: symbol, second: symbol): number {
@@ -147,13 +129,33 @@ function getComparisonParts(value: unknown): unknown[] {
 	return typeof value === 'object' ? [value] : words(getString(value));
 }
 
+/**
+ * Register a custom comparison handler for a class
+ * @param constructor Class constructor
+ * @param handler Method name or comparison function _(defaults to `compare`)_
+ */
+function registerComparator<Instance>(
+	constructor: Constructor<Instance>,
+	handler?: string | ((first: Instance, second: Instance) => number),
+): void {
+	compare.handlers.register(constructor, handler);
+}
+
+/**
+ * Unregister a custom comparison handler for a class
+ * @param constructor Class constructor
+ */
+function unregisterComparator<Instance>(constructor: Constructor<Instance>): void {
+	compare.handlers.unregister(constructor);
+}
+
 // #endregion
 
 // #region Variables
 
 const comparators: Record<string, Comparator> = {
 	bigint: compareNumbers,
-	boolean: compareNumbers,
+	boolean: (first, second) => compareNumbers(first ? 1 : 0, second ? 1 : 0),
 	number: compareNumbers,
 	symbol: compareSymbols,
 };

package/src/query.ts

@@ -16,13 +16,13 @@ export function fromQuery(query: string): PlainObject {
 		return {};
 	}
 
-	const parts = query.split('&');
+	const parts = query.split(AMPERSAND);
 	const {length} = parts;
 
 	const parameters: PlainObject = {};
 
 	for (let index = 0; index < length; index += 1) {
-		const decoded = parts[index].split('=').map(tryDecode);
+		const decoded = parts[index].split(EQUAL).map(tryDecode);
 		const key = decoded[0].replace(EXPRESSION_ARRAY_SUFFIX, '');
 
 		if (!ignoreKey(key)) {
@@ -64,10 +64,6 @@ function getQueryValue(value: string): unknown {
 		return value === TRUE;
 	}
 
-	if (EXPRESSION_NOPARSE.test(value)) {
-		return value;
-	}
-
 	const asNumber = getNumber(value);
 
 	if (!Number.isNaN(asNumber)) {
@@ -90,7 +86,7 @@ function isDecodable(value: unknown): value is boolean | number | string {
 }
 
 function setQueryValue(parameters: PlainObject, key: string, value: string): void {
-	if (key.includes('.')) {
+	if (EXPRESSION_DOT.test(key)) {
 		setValue(parameters, key, getQueryValue(value));
 	} else {
 		if (key in parameters) {
@@ -114,7 +110,7 @@ export function toQuery(parameters: PlainObject): string {
 	return isPlainObject(parameters)
 		? join(
 				getParts(parameters, false).filter(part => part.length > 0),
-				'&',
+				AMPERSAND,
 			)
 		: '';
 }
@@ -123,11 +119,15 @@ export function toQuery(parameters: PlainObject): string {
 
 // #region Variables
 
+const AMPERSAND = '&';
+
+const EQUAL = '=';
+
 const EXPRESSION_ARRAY_SUFFIX = /\[\]$/;
 
 const EXPRESSION_BOOLEAN = /^(false|true)$/;
 
-const EXPRESSION_NOPARSE = /[_]/;
+const EXPRESSION_DOT = /\./g;
 
 const TRUE = 'true';