@oscarpalmer/atoms 0.177.0 → 0.178.0

package/dist/array/index.d.mts

@@ -13,6 +13,7 @@ import { intersection } from "./intersection.mjs";
 import { partition } from "./partition.mjs";
 import { ArrayPosition, endsWithArray, getArrayPosition, includesArray, indexOfArray, startsWithArray } from "./position.mjs";
 import { push } from "./push.mjs";
+import { reverse } from "./reverse.mjs";
 import { select } from "./select.mjs";
 import { single } from "./single.mjs";
 import { drop, slice, take } from "./slice.mjs";
@@ -22,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, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };
+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 };

package/dist/array/index.mjs

@@ -13,6 +13,7 @@ import { intersection } from "./intersection.mjs";
 import { partition } from "./partition.mjs";
 import { endsWithArray, getArrayPosition, includesArray, indexOfArray, startsWithArray } from "./position.mjs";
 import { push } from "./push.mjs";
+import { reverse } from "./reverse.mjs";
 import { select } from "./select.mjs";
 import { single } from "./single.mjs";
 import { drop, slice, take } from "./slice.mjs";
@@ -22,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, select, shuffle, single, slice, splice, startsWithArray, take, times, toSet, toggle, union, unique, update };
+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 };

package/dist/array/reverse.d.mts

@@ -0,0 +1,4 @@
+//#region src/array/reverse.d.ts
+declare function reverse<Item>(array: Item[]): Item[];
+//#endregion
+export { reverse };

package/dist/array/reverse.mjs

@@ -0,0 +1,16 @@
+//#region src/array/reverse.ts
+function reverse(array) {
+	if (!Array.isArray(array)) return [];
+	const { length } = array;
+	if (length < 2) return array;
+	const half = Math.floor(length / 2);
+	for (let firstIndex = 0; firstIndex < half; firstIndex += 1) {
+		const temporaryItem = array[firstIndex];
+		const secondIndex = length - 1 - firstIndex;
+		array[firstIndex] = array[secondIndex];
+		array[secondIndex] = temporaryItem;
+	}
+	return array;
+}
+//#endregion
+export { reverse };

package/dist/index.d.mts

@@ -829,6 +829,9 @@ declare function startsWithArray<Item>(haystack: Item[], needle: Item[]): boolea
  */
 declare function push<Item>(array: Item[], pushed: Item[]): number;
 //#endregion
+//#region src/array/reverse.d.ts
+declare function reverse<Item>(array: Item[]): Item[];
+//#endregion
 //#region src/array/select.d.ts
 /**
  * Get a filtered and mapped array of items
@@ -2667,6 +2670,8 @@ declare function titleCase(value: string): string;
 declare function upperCase(value: string): string;
 //#endregion
 //#region src/string/index.d.ts
+declare function dedent(strings: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedent(value: string): string;
 /**
  * Get a new UUID-string _(version 4)_
  * @returns UUID string
@@ -3343,13 +3348,54 @@ declare function isInstanceOf<Instance>(constructor: Constructor<Instance>, valu
  * @returns `true` if the value is a `Key` _(`number` or `string`)_, otherwise `false`
  */
 declare function isKey(value: unknown): value is Key;
+/**
+ * Is the value not an array or a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not an array or a plain object, otherwise `false`
+ */
 declare function isNonArrayOrPlainObject<Value>(value: Value): value is Exclude<Value, ArrayOrPlainObject>;
+/**
+ * Is the value not a constructor function?
+ * @param value Value to check
+ * @returns `true` if the value is not a constructor function, otherwise `false`
+ */
 declare function isNonConstructor<Value>(value: Value): value is Exclude<Value, Constructor>;
+/**
+ * Is the value not an instance of the constructor?
+ * @param constructor Class constructor
+ * @param value Value to check
+ * @returns `true` if the value is not an instance of the constructor, otherwise `false`
+ */
 declare function isNonInstanceOf<Instance, Value>(constructor: Constructor<Instance>, value: Value): value is Exclude<Value, Instance>;
