elements-kit 0.0.10 → 0.0.12

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

@@ -1,61 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/state-history.ts
-/**
-* Tracks the history of a reactive getter, providing `undo` and `redo`.
-*
-* @param getter - A reactive getter whose value is tracked.
-* @param capacity - Maximum number of history entries (default: 100).
-*/
-function createStateHistory(getter, capacity = 100) {
-	const history = signal([getter()]);
-	const index = signal(0);
-	let paused = false;
-	let firstRun = true;
-	effect(() => {
-		const next = getter();
-		if (paused) return;
-		if (firstRun) {
-			firstRun = false;
-			return;
-		}
-		const hist = history();
-		const idx = index();
-		const trimmed = hist.slice(0, idx + 1);
-		trimmed.push(next);
-		if (trimmed.length > capacity) trimmed.shift();
-		history(trimmed);
-		index(trimmed.length - 1);
-	});
-	const canUndo = () => index() > 0;
-	const canRedo = () => index() < history().length - 1;
-	const undo = () => {
-		if (!canUndo()) return;
-		paused = true;
-		index(index() - 1);
-		paused = false;
-	};
-	const redo = () => {
-		if (!canRedo()) return;
-		paused = true;
-		index(index() + 1);
-		paused = false;
-	};
-	const clear = () => {
-		const current = getter();
-		paused = true;
-		history([current]);
-		index(0);
-		paused = false;
-	};
-	return {
-		history,
-		index,
-		canUndo,
-		canRedo,
-		undo,
-		redo,
-		clear
-	};
-}
-//#endregion
-export { createStateHistory };

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

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

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

@@ -1,106 +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 { createStateHistory } from "./state-history.mjs";
-//#region src/signals/lib/state-history.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createStateHistory", () => {
-	it("starts with the current getter value in history", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		globalExpect(h.history()).toEqual([0]);
-		globalExpect(h.index()).toBe(0);
-	});
-	it("records new values", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		s(2);
-		globalExpect(h.history()).toEqual([
-			0,
-			1,
-			2
-		]);
-		globalExpect(h.index()).toBe(2);
-	});
-	it("canUndo is false initially", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		globalExpect(h.canUndo()).toBe(false);
-	});
-	it("canUndo is true after a change", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		globalExpect(h.canUndo()).toBe(true);
-	});
-	it("undo moves the index back", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		s(2);
-		h.undo();
-		globalExpect(h.index()).toBe(1);
-		globalExpect(h.canRedo()).toBe(true);
-	});
-	it("redo moves the index forward", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		s(2);
-		h.undo();
-		h.redo();
-		globalExpect(h.index()).toBe(2);
-		globalExpect(h.canRedo()).toBe(false);
-	});
-	it("new change after undo drops the future", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		s(2);
-		h.undo();
-		s(3);
-		globalExpect(h.history()).toEqual([
-			0,
-			1,
-			3
-		]);
-		globalExpect(h.canRedo()).toBe(false);
-	});
-	it("clear resets history to the current value", () => {
-		const s = signal(0);
-		let h;
-		effectScope(() => {
-			h = createStateHistory(() => s());
-		});
-		s(1);
-		s(2);
-		h.clear();
-		globalExpect(h.history()).toEqual([2]);
-		globalExpect(h.index()).toBe(0);
-	});
-});
-//#endregion
-export {};

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

@@ -1,16 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/state-validator.d.ts
-type StateValidatorResult<E> = {
-  errors: Computed<E | null>;
-  isValid: Computed<boolean>;
-};
-/**
- * Runs `validator` reactively against a getter's value and exposes the result
- * as `errors` and `isValid` computeds.
- *
- * Return `null` from `validator` to indicate no error.
- */
-declare function createStateValidator<T, E>(getter: () => T, validator: (value: T) => E | null): StateValidatorResult<E>;
-//#endregion
-export { createStateValidator };

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

