@oscarpalmer/toretto 0.47.3 → 0.49.0

package/dist/index.mjs

@@ -627,7 +627,10 @@ function getAria(element, value) {
 	return arias;
 }
 function getAriaValue(element, attribute) {
-	return element.getAttribute(getName$1(attribute)) ?? void 0;
+	const name = getName$1(attribute);
+	const value = element.getAttribute(name) ?? void 0;
+	if (ariaBooleanAttributesSet.has(name) && typeof value === "string" && EXPRESSION_BOOLEAN.test(value)) return value.toLowerCase() === "true";
+	return value;
 }
 function getName$1(value) {
 	return EXPRESSION_ARIA_PREFIX.test(value) ? value : `${ATTRIBUTE_ARIA_PREFIX}${value}`;
@@ -656,10 +659,39 @@ function setRole(element, role) {
 	else element.removeAttribute("role");
 }
 function updateAriaAttribute(element, key, value) {
-	updateElementValue(element, getName$1(key), value, element.setAttribute, element.removeAttribute, false, false);
+	const name = getName$1(key);
+	let actual = value;
+	if (ariaBooleanAttributesSet.has(name) && typeof value === "string" && EXPRESSION_BOOLEAN.test(value)) actual = value.toLowerCase() === "true";
+	updateElementValue(element, name, actual, element.setAttribute, element.removeAttribute, false, false);
 }
 const ATTRIBUTE_ARIA_PREFIX = "aria-";
 const EXPRESSION_ARIA_PREFIX = /^aria-/i;
+const EXPRESSION_BOOLEAN = /^(true|false)$/i;
+/**
+* List of _ARIA_ attributes that can be treated as boolean values
+*/
+const ariaBooleanAttributes = Object.freeze([
+	"aria-atomic",
+	"aria-busy",
+	"aria-checked",
+	"aria-current",
+	"aria-disabled",
+	"aria-expanded",
+	"aria-haspopup",
+	"aria-hidden",
+	"aria-invalid",
+	"aria-modal",
+	"aria-multiline",
+	"aria-multiselectable",
+	"aria-pressed",
+	"aria-readonly",
+	"aria-required",
+	"aria-selected"
+]);
+/**
+* Set of _ARIA_ attributes that can be treated as boolean values
+*/
+const ariaBooleanAttributesSet = new Set(ariaBooleanAttributes);
 //#endregion
 //#region src/internal/get-value.ts
 function getBoolean(value, defaultValue) {
@@ -722,6 +754,36 @@ function isInvalidBooleanAttribute(first, second) {
 	return _isInvalidBooleanAttribute(first, second, true);
 }
 //#endregion
+//#region src/data.ts
+function getData(element, keys, parseValues) {
+	if (!(element instanceof Element)) return;
+	const noParse = parseValues === false;
+	if (typeof keys === "string") {
+		const value = element.dataset[camelCase(keys)];
+		if (value === void 0) return;
+		return noParse ? value : parse(value);
+	}
+	const { length } = keys;
+	const data = {};
+	for (let index = 0; index < length; index += 1) {
+		const key = keys[index];
+		const value = element.dataset[camelCase(key)];
+		if (value == null) data[key] = void 0;
+		else data[key] = noParse ? value : parse(value);
+	}
+	return data;
+}
+function getName(original) {
+	return `${ATTRIBUTE_DATA_PREFIX}${kebabCase(original.replace(EXPRESSION_DATA_PREFIX, ""))}`;
+}
+function setData(element, first, second) {
+	setElementValues(element, first, second, null, updateDataAttribute);
+}
+function updateDataAttribute(element, key, value) {
+	updateElementValue(element, getName(key), value, element.setAttribute, element.removeAttribute, false, true);
+}
+const ATTRIBUTE_DATA_PREFIX = "data-";
+//#endregion
 //#region src/property/get.property.ts
 /**
 * Get the values of one or more properties on an element
@@ -786,28 +848,28 @@ function setPropertyValue(element, property, value, dispatch) {
 * Get a style from an element
 *
 * @param element Element to get the style from
-* @param property Style name
+* @param name Style name
 * @param computed Get the computed style? _(defaults to `false`)_
 * @returns Style value
 */
-function getStyle(element, property, computed) {
-	if (element instanceof Element && typeof property === "string") return getStyleValue(element, property, computed === true);
+function getStyle(element, name, computed) {
+	if (element instanceof Element && typeof name === "string") return getStyleValue(element, name, computed === true);
 }
 /**
 * Get styles from an element
 *
 * @param element Element to get the styles from
-* @param properties Styles to get
+* @param names Styles to get
 * @param computed Get the computed styles? _(defaults to `false`)_
 * @returns Style values
 */
-function getStyles(element, properties, computed) {
+function getStyles(element, names, computed) {
 	const styles = {};
-	if (!(element instanceof Element && Array.isArray(properties))) return styles;
-	const { length } = properties;
+	if (!(element instanceof Element && Array.isArray(names))) return styles;
+	const { length } = names;
 	for (let index = 0; index < length; index += 1) {
-		const property = properties[index];
-		if (typeof property === "string") styles[property] = getStyleValue(element, property, computed === true);
+		const name = names[index];
+		if (typeof name === "string") styles[name] = getStyleValue(element, name, computed === true);
 	}
 	return styles;
 }
@@ -823,11 +885,11 @@ function getTextDirection(node) {
 * Set a style on an element
 *
 * @param element Element to set the style on
-* @param property Style name
+* @param name Style name
 * @param value Style value
 */
-function setStyle(element, property, value) {
-	setElementValues(element, property, value, null, updateStyleProperty, true);
+function setStyle(element, name, value) {
+	setElementValues(element, name, value, null, updateStyleProperty, true);
 }
 /**
 * Set styles on an element
@@ -873,12 +935,12 @@ function toggleStyles(element, styles) {
 	};
 }
 function updateStyleProperty(element, key, value) {
-	updateElementValue(element, key, value, function(property, style) {
-		if (property.startsWith(VARIABLE_PREFIX)) this.style.setProperty(property, getString(style));
-		else this.style[property] = getString(style);
-	}, function(property) {
-		if (property.startsWith(VARIABLE_PREFIX)) this.style.removeProperty(property);
-		else this.style[property] = "";
+	updateElementValue(element, key, value, function(name, style) {
+		if (name.startsWith(VARIABLE_PREFIX)) this.style.setProperty(name, getString(style));
+		else this.style[name] = getString(style);
+	}, function(name) {
+		if (name.startsWith(VARIABLE_PREFIX)) this.style.removeProperty(name);
+		else this.style[name] = "";
 		if (this.getAttribute(ATTRIBUTE_STYLE) === "") this.removeAttribute(ATTRIBUTE_STYLE);
 	}, false, false);
 }
@@ -889,45 +951,28 @@ const PROPERTY_DIRECTION = "direction";
 const VARIABLE_PREFIX = "--";
 //#endregion
 //#region src/create.ts
-function createElement(tag, properties, attributes, styles) {
+function createElement(tag, values) {
 	if (typeof tag !== "string") throw new TypeError(MESSAGE);
 	const element = document.createElement(tag);
-	if (properties != null) setProperties(element, properties);
-	if (attributes != null) setAttributes(element, attributes);
-	if (styles != null) setStyles(element, styles);
+	const { aria, attribute, data, property, style } = getElementValues(values);
+	setAria(element, aria ?? {});
+	setAttributes(element, attribute ?? {});
+	setData(element, data ?? {});
+	setProperties(element, property ?? {});
+	setStyles(element, style ?? {});
 	return element;
 }
-const MESSAGE = "Tag name must be a string";
-//#endregion
-//#region src/data.ts
-function getData(element, keys, parseValues) {
-	if (!(element instanceof Element)) return;
-	const noParse = parseValues === false;
-	if (typeof keys === "string") {
-		const value = element.dataset[camelCase(keys)];
-		if (value === void 0) return;
-		return noParse ? value : parse(value);
-	}
-	const { length } = keys;
-	const data = {};
-	for (let index = 0; index < length; index += 1) {
-		const key = keys[index];
-		const value = element.dataset[camelCase(key)];
-		if (value == null) data[key] = void 0;
-		else data[key] = noParse ? value : parse(value);
-	}
-	return data;
-}
-function getName(original) {
-	return `${ATTRIBUTE_DATA_PREFIX}${kebabCase(original.replace(EXPRESSION_DATA_PREFIX, ""))}`;
-}
-function setData(element, first, second) {
-	setElementValues(element, first, second, null, updateDataAttribute);
-}
-function updateDataAttribute(element, key, value) {
-	updateElementValue(element, getName(key), value, element.setAttribute, element.removeAttribute, false, true);
+function getElementValues(input) {
+	if (!isPlainObject(input)) return {};
+	return {
+		aria: isPlainObject(input.aria) ? input.aria : void 0,
+		attribute: isPlainObject(input.attribute) ? input.attribute : void 0,
+		data: isPlainObject(input.data) ? input.data : void 0,
+		property: isPlainObject(input.property) ? input.property : void 0,
+		style: isPlainObject(input.style) ? input.style : void 0
+	};
 }
-const ATTRIBUTE_DATA_PREFIX = "data-";
+const MESSAGE = "Tag name must be a string";
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/internal/function/misc.mjs
 /**
@@ -1049,7 +1094,10 @@ function createEventOptions(options) {
 	};
 }
 function dispatch(target, type, options) {
-	if (isEventTarget(target) && typeof type === "string") target.dispatchEvent(createEvent(type, options));
+	if (!isEventTarget(target) || typeof type !== "string") return;
+	const event = createEvent(type, options);
+	target.dispatchEvent(event);
+	return event;
 }
 /**
 * Get the X- and Y-coordinates from a pointer event
@@ -1670,4 +1718,4 @@ const CHILD_NODE_TYPES = /* @__PURE__ */ new Set([
 	Node.DOCUMENT_TYPE_NODE
 ]);
 //#endregion
-export { findElement as $, findElement, findElements as $$, findElements, booleanAttributes, createElement, dispatch, findAncestor, findRelatives, getAria, getAttribute, getAttributes, getData, getDistance, getElementFromPosition, getElementUnderPointer, getFocusable, getPosition, getProperties, getProperty, getRole, getStyle, getStyles, getTabbable, getTextDirection, html, isBadAttribute, isBooleanAttribute, isChildNode, isEventPosition, isEventTarget, isFocusable, isHTMLOrSVGElement, isInDocument, isInputElement, isInvalidBooleanAttribute, isTabbable, off, on, sanitize, setAria, setAttribute, setAttributes, setData, setProperties, setProperty, setRole, setStyle, setStyles, supportsTouch, toggleStyles };
+export { findElement as $, findElement, findElements as $$, findElements, ariaBooleanAttributes, ariaBooleanAttributesSet, 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 };

package/dist/internal/attribute.d.mts

@@ -1,5 +1,4 @@
 import { Attribute } from "../models.mjs";
-
 //#region src/internal/attribute.d.ts
 declare function isAttribute(value: unknown): value is Attr | Attribute;
 declare function _isBadAttribute(first: unknown, second: unknown, decode: boolean): boolean;

package/dist/internal/is.d.mts

@@ -1,5 +1,4 @@
 import { EventPosition } from "@oscarpalmer/atoms/models";
-
 //#region src/internal/is.d.ts
 /**
  * Is the value an event position?

package/dist/is.d.mts

@@ -1,5 +1,4 @@
 import { isEventPosition, isEventTarget, isHTMLOrSVGElement, isInputElement } from "./internal/is.mjs";
-
 //#region src/is.d.ts
 /**
  * Is the value a child node?

package/dist/models.d.mts

@@ -1,4 +1,12 @@
 //#region src/models.d.ts
+/**
+ * Any _ARIA_ attribute for an element _(both prefixed and unprefixed)_
+ */
+type AnyAriaAttribute = AriaAttribute | AriaAttributeUnprefixed;
+/**
+ * Any _ARIA_ attribute for an element that can be set to a boolean value _(both prefixed and unprefixed)_
+ */
+type AnyAriaBooleanAttribute = AriaBooleanAttribute | AriaBooleanAttributeUnprefixed;
 /**
  * _ARIA_ attribute for an element
  *
@@ -10,8 +18,16 @@ type AriaAttribute = keyof AriaAttributes;
  *
  * _(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 AriaAttributeUnprefixed = keyof { [Key in AriaAttribute as Key extends `aria-${infer Name}` ? Name : never]: unknown; };
+type AriaAttributes = { [Key in keyof ARIAMixin as NormalizedName<Key>]: unknown; };
+/**
+ * _ARIA_ attribute for an element that can be set to a boolean value
+ */
+type AriaBooleanAttribute = 'aria-atomic' | 'aria-busy' | 'aria-checked' | 'aria-current' | 'aria-disabled' | 'aria-expanded' | 'aria-haspopup' | 'aria-hidden' | 'aria-invalid' | 'aria-modal' | 'aria-multiline' | 'aria-multiselectable' | 'aria-pressed' | 'aria-readonly' | 'aria-required' | 'aria-selected';
+/**
+ * _ARIA_ attribute for an element that can be set to a boolean value, without the `aria-` prefix
+ */
+type AriaBooleanAttributeUnprefixed = keyof { [Key in AriaBooleanAttribute as Key extends `aria-${infer Name}` ? Name : never]: 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
@@ -26,6 +42,18 @@ type Attribute = {
   name: string;
   value: unknown;
 };
+/**
+ * CSS styles for an element
+ */
+type CSSStyles = Record<keyof CSSStyleDeclaration, unknown>;
+/**
+ * CSSS values for an element _(both styles and variables)_
+ */
+type CSSValues = CSSVariables & CSSStyles;
+/**
+ * CSS variables for an element
+ */
+type CSSVariables<Value extends Record<string, unknown> = Record<string, unknown>> = { [Property in keyof Value as `--${string & Property}`]?: unknown; };
 /**
  * Event listener for custom events
  */
@@ -43,4 +71,4 @@ type Selector = string | Node | Node[] | NodeList;
  */
 type TextDirection = 'ltr' | 'rtl';
 //#endregion
-export { AriaAttribute, AriaAttributeUnprefixed, AriaRole, Attribute, CustomEventListener, RemovableEventListener, Selector, TextDirection };
+export { AnyAriaAttribute, AnyAriaBooleanAttribute, AriaAttribute, AriaAttributeUnprefixed, AriaBooleanAttribute, AriaBooleanAttributeUnprefixed, AriaRole, Attribute, CSSStyles, CSSValues, CSSVariables, CustomEventListener, RemovableEventListener, Selector, TextDirection };

package/dist/property/get.property.d.mts

@@ -1,7 +1,6 @@
 import { Primitive } from "@oscarpalmer/atoms/models";
-
 //#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
  *

package/dist/property/set.property.d.mts

@@ -1,9 +1,8 @@
 import { DispatchedAttributeName } from "../attribute/set.attribute.mjs";
 import { Primitive } from "@oscarpalmer/atoms/models";
-
 //#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
  *

package/dist/style.d.mts

@@ -1,7 +1,5 @@
-import { TextDirection } from "./models.mjs";
-
+import { CSSValues, TextDirection } from "./models.mjs";
 //#region src/style.d.ts
-type CSSStyleValues = Variables & CSSStyleDeclaration;
 type StyleToggler = {
   /**
    * Set the provided styles on the element
@@ -12,26 +10,24 @@ 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 };
 /**
  * Get a style from an element
  *
  * @param element Element to get the style from
- * @param property Style name
+ * @param name Style name
  * @param computed Get the computed style? _(defaults to `false`)_
  * @returns Style value
  */
-declare function getStyle(element: Element, property: keyof CSSStyleValues, computed?: boolean): string | undefined;
+declare function getStyle(element: Element, name: keyof CSSValues, computed?: boolean): string | undefined;
 /**
  * Get styles from an element
  *
  * @param element Element to get the styles from
- * @param properties Styles to get
+ * @param names Styles to get
  * @param computed Get the computed styles? _(defaults to `false`)_
  * @returns Style values
  */
-declare function getStyles<Property extends keyof CSSStyleValues>(element: Element, properties: Property[], computed?: boolean): Record<Property, string | undefined>;
+declare function getStyles<Name extends keyof CSSValues>(element: Element, names: Name[], computed?: boolean): Record<Name, string | undefined>;
 /**
  * Get the text direction of a node or element _(or document, if element is invalid)_
  *
@@ -49,17 +45,17 @@ declare function getTextDirection(): TextDirection;
  * Set a style on an element
  *
  * @param element Element to set the style on
- * @param property Style name
+ * @param name Style name
  * @param value Style value
  */
-declare function setStyle(element: Element, property: keyof CSSStyleValues, value?: unknown): void;
+declare function setStyle(element: Element, name: keyof CSSValues, 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;
+declare function setStyles(element: Element, styles: Partial<CSSValues>): void;
 /**
  * Toggle styles for an element
  *
@@ -67,6 +63,6 @@ declare function setStyles(element: Element, styles: Styles): void;
  * @param styles Styles to be set or removed
  * @returns Style toggler
  */
-declare function toggleStyles(element: Element, styles: Styles): StyleToggler;
+declare function toggleStyles(element: Element, styles: Partial<CSSValues>): StyleToggler;
 //#endregion
 export { StyleToggler, getStyle, getStyles, getTextDirection, setStyle, setStyles, toggleStyles };

package/dist/style.mjs

@@ -6,28 +6,28 @@ import { getString } from "@oscarpalmer/atoms/string";
 * Get a style from an element
 *
 * @param element Element to get the style from
-* @param property Style name
+* @param name Style name
 * @param computed Get the computed style? _(defaults to `false`)_
 * @returns Style value
 */
-function getStyle(element, property, computed) {
-	if (element instanceof Element && typeof property === "string") return getStyleValue(element, property, computed === true);
+function getStyle(element, name, computed) {
+	if (element instanceof Element && typeof name === "string") return getStyleValue(element, name, computed === true);
 }
 /**
 * Get styles from an element
 *
 * @param element Element to get the styles from
-* @param properties Styles to get
+* @param names Styles to get
 * @param computed Get the computed styles? _(defaults to `false`)_
 * @returns Style values
 */
-function getStyles(element, properties, computed) {
+function getStyles(element, names, computed) {
 	const styles = {};
-	if (!(element instanceof Element && Array.isArray(properties))) return styles;
-	const { length } = properties;
+	if (!(element instanceof Element && Array.isArray(names))) return styles;
+	const { length } = names;
 	for (let index = 0; index < length; index += 1) {
-		const property = properties[index];
-		if (typeof property === "string") styles[property] = getStyleValue(element, property, computed === true);
+		const name = names[index];
+		if (typeof name === "string") styles[name] = getStyleValue(element, name, computed === true);
 	}
 	return styles;
 }
@@ -43,11 +43,11 @@ function getTextDirection(node) {
 * Set a style on an element
 *
 * @param element Element to set the style on
-* @param property Style name
+* @param name Style name
 * @param value Style value
 */
-function setStyle(element, property, value) {
-	setElementValues(element, property, value, null, updateStyleProperty, true);
+function setStyle(element, name, value) {
+	setElementValues(element, name, value, null, updateStyleProperty, true);
 }
 /**
 * Set styles on an element
@@ -93,12 +93,12 @@ function toggleStyles(element, styles) {
 	};
 }
 function updateStyleProperty(element, key, value) {
-	updateElementValue(element, key, value, function(property, style) {
-		if (property.startsWith(VARIABLE_PREFIX)) this.style.setProperty(property, getString(style));
-		else this.style[property] = getString(style);
-	}, function(property) {
-		if (property.startsWith(VARIABLE_PREFIX)) this.style.removeProperty(property);
-		else this.style[property] = "";
+	updateElementValue(element, key, value, function(name, style) {
+		if (name.startsWith(VARIABLE_PREFIX)) this.style.setProperty(name, getString(style));
+		else this.style[name] = getString(style);
+	}, function(name) {
+		if (name.startsWith(VARIABLE_PREFIX)) this.style.removeProperty(name);
+		else this.style[name] = "";
 		if (this.getAttribute(ATTRIBUTE_STYLE) === "") this.removeAttribute(ATTRIBUTE_STYLE);
 	}, false, false);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/toretto",
-	"version": "0.47.3",
+	"version": "0.49.0",
 	"description": "A collection of badass DOM utilities.",
 	"keywords": [
 		"dom",
@@ -93,10 +93,10 @@
 		"@oscarpalmer/atoms": "^0.188.1"
 	},
 	"devDependencies": {
-		"@oxlint/plugins": "^1.73",
+		"@oxlint/plugins": "^1.76",
 		"@types/node": "^26.1",
 		"@vitest/coverage-istanbul": "^4.1",
-		"jsdom": "^29.1",
+		"jsdom": "^30",
 		"tsdown": "^0.22",
 		"typescript": "^6",
 		"vite": "npm:@voidzero-dev/vite-plus-core@latest",