+/**
+ * Is the value not a key?
+ * @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>;
+/**
+ * Is the value not a number?
+ * @param value Value to check
+ * @returns `true` if the value is not a `number`, otherwise `false`
+ */
 declare function isNonNumber<Value>(value: Value): value is Exclude<Value, number>;
+/**
+ * Is the value not a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not a plain object, otherwise `false`
+ */
 declare function isNonPlainObject<Value>(value: Value): value is Exclude<Value, PlainObject>;
+/**
+ * Is the value not a primitive value?
+ * @param value Value to check
+ * @returns `true` if the value is not a primitive value, otherwise `false`
+ */
 declare function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Primitive>;
+/**
+ * Is the value not a typed array?
+ * @param value Value to check
+ * @returns `true` if the value is not a typed array, otherwise `false`
+ */
 declare function isNonTypedArray<Value>(value: Value): value is Exclude<Value, TypedArray>;
 /**
  * Is the value a number?
@@ -4780,4 +4826,4 @@ declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { AnyResult, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayPosition, ArrayValueSorter, Asserter, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, ExtendedErr, ExtendedResult, Flow, FlowPromise, FulfilledPromise, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, HasValue, Key, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, Simplify, SizedMap, SizedSet, Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Time, ToString, TypedArray, Unsmushed, UnwrapValue, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, first, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, 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, isTypedArray, join, kebabCase, last, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { AnyResult, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayPosition, ArrayValueSorter, Asserter, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, ExtendedErr, ExtendedResult, Flow, FlowPromise, FulfilledPromise, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, HasValue, Key, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, Simplify, SizedMap, SizedSet, Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Time, ToString, TypedArray, Unsmushed, UnwrapValue, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, dedent, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, first, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, 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, isTypedArray, join, kebabCase, last, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, 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, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/index.mjs

@@ -212,27 +212,68 @@ function isInstanceOf(constructor, value) {
 function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
+/**
+* Is the value not an array or a plain object?
+* @param value Value to check
+* @returns `true` if the value is not an array or a plain object, otherwise `false`
+*/
 function isNonArrayOrPlainObject(value) {
 	return !isArrayOrPlainObject(value);
 }
+/**
+* Is the value not a constructor function?
+* @param value Value to check
+* @returns `true` if the value is not a constructor function, otherwise `false`
+*/
 function isNonConstructor(value) {
 	return !isConstructor(value);
 }
+/**
+* Is the value not an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is not an instance of the constructor, otherwise `false`
+*/
 function isNonInstanceOf(constructor, value) {
 	return !isInstanceOf(constructor, value);
 }
+/**
+* Is the value not a key?
+* @param value Value to check
+* @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
+*/
 function isNonKey(value) {
 	return !isKey(value);
 }
+/**
+* Is the value not a number?
+* @param value Value to check
+* @returns `true` if the value is not a `number`, otherwise `false`
+*/
 function isNonNumber(value) {
 	return !isNumber(value);
 }
+/**
+* Is the value not a plain object?
+* @param value Value to check
+* @returns `true` if the value is not a plain object, otherwise `false`
+*/
 function isNonPlainObject(value) {
 	return !isPlainObject(value);
 }
+/**
+* Is the value not a primitive value?
+* @param value Value to check
+* @returns `true` if the value is not a primitive value, otherwise `false`
+*/
 function isNonPrimitive(value) {
 	return !isPrimitive(value);
 }
+/**
+* Is the value not a typed array?
+* @param value Value to check
+* @returns `true` if the value is not a typed array, otherwise `false`
+*/
 function isNonTypedArray(value) {
 	return !isTypedArray(value);
 }
