@oscarpalmer/toretto 0.45.0 → 0.47.0

package/dist/aria.d.mts

@@ -0,0 +1,68 @@
+import { AriaAttribute, AriaAttributeUnprefixed, AriaRole } from "./models.mjs";
+
+//#region src/aria.d.ts
+type AnyAriaAttribute = AriaAttribute | AriaAttributeUnprefixed;
+type AriaAttributeItem = {
+  name: AnyAriaAttribute;
+  value?: string;
+};
+/**
+ * Get the value of a specific _ARIA_ attribute from an element
+ *
+ * @param element Element to get _ARIA_ attribute from
+ * @param name _ARIA_ name
+ * @returns _ARIA_ value _(or `undefined`)_
+ */
+declare function getAria(element: Element, attribute: AnyAriaAttribute): string | undefined;
+/**
+ * Get specific _ARIA_ attributes from an element
+ *
+ * @param element Element to get _ARIA_ attributes from
+ * @param names _ARIA_ attribute names
+ * @returns Object of named _ARIA_ attributes
+ */
+declare function getAria<Attribute extends AnyAriaAttribute>(element: Element, attributes: Attribute[]): Record<Attribute, string | undefined>;
+/**
+ * Get the role of an element
+ *
+ * @param element Element to get role from
+ * @returns Element role _(or `undefined`)_
+ */
+declare function getRole(element: Element): unknown;
+/**
+ * Set an _ARIA_ attribute on an element
+ *
+ * _(Or remove it, if value is `null` or `undefined`)_
+ *
+ * @param element Element for _ARIA_ attribute
+ * @param attribute _ARIA_ attribute to set
+ * @param value _ARIA_ attribute value
+ */
+declare function setAria(element: Element, attribute: AnyAriaAttribute, value?: string): void;
+/**
+ * Set one or more _ARIA_ attributes on an element
+ *
+ * _(Or remove them, if their value is `null` or `undefined`)_
+ *
+ * @param element Element for _ARIA_ attributes
+ * @param attributes _ARIA_ attributes to set
+ */
+declare function setAria(element: Element, attributes: AriaAttributeItem[]): void;
+/**
+ * Set one or more _ARIA_ attributes on an element
+ *
+ * _(Or remove them, if their value is `null` or `undefined`)_
+ *
+ * @param element Element for _ARIA_ attributes
+ * @param attributes _ARIA_ attributes to set
+ */
+declare function setAria(element: Element, attributes: Partial<Record<AnyAriaAttribute, unknown>>): void;
+/**
+ * Set the role of an element
+ *
+ * @param element Element for role
+ * @param role Role to set _(or `undefined` to remove it)_
+ */
+declare function setRole(element: Element, role?: AriaRole): void;
+//#endregion
+export { getAria, getRole, setAria, setRole };

package/dist/aria.mjs

@@ -0,0 +1,49 @@
+import { setElementValues, updateElementValue } from "./internal/element-value.mjs";
+//#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(attribute)) ?? void 0;
+}
+function getName(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(key), value, element.setAttribute, element.removeAttribute, false, false);
+}
+const ATTRIBUTE_ARIA_PREFIX = "aria-";
+const EXPRESSION_ARIA_PREFIX = /^aria-/i;
+//#endregion
+export { getAria, getRole, setAria, setRole };

package/dist/attribute/get.attribute.d.mts