@@ -1,21 +0,0 @@
-import { a as effect, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/state-validator.ts
-/**
-* Runs `validator` reactively against a getter's value and exposes the result
-* as `errors` and `isValid` computeds.
-*
-* Return `null` from `validator` to indicate no error.
-*/
-function createStateValidator(getter, validator) {
-	const errors = signal(null);
-	effect(() => {
-		errors(validator(getter()));
-	});
-	const isValid = () => errors() === null;
-	return {
-		errors,
-		isValid
-	};
-}
-//#endregion
-export { createStateValidator };

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

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

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

@@ -1,41 +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 { createStateValidator } from "./state-validator.mjs";
-//#region src/signals/lib/state-validator.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createStateValidator", () => {
-	it("starts with validator result of the initial value", () => {
-		const s = signal("");
-		let v;
-		effectScope(() => {
-			v = createStateValidator(() => s(), (value) => value.length < 3 ? "Too short" : null);
-		});
-		globalExpect(v.errors()).toBe("Too short");
-		globalExpect(v.isValid()).toBe(false);
-	});
-	it("becomes valid when constraint is met", () => {
-		const s = signal("");
-		let v;
-		effectScope(() => {
-			v = createStateValidator(() => s(), (value) => value.length < 3 ? "Too short" : null);
-		});
-		s("hello");
-		globalExpect(v.errors()).toBeNull();
-		globalExpect(v.isValid()).toBe(true);
-	});
-	it("re-validates when the source changes", () => {
-		const s = signal(5);
-		let v;
-		effectScope(() => {
-			v = createStateValidator(() => s(), (n) => n > 10 ? "Too big" : null);
-		});
-		globalExpect(v.isValid()).toBe(true);
-		s(15);
-		globalExpect(v.errors()).toBe("Too big");
-		globalExpect(v.isValid()).toBe(false);
-	});
-});
-//#endregion
-export {};

package/dist/signals/lib/throttled.mjs

@@ -1,45 +0,0 @@
-import { a as effect, d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/throttled.ts
-/**
-* Returns a `Computed` that mirrors `getter` but updates at most once per
-* `interval` milliseconds.  A trailing-edge update is scheduled so the final
-* value is never lost.
-*
-* The initial value is read synchronously.
-*/
-function createThrottled(getter, interval) {
-	const s = signal(getter());
-	let lastRun = -Infinity;
-	let trailingTimer;
-	let firstRun = true;
-	effect(() => {
-		const latest = getter();
-		if (firstRun) {
-			firstRun = false;
-			return;
-		}
-		const now = Date.now();
-		const elapsed = now - lastRun;
-		if (trailingTimer !== void 0) {
-			clearTimeout(trailingTimer);
-			trailingTimer = void 0;
-		}
-		if (elapsed >= interval) {
-			lastRun = now;
-			s(latest);
-		} else {
-			trailingTimer = setTimeout(() => {
-				lastRun = Date.now();
-				trailingTimer = void 0;
-				s(latest);
-			}, interval - elapsed);
-			onCleanup(() => {
-				clearTimeout(trailingTimer);
-				trailingTimer = void 0;
-			});
-		}
-	});
-	return s;
-}
-//#endregion
-export { createThrottled };

package/dist/signals/lib/timeout.mjs

@@ -1,39 +0,0 @@
-import { d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/timeout.ts
-/**
-* Reactive `setTimeout` wrapper with pause/resume/reset control.
-* The callback fires once after `delay` ms.  Starts running immediately.
-*/
-function createTimeout(callback, delay) {
-	const isPending = signal(false);
-	let id;
-	const stop = () => {
-		clearTimeout(id);
-		id = void 0;
-		isPending(false);
-	};
-	const start = () => {
-		if (isPending()) return;
-		isPending(true);
-		id = setTimeout(() => {
-			isPending(false);
-			id = void 0;
-			callback();
-		}, delay);
-	};
-	const reset = () => {
-		stop();
-		start();
-	};
-	start();
-	const cleanup = () => stop();
-	onCleanup(cleanup);
-	return Object.assign({
-		isPending,
-		start,
-		stop,
-		reset
-	}, { [Symbol.dispose]: cleanup });
-}
-//#endregion
-export { createTimeout };

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

@@ -1,12 +0,0 @@
-import { n as Signal } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/toggle.d.ts
-type ToggleResult = Signal<boolean> & {
-  toggle(): void;
-};
-/**
- * Returns a boolean `Signal` with an additional `toggle()` helper.
- */
-declare function createToggle(initial?: boolean): ToggleResult;
-//#endregion
-export { createToggle };

package/dist/signals/lib/toggle.mjs

@@ -1,12 +0,0 @@
-import { f as signal } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/toggle.ts
-/**
-* Returns a boolean `Signal` with an additional `toggle()` helper.
-*/
-function createToggle(initial = false) {
-	const s = signal(initial);
-	const toggle = () => s(!s());
-	return Object.assign(s, { toggle });
-}
-//#endregion
-export { createToggle };

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

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

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

@@ -1,43 +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 { createToggle } from "./toggle.mjs";
-//#region src/signals/lib/toggle.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createToggle", () => {
-	it("starts as false by default", () => {
-		let t;
-		effectScope(() => {
-			t = createToggle();
-		});
-		globalExpect(t()).toBe(false);
-	});
-	it("starts with provided initial value", () => {
-		let t;
-		effectScope(() => {
-			t = createToggle(true);
-		});
-		globalExpect(t()).toBe(true);
-	});
-	it("toggle() flips the value", () => {
-		let t;
-		effectScope(() => {
-			t = createToggle(false);
-		});
-		t.toggle();
-		globalExpect(t()).toBe(true);
-		t.toggle();
-		globalExpect(t()).toBe(false);
-	});
-	it("can be set directly via signal call", () => {
-		let t;
-		effectScope(() => {
-			t = createToggle();
-		});
-		t(true);
-		globalExpect(t()).toBe(true);
-	});
-});
-//#endregion
-export {};

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

