elements-kit 0.0.9 → 0.0.11

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 { };

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

@@ -1,66 +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 { createFiniteStateMachine } from "./finite-state-machine.mjs";
-//#region src/signals/lib/finite-state-machine.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-const transitions = {
-	red: { GO: "green" },
-	green: { SLOW: "yellow" },
-	yellow: { STOP: "red" }
-};
-describe("createFiniteStateMachine", () => {
-	it("starts in the initial state", () => {
-		let fsm;
-		effectScope(() => {
-			fsm = createFiniteStateMachine("red", transitions);
-		});
-		globalExpect(fsm.state()).toBe("red");
-	});
-	it("transitions on valid event", () => {
-		let fsm;
-		effectScope(() => {
-			fsm = createFiniteStateMachine("red", transitions);
-		});
-		fsm.send("GO");
-		globalExpect(fsm.state()).toBe("green");
-	});
-	it("does not transition on invalid event", () => {
-		let fsm;
-		effectScope(() => {
-			fsm = createFiniteStateMachine("red", transitions);
-		});
-		fsm.send("SLOW");
-		globalExpect(fsm.state()).toBe("red");
-	});
-	it("can() returns true for valid transition", () => {
-		let fsm;
-		effectScope(() => {
-			fsm = createFiniteStateMachine("red", transitions);
-		});
-		globalExpect(fsm.can("GO")).toBe(true);
-		globalExpect(fsm.can("SLOW")).toBe(false);
-	});
-	it("calls enter/exit hooks on transition", () => {
-		const enterRed = vi.fn();
-		const exitRed = vi.fn();
-		const enterGreen = vi.fn();
-		let fsm;
-		effectScope(() => {
-			fsm = createFiniteStateMachine("red", transitions, { on: {
-				red: {
-					enter: enterRed,
-					exit: exitRed
-				},
-				green: { enter: enterGreen }
-			} });
-		});
-		globalExpect(enterRed).toHaveBeenCalledOnce();
-		fsm.send("GO");
-		globalExpect(exitRed).toHaveBeenCalledOnce();
-		globalExpect(enterGreen).toHaveBeenCalledOnce();
-	});
-});
-//#endregion
-export {};

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

@@ -1,15 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/fullscreen.d.ts
-type FullscreenResult = {
-  isFullscreen: Computed<boolean>;
-  enter(): Promise<void>;
-  exit(): Promise<void>;
-  toggle(): Promise<void>;
-} & Disposable;
-/**
- * Wraps the Fullscreen API.  `target` defaults to `document.documentElement`.
- */
-declare function createFullscreen(target?: Element | (() => Element | null)): FullscreenResult;
-//#endregion
-export { createFullscreen };

package/dist/signals/lib/fullscreen.mjs

@@ -1,26 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/fullscreen.ts
-/**
-* Wraps the Fullscreen API.  `target` defaults to `document.documentElement`.
-*/
-function createFullscreen(target) {
-	const getTarget = () => {
-		if (!target) return document.documentElement;
-		return typeof target === "function" ? target() ?? document.documentElement : target;
-	};
-	const isFullscreen = signal(!!document.fullscreenElement);
-	const onChange = () => isFullscreen(!!document.fullscreenElement);
-	const cleanup = createEventListener(document, "fullscreenchange", onChange);
-	const enter = () => getTarget().requestFullscreen();
-	const exit = () => document.exitFullscreen();
-	const toggle = () => isFullscreen() ? exit() : enter();
-	return Object.assign({
-		isFullscreen,
-		enter,
-		exit,
-		toggle
-	}, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createFullscreen };

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

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

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

@@ -1,56 +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 { createFullscreen } from "./fullscreen.mjs";
-//#region src/signals/lib/fullscreen.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.restoreAllMocks();
-});
-describe("createFullscreen", () => {
-	it("starts with current fullscreen state", () => {
-		Object.defineProperty(document, "fullscreenElement", {
-			configurable: true,
-			get: () => null
-		});
-		let f;
-		effectScope(() => {
-			f = createFullscreen();
-		});
-		globalExpect(f.isFullscreen()).toBe(false);
-	});
-	it("updates isFullscreen on fullscreenchange event", () => {
-		Object.defineProperty(document, "fullscreenElement", {
-			configurable: true,
-			get: () => null
-		});
-		let f;
-		effectScope(() => {
-			f = createFullscreen();
-		});
-		Object.defineProperty(document, "fullscreenElement", {
-			configurable: true,
-			get: () => document.documentElement
-		});
-		document.dispatchEvent(new Event("fullscreenchange"));
-		globalExpect(f.isFullscreen()).toBe(true);
-	});
-	it("stops reacting after Symbol.dispose", () => {
-		Object.defineProperty(document, "fullscreenElement", {
-			configurable: true,
-			get: () => null
-		});
-		let f;
-		effectScope(() => {
-			f = createFullscreen();
-		});
-		f[Symbol.dispose]();
-		Object.defineProperty(document, "fullscreenElement", {
-			configurable: true,
-			get: () => document.documentElement
-		});
-		document.dispatchEvent(new Event("fullscreenchange"));
-		globalExpect(f.isFullscreen()).toBe(false);
-	});
-});
-//#endregion
-export {};

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

