@oscarpalmer/toretto 0.35.0 → 0.37.0

package/dist/find/relative.js

@@ -1,12 +1,13 @@
 function findAncestor(origin, selector) {
-	if (!(origin instanceof Element) || selector == null) return null;
+	const element = getElement(origin);
+	if (element == null || selector == null) return null;
 	if (typeof selector === "string") {
-		if (origin.matches?.(selector)) return origin;
-		return origin.closest(selector);
+		if (element.matches?.(selector)) return element;
+		return element.closest(selector);
 	}
 	if (typeof selector !== "function") return null;
-	if (selector(origin)) return origin;
-	let parent = origin.parentElement;
+	if (selector(element)) return element;
+	let parent = element.parentElement;
 	while (parent != null && !selector(parent)) {
 		if (parent === document.body) return null;
 		parent = parent.parentElement;
@@ -45,6 +46,10 @@ function getDistance(origin, target) {
 	const preceding = comparison & Node.DOCUMENT_POSITION_PRECEDING;
 	return traverse(preceding ? origin : target, preceding ? target : origin) ?? -1;
 }
+function getElement(origin) {
+	if (origin instanceof Element) return origin;
+	return origin instanceof Event && origin.target instanceof Element ? origin.target : void 0;
+}
 function traverse(from, to) {
 	let current = from;
 	let distance = 0;

package/dist/toretto.full.js

@@ -368,7 +368,7 @@ function toCaseCallback(value) {
 	const { capitalizeAny, capitalizeFirst, type } = this;
 	const parts = words(value);
 	const partsLength = parts.length;
-	const result = [];
+	const cased = [];
 	for (let partIndex = 0; partIndex < partsLength; partIndex += 1) {
 		const items = parts[partIndex].replace(EXPRESSION_ACRONYM, (full, one, two, three) => three === "s" ? full : `${one}-${two}${three}`).replace(EXPRESSION_CAMEL_CASE, REPLACEMENT_CAMEL_CASE).split("-");
 		const itemsLength = items.length;
@@ -381,9 +381,9 @@ function toCaseCallback(value) {
 			else partResult.push(capitalize(item));
 			itemCount += 1;
 		}
-		result.push(join(partResult, delimiters[type]));
+		cased.push(join(partResult, delimiters[type]));
 	}
-	return join(result, delimiters[type]);
+	return join(cased, delimiters[type]);
 }
 var EXPRESSION_CAMEL_CASE = /(\p{Ll})(\p{Lu})/gu;
 var EXPRESSION_ACRONYM = /(\p{Lu}*)(\p{Lu})(\p{Ll}+)/gu;
@@ -417,7 +417,7 @@ function handleValue(data, path, value, get, ignoreCase) {
 	if (typeof data === "object" && data !== null && !ignoreKey(path)) {
 		const key = ignoreCase ? findKey(path, data) : path;
 		if (get) return data[key];
-		data[key] = value;
+		data[key] = typeof value === "function" ? value(data[key]) : value;
 	}
 }
 var EXPRESSION_BRACKET = /\[(\w+)\]/g;
@@ -656,14 +656,15 @@ function on(target, type, listener, options) {
 }
 const PROPERTY_DETAIL = "detail";
 function findAncestor(origin, selector) {
-	if (!(origin instanceof Element) || selector == null) return null;
+	const element = getElement(origin);
+	if (element == null || selector == null) return null;
 	if (typeof selector === "string") {
-		if (origin.matches?.(selector)) return origin;
-		return origin.closest(selector);
+		if (element.matches?.(selector)) return element;
+		return element.closest(selector);
 	}
 	if (typeof selector !== "function") return null;
-	if (selector(origin)) return origin;
-	let parent = origin.parentElement;
+	if (selector(element)) return element;
+	let parent = element.parentElement;
 	while (parent != null && !selector(parent)) {
 		if (parent === document.body) return null;
 		parent = parent.parentElement;
@@ -702,6 +703,10 @@ function getDistance(origin, target) {
 	const preceding = comparison & Node.DOCUMENT_POSITION_PRECEDING;
 	return traverse(preceding ? origin : target, preceding ? target : origin) ?? -1;
 }
+function getElement(origin) {
+	if (origin instanceof Element) return origin;
+	return origin instanceof Event && origin.target instanceof Element ? origin.target : void 0;
+}
 function traverse(from, to) {
 	let current = from;
 	let distance = 0;

package/package.json

@@ -4,19 +4,19 @@
 		"url": "https://oscarpalmer.se"
 	},
 	"dependencies": {
-		"@oscarpalmer/atoms": "^0.127"
+		"@oscarpalmer/atoms": "^0.128.1"
 	},
 	"description": "A collection of badass DOM utilities.",
 	"devDependencies": {
 		"@types/node": "^25",
 		"@vitest/coverage-istanbul": "^4",
 		"jsdom": "^27.4",
-		"oxfmt": "^0.22",
-		"oxlint": "^1.38",
-		"rolldown": "1.0.0-beta.58",
+		"oxfmt": "^0.26",
+		"oxlint": "^1.41",
+		"rolldown": "1.0.0-beta.60",
 		"tslib": "^2.8",
 		"typescript": "^5.9",
-		"vite": "8.0.0-beta.5",
+		"vite": "8.0.0-beta.8",
 		"vitest": "^4"
 	},
 	"exports": {
@@ -93,5 +93,5 @@
 	},
 	"type": "module",
 	"types": "types/index.d.ts",
-	"version": "0.35.0"
+	"version": "0.37.0"
 }

package/src/find/index.ts

@@ -1,12 +1,25 @@
 import type {PlainObject} from '@oscarpalmer/atoms';
 import type {Selector} from '../models';
 
+/**
+ * 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 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 function findElement(selector: string, context?: Selector | null): Element | null;
+
 export function findElement(selector: string, context?: Selector | null): Element | null {
 	return findElementOrElements(selector, context, true) as never;
 }
@@ -103,12 +116,25 @@ function findElementOrElementsFromNodes(
 	return result;
 }
 
+/**
+ * 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 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 function findElements(selector: Selector, context?: Selector | null): Element[];
+
 export function findElements(selector: Selector, context?: Selector | null): Element[] {
 	return findElementOrElements(selector, context, false) as never;
 }

package/src/find/relative.ts

@@ -1,37 +1,58 @@
+/**
+ * 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 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 Element to start from
+ * @param origin Origin to start from
  * @param selector Selector to match
  * @returns Found ancestor or `null`
  */
 export function findAncestor(
-	origin: Element,
+	origin: Element | Event | EventTarget,
+	selector: string | ((element: Element) => boolean),
+): Element | null;
+
+export function findAncestor(
+	origin: Element | Event | EventTarget,
 	selector: string | ((element: Element) => boolean),
 ): Element | null {
-	if (!(origin instanceof Element) || selector == null) {
+	const element = getElement(origin);
+
+	if (element == null || selector == null) {
 		return null;
 	}
 
 	if (typeof selector === 'string') {
-		if (origin.matches?.(selector)) {
-			return origin;
+		if (element.matches?.(selector)) {
+			return element;
 		}
 
-		return origin.closest(selector);
+		return element.closest(selector);
 	}
 
 	if (typeof selector !== 'function') {
 		return null;
 	}
 
-	if (selector(origin)) {
-		return origin;
+	if (selector(element)) {
+		return element;
 	}
 
-	let parent: Element | null = origin.parentElement;
+	let parent: Element | null = element.parentElement;
 
 	while (parent != null && !selector(parent)) {
 		if (parent === document.body) {
@@ -44,6 +65,21 @@ export function findAncestor(
 	return parent;
 }
 
+/**
+ * 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 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
  *
@@ -53,6 +89,12 @@ export function findAncestor(
  * @param context Context to search within
  * @returns Found elements
  */
+export function findRelatives(
+	origin: Element,
+	selector: string,
+	context?: Document | Element,
+): Element[];
+
 export function findRelatives(
 	origin: Element,
 	selector: string,
@@ -95,9 +137,7 @@ export function findRelatives(
 		}
 	}
 
-	return distances
-		.filter(found => found.distance === minimum)
-		.map(found => found.element);
+	return distances.filter(found => found.distance === minimum).map(found => found.element);
 }
 
 /**
@@ -132,6 +172,14 @@ export function getDistance(origin: Element, target: Element): number {
 	return traverse(preceding ? origin : target, preceding ? target : origin) ?? -1;
 }
 
+function getElement(origin: unknown): Element | undefined {
+	if (origin instanceof Element) {
+		return origin;
+	}
+
+	return origin instanceof Event && origin.target instanceof Element ? origin.target : undefined;
+}
+
 function traverse(from: Element, to: Element): number | undefined {
 	let current = from;
 	let distance = 0;

package/types/find/index.d.ts

@@ -1,4 +1,11 @@
 import type { Selector } from '../models';
+/**
+ * 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
@@ -6,6 +13,13 @@ import type { Selector } from '../models';
  * @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

package/types/find/relative.d.ts

@@ -1,13 +1,33 @@
+/**
+ * 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 Element to start from
+ * @param origin Origin to start from
  * @param selector Selector to match
  * @returns Found ancestor or `null`
  */
-export declare function findAncestor(origin: Element, selector: string | ((element: Element) => boolean)): Element | 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
  *