@oscarpalmer/toretto 0.39.0 → 0.39.2

package/dist/index.js

@@ -1,5 +1,8 @@
 import { isEventTarget, isHTMLOrSVGElement } from "./internal/is.js";
+import { getAttribute, getAttributes } from "./attribute/get.js";
 import { isChildNode, isInDocument } from "./is.js";
+import { booleanAttributes } from "./internal/attribute.js";
+import { setAttribute, setAttributes } from "./attribute/set.js";
 import { isBadAttribute, isBooleanAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute } from "./attribute/index.js";
 import { getData, setData } from "./data.js";
 import { dispatch, getPosition, off, on } from "./event/index.js";
@@ -9,4 +12,4 @@ import { getFocusable, getTabbable, isFocusable, isTabbable } from "./focusable.
 import { html, sanitize } from "./html/index.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, supportsTouch, toggleStyles };
+export { findElement as $, findElement, findElements as $$, findElements, booleanAttributes, dispatch, findAncestor, findRelatives, getAttribute, getAttributes, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setAttribute, setAttributes, setData, setStyle, setStyles, supportsTouch, toggleStyles };

package/dist/toretto.full.js

@@ -529,14 +529,44 @@ var memoizedCapitalize;
 function getBoolean(value, defaultValue) {
 	return typeof value === "boolean" ? value : defaultValue ?? false;
 }
+function getAttributeValue(element, name, parseValue) {
+	const normalized = kebabCase(name);
+	const attribute = element.attributes[normalized];
+	const value = attribute instanceof Attr ? attribute.value : void 0;
+	return EXPRESSION_DATA_PREFIX.test(normalized) && typeof value === "string" && parseValue ? parse(value) ?? value : value;
+}
 function getStyleValue(element, property, computed) {
 	const name = camelCase(property);
 	return computed ? getComputedStyle(element)[name] : element.style[name];
 }
 const EXPRESSION_DATA_PREFIX = /^data-/i;
+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;
+	const shouldParse = parseData !== false;
+	const { length } = names;
+	for (let index = 0; index < length; index += 1) {
+		const name = names[index];
+		if (typeof name === "string") attributes[name] = getAttributeValue(element, name, shouldParse);
+	}
+	return attributes;
+}
 function setAttribute(element, first, second, third) {
 	setElementValue(element, first, second, third, updateAttribute);
 }
+function setAttributes(element, attributes, dispatch) {
+	setElementValues(element, attributes, null, dispatch, updateAttribute);
+}
 function isBadAttribute(first, second) {
 	return _isBadAttribute(first, second, true);
 }
@@ -1418,4 +1448,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, supportsTouch, toggleStyles };
+export { findElement as $, findElement, findElements as $$, findElements, booleanAttributes, dispatch, findAncestor, findRelatives, getAttribute, getAttributes, getData, getDistance, getElementUnderPointer, getFocusable, getPosition, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEmptyNonBooleanAttribute, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setAttribute, setAttributes, setData, setStyle, setStyles, supportsTouch, toggleStyles };

package/package.json

@@ -10,6 +10,7 @@
 	"devDependencies": {
 		"@types/node": "^25.4",
 		"@vitest/coverage-istanbul": "^4",
+		"dts-bundle-generator": "^9.5",
 		"jsdom": "^28.1",
 		"oxfmt": "^0.39",
 		"oxlint": "^1.54",
@@ -23,7 +24,7 @@
 		"./package.json": "./package.json",
 		".": {
 			"types": "./types/index.d.ts",
-			"default": "./dist/index.js"
+			"default": "./dist/toretto.full.js"
 		},
 		"./attribute": {
 			"types": "./types/attribute/index.d.ts",
@@ -84,7 +85,7 @@
 		"url": "git+https://github.com/oscarpalmer/toretto.git"
 	},
 	"scripts": {
-		"build": "npm run clean && npx vite build && npm run rolldown:build && npx tsc",
+		"build": "npm run clean && npx vite build && npm run rolldown:build && npx tsc && npx dts-bundle-generator --config ./dts.config.ts --silent",
 		"clean": "rm -rf ./dist && rm -rf ./types && rm -f ./tsconfig.tsbuildinfo",
 		"rolldown:build": "npx rolldown -c",
 		"rolldown:watch": "npx rolldown -c ./rolldown.config.js --watch",
@@ -93,5 +94,5 @@
 	},
 	"type": "module",
 	"types": "types/index.d.ts",
-	"version": "0.39.0"
+	"version": "0.39.2"
 }

package/src/index.ts

@@ -1,10 +1,15 @@
 import supportsTouch from './touch';
 
 export {
+	booleanAttributes,
+	getAttribute,
+	getAttributes,
 	isBadAttribute,
 	isBooleanAttribute,
 	isEmptyNonBooleanAttribute,
 	isInvalidBooleanAttribute,
+	setAttribute,
+	setAttributes,
 } from './attribute/index';
 export * from './data';
 export * from './event/index';