@@ -2,6 +2,7 @@
 type DataPrefixedName = `data-${string}`;
 /**
  * Get the value of a specific attribute from an element
+ *
  * @param element Element to get attribute from
  * @param name Attribute name
  * @param parse Parse value? _(defaults to `true`)_
@@ -10,6 +11,7 @@ type DataPrefixedName = `data-${string}`;
 declare function getAttribute(element: Element, name: DataPrefixedName, parse?: boolean): unknown;
 /**
  * Get the value of a specific attribute from an element
+ *
  * @param element Element to get attribute from
  * @param name Attribute name
  * @returns Attribute value _(or `undefined`)_
@@ -17,6 +19,7 @@ declare function getAttribute(element: Element, name: DataPrefixedName, parse?:
 declare function getAttribute(element: Element, name: string): unknown;
 /**
  * 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`)_

package/dist/attribute/get.attribute.mjs

@@ -1,12 +1,12 @@
-import { isHTMLOrSVGElement } from "../internal/is.mjs";
 import { getAttributeValue } from "../internal/get-value.mjs";
 import { kebabCase } from "@oscarpalmer/atoms/string/case";
 //#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`)_
@@ -14,7 +14,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) {

package/dist/attribute/index.d.mts

@@ -1,17 +1,19 @@
-import { getAttribute, getAttributes } from "./get.attribute.mjs";
 import { Attribute } from "../models.mjs";
+import { getAttribute, getAttributes } from "./get.attribute.mjs";
 import { booleanAttributes } from "../internal/attribute.mjs";
 import { setAttribute, setAttributes } from "./set.attribute.mjs";
 
 //#region src/attribute/index.d.ts
 /**
  * Is the attribute considered bad and potentially harmful?
+ *
  * @param attribute Attribute to check
  * @returns `true` if attribute is considered bad
  */
 declare function isBadAttribute(attribute: Attr | Attribute): boolean;
 /**
  * Is the attribute considered bad and potentially harmful?
+ *
  * @param name Attribute name
  * @param value Attribute value
  * @returns `true` if attribute is considered bad
@@ -19,12 +21,14 @@ declare function isBadAttribute(attribute: Attr | Attribute): boolean;
 declare function isBadAttribute(name: string, value: string): boolean;
 /**
  * Is the attribute a boolean attribute?
+ *
  * @param name Attribute to check
  * @returns `true` if attribute is a boolean attribute
  */
 declare function isBooleanAttribute(attribute: Attr | Attribute): boolean;
 /**
  * Is the attribute a boolean attribute?
+ *
  * @param name Attribute name
  * @returns `true` if attribute is a boolean attribute
  */
@@ -33,6 +37,7 @@ declare function isBooleanAttribute(name: string): boolean;
  * Is the attribute an invalid boolean attribute?
  *
  * _(I.e., its value is not empty or the same as its name)_
+ *
  * @param attribute Attribute to check
  * @returns `true` if attribute is an invalid boolean attribute
  */
@@ -41,6 +46,7 @@ declare function isInvalidBooleanAttribute(attribute: Attr | Attribute): boolean
  * Is the attribute an invalid boolean attribute?
  *
  * _(I.e., its value is not empty or the same as its name)_
+ *
  * @param name Attribute name
  * @param value Attribute value
  * @returns `true` if attribute is an invalid boolean attribute

package/dist/attribute/set.attribute.d.mts

@@ -6,6 +6,7 @@ type DispatchedAttributeName = 'checked' | 'open' | 'value';
  * Set an attribute on an element
  *
  * _(Or remove it, if value is `null` or `undefined`)_
+ *
  * @param element Element for attribute
  * @param name Attribute name
  * @param value Attribute value