@@ -266,6 +307,14 @@ function isPrimitive(value) {
 	return type === "bigint" || type === "boolean" || type === "number" || type === "string" || type === "symbol";
 }
 /**
+* Is the value a template strings array?
+* @param value Value to check
+* @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+*/
+function isTemplateStringsArray(value) {
+	return Array.isArray(value) && Array.isArray(value.raw);
+}
+/**
 * Is the value a typed array?
 * @param value Value to check
 * @returns `true` if the value is a typed array, otherwise `false`
@@ -532,6 +581,21 @@ function push(array, pushed) {
 	return insertValues(INSERT_TYPE_PUSH, array, pushed, array.length, 0);
 }
 //#endregion
+//#region src/array/reverse.ts
+function reverse(array) {
+	if (!Array.isArray(array)) return [];
+	const { length } = array;
+	if (length < 2) return array;
+	const half = Math.floor(length / 2);
+	for (let firstIndex = 0; firstIndex < half; firstIndex += 1) {
+		const temporaryItem = array[firstIndex];
+		const secondIndex = length - 1 - firstIndex;
+		array[firstIndex] = array[secondIndex];
+		array[secondIndex] = temporaryItem;
+	}
+	return array;
+}
+//#endregion
 //#region src/array/select.ts
 function select(array, ...parameters) {
 	return findValues("all", array, parameters, parameters.pop()).matched;
@@ -2253,6 +2317,30 @@ let memoizedCapitalize;
 let memoizedTitleCase;
 //#endregion
 //#region src/string/index.ts
+function dedent(value, ...values) {
+	let actual;
+	if (isTemplateStringsArray(value)) actual = interpolate(value, values);
+	else actual = value;
+	if (typeof actual !== "string") return "";
+	const lines = actual.split("\n");
+	const { length } = lines;
+	if (length === 1) return actual.trim();
+	const lastIndex = length - 1;
+	const lengths = [];
+	for (let index = 0; index < length; index += 1) {
+		const [, indentation] = /^(\s+)/.exec(lines[index]) ?? [];
+		if (indentation != null) lengths.push(indentation.length);
+	}
+	if (lengths.length === 0) return actual.trim();
+	const minimum = Math.min(...lengths);
+	const pattern = new RegExp(`^\\s{0,${minimum}}`);
+	let result = "";
+	for (let index = 0; index < length; index += 1) {
+		const line = lines[index];
+		result += line.replace(pattern, "") + (index === lastIndex ? "" : "\n");
+	}
+	return result.trim();
+}
 /**
 * Get a new UUID-string _(version 4)_
 * @returns UUID string
@@ -2271,6 +2359,12 @@ function getUuid() {
 		hex.substring(20, 32)
 	].join("-");
 }
+function interpolate(strings, values) {
+	const { length } = strings;
+	let interpolated = "";
+	for (let index = 0; index < length; index += 1) interpolated += `${strings[index]}${getString(values[index])}`;
+	return interpolated;
+}
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
 * @param value JSON string to parse
@@ -4706,4 +4800,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, first, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, 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, isTypedArray, join, kebabCase, last, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, dedent, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, first, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, 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, isTypedArray, join, kebabCase, last, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, 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, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/is.d.mts

@@ -26,13 +26,60 @@ declare function isInstanceOf<Instance>(constructor: Constructor<Instance>, valu
  * @returns `true` if the value is a `Key` _(`number` or `string`)_, otherwise `false`
  */
 declare function isKey(value: unknown): value is Key;
+/**
+ * Is the value not an array or a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not an array or a plain object, otherwise `false`
+ */
 declare function isNonArrayOrPlainObject<Value>(value: Value): value is Exclude<Value, ArrayOrPlainObject>;
+/**
+ * Is the value not a constructor function?
+ * @param value Value to check
+ * @returns `true` if the value is not a constructor function, otherwise `false`
+ */
 declare function isNonConstructor<Value>(value: Value): value is Exclude<Value, Constructor>;
+/**
+ * Is the value not an instance of the constructor?
+ * @param constructor Class constructor
+ * @param value Value to check
+ * @returns `true` if the value is not an instance of the constructor, otherwise `false`
+ */
 declare function isNonInstanceOf<Instance, Value>(constructor: Constructor<Instance>, value: Value): value is Exclude<Value, Instance>;
