elements-kit 0.0.10 → 0.0.11

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,24 +0,0 @@
-import { fromEvent, sync } from "./event-driven.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, cleanup] = sync(fromEvent(document, "fullscreenchange"), () => !!document.fullscreenElement);
-	const enter = () => getTarget().requestFullscreen();
-	const exit = () => document.exitFullscreen();
-	const toggle = () => isFullscreen() ? exit() : enter();
-	return {
-		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,48 +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("removes event listener on Symbol.dispose", () => {
-		const removeSpy = vi.spyOn(document, "removeEventListener");
-		let f;
-		effectScope(() => {
-			f = createFullscreen();
-		});
-		f[Symbol.dispose]();
-		globalExpect(removeSpy).toHaveBeenCalledWith("fullscreenchange", globalExpect.any(Function));
-	});
-});
-//#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,14 +0,0 @@
-import { fromEvent, sync } from "./event-driven.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, cleanup] = sync(fromEvent(window, "hashchange"), () => typeof location !== "undefined" ? location.hash : "", (v) => {
-		location.hash = v;
-	});
-	return Object.assign(hash, { [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,46 +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("removes event listener on Symbol.dispose", () => {
-		const removeSpy = vi.spyOn(window, "removeEventListener");
-		let h;
-		effectScope(() => {
-			h = createHash();
-		});
-		h[Symbol.dispose]();
-		globalExpect(removeSpy).toHaveBeenCalledWith("hashchange", globalExpect.any(Function));
-	});
-});
-//#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,13 +0,0 @@
-import { fromEvent, sync } from "./event-driven.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, cleanup] = sync(fromEvent(document, "visibilitychange"), () => typeof document !== "undefined" ? document.visibilityState === "visible" : true);
-	return Object.assign(visible, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createIsDocumentVisible };

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

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

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

@@ -1,58 +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 { createIsDocumentVisible } from "./is-document-visible.mjs";
-//#region src/signals/lib/is-document-visible.test.ts
-afterEach(() => {
-	Object.defineProperty(document, "visibilityState", {
-		value: "visible",
-		configurable: true
-	});
-});
-function setVisibility(state) {
-	Object.defineProperty(document, "visibilityState", {
-		value: state,
-		configurable: true
-	});
-	document.dispatchEvent(new Event("visibilitychange"));
-}
-describe("createIsDocumentVisible", () => {
-	it("starts as true when document is visible", () => {
-		Object.defineProperty(document, "visibilityState", {
-			value: "visible",
-			configurable: true
-		});
-		let visible;
-		effectScope(() => {
-			visible = createIsDocumentVisible();
-		});
-		globalExpect(visible()).toBe(true);
-	});
-	it("becomes false when document becomes hidden", () => {
-		let visible;
-		effectScope(() => {
-			visible = createIsDocumentVisible();
-		});
-		setVisibility("hidden");
-		globalExpect(visible()).toBe(false);
-	});
-	it("becomes true again when document becomes visible", () => {
-		let visible;
-		effectScope(() => {
-			visible = createIsDocumentVisible();
-		});
-		setVisibility("hidden");
-		setVisibility("visible");
-		globalExpect(visible()).toBe(true);
-	});
-	it("stops reacting after Symbol.dispose", () => {
-		let visible;
-		effectScope(() => {
-			visible = createIsDocumentVisible();
-		});
-		visible[Symbol.dispose]();
-		setVisibility("hidden");
-		globalExpect(visible()).toBe(true);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/is-focus-within.d.mts

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/is-focus-within.d.ts
-/**
- * Returns a `Computed<boolean>` that is `true` while focus is anywhere inside
- * `target` (including `target` itself).
- */
-declare function createIsFocusWithin(target: Element | (() => Element | null)): Computed<boolean> & Disposable;
-//#endregion
-export { createIsFocusWithin };

package/dist/signals/lib/is-focus-within.mjs

@@ -1,28 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/is-focus-within.ts
-/**
-* Returns a `Computed<boolean>` that is `true` while focus is anywhere inside
-* `target` (including `target` itself).
-*/
-function createIsFocusWithin(target) {
-	const focused = signal(false);
-	const el = typeof target === "function" ? target() : target;
-	const onFocusIn = (e) => {
-		const t = typeof target === "function" ? target() : target;
-		if (t && t.contains(e.target)) focused(true);
-	};
-	const onFocusOut = (e) => {
-		const t = typeof target === "function" ? target() : target;
-		if (t && !t.contains(e.relatedTarget)) focused(false);
-	};
-	const cleanups = [];
-	if (el) {
-		cleanups.push(createEventListener(document, "focusin", onFocusIn));
-		cleanups.push(createEventListener(document, "focusout", onFocusOut));
-	}
-	const cleanup = () => cleanups.forEach((fn) => fn());
-	return Object.assign(focused, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createIsFocusWithin };

package/dist/signals/lib/is-focus-within.test.d.mts

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

package/dist/signals/lib/is-idle.d.mts

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/is-idle.d.ts
-/**
- * Returns a `Computed<boolean>` that is `true` when the user has been inactive
- * for longer than `timeout` milliseconds (default 60 s).
- */
-declare function createIsIdle(timeout?: number): Computed<boolean> & Disposable;
-//#endregion
-export { createIsIdle };

package/dist/signals/lib/is-idle.mjs

@@ -1,37 +0,0 @@
-import { d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/is-idle.ts
-/** Default idle timeout in milliseconds (60 seconds). */
-const DEFAULT_TIMEOUT = 6e4;
-/** Events that reset the idle timer. */
-const ACTIVITY_EVENTS = [
-	"mousemove",
-	"mousedown",
-	"keydown",
-	"touchstart",
-	"scroll",
-	"pointermove"
-];
-/**
-* Returns a `Computed<boolean>` that is `true` when the user has been inactive
-* for longer than `timeout` milliseconds (default 60 s).
-*/
-function createIsIdle(timeout = DEFAULT_TIMEOUT) {
-	const idle = signal(false);
-	let timer;
-	const reset = () => {
-		clearTimeout(timer);
-		idle(false);
-		timer = setTimeout(() => idle(true), timeout);
-	};
-	reset();
-	const removes = ACTIVITY_EVENTS.map((event) => createEventListener(window, event, reset, { passive: true }));
-	onCleanup(() => clearTimeout(timer));
-	const cleanup = () => {
-		clearTimeout(timer);
-		removes.forEach((fn) => fn());
-	};
-	return Object.assign(idle, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createIsIdle };

package/dist/signals/lib/is-idle.test.d.mts

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

package/dist/signals/lib/is-idle.test.mjs

@@ -1,50 +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 { createIsIdle } from "./is-idle.mjs";
-//#region src/signals/lib/is-idle.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.useRealTimers();
-});
-describe("createIsIdle", () => {
-	it("starts as false (user is active)", () => {
-		vi.useFakeTimers();
-		let idle;
-		effectScope(() => {
-			idle = createIsIdle(1e3);
-		});
-		globalExpect(idle()).toBe(false);
-	});
-	it("becomes true after the timeout", () => {
-		vi.useFakeTimers();
-		let idle;
-		effectScope(() => {
-			idle = createIsIdle(1e3);
-		});
-		vi.advanceTimersByTime(1001);
-		globalExpect(idle()).toBe(true);
-	});
-	it("resets the timer on activity", () => {
-		vi.useFakeTimers();
-		let idle;
-		effectScope(() => {
-			idle = createIsIdle(1e3);
-		});
-		vi.advanceTimersByTime(800);
-		window.dispatchEvent(new MouseEvent("mousemove"));
-		vi.advanceTimersByTime(800);
-		globalExpect(idle()).toBe(false);
-	});
-	it("stops reacting after Symbol.dispose", () => {
-		vi.useFakeTimers();
-		let idle;
-		effectScope(() => {
-			idle = createIsIdle(500);
-		});
-		idle[Symbol.dispose]();
-		vi.advanceTimersByTime(1e3);
-		globalExpect(idle()).toBe(false);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/is-in-viewport.d.mts

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/is-in-viewport.d.ts
-/**
- * Returns a `Computed<boolean>` that is `true` while `target` is intersecting
- * the viewport (or a custom root defined via `options`).
- */
-declare function createIsInViewport(target: Element | (() => Element | null), options?: IntersectionObserverInit): Computed<boolean> & Disposable;
-//#endregion
-export { createIsInViewport };

package/dist/signals/lib/is-in-viewport.mjs

@@ -1,16 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createIntersectionObserver } from "./intersection-observer.mjs";
-//#region src/signals/lib/is-in-viewport.ts
-/**
-* Returns a `Computed<boolean>` that is `true` while `target` is intersecting
-* the viewport (or a custom root defined via `options`).
-*/
-function createIsInViewport(target, options) {
-	const visible = signal(false);
-	const observer = createIntersectionObserver(target, (entries) => {
-		for (const entry of entries) visible(entry.isIntersecting);
-	}, options);
-	return Object.assign(visible, { [Symbol.dispose]: observer[Symbol.dispose] });
-}
-//#endregion
-export { createIsInViewport };

package/dist/signals/lib/is-in-viewport.test.d.mts

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