package/types/index.d.ts

@@ -1,11 +1,502 @@
-import supportsTouch from './touch';
-export { isBadAttribute, isBooleanAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute, } from './attribute/index';
-export * from './data';
-export * from './event/index';
-export * from './find/index';
-export * from './focusable';
-export * from './html/index';
-export * from './is';
-export * from './models';
-export * from './style';
-export { supportsTouch };
+// Generated by dts-bundle-generator v9.5.1
+
+export type SupporsTouch = {
+	/**
+	 * Are touch events supported?
+	 */
+	readonly value: boolean;
+	/**
+	 * Are touch events supported?
+	 */
+	get(): boolean;
+	/**
+	 * Re-evaluate if touch events are supported
+	 */
+	update(): boolean;
+};
+/**
+ * Does the device support touch events?
+ */
+export declare const supportsTouch: SupporsTouch;
+/**
+ * Attribute for an element
+ */
+export type Attribute = {
+	name: string;
+	value: unknown;
+};
+/**
+ * Event listener for custom events
+ */
+export type CustomEventListener = (event: CustomEvent) => void;
+/**
+ * The position of an event
+ */
+export type EventPosition = {
+	x: number;
+	y: number;
+};
+/**
+ * Event listener that can be removed
+ */
+export type RemovableEventListener = () => void;
+/**
+ * Selector that be searched for
+ */
+export type Selector = string | Node | Node[] | NodeList;
+/**
+ * Text direction for an element
+ */
+export type TextDirection = "ltr" | "rtl";
+/**
+ * List of boolean attributes
+ */
+export declare const booleanAttributes: readonly 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`)_
+ * @returns Attribute value _(or `undefined`)_
+ */
+export declare function getAttribute(element: Element, name: `data-${string}`, 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`)_
+ */
+export 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`)_
+ * @returns Object of named attributes
+ */
+export declare function getAttributes<Key extends string>(element: Element, names: Key[], parseData?: boolean): Record<Key, unknown>;
+export type DispatchedAttribute = "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
+ * @param dispatch Dispatch event for attribute? _(defaults to `true`)_
+ */
+export declare function setAttribute<Name extends DispatchedAttribute>(element: Element, name: Name, value?: unknown, dispatch?: boolean): void;
+/**
+ * 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
+ */
+export declare function setAttribute(element: Element, name: string, value?: unknown): void;
+/**
+ * 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`)_
+ */
+export declare function setAttribute(element: Element, attribute: Attr | Attribute, dispatch?: boolean): void;
+/**
+ * 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`)_
+ */
+export declare function setAttributes(element: Element, attributes: Array<Attr | Attribute>, dispatch?: boolean): void;
+/**
+ * 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`)_
+ */
+export declare function setAttributes(element: Element, attributes: Record<string, unknown>, dispatch?: boolean): void;
+/**
+ * Is the attribute considered bad and potentially harmful?
+ * @param attribute Attribute to check
+ * @returns `true` if attribute is considered bad
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function isBooleanAttribute(name: string): boolean;
+/**
+ * Is the attribute empty and not a boolean attribute?
+ * @param attribute Attribute to check
+ * @returns `true` if attribute is empty and not a boolean attribute
+ */
+export declare function isEmptyNonBooleanAttribute(attribute: Attr | Attribute): boolean;
+/**
+ * Is the attribute empty and not a boolean attribute?
+ * @param name Attribute name
+ * @param value Attribute value
+ * @returns `true` if attribute is empty and not a boolean attribute
+ */
+export declare function isEmptyNonBooleanAttribute(name: string, value: 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
+ */
+export 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
+ */
+export declare function isInvalidBooleanAttribute(name: string, value: string): boolean;
+/**
+ * A generic object
+ */
+export type PlainObject = Record<PropertyKey, unknown>;
+/**
+ * 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`)_
+ * @returns Data value
+ */
+export 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`)_
+ * @returns Keyed data values
+ */
+export 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
+ */
+export 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
+ */
+export declare function setData(element: Element, key: string, value: unknown): 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)_
+ */
+export 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)_
+ */
+export 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
+ */
+export 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
+ * @param options Options for event
+ */
+export 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
+ * @param options Options for event
+ */
+export 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
+ * @param options Options for event _(passive by default)_
+ */
+export 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
+ * @param options Options for event _(passive by default)_
+ */
+export declare function on(target: EventTarget, type: string, listener: EventListener | CustomEventListener, options?: AddEventListenerOptions): RemovableEventListener;
+/**
+ * Find the closest ancestor element that matches the tag name
+ *
+ * - 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`
+ */
+export declare function findAncestor<TagName extends keyof HTMLElementTagNameMap>(origin: Element | Event | EventTarget, tagName: TagName): HTMLElementTagNameMap[TagName] | null;
+/**
+ * Find the closest ancestor element that matches the selector _(string or callback)_
+ *
+ * - 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`
+ */
+export declare function findAncestor(origin: Element | Event | EventTarget, selector: string | ((element: Element) => boolean)): Element | null;
+/**
+ * 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
+ * @returns Found elements
+ */
+export declare function findRelatives<TagName extends keyof HTMLElementTagNameMap>(origin: Element, tagName: TagName, context?: Document | Element): HTMLElementTagNameMap[TagName][];
+/**
+ * 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
+ * @returns Found elements
+ */
+export 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
+ */
+export declare function getDistance(origin: Element, target: Element): number;
+/**
+ * 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`
+ */
+export 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`
+ */
+export 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
+ */
+export 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
+ */
+export declare function findElements(selector: Selector, context?: Selector | null): 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`
+ */
+export declare function getElementUnderPointer(skipIgnore?: boolean): Element | null;
+/**
+ * Get a list of focusable elements within a parent element
+ * @param parent Parent element
+ * @returns Focusable elements
+ */
+export declare function getFocusable(parent: Element): Element[];
+/**
+ * Get a list of tabbable elements within a parent element
+ * @param parent Parent element
+ * @returns Tabbable elements
+ */
+export declare function getTabbable(parent: Element): Element[];
+/**
+ * Is the element focusable?
+ * @param element Element to check
+ * @returns `true` if focusable, otherwise `false`
+ */
+export declare function isFocusable(element: Element): boolean;
+/**
+ * Is the element tabbable?
+ * @param element Element to check
+ * @returns `true` if tabbable, otherwise `false`
+ */
+export declare function isTabbable(element: Element): boolean;
+export type Html = {
+	/**
+	 * 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
+	 */
+	(value: string, options?: HtmlOptions): Node[];
+	/**
+	 * Create nodes from a template element
+	 * @param template Template element
+	 * @param options Options for creating nodes
+	 * @returns Created nodes
+	 */
+	(template: HTMLTemplateElement, options?: HtmlOptions): Node[];
+	/**
+	 * Clear cache of template elements
+	 */
+	clear(): void;
+	/**
+	 * Remove cached template element for an HTML string or id
+	 * @param template HTML string or id for a template element
+	 */
+	remove(template: string): void;
+};
+export type HtmlOptions = {
+	/**
+	 * Cache template element for the HTML string? _(defaults to `true`)_
+	 */
+	cache?: boolean;
+};
+export declare const html: Html;
+/**
+ * Sanitize one or more nodes, recursively
+ * @param value Node or nodes to sanitize
+ * @param options Sanitization options
+ * @returns Sanitized nodes
+ */
+export declare function sanitize(value: Node | Node[]): Node[];
+/**
+ * Is the value an event target?
+ * @param value Value to check
+ * @returns `true` if it's an event target, otherwise `false`
+ */
+export declare function isEventTarget(value: unknown): value is EventTarget;
+/**
+ * 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`
+ */
+export declare function isHTMLOrSVGElement(value: unknown): value is HTMLElement | SVGElement;
+/**
+ * Is the value a child node?
+ * @param value Value to check
+ * @returns `true` if it's a child node, otherwise `false`
+ */
+export 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`
+ */
+export 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`
+ */
+export declare function isInDocument(node: Node, document: Document): boolean;
+export type StyleToggler = {
+	/**
+	 * Set the provided styles on the element
+	 */
+	set(): void;
+	/**
+	 * Remove the provided styles from the element _(and sets any previous styles)_
+	 */
+	remove(): void;
+};
+/**
+ * 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
+ */
+export declare function getStyle(element: Element, property: keyof CSSStyleDeclaration, 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`)_
+ * @returns Style values
+ */
+export declare function getStyles<Property extends keyof CSSStyleDeclaration>(element: Element, properties: Property[], computed?: boolean): Record<Property, string | undefined>;
+/**
+ * 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
+ */
+export declare function getTextDirection(element: Element, computed?: boolean): TextDirection;
+/**
+ * Set a style on an element
+ * @param element Element to set the style on
+ * @param property Style name
+ * @param value Style value
+ */
+export declare function setStyle(element: Element, property: keyof CSSStyleDeclaration, value?: string): void;
+/**
+ * Set styles on an element
+ * @param element Element to set the styles on
+ * @param styles Styles to set
+ */
+export declare function setStyles(element: Element, styles: Partial<CSSStyleDeclaration>): void;
+/**
+ * Toggle styles for an element
+ * @param element Element to style
+ * @param styles Styles to be set or removed
+ * @returns Style toggler
+ */
+export declare function toggleStyles(element: Element, styles: Partial<CSSStyleDeclaration>): StyleToggler;
+
+export {
+	findElement as $,
+	findElements as $$,
+};
+
+export {};