@oscarpalmer/toretto 0.45.0 → 0.47.0

package/dist/index.mjs

@@ -33,6 +33,7 @@ const supportsTouch = (() => {
 //#region node_modules/@oscarpalmer/atoms/dist/internal/is.mjs
 /**
 * Is the value a number?
+*
 * @param value Value to check
 * @returns `true` if the value is a `number`, otherwise `false`
 */
@@ -41,6 +42,7 @@ function isNumber(value) {
 }
 /**
 * Is the value a plain object?
+*
 * @param value Value to check
 * @returns `true` if the value is a plain object, otherwise `false`
 */
@@ -54,8 +56,20 @@ function isPlainObject(value) {
 //#region node_modules/@oscarpalmer/atoms/dist/internal/string.mjs
 /**
 * Get the string value from any value
+*
 * @param value Original value
 * @returns String representation of the value
+*
+* @example
+* ```typescript
+* getString(null)       // => ''
+* getString('foo')      // => 'foo'
+* getString(123)        // => '123'
+* getString(true)       // => 'true'
+* getString([1, 2, 3])  // => '1,2,3'
+* getString({a: 1})     // => '{"a":1}'
+* getString(() => 123)  // => '123'
+* ```
 */
 function getString(value) {
 	if (typeof value === "string") return value;
@@ -69,6 +83,7 @@ function getString(value) {
 * Join an array of values into a string _(while ignoring empty values)_
 *
 * _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+*
 * @param array Array of values
 * @param delimiter Delimiter to use between values
 * @returns Joined string
@@ -80,12 +95,13 @@ function join(array, delimiter) {
 	const values = [];
 	for (let index = 0; index < length; index += 1) {
 		const item = getString(array[index]);
-		if (item.trim().length > 0) values.push(item);
+		if (item.length > 0) values.push(item);
 	}
 	return values.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
 */
@@ -97,6 +113,7 @@ const EXPRESSION_WORDS = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
 //#region node_modules/@oscarpalmer/atoms/dist/is.mjs
 /**
 * Is the value `undefined`, `null`, or stringified as a whitespace-only string?
+*
 * @param value Value to check
 * @returns `true` if the value is nullable or matches a whitespace-only string, otherwise `false`
 */
@@ -108,6 +125,7 @@ const EXPRESSION_WHITESPACE$1 = /^\s*$/;
 //#region node_modules/@oscarpalmer/atoms/dist/string/index.mjs
 /**
 * 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
@@ -123,11 +141,18 @@ function parse(value, reviver) {
 //#region node_modules/@oscarpalmer/atoms/dist/internal/number.mjs
 /**
 * 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
+*
+* @example
+* ```typescript
+* clamp(10, 0, 5);       // => 5
+* clamp(10, 0, 5, true); // => 0
+* ```
 */
 function clamp(value, minimum, maximum, loop) {
 	if (![
@@ -151,17 +176,17 @@ const MAXIMUM_DEFAULT = 1048576;
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/sized/map.mjs
 /**
-* A Map with a maximum size
+* A _Map_ with a maximum size
 *
-* Behavior is similar to a _LRU_-cache, where the least recently used entries are removed
+* 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
+	* The maximum size of the _Map_
 	*/
 	#maximumSize;
 	/**
-	* Is the Map full?
+	* Is the _Map_ full?
 	*/
 	get full() {
 		return super.size >= this.#maximumSize;
@@ -205,18 +230,22 @@ var SizedMap = class extends Map {
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/function/memoize.mjs
 /**
-* A memoized function, caching and retrieving results based on the its parameters _(or a custom cache key)_
+* A _Memoized_ function instance, caching and retrieving results based on the its parameters _(or a custom cache key)_
 */
 var Memoized = class {
 	#state;
 	/**
 	* Maximum cache size
+	*
+	* @returns Maximum cache size _(or `Number.NaN` if the instance has been destroyed)_
 	*/
 	get maximum() {
 		return this.#state.cache?.maximum ?? NaN;
 	}
 	/**
 	* Current cache size
+	*
+	* @returns Current cache size _(or `Number.NaN` if the instance has been destroyed)_
 	*/
 	get size() {
 		return this.#state.cache?.size ?? NaN;
@@ -243,6 +272,7 @@ var Memoized = class {
 	}
 	/**
 	* Delete a result from the cache
+	*
 	* @param key Key to delete
 	* @returns `true` if the key existed and was removed, otherwise `false`
 	*/
@@ -250,7 +280,9 @@ var Memoized = class {
 		return this.#state.cache?.delete(key) ?? false;
 	}
 	/**
-	* Destroy the instance _(clearing its cache and removing its callback)_
+	* Destroy the instance
+	*
+	* _(When a Memoized instance is destroyed, its cache and callback are removed, and calls to `run` will throw an error)_
 	*/
 	destroy() {
 		this.#state.cache?.clear();
@@ -259,6 +291,7 @@ var Memoized = class {
 	}
 	/**
 	* Get a result from the cache
+	*
 	* @param key Key to get
 	* @returns Cached result or `undefined` if it does not exist
 	*/
@@ -267,6 +300,7 @@ var Memoized = class {
 	}
 	/**
 	* Does the result exist?
+	*
 	* @param key Key to check
 	* @returns `true` if the result exists, otherwise `false`
 	*/
@@ -275,11 +309,12 @@ var Memoized = class {
 	}
 	/**
 	* 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");
+		if (this.#state.cache == null || this.#state.getter == null) throw new Error(MEMOIZED_ERROR_DESTROYED);
 		return this.#state.getter(...parameters);
 	}
 };
@@ -292,19 +327,24 @@ function getMemoizationOptions(input) {
 }
 /**
 * Memoize a function, caching and retrieving results based on the first parameter
+*
 * @param callback Callback to memoize
 * @param options Memoization options
-* @returns Memoized instance
+* @returns _Memoized_ instance
 */
 function memoize(callback, options) {
+	if (typeof callback !== "function") throw new TypeError(MEMOIZED_ERROR_CALLBACK);
 	return new Memoized(callback, getMemoizationOptions(options));
 }
 const DEFAULT_CACHE_SIZE = 1024;
+const MEMOIZED_ERROR_CALLBACK = "Memoized requires a callback function";
+const MEMOIZED_ERROR_DESTROYED = "The Memoized instance has been destroyed";
 const SEPARATOR = "_";
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/string/case.mjs
 /**
 * Convert a string to camel case _(thisIsCamelCase)_
+*
 * @param value String to convert
 * @returns Camel-cased string
 */
@@ -313,6 +353,7 @@ function camelCase(value) {
 }
 /**
 * Capitalize the first letter of a string _(and lowercase the rest)_
+*
 * @param value String to capitalize
 * @returns Capitalized string
 */
@@ -323,6 +364,7 @@ function capitalize(value) {
 }
 /**
 * Convert a string to kebab case _(this-is-kebab-case)_
+*
 * @param value String to convert
 * @returns Kebab-cased string
 */
@@ -382,7 +424,17 @@ let memoizedCapitalize;
 //#endregion
 //#region src/internal/is.ts
 /**
+* Is the value an event position?
+*
+* @param value Value to check
+* @returns `true` if it's an event position, otherwise `false`
+*/
+function isEventPosition(value) {
+	return typeof value === "object" && value != null && typeof value.x === "number" && typeof value.y === "number";
+}
+/**
 * Is the value an event target?
+*
 * @param value Value to check
 * @returns `true` if it's an event target, otherwise `false`
 */
@@ -390,15 +442,17 @@ 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?
+* 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`
+* @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 an input element? _(`<input>`, `<select>`, or `<textarea>`)_
+*
 * @param value Value to check
 * @returns `true` if it's an input element, otherwise `false`
 */
@@ -406,66 +460,6 @@ function isInputElement(value) {
 	return value instanceof HTMLInputElement || value instanceof HTMLSelectElement || value instanceof HTMLTextAreaElement;
 }
 //#endregion
-//#region src/is.ts
-/**
-* 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);
-}
-function isInDocument(node, doc) {
-	if (!(node instanceof Node)) return false;
-	if (!(doc instanceof Document)) return node.ownerDocument?.contains(node) ?? true;
-	return node.ownerDocument == null ? node === doc : node.ownerDocument === doc && doc.contains(node);
-}
-const CHILD_NODE_TYPES = new Set([
-	Node.ELEMENT_NODE,
-	Node.TEXT_NODE,
-	Node.PROCESSING_INSTRUCTION_NODE,
-	Node.COMMENT_NODE,
-	Node.DOCUMENT_TYPE_NODE
-]);
-//#endregion
-//#region src/internal/element-value.ts
-function ignoreSetAttribute(element, name) {
-	if (element instanceof HTMLTextAreaElement && name === "value") return true;
-	return false;
-}
-function normalizeKey(key, style) {
-	return style && key.startsWith(CSS_VARIABLE_PREFIX$1) ? key : kebabCase(key);
-}
-function setElementValue(element, first, second, third, callback, style) {
-	if (!isHTMLOrSVGElement(element)) return;
-	if (typeof first === "string") setElementValues(element, first, second, third, callback, style);
-	else if (isAttribute(first)) setElementValues(element, first.name, first.value, third, callback, style);
-}
-function setElementValues(element, first, second, third, callback, style) {
-	if (!isHTMLOrSVGElement(element)) return;
-	const dispatch = third !== false;
-	if (typeof first === "string") {
-		callback(element, normalizeKey(first, style), second, dispatch);
-		return;
-	}
-	const isArray = Array.isArray(first);
-	if (!isArray && !(typeof first === "object" && first !== null)) return;
-	const entries = isArray ? first : Object.entries(first).map(([name, value]) => ({
-		name,
-		value
-	}));
-	const { length } = entries;
-	for (let index = 0; index < length; index += 1) {
-		const entry = entries[index];
-		if (typeof entry === "object" && typeof entry?.name === "string") callback(element, normalizeKey(entry.name, style), entry.value, dispatch);
-	}
-}
-function updateElementValue(element, key, value, set, remove, isBoolean, json) {
-	if (isBoolean ? value == null : isNullableOrWhitespace(value)) remove.call(element, key);
-	else if (!ignoreSetAttribute(element, key)) set.call(element, key, json ? JSON.stringify(value) : getString(value));
-}
-const CSS_VARIABLE_PREFIX$1 = "--";
-//#endregion
 //#region src/internal/property.ts
 function getPropertyValue$1(element, name, value) {
 	if (isInputElement(element) && name === "value") return getString(value);
@@ -586,7 +580,7 @@ const booleanAttributes = Object.freeze([
 	"selected"
 ]);
 const booleanAttributesSet = new Set(booleanAttributes);
-const dispatchedAttributes = new Set([
+const dispatchedAttributes = /* @__PURE__ */ new Set([
 	"checked",
 	"open",
 	"value"
@@ -594,6 +588,91 @@ const dispatchedAttributes = new Set([
 const formElement = document.createElement("form");
 let textArea;
 //#endregion
+//#region src/internal/element-value.ts
+function ignoreSetAttribute(element, name) {
+	if (element instanceof HTMLTextAreaElement && name === "value") return true;
+	return false;
+}
+function normalizeKey(key, style) {
+	return style && key.startsWith(CSS_VARIABLE_PREFIX$1) ? key : kebabCase(key);
+}
+function setElementValue(element, first, second, third, callback, style) {
+	if (!(element instanceof Element)) return;
+	if (typeof first === "string") setElementValues(element, first, second, third, callback, style);
+	else if (isAttribute(first)) setElementValues(element, first.name, first.value, third, callback, style);
+}
+function setElementValues(element, first, second, third, callback, style) {
+	if (!(element instanceof Element)) return;
+	const dispatch = third !== false;
+	if (typeof first === "string") {
+		callback(element, normalizeKey(first, style), second, dispatch);
+		return;
+	}
+	const isArray = Array.isArray(first);
+	if (!isArray && !(typeof first === "object" && first !== null)) return;
+	const entries = isArray ? first : Object.entries(first).map(([name, value]) => ({
+		name,
+		value
+	}));
+	const { length } = entries;
+	for (let index = 0; index < length; index += 1) {
+		const entry = entries[index];
+		if (typeof entry === "object" && typeof entry?.name === "string") callback(element, normalizeKey(entry.name, style), entry.value, dispatch);
+	}
+}
+function updateElementValue(element, key, value, set, remove, isBoolean, json) {
+	if (isBoolean ? value == null : isNullableOrWhitespace(value)) remove.call(element, key);
+	else if (!ignoreSetAttribute(element, key)) set.call(element, key, json ? JSON.stringify(value) : getString(value));
+}
+const CSS_VARIABLE_PREFIX$1 = "--";
+//#endregion
+//#region src/aria.ts
+function getAria(element, value) {
+	if (!(element instanceof Element)) return Array.isArray(value) ? {} : void 0;
+	if (!Array.isArray(value)) return typeof value === "string" ? getAriaValue(element, value) : void 0;
+	const arias = {};
+	const { length } = value;
+	for (let index = 0; index < length; index += 1) {
+		const attribute = value[index];
+		if (typeof attribute === "string") arias[attribute.replace(ATTRIBUTE_ARIA_PREFIX, "")] = getAriaValue(element, attribute);
+	}
+	return arias;
+}
+function getAriaValue(element, attribute) {
+	return element.getAttribute(getName$1(attribute)) ?? void 0;
+}
+function getName$1(value) {
+	return EXPRESSION_ARIA_PREFIX.test(value) ? value : `${ATTRIBUTE_ARIA_PREFIX}${value}`;
+}
+/**
+* Get the role of an element
+*
+* @param element Element to get role from
+* @returns Element role _(or `undefined`)_
+*/
+function getRole(element) {
+	if (element instanceof Element) return element.getAttribute("role") ?? void 0;
+}
+function setAria(element, first, second) {
+	setElementValues(element, first, second, null, updateAriaAttribute);
+}
+/**
+* Set the role of an element
+*
+* @param element Element for role
+* @param role Role to set _(or `undefined` to remove it)_
+*/
+function setRole(element, role) {
+	if (!(element instanceof Element)) return;
+	if (typeof role === "string") element.setAttribute("role", role);
+	else element.removeAttribute("role");
+}
+function updateAriaAttribute(element, key, value) {
+	updateElementValue(element, getName$1(key), value, element.setAttribute, element.removeAttribute, false, false);
+}
+const ATTRIBUTE_ARIA_PREFIX = "aria-";
+const EXPRESSION_ARIA_PREFIX = /^aria-/i;
+//#endregion
 //#region src/internal/get-value.ts
 function getBoolean(value, defaultValue) {
 	return typeof value === "boolean" ? value : defaultValue ?? false;
@@ -614,10 +693,11 @@ const CSS_VARIABLE_PREFIX = "--";
 //#endregion
 //#region src/attribute/get.attribute.ts
 function getAttribute(element, name, parseValues) {
-	if (isHTMLOrSVGElement(element) && typeof name === "string") return getAttributeValue(element, kebabCase(name), parseValues !== false);
+	if (element instanceof Element && typeof name === "string") return getAttributeValue(element, kebabCase(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`)_
@@ -625,7 +705,7 @@ function getAttribute(element, name, parseValues) {
 */
 function getAttributes(element, names, parseData) {
 	const attributes = {};
-	if (!(isHTMLOrSVGElement(element) && Array.isArray(names))) return attributes;
+	if (!(element instanceof Element && Array.isArray(names))) return attributes;
 	const shouldParse = parseData !== false;
 	const { length } = names;
 	for (let index = 0; index < length; index += 1) {
@@ -654,19 +734,80 @@ function isInvalidBooleanAttribute(first, second) {
 	return _isInvalidBooleanAttribute(first, second, true);
 }
 //#endregion
+//#region src/property/get.property.ts
+/**
+* Get the values of one or more properties on an element
+*
+* @param target Target element
+* @param properties Properties to get
+* @returns Property values
+*/
+function getProperties(target, properties) {
+	const values = {};
+	if (!(target instanceof Element && Array.isArray(properties))) return values;
+	const { length } = properties;
+	for (let index = 0; index < length; index += 1) {
+		const property = properties[index];
+		if (typeof property === "string") values[property] = getPropertyValue(target, property);
+	}
+	return values;
+}
+/**
+* Get the value of a property on an element
+*
+* @param target Target element
+* @param property Property to get
+* @returns Property value
+*/
+function getProperty(target, property) {
+	if (target instanceof Element && typeof property === "string") return getPropertyValue(target, property);
+}
+function getPropertyValue(element, property) {
+	let actual = property;
+	if (!(actual in element)) actual = camelCase(actual);
+	if (actual in element) return element[actual];
+}
+//#endregion
+//#region src/property/set.property.ts
+/**
+* Set the values of one or more properties on an element
+*
+* Also updates attributes for boolean/dispatchable properties, and if `dispatch` is `true`, will dispatch events for dispatchable properties
+*
+* @param target Target element
+* @param properties Properties to set
+* @param dispatch Dispatch events for properties? _(defaults to `true`)_
+*/
+function setProperties(target, properties, dispatch) {
+	if (!(target instanceof Element) || !isPlainObject(properties)) return;
+	const shouldDispatch = dispatch !== false;
+	const keys = Object.keys(properties);
+	const { length } = keys;
+	for (let index = 0; index < length; index += 1) setPropertyValue(target, keys[index], properties[keys[index]], shouldDispatch);
+}
+function setProperty(target, property, value, dispatch) {
+	if (target instanceof Element && typeof property === "string") setPropertyValue(target, property, value, dispatch !== false);
+}
+function setPropertyValue(element, property, value, dispatch) {
+	if (booleanAttributesSet.has(property.toLowerCase()) || dispatchedAttributes.has(property)) setAttribute(element, property, value, dispatch);
+	else updateProperty(element, property, value, dispatch);
+}
+//#endregion
 //#region src/style.ts
 /**
 * 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 getStyleValue(element, property, computed === true);
+	if (element instanceof Element && typeof property === "string") 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`)_
@@ -674,7 +815,7 @@ function getStyle(element, property, computed) {
 */
 function getStyles(element, properties, computed) {
 	const styles = {};
-	if (!(isHTMLOrSVGElement(element) && Array.isArray(properties))) return styles;
+	if (!(element instanceof Element && Array.isArray(properties))) return styles;
 	const { length } = properties;
 	for (let index = 0; index < length; index += 1) {
 		const property = properties[index];
@@ -684,7 +825,7 @@ function getStyles(element, properties, computed) {
 }
 function getTextDirection(node) {
 	let target;
-	if (isHTMLOrSVGElement(node)) target = node;
+	if (node instanceof Element) target = node;
 	else target = node instanceof Node ? node.ownerDocument?.documentElement ?? document.documentElement : document.documentElement;
 	let { direction } = target.style;
 	if (direction === "") direction = getStyleValue(target, PROPERTY_DIRECTION, true);
@@ -692,6 +833,7 @@ function getTextDirection(node) {
 }
 /**
 * Set a style on an element
+*
 * @param element Element to set the style on
 * @param property Style name
 * @param value Style value
@@ -701,6 +843,7 @@ function setStyle(element, property, value) {
 }
 /**
 * Set styles on an element
+*
 * @param element Element to set the styles on
 * @param styles Styles to set
 */
@@ -709,6 +852,7 @@ function setStyles(element, styles) {
 }
 /**
 * Toggle styles for an element
+*
 * @param element Element to style
 * @param styles Styles to be set or removed
 * @returns Style toggler
@@ -756,62 +900,6 @@ const DIRECTION_RTL = "rtl";
 const PROPERTY_DIRECTION = "direction";
 const VARIABLE_PREFIX = "--";
 //#endregion
-//#region src/property/get.property.ts
-/**
-* Get the values of one or more properties on an element
-* @param target Target element
-* @param properties Properties to get
-* @returns Property values
-*/
-function getProperties(target, properties) {
-	const values = {};
-	if (!isHTMLOrSVGElement(target) || !Array.isArray(properties)) return values;
-	const { length } = properties;
-	for (let index = 0; index < length; index += 1) {
-		const property = properties[index];
-		if (typeof property === "string") values[property] = getPropertyValue(target, property);
-	}
-	return values;
-}
-/**
-* Get the value of a property on an element
-* @param target Target element
-* @param property Property to get
-* @returns Property value
-*/
-function getProperty(target, property) {
-	if (isHTMLOrSVGElement(target) && typeof property === "string") return getPropertyValue(target, property);
-}
-function getPropertyValue(element, property) {
-	let actual = property;
-	if (!(actual in element)) actual = camelCase(actual);
-	if (actual in element) return element[actual];
-}
-//#endregion
-//#region src/property/set.property.ts
-/**
-* Set the values of one or more properties on an element
-*
-* Also updates attributes for boolean/dispatchable properties, and if `dispatch` is `true`, will dispatch events for dispatchable properties
-* @param target Target element
-* @param properties Properties to set
-* @param dispatch Dispatch events for properties? _(defaults to `true`)_
-*/
-function setProperties(target, properties, dispatch) {
-	if (!isHTMLOrSVGElement(target) || !isPlainObject(properties)) return;
-	const shouldDispatch = dispatch !== false;
-	const keys = Object.keys(properties);
-	const { length } = keys;
-	for (let index = 0; index < length; index += 1) setPropertyValue(target, keys[index], properties[keys[index]], shouldDispatch);
-}
-function setProperty(target, property, value, dispatch) {
-	if (isHTMLOrSVGElement(target) && typeof property === "string") setPropertyValue(target, property, value, dispatch !== false);
-}
-function setPropertyValue(element, property, value, dispatch) {
-	if (booleanAttributesSet.has(property.toLowerCase()) || dispatchedAttributes.has(property)) setAttribute(element, property, value, dispatch);
-	else updateProperty(element, property, value, dispatch);
-}
-//#endregion
 //#region src/create.ts
 function createElement(tag, properties, attributes, styles) {
 	if (typeof tag !== "string") throw new TypeError(MESSAGE);
@@ -825,7 +913,7 @@ const MESSAGE = "Tag name must be a string";
 //#endregion
 //#region src/data.ts
 function getData(element, keys, parseValues) {
-	if (!isHTMLOrSVGElement(element)) return;
+	if (!(element instanceof Element)) return;
 	const noParse = parseValues === false;
 	if (typeof keys === "string") {
 		const value = element.dataset[camelCase(keys)];
@@ -874,7 +962,7 @@ function addDelegatedListener(target, type, name, listener, passive) {
 	};
 }
 function delegatedEventHandler(event) {
-	const key = `${EVENT_PREFIX}${event.type}${this ? EVENT_SUFFIX_PASSIVE : EVENT_SUFFIX_ACTIVE}`;
+	const key = `@${event.type}${this ? EVENT_SUFFIX_PASSIVE : EVENT_SUFFIX_ACTIVE}`;
 	const items = event.composedPath();
 	const { length } = items;
 	let cancelled = false;
@@ -909,7 +997,7 @@ function delegatedEventHandler(event) {
 	}
 }
 function getDelegatedName(target, type, options) {
-	if (isEventTarget(target) && EVENT_TYPES.has(type) && !options.capture && !options.once && options.signal == null) return `${EVENT_PREFIX}${type}${options.passive ? EVENT_SUFFIX_PASSIVE : EVENT_SUFFIX_ACTIVE}`;
+	if (isEventTarget(target) && EVENT_TYPES.has(type) && !options.capture && !options.once && options.signal == null) return `@${type}${options.passive ? EVENT_SUFFIX_PASSIVE : EVENT_SUFFIX_ACTIVE}`;
 }
 function removeDelegatedListener(target, name, listener) {
 	const handlers = target[name];
@@ -919,10 +1007,9 @@ function removeDelegatedListener(target, name, listener) {
 	return true;
 }
 const DELEGATED = /* @__PURE__ */ new Set();
-const EVENT_PREFIX = "@";
 const EVENT_SUFFIX_ACTIVE = ":active";
 const EVENT_SUFFIX_PASSIVE = ":passive";
-const EVENT_TYPES = new Set([
+const EVENT_TYPES = /* @__PURE__ */ new Set([
 	"beforeinput",
 	"click",
 	"dblclick",
@@ -959,7 +1046,7 @@ function createDispatchOptions(options) {
 }
 function createEvent(type, options) {
 	const hasOptions = isPlainObject(options);
-	if (hasOptions && PROPERTY_DETAIL in options) return new CustomEvent(type, {
+	if (hasOptions && "detail" in options) return new CustomEvent(type, {
 		...createDispatchOptions(options),
 		detail: options?.detail
 	});
@@ -978,6 +1065,7 @@ function dispatch(target, type, options) {
 }
 /**
 * Get the X- and Y-coordinates from a pointer event
+*
 * @param event Pointer event
 * @returns X- and Y-coordinates
 */
@@ -998,6 +1086,7 @@ function getPosition(event) {
 }
 /**
 * Remove an event listener
+*
 * @param target Event target
 * @param type Type of event
 * @param listener Event listener
@@ -1020,7 +1109,6 @@ function on(target, type, listener, options) {
 		target.removeEventListener(type, listener, extended);
 	};
 }
-const PROPERTY_DETAIL = "detail";
 //#endregion
 //#region src/find/relative.ts
 function findAncestor(origin, selector) {
@@ -1061,6 +1149,7 @@ function findRelatives(origin, selector, context) {
 }
 /**
 * 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
@@ -1143,10 +1232,42 @@ function findElements(selector, context) {
 	return findElementOrElements(selector, context, false);
 }
 /**
+* Get elements from an event position
+*
+* @param position Event position
+* @returns Elements at the event position
+*/
+function getElementFromPosition(position) {
+	if (!isEventPosition(position) || typeof document.elementFromPoint !== "function") return [];
+	const { x, y } = position;
+	const elements = [];
+	const events = [];
+	let current;
+	while (true) {
+		current = document.elementFromPoint(x, y);
+		if (current == null || elements.indexOf(current) !== -1) break;
+		if (!(current instanceof HTMLElement)) continue;
+		elements.push(current);
+		events.push({
+			value: current.style.getPropertyValue(STYLE_POINTER_EVENTS),
+			priority: current.style.getPropertyPriority(STYLE_POINTER_EVENTS)
+		});
+		current.style.setProperty(STYLE_POINTER_EVENTS, STYLE_NONE$1, STYLE_IMPORTANT);
+	}
+	const { length } = elements;
+	for (let index = 0; index < length; index += 1) {
+		const element = elements[index];
+		const event = events[index];
+		if (element instanceof HTMLElement) element.style.setProperty(STYLE_POINTER_EVENTS, event.value ?? "", event.priority);
+	}
+	return elements;
+}
+/**
 * 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`
 */
@@ -1168,13 +1289,16 @@ function isContext(value) {
 const QUERY_SELECTOR_ALL = "querySelectorAll";
 const QUERY_SELECTOR_SINGLE = "querySelector";
 const STYLE_HIDDEN$1 = "hidden";
+const STYLE_IMPORTANT = "important";
 const STYLE_NONE$1 = "none";
+const STYLE_POINTER_EVENTS = "pointer-events";
 const SUFFIX_HOVER = ":hover";
 const TAG_HEAD = "HEAD";
 //#endregion
 //#region src/focusable.ts
 /**
 * Get a list of focusable elements within a parent element
+*
 * @param parent Parent element
 * @returns Focusable elements
 */
@@ -1189,6 +1313,7 @@ function getItem(element, tabbable) {
 }
 /**
 * Get a list of tabbable elements within a parent element
+*
 * @param parent Parent element
 * @returns Tabbable elements
 */
@@ -1248,6 +1373,7 @@ function isEditable(element) {
 }
 /**
 * Is the element focusable?
+*
 * @param element Element to check
 * @returns `true` if focusable, otherwise `false`
 */
@@ -1283,6 +1409,7 @@ function isSummarised(item) {
 }
 /**
 * Is the element tabbable?
+*
 * @param element Element to check
 * @returns `true` if tabbable, otherwise `false`
 */
@@ -1489,8 +1616,9 @@ html.clear = () => {
 	templates.clear();
 };
 /**
-* Remove cached template element for an HTML string or id
-* @param template HTML string or id for a template element
+* Remove cached template element for an _HTML_ string or _ID_
+*
+* @param template _HTML_ string or ID for a template element
 */
 html.remove = (template) => {
 	templates.delete(template);
@@ -1513,6 +1641,7 @@ function replaceComments(origin, replacements) {
 }
 /**
 * Sanitize one or more nodes, recursively
+*
 * @param value Node or nodes to sanitize
 * @param options Sanitization options
 * @returns Sanitized nodes
@@ -1529,6 +1658,28 @@ const TEMPLATE_TAG = "template";
 const TEMPORARY_ELEMENT = "<toretto-temporary></toretto-temporary>";
 const templates = new SizedMap(128);
 let parser;
-window.templates = templates;
 //#endregion
-export { findElement as $, findElement, findElements as $$, findElements, booleanAttributes, createElement, dispatch, findAncestor, findRelatives, getAttribute, getAttributes, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getProperties, getProperty, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInputElement, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setAttribute, setAttributes, setData, setProperties, setProperty, setStyle, setStyles, supportsTouch, toggleStyles };
+//#region src/is.ts
+/**
+* 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);
+}
+function isInDocument(node, doc) {
+	if (!(node instanceof Node)) return false;
+	if (!(doc instanceof Document)) return node.ownerDocument?.contains(node) ?? true;
+	return node.ownerDocument == null ? node === doc : node.ownerDocument === doc && doc.contains(node);
+}
+const CHILD_NODE_TYPES = /* @__PURE__ */ new Set([
+	Node.ELEMENT_NODE,
+	Node.TEXT_NODE,
+	Node.PROCESSING_INSTRUCTION_NODE,
+	Node.COMMENT_NODE,
+	Node.DOCUMENT_TYPE_NODE
+]);
+//#endregion
+export { findElement as $, findElement, findElements as $$, findElements, booleanAttributes, createElement, dispatch, findAncestor, findRelatives, getAria, getAttribute, getAttributes, getData, getDistance, getElementFromPosition, getElementUnderPointer, getFocusable, getPosition, getProperties, getProperty, getRole, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEventPosition, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInputElement, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setAria, setAttribute, setAttributes, setData, setProperties, setProperty, setRole, setStyle, setStyles, supportsTouch, toggleStyles };