elements-kit 0.19.0 → 0.20.0

package/dist/utilities/retry.test.mjs

@@ -1,85 +0,0 @@
-import { p as onCleanup } from "../lib-Dkc7cV5F.mjs";
-import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { retry } from "./retry.mjs";
-//#region src/utilities/retry.test.ts
-describe("retry", () => {
-	it("resolves immediately on first success", async () => {
-		globalExpect(await retry(() => Promise.resolve(42), 3)()).toBe(42);
-	});
-	it("retries after failure and resolves on later success", async () => {
-		let calls = 0;
-		globalExpect(await retry(() => {
-			calls++;
-			if (calls < 3) return Promise.reject(/* @__PURE__ */ new Error("fail"));
-			return Promise.resolve(calls);
-		}, 3)()).toBe(3);
-		globalExpect(calls).toBe(3);
-	});
-	it("rejects after exhausting all attempts", async () => {
-		const err = /* @__PURE__ */ new Error("always fails");
-		await globalExpect(retry(() => Promise.reject(err), 3)()).rejects.toBe(err);
-	});
-	it("rejects with the last error", async () => {
-		let i = 0;
-		const errors = [
-			/* @__PURE__ */ new Error("a"),
-			/* @__PURE__ */ new Error("b"),
-			/* @__PURE__ */ new Error("c")
-		];
-		await globalExpect(retry(() => Promise.reject(errors[i++]), 3)()).rejects.toBe(errors[2]);
-	});
-	it("delays between failures but not after the last", async () => {
-		const delayFn = vi.fn().mockReturnValue(0);
-		await retry(() => Promise.reject(/* @__PURE__ */ new Error("x")), 3, delayFn)().catch(() => {});
-		globalExpect(delayFn).toHaveBeenCalledTimes(2);
-	});
-	it("supports dynamic delay via function — passes attempt index", async () => {
-		const delayFn = vi.fn().mockReturnValue(0);
-		await retry(() => Promise.reject(/* @__PURE__ */ new Error("x")), 3, delayFn)().catch(() => {});
-		globalExpect(delayFn).toHaveBeenNthCalledWith(1, 0);
-		globalExpect(delayFn).toHaveBeenNthCalledWith(2, 1);
-	});
-	it("onCleanup inside fn fires before each retry", async () => {
-		const cleaned = [];
-		let attempt = 0;
-		await retry(() => {
-			const i = attempt++;
-			onCleanup(() => cleaned.push(i));
-			if (i < 2) return Promise.reject(/* @__PURE__ */ new Error("fail"));
-			return Promise.resolve(i);
-		}, 3)();
-		globalExpect(cleaned).toContain(0);
-		globalExpect(cleaned).toContain(1);
-	});
-	it("composes with async()", async () => {
-		const asyncOp = (await import("./async.mjs")).async;
-		let calls = 0;
-		const op = asyncOp(() => retry(() => {
-			calls++;
-			if (calls < 2) return Promise.reject(/* @__PURE__ */ new Error("fail"));
-			return Promise.resolve(calls);
-		}, 3)());
-		op.start();
-		await op;
-		globalExpect(op.value).toBe(2);
-		op.stop();
-	});
-	it("AbortController cleanup fires between retries when composed with async()", async () => {
-		const asyncOp = (await import("./async.mjs")).async;
-		const aborted = [];
-		let attempt = 0;
-		const op = asyncOp(() => {
-			const i = attempt++;
-			onCleanup(() => aborted.push(i));
-			if (i < 2) return Promise.reject(/* @__PURE__ */ new Error("fail"));
-			return Promise.resolve(i);
-		});
-		op.start();
-		await op.catch(() => {});
-		op.stop();
-	});
-});
-//#endregion
-export {};

package/dist/utilities/routing.test.d.mts

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

package/dist/utilities/routing.test.mjs

