@oscarpalmer/toretto 0.45.0 → 0.47.0

package/dist/index.d.mts

@@ -6,10 +6,14 @@ type SupporsTouch = {
   readonly value: boolean;
   /**
    * Are touch events supported?
+   *
+   * @returns `true` if touch events are supported, otherwise `false`
    */
   get(): boolean;
   /**
    * Re-evaluate if touch events are supported
+   *
+   * @returns `true` if touch events are supported, otherwise `false`
    */
   update(): boolean;
 };
@@ -19,6 +23,26 @@ type SupporsTouch = {
 declare const supportsTouch: SupporsTouch;
 //#endregion
 //#region src/models.d.ts
+/**
+ * _ARIA_ attribute for an element
+ *
+ * _(https://www.w3.org/TR/wai-aria-1.3/#aria-attributes)_
+ */
+type AriaAttribute = keyof AriaAttributes;
+/**
+ * _ARIA_ attribute for an element without the `aria-` prefix
+ *
+ * _(https://www.w3.org/TR/wai-aria-1.3/#aria-attributes)_
+ */
+type AriaAttributeUnprefixed = keyof { [Key in AriaAttribute as Key extends `aria-${infer Name}` ? Name : never]: string | null; };
+type AriaAttributes = { [Key in keyof ARIAMixin as NormalizedName<Key>]: string | null; };
+type NormalizedName<Key extends string> = Key extends `aria${infer Name}` ? Name extends `${infer Part}Element` ? `aria-${Lowercase<Part>}` : Name extends `${infer Part}Elements` ? `aria-${Lowercase<Part>}` : `aria-${Lowercase<Name>}` : never;
+/**
+ * _ARIA_ role for an element
+ *
+ * _(https://www.w3.org/TR/wai-aria-1.3/#role_definitions)_
+ */
+type AriaRole = 'alert' | 'alertdialog' | 'application' | 'article' | 'banner' | 'blockquote' | 'button' | 'caption' | 'cell' | 'checkbox' | 'code' | 'columnheader' | 'combobox' | 'comment' | 'complementary' | 'contentinfo' | 'definition' | 'deletion' | 'dialog' | 'directory' | 'document' | 'emphasis' | 'feed' | 'figure' | 'form' | 'generic' | 'grid' | 'gridcell' | 'group' | 'heading' | 'img' | 'insertion' | 'link' | 'list' | 'listbox' | 'listitem' | 'log' | 'main' | 'mark' | 'marquee' | 'math' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'meter' | 'navigation' | 'none' | 'note' | 'option' | 'paragraph' | 'presentation' | 'progressbar' | 'radio' | 'radiogroup' | 'region' | 'row' | 'rowgroup' | 'rowheader' | 'scrollbar' | 'search' | 'searchbox' | 'sectionfooter' | 'sectionheader' | 'separator' | 'slider' | 'spinbutton' | 'status' | 'strong' | 'subscript' | 'suggestion' | 'superscript' | 'switch' | 'tab' | 'table' | 'tablist' | 'tabpanel' | 'term' | 'textbox' | 'time' | 'timer' | 'toolbar' | 'tooltip' | 'tree' | 'treegrid' | 'treeitem';
 /**
  * Attribute for an element
  */
@@ -30,13 +54,6 @@ type Attribute = {
  * Event listener for custom events
  */
 type CustomEventListener = (event: CustomEvent) => void;
-/**
- * The position of an event
- */
-type EventPosition = {
-  x: number;
-  y: number;
-};
 /**
  * Event listener that can be removed
  */
@@ -50,6 +67,71 @@ type Selector = string | Node | Node[] | NodeList;
  */
 type TextDirection = 'ltr' | 'rtl';
 //#endregion
+//#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
 //#region src/internal/attribute.d.ts
 /**
  * List of boolean attributes
@@ -60,6 +142,7 @@ declare const booleanAttributes: readonly string[];
 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`)_
@@ -68,6 +151,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`)_
@@ -75,6 +159,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`)_
@@ -88,6 +173,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
@@ -98,6 +184,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
@@ -107,6 +194,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`)_
@@ -116,6 +204,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`)_
@@ -125,6 +214,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`)_
@@ -134,12 +224,14 @@ declare function setAttributes(element: Element, attributes: Record<string, unkn
 //#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
@@ -147,12 +239,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
  */
@@ -161,6 +255,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
  */
@@ -169,6 +264,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
@@ -176,6 +272,13 @@ declare function isInvalidBooleanAttribute(attribute: Attr | Attribute): boolean
 declare function isInvalidBooleanAttribute(name: string, value: string): boolean;
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/models.d.mts
+/**
+ * Position of an event
+ */
+type EventPosition = {
+  x: number;
+  y: number;
+};
 /**
  * A generic object
  */
@@ -186,15 +289,13 @@ type PlainObject = Record<PropertyKey, unknown>;
  * _(Thanks, type-fest!)_
  */
 type Primitive = null | undefined | string | number | boolean | symbol | bigint;
-/**
- * Set required keys for a type
- */
 //#endregion
 //#region src/create.d.ts
-type Properties<Target extends Element> = { [Property in keyof Target]?: Target[Property] extends Primitive ? Target[Property] : never };
+type Properties<Target extends Element> = { [Property in keyof Target]?: Target[Property] extends Primitive ? Target[Property] : never; };
 type Styles$1 = 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
@@ -203,7 +304,8 @@ type Styles$1 = Partial<Record<keyof CSSStyleDeclaration, unknown>>;
  */
 declare function createElement<TagName extends keyof HTMLElementTagNameMap>(tag: TagName, properties?: Properties<HTMLElementTagNameMap[TagName]>, attributes?: Record<string, unknown>, styles?: Styles$1): 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
@@ -215,6 +317,7 @@ declare function createElement(tag: string, properties?: Properties<HTMLElement>
 //#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`)_
@@ -223,6 +326,7 @@ declare function createElement(tag: string, properties?: Properties<HTMLElement>
 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`)_
@@ -231,12 +335,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
@@ -246,6 +352,7 @@ declare function setData(element: Element, key: string, value: unknown): void;
 //#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)_
@@ -253,6 +360,7 @@ declare function setData(element: Element, key: string, value: unknown): void;
 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)_
@@ -260,12 +368,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
@@ -274,6 +384,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
@@ -282,6 +393,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
@@ -290,6 +402,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
@@ -303,6 +416,7 @@ declare function on(target: EventTarget, type: string, listener: EventListener |
  *
  * - 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`
@@ -313,6 +427,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`
@@ -322,6 +437,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
@@ -332,6 +448,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
@@ -340,6 +457,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
@@ -349,6 +467,7 @@ declare function getDistance(origin: Element, target: Element): number;
 //#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`
@@ -356,6 +475,7 @@ declare function getDistance(origin: Element, target: Element): number;
 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`
@@ -363,6 +483,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
@@ -370,16 +491,25 @@ 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`
  */
@@ -388,24 +518,28 @@ declare function getElementUnderPointer(skipIgnore?: boolean): Element | null;
 //#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`
  */
@@ -414,24 +548,27 @@ declare function isTabbable(element: Element): boolean;
 //#region src/html/index.d.ts
 type HtmlOptions = {
   /**
-   * Cache template element for the HTML string? _(defaults to `true`)_
+   * Cache template element for the _HTML_ string? _(defaults to `true`)_
    */
   cache?: boolean;
 };
 /**
  * Create nodes from a template string
+ *
  * @returns Created nodes
  */
 declare function html(strings: TemplateStringsArray, ...values: unknown[]): Node[];
 /**
- * Create nodes from an HTML string or a template element
- * @param value HTML string or id for a template element
+ * Create nodes from an _HTML_ string or a template element
+ *
+ * @param value _HTML_ string or ID for a template element
  * @param options Options for creating nodes
  * @returns Created nodes
  */
 declare function html(value: string, options?: HtmlOptions): Node[];
 /**
  * Create nodes from a template element
+ *
  * @param template Template element
  * @param options Options for creating nodes
  * @returns Created nodes
@@ -443,6 +580,7 @@ declare namespace html {
 }
 /**
  * Sanitize one or more nodes, recursively
+ *
  * @param value Node or nodes to sanitize
  * @param options Sanitization options
  * @returns Sanitized nodes
@@ -450,20 +588,30 @@ declare namespace html {
 declare function sanitize(value: Node | Node[]): Node[];
 //#endregion
 //#region src/internal/is.d.ts
+/**
+ * Is the value an event position?
+ *
+ * @param value Value to check
+ * @returns `true` if it's an event position, otherwise `false`
+ */
+declare function isEventPosition(value: unknown): value is EventPosition;
 /**
  * Is the value an event target?
+ *
  * @param value Value to check
  * @returns `true` if it's an event target, otherwise `false`
  */
 declare function isEventTarget(value: unknown): value is EventTarget;
 /**
- * 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`
  */
 declare function isHTMLOrSVGElement(value: unknown): value is HTMLElement | 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`
  */
@@ -472,18 +620,21 @@ declare function isInputElement(value: unknown): value is HTMLInputElement | HTM
 //#region src/is.d.ts
 /**
  * Is the value a child node?
+ *
  * @param value Value to check
  * @returns `true` if it's a child node, otherwise `false`
  */
 declare function isChildNode(value: unknown): value is ChildNode;
 /**
  * Is the node inside a document?
+ *
  * @param node Node to check
  * @returns `true` if it's inside a document, otherwise `false`
  */
 declare function isInDocument(node: Node): boolean;
 /**
  * Is the node inside a specific document?
+ *
  * @param node Node to check
  * @param document Document to check within
  * @returns `true` if it's inside the document, otherwise `false`
@@ -491,9 +642,10 @@ declare function isInDocument(node: Node): boolean;
 declare function isInDocument(node: Node, document: Document): boolean;
 //#endregion
 //#region src/property/get.property.d.ts
-type GetProperties<Target extends Element> = { [Property in keyof Target as Target[Property] extends Primitive ? Property : never]?: Target[Property] };
+type GetProperties<Target extends Element> = { [Property in keyof Target as Target[Property] extends Primitive ? Property : never]?: Target[Property]; };
 /**
  * Get the values of one or more properties on an element
+ *
  * @param target Target element
  * @param properties Properties to get
  * @returns Property values
@@ -501,6 +653,7 @@ type GetProperties<Target extends Element> = { [Property in keyof Target as Targ
 declare function getProperties<Target extends Element, Property extends keyof GetProperties<Target>>(target: Target, properties: Property[]): Pick<GetProperties<Target>, Property>;
 /**
  * Get the value of a property on an element
+ *
  * @param target Target element
  * @param property Property to get
  * @returns Property value
@@ -509,11 +662,12 @@ declare function getProperty<Target extends Element, Property extends keyof GetP
 //#endregion
 //#region src/property/set.property.d.ts
 type DispatchedPropertyValue<Target extends Element, Property extends DispatchedAttributeName> = Property extends keyof SetProperties<Target> ? SetProperties<Target>[Property] : never;
-type SetProperties<Target extends Element> = { [Property in keyof Target as Target[Property] extends Primitive ? Property : never]?: Target[Property] };
+type SetProperties<Target extends Element> = { [Property in keyof Target as Target[Property] extends Primitive ? Property : never]?: Target[Property]; };
 /**
  * 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`)_
@@ -521,6 +675,7 @@ type SetProperties<Target extends Element> = { [Property in keyof Target as Targ
 declare function setProperties<Target extends Element>(target: Target, properties: SetProperties<Target>, dispatch?: boolean): void;
 /**
  * Set the value for a dispatchable property on an element
+ *
  * @param target Target element
  * @param property Property to set
  * @param value Value to set
@@ -529,6 +684,7 @@ declare function setProperties<Target extends Element>(target: Target, propertie
 declare function setProperty<Target extends Element, Property extends DispatchedAttributeName>(target: Target, property: Property, value: DispatchedPropertyValue<Target, Property>, dispatch?: boolean): void;
 /**
  * Set the value for a property on an element
+ *
  * @param target Target element
  * @param property Property to set
  * @param value Value to set
@@ -548,9 +704,10 @@ type StyleToggler = {
   remove(): void;
 };
 type Styles = Partial<Record<keyof CSSStyleValues, unknown>>;
-type Variables<Value extends Record<string, string | undefined> = Record<string, string | undefined>> = { [property in keyof Value as `--${string & property}`]?: string | undefined };
+type Variables<Value extends Record<string, string | undefined> = Record<string, string | undefined>> = { [property in keyof Value as `--${string & property}`]?: string | undefined; };
 /**
  * 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`)_
@@ -559,6 +716,7 @@ type Variables<Value extends Record<string, string | undefined> = Record<string,
 declare function getStyle(element: Element, property: keyof CSSStyleValues, computed?: boolean): string | undefined;
 /**
  * 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`)_
@@ -567,17 +725,20 @@ declare function getStyle(element: Element, property: keyof CSSStyleValues, comp
 declare function getStyles<Property extends keyof CSSStyleValues>(element: Element, properties: Property[], computed?: boolean): Record<Property, string | undefined>;
 /**
  * Get the text direction of a node or element _(or document, if element is invalid)_
+ *
  * @param node Node or element to get the text direction from
  * @returns Text direction
  */
 declare function getTextDirection(node: Element | Node): TextDirection;
 /**
  * Get the text direction of the document
+ *
  * @returns Text direction
  */
 declare function getTextDirection(): TextDirection;
 /**
  * Set a style on an element
+ *
  * @param element Element to set the style on
  * @param property Style name
  * @param value Style value
@@ -585,16 +746,18 @@ declare function getTextDirection(): TextDirection;
 declare function setStyle(element: Element, property: keyof CSSStyleValues, value?: unknown): void;
 /**
  * Set styles on an element
+ *
  * @param element Element to set the styles on
  * @param styles Styles to set
  */
 declare function setStyles(element: Element, styles: Styles): void;
 /**
  * Toggle styles for an element
+ *
  * @param element Element to style
  * @param styles Styles to be set or removed
  * @returns Style toggler
  */
 declare function toggleStyles(element: Element, styles: Styles): StyleToggler;
 //#endregion
-export { findElement as $, findElement, findElements as $$, findElements, Attribute, CustomEventListener, EventPosition, RemovableEventListener, Selector, StyleToggler, TextDirection, 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 };
+export { findElement as $, findElement, findElements as $$, findElements, AriaAttribute, AriaAttributeUnprefixed, AriaRole, Attribute, CustomEventListener, HtmlOptions, RemovableEventListener, Selector, StyleToggler, TextDirection, 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 };