@@ -1,15 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/geolocation.d.ts
-type GeolocationResult = {
-  position: Computed<GeolocationPosition | null>;
-  error: Computed<GeolocationPositionError | null>;
-  loading: Computed<boolean>;
-} & Disposable;
-/**
- * Exposes the Geolocation API as reactive signals.
- * Begins watching the position immediately.
- */
-declare function createGeolocation(options?: PositionOptions): GeolocationResult;
-//#endregion
-export { createGeolocation };

package/dist/signals/lib/geolocation.mjs

@@ -1,30 +0,0 @@
-import { d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/geolocation.ts
-/**
-* Exposes the Geolocation API as reactive signals.
-* Begins watching the position immediately.
-*/
-function createGeolocation(options) {
-	const position = signal(null);
-	const error = signal(null);
-	const loading = signal(true);
-	const onSuccess = (pos) => {
-		position(pos);
-		error(null);
-		loading(false);
-	};
-	const onError = (err) => {
-		error(err);
-		loading(false);
-	};
-	const watchId = navigator.geolocation.watchPosition(onSuccess, onError, options);
-	const cleanup = () => navigator.geolocation.clearWatch(watchId);
-	onCleanup(cleanup);
-	return Object.assign({
-		position,
-		error,
-		loading
-	}, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createGeolocation };

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

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

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

@@ -1,37 +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 { createGeolocation } from "./geolocation.mjs";
-//#region src/signals/lib/geolocation.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.unstubAllGlobals();
-});
-describe("createGeolocation", () => {
-	it("starts with null position and loading true", () => {
-		vi.stubGlobal("navigator", { geolocation: {
-			watchPosition: vi.fn().mockReturnValue(1),
-			clearWatch: vi.fn()
-		} });
-		let g;
-		effectScope(() => {
-			g = createGeolocation();
-		});
-		globalExpect(g.position()).toBeNull();
-		globalExpect(g.loading()).toBe(true);
-	});
-	it("calls clearWatch on Symbol.dispose", () => {
-		const clearWatch = vi.fn();
-		vi.stubGlobal("navigator", { geolocation: {
-			watchPosition: vi.fn().mockReturnValue(42),
-			clearWatch
-		} });
-		let g;
-		effectScope(() => {
-			g = createGeolocation();
-		});
-		g[Symbol.dispose]();
-		globalExpect(clearWatch).toHaveBeenCalledWith(42);
-	});
-});
-//#endregion
-export {};

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

@@ -1,10 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/hash.d.ts
-/**
- * Returns a writable `Signal<string>` that stays in sync with `location.hash`
- * (including the leading `#`).  Writing the signal updates `location.hash`.
- */
-declare function createHash(): Signal<string> & Disposable;
-//#endregion
-export { createHash };

package/dist/signals/lib/hash.mjs