@@ -1,129 +0,0 @@
-import { f as it, l as describe, o as afterEach, s as beforeAll } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { isLocalNavigationEvent, match, matches, navigate, patchHistory } from "./routing.mjs";
-//#region src/utilities/routing.test.ts
-beforeAll(() => {
-	patchHistory();
-});
-afterEach(() => {
-	history.replaceState(null, "", "/");
-});
-describe("navigate", () => {
-	it("pushes a new history entry", () => {
-		navigate("/about");
-		globalExpect(location.pathname).toBe("/about");
-	});
-	it("replaces the current entry when replace is true", () => {
-		const before = history.length;
-		navigate("/replaced", { replace: true });
-		globalExpect(location.pathname).toBe("/replaced");
-		globalExpect(history.length).toBe(before);
-	});
-	it("dispatches pushstate event so currentLocation updates", () => {
-		const handler = vi.fn();
-		window.addEventListener("pushstate", handler);
-		navigate("/dispatched");
-		window.removeEventListener("pushstate", handler);
-		globalExpect(handler).toHaveBeenCalledOnce();
-	});
-	it("dispatches replacestate event on replace", () => {
-		const handler = vi.fn();
-		window.addEventListener("replacestate", handler);
-		navigate("/dispatched", { replace: true });
-		window.removeEventListener("replacestate", handler);
-		globalExpect(handler).toHaveBeenCalledOnce();
-	});
-});
-describe("isLocalNavigationEvent", () => {
-	function makeClick(el, init = {}) {
-		const e = new MouseEvent("click", {
-			bubbles: true,
-			cancelable: true,
-			...init
-		});
-		Object.defineProperty(e, "currentTarget", {
-			value: el,
-			configurable: true
-		});
-		return e;
-	}
-	it("returns true for a same-origin link", () => {
-		const el = document.createElement("a");
-		el.href = "/linked";
-		globalExpect(isLocalNavigationEvent(makeClick(el))).toBe(true);
-	});
-	it("returns false for an external link", () => {
-		const el = document.createElement("a");
-		el.href = "https://example.com/page";
-		globalExpect(isLocalNavigationEvent(makeClick(el))).toBe(false);
-	});
-	it("returns false when metaKey is held", () => {
-		const el = document.createElement("a");
-		el.href = "/about";
-		globalExpect(isLocalNavigationEvent(makeClick(el, { metaKey: true }))).toBe(false);
-	});
-	it("returns false when ctrlKey is held", () => {
-		const el = document.createElement("a");
-		el.href = "/about";
-		globalExpect(isLocalNavigationEvent(makeClick(el, { ctrlKey: true }))).toBe(false);
-	});
-	it("returns false for download links", () => {
-		const el = document.createElement("a");
-		el.href = "/file.pdf";
-		el.setAttribute("download", "");
-		globalExpect(isLocalNavigationEvent(makeClick(el))).toBe(false);
-	});
-	it("returns false for _blank links", () => {
-		const el = document.createElement("a");
-		el.href = "/page";
-		el.setAttribute("target", "_blank");
-		globalExpect(isLocalNavigationEvent(makeClick(el))).toBe(false);
-	});
-	it("returns false for non-primary button clicks", () => {
-		const el = document.createElement("a");
-		el.href = "/page";
-		globalExpect(isLocalNavigationEvent(makeClick(el, { button: 1 }))).toBe(false);
-	});
-});
-describe("matches", () => {
-	it("returns true when current URL matches", () => {
-		navigate("/users/42");
-		globalExpect(matches({ pathname: "/users/:id" })()).toBe(true);
-	});
-	it("returns false when current URL does not match", () => {
-		navigate("/other");
-		globalExpect(matches({ pathname: "/users/:id" })()).toBe(false);
-	});
-	it("updates reactively on navigation", () => {
-		const result = matches({ pathname: "/home" });
-		navigate("/other");
-		globalExpect(result()).toBe(false);
-		navigate("/home");
-		globalExpect(result()).toBe(true);
-	});
-});
-describe("match", () => {
-	it("returns null when current URL does not match", () => {
-		navigate("/other");
-		globalExpect(match({ pathname: "/users/:id" })()).toBeNull();
-	});
-	it("returns URLPatternResult with groups when matched", () => {
-		navigate("/users/42");
-		globalExpect(match({ pathname: "/users/:id" })()?.pathname.groups.id).toBe("42");
-	});
-	it("updates reactively on navigation", () => {
-		const result = match({ pathname: "/posts/:slug" });
-		navigate("/posts/hello");
-		globalExpect(result()?.pathname.groups.slug).toBe("hello");
-		navigate("/other");
-		globalExpect(result()).toBeNull();
-	});
-	it("extracts multiple params", () => {
-		navigate("/posts/2024/my-slug");
-		const result = match({ pathname: "/posts/:year/:slug" });
-		globalExpect(result()?.pathname.groups.year).toBe("2024");
-		globalExpect(result()?.pathname.groups.slug).toBe("my-slug");
-	});
-});
-//#endregion
-export {};