@@ -1,21 +0,0 @@
-import { n as Signal, t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/video.d.ts
-type VideoResult = {
-  element: HTMLVideoElement;
-  playing: Computed<boolean>;
-  muted: Signal<boolean>;
-  volume: Signal<number>;
-  duration: Computed<number>;
-  time: Signal<number>;
-  ended: Computed<boolean>;
-  play(): void;
-  pause(): void;
-  toggle(): void;
-} & Disposable;
-/**
- * Wraps an `HTMLVideoElement` with reactive state and playback controls.
- */
-declare function createVideo(element: HTMLVideoElement): VideoResult;
-//#endregion
-export { createVideo };

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

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

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

@@ -1,51 +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 { createVideo } from "./video.mjs";
-//#region src/signals/lib/video.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-	vi.restoreAllMocks();
-});
-describe("createVideo", () => {
-	it("accepts an HTMLVideoElement", () => {
-		const el = document.createElement("video");
-		document.body.appendChild(el);
-		let v;
-		effectScope(() => {
-			v = createVideo(el);
-		});
-		globalExpect(v.element).toBe(el);
-	});
-	it("starts as paused", () => {
-		const el = document.createElement("video");
-		document.body.appendChild(el);
-		let v;
-		effectScope(() => {
-			v = createVideo(el);
-		});
-		globalExpect(v.playing()).toBe(false);
-	});
-	it("time(v) updates currentTime", () => {
-		const el = document.createElement("video");
-		document.body.appendChild(el);
-		let v;
-		effectScope(() => {
-			v = createVideo(el);
-		});
-		v.time(30);
-		globalExpect(el.currentTime).toBe(30);
-	});
-	it("removes event listeners when scope is disposed", () => {
-		const el = document.createElement("video");
-		document.body.appendChild(el);
-		let dispose;
-		dispose = effectScope(() => {
-			createVideo(el);
-		});
-		const removeSpy = vi.spyOn(el, "removeEventListener");
-		dispose();
-		globalExpect(removeSpy).toHaveBeenCalled();
-	});
-});
-//#endregion
-export {};

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

@@ -1,16 +0,0 @@
-//#region src/signals/lib/watch.d.ts
-/**
- * Watches a reactive `source` getter and runs `callback` whenever the source
- * changes, skipping the initial run.
- *
- * ```ts
- * const count = signal(0);
- * createWatch(() => count(), (value, prev) => console.log(value, prev));
- * count(1); // logs: 1, 0
- * ```
- *
- * @returns A disposal function.
- */
-declare function createWatch<T>(source: () => T, callback: (value: T, prev: T | undefined) => void): () => void;
-//#endregion
-export { createWatch };

package/dist/signals/lib/watch.mjs

@@ -1,31 +0,0 @@
-import { a as effect, m as untracked } from "../../signals-CLAPw8kk.mjs";
-//#region src/signals/lib/watch.ts
-/**
-* Watches a reactive `source` getter and runs `callback` whenever the source
-* changes, skipping the initial run.
-*
-* ```ts
-* const count = signal(0);
-* createWatch(() => count(), (value, prev) => console.log(value, prev));
-* count(1); // logs: 1, 0
-* ```
-*
-* @returns A disposal function.
-*/
-function createWatch(source, callback) {
-	let prev;
-	let firstRun = true;
-	return effect(() => {
-		const value = source();
-		if (firstRun) {
-			firstRun = false;
-			prev = value;
-			return;
-		}
-		const p = prev;
-		prev = value;
-		untracked(() => callback(value, p));
-	});
-}
-//#endregion
-export { createWatch };

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

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

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

