@oscarpalmer/atoms 0.13.0 → 0.15.0

package/dist/js/array.js

@@ -0,0 +1,111 @@
+// src/js/number.ts
+function getNumber(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "symbol") {
+    return NaN;
+  }
+  let parsed = value?.valueOf?.() ?? value;
+  if (typeof parsed === "object") {
+    parsed = parsed?.toString() ?? parsed;
+  }
+  if (typeof parsed !== "string") {
+    return parsed == null ? NaN : typeof parsed === "number" ? parsed : +parsed;
+  }
+  if (/^\s*0+\s*$/.test(parsed)) {
+    return 0;
+  }
+  const trimmed = parsed.trim();
+  if (trimmed.length === 0) {
+    return NaN;
+  }
+  const isBinary = /^0b[01]+$/i.test(trimmed);
+  if (isBinary || /^0o[0-7]+$/i.test(trimmed)) {
+    return parseInt(trimmed.slice(2), isBinary ? 2 : 8);
+  }
+  return +(/^0x[0-9a-f]+$/i.test(trimmed) ? trimmed : trimmed.replace(/_/g, ""));
+}
+
+// src/js/array.ts
+var _getCallback = function(value) {
+  if (typeof value === "function") {
+    return value;
+  }
+  const isString = typeof value === "string";
+  if (!isString && typeof value !== "number") {
+    return;
+  }
+  return isString && value.includes(".") ? undefined : (item) => item[value];
+};
+function chunk(array, size) {
+  const chunks = [];
+  const chunkSize = getNumber(size);
+  let remaining = Number(array.length);
+  while (remaining > 0) {
+    chunks.push(array.splice(0, chunkSize));
+    remaining -= chunkSize;
+  }
+  return chunks;
+}
+function exists(array, value, key) {
+  const callback = _getCallback(key);
+  if (callback === undefined) {
+    return array.indexOf(value) > -1;
+  }
+  const needle = typeof value === "object" && value !== null ? callback(value) : value;
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    if (callback(array[index]) === needle) {
+      return true;
+    }
+  }
+  return false;
+}
+function groupBy(array, key) {
+  const keyCallback = _getCallback(key);
+  if (keyCallback === undefined) {
+    return {};
+  }
+  const grouped = {};
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback(item);
+    if (value in grouped) {
+      grouped[value].push(item);
+    } else {
+      grouped[value] = [item];
+    }
+  }
+  return grouped;
+}
+function unique(array, key) {
+  const keyCallback = _getCallback(key);
+  const { length } = array;
+  if (keyCallback === undefined && length >= 100) {
+    return Array.from(new Set(array));
+  }
+  const result = [];
+  const values = keyCallback === undefined ? result : [];
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback?.(item) ?? item;
+    if (values.indexOf(value) === -1) {
+      if (values !== result) {
+        values.push(value);
+      }
+      result.push(item);
+    }
+  }
+  return result;
+}
+export {
+  unique,
+  groupBy,
+  exists,
+  chunk
+};

package/dist/js/array.mjs

@@ -0,0 +1,83 @@
+// src/js/array.ts
+import {getNumber} from "./number";
+var _getCallback = function(value) {
+  if (typeof value === "function") {
+    return value;
+  }
+  const isString = typeof value === "string";
+  if (!isString && typeof value !== "number") {
+    return;
+  }
+  return isString && value.includes(".") ? undefined : (item) => item[value];
+};
+function chunk(array, size) {
+  const chunks = [];
+  const chunkSize = getNumber(size);
+  let remaining = Number(array.length);
+  while (remaining > 0) {
+    chunks.push(array.splice(0, chunkSize));
+    remaining -= chunkSize;
+  }
+  return chunks;
+}
+function exists(array, value, key) {
+  const callback = _getCallback(key);
+  if (callback === undefined) {
+    return array.indexOf(value) > -1;
+  }
+  const needle = typeof value === "object" && value !== null ? callback(value) : value;
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    if (callback(array[index]) === needle) {
+      return true;
+    }
+  }
+  return false;
+}
+function groupBy(array, key) {
+  const keyCallback = _getCallback(key);
+  if (keyCallback === undefined) {
+    return {};
+  }
+  const grouped = {};
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback(item);
+    if (value in grouped) {
+      grouped[value].push(item);
+    } else {
+      grouped[value] = [item];
+    }
+  }
+  return grouped;
+}
+function unique(array, key) {
+  const keyCallback = _getCallback(key);
+  const { length } = array;
+  if (keyCallback === undefined && length >= 100) {
+    return Array.from(new Set(array));
+  }
+  const result = [];
+  const values = keyCallback === undefined ? result : [];
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback?.(item) ?? item;
+    if (values.indexOf(value) === -1) {
+      if (values !== result) {
+        values.push(value);
+      }
+      result.push(item);
+    }
+  }
+  return result;
+}
+export {
+  unique,
+  groupBy,
+  exists,
+  chunk
+};