package/dist/utilities/search-params.test.d.mts

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

package/dist/utilities/search-params.test.mjs

@@ -1,37 +0,0 @@
-import { c as effectScope } from "../lib-Dkc7cV5F.mjs";
-import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { createSearchParam } from "./search-params.mjs";
-//#region src/utilities/search-params.test.ts
-afterEach(() => {
-	history.replaceState(null, "", location.pathname);
-});
-describe("createSearchParam", () => {
-	it("returns null when param is absent", () => {
-		let s;
-		effectScope(() => {
-			s = createSearchParam("q");
-		});
-		globalExpect(s()).toBeNull();
-	});
-	it("reads an existing param from the URL", () => {
-		history.replaceState(null, "", "?q=hello");
-		let s;
-		effectScope(() => {
-			s = createSearchParam("q");
-		});
-		globalExpect(s()).toBe("hello");
-	});
-	it("reacts to popstate events", () => {
-		let s;
-		effectScope(() => {
-			s = createSearchParam("q");
-		});
-		history.replaceState(null, "", "?q=changed");
-		window.dispatchEvent(new PopStateEvent("popstate"));
-		globalExpect(s()).toBe("changed");
-	});
-});
-//#endregion
-export {};

package/dist/utilities/ssr.test.d.mts

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

package/dist/utilities/ssr.test.mjs

@@ -1,65 +0,0 @@
-import { p as test } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-//#region src/utilities/ssr.test.ts
-// @vitest-environment node
-test.each([
-	"./active-element.ts",
-	"./async.ts",
-	"./debounced.ts",
-	"./element-rect.ts",
-	"./element-scroll.ts",
-	"./environment.ts",
-	"./event-driven.ts",
-	"./event-listener.ts",
-	"./focus-within.ts",
-	"./hover.ts",
-	"./intersection-observer.ts",
-	"./interval.ts",
-	"./location.ts",
-	"./long-press.ts",
-	"./media-devices.ts",
-	"./media-player.ts",
-	"./media-query.ts",
-	"./mutation-observer.ts",
-	"./network.ts",
-	"./on-click-outside.ts",
-	"./orientation.ts",
-	"./previous.ts",
-	"./promise.ts",
-	"./resize-observer.ts",
-	"./retry.ts",
-	"./routing.ts",
-	"./search-params.ts",
-	"./storage.ts",
-	"./throttled.ts",
-	"./timeout.ts",
-	"./window-focus.ts",
-	"./window-size.ts"
-])("imports %s in Node without crashing", async (path) => {
-	await globalExpect(import(path)).resolves.toBeDefined();
-});
-test("singletons return neutral values in Node", async () => {
-	const { windowSize } = await import("./window-size.mjs");
-	globalExpect(windowSize.width()).toBe(0);
-	globalExpect(windowSize.height()).toBe(0);
-	const { online } = await import("./network.mjs");
-	globalExpect(online()).toBe(true);
-	const { windowFocused } = await import("./window-focus.mjs");
-	globalExpect(windowFocused()).toBe(true);
-	const { activeElement } = await import("./active-element.mjs");
-	globalExpect(activeElement()).toBe(null);
-	const { orientation } = await import("./orientation.mjs");
-	globalExpect(orientation.angle()).toBe(0);
-	globalExpect(orientation.type()).toBe("portrait-primary");
-	const { currentLocation } = await import("./location.mjs");
-	globalExpect(currentLocation.href()).toBe("");
-	globalExpect(currentLocation.pathname()).toBe("");
-	globalExpect(currentLocation.search()).toBe("");
-	globalExpect(currentLocation.hash()).toBe("");
-});
-test("isBrowser is false in Node", async () => {
-	const { isBrowser } = await import("./environment.mjs");
-	globalExpect(isBrowser).toBe(false);
-});
-//#endregion
-export {};

package/dist/utilities/storage.test.d.mts

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

package/dist/utilities/storage.test.mjs