@@ -1,51 +0,0 @@
-import { f as signal, 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 { createWatch } from "./watch.mjs";
-//#region src/signals/lib/watch.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createWatch", () => {
-	it("does not call callback on initial run", () => {
-		const s = signal(0);
-		const cb = vi.fn();
-		effectScope(() => {
-			createWatch(() => s(), cb);
-		});
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-	it("calls callback when the source changes", () => {
-		const s = signal(0);
-		const cb = vi.fn();
-		effectScope(() => {
-			createWatch(() => s(), cb);
-		});
-		s(1);
-		globalExpect(cb).toHaveBeenCalledOnce();
-		globalExpect(cb).toHaveBeenCalledWith(1, 0);
-	});
-	it("passes the previous value correctly", () => {
-		const s = signal("a");
-		const cb = vi.fn();
-		effectScope(() => {
-			createWatch(() => s(), cb);
-		});
-		s("b");
-		s("c");
-		globalExpect(cb).toHaveBeenNthCalledWith(1, "b", "a");
-		globalExpect(cb).toHaveBeenNthCalledWith(2, "c", "b");
-	});
-	it("disposal stops the watch", () => {
-		const s = signal(0);
-		const cb = vi.fn();
-		let stop;
-		effectScope(() => {
-			stop = createWatch(() => s(), cb);
-		});
-		stop();
-		s(1);
-		globalExpect(cb).not.toHaveBeenCalled();
-	});
-});
-//#endregion
-export {};

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

@@ -1,14 +0,0 @@
-import { t as Computed } from "../../index-BtqiEEfc.mjs";
-
-//#region src/signals/lib/window-size.d.ts
-type WindowSizeResult = {
-  width: Computed<number>;
-  height: Computed<number>;
-} & Disposable;
-/**
- * Returns reactive `width` and `height` signals tracking the browser window
- * inner dimensions.
- */
-declare function createWindowSize(): WindowSizeResult;
-//#endregion
-export { createWindowSize };

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

@@ -1,21 +0,0 @@
-import { fromEvent, sync } from "./event-driven.mjs";
-//#region src/signals/lib/window-size.ts
-/**
-* Returns reactive `width` and `height` signals tracking the browser window
-* inner dimensions.
-*/
-function createWindowSize() {
-	const subscribe = fromEvent(window, "resize");
-	const [width, stopWidth] = sync(subscribe, () => typeof window !== "undefined" ? window.innerWidth : 0);
-	const [height, stopHeight] = sync(subscribe, () => typeof window !== "undefined" ? window.innerHeight : 0);
-	return {
-		width,
-		height,
-		[Symbol.dispose]: () => {
-			stopWidth();
-			stopHeight();
-		}
-	};
-}
-//#endregion
-export { createWindowSize };

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

@@ -1,50 +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 { createWindowSize } from "./window-size.mjs";
-//#region src/signals/lib/window-size.test.ts
-afterEach(() => {
-	document.body.innerHTML = "";
-});
-describe("createWindowSize", () => {
-	it("starts with current window dimensions", () => {
-		let ws;
-		effectScope(() => {
-			ws = createWindowSize();
-		});
-		globalExpect(ws.width()).toBe(window.innerWidth);
-		globalExpect(ws.height()).toBe(window.innerHeight);
-	});
-	it("updates on resize event", () => {
-		let ws;
-		effectScope(() => {
-			ws = createWindowSize();
-		});
-		Object.defineProperty(window, "innerWidth", {
-			configurable: true,
-			get: () => 1024
-		});
-		Object.defineProperty(window, "innerHeight", {
-			configurable: true,
-			get: () => 768
-		});
-		window.dispatchEvent(new Event("resize"));
-		globalExpect(ws.width()).toBe(1024);
-		globalExpect(ws.height()).toBe(768);
-	});
-	it("stops reacting after Symbol.dispose", () => {
-		let ws;
-		effectScope(() => {
-			ws = createWindowSize();
-		});
-		const w0 = ws.width();
-		ws[Symbol.dispose]();
-		Object.defineProperty(window, "innerWidth", {
-			configurable: true,
-			get: () => 9999
-		});
-		window.dispatchEvent(new Event("resize"));
-		globalExpect(ws.width()).toBe(w0);
-	});
-});
-//#endregion
-export {};