@oscarpalmer/toretto 0.47.2 → 0.48.0

package/dist/aria.d.mts

@@ -1,5 +1,4 @@
 import { AriaAttribute, AriaAttributeUnprefixed, AriaRole } from "./models.mjs";
-
 //#region src/aria.d.ts
 type AnyAriaAttribute = AriaAttribute | AriaAttributeUnprefixed;
 type AriaAttributeItem = {

package/dist/attribute/index.d.mts

@@ -2,7 +2,6 @@ import { Attribute } from "../models.mjs";
 import { getAttribute, getAttributes } from "./get.attribute.mjs";
 import { booleanAttributes } from "../internal/attribute.mjs";
 import { setAttribute, setAttributes } from "./set.attribute.mjs";
-
 //#region src/attribute/index.d.ts
 /**
  * Is the attribute considered bad and potentially harmful?

package/dist/attribute/set.attribute.d.mts

@@ -1,5 +1,4 @@
 import { Attribute } from "../models.mjs";
-
 //#region src/attribute/set.attribute.d.ts
 type DispatchedAttributeName = 'checked' | 'open' | 'value';
 /**

package/dist/create.d.mts

@@ -1,7 +1,6 @@
 import { Primitive } from "@oscarpalmer/atoms/models";
-
 //#region src/create.d.ts
-type Properties<Target extends Element> = { [Property in keyof Target]?: Target[Property] extends Primitive ? Target[Property] : never };
+type Properties<Target extends Element> = { [Property in keyof Target]?: Target[Property] extends Primitive ? Target[Property] : never; };
 type Styles = Partial<Record<keyof CSSStyleDeclaration, unknown>>;
 /**
  * Creates an _HTML_ element with the specified tag name together with optional properties, attributes, and styles

package/dist/data.d.mts

@@ -1,5 +1,4 @@
 import { PlainObject } from "@oscarpalmer/atoms/models";
-
 //#region src/data.d.ts
 /**
  * Get a keyed data value from an element

package/dist/event/delegation.d.mts

@@ -1,5 +1,4 @@
 import { CustomEventListener, RemovableEventListener } from "../models.mjs";
-
 //#region src/event/delegation.d.ts
 type EventTargetWithListeners = EventTarget & Partial<{
   [key: string]: Set<EventListener | CustomEventListener>;

package/dist/event/index.d.mts

@@ -1,6 +1,5 @@
 import { CustomEventListener, RemovableEventListener } from "../models.mjs";
 import { EventPosition } from "@oscarpalmer/atoms/models";
-
 //#region src/event/index.d.ts
 /**
  * Dispatch an event for a target
@@ -9,7 +8,9 @@ import { EventPosition } from "@oscarpalmer/atoms/models";
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventTarget, type: Type, options?: CustomEventInit): void;
+declare function dispatch<Type extends keyof HTMLElementEventMap, Options extends CustomEventInit>(target: EventTarget, type: Type, options?: Options): Options extends {
+  detail: infer Detail;
+} ? CustomEvent<Detail> : Event;
 /**
  * Dispatch an event for a target
  *
@@ -17,7 +18,9 @@ declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventT
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-declare function dispatch(target: EventTarget, type: string, options?: CustomEventInit): void;
+declare function dispatch<Options extends CustomEventInit>(target: EventTarget, type: string, options?: Options): Options extends {
+  detail: infer Detail;
+} ? CustomEvent<Detail> : Event;
 /**
  * Get the X- and Y-coordinates from a pointer event
  *

package/dist/event/index.mjs

@@ -28,7 +28,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

package/dist/find/index.d.mts

@@ -1,7 +1,6 @@
 import { Selector } from "../models.mjs";
 import { findAncestor, findRelatives, getDistance } from "./relative.mjs";
 import { EventPosition } from "@oscarpalmer/atoms/models";
-
 //#region src/find/index.d.ts
 /**
  * Find the first element that matches the tag name

package/dist/html/index.mjs

@@ -1,6 +1,6 @@
 import { sanitizeNodes } from "./sanitize.mjs";
-import { isPlainObject } from "@oscarpalmer/atoms/is";
 import { getString } from "@oscarpalmer/atoms/string";
+import { isPlainObject } from "@oscarpalmer/atoms/is";
 import { SizedMap } from "@oscarpalmer/atoms/sized/map";
 //#region src/html/index.ts
 function createHtml(value) {

package/dist/index.d.mts

@@ -356,7 +356,9 @@ declare function setData(element: Element, key: string, value: unknown): void;
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventTarget, type: Type, options?: CustomEventInit): void;
+declare function dispatch<Type extends keyof HTMLElementEventMap, Options extends CustomEventInit>(target: EventTarget, type: Type, options?: Options): Options extends {
+  detail: infer Detail;
+} ? CustomEvent<Detail> : Event;
 /**
  * Dispatch an event for a target
  *
@@ -364,7 +366,9 @@ declare function dispatch<Type extends keyof HTMLElementEventMap>(target: EventT
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-declare function dispatch(target: EventTarget, type: string, options?: CustomEventInit): void;
+declare function dispatch<Options extends CustomEventInit>(target: EventTarget, type: string, options?: Options): Options extends {
+  detail: infer Detail;
+} ? CustomEvent<Detail> : Event;
 /**
  * Get the X- and Y-coordinates from a pointer event
  *

package/dist/index.mjs

@@ -110,18 +110,6 @@ function words(value) {
 }
 const EXPRESSION_WORDS = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
 //#endregion
-//#region node_modules/@oscarpalmer/atoms/dist/is.mjs
-/**
-* Is the value `undefined`, `null`, or stringified as a whitespace-only string?
-*
-* @param value Value to check
-* @returns `true` if the value is nullable or matches a whitespace-only string, otherwise `false`
-*/
-function isNullableOrWhitespace(value) {
-	return value == null || EXPRESSION_WHITESPACE$1.test(getString(value));
-}
-const EXPRESSION_WHITESPACE$1 = /^\s*$/;
-//#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/string/index.mjs
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
@@ -621,7 +609,7 @@ function setElementValues(element, first, second, third, callback, style) {
 	}
 }
 function updateElementValue(element, key, value, set, remove, isBoolean, json) {
-	if (isBoolean ? value == null : isNullableOrWhitespace(value)) remove.call(element, key);
+	if (value == null) remove.call(element, key);
 	else if (!ignoreSetAttribute(element, key)) set.call(element, key, json ? JSON.stringify(value) : getString(value));
 }
 const CSS_VARIABLE_PREFIX$1 = "--";