@@ -1,139 +0,0 @@
-import { c as effectScope } from "../lib-Dkc7cV5F.mjs";
-import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { createLocalStorage, createSessionStorage } from "./storage.mjs";
-//#region src/utilities/storage.test.ts
-describe("createLocalStorage", () => {
-	afterEach(() => {
-		localStorage.clear();
-	});
-	it("uses initialValue when storage is empty", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("count", 0);
-		});
-		globalExpect(s()).toBe(0);
-	});
-	it("reads an existing value from localStorage", () => {
-		localStorage.setItem("count", "42");
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("count", 0);
-		});
-		globalExpect(s()).toBe(42);
-	});
-	it("persists writes to localStorage", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("key", "a");
-		});
-		s("b");
-		globalExpect(JSON.parse(localStorage.getItem("key"))).toBe("b");
-	});
-	it("persists complex values as JSON", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("obj", { x: 1 });
-		});
-		s({ x: 99 });
-		globalExpect(JSON.parse(localStorage.getItem("obj"))).toEqual({ x: 99 });
-	});
-	it("falls back to initialValue on invalid JSON", () => {
-		localStorage.setItem("broken", "{not json}");
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("broken", 7);
-		});
-		globalExpect(s()).toBe(7);
-	});
-	it("supports custom serialise / deserialise", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("date", /* @__PURE__ */ new Date("2024-01-01"), {
-				serialise: (d) => d.toISOString(),
-				deserialise: (raw) => new Date(raw)
-			});
-		});
-		const d = /* @__PURE__ */ new Date("2025-06-15");
-		s(d);
-		globalExpect(localStorage.getItem("date")).toBe(d.toISOString());
-	});
-	it("reacts to storage events from other tabs", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("sync-key", "init");
-		});
-		localStorage.setItem("sync-key", JSON.stringify("from-other-tab"));
-		window.dispatchEvent(new StorageEvent("storage", {
-			key: "sync-key",
-			newValue: JSON.stringify("from-other-tab"),
-			storageArea: localStorage
-		}));
-		globalExpect(s()).toBe("from-other-tab");
-	});
-	it("ignores storage events for different keys", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("my-key", "init");
-		});
-		window.dispatchEvent(new StorageEvent("storage", {
-			key: "other-key",
-			newValue: JSON.stringify("nope"),
-			storageArea: localStorage
-		}));
-		globalExpect(s()).toBe("init");
-	});
-	it("resets to initialValue when key is removed", () => {
-		let s;
-		effectScope(() => {
-			s = createLocalStorage("rm-key", "default");
-		});
-		s("changed");
-		localStorage.removeItem("rm-key");
-		window.dispatchEvent(new StorageEvent("storage", {
-			key: "rm-key",
-			newValue: null,
-			storageArea: localStorage
-		}));
-		globalExpect(s()).toBe("default");
-	});
-});
-describe("createSessionStorage", () => {
-	afterEach(() => {
-		sessionStorage.clear();
-	});
-	it("uses initialValue when storage is empty", () => {
-		let s;
-		effectScope(() => {
-			s = createSessionStorage("count", 0);
-		});
-		globalExpect(s()).toBe(0);
-	});
-	it("reads an existing value from sessionStorage", () => {
-		sessionStorage.setItem("count", "42");
-		let s;
-		effectScope(() => {
-			s = createSessionStorage("count", 0);
-		});
-		globalExpect(s()).toBe(42);
-	});
-	it("persists writes to sessionStorage", () => {
-		let s;
-		effectScope(() => {
-			s = createSessionStorage("key", "a");
-		});
-		s("b");
-		globalExpect(JSON.parse(sessionStorage.getItem("key"))).toBe("b");
-	});
-	it("falls back to initialValue on invalid JSON", () => {
-		sessionStorage.setItem("broken", "{not json}");
-		let s;
-		effectScope(() => {
-			s = createSessionStorage("broken", 7);
-		});
-		globalExpect(s()).toBe(7);
-	});
-});
-//#endregion
-export {};

package/dist/utilities/throttled.test.d.mts

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

package/dist/utilities/throttled.test.mjs

