elements-kit 0.0.8 → 0.0.9

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

@@ -0,0 +1,15 @@
+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

@@ -0,0 +1,25 @@
+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.d.mts

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

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

@@ -0,0 +1,53 @@
+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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,21 @@
+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

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

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

@@ -0,0 +1,74 @@
+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/debounced.d.mts

@@ -0,0 +1,12 @@
+import { t as Computed } from "../../index-BtqiEEfc.mjs";
+
+//#region src/signals/lib/debounced.d.ts
+/**
+ * Returns a `Computed` that mirrors `getter` but only updates after `delay`
+ * milliseconds of silence (i.e. no new values from `getter`).
+ *
+ * The initial value is read synchronously, so the computed is never undefined.
+ */
+declare function createDebounced<T>(getter: () => T, delay: number): Computed<T>;
+//#endregion
+export { createDebounced };

package/dist/signals/lib/debounced.mjs

@@ -0,0 +1,20 @@
+import { a as effect, d as onCleanup, f as signal } from "../../signals-CLAPw8kk.mjs";
+//#region src/signals/lib/debounced.ts
+/**
+* Returns a `Computed` that mirrors `getter` but only updates after `delay`
+* milliseconds of silence (i.e. no new values from `getter`).
+*
+* The initial value is read synchronously, so the computed is never undefined.
+*/
+function createDebounced(getter, delay) {
+	const s = signal(getter());
+	let timer;
+	effect(() => {
+		const latest = getter();
+		timer = setTimeout(() => s(latest), delay);
+		onCleanup(() => clearTimeout(timer));
+	});
+	return s;
+}
+//#endregion
+export { createDebounced };

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

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

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

@@ -0,0 +1,66 @@
+import { f as signal, o as effectScope } from "../../signals-CLAPw8kk.mjs";
+import { a as describe, i as beforeEach, n as vi, o as it, r as afterEach, t as globalExpect } from "../../test.BmQO5GaM-CR2qjV1t.mjs";
+import { createDebounced } from "./debounced.mjs";
+//#region src/signals/lib/debounced.test.ts
+beforeEach(() => {
+	vi.useFakeTimers();
+});
+afterEach(() => {
+	vi.useRealTimers();
+});
+describe("createDebounced", () => {
+	it("returns the initial value synchronously", () => {
+		const s = signal(42);
+		let d;
+		effectScope(() => {
+			d = createDebounced(() => s(), 100);
+		});
+		globalExpect(d()).toBe(42);
+	});
+	it("does not update before the delay elapses", () => {
+		const s = signal(0);
+		let d;
+		effectScope(() => {
+			d = createDebounced(() => s(), 100);
+		});
+		s(1);
+		vi.advanceTimersByTime(50);
+		globalExpect(d()).toBe(0);
+	});
+	it("updates after the delay elapses", () => {
+		const s = signal(0);
+		let d;
+		effectScope(() => {
+			d = createDebounced(() => s(), 100);
+		});
+		s(1);
+		vi.advanceTimersByTime(100);
+		globalExpect(d()).toBe(1);
+	});
+	it("resets the timer on each rapid change", () => {
+		const s = signal(0);
+		let d;
+		effectScope(() => {
+			d = createDebounced(() => s(), 100);
+		});
+		s(1);
+		vi.advanceTimersByTime(50);
+		s(2);
+		vi.advanceTimersByTime(50);
+		globalExpect(d()).toBe(0);
+		vi.advanceTimersByTime(50);
+		globalExpect(d()).toBe(2);
+	});
+	it("stops updating after scope disposal", () => {
+		const s = signal(0);
+		let d;
+		effectScope(() => {
+			d = createDebounced(() => s(), 100);
+		})();
+		s(99);
+		vi.advanceTimersByTime(200);
+		globalExpect(d()).toBe(0);
+	});
+});
+//#endregion
+export {};

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,15 @@
+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

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

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

@@ -0,0 +1,33 @@
+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-rect.d.mts

@@ -0,0 +1,21 @@
+import { t as Computed } from "../../index-BtqiEEfc.mjs";
+
+//#region src/signals/lib/element-rect.d.ts
+type RectResult = {
+  x: Computed<number>;
+  y: Computed<number>;
+  width: Computed<number>;
+  height: Computed<number>;
+  top: Computed<number>;
+  right: Computed<number>;
+  bottom: Computed<number>;
+  left: Computed<number>;
+} & Disposable;
+/**
+ * Observes the full bounding rect of `target` using a `ResizeObserver` (which
+ * fires on size changes) and returns all eight DOMRect properties as reactive
+ * computeds.
+ */
+declare function createElementRect(target: Element | (() => Element | null)): RectResult;
+//#endregion
+export { createElementRect };

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

