elements-kit 0.0.9 → 0.0.11

package/dist/signals/lib/page-leave.d.mts

@@ -1,8 +0,0 @@
-//#region src/signals/lib/page-leave.d.ts
-/**
- * Fires `handler` when the mouse cursor leaves the browser viewport
- * (detected via `mouseleave` on the document).
- */
-declare function createPageLeave(handler: () => void): Disposable;
-//#endregion
-export { createPageLeave };

package/dist/signals/lib/page-leave.mjs

@@ -1,12 +0,0 @@
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/page-leave.ts
-/**
-* Fires `handler` when the mouse cursor leaves the browser viewport
-* (detected via `mouseleave` on the document).
-*/
-function createPageLeave(handler) {
-	const cleanup = createEventListener(document, "mouseleave", handler);
-	return { [Symbol.dispose]: cleanup };
-}
-//#endregion
-export { createPageLeave };

package/dist/signals/lib/page-leave.test.d.mts

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

package/dist/signals/lib/page-leave.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 { createPageLeave } from "./page-leave.mjs";
-//#region src/signals/lib/page-leave.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createPageLeave", () => {
-	it("fires handler when mouse leaves the document", () => {
-		const handler = vi.fn();
-		effectScope(() => {
-			createPageLeave(handler);
-		});
-		document.dispatchEvent(new MouseEvent("mouseleave"));
-		globalExpect(handler).toHaveBeenCalledOnce();
-	});
-	it("stops firing after Symbol.dispose", () => {
-		const handler = vi.fn();
-		let pl;
-		effectScope(() => {
-			pl = createPageLeave(handler);
-		});
-		pl[Symbol.dispose]();
-		document.dispatchEvent(new MouseEvent("mouseleave"));
-		globalExpect(handler).not.toHaveBeenCalled();
-	});
-});
-//#endregion
-export {};

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

@@ -1,14 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/permission.d.ts
-type PermissionResult = {
-  state: Computed<PermissionState | "unsupported">;
-} & Disposable;
-/**
- * Returns a reactive `Computed` reflecting the current permission state for
- * the given descriptor.  Falls back to `"unsupported"` when the Permissions
- * API is unavailable.
- */
-declare function createPermission(descriptor: PermissionDescriptor): PermissionResult;
-//#endregion
-export { createPermission };

package/dist/signals/lib/permission.mjs

