@oscarpalmer/toretto 0.39.0 → 0.39.1

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.1"
 }

package/types/index.d.ts

@@ -1,11 +1,428 @@
-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";
+/**
+ * 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 {};