@oscarpalmer/atoms 0.159.0 → 0.161.0

package/dist/array/difference.js

@@ -1,5 +1,7 @@
 import { COMPARE_SETS_DIFFERENCE, compareSets } from "../internal/array/sets.js";
+//#region src/array/difference.ts
 function difference(first, second, key) {
 	return compareSets(COMPARE_SETS_DIFFERENCE, first, second, key);
 }
+//#endregion
 export { difference };

package/dist/array/exists.js

@@ -1,6 +1,8 @@
 import { FIND_VALUE_INDEX, findValue } from "../internal/array/find.js";
+//#region src/array/exists.ts
 function exists(array, ...parameters) {
 	if (parameters.length === 1 && typeof parameters[0] !== "function") return Array.isArray(array) ? array.includes(parameters[0]) : false;
 	return findValue(FIND_VALUE_INDEX, array, parameters) > -1;
 }
+//#endregion
 export { exists };

package/dist/array/filter.js

@@ -1,4 +1,5 @@
 import { findValues } from "../internal/array/find.js";
+//#region src/array/filter.ts
 function filter(array, ...parameters) {
 	return findValues("all", array, parameters).matched;
 }
@@ -6,4 +7,5 @@ filter.remove = removeFiltered;
 function removeFiltered(array, ...parameters) {
 	return findValues("all", array, parameters).notMatched;
 }
+//#endregion
 export { filter };

package/dist/array/find.js

@@ -1,5 +1,7 @@
 import { FIND_VALUE_VALUE, findValue } from "../internal/array/find.js";
+//#region src/array/find.ts
 function find(array, ...parameters) {
 	return findValue(FIND_VALUE_VALUE, array, parameters);
 }
+//#endregion
 export { find };

package/dist/array/flatten.js