+/**
+ * Is the value not a key?
+ * @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>;
+/**
+ * Is the value not a number?
+ * @param value Value to check
+ * @returns `true` if the value is not a `number`, otherwise `false`
+ */
 declare function isNonNumber<Value>(value: Value): value is Exclude<Value, number>;
+/**
+ * Is the value not a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not a plain object, otherwise `false`
+ */
 declare function isNonPlainObject<Value>(value: Value): value is Exclude<Value, PlainObject>;
+/**
+ * Is the value not a primitive value?
+ * @param value Value to check
+ * @returns `true` if the value is not a primitive value, otherwise `false`
+ */
 declare function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Primitive>;
+/**
+ * Is the value not a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is not a `TemplateStringsArray`, otherwise `false`
+ */
+declare function isNonTemplateStringsArray<Value>(value: Value): value is Exclude<Value, TemplateStringsArray>;
+/**
+ * Is the value not a typed array?
+ * @param value Value to check
+ * @returns `true` if the value is not a typed array, otherwise `false`
+ */
 declare function isNonTypedArray<Value>(value: Value): value is Exclude<Value, TypedArray>;
 /**
  * Is the value a number?
@@ -52,6 +99,12 @@ declare function isPlainObject(value: unknown): value is PlainObject;
  * @returns `true` if the value matches, otherwise `false`
  */
 declare function isPrimitive(value: unknown): value is Primitive;
+/**
+ * Is the value a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+ */
+declare function isTemplateStringsArray(value: unknown): value is TemplateStringsArray;
 /**
  * Is the value a typed array?
  * @param value Value to check
@@ -59,4 +112,4 @@ declare function isPrimitive(value: unknown): value is Primitive;
  */
 declare function isTypedArray(value: unknown): value is TypedArray;
 //#endregion
-export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTemplateStringsArray, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTemplateStringsArray, isTypedArray };

package/dist/internal/is.mjs