@@ -1,58 +0,0 @@
-import { c as effectScope, m as signal } from "../lib-Dkc7cV5F.mjs";
-import "../signals/index.mjs";
-import { c as beforeEach, f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { createThrottled } from "./throttled.mjs";
-//#region src/utilities/throttled.test.ts
-beforeEach(() => {
-	vi.useFakeTimers();
-});
-afterEach(() => {
-	vi.useRealTimers();
-});
-describe("createThrottled", () => {
-	it("returns the initial value synchronously", () => {
-		const s = signal(7);
-		let t;
-		effectScope(() => {
-			t = createThrottled(() => s(), 200);
-		});
-		globalExpect(t()).toBe(7);
-	});
-	it("passes through the first change immediately (leading edge)", () => {
-		const s = signal(0);
-		let t;
-		effectScope(() => {
-			t = createThrottled(() => s(), 200);
-		});
-		s(1);
-		globalExpect(t()).toBe(1);
-	});
-	it("schedules a trailing update for rapid changes within the interval", () => {
-		const s = signal(0);
-		let t;
-		effectScope(() => {
-			t = createThrottled(() => s(), 200);
-		});
-		s(1);
-		globalExpect(t()).toBe(1);
-		s(2);
-		globalExpect(t()).toBe(1);
-		vi.advanceTimersByTime(200);
-		globalExpect(t()).toBe(2);
-	});
-	it("stops updating after scope disposal", () => {
-		const s = signal(0);
-		let t;
-		const stop = effectScope(() => {
-			t = createThrottled(() => s(), 200);
-		});
-		s(1);
-		stop();
-		s(99);
-		vi.advanceTimersByTime(400);
-		globalExpect(t()).toBe(1);
-	});
-});
-//#endregion
-export {};

package/dist/utilities/timeout.test.d.mts

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

package/dist/utilities/timeout.test.mjs

@@ -1,121 +0,0 @@
-import { c as effectScope } from "../lib-Dkc7cV5F.mjs";
-import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CSLAXL5f.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-Ddz9cDxc.mjs";
-import { createTimeout } from "./timeout.mjs";
-//#region src/utilities/timeout.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.useRealTimers();
-});
-describe("createTimeout", () => {
-	it("starts as running", () => {
-		vi.useFakeTimers();
-		let t;
-		const cb = vi.fn();
-		effectScope(() => {
-			t = createTimeout(cb, 500);
-		});
-		globalExpect(t.pending()).toBe(true);
-	});
-	it("fires callback after delay", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		effectScope(() => {
-			createTimeout(cb, 500);
-		});
-		vi.advanceTimersByTime(600);
-		globalExpect(cb).toHaveBeenCalledOnce();
-	});
-	it("pending becomes false after firing", () => {
-		vi.useFakeTimers();
-		let t;
-		effectScope(() => {
-			t = createTimeout(vi.fn(), 200);
-		});
-		vi.advanceTimersByTime(300);
-		globalExpect(t.pending()).toBe(false);
-	});
-	it("stop() cancels the timeout", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		let t;
-		effectScope(() => {
-			t = createTimeout(cb, 500);
-		});
-		t.stop();
-		vi.advanceTimersByTime(1e3);
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-	it("reset() restarts the timer", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		let t;
-		effectScope(() => {
-			t = createTimeout(cb, 500);
-		});
-		vi.advanceTimersByTime(300);
-		t.reset();
-		vi.advanceTimersByTime(300);
-		globalExpect(cb).not.toHaveBeenCalled();
-		vi.advanceTimersByTime(300);
-		globalExpect(cb).toHaveBeenCalledOnce();
-	});
-	it("immediate=false does not start automatically", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		let t;
-		effectScope(() => {
-			t = createTimeout(cb, 200, false);
-		});
-		globalExpect(t.pending()).toBe(false);
-		vi.advanceTimersByTime(300);
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-	it("start() fires after delay when called manually", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		let t;
-		effectScope(() => {
-			t = createTimeout(cb, 200, false);
-		});
-		t.start();
-		globalExpect(t.pending()).toBe(true);
-		vi.advanceTimersByTime(200);
-		globalExpect(cb).toHaveBeenCalledOnce();
-		globalExpect(t.pending()).toBe(false);
-	});
-	it("Symbol.dispose cancels the timeout", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		let t;
-		effectScope(() => {
-			t = createTimeout(cb, 500);
-		});
-		t[Symbol.dispose]();
-		vi.advanceTimersByTime(1e3);
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-	it("stops when scope is disposed", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		effectScope(() => {
-			createTimeout(cb, 200);
-		})();
-		vi.advanceTimersByTime(500);
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-	it("dynamic delay function is called at start", () => {
-		vi.useFakeTimers();
-		const cb = vi.fn();
-		const getDelay = vi.fn().mockReturnValue(300);
-		effectScope(() => {
-			createTimeout(cb, getDelay);
-		});
-		vi.advanceTimersByTime(300);
-		globalExpect(cb).toHaveBeenCalledOnce();
-		globalExpect(getDelay).toHaveBeenCalledOnce();
-	});
-});
-//#endregion
-export {};

package/dist/utilities/window-size.test.d.mts

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