@@ -1061,7 +1049,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

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/attribute.mjs

@@ -1,8 +1,8 @@
 import { updateProperty } from "./property.mjs";
 import { updateElementValue } from "./element-value.mjs";
-import { isPlainObject } from "@oscarpalmer/atoms/is";
 import { getString } from "@oscarpalmer/atoms/string";
 import { kebabCase } from "@oscarpalmer/atoms/string/case";
+import { isPlainObject } from "@oscarpalmer/atoms/is";
 //#region src/internal/attribute.ts
 function badAttributeHandler(name, value) {
 	if (typeof name !== "string" || name.trim().length === 0 || typeof value !== "string") return true;

package/dist/internal/element-value.mjs

@@ -1,5 +1,4 @@
 import { isAttribute } from "./attribute.mjs";
-import { isNullableOrWhitespace } from "@oscarpalmer/atoms/is";
 import { getString } from "@oscarpalmer/atoms/string";
 import { kebabCase } from "@oscarpalmer/atoms/string/case";
 //#region src/internal/element-value.ts
@@ -35,7 +34,7 @@ function setElementValues(element, first, second, third, callback, style) {
 	}
 }
 function updateElementValue(element, key, value, set, remove, isBoolean, json) {
-	if (isBoolean ? value == null : isNullableOrWhitespace(value)) remove.call(element, key);
+	if (value == null) remove.call(element, key);
 	else if (!ignoreSetAttribute(element, key)) set.call(element, key, json ? JSON.stringify(value) : getString(value));
 }
 const CSS_VARIABLE_PREFIX = "--";

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