@@ -16,6 +17,7 @@ declare function setAttribute(element: Element, name: DispatchedAttributeName, v
  * Set an attribute on an element
  *
  * _(Or remove it, if value is `null` or `undefined`)_
+ *
  * @param element Element for attribute
  * @param name Attribute name
  * @param value Attribute value
@@ -25,6 +27,7 @@ declare function setAttribute(element: Element, name: string, value?: unknown):
  * Set an attribute on an element
  *
  * _(Or remove it, if value is `null` or `undefined`)_
+ *
  * @param element Element for attribute
  * @param attribute Attribute to set
  * @param dispatch Dispatch event for attribute? _(defaults to `true`)_
@@ -34,6 +37,7 @@ declare function setAttribute(element: Element, attribute: Attr | Attribute, dis
  * Set one or more attributes on an element
  *
  * _(Or remove them, if their value is `null` or `undefined`)_
+ *
  * @param element Element for attributes
  * @param attributes Attributes to set
  * @param dispatch Dispatch events for relevant attributes? _(defaults to `true`)_
@@ -43,6 +47,7 @@ declare function setAttributes(element: Element, attributes: Array<Attr | Attrib
  * Set one or more attributes on an element
  *
  * _(Or remove them, if their value is `null` or `undefined`)_
+ *
  * @param element Element for attributes
  * @param attributes Attributes to set
  * @param dispatch Dispatch events for relevant attributes? _(defaults to `true`)_

package/dist/attribute/set.attribute.mjs

@@ -1,5 +1,5 @@
-import { setElementValue, setElementValues } from "../internal/element-value.mjs";
 import { updateAttribute } from "../internal/attribute.mjs";
+import { setElementValue, setElementValues } from "../internal/element-value.mjs";
 //#region src/attribute/set.attribute.ts
 function setAttribute(element, first, second, third) {
 	setElementValue(element, first, second, third, updateAttribute);

package/dist/create.d.mts

@@ -4,7 +4,8 @@ import { Primitive } from "@oscarpalmer/atoms/models";
 type Properties<Target extends Element> = { [Property in keyof Target]?: Target[Property] extends Primitive ? Target[Property] : never };
 type Styles = Partial<Record<keyof CSSStyleDeclaration, unknown>>;
 /**
- * Creates an HTML element with the specified tag name together with optional properties, attributes, and styles
+ * Creates an _HTML_ element with the specified tag name together with optional properties, attributes, and styles
+ *
  * @param tag Tag name
  * @param properties Element properties
  * @param attributes Element attributes
@@ -13,7 +14,8 @@ type Styles = Partial<Record<keyof CSSStyleDeclaration, unknown>>;
  */
 declare function createElement<TagName extends keyof HTMLElementTagNameMap>(tag: TagName, properties?: Properties<HTMLElementTagNameMap[TagName]>, attributes?: Record<string, unknown>, styles?: Styles): HTMLElementTagNameMap[TagName];
 /**
- * Creates an HTML element with the specified tag name together with optional properties, attributes, and styles
+ * Creates an _HTML_ element with the specified tag name together with optional properties, attributes, and styles
+ *
  * @param tag Tag name
  * @param properties Element properties
  * @param attributes Element attributes

package/dist/create.mjs

@@ -1,8 +1,8 @@
 import { setAttributes } from "./attribute/set.attribute.mjs";
 import "./attribute/index.mjs";
-import { setStyles } from "./style.mjs";
 import { setProperties } from "./property/set.property.mjs";
 import "./property/index.mjs";
+import { setStyles } from "./style.mjs";
 //#region src/create.ts
 function createElement(tag, properties, attributes, styles) {
 	if (typeof tag !== "string") throw new TypeError(MESSAGE);

package/dist/data.d.mts

@@ -3,6 +3,7 @@ import { PlainObject } from "@oscarpalmer/atoms/models";
 //#region src/data.d.ts
 /**
  * Get a keyed data value from an element
+ *
  * @param element Element to get data from
  * @param key Data key
  * @param parse Parse values? _(defaults to `true`)_
@@ -11,6 +12,7 @@ import { PlainObject } from "@oscarpalmer/atoms/models";
 declare function getData(element: Element, key: string, parse?: boolean): unknown;
 /**
  * Get keyed data values from an element
+ *
  * @param element Element to get data from
  * @param keys Keys of the data values to get
  * @param parse Parse values? _(defaults to `true`)_
@@ -19,12 +21,14 @@ declare function getData(element: Element, key: string, parse?: boolean): unknow
 declare function getData<Key extends string>(element: Element, keys: Key[], parse?: boolean): Record<Key, unknown>;
 /**
  * Set data values on an element
+ *
  * @param element Element to set data on
  * @param data Data to set
  */
 declare function setData(element: Element, data: PlainObject): void;
 /**
  * Set a data value on an element
+ *
  * @param element Element to set data on
  * @param key Data key
  * @param value Data value

package/dist/data.mjs

@@ -1,11 +1,10 @@
-import { isHTMLOrSVGElement } from "./internal/is.mjs";
 import { setElementValues, updateElementValue } from "./internal/element-value.mjs";
 import { EXPRESSION_DATA_PREFIX } from "./internal/get-value.mjs";
 import { parse } from "@oscarpalmer/atoms/string";
 import { camelCase, kebabCase } from "@oscarpalmer/atoms/string/case";
 //#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)];

package/dist/event/delegation.mjs

@@ -14,7 +14,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;
@@ -49,7 +49,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];
@@ -59,10 +59,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",

package/dist/event/index.d.mts

@@ -1,8 +1,10 @@
-import { CustomEventListener, EventPosition, RemovableEventListener } from "../models.mjs";
+import { CustomEventListener, RemovableEventListener } from "../models.mjs";
+import { EventPosition } from "@oscarpalmer/atoms/models";
 
 //#region src/event/index.d.ts
 /**
  * Dispatch an event for a target
+ *
  * @param target Event target
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
@@ -10,6 +12,7 @@ import { CustomEventListener, EventPosition, RemovableEventListener } from "../m
 declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventTarget, type: Type, options?: CustomEventInit): void;
 /**
  * Dispatch an event for a target
+ *
  * @param target Event target
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
@@ -17,12 +20,14 @@ declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventT
 declare function dispatch(target: EventTarget, type: string, options?: CustomEventInit): void;
 /**
  * Get the X- and Y-coordinates from a pointer event
+ *
  * @param event Pointer event
  * @returns X- and Y-coordinates
  */
 declare function getPosition(event: MouseEvent | TouchEvent): EventPosition | undefined;
 /**
  * Remove an event listener
+ *
  * @param target Event target
  * @param type Type of event
  * @param listener Event listener
@@ -31,6 +36,7 @@ declare function getPosition(event: MouseEvent | TouchEvent): EventPosition | un
 declare function off(target: EventTarget, type: keyof HTMLElementEventMap, listener: EventListener | CustomEventListener, options?: EventListenerOptions): void;
 /**
  * Remove an event listener
+ *
  * @param target Event target
  * @param type Type of event
  * @param listener Event listener
@@ -39,6 +45,7 @@ declare function off(target: EventTarget, type: keyof HTMLElementEventMap, liste
 declare function off(target: EventTarget, type: string, listener: EventListener | CustomEventListener, options?: EventListenerOptions): void;
 /**
  * Add an event listener
+ *
  * @param target Event target
  * @param type Type of event
  * @param listener Event listener
@@ -47,6 +54,7 @@ declare function off(target: EventTarget, type: string, listener: EventListener
 declare function on<Type extends keyof HTMLElementEventMap>(target: EventTarget, type: Type, listener: (event: HTMLElementEventMap[Type]) => void, options?: AddEventListenerOptions): RemovableEventListener;
 /**
  * Add an event listener
+ *
  * @param target Event target
  * @param type Type of event
  * @param listener Event listener

package/dist/event/index.mjs

@@ -13,7 +13,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
 	});
@@ -32,6 +32,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
 */
@@ -52,6 +53,7 @@ function getPosition(event) {
 }
 /**
 * Remove an event listener
+*
 * @param target Event target
 * @param type Type of event
 * @param listener Event listener
@@ -74,6 +76,5 @@ function on(target, type, listener, options) {
 		target.removeEventListener(type, listener, extended);
 	};
 }
-const PROPERTY_DETAIL = "detail";
 //#endregion
 export { dispatch, getPosition, off, on };

package/dist/find/index.d.mts

@@ -1,9 +1,11 @@
 import { Selector } from "../models.mjs";
 import { findAncestor, findRelatives, getDistance } from "./relative.mjs";
+import { EventPosition } from "@oscarpalmer/atoms/models";
 
 //#region src/find/index.d.ts
 /**
  * Find the first element that matches the tag name
+ *
  * @param tagName Tag name of element to find
  * @param context Context to search within _(defaults to `document`)_
  * @returns Found element or `null`
@@ -11,6 +13,7 @@ import { findAncestor, findRelatives, getDistance } from "./relative.mjs";
 declare function findElement<TagName extends keyof HTMLElementTagNameMap>(tagName: TagName, context?: Selector | null): HTMLElementTagNameMap[TagName] | null;
 /**
  * Find the first element that matches the selector
+ *
  * @param selector Selector to find element for
  * @param context Context to search within _(defaults to `document`)_
  * @returns Found element or `null`
@@ -18,6 +21,7 @@ declare function findElement<TagName extends keyof HTMLElementTagNameMap>(tagNam
 declare function findElement(selector: string, context?: Selector | null): Element | null;
 /**
  * Find elements that match the selector
+ *
  * @param tagName tagName to find elements for
  * @param context Context to search within _(defaults to `document`)_
  * @returns Found elements
@@ -25,19 +29,28 @@ declare function findElement(selector: string, context?: Selector | null): Eleme
 declare function findElements(tagName: keyof HTMLElementTagNameMap, context?: Selector | null): HTMLElementTagNameMap[typeof tagName][];
 /**
  * Find elements that match the selector
+ *
  * @param selector Selector to find elements for
  * @param context Context to search within _(defaults to `document`)_
  * @returns Found elements
  */
 declare function findElements(selector: Selector, context?: Selector | null): Element[];
+/**
+ * Get elements from an event position
+ *
+ * @param position Event position
+ * @returns Elements at the event position
+ */
+declare function getElementFromPosition(position: EventPosition): Element[];
 /**
  * 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`
  */
 declare function getElementUnderPointer(skipIgnore?: boolean): Element | null;
 //#endregion
-export { findElement as $, findElement, findElements as $$, findElements, findAncestor, findRelatives, getDistance, getElementUnderPointer };
+export { findElement as $, findElement, findElements as $$, findElements, findAncestor, findRelatives, getDistance, getElementFromPosition, getElementUnderPointer };

package/dist/find/index.mjs

@@ -1,3 +1,4 @@
+import { isEventPosition } from "../internal/is.mjs";
 import { findAncestor, findRelatives, getDistance } from "./relative.mjs";
 //#region src/find/index.ts
 function findElement(selector, context) {
@@ -42,10 +43,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, 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`
 */
@@ -67,8 +100,10 @@ function isContext(value) {
 const QUERY_SELECTOR_ALL = "querySelectorAll";
 const QUERY_SELECTOR_SINGLE = "querySelector";
 const STYLE_HIDDEN = "hidden";
+const STYLE_IMPORTANT = "important";
 const STYLE_NONE = "none";
+const STYLE_POINTER_EVENTS = "pointer-events";
 const SUFFIX_HOVER = ":hover";
 const TAG_HEAD = "HEAD";
 //#endregion
-export { findElement as $, findElement, findElements as $$, findElements, findAncestor, findRelatives, getDistance, getElementUnderPointer };
+export { findElement as $, findElement, findElements as $$, findElements, findAncestor, findRelatives, getDistance, getElementFromPosition, getElementUnderPointer };

package/dist/find/relative.d.mts

@@ -4,6 +4,7 @@
  *
  * - If no match is found, `null` is returned
  * - _(If you want to search upwards, downwards, and sideways, use {@link findRelatives})_
+ *
  * @param origin Origin to start from
  * @param tagName Tag name to match
  * @returns Found ancestor or `null`
@@ -14,6 +15,7 @@ declare function findAncestor<TagName extends keyof HTMLElementTagNameMap>(origi
  *
  * - If no match is found, `null` is returned
  * - _(If you want to search upwards, downwards, and sideways, use {@link findRelatives})_
+ *
  * @param origin Origin to start from
  * @param selector Selector to match
  * @returns Found ancestor or `null`
@@ -23,6 +25,7 @@ declare function findAncestor(origin: Element | Event | EventTarget, selector: s
  * Finds the closest elements to the origin element that matches the tag name
  *
  * Traverses up, down, and sideways in the _DOM_-tree. _(If you only want to traverse up, use {@link findAncestor})_
+ *
  * @param origin Element to start from
  * @param tagName Tag name to match
  * @param context Context to search within
@@ -33,6 +36,7 @@ declare function findRelatives<TagName extends keyof HTMLElementTagNameMap>(orig
  * Finds the closest elements to the origin element that matches the selector
  *
  * Traverses up, down, and sideways in the _DOM_-tree. _(If you only want to traverse up, use {@link findAncestor})_
+ *
  * @param origin Element to start from
  * @param selector Selector to match
  * @param context Context to search within
@@ -41,6 +45,7 @@ declare function findRelatives<TagName extends keyof HTMLElementTagNameMap>(orig
 declare function findRelatives(origin: Element, selector: string, context?: Document | Element): 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

package/dist/find/relative.mjs

@@ -37,6 +37,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

package/dist/focusable.d.mts

@@ -1,24 +1,28 @@
 //#region src/focusable.d.ts
 /**
  * Get a list of focusable elements within a parent element
+ *
  * @param parent Parent element
  * @returns Focusable elements
  */
 declare function getFocusable(parent: Element): Element[];
 /**
  * Get a list of tabbable elements within a parent element
+ *
  * @param parent Parent element
  * @returns Tabbable elements
  */
 declare function getTabbable(parent: Element): Element[];
 /**
  * Is the element focusable?
+ *
  * @param element Element to check
  * @returns `true` if focusable, otherwise `false`
  */
 declare function isFocusable(element: Element): boolean;
 /**
  * Is the element tabbable?
+ *
  * @param element Element to check
  * @returns `true` if tabbable, otherwise `false`
  */