@@ -1,3 +1,4 @@
+//#region src/array/flatten.ts
 /**
 * Flatten an array _(using native `flat` and maximum depth)_
 * @param array Array to flatten
@@ -6,4 +7,5 @@
 function flatten(array) {
 	return Array.isArray(array) ? array.flat(Number.POSITIVE_INFINITY) : [];
 }
+//#endregion
 export { flatten };

package/dist/array/from.js

@@ -1,3 +1,4 @@
+//#region src/array/from.ts
 function range(first, second, third) {
 	const start = typeof second === "number" ? first : 0;
 	const end = typeof second === "number" ? second : first;
@@ -15,4 +16,5 @@ function times(length, value) {
 	for (let index = 0; index < length; index += 1) values.push(isFunction ? value(index) : value ?? index);
 	return values;
 }
+//#endregion
 export { range, times };

package/dist/array/get.js

@@ -1,4 +1,5 @@
 import { isPlainObject } from "../internal/is.js";
+//#region src/array/get.ts
 function getArray(value, indiced) {
 	if (Array.isArray(value)) return value;
 	if (value instanceof Map || value instanceof Set) return [...value.values()];
@@ -13,4 +14,5 @@ function getArray(value, indiced) {
 	}
 	return array;
 }
+//#endregion
 export { getArray };

package/dist/array/group-by.js

@@ -1,4 +1,5 @@
 import { groupValues } from "../internal/array/group.js";
+//#region src/array/group-by.ts
 function groupBy(array, first, second) {
 	return groupValues(array, first, second, false);
 }
@@ -6,4 +7,5 @@ groupBy.arrays = groupArraysBy;
 function groupArraysBy(array, first, second) {
 	return groupValues(array, first, second, true);
 }
+//#endregion
 export { groupBy };

package/dist/array/index.js

@@ -5,20 +5,22 @@ import { find } from "./find.js";
 import { flatten } from "./flatten.js";
 import { range, times } from "./from.js";
 import { getArray } from "./get.js";
-import { indexOf } from "./index-of.js";
 import { chunk } from "../internal/array/chunk.js";
 import { compact } from "../internal/array/compact.js";
+import { indexOf } from "../internal/array/index-of.js";
 import { shuffle } from "../internal/array/shuffle.js";
 import { insert } from "./insert.js";
 import { intersection } from "./intersection.js";
 import { partition } from "./partition.js";
+import { endsWithArray, getArrayPosition, includesArray, indexOfArray, startsWithArray } from "./position.js";
 import { push } from "./push.js";
 import { select } from "./select.js";
 import { drop, slice, take } from "./slice.js";
 import { sort } from "./sort.js";
 import { splice } from "./splice.js";
+import { swap } from "./swap.js";
 import { toSet } from "./to-set.js";
 import { toggle } from "./toggle.js";
 import { union } from "./union.js";
 import { update } from "./update.js";
-export { chunk, compact, difference, drop, exists, filter, find, flatten, getArray, indexOf, insert, intersection, partition, push, range, select, shuffle, slice, sort, splice, take, times, toSet, toggle, union, update };
+export { chunk, compact, difference, drop, endsWithArray, exists, filter, find, flatten, getArray, getArrayPosition, includesArray, indexOf, indexOfArray, insert, intersection, partition, push, range, select, shuffle, slice, sort, splice, startsWithArray, swap, take, times, toSet, toggle, union, update };

package/dist/array/insert.js

@@ -1,5 +1,7 @@
-import { insertValues } from "../internal/array/insert.js";
+import { INSERT_TYPE_INSERT, insertValues } from "../internal/array/insert.js";
+//#region src/array/insert.ts
 function insert(array, indexOrItems, items) {
-	return insertValues("insert", array, items == null ? indexOrItems : items, typeof indexOrItems === "number" ? indexOrItems : array?.length, 0);
+	return insertValues(INSERT_TYPE_INSERT, array, items == null ? indexOrItems : items, typeof indexOrItems === "number" ? indexOrItems : array?.length, 0);
 }
+//#endregion
 export { insert };

package/dist/array/intersection.js

@@ -1,5 +1,7 @@
 import { COMPARE_SETS_INTERSECTION, compareSets } from "../internal/array/sets.js";
+//#region src/array/intersection.ts
 function intersection(first, second, key) {
 	return compareSets(COMPARE_SETS_INTERSECTION, first, second, key);
 }
+//#endregion
 export { intersection };

package/dist/array/partition.js

@@ -1,6 +1,8 @@
 import { findValues } from "../internal/array/find.js";
+//#region src/array/partition.ts
 function partition(array, ...parameters) {
 	const { matched, notMatched } = findValues("all", array, parameters);
 	return [matched, notMatched];
 }
+//#endregion
 export { partition };

package/dist/array/position.js

@@ -0,0 +1,58 @@
+import { getArrayCallback } from "../internal/array/callbacks.js";
+//#region src/array/position.ts
+function endsWithArray(haystack, needle, key) {
+	return endings.has(getPosition(haystack, needle, key)[1]);
+}
+function getArrayPosition(haystack, needle, key) {
+	return getPosition(haystack, needle, key)[1];
+}
+function getName(start, haystack, needle) {
+	if (start === 0) return haystack === needle ? POSITION_SAME : POSITION_START;
+	return start + needle === haystack ? POSITION_END : POSITION_INSIDE;
+}
+function getPosition(haystack, needle, key) {
+	if (!Array.isArray(haystack) || !Array.isArray(needle)) return invalid;
+	const haystackLength = haystack.length;
+	const needleLength = needle.length;
+	if (haystackLength === 0 || needleLength === 0) return outside;
+	if (needleLength > haystackLength) return outside;
+	const callback = getArrayCallback(key);
+	const limit = haystackLength - needleLength + 1;
+	let needleValues = callback == null ? needle : needle.slice();
+	if (callback != null) for (let needleIndex = 0; needleIndex < needleLength; needleIndex += 1) needleValues[needleIndex] = callback(needle[needleIndex], needleIndex, needle);
+	for (let haystackIndex = 0; haystackIndex < limit; haystackIndex += 1) {
+		let haystackItem = haystack[haystackIndex];
+		let haystackValue = callback?.(haystackItem, haystackIndex, haystack) ?? haystackItem;
+		if (!Object.is(haystackValue, needleValues[0])) continue;
+		if (needleLength === 1) return [haystackIndex, getName(haystackIndex, haystackLength, needleLength)];
+		for (let needleIndex = 1; needleIndex < needleLength; needleIndex += 1) {
+			haystackItem = haystack[haystackIndex + needleIndex];
+			haystackValue = callback?.(haystackItem, haystackIndex + needleIndex, haystack) ?? haystackItem;
+			if (!Object.is(haystackValue, needleValues[needleIndex])) break;
+			if (needleIndex === needleLength - 1) return [haystackIndex, getName(haystackIndex, haystackLength, needleLength)];
+		}
+	}
+	return outside;
+}
+function includesArray(haystack, needle, key) {
+	return !outsides.has(getPosition(haystack, needle, key)[1]);
+}
+function indexOfArray(haystack, needle, key) {
+	return getPosition(haystack, needle, key)[0];
+}
+function startsWithArray(haystack, needle, key) {
+	return starts.has(getPosition(haystack, needle, key)[1]);
+}
+var POSITION_END = "end";
+var POSITION_INSIDE = "inside";
+var POSITION_INVALID = "invalid";
+var POSITION_OUTSIDE = "outside";
+var POSITION_SAME = "same";
+var POSITION_START = "start";
+var endings = new Set([POSITION_END, POSITION_SAME]);
+var invalid = [-1, POSITION_INVALID];
+var outside = [-1, POSITION_OUTSIDE];
+var outsides = new Set([POSITION_INVALID, POSITION_OUTSIDE]);
+var starts = new Set([POSITION_START, POSITION_SAME]);
+//#endregion
+export { endsWithArray, getArrayPosition, includesArray, indexOfArray, startsWithArray };

package/dist/array/push.js

@@ -1,4 +1,5 @@
-import { insertValues } from "../internal/array/insert.js";
+import { INSERT_TYPE_PUSH, insertValues } from "../internal/array/insert.js";
+//#region src/array/push.ts
 /**
 * Push items into an array _(at the end)_
 * @param array Original array
@@ -6,6 +7,7 @@ import { insertValues } from "../internal/array/insert.js";
 * @returns New length of the array
 */
 function push(array, pushed) {
-	return insertValues("push", array, pushed, array.length, 0);
+	return insertValues(INSERT_TYPE_PUSH, array, pushed, array.length, 0);
 }