@@ -1,26 +0,0 @@
-import { d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/permission.ts
-/**
-* Returns a reactive `Computed` reflecting the current permission state for
-* the given descriptor.  Falls back to `"unsupported"` when the Permissions
-* API is unavailable.
-*/
-function createPermission(descriptor) {
-	const state = signal("unsupported");
-	let permissionStatus;
-	const cleanup = () => {
-		permissionStatus?.removeEventListener("change", onChange);
-	};
-	const onChange = () => {
-		if (permissionStatus) state(permissionStatus.state);
-	};
-	if (typeof navigator !== "undefined" && navigator.permissions != null) navigator.permissions.query(descriptor).then((status) => {
-		permissionStatus = status;
-		state(status.state);
-		status.addEventListener("change", onChange);
-	});
-	onCleanup(cleanup);
-	return Object.assign({ state }, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createPermission };

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

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

package/dist/signals/lib/permission.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 { createPermission } from "./permission.mjs";
-//#region src/signals/lib/permission.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.unstubAllGlobals();
-	vi.restoreAllMocks();
-});
-describe("createPermission", () => {
-	it("returns 'unsupported' when permissions API is missing", () => {
-		vi.stubGlobal("navigator", { permissions: void 0 });
-		let p;
-		effectScope(() => {
-			p = createPermission({ name: "geolocation" });
-		});
-		globalExpect(p.state()).toBe("unsupported");
-	});
-	it("queries permissions and returns the state", async () => {
-		const mockStatus = {
-			state: "granted",
-			addEventListener: vi.fn(),
-			removeEventListener: vi.fn()
-		};
-		vi.stubGlobal("navigator", { permissions: { query: vi.fn().mockResolvedValue(mockStatus) } });
-		let p;
-		effectScope(() => {
-			p = createPermission({ name: "geolocation" });
-		});
-		await new Promise((res) => setTimeout(res, 0));
-		globalExpect(p.state()).toBe("granted");
-	});
-	it("removes event listener on Symbol.dispose", () => {
-		const removeListener = vi.fn();
-		const mockStatus = {
-			state: "denied",
-			addEventListener: vi.fn(),
-			removeEventListener: removeListener
-		};
-		vi.stubGlobal("navigator", { permissions: { query: vi.fn().mockResolvedValue(mockStatus) } });
-		let p;
-		effectScope(() => {
-			p = createPermission({ name: "geolocation" });
-		});
-		p[Symbol.dispose]();
-		globalExpect(typeof p.state()).toBe("string");
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/persisted-state.d.mts

@@ -1,11 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/persisted-state.d.ts
-/**
- * Returns a `Signal` whose value is persisted to `storage` (defaults to
- * `localStorage`).  On creation the stored value is read back; on every
- * change the new value is serialised with `JSON.stringify`.
- */
-declare function createPersistedState<T>(key: string, initialValue: T, storage?: Storage): Signal<T>;
-//#endregion
-export { createPersistedState };

package/dist/signals/lib/persisted-state.mjs

@@ -1,25 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/persisted-state.ts
-/**
-* Returns a `Signal` whose value is persisted to `storage` (defaults to
-* `localStorage`).  On creation the stored value is read back; on every
-* change the new value is serialised with `JSON.stringify`.
-*/
-function createPersistedState(key, initialValue, storage = typeof localStorage !== "undefined" ? localStorage : void 0) {
-	let stored = initialValue;
-	if (storage) try {
-		const item = storage.getItem(key);
-		if (item !== null) stored = JSON.parse(item);
-	} catch {}
-	const s = signal(stored);
-	effect(() => {
-		const val = s();
-		if (!storage) return;
-		try {
-			storage.setItem(key, JSON.stringify(val));
-		} catch {}
-	});
-	return s;
-}
-//#endregion
-export { createPersistedState };

package/dist/signals/lib/persisted-state.test.d.mts

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

package/dist/signals/lib/persisted-state.test.mjs

@@ -1,70 +0,0 @@
-import { o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, i as beforeEach, o as it, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createPersistedState } from "./persisted-state.mjs";
-//#region src/signals/lib/persisted-state.test.ts
-function makeStorage() {
-	const store = {};
-	return {
-		getItem: (k) => store[k] ?? null,
-		setItem: (k, v) => {
-			store[k] = v;
-		},
-		removeItem: (k) => {
-			delete store[k];
-		},
-		clear: () => {
-			for (const k of Object.keys(store)) delete store[k];
-		},
-		get length() {
-			return Object.keys(store).length;
-		},
-		key: (i) => Object.keys(store)[i] ?? null
-	};
-}
-describe("createPersistedState", () => {
-	let storage;
-	beforeEach(() => {
-		storage = makeStorage();
-	});
-	it("uses initialValue when storage is empty", () => {
-		let s;
-		effectScope(() => {
-			s = createPersistedState("count", 0, storage);
-		});
-		globalExpect(s()).toBe(0);
-	});
-	it("reads an existing value from storage", () => {
-		storage.setItem("count", "42");
-		let s;
-		effectScope(() => {
-			s = createPersistedState("count", 0, storage);
-		});
-		globalExpect(s()).toBe(42);
-	});
-	it("persists changes to storage", () => {
-		let s;
-		effectScope(() => {
-			s = createPersistedState("count", 0, storage);
-		});
-		s(5);
-		globalExpect(storage.getItem("count")).toBe("5");
-	});
-	it("persists complex values as JSON", () => {
-		let s;
-		effectScope(() => {
-			s = createPersistedState("obj", { x: 1 }, storage);
-		});
-		s({ x: 99 });
-		globalExpect(JSON.parse(storage.getItem("obj"))).toEqual({ x: 99 });
-	});
-	it("falls back to initialValue on invalid JSON", () => {
-		storage.setItem("broken", "{not json}");
-		let s;
-		effectScope(() => {
-			s = createPersistedState("broken", 7, storage);
-		});
-		globalExpect(s()).toBe(7);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/pressed-keys.d.mts

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/pressed-keys.d.ts
-/**
- * Returns a `Computed<ReadonlySet<string>>` containing all keyboard keys
- * currently being held down.  Key values follow the `KeyboardEvent.key` spec.
- */
-declare function createPressedKeys(): Computed<ReadonlySet<string>> & Disposable;
-//#endregion
-export { createPressedKeys };

package/dist/signals/lib/pressed-keys.mjs

@@ -1,32 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-import { createEventListener } from "./event-listener.mjs";
-//#region src/signals/lib/pressed-keys.ts
-/**
-* Returns a `Computed<ReadonlySet<string>>` containing all keyboard keys
-* currently being held down.  Key values follow the `KeyboardEvent.key` spec.
-*/
-function createPressedKeys() {
-	const keys = signal(/* @__PURE__ */ new Set());
-	const onKeyDown = (e) => {
-		const next = new Set(keys());
-		next.add(e.key);
-		keys(next);
-	};
-	const onKeyUp = (e) => {
-		const next = new Set(keys());
-		next.delete(e.key);
-		keys(next);
-	};
-	const onBlur = () => keys(/* @__PURE__ */ new Set());
-	const r1 = createEventListener(window, "keydown", onKeyDown);
-	const r2 = createEventListener(window, "keyup", onKeyUp);
-	const r3 = createEventListener(window, "blur", onBlur);
-	const cleanup = () => {
-		r1();
-		r2();
-		r3();
-	};
-	return Object.assign(keys, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createPressedKeys };

package/dist/signals/lib/pressed-keys.test.d.mts

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

package/dist/signals/lib/pressed-keys.test.mjs

@@ -1,54 +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 { createPressedKeys } from "./pressed-keys.mjs";
-//#region src/signals/lib/pressed-keys.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createPressedKeys", () => {
-	it("starts with an empty set", () => {
-		let keys;
-		effectScope(() => {
-			keys = createPressedKeys();
-		});
-		globalExpect(keys().size).toBe(0);
-	});
-	it("adds a key on keydown", () => {
-		let keys;
-		effectScope(() => {
-			keys = createPressedKeys();
-		});
-		window.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }));
-		globalExpect(keys().has("a")).toBe(true);
-	});
-	it("removes a key on keyup", () => {
-		let keys;
-		effectScope(() => {
-			keys = createPressedKeys();
-		});
-		window.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }));
-		window.dispatchEvent(new KeyboardEvent("keyup", { key: "a" }));
-		globalExpect(keys().has("a")).toBe(false);
-	});
-	it("tracks multiple keys simultaneously", () => {
-		let keys;
-		effectScope(() => {
-			keys = createPressedKeys();
-		});
-		window.dispatchEvent(new KeyboardEvent("keydown", { key: "Control" }));
-		window.dispatchEvent(new KeyboardEvent("keydown", { key: "a" }));
-		globalExpect(keys().has("Control")).toBe(true);
-		globalExpect(keys().has("a")).toBe(true);
-	});
-	it("stops reacting after Symbol.dispose", () => {
-		let keys;
-		effectScope(() => {
-			keys = createPressedKeys();
-		});
-		keys[Symbol.dispose]();
-		window.dispatchEvent(new KeyboardEvent("keydown", { key: "z" }));
-		globalExpect(keys().has("z")).toBe(false);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/previous-distinct.d.mts

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/previous-distinct.d.ts
-/**
- * Like `createPrevious` but only updates when the value is *distinct*
- * (i.e. fails the equality check).
- */
-declare function createPreviousDistinct<T>(getter: () => T, isEqual?: (a: T, b: T) => boolean): Computed<T | undefined>;
-//#endregion
-export { createPreviousDistinct };

package/dist/signals/lib/previous-distinct.mjs

@@ -1,22 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/previous-distinct.ts
-/**
-* Like `createPrevious` but only updates when the value is *distinct*
-* (i.e. fails the equality check).
-*/
-function createPreviousDistinct(getter, isEqual = Object.is) {
-	const prev = signal(void 0);
-	let current;
-	let initialized = false;
-	effect(() => {
-		const next = getter();
-		if (!initialized || !isEqual(next, current)) {
-			prev(current);
-			current = next;
-			initialized = true;
-		}
-	});
-	return prev;
-}
-//#endregion
-export { createPreviousDistinct };

package/dist/signals/lib/previous-distinct.test.d.mts

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

package/dist/signals/lib/previous-distinct.test.mjs

@@ -1,50 +0,0 @@
-import { f as signal, 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 { createPreviousDistinct } from "./previous-distinct.mjs";
-//#region src/signals/lib/previous-distinct.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createPreviousDistinct", () => {
-	it("starts as undefined", () => {
-		const s = signal(0);
-		let prev;
-		effectScope(() => {
-			prev = createPreviousDistinct(() => s());
-		});
-		globalExpect(prev()).toBeUndefined();
-	});
-	it("updates previous when value changes", () => {
-		const s = signal(0);
-		let prev;
-		effectScope(() => {
-			prev = createPreviousDistinct(() => s());
-		});
-		s(1);
-		globalExpect(prev()).toBe(0);
-	});
-	it("does not update previous when value is the same", () => {
-		const s = signal(0);
-		let prev;
-		effectScope(() => {
-			prev = createPreviousDistinct(() => s());
-		});
-		s(1);
-		globalExpect(prev()).toBe(0);
-		s(1);
-		globalExpect(prev()).toBe(0);
-	});
-	it("uses a custom equality function", () => {
-		const s = signal({ id: 1 });
-		let prev;
-		effectScope(() => {
-			prev = createPreviousDistinct(() => s(), (a, b) => a.id === b.id);
-		});
-		s({ id: 1 });
-		globalExpect(prev()).toBeUndefined();
-		s({ id: 2 });
-		globalExpect(prev()?.id).toBe(1);
-	});
-});
-//#endregion
-export {};

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

@@ -1,10 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/previous.d.ts
-/**
- * Returns a `Computed` that always holds the *previous* value emitted by
- * `getter`.  Starts as `undefined` until the getter changes for the first time.
- */
-declare function createPrevious<T>(getter: () => T): Computed<T | undefined>;
-//#endregion
-export { createPrevious };

package/dist/signals/lib/previous.mjs

@@ -1,18 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/previous.ts
-/**
-* Returns a `Computed` that always holds the *previous* value emitted by
-* `getter`.  Starts as `undefined` until the getter changes for the first time.
-*/
-function createPrevious(getter) {
-	const prev = signal(void 0);
-	let current;
-	effect(() => {
-		const next = getter();
-		prev(current);
-		current = next;
-	});
-	return prev;
-}
-//#endregion
-export { createPrevious };

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

@@ -1,47 +0,0 @@
-import { f as signal, o as effectScope } from "../../signals-CLAPw8kk.mjs";
-import { a as describe, o as it, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
-import { createPrevious } from "./previous.mjs";
-//#region src/signals/lib/previous.test.ts
-describe("createPrevious", () => {
-	it("starts as undefined", () => {
-		const s = signal(1);
-		let p;
-		effectScope(() => {
-			p = createPrevious(() => s());
-		});
-		globalExpect(p()).toBeUndefined();
-	});
-	it("returns the previous value after a change", () => {
-		const s = signal(1);
-		let p;
-		effectScope(() => {
-			p = createPrevious(() => s());
-		});
-		s(2);
-		globalExpect(p()).toBe(1);
-	});
-	it("tracks each successive previous value", () => {
-		const s = signal("a");
-		let p;
-		effectScope(() => {
-			p = createPrevious(() => s());
-		});
-		s("b");
-		globalExpect(p()).toBe("a");
-		s("c");
-		globalExpect(p()).toBe("b");
-	});
-	it("does not update after scope disposal", () => {
-		const s = signal(10);
-		let p;
-		const stop = effectScope(() => {
-			p = createPrevious(() => s());
-		});
-		s(20);
-		stop();
-		s(30);
-		globalExpect(p()).toBe(10);
-	});
-});
-//#endregion
-export {};

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

@@ -1,17 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/queue.d.ts
-type QueueResult<T> = {
-  items: Computed<readonly T[]>;
-  add(item: T): void;
-  remove(): T | undefined;
-  peek(): T | undefined;
-  clear(): void;
-  size: Computed<number>;
-};
-/**
- * Reactive FIFO queue.
- */
-declare function createQueue<T>(initial?: T[]): QueueResult<T>;
-//#endregion
-export { createQueue };

package/dist/signals/lib/queue.mjs

@@ -1,28 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/queue.ts
-/**
-* Reactive FIFO queue.
-*/
-function createQueue(initial = []) {
-	const s = signal([...initial]);
-	const add = (item) => s([...s(), item]);
-	const remove = () => {
-		const arr = [...s()];
-		const first = arr.shift();
-		s(arr);
-		return first;
-	};
-	const peek = () => s()[0];
-	const clear = () => s([]);
-	const size = () => s().length;
-	return {
-		items: s,
-		add,
-		remove,
-		peek,
-		clear,
-		size
-	};
-}
-//#endregion
-export { createQueue };

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

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

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

@@ -1,61 +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 { createQueue } from "./queue.mjs";
-//#region src/signals/lib/queue.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createQueue", () => {
-	it("starts empty by default", () => {
-		let q;
-		effectScope(() => {
-			q = createQueue();
-		});
-		globalExpect(q.items()).toEqual([]);
-		globalExpect(q.size()).toBe(0);
-	});
-	it("add enqueues an item", () => {
-		let q;
-		effectScope(() => {
-			q = createQueue();
-		});
-		q.add(1);
-		q.add(2);
-		globalExpect(q.items()).toEqual([1, 2]);
-	});
-	it("remove dequeues the first item (FIFO)", () => {
-		let q;
-		effectScope(() => {
-			q = createQueue([
-				1,
-				2,
-				3
-			]);
-		});
-		globalExpect(q.remove()).toBe(1);
-		globalExpect(q.items()).toEqual([2, 3]);
-	});
-	it("peek returns the front without removing", () => {
-		let q;
-		effectScope(() => {
-			q = createQueue([10, 20]);
-		});
-		globalExpect(q.peek()).toBe(10);
-		globalExpect(q.size()).toBe(2);
-	});
-	it("clear empties the queue", () => {
-		let q;
-		effectScope(() => {
-			q = createQueue([
-				1,
-				2,
-				3
-			]);
-		});
-		q.clear();
-		globalExpect(q.items()).toEqual([]);
-		globalExpect(q.size()).toBe(0);
-	});
-});
-//#endregion
-export {};

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

@@ -1,17 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/raf.d.ts
-type RafResult = {
-  isRunning: Computed<boolean>;
-  start(): void;
-  stop(): void;
-} & Disposable;
-/**
- * Looping `requestAnimationFrame` wrapper with start/stop control.
- *
- * The callback receives the `DOMHighResTimeStamp` elapsed since page load.
- * Starts running immediately on creation.
- */
-declare function createRaf(callback: (time: number) => void): RafResult;
-//#endregion
-export { createRaf };