elements-kit 0.0.10 → 0.0.11

package/dist/signals/lib/battery.test.mjs

@@ -1,38 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, n as vi, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createBattery } from "./battery.mjs";
-//#region src/signals/lib/battery.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.unstubAllGlobals();
-});
-describe("createBattery", () => {
-	it("returns unsupported=false when getBattery not present", () => {
-		vi.stubGlobal("navigator", {});
-		let b;
-		effectScope(() => {
-			b = createBattery();
-		});
-		globalExpect(b.supported()).toBe(false);
-	});
-	it("fetches battery info via getBattery", async () => {
-		const batteryMock = {
-			charging: true,
-			level: .8,
-			chargingTime: 3600,
-			dischargingTime: Infinity,
-			addEventListener: vi.fn(),
-			removeEventListener: vi.fn()
-		};
-		vi.stubGlobal("navigator", { getBattery: vi.fn().mockResolvedValue(batteryMock) });
-		let b;
-		effectScope(() => {
-			b = createBattery();
-		});
-		await new Promise((res) => setTimeout(res, 0));
-		globalExpect(b.charging()).toBe(true);
-		globalExpect(b.level()).toBe(.8);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/before-unload.d.mts

@@ -1,11 +0,0 @@
-//#region src/signals/lib/before-unload.d.ts
-/**
- * Registers a `beforeunload` handler that shows a native confirmation dialog
- * when the user tries to leave the page.
- *
- * `message` can be a string or a reactive getter (re-evaluated on each event).
- * Modern browsers ignore custom messages and show a generic prompt instead.
- */
-declare function createBeforeUnload(message?: string | (() => string)): Disposable;
-//#endregion
-export { createBeforeUnload };

package/dist/signals/lib/before-unload.mjs

@@ -1,20 +0,0 @@
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/before-unload.ts
-/**
-* Registers a `beforeunload` handler that shows a native confirmation dialog
-* when the user tries to leave the page.
-*
-* `message` can be a string or a reactive getter (re-evaluated on each event).
-* Modern browsers ignore custom messages and show a generic prompt instead.
-*/
-function createBeforeUnload(message) {
-	const handler = (e) => {
-		const msg = typeof message === "function" ? message() : message;
-		e.preventDefault();
-		if (msg !== void 0) e.returnValue = msg;
-	};
-	const cleanup = createEventListener(window, "beforeunload", handler);
-	return { [Symbol.dispose]: cleanup };
-}
-//#endregion
-export { createBeforeUnload };

package/dist/signals/lib/before-unload.test.mjs

@@ -1,29 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, n as vi, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createBeforeUnload } from "./before-unload.mjs";
-//#region src/signals/lib/before-unload.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createBeforeUnload", () => {
-	it("registers a beforeunload handler", () => {
-		const addSpy = vi.spyOn(window, "addEventListener");
-		effectScope(() => {
-			createBeforeUnload("Are you sure?");
-		});
-		globalExpect(addSpy).toHaveBeenCalledWith("beforeunload", globalExpect.any(Function));
-		addSpy.mockRestore();
-	});
-	it("removes the handler on Symbol.dispose", () => {
-		const removeSpy = vi.spyOn(window, "removeEventListener");
-		let bu;
-		effectScope(() => {
-			bu = createBeforeUnload();
-		});
-		bu[Symbol.dispose]();
-		globalExpect(removeSpy).toHaveBeenCalledWith("beforeunload", globalExpect.any(Function));
-		removeSpy.mockRestore();
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/clipboard.d.mts

@@ -1,15 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/clipboard.d.ts
-type ClipboardResult = {
-  copied: Computed<boolean>;
-  value: Computed<string | null>;
-  copy(text: string): Promise<void>;
-};
-/**
- * Provides a `copy(text)` helper that writes to the clipboard.
- * `copied` is `true` for 1 500 ms after a successful copy.
- */
-declare function createClipboard(resetDelay?: number): ClipboardResult;
-//#endregion
-export { createClipboard };

package/dist/signals/lib/clipboard.mjs

@@ -1,25 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/clipboard.ts
-/**
-* Provides a `copy(text)` helper that writes to the clipboard.
-* `copied` is `true` for 1 500 ms after a successful copy.
-*/
-function createClipboard(resetDelay = 1500) {
-	const copied = signal(false);
-	const value = signal(null);
-	let timer;
-	const copy = async (text) => {
-		await navigator.clipboard.writeText(text);
-		clearTimeout(timer);
-		value(text);
-		copied(true);
-		timer = setTimeout(() => copied(false), resetDelay);
-	};
-	return {
-		copied,
-		value,
-		copy
-	};
-}
-//#endregion
-export { createClipboard };

package/dist/signals/lib/clipboard.test.mjs

@@ -1,53 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, n as vi, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createClipboard } from "./clipboard.mjs";
-//#region src/signals/lib/clipboard.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.useRealTimers();
-	vi.unstubAllGlobals();
-});
-describe("createClipboard", () => {
-	it("starts as not copied", () => {
-		vi.stubGlobal("navigator", {
-			...navigator,
-			clipboard: { writeText: vi.fn().mockResolvedValue(void 0) }
-		});
-		let cb;
-		effectScope(() => {
-			cb = createClipboard();
-		});
-		globalExpect(cb.copied()).toBe(false);
-		globalExpect(cb.value()).toBeNull();
-	});
-	it("sets copied and value after copy()", async () => {
-		vi.useFakeTimers();
-		vi.stubGlobal("navigator", {
-			...navigator,
-			clipboard: { writeText: vi.fn().mockResolvedValue(void 0) }
-		});
-		let cb;
-		effectScope(() => {
-			cb = createClipboard();
-		});
-		await cb.copy("hello");
-		globalExpect(cb.copied()).toBe(true);
-		globalExpect(cb.value()).toBe("hello");
-	});
-	it("resets copied after resetDelay", async () => {
-		vi.useFakeTimers();
-		vi.stubGlobal("navigator", {
-			...navigator,
-			clipboard: { writeText: vi.fn().mockResolvedValue(void 0) }
-		});
-		let cb;
-		effectScope(() => {
-			cb = createClipboard(500);
-		});
-		await cb.copy("text");
-		vi.advanceTimersByTime(600);
-		globalExpect(cb.copied()).toBe(false);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/counter.d.mts

@@ -1,18 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/counter.d.ts
-type CounterResult = Signal<number> & {
-  increment(step?: number): void;
-  decrement(step?: number): void;
-  reset(): void;
-};
-/**
- * Returns a numeric `Signal` with `increment`, `decrement`, and `reset`
- * helpers.  Optionally clamp to `[min, max]`.
- */
-declare function createCounter(initial?: number, options?: {
-  min?: number;
-  max?: number;
-}): CounterResult;
-//#endregion
-export { createCounter };

package/dist/signals/lib/counter.mjs

@@ -1,21 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/counter.ts
-/**
-* Returns a numeric `Signal` with `increment`, `decrement`, and `reset`
-* helpers.  Optionally clamp to `[min, max]`.
-*/
-function createCounter(initial = 0, options) {
-	const { min = -Infinity, max = Infinity } = options ?? {};
-	const clamp = (v) => Math.min(max, Math.max(min, v));
-	const s = signal(clamp(initial));
-	const increment = (step = 1) => s(clamp(s() + step));
-	const decrement = (step = 1) => s(clamp(s() - step));
-	const reset = () => s(clamp(initial));
-	return Object.assign(s, {
-		increment,
-		decrement,
-		reset
-	});
-}
-//#endregion
-export { createCounter };

package/dist/signals/lib/counter.test.d.mts

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

package/dist/signals/lib/counter.test.mjs

@@ -1,74 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createCounter } from "./counter.mjs";
-//#region src/signals/lib/counter.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createCounter", () => {
-	it("starts at 0 by default", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter();
-		});
-		globalExpect(c()).toBe(0);
-	});
-	it("starts at a provided initial value", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(10);
-		});
-		globalExpect(c()).toBe(10);
-	});
-	it("increments by 1", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(0);
-		});
-		c.increment();
-		globalExpect(c()).toBe(1);
-	});
-	it("increments by step", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(0);
-		});
-		c.increment(5);
-		globalExpect(c()).toBe(5);
-	});
-	it("decrements by 1", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(5);
-		});
-		c.decrement();
-		globalExpect(c()).toBe(4);
-	});
-	it("resets to initial value", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(3);
-		});
-		c.increment(10);
-		c.reset();
-		globalExpect(c()).toBe(3);
-	});
-	it("clamps to max", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(0, { max: 5 });
-		});
-		c.increment(100);
-		globalExpect(c()).toBe(5);
-	});
-	it("clamps to min", () => {
-		let c;
-		effectScope(() => {
-			c = createCounter(0, { min: -3 });
-		});
-		c.decrement(100);
-		globalExpect(c()).toBe(-3);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/document-title.d.mts

@@ -1,10 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/document-title.d.ts
-/**
- * Returns a writable `Signal<string>` synced to `document.title`.
- * Writing the signal immediately updates the browser tab title.
- */
-declare function createDocumentTitle(initial?: string): Signal<string>;
-//#endregion
-export { createDocumentTitle };

package/dist/signals/lib/document-title.mjs

@@ -1,15 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/document-title.ts
-/**
-* Returns a writable `Signal<string>` synced to `document.title`.
-* Writing the signal immediately updates the browser tab title.
-*/
-function createDocumentTitle(initial) {
-	const title = signal(initial ?? (typeof document !== "undefined" ? document.title : ""));
-	effect(() => {
-		if (typeof document !== "undefined") document.title = title();
-	});
-	return title;
-}
-//#endregion
-export { createDocumentTitle };

package/dist/signals/lib/document-title.test.d.mts

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

package/dist/signals/lib/document-title.test.mjs

@@ -1,33 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createDocumentTitle } from "./document-title.mjs";
-//#region src/signals/lib/document-title.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createDocumentTitle", () => {
-	it("sets document.title from initial value", () => {
-		effectScope(() => {
-			createDocumentTitle("My App");
-		});
-		globalExpect(document.title).toBe("My App");
-	});
-	it("updates document.title when signal is written", () => {
-		let title;
-		effectScope(() => {
-			title = createDocumentTitle("Initial");
-		});
-		title("Updated");
-		globalExpect(document.title).toBe("Updated");
-	});
-	it("reads from document.title if no initial value given", () => {
-		document.title = "Existing Title";
-		let title;
-		effectScope(() => {
-			title = createDocumentTitle();
-		});
-		globalExpect(title()).toBe("Existing Title");
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/element-size.d.mts

@@ -1,16 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/element-size.d.ts
-/**
- * Observes the content-box size of `target` using a `ResizeObserver` and
- * returns reactive `width` and `height` computeds.
- *
- * Supports a reactive getter — pass `() => element` when the target element
- * is not known at call time.
- */
-declare function createElementSize(target: Element | (() => Element | null)): {
-  width: Computed<number>;
-  height: Computed<number>;
-} & Disposable;
-//#endregion
-export { createElementSize };

package/dist/signals/lib/element-size.mjs

@@ -1,32 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createResizeObserver } from "./resize-observer.mjs";
-//#region src/signals/lib/element-size.ts
-/**
-* Observes the content-box size of `target` using a `ResizeObserver` and
-* returns reactive `width` and `height` computeds.
-*
-* Supports a reactive getter — pass `() => element` when the target element
-* is not known at call time.
-*/
-function createElementSize(target) {
-	const w = signal(0);
-	const h = signal(0);
-	const observer = createResizeObserver(target, (entries) => {
-		for (const entry of entries) {
-			w(entry.contentRect.width);
-			h(entry.contentRect.height);
-		}
-	});
-	const el = typeof target === "function" ? target() : target;
-	if (el) {
-		const rect = el.getBoundingClientRect();
-		w(rect.width);
-		h(rect.height);
-	}
-	return Object.assign({
-		width: w,
-		height: h
-	}, { [Symbol.dispose]: observer[Symbol.dispose] });
-}
-//#endregion
-export { createElementSize };

package/dist/signals/lib/element-size.test.d.mts

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

package/dist/signals/lib/element-size.test.mjs

@@ -1,86 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, n as vi, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createElementSize } from "./element-size.mjs";
-//#region src/signals/lib/element-size.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.restoreAllMocks();
-	vi.unstubAllGlobals();
-});
-describe("createElementSize", () => {
-	it("returns initial dimensions from getBoundingClientRect", () => {
-		const el = document.createElement("div");
-		document.body.appendChild(el);
-		vi.spyOn(el, "getBoundingClientRect").mockReturnValue({
-			width: 200,
-			height: 100,
-			x: 0,
-			y: 0,
-			top: 0,
-			right: 200,
-			bottom: 100,
-			left: 0,
-			toJSON: () => ({})
-		});
-		let size;
-		effectScope(() => {
-			size = createElementSize(el);
-		});
-		globalExpect(size.width()).toBe(200);
-		globalExpect(size.height()).toBe(100);
-	});
-	it("updates when ResizeObserver fires", () => {
-		const el = document.createElement("div");
-		document.body.appendChild(el);
-		vi.spyOn(el, "getBoundingClientRect").mockReturnValue({
-			width: 0,
-			height: 0,
-			x: 0,
-			y: 0,
-			top: 0,
-			right: 0,
-			bottom: 0,
-			left: 0,
-			toJSON: () => ({})
-		});
-		let observerCallback;
-		vi.stubGlobal("ResizeObserver", function MockRO(cb) {
-			observerCallback = cb;
-			return {
-				observe: vi.fn(),
-				disconnect: vi.fn(),
-				unobserve: vi.fn()
-			};
-		});
-		let size;
-		effectScope(() => {
-			size = createElementSize(el);
-		});
-		observerCallback([{ contentRect: {
-			width: 300,
-			height: 150
-		} }], {});
-		globalExpect(size.width()).toBe(300);
-		globalExpect(size.height()).toBe(150);
-	});
-	it("disconnects the observer on Symbol.dispose", () => {
-		const disconnect = vi.fn();
-		vi.stubGlobal("ResizeObserver", function MockRO() {
-			return {
-				observe: vi.fn(),
-				disconnect,
-				unobserve: vi.fn()
-			};
-		});
-		const el = document.createElement("div");
-		document.body.appendChild(el);
-		let size;
-		effectScope(() => {
-			size = createElementSize(el);
-		});
-		size[Symbol.dispose]();
-		globalExpect(disconnect).toHaveBeenCalledOnce();
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/event-listener.d.mts

@@ -1,14 +0,0 @@
-//#region src/signals/lib/event-listener.d.ts
-/**
- * Attaches a type-safe event listener to a target, with automatic cleanup.
- *
- * When called inside an `effect` or `effectScope` the listener is removed
- * when the scope is disposed.  When the target is a reactive getter the
- * listener is re-registered whenever the target changes.
- */
-declare function createEventListener<K extends keyof HTMLElementEventMap>(target: HTMLElement | (() => HTMLElement | null), type: K, handler: (e: HTMLElementEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
-declare function createEventListener<K extends keyof DocumentEventMap>(target: Document | (() => Document | null), type: K, handler: (e: DocumentEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
-declare function createEventListener<K extends keyof WindowEventMap>(target: Window | (() => Window | null), type: K, handler: (e: WindowEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
-declare function createEventListener(target: EventTarget | (() => EventTarget | null), type: string, handler: EventListener, options?: AddEventListenerOptions): () => void;
-//#endregion
-export { createEventListener };

package/dist/signals/lib/favicon.d.mts

@@ -1,10 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/favicon.d.ts
-/**
- * Returns a writable `Signal<string>` whose value is reflected as the page's
- * favicon `href`.  Writing the signal swaps the `<link rel="icon">` element.
- */
-declare function createFavicon(initial?: string): Signal<string>;
-//#endregion
-export { createFavicon };

package/dist/signals/lib/favicon.mjs

@@ -1,24 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/favicon.ts
-/**
-* Returns a writable `Signal<string>` whose value is reflected as the page's
-* favicon `href`.  Writing the signal swaps the `<link rel="icon">` element.
-*/
-function createFavicon(initial) {
-	const getLink = () => {
-		let link = document.querySelector("link[rel~='icon']");
-		if (!link) {
-			link = document.createElement("link");
-			link.rel = "icon";
-			document.head.appendChild(link);
-		}
-		return link;
-	};
-	const href = signal(initial ?? (typeof document !== "undefined" ? getLink().href || "" : ""));
-	effect(() => {
-		if (typeof document !== "undefined") getLink().href = href();
-	});
-	return href;
-}
-//#endregion
-export { createFavicon };

package/dist/signals/lib/favicon.test.d.mts

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

package/dist/signals/lib/favicon.test.mjs

@@ -1,28 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createFavicon } from "./favicon.mjs";
-//#region src/signals/lib/favicon.test.ts
-afterEach(() => {
-	document.head.innerHTML = "";
-	document.body.innerHTML = "";
-});
-describe("createFavicon", () => {
-	it("creates a link element if none exists", () => {
-		effectScope(() => {
-			createFavicon("/icon.png");
-		});
-		const link = document.querySelector("link[rel~='icon']");
-		globalExpect(link).not.toBeNull();
-		globalExpect(link?.href).toContain("/icon.png");
-	});
-	it("updates favicon href when signal changes", () => {
-		let fav;
-		effectScope(() => {
-			fav = createFavicon("/old.png");
-		});
-		fav("/new.png");
-		globalExpect(document.querySelector("link[rel~='icon']")?.href).toContain("/new.png");
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/finite-state-machine.d.mts

@@ -1,22 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/finite-state-machine.d.ts
-type Transitions<S extends string, E extends string> = Partial<Record<S, Partial<Record<E, S>>>>;
-type StateHooks<S extends string> = Partial<Record<S, {
-  enter?: () => void;
-  exit?: () => void;
-}>>;
-type FSMResult<S extends string, E extends string> = {
-  state: Computed<S>;
-  send(event: E): void;
-  can(event: E): boolean;
-};
-/**
- * Type-safe finite state machine with optional `enter` / `exit` lifecycle
- * hooks per state.
- */
-declare function createFiniteStateMachine<S extends string, E extends string>(initial: S, transitions: Transitions<S, E>, options?: {
-  on?: StateHooks<S>;
-}): FSMResult<S, E>;
-//#endregion
-export { createFiniteStateMachine };

package/dist/signals/lib/finite-state-machine.mjs

@@ -1,26 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/finite-state-machine.ts
-/**
-* Type-safe finite state machine with optional `enter` / `exit` lifecycle
-* hooks per state.
-*/
-function createFiniteStateMachine(initial, transitions, options) {
-	const state = signal(initial);
-	options?.on?.[initial]?.enter?.();
-	const send = (event) => {
-		const current = state();
-		const next = transitions[current]?.[event];
-		if (next === void 0 || next === current) return;
-		options?.on?.[current]?.exit?.();
-		state(next);
-		options?.on?.[next]?.enter?.();
-	};
-	const can = (event) => transitions[state()]?.[event] !== void 0;
-	return {
-		state,
-		send,
-		can
-	};
-}
-//#endregion
-export { createFiniteStateMachine };

package/dist/signals/lib/finite-state-machine.test.d.mts

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