+//#endregion
 export { push };

package/dist/array/select.js

@@ -1,5 +1,7 @@
 import { findValues } from "../internal/array/find.js";
+//#region src/array/select.ts
 function select(array, ...parameters) {
 	return findValues("all", array, parameters, parameters.pop()).matched;
 }
+//#endregion
 export { select };

package/dist/array/slice.js

@@ -1,4 +1,5 @@
 import { getArrayCallbacks } from "../internal/array/callbacks.js";
+//#region src/array/slice.ts
 function drop(array, first, second) {
 	return extract(EXTRACT_DROP, array, first, second);
 }
@@ -48,4 +49,5 @@ function take(array, first, second) {
 }
 var EXTRACT_DROP = "drop";
 var EXTRACT_TAKE = "take";
+//#endregion
 export { drop, slice, take };

package/dist/array/sort.js

@@ -1,5 +1,6 @@
 import { isPlainObject } from "../internal/is.js";
 import { compare } from "../internal/value/compare.js";
+//#region src/array/sort.ts
 function getCallback(value, key, forObject) {
 	if (key != null) return;
 	if (forObject && typeof value.value === "function") return value.value;
@@ -32,7 +33,7 @@ function getSorter(value, modifier) {
 function sort(array, first, second) {
 	if (!Array.isArray(array)) return [];
 	if (array.length < 2) return array;
-	const modifier = (first === true || second === true ? "desc" : "asc") === "asc" ? 1 : -1;
+	const modifier = (first === true || second === true ? "descending" : "ascending") === "ascending" ? 1 : -1;
 	const sorters = (Array.isArray(first) ? first : [first]).map((item) => getSorter(item, modifier)).filter((sorter) => sorter != null).filter((current, index, filtered) => filtered.findIndex((next) => next.identifier === current.identifier) === index);
 	const { length } = sorters;
 	if (length === 0) return array.sort((firstItem, secondItem) => compare(firstItem, secondItem) * modifier);
@@ -57,4 +58,7 @@ function sort(array, first, second) {
 		return 0;
 	});
 }
-export { sort };
+var SORT_DIRECTION_ASCENDING = "ascending";
+var SORT_DIRECTION_DESCENDING = "descending";
+//#endregion
+export { SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, sort };

package/dist/array/splice.js

@@ -1,5 +1,7 @@
-import { insertValues } from "../internal/array/insert.js";
+import { INSERT_TYPE_SPLICE, insertValues } from "../internal/array/insert.js";
+//#region src/array/splice.ts
 function splice(array, start, deleteCountOrItems, items) {
-	return insertValues("splice", array, typeof deleteCountOrItems === "number" ? items : deleteCountOrItems, start, typeof deleteCountOrItems === "number" ? deleteCountOrItems : 0);
+	return insertValues(INSERT_TYPE_SPLICE, array, typeof deleteCountOrItems === "number" ? items : deleteCountOrItems, start, typeof deleteCountOrItems === "number" ? deleteCountOrItems : 0);
 }
+//#endregion
 export { splice };

package/dist/array/swap.js

@@ -0,0 +1,56 @@
+import { getArrayCallback } from "../internal/array/callbacks.js";
+import { indexOf } from "../internal/array/index-of.js";
+import { indexOfArray } from "./position.js";
+//#region src/array/swap.ts
+function swap(array, first, second, third) {
+	if (!Array.isArray(array)) return [];
+	if (array.length === 0) return array;
+	if (Array.isArray(first) && Array.isArray(second)) return swapArrays(array, first, second, third);
+	return swapValues(array, first, second, third);
+}
+swap.indices = swapIndices;
+function swapArrays(array, from, to, key) {
+	if (from.length === 0 || to.length === 0) return array;
+	if (from.length === 1 && to.length === 1) return swapValues(array, from[0], to[0], key);
+	const fromIndex = indexOfArray(array, from, key);
+	const toIndex = indexOfArray(array, to, key);
+	if (fromIndex === -1 || toIndex === -1) return array;
+	const first = fromIndex < toIndex ? from : to;
+	const second = fromIndex < toIndex ? to : from;
+	const firstIndex = first === from ? fromIndex : toIndex;
+	const secondIndex = first === from ? toIndex : fromIndex;
+	const firstEnd = firstIndex + first.length - 1;
+	if (firstIndex <= secondIndex + second.length - 1 && firstEnd >= secondIndex) return array;
+	array.splice(firstIndex, first.length, ...second);
+	array.splice(secondIndex, second.length, ...first);
+	return array;
+}
+/**
+* Swap two indiced items in an array
+*
+* If either index is out of bounds, the array will be returned unchanged
+* @param array Array of items to swap
+* @param first First index _(can be negative to count from the end)_
+* @param second Second index _(can be negative to count from the end)_
+* @returns Original array with items swapped _(or unchanged if unable to swap)_
+*/
+function swapIndices(array, first, second) {
+	if (!Array.isArray(array) || array.length === 0) return [];
+	if (typeof first !== "number" || typeof second !== "number") return array;
+	const firstIndex = first < 0 ? array.length + first : first;
+	const secondIndex = second < 0 ? array.length + second : second;
+	if (firstIndex === secondIndex || firstIndex >= array.length || secondIndex >= array.length) return array;
+	const temp = array[firstIndex];
+	array[firstIndex] = array[secondIndex];
+	array[secondIndex] = temp;
+	return array;
+}
+function swapValues(array, from, to, key) {
+	const callback = getArrayCallback(key);
+	const first = callback == null ? array.indexOf(from) : indexOf(array, callback, callback(from, void 0, []));
+	const second = callback == null ? array.indexOf(to) : indexOf(array, callback, callback(to, void 0, []));
+	if (first === second || first === -1 || second === -1) return array;
+	return swapIndices(array, first, second);
+}
+//#endregion
+export { swap };

package/dist/array/to-map.js

@@ -1,4 +1,5 @@
 import { getArrayCallbacks } from "../internal/array/callbacks.js";
+//#region src/array/to-map.ts
 function getMapValues(array, first, second, arrays) {
 	if (!Array.isArray(array)) return /* @__PURE__ */ new Map();
 	const { length } = array;
@@ -23,4 +24,5 @@ toMap.arrays = toMapArrays;
 function toMapArrays(array, first, second) {
 	return getMapValues(array, first, second, true);
 }
+//#endregion
 export { toMap };

package/dist/array/to-record.js

@@ -1,4 +1,5 @@
 import { groupValues } from "../internal/array/group.js";
+//#region src/array/to-record.ts
 function toRecord(array, first, second) {
 	return groupValues(array, first, second, false);
 }
@@ -6,4 +7,5 @@ toRecord.arrays = toRecordArrays;
 function toRecordArrays(array, first, second) {
 	return groupValues(array, first, second, true);
 }
+//#endregion
 export { toRecord };

package/dist/array/to-set.js

@@ -1,4 +1,5 @@
 import { getArrayCallbacks } from "../internal/array/callbacks.js";
+//#region src/array/to-set.ts
 function toSet(array, value) {
 	if (!Array.isArray(array)) return /* @__PURE__ */ new Set();
 	const callbacks = getArrayCallbacks(void 0, void 0, value);
@@ -8,4 +9,5 @@ function toSet(array, value) {
 	for (let index = 0; index < length; index += 1) set.add(callbacks.value(array[index], index, array));
 	return set;
 }
+//#endregion
 export { toSet };

package/dist/array/toggle.js

@@ -1,5 +1,7 @@
 import { updateInArray } from "../internal/array/update.js";
+//#region src/array/toggle.ts
 function toggle(array, values, key) {
 	return updateInArray(array, values, key, false);
 }
+//#endregion
 export { toggle };

package/dist/array/union.js

@@ -1,5 +1,7 @@
 import { COMPARE_SETS_UNION, compareSets } from "../internal/array/sets.js";
+//#region src/array/union.ts
 function union(first, second, key) {
 	return compareSets(COMPARE_SETS_UNION, first, second, key);
 }
+//#endregion
 export { union };

package/dist/array/unique.js

@@ -1,6 +1,8 @@
 import { FIND_VALUES_UNIQUE, findValues } from "../internal/array/find.js";
+//#region src/array/unique.ts
 function unique(array, key) {
 	if (!Array.isArray(array)) return [];
 	return array.length > 1 ? findValues(FIND_VALUES_UNIQUE, array, [key, void 0]).matched : array;
 }
+//#endregion
 export { unique };

package/dist/array/update.js

@@ -1,5 +1,7 @@
 import { updateInArray } from "../internal/array/update.js";
+//#region src/array/update.ts
 function update(array, values, key) {
 	return updateInArray(array, values, key, true);
 }
+//#endregion
 export { update };