@@ -32,27 +32,76 @@ function isInstanceOf(constructor, value) {
 function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
+/**
+* Is the value not an array or a plain object?
+* @param value Value to check
+* @returns `true` if the value is not an array or a plain object, otherwise `false`
+*/
 function isNonArrayOrPlainObject(value) {
 	return !isArrayOrPlainObject(value);
 }
+/**
+* Is the value not a constructor function?
+* @param value Value to check
+* @returns `true` if the value is not a constructor function, otherwise `false`
+*/
 function isNonConstructor(value) {
 	return !isConstructor(value);
 }
+/**
+* Is the value not an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is not an instance of the constructor, otherwise `false`
+*/
 function isNonInstanceOf(constructor, value) {
 	return !isInstanceOf(constructor, value);
 }
+/**
+* Is the value not a key?
+* @param value Value to check
+* @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
+*/
 function isNonKey(value) {
 	return !isKey(value);
 }
+/**
+* Is the value not a number?
+* @param value Value to check
+* @returns `true` if the value is not a `number`, otherwise `false`
+*/
 function isNonNumber(value) {
 	return !isNumber(value);
 }
+/**
+* Is the value not a plain object?
+* @param value Value to check
+* @returns `true` if the value is not a plain object, otherwise `false`
+*/
 function isNonPlainObject(value) {
 	return !isPlainObject(value);
 }
+/**
+* Is the value not a primitive value?
+* @param value Value to check
+* @returns `true` if the value is not a primitive value, otherwise `false`
+*/
 function isNonPrimitive(value) {
 	return !isPrimitive(value);
 }
+/**
+* Is the value not a template strings array?
+* @param value Value to check
+* @returns `true` if the value is not a `TemplateStringsArray`, otherwise `false`
+*/
+function isNonTemplateStringsArray(value) {
+	return !isTemplateStringsArray(value);
+}
+/**
+* Is the value not a typed array?
+* @param value Value to check
+* @returns `true` if the value is not a typed array, otherwise `false`
+*/
 function isNonTypedArray(value) {
 	return !isTypedArray(value);
 }
@@ -86,6 +135,14 @@ function isPrimitive(value) {
 	return type === "bigint" || type === "boolean" || type === "number" || type === "string" || type === "symbol";
 }
 /**
+* Is the value a template strings array?
+* @param value Value to check
+* @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+*/
+function isTemplateStringsArray(value) {
+	return Array.isArray(value) && Array.isArray(value.raw);
+}
+/**
 * Is the value a typed array?
 * @param value Value to check
 * @returns `true` if the value is a typed array, otherwise `false`
@@ -107,4 +164,4 @@ function isTypedArray(value) {
 	return isTypedArray.types.has(value?.constructor);
 }
 //#endregion
-export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTemplateStringsArray, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTemplateStringsArray, isTypedArray };

package/dist/string/index.d.mts

@@ -1,6 +1,8 @@
 import { getString, join, words } from "../internal/string.mjs";
 
 //#region src/string/index.d.ts
+declare function dedent(strings: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedent(value: string): string;
 /**
  * Get a new UUID-string _(version 4)_
  * @returns UUID string
@@ -28,4 +30,4 @@ declare function trim(value: string): string;
  */
 declare function truncate(value: string, length: number, suffix?: string): string;
 //#endregion
-export { getString, getUuid, join, parse, trim, truncate, words };
+export { dedent, getString, getUuid, join, parse, trim, truncate, words };

package/dist/string/index.mjs

@@ -1,5 +1,30 @@
+import { isTemplateStringsArray } from "../internal/is.mjs";
 import { getString, join, words } from "../internal/string.mjs";
 //#region src/string/index.ts
+function dedent(value, ...values) {
+	let actual;
+	if (isTemplateStringsArray(value)) actual = interpolate(value, values);
+	else actual = value;
+	if (typeof actual !== "string") return "";
+	const lines = actual.split("\n");
+	const { length } = lines;
+	if (length === 1) return actual.trim();
+	const lastIndex = length - 1;
+	const lengths = [];
+	for (let index = 0; index < length; index += 1) {
+		const [, indentation] = /^(\s+)/.exec(lines[index]) ?? [];
+		if (indentation != null) lengths.push(indentation.length);
+	}
+	if (lengths.length === 0) return actual.trim();
+	const minimum = Math.min(...lengths);
+	const pattern = new RegExp(`^\\s{0,${minimum}}`);
+	let result = "";
+	for (let index = 0; index < length; index += 1) {
+		const line = lines[index];
+		result += line.replace(pattern, "") + (index === lastIndex ? "" : "\n");
+	}
+	return result.trim();
+}
 /**
 * Get a new UUID-string _(version 4)_
 * @returns UUID string
@@ -18,6 +43,12 @@ function getUuid() {
 		hex.substring(20, 32)
 	].join("-");
 }
+function interpolate(strings, values) {
+	const { length } = strings;
+	let interpolated = "";
+	for (let index = 0; index < length; index += 1) interpolated += `${strings[index]}${getString(values[index])}`;
+	return interpolated;
+}
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
 * @param value JSON string to parse
@@ -57,4 +88,4 @@ function truncate(value, length, suffix) {
 }
 const ZERO = "0";
 //#endregion
-export { getString, getUuid, join, parse, trim, truncate, words };
+export { dedent, getString, getUuid, join, parse, trim, truncate, words };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.177.0",
+	"version": "0.178.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"helper",
@@ -241,7 +241,7 @@
 		"watch": "npx vite build --watch"
 	},
 	"devDependencies": {
-		"@oxlint/plugins": "^1.59",
+		"@oxlint/plugins": "^1.60",
 		"@types/node": "^25.6",
 		"@vitest/coverage-istanbul": "^4.1",
 		"eslint": "^10.2",

package/src/array/index.ts

@@ -14,6 +14,7 @@ export * from './intersection';
 export * from './partition';
 export * from './position';
 export * from './push';
+export * from './reverse';
 export * from './select';
 export * from './single';
 export * from './slice';

package/src/array/reverse.ts

@@ -0,0 +1,23 @@
+export function reverse<Item>(array: Item[]): Item[] {
+	if (!Array.isArray(array)) {
+		return [];
+	}
+
+	const {length} = array;
+
+	if (length < 2) {
+		return array;
+	}
+
+	const half = Math.floor(length / 2);
+
+	for (let firstIndex = 0; firstIndex < half; firstIndex += 1) {
+		const temporaryItem = array[firstIndex];
+		const secondIndex = length - 1 - firstIndex;
+
+		array[firstIndex] = array[secondIndex];
+		array[secondIndex] = temporaryItem;
+	}
+
+	return array;
+}

package/src/internal/is.ts

@@ -118,6 +118,17 @@ export function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Pri
 	return !isPrimitive(value);
 }
 
+/**
+ * Is the value not a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is not a `TemplateStringsArray`, otherwise `false`
+ */
+export function isNonTemplateStringsArray<Value>(
+	value: Value,
+): value is Exclude<Value, TemplateStringsArray> {
+	return !isTemplateStringsArray(value);
+}
+
 /**
  * Is the value not a typed array?
  * @param value Value to check
@@ -180,6 +191,15 @@ export function isPrimitive(value: unknown): value is Primitive {
 	);
 }
 
+/**
+ * Is the value a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+ */
+export function isTemplateStringsArray(value: unknown): value is TemplateStringsArray {
+	return Array.isArray(value) && Array.isArray((value as unknown as TemplateStringsArray).raw);
+}
+
 /**
  * Is the value a typed array?
  * @param value Value to check

package/src/string/index.ts

@@ -1,5 +1,63 @@
+import {isTemplateStringsArray} from '../internal/is';
+import {getString} from '../internal/string';
+
 // #region Functions
 
+export function dedent(strings: TemplateStringsArray, ...values: unknown[]): string;
+
+export function dedent(value: string): string;
+
+export function dedent(value: string | TemplateStringsArray, ...values: unknown[]): string {
+	let actual: string;
+
+	if (isTemplateStringsArray(value)) {
+		actual = interpolate(value, values);
+	} else {
+		actual = value;
+	}
+
+	if (typeof actual !== 'string') {
+		return '';
+	}
+
+	const lines = actual.split('\n');
+	const {length} = lines;
+
+	if (length === 1) {
+		return actual.trim();
+	}
+
+	const lastIndex = length - 1;
+
+	const lengths: number[] = [];
+
+	for (let index = 0; index < length; index += 1) {
+		const [, indentation] = /^(\s+)/.exec(lines[index]) ?? [];
+
+		if (indentation != null) {
+			lengths.push(indentation.length);
+		}
+	}
+
+	if (lengths.length === 0) {
+		return actual.trim();
+	}
+
+	const minimum = Math.min(...lengths);
+
+	const pattern = new RegExp(`^\\s{0,${minimum}}`);
+
+	let result = '';
+
+	for (let index = 0; index < length; index += 1) {
+		const line = lines[index];
+
+		result += line.replace(pattern, '') + (index === lastIndex ? '' : '\n');
+	}
+
+	return result.trim();
+}
+
 /**
  * Get a new UUID-string _(version 4)_
  * @returns UUID string
@@ -24,6 +82,18 @@ export function getUuid(): string {
 	].join('-');
 }
 
+function interpolate(strings: TemplateStringsArray, values: unknown[]): string {
+	const {length} = strings;
+
+	let interpolated = '';
+
+	for (let index = 0; index < length; index += 1) {
+		interpolated += `${strings[index]}${getString(values[index])}`;
+	}
+
+	return interpolated;
+}
+
 /**
  * Parse a JSON string into its proper value _(or `undefined` if it fails)_
  * @param value JSON string to parse
@@ -78,6 +148,8 @@ export function truncate(value: string, length: number, suffix?: string): string
 	return `${value.slice(0, truncatedLength)}${actualSuffix}`;
 }
 
+// #endregion
+
 // #region Variables
 
 const ZERO = '0';
@@ -86,4 +158,8 @@ const ZERO = '0';
 
 // #endregion
 
+// #region Exports
+
 export {getString, join, words} from '../internal/string';
+
+// #endregion