@oscarpalmer/atoms 0.158.0 → 0.160.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-of.js

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

package/dist/array/index.js

@@ -12,6 +12,7 @@ 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";
@@ -21,4 +22,4 @@ 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, take, times, toSet, toggle, union, update };

package/dist/array/insert.js

@@ -1,5 +1,7 @@
 import { 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);
 }
+//#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";
+//#region src/array/push.ts
 /**
 * Push items into an array _(at the end)_
 * @param array Original array
@@ -8,4 +9,5 @@ import { insertValues } from "../internal/array/insert.js";
 function push(array, pushed) {
 	return insertValues("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;
@@ -57,4 +58,5 @@ function sort(array, first, second) {
 		return 0;
 	});
 }
+//#endregion
 export { sort };

package/dist/array/splice.js

@@ -1,5 +1,7 @@
 import { 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);
 }
+//#endregion
 export { splice };

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 };