@oscarpalmer/toretto 0.26.1 → 0.28.0

package/src/html.ts

@@ -1,9 +1,5 @@
 import {isPlainObject} from '@oscarpalmer/atoms/is';
-import {
-	type SanitizeOptions,
-	getSanitizeOptions,
-	sanitizeNodes,
-} from './internal/sanitize';
+import {getSanitizeOptions, type SanitizeOptions, sanitizeNodes} from './internal/sanitize';
 
 //
 
@@ -59,18 +55,13 @@ function createTemplate(html: string, ignore: boolean): HTMLTemplateElement {
 	return template;
 }
 
-function getHtml(
-	value: string | HTMLTemplateElement,
-	options: Options,
-): Node[] {
+function getHtml(value: string | HTMLTemplateElement, options: Options): Node[] {
 	if (typeof value !== 'string' && !(value instanceof HTMLTemplateElement)) {
 		return [];
 	}
 
 	const template =
-		value instanceof HTMLTemplateElement
-			? value
-			: getTemplate(value, options.ignoreCache);
+		value instanceof HTMLTemplateElement ? value : getTemplate(value, options.ignoreCache);
 
 	if (template == null) {
 		return [];
@@ -92,8 +83,7 @@ function getHtml(
 function getOptions(input?: HtmlOptions): Options {
 	const options = isPlainObject(input) ? input : {};
 
-	options.ignoreCache =
-		typeof options.ignoreCache === 'boolean' ? options.ignoreCache : false;
+	options.ignoreCache = typeof options.ignoreCache === 'boolean' ? options.ignoreCache : false;
 
 	options.sanitizeBooleanAttributes =
 		typeof options.sanitizeBooleanAttributes === 'boolean'
@@ -103,10 +93,7 @@ function getOptions(input?: HtmlOptions): Options {
 	return options as Options;
 }
 
-function getTemplate(
-	value: string,
-	ignore: boolean,
-): HTMLTemplateElement | undefined {
+function getTemplate(value: string, ignore: boolean): HTMLTemplateElement | undefined {
 	if (typeof value !== 'string' || value.trim().length === 0) {
 		return;
 	}
@@ -117,22 +104,14 @@ function getTemplate(
 		return template;
 	}
 
-	const element = EXPRESSION_ID.test(value)
-		? document.querySelector(`#${value}`)
-		: null;
+	const element = EXPRESSION_ID.test(value) ? document.querySelector(`#${value}`) : null;
 
-	template =
-		element instanceof HTMLTemplateElement
-			? element
-			: createTemplate(value, ignore);
+	template = element instanceof HTMLTemplateElement ? element : createTemplate(value, ignore);
 
 	return template;
 }
 
-const html = ((
-	value: string | HTMLTemplateElement,
-	options?: Options,
-): Node[] => {
+const html = ((value: string | HTMLTemplateElement, options?: Options): Node[] => {
 	return getHtml(value, getOptions(options));
 }) as Html;
 
@@ -167,14 +146,8 @@ html.remove = (template: string): void => {
  * @param options Sanitization options
  * @returns Sanitized nodes
  */
-export function sanitize(
-	value: Node | Node[],
-	options?: SanitizeOptions,
-): Node[] {
-	return sanitizeNodes(
-		Array.isArray(value) ? value : [value],
-		getSanitizeOptions(options),
-	);
+export function sanitize(value: Node | Node[], options?: SanitizeOptions): Node[] {
+	return sanitizeNodes(Array.isArray(value) ? value : [value], getSanitizeOptions(options));
 }
 
 //

package/src/internal/attribute.ts

@@ -1,6 +1,8 @@
 import type {PlainObject} from '@oscarpalmer/atoms';
 import {isPlainObject} from '@oscarpalmer/atoms/is';
-import type {Attribute} from '../models';
+import {getString} from '@oscarpalmer/atoms/string';
+import type {Attribute, HTMLOrSVGElement, Property} from '../models';
+import {isHTMLOrSVGElement} from './is';
 
 function isAttribute(value: unknown): value is Attr | Attribute {
 	return (
@@ -26,10 +28,7 @@ export function isBadAttribute(attribute: Attr | Attribute): boolean;
  */
 export function isBadAttribute(name: string, value: string): boolean;
 
-export function isBadAttribute(
-	first: string | Attr | Attribute,
-	second?: string,
-): boolean {
+export function isBadAttribute(first: string | Attr | Attribute, second?: string): boolean {
 	return isValidAttribute(
 		attribute =>
 			attribute == null ||
@@ -57,9 +56,7 @@ export function isBooleanAttribute(name: string): boolean;
 
 export function isBooleanAttribute(value: string | Attr | Attribute): boolean {
 	return isValidAttribute(
-		attribute =>
-			attribute != null &&
-			booleanAttributes.includes(attribute.name.toLowerCase()),
+		attribute => attribute != null && booleanAttributes.includes(attribute.name.toLowerCase()),
 		value,
 		'',
 	);
@@ -70,9 +67,7 @@ export function isBooleanAttribute(value: string | Attr | Attribute): boolean {
  * @param attribute Attribute to check
  * @returns `true` if attribute is empty and not a boolean attribute
  */
-export function isEmptyNonBooleanAttribute(
-	attribute: Attr | Attribute,
-): boolean;
+export function isEmptyNonBooleanAttribute(attribute: Attr | Attribute): boolean;
 
 /**
  * Is the attribute empty and not a boolean attribute?
@@ -80,10 +75,7 @@ export function isEmptyNonBooleanAttribute(
  * @param value Attribute value
  * @returns `true` if attribute is empty and not a boolean attribute
  */
-export function isEmptyNonBooleanAttribute(
-	name: string,
-	value: string,
-): boolean;
+export function isEmptyNonBooleanAttribute(name: string, value: string): boolean;
 
 export function isEmptyNonBooleanAttribute(
 	first: string | Attr | Attribute,
@@ -141,6 +133,10 @@ export function isInvalidBooleanAttribute(
 	);
 }
 
+export function isProperty(value: unknown): value is Property {
+	return isPlainObject(value) && typeof (value as PlainObject).name === 'string';
+}
+
 function isValidAttribute(
 	callback: (attribute: Attr | Attribute | undefined) => boolean,
 	first: string | Attr | Attribute,
@@ -157,6 +153,62 @@ function isValidAttribute(
 	return callback(attribute);
 }
 
+function updateAttribute(element: HTMLOrSVGElement, name: string, value: unknown): void {
+	const isBoolean = booleanAttributes.includes(name.toLowerCase());
+
+	if (isBoolean) {
+		updateProperty(element, name, value);
+	}
+
+	if (isBoolean ? value !== true : value == null) {
+		element.removeAttribute(name);
+	} else {
+		element.setAttribute(name, isBoolean ? '' : getString(value));
+	}
+}
+
+function updateProperty(element: HTMLOrSVGElement, name: string, value: unknown): void {
+	const actual = name.toLowerCase();
+
+	(element as unknown as PlainObject)[actual] =
+		value === '' || (typeof value === 'string' && value.toLowerCase() === actual) || value === true;
+}
+
+export function updateValue(element: HTMLOrSVGElement, first: unknown, second: unknown): void {
+	if (!isHTMLOrSVGElement(element)) {
+		return;
+	}
+
+	if (isProperty(first)) {
+		updateAttribute(element, (first as Attribute).name, (first as Attribute).value);
+	} else if (typeof first === 'string') {
+		updateAttribute(element, first as string, second);
+	}
+}
+
+export function updateValues(
+	element: HTMLOrSVGElement,
+	values: Attribute<unknown>[] | Record<string, unknown>,
+): void {
+	if (!isHTMLOrSVGElement(element)) {
+		return;
+	}
+
+	const isArray = Array.isArray(values);
+	const entries = Object.entries(values);
+	const {length} = entries;
+
+	for (let index = 0; index < length; index += 1) {
+		const entry = entries[index];
+
+		if (isArray) {
+			updateAttribute(element, (entry[1] as Attribute).name, (entry[1] as Attribute).value);
+		} else {
+			updateAttribute(element, entry[0], entry[1]);
+		}
+	}
+}
+
 //
 
 const EXPRESSION_ON_PREFIX = /^on/i;

package/src/internal/element-value.ts

@@ -27,7 +27,6 @@ export function setElementValues(
 	}
 }
 
-// biome-ignore lint/nursery/useMaxParams: Internal function, so it's fine
 export function updateElementValue(
 	element: HTMLOrSVGElement,
 	key: string,

package/src/internal/get-value.ts

@@ -14,9 +14,7 @@ export function getAttributeValue(
 	const attribute = element.attributes[normalized as keyof NamedNodeMap];
 	const value = attribute instanceof Attr ? attribute.value : undefined;
 
-	return EXPRESSION_DATA_PREFIX.test(normalized) &&
-		typeof value === 'string' &&
-		parseValue
+	return EXPRESSION_DATA_PREFIX.test(normalized) && typeof value === 'string' && parseValue
 		? (parse(value) ?? value)
 		: value;
 }
@@ -28,9 +26,7 @@ export function getStyleValue(
 ): string | undefined {
 	const name = camelCase(property);
 
-	return computed
-		? getComputedStyle(element)[name as never]
-		: element.style[name as never];
+	return computed ? getComputedStyle(element)[name as never] : element.style[name as never];
 }
 
 export const EXPRESSION_DATA_PREFIX = /^data-/i;

package/src/internal/sanitize.ts

@@ -1,9 +1,5 @@
 import {isPlainObject} from '@oscarpalmer/atoms/is';
-import {
-	isBadAttribute,
-	isEmptyNonBooleanAttribute,
-	isInvalidBooleanAttribute,
-} from './attribute';
+import {isBadAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute} from './attribute';
 
 //
 
@@ -31,11 +27,7 @@ export function getSanitizeOptions(input?: SanitizeOptions): Options {
 	return options as Options;
 }
 
-export function sanitizeAttributes(
-	element: Element,
-	attributes: Attr[],
-	options: Options,
-): void {
+export function sanitizeAttributes(element: Element, attributes: Attr[], options: Options): void {
 	const {length} = attributes;
 
 	for (let index = 0; index < length; index += 1) {
@@ -43,10 +35,7 @@ export function sanitizeAttributes(
 
 		if (isBadAttribute(attribute) || isEmptyNonBooleanAttribute(attribute)) {
 			element.removeAttribute(attribute.name);
-		} else if (
-			options.sanitizeBooleanAttributes &&
-			isInvalidBooleanAttribute(attribute)
-		) {
+		} else if (options.sanitizeBooleanAttributes && isInvalidBooleanAttribute(attribute)) {
 			element.setAttribute(attribute.name, '');
 		}
 	}

package/src/is.ts

@@ -48,4 +48,4 @@ const CHILD_NODE_TYPES: Set<number> = new Set([
 
 //
 
-export {isEventTarget, isHTMLOrSVGElement} from './internal/is'
+export {isEventTarget, isHTMLOrSVGElement} from './internal/is';

package/src/style.ts

@@ -57,11 +57,7 @@ export function getStyles<Property extends keyof CSSStyleDeclaration>(
 		const property = properties[index];
 
 		if (typeof property === 'string') {
-			styles[property] = getStyleValue(
-				element,
-				property,
-				computed === true,
-			) as never;
+			styles[property] = getStyleValue(element, property, computed === true) as never;
 		}
 	}
 
@@ -74,10 +70,7 @@ export function getStyles<Property extends keyof CSSStyleDeclaration>(
  * @param computed Get the computed text direction? _(defaults to `false`)_
  * @returns Text direction
  */
-export function getTextDirection(
-	element: HTMLOrSVGElement,
-	computed?: boolean,
-): TextDirection {
+export function getTextDirection(element: HTMLOrSVGElement, computed?: boolean): TextDirection {
 	if (!(element instanceof Element)) {
 		return undefined as never;
 	}
@@ -112,10 +105,7 @@ export function setStyle(
  * @param element Element to set the styles on
  * @param styles Styles to set
  */
-export function setStyles(
-	element: HTMLOrSVGElement,
-	styles: Partial<CSSStyleDeclaration>,
-): void {
+export function setStyles(element: HTMLOrSVGElement, styles: Partial<CSSStyleDeclaration>): void {
 	setElementValues(element, styles as never, null, updateStyleProperty);
 }
 
@@ -170,11 +160,7 @@ export function toggleStyles(
 	};
 }
 
-function updateStyleProperty(
-	element: HTMLOrSVGElement,
-	key: string,
-	value: unknown,
-): void {
+function updateStyleProperty(element: HTMLOrSVGElement, key: string, value: unknown): void {
 	updateElementValue(
 		element,
 		key,

package/src/touch.ts

@@ -36,16 +36,12 @@ function getSupport(): boolean {
 		return true;
 	}
 
-	if (
-		typeof navigator.maxTouchPoints === 'number' &&
-		navigator.maxTouchPoints > 0
-	) {
+	if (typeof navigator.maxTouchPoints === 'number' && navigator.maxTouchPoints > 0) {
 		return true;
 	}
 
 	if (
-		typeof (navigator as NavigatorWithMsMaxTouchPoints).msMaxTouchPoints ===
-			'number' &&
+		typeof (navigator as NavigatorWithMsMaxTouchPoints).msMaxTouchPoints === 'number' &&
 		(navigator as NavigatorWithMsMaxTouchPoints).msMaxTouchPoints > 0
 	) {
 		return true;

package/types/attribute/set.d.ts

@@ -4,18 +4,18 @@ import type { Attribute, HTMLOrSVGElement, Property } from '../models';
  *
  * _(Or remove it, if value is `null` or `undefined`)_
  * @param element Element for attribute
- * @param attribute Attribute to set
+ * @param name Attribute name
+ * @param value Attribute value
  */
-export declare function setAttribute(element: HTMLOrSVGElement, attribute: Attr | Attribute): void;
+export declare function setAttribute(element: HTMLOrSVGElement, 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 name Attribute name
- * @param value Attribute value
+ * @param attribute Attribute to set
  */
-export declare function setAttribute(element: HTMLOrSVGElement, name: string, value?: unknown): void;
+export declare function setAttribute(element: HTMLOrSVGElement, attribute: Attr | Attribute): void;
 /**
  * Set one or more attributes on an element
  *
@@ -37,18 +37,18 @@ export declare function setAttributes(element: HTMLOrSVGElement, attributes: Rec
  *
  * _(Or remove it, if value is not an empty string or does not match the name)_
  * @param element Element for property
- * @param property Property to set
+ * @param name Property name
+ * @param value Property value
  */
-export declare function setProperty(element: HTMLOrSVGElement, property: Property): void;
+export declare function setProperty(element: HTMLOrSVGElement, name: string, value: boolean | string): void;
 /**
  * Set a property on an element
  *
  * _(Or remove it, if value is not an empty string or does not match the name)_
  * @param element Element for property
- * @param name Property name
- * @param value Property value
+ * @param property Property to set
  */
-export declare function setProperty(element: HTMLOrSVGElement, name: string, value: boolean | string): void;
+export declare function setProperty(element: HTMLOrSVGElement, property: Property): void;
 /**
  * Set one or more properties on an element
  *

package/types/event/index.d.ts

@@ -19,6 +19,14 @@ export declare function dispatch(target: EventTarget, type: string, options?: Cu
  * @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

package/types/internal/attribute.d.ts

@@ -1,4 +1,4 @@
-import type { Attribute } from '../models';
+import type { Attribute, HTMLOrSVGElement, Property } from '../models';
 /**
  * Is the attribute considered bad and potentially harmful?
  * @param attribute Attribute to check
@@ -54,6 +54,9 @@ export declare function isInvalidBooleanAttribute(attribute: Attr | Attribute):
  * @returns `true` if attribute is an invalid boolean attribute
  */
 export declare function isInvalidBooleanAttribute(name: string, value: string): boolean;
+export declare function isProperty(value: unknown): value is Property;
+export declare function updateValue(element: HTMLOrSVGElement, first: unknown, second: unknown): void;
+export declare function updateValues(element: HTMLOrSVGElement, values: Attribute<unknown>[] | Record<string, unknown>): void;
 /**
  * List of boolean attributes
  */

package/dist/attribute/is.js

@@ -1,5 +0,0 @@
-import { isPlainObject } from "@oscarpalmer/atoms/is";
-function isProperty(value) {
-	return isPlainObject(value) && typeof value.name === "string";
-}
-export { isProperty };

package/dist/attribute/update.js

@@ -1,31 +0,0 @@
-import { isHTMLOrSVGElement } from "../internal/is.js";
-import { booleanAttributes } from "../internal/attribute.js";
-import { isProperty } from "./is.js";
-import { getString } from "@oscarpalmer/atoms/string";
-function updateAttribute(element, name, value) {
-	if (booleanAttributes.includes(name.toLowerCase())) updateProperty(element, name, value, false);
-	else if (value == null) element.removeAttribute(name);
-	else element.setAttribute(name, typeof value === "string" ? value : getString(value));
-}
-function updateProperty(element, name, value, validate) {
-	const actual = validate ?? true ? name.toLowerCase() : name;
-	if (actual === "hidden") element.hidden = value === "" || value === true;
-	else element[actual] = value === "" || typeof value === "string" && value.toLowerCase() === actual || value === true;
-}
-function updateValue(element, first, second, callback) {
-	if (!isHTMLOrSVGElement(element)) return;
-	if (isProperty(first)) callback(element, first.name, first.value);
-	else if (typeof first === "string") callback(element, first, second);
-}
-function updateValues(element, values, callback) {
-	if (!isHTMLOrSVGElement(element)) return;
-	const isArray = Array.isArray(values);
-	const entries = Object.entries(values);
-	const { length } = entries;
-	for (let index = 0; index < length; index += 1) {
-		const entry = entries[index];
-		if (isArray) (callback ?? updateAttribute)(element, entry[1].name, entry[1].value);
-		else (callback ?? updateAttribute)(element, entry[0], entry[1]);
-	}
-}
-export { updateAttribute, updateProperty, updateValue, updateValues };

package/src/attribute/is.ts

@@ -1,9 +0,0 @@
-import type {PlainObject} from '@oscarpalmer/atoms';
-import {isPlainObject} from '@oscarpalmer/atoms/is';
-import type {Property} from '../models';
-
-export function isProperty(value: unknown): value is Property {
-	return (
-		isPlainObject(value) && typeof (value as PlainObject).name === 'string'
-	);
-}

package/src/attribute/update.ts

@@ -1,86 +0,0 @@
-import type {PlainObject} from '@oscarpalmer/atoms';
-import {getString} from '@oscarpalmer/atoms/string';
-import {booleanAttributes} from '../internal/attribute';
-import {isHTMLOrSVGElement} from '../internal/is';
-import type {Attribute, HTMLOrSVGElement} from '../models';
-import {isProperty} from './is';
-
-export function updateAttribute(
-	element: HTMLOrSVGElement,
-	name: string,
-	value: unknown,
-): void {
-	if (booleanAttributes.includes(name.toLowerCase())) {
-		updateProperty(element, name, value, false);
-	} else if (value == null) {
-		element.removeAttribute(name);
-	} else {
-		element.setAttribute(
-			name,
-			typeof value === 'string' ? value : getString(value),
-		);
-	}
-}
-
-export function updateProperty(
-	element: HTMLOrSVGElement,
-	name: string,
-	value: unknown,
-	validate?: boolean,
-): void {
-	const actual = (validate ?? true) ? name.toLowerCase() : name;
-
-	if (actual === 'hidden') {
-		(element as HTMLElement).hidden = value === '' || value === true;
-	} else {
-		(element as unknown as PlainObject)[actual] =
-			value === '' ||
-			(typeof value === 'string' && value.toLowerCase() === actual) ||
-			value === true;
-	}
-}
-
-export function updateValue(
-	element: HTMLOrSVGElement,
-	first: unknown,
-	second: unknown,
-	callback: (element: HTMLOrSVGElement, name: string, value: unknown) => void,
-): void {
-	if (!isHTMLOrSVGElement(element)) {
-		return;
-	}
-
-	if (isProperty(first)) {
-		callback(element, (first as Attribute).name, (first as Attribute).value);
-	} else if (typeof first === 'string') {
-		callback(element, first as string, second);
-	}
-}
-
-export function updateValues(
-	element: HTMLOrSVGElement,
-	values: Attribute<unknown>[] | Record<string, unknown>,
-	callback?: (element: HTMLOrSVGElement, name: string, value: unknown) => void,
-): void {
-	if (!isHTMLOrSVGElement(element)) {
-		return;
-	}
-
-	const isArray = Array.isArray(values);
-	const entries = Object.entries(values);
-	const {length} = entries;
-
-	for (let index = 0; index < length; index += 1) {
-		const entry = entries[index];
-
-		if (isArray) {
-			(callback ?? updateAttribute)(
-				element,
-				(entry[1] as Attribute).name,
-				(entry[1] as Attribute).value,
-			);
-		} else {
-			(callback ?? updateAttribute)(element, entry[0], entry[1]);
-		}
-	}
-}

package/types/attribute/is.d.ts

@@ -1,2 +0,0 @@
-import type { Property } from '../models';
-export declare function isProperty(value: unknown): value is Property;

package/types/attribute/misc.d.ts

@@ -1 +0,0 @@
-export {};

package/types/attribute/update.d.ts

@@ -1,5 +0,0 @@
-import type { Attribute, HTMLOrSVGElement } from '../models';
-export declare function updateAttribute(element: HTMLOrSVGElement, name: string, value: unknown): void;
-export declare function updateProperty(element: HTMLOrSVGElement, name: string, value: unknown, validate?: boolean): void;
-export declare function updateValue(element: HTMLOrSVGElement, first: unknown, second: unknown, callback: (element: HTMLOrSVGElement, name: string, value: unknown) => void): void;
-export declare function updateValues(element: HTMLOrSVGElement, values: Attribute<unknown>[] | Record<string, unknown>, callback?: (element: HTMLOrSVGElement, name: string, value: unknown) => void): void;