@oscarpalmer/toretto 0.39.1 → 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

@@ -94,5 +94,5 @@
 	},
 	"type": "module",
 	"types": "types/index.d.ts",
-	"version": "0.39.1"
+	"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

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