@@ -10,8 +10,8 @@ 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]: string | null; };
+type AriaAttributes = { [Key in keyof ARIAMixin as NormalizedName<Key>]: 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

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,5 +1,4 @@
 import { TextDirection } from "./models.mjs";
-
 //#region src/style.d.ts
 type CSSStyleValues = Variables & CSSStyleDeclaration;
 type StyleToggler = {
@@ -13,7 +12,7 @@ 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 };
+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
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/toretto",
-	"version": "0.47.2",
+	"version": "0.48.0",
 	"description": "A collection of badass DOM utilities.",
 	"keywords": [
 		"dom",
@@ -93,7 +93,7 @@
 		"@oscarpalmer/atoms": "^0.188.1"
 	},
 	"devDependencies": {
-		"@oxlint/plugins": "^1.73",
+		"@oxlint/plugins": "^1.74",
 		"@types/node": "^26.1",
 		"@vitest/coverage-istanbul": "^4.1",
 		"jsdom": "^29.1",

package/src/event/index.ts

@@ -32,7 +32,7 @@ function createDispatchOptions(options: EventInit): EventInit {
 	};
 }
 
-function createEvent(type: string, options?: CustomEventInit): Event {
+function createEvent(type: string, options?: CustomEventInit): CustomEvent | Event {
 	const hasOptions = isPlainObject(options);
 
 	if (hasOptions && 'detail' in (options as CustomEventInit)) {
@@ -61,11 +61,11 @@ function createEventOptions(options?: AddEventListenerOptions): EventOptions {
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-export function dispatch<Type extends keyof HTMLElementEventMap>(
+export function dispatch<Type extends keyof HTMLElementEventMap, Options extends CustomEventInit>(
 	target: EventTarget,
 	type: Type,
-	options?: CustomEventInit,
-): void;
+	options?: Options,
+): Options extends {detail: infer Detail} ? CustomEvent<Detail> : Event;
 
 /**
  * Dispatch an event for a target
@@ -74,16 +74,26 @@ export function dispatch<Type extends keyof HTMLElementEventMap>(
  * @param type Type of event
  * @param options Options for event _(bubbles and is cancelable by default)_
  */
-export function dispatch(target: EventTarget, type: string, options?: CustomEventInit): void;
+export function dispatch<Options extends CustomEventInit>(
+	target: EventTarget,
+	type: string,
+	options?: Options,
+): Options extends {detail: infer Detail} ? CustomEvent<Detail> : Event;
 
 export function dispatch<Type extends keyof HTMLElementEventMap>(
 	target: EventTarget,
 	type: Type | string,
 	options?: CustomEventInit,
-): void {
-	if (isEventTarget(target) && typeof type === 'string') {
-		target.dispatchEvent(createEvent(type, options));
+): CustomEvent | Event | undefined {
+	if (!isEventTarget(target) || typeof type !== 'string') {
+		return;
 	}
+
+	const event = createEvent(type, options);
+
+	target.dispatchEvent(event);
+
+	return event;
 }
 
 /**

package/src/internal/element-value.ts

@@ -1,4 +1,3 @@
-import {isNullableOrWhitespace} from '@oscarpalmer/atoms/is';
 import {getString} from '@oscarpalmer/atoms/string';
 import {kebabCase} from '@oscarpalmer/atoms/string/case';
 import {isAttribute} from './attribute';
@@ -83,7 +82,7 @@ export function updateElementValue(
 	isBoolean: boolean,
 	json: boolean,
 ): void {
-	if (isBoolean ? value == null : isNullableOrWhitespace(value)) {
+	if (value == null) {
 		remove.call(element, key);
 	} else if (!ignoreSetAttribute(element, key)) {
 		set.call(element, key, json ? JSON.stringify(value) : getString(value));