@oscarpalmer/toretto 0.37.2 → 0.38.0

package/dist/attribute/get.js

@@ -3,6 +3,13 @@ import { isHTMLOrSVGElement } from "../internal/is.js";
 function getAttribute(element, name, parseValues) {
 	if (isHTMLOrSVGElement(element) && typeof name === "string") return getAttributeValue(element, name, parseValues !== false);
 }
+/**
+* Get specific attributes from an element
+* @param element Element to get attributes from
+* @param names Attribute names
+* @param parseData Parse data values? _(defaults to `true`)_
+* @returns Object of named attributes
+*/
 function getAttributes(element, names, parseData) {
 	const attributes = {};
 	if (!(isHTMLOrSVGElement(element) && Array.isArray(names))) return attributes;

package/dist/data.js

@@ -1,7 +1,8 @@
 import { EXPRESSION_DATA_PREFIX } from "./internal/get-value.js";
 import { isHTMLOrSVGElement } from "./internal/is.js";
 import { setElementValues, updateElementValue } from "./internal/element-value.js";
-import { kebabCase, parse } from "@oscarpalmer/atoms/string";
+import { parse } from "@oscarpalmer/atoms/string";
+import { kebabCase } from "@oscarpalmer/atoms/string/case";
 function getData(element, keys, parseValues) {
 	if (!isHTMLOrSVGElement(element)) return;
 	const shouldParse = parseValues !== false;

package/dist/event/index.js

@@ -29,6 +29,11 @@ function createEventOptions(options) {
 function dispatch(target, type, options) {
 	if (isEventTarget(target) && typeof type === "string") target.dispatchEvent(createEvent(type, options));
 }
+/**
+* Get the X- and Y-coordinates from a pointer event
+* @param event Pointer event
+* @returns X- and Y-coordinates
+*/
 function getPosition(event) {
 	let x;
 	let y;
@@ -44,6 +49,13 @@ function getPosition(event) {
 		y
 	} : void 0;
 }
+/**
+* Remove an event listener
+* @param target Event target
+* @param type Type of event
+* @param listener Event listener
+* @param options Options for event
+*/
 function off(target, type, listener, options) {
 	if (!isEventTarget(target) || typeof type !== "string" || typeof listener !== "function") return;
 	const extended = createEventOptions(options);

package/dist/find/index.js

@@ -40,6 +40,14 @@ function findElementOrElementsFromNodes(array, context, contexts) {
 function findElements(selector, context) {
 	return findElementOrElements(selector, context, false);
 }
+/**
+* Get the most specific element under the pointer
+*
+* - Ignores elements with `pointer-events: none` and `visibility: hidden`
+* - _(If `skipIgnore` is `true`, no elements are ignored)_
+* @param skipIgnore Skip ignored elements?
+* @returns Found element or `null`
+*/
 function getElementUnderPointer(skipIgnore) {
 	const elements = [...document.querySelectorAll(SUFFIX_HOVER)];
 	const { length } = elements;

package/dist/find/relative.js

@@ -34,6 +34,12 @@ function findRelatives(origin, selector, context) {
 	}
 	return distances.filter((found) => found.distance === minimum).map((found) => found.element);
 }
+/**
+* Get the distance between two elements _(i.e., the amount of nodes of between them)_
+* @param origin Origin element
+* @param target Target element
+* @returns Distance between elements, or `-1` if distance cannot be calculated
+*/
 function getDistance(origin, target) {
 	if (origin === target) return 0;
 	if (origin.parentElement === target || target.parentElement === origin) return 1;

package/dist/focusable.js

@@ -1,3 +1,8 @@
+/**
+* Get a list of focusable elements within a parent element
+* @param parent Parent element
+* @returns Focusable elements
+*/
 function getFocusable(parent) {
 	return getValidElements(parent, FILTERS_FOCUSABLE, false);
 }
@@ -7,6 +12,11 @@ function getItem(element, tabbable) {
 		tabIndex: tabbable ? getTabIndex(element) : TABINDEX_DEFAULT
 	};
 }
+/**
+* Get a list of tabbable elements within a parent element
+* @param parent Parent element
+* @returns Tabbable elements
+*/
 function getTabbable(parent) {
 	return getValidElements(parent, FILTERS_TABBABLE, true);
 }
@@ -61,6 +71,11 @@ function isDisabledFromFieldset(element) {
 function isEditable(element) {
 	return EXPRESSION_TRUEISH.test(element.getAttribute(ATTRIBUTE_CONTENTEDITABLE));
 }
+/**
+* Is the element focusable?
+* @param element Element to check
+* @returns `true` if focusable, otherwise `false`
+*/
 function isFocusable(element) {
 	return element instanceof Element ? isValidElement(element, FILTERS_FOCUSABLE, false) : false;
 }
@@ -91,6 +106,11 @@ function isNotTabbableRadio(item) {
 function isSummarised(item) {
 	return item.element instanceof HTMLDetailsElement && [...item.element.children].some((child) => EXPRESSION_SUMMARY.test(child.tagName));
 }
+/**
+* Is the element tabbable?
+* @param element Element to check
+* @returns `true` if tabbable, otherwise `false`
+*/
 function isTabbable(element) {
 	return element instanceof Element ? isValidElement(element, FILTERS_TABBABLE, true) : false;
 }

package/dist/html/index.js

@@ -54,6 +54,12 @@ html.remove = (template) => {
 	}
 	templates = updated;
 };
+/**
+* Sanitize one or more nodes, recursively
+* @param value Node or nodes to sanitize
+* @param options Sanitization options
+* @returns Sanitized nodes
+*/
 function sanitize(value) {
 	return sanitizeNodes(Array.isArray(value) ? value : [value], 0);
 }

package/dist/html/sanitize.js

@@ -7,6 +7,11 @@ function handleElement(element, depth) {
 	}
 	sanitizeAttributes(element, [...element.attributes]);
 }
+/**
+* Is the element clobbered?
+*
+* Thanks, DOMPurify _(https://github.com/cure53/DOMPurify)_
+*/
 function isClobbered(value) {
 	return value instanceof HTMLFormElement && (typeof value.nodeName !== "string" || typeof value.textContent !== "string" || typeof value.removeChild !== "function" || !(value.attributes instanceof NamedNodeMap) || typeof value.removeAttribute !== "function" || typeof value.setAttribute !== "function" || typeof value.namespaceURI !== "string" || typeof value.insertBefore !== "function" || typeof value.hasChildNodes !== "function");
 }

package/dist/index.js

@@ -7,6 +7,6 @@ import { findAncestor, findRelatives, getDistance } from "./find/relative.js";
 import { $ as findElement, $$ as findElements, getElementUnderPointer } from "./find/index.js";
 import { getFocusable, getTabbable, isFocusable, isTabbable } from "./focusable.js";
 import { html, sanitize } from "./html/index.js";
-import touch_default from "./touch.js";
+import supportsTouch from "./touch.js";
 import { getStyle, getStyles, getTextDirection, setStyle, setStyles, toggleStyles } from "./style.js";
-export { findElement as $, findElement, findElements as $$, findElements, dispatch, findAncestor, findRelatives, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setData, setStyle, setStyles, touch_default as supportsTouch, toggleStyles };
+export { findElement as $, findElement, findElements as $$, findElements, dispatch, findAncestor, findRelatives, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setData, setStyle, setStyles, supportsTouch, toggleStyles };

package/dist/internal/attribute.js

@@ -70,6 +70,9 @@ var EXPRESSION_SOURCE_NAME = /^src$/i;
 var EXPRESSION_SOURCE_VALUE = /^data:/i;
 var EXPRESSION_URI_VALUE = /^(?:(?:(?:f|ht)tps?|mailto|tel|callto|sms|cid|xmpp|matrix):|[^a-z]|[a-z+.-]+(?:[^a-z+.\-:]|$))/i;
 var EXPRESSION_WHITESPACE = /[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205F\u3000]/g;
+/**
+* List of boolean attributes
+*/
 const booleanAttributes = Object.freeze([
 	"async",
 	"autofocus",

package/dist/internal/get-value.js

@@ -1,4 +1,5 @@
-import { camelCase, kebabCase, parse } from "@oscarpalmer/atoms/string";
+import { parse } from "@oscarpalmer/atoms/string";
+import { camelCase, kebabCase } from "@oscarpalmer/atoms/string/case";
 function getBoolean(value, defaultValue) {
 	return typeof value === "boolean" ? value : defaultValue ?? false;
 }

package/dist/internal/is.js

@@ -1,6 +1,16 @@
+/**
+* Is the value an event target?
+* @param value Value to check
+* @returns `true` if it's an event target, otherwise `false`
+*/
 function isEventTarget(value) {
 	return typeof value === "object" && value != null && typeof value.addEventListener === "function" && typeof value.removeEventListener === "function" && typeof value.dispatchEvent === "function";
 }
+/**
+* Is the value an HTML or SVG element?
+* @param value Value to check
+* @returns `true` if it's an HTML or SVG element, otherwise `false`
+*/
 function isHTMLOrSVGElement(value) {
 	return value instanceof HTMLElement || value instanceof SVGElement;
 }

package/dist/is.js

@@ -1,4 +1,9 @@
 import { isEventTarget, isHTMLOrSVGElement } from "./internal/is.js";
+/**
+* Is the value a child node?
+* @param value Value to check
+* @returns `true` if it's a child node, otherwise `false`
+*/
 function isChildNode(value) {
 	return value instanceof Node && CHILD_NODE_TYPES.has(value.nodeType);
 }

package/dist/style.js

@@ -1,10 +1,24 @@
 import { getStyleValue } from "./internal/get-value.js";
 import { isHTMLOrSVGElement } from "./internal/is.js";
 import { setElementValues, updateElementValue } from "./internal/element-value.js";
+/**
+* Get a style from an element
+* @param element Element to get the style from
+* @param property Style name
+* @param computed Get the computed style? _(defaults to `false`)_
+* @returns Style value
+*/
 function getStyle(element, property, computed) {
 	if (!isHTMLOrSVGElement(element) || typeof property !== "string") return;
 	return getStyleValue(element, property, computed === true);
 }
+/**
+* Get styles from an element
+* @param element Element to get the styles from
+* @param properties Styles to get
+* @param computed Get the computed styles? _(defaults to `false`)_
+* @returns Style values
+*/
 function getStyles(element, properties, computed) {
 	const styles = {};
 	if (!(isHTMLOrSVGElement(element) && Array.isArray(properties))) return styles;
@@ -15,6 +29,12 @@ function getStyles(element, properties, computed) {
 	}
 	return styles;
 }
+/**
+* Get the text direction of an element
+* @param element Element to get the text direction from
+* @param computed Get the computed text direction? _(defaults to `false`)_
+* @returns Text direction
+*/
 function getTextDirection(element, computed) {
 	if (!(element instanceof Element)) return;
 	const direction = element.getAttribute(ATTRIBUTE_DIRECTION);
@@ -22,12 +42,29 @@ function getTextDirection(element, computed) {
 	const value = getStyleValue(element, "direction", computed === true);
 	return value === "rtl" ? value : "ltr";
 }
+/**
+* Set a style on an element
+* @param element Element to set the style on
+* @param property Style name
+* @param value Style value
+*/
 function setStyle(element, property, value) {
 	setElementValues(element, property, value, null, updateStyleProperty);
 }
+/**
+* Set styles on an element
+* @param element Element to set the styles on
+* @param styles Styles to set
+*/
 function setStyles(element, styles) {
 	setElementValues(element, styles, null, null, updateStyleProperty);
 }
+/**
+* Toggle styles for an element
+* @param element Element to style
+* @param styles Styles to be set or removed
+* @returns Style toggler
+*/
 function toggleStyles(element, styles) {
 	function toggle(set) {
 		hasSet = set;

package/dist/toretto.full.js

@@ -9,7 +9,10 @@ function getSupport() {
 	if (typeof navigator.msMaxTouchPoints === "number" && navigator.msMaxTouchPoints > 0) return true;
 	return false;
 }
-var touch_default = (() => {
+/**
+* Does the device support touch events?
+*/
+const supportsTouch = (() => {
 	let support = getSupport();
 	const instance = Object.create({
 		get() {
@@ -25,9 +28,19 @@ var touch_default = (() => {
 	} });
 	return instance;
 })();
+/**
+* Is the value a number?
+* @param value Value to check
+* @returns `true` if the value is a `number`, otherwise `false`
+*/
 function isNumber(value) {
 	return typeof value === "number" && !Number.isNaN(value);
 }
+/**
+* Is the value a plain object?
+* @param value Value to check
+* @returns `true` if the value is a plain object, otherwise `false`
+*/
 function isPlainObject(value) {
 	if (value === null || typeof value !== "object") return false;
 	if (Symbol.toStringTag in value || Symbol.iterator in value) return false;
@@ -45,6 +58,11 @@ function compact(array, strict) {
 	}
 	return compacted;
 }
+/**
+* Get the string value from any value
+* @param value Original value
+* @returns String representation of the value
+*/
 function getString(value) {
 	if (typeof value === "string") return value;
 	if (value == null) return "";
@@ -53,27 +71,54 @@ function getString(value) {
 	const asString = String(value.valueOf?.() ?? value);
 	return asString.startsWith("[object ") ? JSON.stringify(value) : asString;
 }
-function ignoreKey(key) {
-	return EXPRESSION_IGNORED.test(key);
-}
+/**
+* Join an array of values into a string
+* @param value Array of values
+* @param delimiter Delimiter to use between values
+* @returns Joined string
+*/
 function join(value, delimiter) {
 	return compact(value).map(getString).join(typeof delimiter === "string" ? delimiter : "");
 }
+/**
+* Split a string into words _(and other readable parts)_
+* @param value Original string
+* @returns Array of words found in the string
+*/
 function words(value) {
 	return typeof value === "string" ? value.match(EXPRESSION_WORDS) ?? [] : [];
 }
-var EXPRESSION_IGNORED = /(^|\.)(__proto__|constructor|prototype)(\.|$)/i;
 var EXPRESSION_WORDS = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
+/**
+* Is the value `undefined`, `null`, or a whitespace-only string?
+* @param value Value to check
+* @returns `true` if the value is nullable or a whitespace-only string, otherwise `false`
+*/
 function isNullableOrWhitespace(value) {
 	return value == null || EXPRESSION_WHITESPACE$1.test(getString(value));
 }
 var EXPRESSION_WHITESPACE$1 = /^\s*$/;
+/**
+* Is the value an event target?
+* @param value Value to check
+* @returns `true` if it's an event target, otherwise `false`
+*/
 function isEventTarget(value) {
 	return typeof value === "object" && value != null && typeof value.addEventListener === "function" && typeof value.removeEventListener === "function" && typeof value.dispatchEvent === "function";
 }
+/**
+* Is the value an HTML or SVG element?
+* @param value Value to check
+* @returns `true` if it's an HTML or SVG element, otherwise `false`
+*/
 function isHTMLOrSVGElement(value) {
 	return value instanceof HTMLElement || value instanceof SVGElement;
 }
+/**
+* Is the value a child node?
+* @param value Value to check
+* @returns `true` if it's a child node, otherwise `false`
+*/
 function isChildNode(value) {
 	return value instanceof Node && CHILD_NODE_TYPES.has(value.nodeType);
 }
@@ -186,6 +231,9 @@ const EXPRESSION_SOURCE_NAME = /^src$/i;
 const EXPRESSION_SOURCE_VALUE = /^data:/i;
 const EXPRESSION_URI_VALUE = /^(?:(?:(?:f|ht)tps?|mailto|tel|callto|sms|cid|xmpp|matrix):|[^a-z]|[a-z+.-]+(?:[^a-z+.\-:]|$))/i;
 const EXPRESSION_WHITESPACE = /[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205F\u3000]/g;
+/**
+* List of boolean attributes
+*/
 const booleanAttributes = Object.freeze([
 	"async",
 	"autofocus",
@@ -224,24 +272,27 @@ const elementEvents = {
 };
 const formElement = document.createElement("form");
 let textArea;
-function noop() {}
-function calculate() {
-	return new Promise((resolve) => {
-		const values = [];
-		let last;
-		function step(now) {
-			if (last != null) values.push(now - last);
-			last = now;
-			if (values.length >= TOTAL) resolve(values.sort().slice(TRIM_PART, -TRIM_PART).reduce((first, second) => first + second, 0) / (values.length - TRIM_TOTAL));
-			else requestAnimationFrame(step);
-		}
-		requestAnimationFrame(step);
-	});
+/**
+* Parse a JSON string into its proper value _(or `undefined` if it fails)_
+* @param value JSON string to parse
+* @param reviver Reviver function to transform the parsed values
+* @returns Parsed value or `undefined` if parsing fails
+*/
+function parse(value, reviver) {
+	try {
+		return JSON.parse(value, reviver);
+	} catch {
+		return;
+	}
 }
-var TOTAL = 10;
-var TRIM_PART = 2;
-var TRIM_TOTAL = 4;
-calculate().then((value) => {});
+/**
+* Clamp a number between a minimum and maximum value
+* @param value Value to clamp
+* @param minimum Minimum value
+* @param maximum Maximum value
+* @param loop If `true`, the value will loop around when smaller than the minimum or larger than the maximum _(defaults to `false`)_
+* @returns Clamped value
+*/
 function clamp(value, minimum, maximum, loop) {
 	if (![
 		value,
@@ -251,8 +302,27 @@ function clamp(value, minimum, maximum, loop) {
 	if (value < minimum) return loop === true ? maximum : minimum;
 	return value > maximum ? loop === true ? minimum : maximum : value;
 }
+function getSizedMaximum(first, second) {
+	let actual;
+	if (typeof first === "number") actual = first;
+	else actual = typeof second === "number" ? second : MAXIMUM_DEFAULT;
+	return clamp(actual, 1, MAXIMUM_ABSOLUTE);
+}
+var MAXIMUM_ABSOLUTE = 16777216;
+var MAXIMUM_DEFAULT = 1048576;
+/**
+* A Map with a maximum size
+*
+* Behavior is similar to a _LRU_-cache, where the least recently used entries are removed
+*/
 var SizedMap = class extends Map {
+	/**
+	* The maximum size of the Map
+	*/
 	#maximumSize;
+	/**
+	* Is the Map full?
+	*/
 	get full() {
 		return this.size >= this.#maximumSize;
 	}
@@ -260,7 +330,7 @@ var SizedMap = class extends Map {
 		return this.#maximumSize;
 	}
 	constructor(first, second) {
-		const maximum = getMaximum(first, second);
+		const maximum = getSizedMaximum(first, second);
 		super();
 		this.#maximumSize = maximum;
 		if (Array.isArray(first)) {
@@ -269,30 +339,34 @@ var SizedMap = class extends Map {
 			else for (let index = 0; index < maximum; index += 1) this.set(...first[length - maximum + index]);
 		}
 	}
+	/**
+	* @inheritdoc
+	*/
 	get(key) {
 		const value = super.get(key);
 		if (value !== void 0 || this.has(key)) this.set(key, value);
 		return value;
 	}
+	/**
+	* @inheritdoc
+	*/
 	set(key, value) {
 		if (this.has(key)) this.delete(key);
 		else if (this.size >= this.#maximumSize) this.delete(this.keys().next().value);
 		return super.set(key, value);
 	}
 };
-function getMaximum(first, second) {
-	let actual;
-	if (typeof first === "number") actual = first;
-	else actual = typeof second === "number" ? second : MAXIMUM_DEFAULT;
-	return clamp(actual, 1, MAXIMUM_ABSOLUTE);
-}
-var MAXIMUM_ABSOLUTE = 16777216;
-var MAXIMUM_DEFAULT = 1048576;
 var Memoized = class {
 	#state;
+	/**
+	* Maximum cache size
+	*/
 	get maximum() {
 		return this.#state.cache?.maximum ?? NaN;
 	}
+	/**
+	* Current cache size
+	*/
 	get size() {
 		return this.#state.cache?.size ?? NaN;
 	}
@@ -310,23 +384,49 @@ var Memoized = class {
 			getter
 		};
 	}
+	/**
+	* Clear the cache
+	*/
 	clear() {
 		this.#state.cache?.clear();
 	}
+	/**
+	* Delete a result from the cache
+	* @param key Key to delete
+	* @returns `true` if the key existed and was removed, otherwise `false`
+	*/
 	delete(key) {
 		return this.#state.cache?.delete(key) ?? false;
 	}
+	/**
+	* Destroy the instance _(clearing its cache and removing its callback)_
+	*/
 	destroy() {
 		this.#state.cache?.clear();
 		this.#state.cache = void 0;
 		this.#state.getter = void 0;
 	}
+	/**
+	* Get a result from the cache
+	* @param key Key to get
+	* @returns Cached result or `undefined` if it does not exist
+	*/
 	get(key) {
 		return this.#state.cache?.get(key);
 	}
+	/**
+	* Does the result exist?
+	* @param key Key to check
+	* @returns `true` if the result exists, otherwise `false`
+	*/
 	has(key) {
 		return this.#state.cache?.has(key) ?? false;
 	}
+	/**
+	* Run the callback with the provided parameters
+	* @param parameters Parameters to pass to the callback
+	* @returns Cached or computed _(then cached)_ result
+	*/
 	run(...parameters) {
 		if (this.#state.cache == null || this.#state.getter == null) throw new Error("The Memoized instance has been destroyed");
 		return this.#state.getter(...parameters);
@@ -339,18 +439,39 @@ function getMemoizationOptions(input) {
 		cacheSize: typeof cacheSize === "number" && cacheSize > 0 ? cacheSize : DEFAULT_CACHE_SIZE
 	};
 }
+/**
+* Memoize a function, caching and retrieving results based on the first parameter
+* @param callback Callback to memoize
+* @param options Memoization options
+* @returns Memoized instance
+*/
 function memoize(callback, options) {
 	return new Memoized(callback, getMemoizationOptions(options));
 }
 var DEFAULT_CACHE_SIZE = 1024;
+/**
+* Convert a string to camel case _(thisIsCamelCase)_
+* @param value String to convert
+* @returns Camel-cased string
+*/
 function camelCase(value) {
 	return toCase("camel", value, true, false);
 }
+/**
+* Capitalize the first letter of a string _(and lowercase the rest)_
+* @param value String to capitalize
+* @returns Capitalized string
+*/
 function capitalize(value) {
 	if (typeof value !== "string" || value.length === 0) return "";
 	memoizedCapitalize ??= memoize((v) => v.length === 1 ? v.toLocaleUpperCase() : `${v.charAt(0).toLocaleUpperCase()}${v.slice(1).toLocaleLowerCase()}`);
 	return memoizedCapitalize.run(value);
 }
+/**
+* Convert a string to kebab case _(this-is-kebab-case)_
+* @param value String to convert
+* @returns Kebab-cased string
+*/
 function kebabCase(value) {
 	return toCase("kebab", value, false, false);
 }
@@ -385,6 +506,7 @@ function toCaseCallback(value) {
 	}
 	return join(cased, delimiters[type]);
 }
+var caseMemoizers = {};
 var delimiters = {
 	camel: "",
 	kebab: "-",
@@ -393,77 +515,8 @@ var delimiters = {
 };
 var EXPRESSION_CAMEL_CASE = /(\p{Ll})(\p{Lu})/gu;
 var EXPRESSION_ACRONYM = /(\p{Lu}*)(\p{Lu})(\p{Ll}+)/gu;
-var caseMemoizers = {};
 var REPLACEMENT_CAMEL_CASE = "$1-$2";
 var memoizedCapitalize;
-function parse(value, reviver) {
-	try {
-		return JSON.parse(value, reviver);
-	} catch {
-		return;
-	}
-}
-function findKey(needle, haystack) {
-	const keys = Object.keys(haystack);
-	const index = keys.map((key) => key.toLowerCase()).indexOf(needle.toLowerCase());
-	return index > -1 ? keys[index] : needle;
-}
-function getPaths(path, lowercase) {
-	const normalized = lowercase ? path.toLowerCase() : path;
-	if (!EXPRESSION_NESTED.test(normalized)) return normalized;
-	return normalized.replace(EXPRESSION_BRACKET, ".$1").replace(EXPRESSION_DOTS, "").split(".");
-}
-function handleValue(data, path, value, get, ignoreCase) {
-	if (typeof data === "object" && data !== null && !ignoreKey(path)) {
-		const key = ignoreCase ? findKey(path, data) : path;
-		if (get) return data[key];
-		data[key] = typeof value === "function" ? value(data[key]) : value;
-	}
-}
-var EXPRESSION_BRACKET = /\[(\w+)\]/g;
-var EXPRESSION_DOTS = /^\.|\.$/g;
-var EXPRESSION_NESTED = /\.|\[\w+\]/;
-function getValue(data, path, ignoreCase) {
-	if (typeof data !== "object" || data === null || typeof path !== "string" || path.trim().length === 0) return;
-	const shouldIgnoreCase = ignoreCase === true;
-	const paths = getPaths(path, shouldIgnoreCase);
-	if (typeof paths === "string") return handleValue(data, paths, null, true, shouldIgnoreCase);
-	const { length } = paths;
-	let index = 0;
-	let value = data;
-	while (index < length && value != null) value = handleValue(value, paths[index++], null, true, shouldIgnoreCase);
-	return value;
-}
-function getTemplateOptions(input) {
-	const options = isPlainObject(input) ? input : {};
-	return {
-		ignoreCase: options.ignoreCase === true,
-		pattern: options.pattern instanceof RegExp ? options.pattern : EXPRESSION_VARIABLE
-	};
-}
-function handleTemplate(value, pattern, ignoreCase, variables) {
-	if (typeof value !== "string") return "";
-	if (typeof variables !== "object" || variables === null) return value;
-	const values = {};
-	return value.replace(pattern, (_, key) => {
-		if (values[key] == null) {
-			const templateValue = getValue(variables, key, ignoreCase);
-			values[key] = templateValue == null ? "" : getString(templateValue);
-		}
-		return values[key];
-	});
-}
-function template(value, variables, options) {
-	const { ignoreCase, pattern } = getTemplateOptions(options);
-	return handleTemplate(value, pattern, ignoreCase, variables);
-}
-template.initialize = function(options) {
-	const { ignoreCase, pattern } = getTemplateOptions(options);
-	return (value, variables) => {
-		return handleTemplate(value, pattern, ignoreCase, variables);
-	};
-};
-var EXPRESSION_VARIABLE = /{{([\s\S]+?)}}/g;
 function getBoolean(value, defaultValue) {
 	return typeof value === "boolean" ? value : defaultValue ?? false;
 }
@@ -515,6 +568,10 @@ function updateDataAttribute(element, key, value) {
 	updateElementValue(element, getName(key), value, element.setAttribute, element.removeAttribute, false, true);
 }
 const ATTRIBUTE_DATA_PREFIX = "data-";
+/**
+* A function that does nothing, which can be useful, I guess…
+*/
+function noop() {}
 function addDelegatedHandler(doc, type, name, passive) {
 	if (DELEGATED.has(name)) return;
 	DELEGATED.add(name);
@@ -622,6 +679,11 @@ function createEventOptions(options) {
 function dispatch(target, type, options) {
 	if (isEventTarget(target) && typeof type === "string") target.dispatchEvent(createEvent(type, options));
 }
+/**
+* Get the X- and Y-coordinates from a pointer event
+* @param event Pointer event
+* @returns X- and Y-coordinates
+*/
 function getPosition(event) {
 	let x;
 	let y;
@@ -637,6 +699,13 @@ function getPosition(event) {
 		y
 	} : void 0;
 }
+/**
+* Remove an event listener
+* @param target Event target
+* @param type Type of event
+* @param listener Event listener
+* @param options Options for event
+*/
 function off(target, type, listener, options) {
 	if (!isEventTarget(target) || typeof type !== "string" || typeof listener !== "function") return;
 	const extended = createEventOptions(options);
@@ -691,6 +760,12 @@ function findRelatives(origin, selector, context) {
 	}
 	return distances.filter((found) => found.distance === minimum).map((found) => found.element);
 }
+/**
+* Get the distance between two elements _(i.e., the amount of nodes of between them)_
+* @param origin Origin element
+* @param target Target element
+* @returns Distance between elements, or `-1` if distance cannot be calculated
+*/
 function getDistance(origin, target) {
 	if (origin === target) return 0;
 	if (origin.parentElement === target || target.parentElement === origin) return 1;
@@ -766,6 +841,14 @@ function findElementOrElementsFromNodes(array, context, contexts) {
 function findElements(selector, context) {
 	return findElementOrElements(selector, context, false);
 }
+/**
+* Get the most specific element under the pointer
+*
+* - Ignores elements with `pointer-events: none` and `visibility: hidden`
+* - _(If `skipIgnore` is `true`, no elements are ignored)_
+* @param skipIgnore Skip ignored elements?
+* @returns Found element or `null`
+*/
 function getElementUnderPointer(skipIgnore) {
 	const elements = [...document.querySelectorAll(SUFFIX_HOVER)];
 	const { length } = elements;
@@ -787,6 +870,11 @@ const STYLE_HIDDEN$1 = "hidden";
 const STYLE_NONE$1 = "none";
 const SUFFIX_HOVER = ":hover";
 const TAG_HEAD = "HEAD";
+/**
+* Get a list of focusable elements within a parent element
+* @param parent Parent element
+* @returns Focusable elements
+*/
 function getFocusable(parent) {
 	return getValidElements(parent, FILTERS_FOCUSABLE, false);
 }
@@ -796,6 +884,11 @@ function getItem(element, tabbable) {
 		tabIndex: tabbable ? getTabIndex(element) : TABINDEX_DEFAULT
 	};
 }
+/**
+* Get a list of tabbable elements within a parent element
+* @param parent Parent element
+* @returns Tabbable elements
+*/
 function getTabbable(parent) {
 	return getValidElements(parent, FILTERS_TABBABLE, true);
 }
@@ -850,6 +943,11 @@ function isDisabledFromFieldset(element) {
 function isEditable(element) {
 	return EXPRESSION_TRUEISH.test(element.getAttribute(ATTRIBUTE_CONTENTEDITABLE));
 }
+/**
+* Is the element focusable?
+* @param element Element to check
+* @returns `true` if focusable, otherwise `false`
+*/
 function isFocusable(element) {
 	return element instanceof Element ? isValidElement(element, FILTERS_FOCUSABLE, false) : false;
 }
@@ -880,6 +978,11 @@ function isNotTabbableRadio(item) {
 function isSummarised(item) {
 	return item.element instanceof HTMLDetailsElement && [...item.element.children].some((child) => EXPRESSION_SUMMARY.test(child.tagName));
 }
+/**
+* Is the element tabbable?
+* @param element Element to check
+* @returns `true` if tabbable, otherwise `false`
+*/
 function isTabbable(element) {
 	return element instanceof Element ? isValidElement(element, FILTERS_TABBABLE, true) : false;
 }
@@ -935,6 +1038,11 @@ function handleElement(element, depth) {
 	}
 	sanitizeAttributes(element, [...element.attributes]);
 }
+/**
+* Is the element clobbered?
+*
+* Thanks, DOMPurify _(https://github.com/cure53/DOMPurify)_
+*/
 function isClobbered(value) {
 	return value instanceof HTMLFormElement && (typeof value.nodeName !== "string" || typeof value.textContent !== "string" || typeof value.removeChild !== "function" || !(value.attributes instanceof NamedNodeMap) || typeof value.removeAttribute !== "function" || typeof value.setAttribute !== "function" || typeof value.namespaceURI !== "string" || typeof value.insertBefore !== "function" || typeof value.hasChildNodes !== "function");
 }
@@ -1034,6 +1142,12 @@ html.remove = (template) => {
 	}
 	templates = updated;
 };
+/**
+* Sanitize one or more nodes, recursively
+* @param value Node or nodes to sanitize
+* @param options Sanitization options
+* @returns Sanitized nodes
+*/
 function sanitize(value) {
 	return sanitizeNodes(Array.isArray(value) ? value : [value], 0);
 }
@@ -1043,10 +1157,24 @@ const TEMPLATE_TAG = "template";
 const TEMPORARY_ELEMENT = "<toretto-temporary></toretto-temporary>";
 let parser;
 let templates = {};
+/**
+* Get a style from an element
+* @param element Element to get the style from
+* @param property Style name
+* @param computed Get the computed style? _(defaults to `false`)_
+* @returns Style value
+*/
 function getStyle(element, property, computed) {
 	if (!isHTMLOrSVGElement(element) || typeof property !== "string") return;
 	return getStyleValue(element, property, computed === true);
 }
+/**
+* Get styles from an element
+* @param element Element to get the styles from
+* @param properties Styles to get
+* @param computed Get the computed styles? _(defaults to `false`)_
+* @returns Style values
+*/
 function getStyles(element, properties, computed) {
 	const styles = {};
 	if (!(isHTMLOrSVGElement(element) && Array.isArray(properties))) return styles;
@@ -1057,6 +1185,12 @@ function getStyles(element, properties, computed) {
 	}
 	return styles;
 }
+/**
+* Get the text direction of an element
+* @param element Element to get the text direction from
+* @param computed Get the computed text direction? _(defaults to `false`)_
+* @returns Text direction
+*/
 function getTextDirection(element, computed) {
 	if (!(element instanceof Element)) return;
 	const direction = element.getAttribute(ATTRIBUTE_DIRECTION);
@@ -1064,12 +1198,29 @@ function getTextDirection(element, computed) {
 	const value = getStyleValue(element, "direction", computed === true);
 	return value === "rtl" ? value : "ltr";
 }
+/**
+* Set a style on an element
+* @param element Element to set the style on
+* @param property Style name
+* @param value Style value
+*/
 function setStyle(element, property, value) {
 	setElementValues(element, property, value, null, updateStyleProperty);
 }
+/**
+* Set styles on an element
+* @param element Element to set the styles on
+* @param styles Styles to set
+*/
 function setStyles(element, styles) {
 	setElementValues(element, styles, null, null, updateStyleProperty);
 }
+/**
+* Toggle styles for an element
+* @param element Element to style
+* @param styles Styles to be set or removed
+* @returns Style toggler
+*/
 function toggleStyles(element, styles) {
 	function toggle(set) {
 		hasSet = set;
@@ -1105,4 +1256,4 @@ function updateStyleProperty(element, key, value) {
 }
 const ATTRIBUTE_DIRECTION = "dir";
 const EXPRESSION_DIRECTION = /^(ltr|rtl)$/i;
-export { findElement as $, findElement, findElements as $$, findElements, dispatch, findAncestor, findRelatives, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setData, setStyle, setStyles, touch_default as supportsTouch, toggleStyles };
+export { findElement as $, findElement, findElements as $$, findElements, dispatch, findAncestor, findRelatives, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setData, setStyle, setStyles, supportsTouch, toggleStyles };

package/dist/touch.js

@@ -9,7 +9,10 @@ function getSupport() {
 	if (typeof navigator.msMaxTouchPoints === "number" && navigator.msMaxTouchPoints > 0) return true;
 	return false;
 }
-var touch_default = (() => {
+/**
+* Does the device support touch events?
+*/
+var supportsTouch = (() => {
 	let support = getSupport();
 	const instance = Object.create({
 		get() {
@@ -25,4 +28,4 @@ var touch_default = (() => {
 	} });
 	return instance;
 })();
-export { touch_default as default };
+export { supportsTouch as default };

package/package.json

@@ -4,19 +4,19 @@
 		"url": "https://oscarpalmer.se"
 	},
 	"dependencies": {
-		"@oscarpalmer/atoms": "^0.130.0"
+		"@oscarpalmer/atoms": "^0.157"
 	},
 	"description": "A collection of badass DOM utilities.",
 	"devDependencies": {
-		"@types/node": "^25.1",
+		"@types/node": "^25.3",
 		"@vitest/coverage-istanbul": "^4",
-		"jsdom": "^27.4",
-		"oxfmt": "^0.27",
-		"oxlint": "^1.42",
-		"rolldown": "1.0.0-rc.2",
+		"jsdom": "^28.1",
+		"oxfmt": "^0.36",
+		"oxlint": "^1.51",
+		"rolldown": "1.0.0-rc.7",
 		"tslib": "^2.8",
 		"typescript": "^5.9",
-		"vite": "8.0.0-beta.11",
+		"vite": "8.0.0-beta.16",
 		"vitest": "^4"
 	},
 	"exports": {
@@ -93,5 +93,5 @@
 	},
 	"type": "module",
 	"types": "types/index.d.ts",
-	"version": "0.37.2"
+	"version": "0.38.0"
 }

package/src/data.ts

@@ -1,5 +1,6 @@
 import type {PlainObject} from '@oscarpalmer/atoms';
-import {kebabCase, parse} from '@oscarpalmer/atoms/string';
+import {parse} from '@oscarpalmer/atoms/string';
+import {kebabCase} from '@oscarpalmer/atoms/string/case';
 import {setElementValues, updateElementValue} from './internal/element-value';
 import {EXPRESSION_DATA_PREFIX} from './internal/get-value';
 import {isHTMLOrSVGElement} from './internal/is';

package/src/find/index.ts

@@ -1,4 +1,4 @@
-import type {PlainObject} from '@oscarpalmer/atoms';
+import type {PlainObject} from '@oscarpalmer/atoms/models';
 import type {Selector} from '../models';
 
 /**

package/src/internal/attribute.ts

@@ -1,4 +1,4 @@
-import type {PlainObject} from '@oscarpalmer/atoms';
+import type {PlainObject} from '@oscarpalmer/atoms/models';
 import {isPlainObject} from '@oscarpalmer/atoms/is';
 import type {Attribute} from '../models';
 import {updateElementValue} from './element-value';

package/src/internal/get-value.ts

@@ -1,4 +1,5 @@
-import {camelCase, kebabCase, parse} from '@oscarpalmer/atoms/string';
+import {parse} from '@oscarpalmer/atoms/string';
+import {camelCase, kebabCase} from '@oscarpalmer/atoms/string/case';
 
 export function getBoolean(value: unknown, defaultValue?: boolean): boolean {
 	return typeof value === 'boolean' ? value : (defaultValue ?? false);