@@ -0,0 +1,46 @@
+import { f as signal } from "../../signals-CLAPw8kk.mjs";
+import { createResizeObserver } from "./resize-observer.mjs";
+//#region src/signals/lib/element-rect.ts
+/**
+* Observes the full bounding rect of `target` using a `ResizeObserver` (which
+* fires on size changes) and returns all eight DOMRect properties as reactive
+* computeds.
+*/
+function createElementRect(target) {
+	const x = signal(0);
+	const y = signal(0);
+	const width = signal(0);
+	const height = signal(0);
+	const top = signal(0);
+	const right = signal(0);
+	const bottom = signal(0);
+	const left = signal(0);
+	const updateRect = (el) => {
+		const rect = el.getBoundingClientRect();
+		x(rect.x);
+		y(rect.y);
+		width(rect.width);
+		height(rect.height);
+		top(rect.top);
+		right(rect.right);
+		bottom(rect.bottom);
+		left(rect.left);
+	};
+	const observer = createResizeObserver(target, (entries) => {
+		for (const entry of entries) updateRect(entry.target);
+	});
+	const el = typeof target === "function" ? target() : target;
+	if (el) updateRect(el);
+	return Object.assign({
+		x,
+		y,
+		width,
+		height,
+		top,
+		right,
+		bottom,
+		left
+	}, { [Symbol.dispose]: observer[Symbol.dispose] });
+}
+//#endregion
+export { createElementRect };

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

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

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

@@ -0,0 +1,99 @@
+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 { createElementRect } from "./element-rect.mjs";
+//#region src/signals/lib/element-rect.test.ts
+afterEach(() => {
+	document.body.innerHTML = "";
+	vi.restoreAllMocks();
+	vi.unstubAllGlobals();
+});
+describe("createElementRect", () => {
+	it("returns initial rect values from getBoundingClientRect", () => {
+		const el = document.createElement("div");
+		document.body.appendChild(el);
+		vi.spyOn(el, "getBoundingClientRect").mockReturnValue({
+			x: 10,
+			y: 20,
+			width: 100,
+			height: 50,
+			top: 20,
+			right: 110,
+			bottom: 70,
+			left: 10,
+			toJSON: () => ({})
+		});
+		let rect;
+		effectScope(() => {
+			rect = createElementRect(el);
+		});
+		globalExpect(rect.x()).toBe(10);
+		globalExpect(rect.y()).toBe(20);
+		globalExpect(rect.width()).toBe(100);
+		globalExpect(rect.height()).toBe(50);
+		globalExpect(rect.top()).toBe(20);
+		globalExpect(rect.right()).toBe(110);
+		globalExpect(rect.bottom()).toBe(70);
+		globalExpect(rect.left()).toBe(10);
+	});
+	it("updates all rect properties when ResizeObserver fires", () => {
+		const el = document.createElement("div");
+		document.body.appendChild(el);
+		vi.spyOn(el, "getBoundingClientRect").mockReturnValueOnce({
+			x: 0,
+			y: 0,
+			width: 0,
+			height: 0,
+			top: 0,
+			right: 0,
+			bottom: 0,
+			left: 0,
+			toJSON: () => ({})
+		}).mockReturnValueOnce({
+			x: 5,
+			y: 15,
+			width: 200,
+			height: 80,
+			top: 15,
+			right: 205,
+			bottom: 95,
+			left: 5,
+			toJSON: () => ({})
+		});
+		let observerCallback;
+		vi.stubGlobal("ResizeObserver", function MockRO(cb) {
+			observerCallback = cb;
+			return {
+				observe: vi.fn(),
+				disconnect: vi.fn(),
+				unobserve: vi.fn()
+			};
+		});
+		let rect;
+		effectScope(() => {
+			rect = createElementRect(el);
+		});
+		observerCallback([{ target: el }], {});
+		globalExpect(rect.width()).toBe(200);
+		globalExpect(rect.height()).toBe(80);
+		globalExpect(rect.top()).toBe(15);
+	});
+	it("disconnects 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");
+		let rect;
+		effectScope(() => {
+			rect = createElementRect(el);
+		});
+		rect[Symbol.dispose]();
+		globalExpect(disconnect).toHaveBeenCalledOnce();
+	});
+});
+//#endregion
+export {};

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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,32 @@
+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

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