@@ -1,20 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/hash.ts
-/**
-* Returns a writable `Signal<string>` that stays in sync with `location.hash`
-* (including the leading `#`).  Writing the signal updates `location.hash`.
-*/
-function createHash() {
-	const hash = signal(typeof location !== "undefined" ? location.hash : "");
-	const onHashChange = () => hash(location.hash);
-	const cleanup = createEventListener(window, "hashchange", onHashChange);
-	const proxy = (value) => {
-		if (value === void 0) return hash();
-		location.hash = value;
-		hash(value);
-	};
-	return Object.assign(proxy, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createHash };

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

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

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

@@ -1,47 +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 { createHash } from "./hash.mjs";
-//#region src/signals/lib/hash.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	location.hash = "";
-	vi.useRealTimers();
-});
-describe("createHash", () => {
-	it("reads the current location.hash", () => {
-		let h;
-		effectScope(() => {
-			h = createHash();
-		});
-		globalExpect(typeof h()).toBe("string");
-	});
-	it("updates when hash changes via hashchange event", () => {
-		let h;
-		effectScope(() => {
-			h = createHash();
-		});
-		location.hash = "#section";
-		window.dispatchEvent(new HashChangeEvent("hashchange"));
-		globalExpect(h()).toBe("#section");
-	});
-	it("writing the signal updates location.hash", () => {
-		let h;
-		effectScope(() => {
-			h = createHash();
-		});
-		h("#new");
-		globalExpect(location.hash).toBe("#new");
-	});
-	it("stops updating after Symbol.dispose", () => {
-		let h;
-		effectScope(() => {
-			h = createHash();
-		});
-		h[Symbol.dispose]();
-		location.hash = "#other";
-		window.dispatchEvent(new HashChangeEvent("hashchange"));
-		globalExpect(h()).not.toBe("#other");
-	});
-});
-//#endregion
-export {};

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

@@ -1,11 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/hover.d.ts
-/**
- * Returns a `Computed<boolean>` that is `true` while the pointer is over
- * `target`.  Uses `pointerenter` / `pointerleave` so it works for both mouse
- * and touch/stylus input.
- */
-declare function createHover(target: Element | (() => Element | null)): Computed<boolean> & Disposable;
-//#endregion
-export { createHover };

package/dist/signals/lib/hover.mjs

@@ -1,23 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/hover.ts
-/**
-* Returns a `Computed<boolean>` that is `true` while the pointer is over
-* `target`.  Uses `pointerenter` / `pointerleave` so it works for both mouse
-* and touch/stylus input.
-*/
-function createHover(target) {
-	const hovered = signal(false);
-	const el = typeof target === "function" ? target() : target;
-	const onEnter = () => hovered(true);
-	const onLeave = () => hovered(false);
-	const cleanups = [];
-	if (el) {
-		cleanups.push(createEventListener(el, "pointerenter", onEnter));
-		cleanups.push(createEventListener(el, "pointerleave", onLeave));
-	}
-	const cleanup = () => cleanups.forEach((fn) => fn());
-	return Object.assign(hovered, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createHover };

package/dist/signals/lib/intersection-observer.d.mts

@@ -1,8 +0,0 @@
-//#region src/signals/lib/intersection-observer.d.ts
-/**
- * Raw `IntersectionObserver` wrapper with automatic cleanup.
- * Use `createIsInViewport` for the common boolean case.
- */
-declare function createIntersectionObserver(target: Element | (() => Element | null), callback: IntersectionObserverCallback, options?: IntersectionObserverInit): Disposable;
-//#endregion
-export { createIntersectionObserver };

package/dist/signals/lib/is-document-visible.d.mts

@@ -1,11 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/is-document-visible.d.ts
-/**
- * Returns a `Computed<boolean>` that tracks the Page Visibility API.
- * `true` while the document is visible; `false` when hidden (minimised,
- * background tab, etc.).
- */
-declare function createIsDocumentVisible(): Computed<boolean> & Disposable;
-//#endregion
-export { createIsDocumentVisible };

package/dist/signals/lib/is-document-visible.mjs

@@ -1,19 +0,0 @@
-import { d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/is-document-visible.ts
-/**
-* Returns a `Computed<boolean>` that tracks the Page Visibility API.
-* `true` while the document is visible; `false` when hidden (minimised,
-* background tab, etc.).
-*/
-function createIsDocumentVisible() {
-	const visible = signal(typeof document !== "undefined" ? document.visibilityState === "visible" : true);
-	const handler = () => {
-		visible(document.visibilityState === "visible");
-	};
-	document.addEventListener("visibilitychange", handler);
-	const cleanup = () => document.removeEventListener("visibilitychange", handler);
-	onCleanup(cleanup);
-	return Object.assign(visible, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createIsDocumentVisible };

package/dist/signals/lib/is-document-visible.test.d.mts

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