package/dist/js/element/focusable.js

@@ -18,7 +18,10 @@ var _getValidElements = function(type, parent, filters) {
   }
   const indiced = [];
   const zeroed = [];
-  for (const item of items) {
+  const { length } = items;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = items[index];
     if (item.tabIndex === 0) {
       zeroed.push(item.element);
     } else {
@@ -44,7 +47,10 @@ var _isDisabledFromFieldset = function(element) {
   while (parent !== null) {
     if (parent instanceof HTMLFieldSetElement && parent.disabled) {
       const children = Array.from(parent.children);
-      for (const child of children) {
+      const { length } = children;
+      let index = 0;
+      for (;index < length; index += 1) {
+        const child = children[index];
         if (child instanceof HTMLLegendElement) {
           return parent.matches("fieldset[disabled] *") ? true : !child.contains(element);
         }

package/dist/js/element/focusable.mjs

@@ -18,7 +18,10 @@ var _getValidElements = function(type, parent, filters) {
   }
   const indiced = [];
   const zeroed = [];
-  for (const item of items) {
+  const { length } = items;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = items[index];
     if (item.tabIndex === 0) {
       zeroed.push(item.element);
     } else {
@@ -44,7 +47,10 @@ var _isDisabledFromFieldset = function(element) {
   while (parent !== null) {
     if (parent instanceof HTMLFieldSetElement && parent.disabled) {
       const children = Array.from(parent.children);
-      for (const child of children) {
+      const { length } = children;
+      let index = 0;
+      for (;index < length; index += 1) {
+        const child = children[index];
         if (child instanceof HTMLLegendElement) {
           return parent.matches("fieldset[disabled] *") ? true : !child.contains(element);
         }

package/dist/js/element/index.js

@@ -1,15 +1,23 @@
 // src/js/element/index.ts
+function findElement(selector, context) {
+  return findElements(selector, context)[0];
+}
 function findElements(selector, context) {
   const contexts = context === undefined ? [document] : findElements(context);
   const elements = [];
   if (typeof selector === "string") {
-    for (const context2 of contexts) {
-      elements.push(...Array.from(context2.querySelectorAll(selector) ?? []));
+    const { length: length2 } = contexts;
+    let index2 = 0;
+    for (;index2 < length2; index2 += 1) {
+      elements.push(...Array.from(contexts[index2].querySelectorAll(selector) ?? []));
     }
     return elements;
   }
   const nodes = Array.isArray(selector) || selector instanceof NodeList ? selector : [selector];
-  for (const node of nodes) {
+  const { length } = nodes;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const node = nodes[index];
     if (node instanceof Element && contexts.some((context2) => context2.contains(node))) {
       elements.push(node);
     }
@@ -56,5 +64,8 @@ export {
   getTextDirection,
   getElementUnderPointer,
   findParentElement,
-  findElements
+  findElements,
+  findElement,
+  findElements as $$,
+  findElement as $
 };

package/dist/js/element/index.mjs

@@ -1,15 +1,23 @@
 // src/js/element/index.ts
+function findElement(selector, context) {
+  return findElements(selector, context)[0];
+}
 function findElements(selector, context) {
   const contexts = context === undefined ? [document] : findElements(context);
   const elements = [];
   if (typeof selector === "string") {
-    for (const context2 of contexts) {
-      elements.push(...Array.from(context2.querySelectorAll(selector) ?? []));
+    const { length: length2 } = contexts;
+    let index2 = 0;
+    for (;index2 < length2; index2 += 1) {
+      elements.push(...Array.from(contexts[index2].querySelectorAll(selector) ?? []));
     }
     return elements;
   }
   const nodes = Array.isArray(selector) || selector instanceof NodeList ? selector : [selector];
-  for (const node of nodes) {
+  const { length } = nodes;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const node = nodes[index];
     if (node instanceof Element && contexts.some((context2) => context2.contains(node))) {
       elements.push(node);
     }
@@ -52,9 +60,13 @@ function getTextDirection(element) {
   }
   return getComputedStyle?.(element)?.direction === "rtl" ? "rtl" : "ltr";
 }
+import {findElement as findElement2, findElements as findElements2} from ".";
 export {
   getTextDirection,
   getElementUnderPointer,
   findParentElement,
-  findElements
+  findElements,
+  findElement,
+  findElements2 as $$,
+  findElement2 as $
 };

package/dist/js/event.js

@@ -1,5 +1,5 @@
 // src/js/event.ts
-function getEventPosition(event) {
+function getPosition(event) {
   let x;
   let y;
   if (event instanceof MouseEvent) {
@@ -12,5 +12,5 @@ function getEventPosition(event) {
   return typeof x === "number" && typeof y === "number" ? { x, y } : undefined;
 }
 export {
-  getEventPosition
+  getPosition
 };

package/dist/js/event.mjs

@@ -1,5 +1,5 @@
 // src/js/event.ts
-function getEventPosition(event) {
+function getPosition(event) {
   let x;
   let y;
   if (event instanceof MouseEvent) {
@@ -12,5 +12,5 @@ function getEventPosition(event) {
   return typeof x === "number" && typeof y === "number" ? { x, y } : undefined;
 }
 export {
-  getEventPosition
+  getPosition
 };

package/dist/js/index.js

@@ -1,15 +1,138 @@
+// src/js/number.ts
+function clamp(value, min, max, loop) {
+  const maxNumber = getNumber(max);
+  const minNumber = getNumber(min);
+  const valueNumber = getNumber(value);
+  const shouldLoop = loop === true;
+  if (valueNumber < minNumber) {
+    return shouldLoop ? maxNumber : minNumber;
+  }
+  return valueNumber > maxNumber ? shouldLoop ? minNumber : maxNumber : valueNumber;
+}
+function getNumber(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "symbol") {
+    return NaN;
+  }
+  let parsed = value?.valueOf?.() ?? value;
+  if (typeof parsed === "object") {
+    parsed = parsed?.toString() ?? parsed;
+  }
+  if (typeof parsed !== "string") {
+    return parsed == null ? NaN : typeof parsed === "number" ? parsed : +parsed;
+  }
+  if (/^\s*0+\s*$/.test(parsed)) {
+    return 0;
+  }
+  const trimmed = parsed.trim();
+  if (trimmed.length === 0) {
+    return NaN;
+  }
+  const isBinary = /^0b[01]+$/i.test(trimmed);
+  if (isBinary || /^0o[0-7]+$/i.test(trimmed)) {
+    return parseInt(trimmed.slice(2), isBinary ? 2 : 8);
+  }
+  return +(/^0x[0-9a-f]+$/i.test(trimmed) ? trimmed : trimmed.replace(/_/g, ""));
+}
+
+// src/js/array.ts
+var _getCallback = function(value) {
+  if (typeof value === "function") {
+    return value;
+  }
+  const isString = typeof value === "string";
+  if (!isString && typeof value !== "number") {
+    return;
+  }
+  return isString && value.includes(".") ? undefined : (item) => item[value];
+};
+function chunk(array, size) {
+  const chunks = [];
+  const chunkSize = getNumber(size);
+  let remaining = Number(array.length);
+  while (remaining > 0) {
+    chunks.push(array.splice(0, chunkSize));
+    remaining -= chunkSize;
+  }
+  return chunks;
+}
+function exists(array, value, key) {
+  const callback = _getCallback(key);
+  if (callback === undefined) {
+    return array.indexOf(value) > -1;
+  }
+  const needle = typeof value === "object" && value !== null ? callback(value) : value;
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    if (callback(array[index]) === needle) {
+      return true;
+    }
+  }
+  return false;
+}
+function groupBy(array, key) {
+  const keyCallback = _getCallback(key);
+  if (keyCallback === undefined) {
+    return {};
+  }
+  const grouped = {};
+  const { length } = array;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback(item);
+    if (value in grouped) {
+      grouped[value].push(item);
+    } else {
+      grouped[value] = [item];
+    }
+  }
+  return grouped;
+}
+function unique(array, key) {
+  const keyCallback = _getCallback(key);
+  const { length } = array;
+  if (keyCallback === undefined && length >= 100) {
+    return Array.from(new Set(array));
+  }
+  const result = [];
+  const values = keyCallback === undefined ? result : [];
+  let index = 0;
+  for (;index < length; index += 1) {
+    const item = array[index];
+    const value = keyCallback?.(item) ?? item;
+    if (values.indexOf(value) === -1) {
+      if (values !== result) {
+        values.push(value);
+      }
+      result.push(item);
+    }
+  }
+  return result;
+}
 // src/js/element/index.ts
+function findElement(selector, context) {
+  return findElements(selector, context)[0];
+}
 function findElements(selector, context) {
   const contexts = context === undefined ? [document] : findElements(context);
   const elements = [];
   if (typeof selector === "string") {
-    for (const context2 of contexts) {
-      elements.push(...Array.from(context2.querySelectorAll(selector) ?? []));
+    const { length: length2 } = contexts;
+    let index2 = 0;
+    for (;index2 < length2; index2 += 1) {
+      elements.push(...Array.from(contexts[index2].querySelectorAll(selector) ?? []));
     }
     return elements;
   }
   const nodes = Array.isArray(selector) || selector instanceof NodeList ? selector : [selector];
-  for (const node of nodes) {
+  const { length } = nodes;
+  let index = 0;
+  for (;index < length; index += 1) {
+    const node = nodes[index];
     if (node instanceof Element && contexts.some((context2) => context2.contains(node))) {
       elements.push(node);
     }
@@ -53,7 +176,7 @@ function getTextDirection(element) {
   return getComputedStyle?.(element)?.direction === "rtl" ? "rtl" : "ltr";
 }
 // src/js/event.ts
-function getEventPosition(event) {
+function getPosition(event) {
   let x;
   let y;
   if (event instanceof MouseEvent) {
@@ -65,37 +188,6 @@ function getEventPosition(event) {
   }
   return typeof x === "number" && typeof y === "number" ? { x, y } : undefined;
 }
-// src/js/number.ts
-function clampNumber(value, min, max) {
-  return Math.min(Math.max(getNumber(value), getNumber(min)), getNumber(max));
-}
-function getNumber(value) {
-  if (typeof value === "number") {
-    return value;
-  }
-  if (typeof value === "symbol") {
-    return NaN;
-  }
-  let parsed = value?.valueOf?.() ?? value;
-  if (typeof parsed === "object") {
-    parsed = parsed?.toString() ?? parsed;
-  }
-  if (typeof parsed !== "string") {
-    return parsed == null ? NaN : typeof parsed === "number" ? parsed : +parsed;
-  }
-  if (/^\s*0+\s*$/.test(parsed)) {
-    return 0;
-  }
-  const trimmed = parsed.trim();
-  if (trimmed.length === 0) {
-    return NaN;
-  }
-  const isBinary = /^0b[01]+$/i.test(trimmed);
-  if (isBinary || /^0o[0-7]+$/i.test(trimmed)) {
-    return parseInt(trimmed.slice(2), isBinary ? 2 : 8);
-  }
-  return +(/^0x[0-9a-f]+$/i.test(trimmed) ? trimmed : trimmed.replace(/_/g, ""));
-}
 // src/js/string.ts
 function createUuid() {
   return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (substring) => (substring ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> substring / 4).toString(16));
@@ -194,10 +286,7 @@ var _getValue = function(data, key) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
     return;
   }
-  if (data instanceof Map) {
-    return data.get(key);
-  }
-  return data[key];
+  return data instanceof Map ? data.get(key) : data[key];
 };
 var _setValue = function(data, key, value) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
@@ -214,9 +303,11 @@ function getValue(data, key) {
     return;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let value = data;
-  for (const part of parts) {
-    value = _getValue(value, part);
+  for (;index < length; index += 1) {
+    value = _getValue(value, parts[index]);
     if (value == null) {
       break;
     }
@@ -237,8 +328,11 @@ function setValue(data, key, value) {
     return data;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let target = data;
-  for (const part of parts) {
+  for (;index < length; index += 1) {
+    const part = parts[index];
     if (parts.indexOf(part) === parts.length - 1) {
       _setValue(target, part, value);
       break;
@@ -254,21 +348,28 @@ function setValue(data, key, value) {
 }
 export {
   wait,
+  unique,
   setValue,
   repeat,
   isObject,
   isNullableOrWhitespace,
   isNullable,
   isArrayOrObject,
+  groupBy,
   getValue,
   getTextDirection,
   getString,
+  getPosition,
   getNumber,
-  getEventPosition,
   getElementUnderPointer,
   findParentElement,
   findElements,
+  findElement,
+  exists,
   createUuid,
-  clampNumber,
-  Timer
+  clamp,
+  chunk,
+  Timer,
+  findElements as $$,
+  findElement as $
 };

package/dist/js/index.mjs

@@ -1,4 +1,5 @@
 // src/js/index.ts
+export * from "./array";
 export * from "./element";
 export * from "./event";
 export * from "./number";

package/dist/js/number.js

@@ -1,6 +1,13 @@
 // src/js/number.ts
-function clampNumber(value, min, max) {
-  return Math.min(Math.max(getNumber(value), getNumber(min)), getNumber(max));
+function clamp(value, min, max, loop) {
+  const maxNumber = getNumber(max);
+  const minNumber = getNumber(min);
+  const valueNumber = getNumber(value);
+  const shouldLoop = loop === true;
+  if (valueNumber < minNumber) {
+    return shouldLoop ? maxNumber : minNumber;
+  }
+  return valueNumber > maxNumber ? shouldLoop ? minNumber : maxNumber : valueNumber;
 }
 function getNumber(value) {
   if (typeof value === "number") {
@@ -31,5 +38,5 @@ function getNumber(value) {
 }
 export {
   getNumber,
-  clampNumber
+  clamp
 };

package/dist/js/number.mjs

@@ -1,6 +1,13 @@
 // src/js/number.ts
-function clampNumber(value, min, max) {
-  return Math.min(Math.max(getNumber(value), getNumber(min)), getNumber(max));
+function clamp(value, min, max, loop) {
+  const maxNumber = getNumber(max);
+  const minNumber = getNumber(min);
+  const valueNumber = getNumber(value);
+  const shouldLoop = loop === true;
+  if (valueNumber < minNumber) {
+    return shouldLoop ? maxNumber : minNumber;
+  }
+  return valueNumber > maxNumber ? shouldLoop ? minNumber : maxNumber : valueNumber;
 }
 function getNumber(value) {
   if (typeof value === "number") {
@@ -31,5 +38,5 @@ function getNumber(value) {
 }
 export {
   getNumber,
-  clampNumber
+  clamp
 };

package/dist/js/value.js

@@ -11,10 +11,7 @@ var _getValue = function(data, key) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
     return;
   }
-  if (data instanceof Map) {
-    return data.get(key);
-  }
-  return data[key];
+  return data instanceof Map ? data.get(key) : data[key];
 };
 var _setValue = function(data, key, value) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
@@ -31,9 +28,11 @@ function getValue(data, key) {
     return;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let value = data;
-  for (const part of parts) {
-    value = _getValue(value, part);
+  for (;index < length; index += 1) {
+    value = _getValue(value, parts[index]);
     if (value == null) {
       break;
     }
@@ -54,8 +53,11 @@ function setValue(data, key, value) {
     return data;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let target = data;
-  for (const part of parts) {
+  for (;index < length; index += 1) {
+    const part = parts[index];
     if (parts.indexOf(part) === parts.length - 1) {
       _setValue(target, part, value);
       break;

package/dist/js/value.mjs

@@ -4,10 +4,7 @@ var _getValue = function(data, key) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
     return;
   }
-  if (data instanceof Map) {
-    return data.get(key);
-  }
-  return data[key];
+  return data instanceof Map ? data.get(key) : data[key];
 };
 var _setValue = function(data, key, value) {
   if (typeof data !== "object" || data === null || /^(__proto__|constructor|prototype)$/i.test(key)) {
@@ -24,9 +21,11 @@ function getValue(data, key) {
     return;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let value = data;
-  for (const part of parts) {
-    value = _getValue(value, part);
+  for (;index < length; index += 1) {
+    value = _getValue(value, parts[index]);
     if (value == null) {
       break;
     }
@@ -47,8 +46,11 @@ function setValue(data, key, value) {
     return data;
   }
   const parts = getString(key).split(".");
+  const { length } = parts;
+  let index = 0;
   let target = data;
-  for (const part of parts) {
+  for (;index < length; index += 1) {
+    const part = parts[index];
     if (parts.indexOf(part) === parts.length - 1) {
       _setValue(target, part, value);
       break;

package/package.json

@@ -18,6 +18,12 @@
 			"require": "./dist/js/index.js",
 			"types": "./types/index.d.ts"
 		},
+		"./array": {
+			"bun": "./src/js/array.ts",
+			"import": "./dist/js/array.mjs",
+			"require": "./dist/js/array.js",
+			"types": "./types/array.d.ts"
+		},
 		"./element": {
 			"bun": "./src/js/element/index.ts",
 			"import": "./dist/js/element/index.mjs",
@@ -93,5 +99,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.13.0"
+	"version": "0.15.0"
 }

package/src/js/array.ts

@@ -0,0 +1,144 @@
+import {getNumber} from './number';
+import {Key} from './value';
+
+type KeyCallback<T> = (item: T) => Key;
+
+function _getCallback<T>(
+	value: Key | KeyCallback<T> | undefined,
+): KeyCallback<T> | undefined {
+	if (typeof value === 'function') {
+		return value;
+	}
+
+	const isString = typeof value === 'string';
+
+	if (!isString && typeof value !== 'number') {
+		return undefined;
+	}
+
+	return isString && value.includes('.')
+		? undefined
+		: (item: T): Key => item[value as never];
+}
+
+/**
+ * Chunks an array into smaller arrays of a specified size
+ */
+export function chunk<T>(array: T[], size: number): T[][] {
+	const chunks: T[][] = [];
+	const chunkSize = getNumber(size);
+
+	let remaining = Number(array.length);
+
+	while (remaining > 0) {
+		chunks.push(array.splice(0, chunkSize));
+
+		remaining -= chunkSize;
+	}
+
+	return chunks;
+}
+
+/**
+ * Does the value exist in the array?
+ * - `key` is optional and can be used to specify a key or callback for finding a key for comparisons
+ * - If `key` is not provided, the item itself is used for comparisons
+ */
+export function exists<T1, T2 = T1>(
+	array: T1[],
+	value: T2,
+	key?: Key | KeyCallback<T1>,
+): boolean {
+	const callback = _getCallback(key);
+
+	if (callback === undefined) {
+		return array.indexOf(value as never) > -1;
+	}
+
+	const needle =
+		typeof value === 'object' && value !== null
+			? callback(value as never)
+			: value;
+
+	const {length} = array;
+
+	let index = 0;
+
+	for (; index < length; index += 1) {
+		if (callback(array[index]) === needle) {
+			return true;
+		}
+	}
+
+	return false;
+}
+
+/**
+ * Groups an array of items using a key or callback
+ */
+export function groupBy<T>(
+	array: T[],
+	key: Key | ((item: T) => Key),
+): Record<Key, T[]> {
+	const keyCallback = _getCallback(key) as KeyCallback<T>;
+
+	if (keyCallback === undefined) {
+		return {};
+	}
+
+	const grouped: Record<Key, T[]> = {};
+
+	const {length} = array;
+
+	let index = 0;
+
+	for (; index < length; index += 1) {
+		const item = array[index];
+		const value = keyCallback(item);
+
+		if (value in grouped) {
+			grouped[value].push(item);
+		} else {
+			grouped[value] = [item];
+		}
+	}
+
+	return grouped;
+}
+
+/**
+ * - Returns a new array with unique items
+ * - `key` is optional and can be used to specify a key or callback for finding a key for uniqueness
+ * - If `key` is not provided, the item itself is used for comparisons
+ * - Inspired by Lodash :-)
+ */
+export function unique<T>(array: T[], key?: Key | ((item: T) => Key)): T[] {
+	const keyCallback = _getCallback(key);
+
+	const {length} = array;
+
+	if (keyCallback === undefined && length >= 100) {
+		return Array.from(new Set(array));
+	}
+
+	const result: T[] = [];
+
+	const values: unknown[] = keyCallback === undefined ? result : [];
+
+	let index = 0;
+
+	for (; index < length; index += 1) {
+		const item = array[index];
+		const value = keyCallback?.(item) ?? item;
+
+		if (values.indexOf(value) === -1) {
+			if (values !== result) {
+				values.push(value);
+			}
+
+			result.push(item);
+		}
+	}
+
+	return result;
+}

package/src/js/element/focusable.ts

@@ -87,7 +87,13 @@ function _getValidElements(
 	const indiced: Array<Array<FocusableElement>> = [];
 	const zeroed: Array<FocusableElement> = [];
 
-	for (const item of items) {
+	const {length} = items;
+
+	let index = 0;
+
+	for (; index < length; index += 1) {
+		const item = items[index];
+
 		if (item.tabIndex === 0) {
 			zeroed.push(item.element);
 		} else {
@@ -128,7 +134,13 @@ function _isDisabledFromFieldset(element: FocusableElement): boolean {
 		if (parent instanceof HTMLFieldSetElement && parent.disabled) {
 			const children = Array.from(parent.children);
 
-			for (const child of children) {
+			const {length} = children;
+
+			let index = 0;
+
+			for (; index < length; index += 1) {
+				const child = children[index];
+
 				if (child instanceof HTMLLegendElement) {
 					return parent.matches('fieldset[disabled] *')
 						? true

package/src/js/element/index.ts

@@ -2,6 +2,17 @@ type Selector = string | Element | Element[] | NodeList;
 
 type TextDirection = 'ltr' | 'rtl';
 
+/**
+ * - Find the first element that matches the selector
+ * - `context` is optional and defaults to `document`
+ */
+export function findElement(
+	selector: Selector,
+	context?: Selector,
+): Element | undefined {
+	return findElements(selector, context)[0];
+}
+
 /**
  * - Find elements that match the selector
  * - `context` is optional and defaults to `document`
@@ -15,9 +26,13 @@ export function findElements(
 	const elements: Element[] = [];
 
 	if (typeof selector === 'string') {
-		for (const context of contexts) {
+		const {length} = contexts;
+
+		let index = 0;
+
+		for (; index < length; index += 1) {
 			elements.push(
-				...Array.from((context as Element).querySelectorAll(selector) ?? []),
+				...Array.from((contexts[index] as Element).querySelectorAll(selector) ?? []),
 			);
 		}
 
@@ -29,7 +44,13 @@ export function findElements(
 			? selector
 			: [selector];
 
-	for (const node of nodes) {
+	const {length} = nodes;
+
+	let index = 0;
+
+	for (; index < length; index += 1) {
+		const node = nodes[index];
+
 		if (
 			node instanceof Element &&
 			contexts.some(context => context.contains(node))
@@ -119,3 +140,5 @@ export function getTextDirection(element: Element): TextDirection {
 		getComputedStyle?.(element)?.direction === 'rtl' ? 'rtl' : 'ltr'
 	) as TextDirection;
 }
+
+export {findElement as $, findElements as $$} from '.';

package/src/js/event.ts

@@ -6,7 +6,7 @@ type Position = {
 /**
  * Get the X- and Y-coordinates from a pointer event
  */
-export function getEventPosition(
+export function getPosition(
 	event: MouseEvent | TouchEvent,
 ): Position | undefined {
 	let x: number | undefined;

package/src/js/index.ts

@@ -1,3 +1,4 @@
+export * from './array';
 export * from './element';
 export * from './event';
 export * from './number';

package/src/js/number.ts

@@ -1,9 +1,27 @@
-
 /**
- * Clamps a number between a minimum and maximum value
+ * - Clamps a number between a minimum and maximum value
+ * - If `loop` is `true`, when the value is less than the minimum, it will be clamped as the maximum, and vice versa
  */
-export function clampNumber(value: number, min: number, max: number): number {
-	return Math.min(Math.max(getNumber(value), getNumber(min)), getNumber(max));
+export function clamp(
+	value: number,
+	min: number,
+	max: number,
+	loop?: boolean,
+): number {
+	const maxNumber = getNumber(max);
+	const minNumber = getNumber(min);
+	const valueNumber = getNumber(value);
+	const shouldLoop = loop === true;
+
+	if (valueNumber < minNumber) {
+		return shouldLoop ? maxNumber : minNumber;
+	}
+
+	return valueNumber > maxNumber
+		? shouldLoop
+			? minNumber
+			: maxNumber
+		: valueNumber;
 }
 
 /**

package/src/js/value.ts

@@ -17,11 +17,7 @@ function _getValue(data: ValueObject, key: string): unknown {
 		return undefined;
 	}
 
-	if (data instanceof Map) {
-		return data.get(key as never);
-	}
-
-	return data[key as never];
+	return data instanceof Map ? data.get(key as never) : data[key as never];
 }
 
 /**
@@ -59,10 +55,13 @@ export function getValue(data: ValueObject, key: Key): unknown {
 
 	const parts = getString(key).split('.');
 
+	const {length} = parts;
+
+	let index = 0;
 	let value = data;
 
-	for (const part of parts) {
-		value = _getValue(value, part) as ValueObject;
+	for (; index < length; index += 1) {
+		value = _getValue(value, parts[index]) as ValueObject;
 
 		if (value == null) {
 			break;
@@ -99,11 +98,11 @@ export function isObject(value: unknown): value is GenericObject {
  * - If a part of the path does not exist, it will be created, either as an array or a generic object, depending on the key
  * - Returns the original object
  */
-export function setValue<Model extends ValueObject>(
-	data: Model,
+export function setValue<T extends ValueObject>(
+	data: T,
 	key: Key,
 	value: unknown,
-): Model {
+): T {
 	if (
 		typeof data !== 'object' ||
 		data === null ||
@@ -114,9 +113,14 @@ export function setValue<Model extends ValueObject>(
 
 	const parts = getString(key).split('.');
 
+	const {length} = parts;
+
+	let index = 0;
 	let target: ValueObject = data;
 
-	for (const part of parts) {
+	for (; index < length; index += 1) {
+		const part = parts[index];
+
 		if (parts.indexOf(part) === parts.length - 1) {
 			_setValue(target, part, value);
 

package/types/array.d.ts

@@ -0,0 +1,24 @@
+import { Key } from './value';
+type KeyCallback<T> = (item: T) => Key;
+/**
+ * Chunks an array into smaller arrays of a specified size
+ */
+export declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Does the value exist in the array?
+ * - `key` is optional and can be used to specify a key or callback for finding a key for comparisons
+ * - If `key` is not provided, the item itself is used for comparisons
+ */
+export declare function exists<T1, T2 = T1>(array: T1[], value: T2, key?: Key | KeyCallback<T1>): boolean;
+/**
+ * Groups an array of items using a key or callback
+ */
+export declare function groupBy<T>(array: T[], key: Key | ((item: T) => Key)): Record<Key, T[]>;
+/**
+ * - Returns a new array with unique items
+ * - `key` is optional and can be used to specify a key or callback for finding a key for uniqueness
+ * - If `key` is not provided, the item itself is used for comparisons
+ * - Inspired by Lodash :-)
+ */
+export declare function unique<T>(array: T[], key?: Key | ((item: T) => Key)): T[];
+export {};

package/types/element/index.d.ts

@@ -1,5 +1,10 @@
 type Selector = string | Element | Element[] | NodeList;
 type TextDirection = 'ltr' | 'rtl';
+/**
+ * - Find the first element that matches the selector
+ * - `context` is optional and defaults to `document`
+ */
+export declare function findElement(selector: Selector, context?: Selector): Element | undefined;
 /**
  * - Find elements that match the selector
  * - `context` is optional and defaults to `document`
@@ -21,4 +26,4 @@ export declare function getElementUnderPointer(skipIgnore?: boolean): Element |
  * Get the text direction of an element
  */
 export declare function getTextDirection(element: Element): TextDirection;
-export {};
+export { findElement as $, findElements as $$ } from '.';

package/types/event.d.ts

@@ -5,5 +5,5 @@ type Position = {
 /**
  * Get the X- and Y-coordinates from a pointer event
  */
-export declare function getEventPosition(event: MouseEvent | TouchEvent): Position | undefined;
+export declare function getPosition(event: MouseEvent | TouchEvent): Position | undefined;
 export {};

package/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './array';
 export * from './element';
 export * from './event';
 export * from './number';

package/types/number.d.ts

@@ -1,7 +1,8 @@
 /**
- * Clamps a number between a minimum and maximum value
+ * - Clamps a number between a minimum and maximum value
+ * - If `loop` is `true`, when the value is less than the minimum, it will be clamped as the maximum, and vice versa
  */
-export declare function clampNumber(value: number, min: number, max: number): number;
+export declare function clamp(value: number, min: number, max: number, loop?: boolean): number;
 /**
  * - Gets the number value from an unknown value
  * - Returns `NaN` if the value is `undefined`, `null`, or cannot be parsed

package/types/value.d.ts

@@ -26,4 +26,4 @@ export declare function isObject(value: unknown): value is GenericObject;
  * - If a part of the path does not exist, it will be created, either as an array or a generic object, depending on the key
  * - Returns the original object
  */
-export declare function setValue<Model extends ValueObject>(data: Model, key: Key, value: unknown): Model;
+export declare function setValue<T extends ValueObject>(data: T, key: Key, value: unknown): T;