@praxisjs/composables 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @praxisjs/composables
 
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [fe39901]
+  - @praxisjs/core@0.4.1
+
 ## 0.1.3
 
 ### Patch Changes

package/dist/__tests__/browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser.test.d.ts.map

package/dist/__tests__/browser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/browser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/browser.test.js

@@ -0,0 +1,94 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+import { useMediaQuery, useColorScheme, useMouse, useKeyCombo, useIdle } from "../browser";
+// ---------- useMediaQuery ----------
+describe("useMediaQuery", () => {
+    it("returns computed that reflects matchMedia result", () => {
+        Object.defineProperty(window, "matchMedia", {
+            writable: true,
+            value: vi.fn((query) => ({
+                matches: query === "(prefers-color-scheme: dark)",
+                addEventListener: vi.fn(),
+                removeEventListener: vi.fn(),
+            })),
+        });
+        const isDark = useMediaQuery("(prefers-color-scheme: dark)");
+        expect(isDark()).toBe(true);
+        const isLight = useMediaQuery("(prefers-color-scheme: light)");
+        expect(isLight()).toBe(false);
+    });
+});
+// ---------- useColorScheme ----------
+describe("useColorScheme", () => {
+    it("isDark and isLight are complementary", () => {
+        Object.defineProperty(window, "matchMedia", {
+            writable: true,
+            value: vi.fn(() => ({
+                matches: true,
+                addEventListener: vi.fn(),
+                removeEventListener: vi.fn(),
+            })),
+        });
+        const { isDark, isLight } = useColorScheme();
+        expect(isDark()).toBe(true);
+        expect(isLight()).toBe(false);
+    });
+});
+// ---------- useMouse ----------
+describe("useMouse", () => {
+    it("starts at (0, 0)", () => {
+        const { x, y } = useMouse();
+        expect(x()).toBe(0);
+        expect(y()).toBe(0);
+    });
+    it("updates on mousemove event", () => {
+        const { x, y } = useMouse();
+        window.dispatchEvent(new MouseEvent("mousemove", { clientX: 100, clientY: 200 }));
+        expect(x()).toBe(100);
+        expect(y()).toBe(200);
+    });
+});
+// ---------- useKeyCombo ----------
+describe("useKeyCombo", () => {
+    it("starts as false", () => {
+        const pressed = useKeyCombo("ctrl+s");
+        expect(pressed()).toBe(false);
+    });
+    it("becomes true on matching keydown", () => {
+        const pressed = useKeyCombo("ctrl+s");
+        window.dispatchEvent(new KeyboardEvent("keydown", { key: "s", ctrlKey: true }));
+        expect(pressed()).toBe(true);
+    });
+    it("resets to false on keyup", () => {
+        const pressed = useKeyCombo("ctrl+s");
+        window.dispatchEvent(new KeyboardEvent("keydown", { key: "s", ctrlKey: true }));
+        window.dispatchEvent(new KeyboardEvent("keyup"));
+        expect(pressed()).toBe(false);
+    });
+});
+// ---------- useIdle ----------
+describe("useIdle", () => {
+    it("starts as not idle", () => {
+        vi.useFakeTimers();
+        const idle = useIdle(500);
+        expect(idle()).toBe(false);
+        vi.useRealTimers();
+    });
+    it("becomes idle after the timeout elapses", () => {
+        vi.useFakeTimers();
+        const idle = useIdle(500);
+        vi.advanceTimersByTime(500);
+        expect(idle()).toBe(true);
+        vi.useRealTimers();
+    });
+    it("resets idle on user activity", () => {
+        vi.useFakeTimers();
+        const idle = useIdle(500);
+        vi.advanceTimersByTime(300);
+        window.dispatchEvent(new MouseEvent("mousemove"));
+        vi.advanceTimersByTime(300); // not enough since activity reset the timer
+        expect(idle()).toBe(false);
+        vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=browser.test.js.map

package/dist/__tests__/browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.test.js","sourceRoot":"","sources":["../../src/__tests__/browser.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/dom.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dom.test.d.ts.map

package/dist/__tests__/dom.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dom.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dom.test.js

@@ -0,0 +1,84 @@
+// @vitest-environment jsdom
+import { describe, it, expect } from "vitest";
+import { createRef, useWindowSize, useScrollPosition, useFocus } from "../dom";
+// ---------- createRef ----------
+describe("createRef", () => {
+    it("starts with current = null", () => {
+        const ref = createRef();
+        expect(ref.current).toBeNull();
+    });
+    it("can be assigned an element", () => {
+        const ref = createRef();
+        const el = document.createElement("div");
+        ref.current = el;
+        expect(ref.current).toBe(el);
+    });
+});
+// ---------- useWindowSize ----------
+describe("useWindowSize", () => {
+    it("returns the current window dimensions", () => {
+        Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 1024 });
+        Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 768 });
+        const { width, height } = useWindowSize();
+        expect(width()).toBe(1024);
+        expect(height()).toBe(768);
+    });
+    it("updates on resize event", () => {
+        Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 800 });
+        Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 600 });
+        const { width, height } = useWindowSize();
+        Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 1280 });
+        Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 720 });
+        window.dispatchEvent(new Event("resize"));
+        expect(width()).toBe(1280);
+        expect(height()).toBe(720);
+    });
+});
+// ---------- useScrollPosition ----------
+describe("useScrollPosition", () => {
+    it("starts at (0, 0)", () => {
+        const { x, y } = useScrollPosition(window);
+        expect(x()).toBe(0);
+        expect(y()).toBe(0);
+    });
+    it("updates on element scroll", () => {
+        const el = document.createElement("div");
+        const { x, y } = useScrollPosition(el);
+        Object.defineProperty(el, "scrollLeft", { configurable: true, value: 50 });
+        Object.defineProperty(el, "scrollTop", { configurable: true, value: 80 });
+        el.dispatchEvent(new Event("scroll"));
+        expect(x()).toBe(50);
+        expect(y()).toBe(80);
+    });
+});
+// ---------- useFocus ----------
+describe("useFocus", () => {
+    it("starts as not focused", () => {
+        const el = document.createElement("input");
+        document.body.appendChild(el);
+        const ref = { current: el };
+        const focused = useFocus(ref);
+        expect(focused()).toBe(false);
+        document.body.removeChild(el);
+    });
+    it("becomes true on focus event", () => {
+        const el = document.createElement("input");
+        document.body.appendChild(el);
+        const ref = { current: el };
+        const focused = useFocus(ref);
+        el.dispatchEvent(new FocusEvent("focus"));
+        expect(focused()).toBe(true);
+        document.body.removeChild(el);
+    });
+    it("becomes false on blur event", () => {
+        const el = document.createElement("input");
+        document.body.appendChild(el);
+        const ref = { current: el };
+        const focused = useFocus(ref);
+        el.dispatchEvent(new FocusEvent("focus"));
+        el.dispatchEvent(new FocusEvent("blur"));
+        expect(focused()).toBe(false);
+        document.body.removeChild(el);
+    });
+});
+//# sourceMappingURL=dom.test.js.map

package/dist/__tests__/dom.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.test.js","sourceRoot":"","sources":["../../src/__tests__/dom.test.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE/E,kCAAkC;AAElC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sCAAsC;AAEtC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAEjG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAC1C,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAChG,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAEjG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAE1C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE1C,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,0CAA0C;AAE1C,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,EAAE,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEtC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iCAAiC;AAEjC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,EAAE,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/utilities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utilities.test.d.ts.map

package/dist/__tests__/utilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utilities.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utilities.test.js

@@ -0,0 +1,226 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { signal } from "@praxisjs/core/internal";
+import { usePagination, useClipboard, useGeolocation, useTimeAgo } from "../utilities";
+describe("usePagination", () => {
+    it("starts on page 1 by default", () => {
+        const p = usePagination({ total: 100, pageSize: 10 });
+        expect(p.page()).toBe(1);
+    });
+    it("respects initial page option", () => {
+        const p = usePagination({ total: 100, pageSize: 10, initial: 3 });
+        expect(p.page()).toBe(3);
+    });
+    it("computes total pages correctly", () => {
+        expect(usePagination({ total: 100, pageSize: 10 }).totalPages()).toBe(10);
+        expect(usePagination({ total: 101, pageSize: 10 }).totalPages()).toBe(11);
+        expect(usePagination({ total: 5, pageSize: 10 }).totalPages()).toBe(1);
+    });
+    it("computes offset", () => {
+        const p = usePagination({ total: 100, pageSize: 10 });
+        expect(p.offset()).toBe(0);
+        p.goTo(3);
+        expect(p.offset()).toBe(20);
+    });
+    it("next() advances the page", () => {
+        const p = usePagination({ total: 30, pageSize: 10 });
+        p.next();
+        expect(p.page()).toBe(2);
+    });
+    it("next() does nothing on last page", () => {
+        const p = usePagination({ total: 10, pageSize: 10 });
+        p.next();
+        expect(p.page()).toBe(1);
+    });
+    it("prev() goes back", () => {
+        const p = usePagination({ total: 30, pageSize: 10, initial: 3 });
+        p.prev();
+        expect(p.page()).toBe(2);
+    });
+    it("prev() does nothing on first page", () => {
+        const p = usePagination({ total: 30, pageSize: 10 });
+        p.prev();
+        expect(p.page()).toBe(1);
+    });
+    it("goTo() clamps to valid range", () => {
+        const p = usePagination({ total: 30, pageSize: 10 });
+        p.goTo(0);
+        expect(p.page()).toBe(1);
+        p.goTo(99);
+        expect(p.page()).toBe(3);
+    });
+    it("first() jumps to page 1", () => {
+        const p = usePagination({ total: 50, pageSize: 10, initial: 5 });
+        p.first();
+        expect(p.page()).toBe(1);
+    });
+    it("last() jumps to last page", () => {
+        const p = usePagination({ total: 50, pageSize: 10 });
+        p.last();
+        expect(p.page()).toBe(5);
+    });
+    it("hasNext is false on last page", () => {
+        const p = usePagination({ total: 10, pageSize: 10 });
+        expect(p.hasNext()).toBe(false);
+    });
+    it("hasPrev is false on first page", () => {
+        const p = usePagination({ total: 30, pageSize: 10 });
+        expect(p.hasPrev()).toBe(false);
+    });
+    it("pages() returns array of page numbers", () => {
+        const p = usePagination({ total: 30, pageSize: 10 });
+        expect(p.pages()).toEqual([1, 2, 3]);
+    });
+    it("pageSize() reflects the configured size", () => {
+        const p = usePagination({ total: 100, pageSize: 25 });
+        expect(p.pageSize()).toBe(25);
+    });
+    it("accepts a factory function for options", () => {
+        const p = usePagination(() => ({ total: 50, pageSize: 5 }));
+        expect(p.totalPages()).toBe(10);
+    });
+});
+// ── useClipboard ──────────────────────────────────────────────────────────────
+describe("useClipboard", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        Object.defineProperty(navigator, "clipboard", {
+            value: { writeText: vi.fn().mockResolvedValue(undefined) },
+            configurable: true,
+            writable: true,
+        });
+    });
+    afterEach(() => {
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("copied starts as false", () => {
+        const { copied } = useClipboard();
+        expect(copied()).toBe(false);
+    });
+    it("content starts as empty string", () => {
+        const { content } = useClipboard();
+        expect(content()).toBe("");
+    });
+    it("sets copied to true and content to the text after copy()", async () => {
+        const { copy, copied, content } = useClipboard();
+        await copy("hello");
+        expect(copied()).toBe(true);
+        expect(content()).toBe("hello");
+    });
+    it("resets copied to false after resetDelay", async () => {
+        const { copy, copied } = useClipboard(1000);
+        await copy("test");
+        expect(copied()).toBe(true);
+        vi.advanceTimersByTime(1000);
+        expect(copied()).toBe(false);
+    });
+    it("warns and does not update state on clipboard failure", async () => {
+        navigator.clipboard.writeText =
+            vi.fn().mockRejectedValue(new Error("denied"));
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { copy, copied } = useClipboard();
+        await copy("fail");
+        expect(copied()).toBe(false);
+        expect(warn).toHaveBeenCalled();
+        warn.mockRestore();
+    });
+});
+// ── useGeolocation ────────────────────────────────────────────────────────────
+describe("useGeolocation", () => {
+    it("starts with loading=true and lat/lng null", () => {
+        const successCb = [];
+        Object.defineProperty(navigator, "geolocation", {
+            value: {
+                getCurrentPosition: (success) => {
+                    successCb.push(success);
+                },
+            },
+            configurable: true,
+        });
+        const geo = useGeolocation();
+        expect(geo.loading()).toBe(true);
+        expect(geo.lat()).toBeNull();
+        expect(geo.lng()).toBeNull();
+    });
+    it("updates lat/lng/loading on success", () => {
+        let successCb = null;
+        Object.defineProperty(navigator, "geolocation", {
+            value: {
+                getCurrentPosition: (success) => {
+                    successCb = success;
+                },
+            },
+            configurable: true,
+        });
+        const geo = useGeolocation();
+        successCb({
+            coords: { latitude: 10.5, longitude: 20.5 },
+        });
+        expect(geo.lat()).toBe(10.5);
+        expect(geo.lng()).toBe(20.5);
+        expect(geo.loading()).toBe(false);
+    });
+    it("sets error and loading=false on failure", () => {
+        let errorCb = null;
+        Object.defineProperty(navigator, "geolocation", {
+            value: {
+                getCurrentPosition: (_s, error) => {
+                    errorCb = error;
+                },
+            },
+            configurable: true,
+        });
+        const geo = useGeolocation();
+        const fakeError = { code: 1, message: "denied" };
+        errorCb(fakeError);
+        expect(geo.error()).toBe(fakeError);
+        expect(geo.loading()).toBe(false);
+    });
+});
+// ── useTimeAgo ────────────────────────────────────────────────────────────────
+describe("useTimeAgo", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.clearAllTimers();
+        vi.useRealTimers();
+    });
+    it("returns a computed string", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now);
+        expect(typeof t()).toBe("string");
+    });
+    it("formats seconds ago", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 30_000);
+        expect(t()).toMatch(/segundo|second/i);
+    });
+    it("formats minutes ago", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 5 * 60_000);
+        expect(t()).toMatch(/minuto|minute/i);
+    });
+    it("formats hours ago", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 2 * 3_600_000);
+        expect(t()).toMatch(/hora|hour/i);
+    });
+    it("formats days ago", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 3 * 86_400_000);
+        expect(t()).toMatch(/dia|day/i);
+    });
+    it("formats months ago", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 60 * 86_400_000);
+        expect(t()).toMatch(/mes|month/i);
+    });
+    it("accepts a signal source", () => {
+        const src = signal(Date.now() - 90_000);
+        const t = useTimeAgo(src);
+        expect(typeof t()).toBe("string");
+    });
+});
+//# sourceMappingURL=utilities.test.js.map

package/dist/__tests__/utilities.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.test.js","sourceRoot":"","sources":["../../src/__tests__/utilities.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/composables",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,7 +14,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "0.4.0",
+    "@praxisjs/core": "0.4.1",
     "@praxisjs/shared": "0.2.0"
   },
   "scripts": {

package/src/__tests__/browser.test.ts

@@ -0,0 +1,118 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+
+import { useMediaQuery, useColorScheme, useMouse, useKeyCombo, useIdle } from "../browser";
+
+// ---------- useMediaQuery ----------
+
+describe("useMediaQuery", () => {
+  it("returns computed that reflects matchMedia result", () => {
+    Object.defineProperty(window, "matchMedia", {
+      writable: true,
+      value: vi.fn((query: string) => ({
+        matches: query === "(prefers-color-scheme: dark)",
+        addEventListener: vi.fn(),
+        removeEventListener: vi.fn(),
+      })),
+    });
+
+    const isDark = useMediaQuery("(prefers-color-scheme: dark)");
+    expect(isDark()).toBe(true);
+
+    const isLight = useMediaQuery("(prefers-color-scheme: light)");
+    expect(isLight()).toBe(false);
+  });
+});
+
+// ---------- useColorScheme ----------
+
+describe("useColorScheme", () => {
+  it("isDark and isLight are complementary", () => {
+    Object.defineProperty(window, "matchMedia", {
+      writable: true,
+      value: vi.fn(() => ({
+        matches: true,
+        addEventListener: vi.fn(),
+        removeEventListener: vi.fn(),
+      })),
+    });
+
+    const { isDark, isLight } = useColorScheme();
+    expect(isDark()).toBe(true);
+    expect(isLight()).toBe(false);
+  });
+});
+
+// ---------- useMouse ----------
+
+describe("useMouse", () => {
+  it("starts at (0, 0)", () => {
+    const { x, y } = useMouse();
+    expect(x()).toBe(0);
+    expect(y()).toBe(0);
+  });
+
+  it("updates on mousemove event", () => {
+    const { x, y } = useMouse();
+    window.dispatchEvent(
+      new MouseEvent("mousemove", { clientX: 100, clientY: 200 }),
+    );
+    expect(x()).toBe(100);
+    expect(y()).toBe(200);
+  });
+});
+
+// ---------- useKeyCombo ----------
+
+describe("useKeyCombo", () => {
+  it("starts as false", () => {
+    const pressed = useKeyCombo("ctrl+s");
+    expect(pressed()).toBe(false);
+  });
+
+  it("becomes true on matching keydown", () => {
+    const pressed = useKeyCombo("ctrl+s");
+    window.dispatchEvent(
+      new KeyboardEvent("keydown", { key: "s", ctrlKey: true }),
+    );
+    expect(pressed()).toBe(true);
+  });
+
+  it("resets to false on keyup", () => {
+    const pressed = useKeyCombo("ctrl+s");
+    window.dispatchEvent(
+      new KeyboardEvent("keydown", { key: "s", ctrlKey: true }),
+    );
+    window.dispatchEvent(new KeyboardEvent("keyup"));
+    expect(pressed()).toBe(false);
+  });
+});
+
+// ---------- useIdle ----------
+
+describe("useIdle", () => {
+  it("starts as not idle", () => {
+    vi.useFakeTimers();
+    const idle = useIdle(500);
+    expect(idle()).toBe(false);
+    vi.useRealTimers();
+  });
+
+  it("becomes idle after the timeout elapses", () => {
+    vi.useFakeTimers();
+    const idle = useIdle(500);
+    vi.advanceTimersByTime(500);
+    expect(idle()).toBe(true);
+    vi.useRealTimers();
+  });
+
+  it("resets idle on user activity", () => {
+    vi.useFakeTimers();
+    const idle = useIdle(500);
+    vi.advanceTimersByTime(300);
+    window.dispatchEvent(new MouseEvent("mousemove"));
+    vi.advanceTimersByTime(300); // not enough since activity reset the timer
+    expect(idle()).toBe(false);
+    vi.useRealTimers();
+  });
+});

package/src/__tests__/dom.test.ts

@@ -0,0 +1,103 @@
+// @vitest-environment jsdom
+import { describe, it, expect } from "vitest";
+
+import { createRef, useWindowSize, useScrollPosition, useFocus } from "../dom";
+
+// ---------- createRef ----------
+
+describe("createRef", () => {
+  it("starts with current = null", () => {
+    const ref = createRef();
+    expect(ref.current).toBeNull();
+  });
+
+  it("can be assigned an element", () => {
+    const ref = createRef();
+    const el = document.createElement("div");
+    ref.current = el;
+    expect(ref.current).toBe(el);
+  });
+});
+
+// ---------- useWindowSize ----------
+
+describe("useWindowSize", () => {
+  it("returns the current window dimensions", () => {
+    Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 1024 });
+    Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 768 });
+
+    const { width, height } = useWindowSize();
+    expect(width()).toBe(1024);
+    expect(height()).toBe(768);
+  });
+
+  it("updates on resize event", () => {
+    Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 800 });
+    Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 600 });
+
+    const { width, height } = useWindowSize();
+
+    Object.defineProperty(window, "innerWidth", { writable: true, configurable: true, value: 1280 });
+    Object.defineProperty(window, "innerHeight", { writable: true, configurable: true, value: 720 });
+    window.dispatchEvent(new Event("resize"));
+
+    expect(width()).toBe(1280);
+    expect(height()).toBe(720);
+  });
+});
+
+// ---------- useScrollPosition ----------
+
+describe("useScrollPosition", () => {
+  it("starts at (0, 0)", () => {
+    const { x, y } = useScrollPosition(window);
+    expect(x()).toBe(0);
+    expect(y()).toBe(0);
+  });
+
+  it("updates on element scroll", () => {
+    const el = document.createElement("div");
+    const { x, y } = useScrollPosition(el);
+
+    Object.defineProperty(el, "scrollLeft", { configurable: true, value: 50 });
+    Object.defineProperty(el, "scrollTop", { configurable: true, value: 80 });
+    el.dispatchEvent(new Event("scroll"));
+
+    expect(x()).toBe(50);
+    expect(y()).toBe(80);
+  });
+});
+
+// ---------- useFocus ----------
+
+describe("useFocus", () => {
+  it("starts as not focused", () => {
+    const el = document.createElement("input");
+    document.body.appendChild(el);
+    const ref = { current: el };
+    const focused = useFocus(ref);
+    expect(focused()).toBe(false);
+    document.body.removeChild(el);
+  });
+
+  it("becomes true on focus event", () => {
+    const el = document.createElement("input");
+    document.body.appendChild(el);
+    const ref = { current: el };
+    const focused = useFocus(ref);
+    el.dispatchEvent(new FocusEvent("focus"));
+    expect(focused()).toBe(true);
+    document.body.removeChild(el);
+  });
+
+  it("becomes false on blur event", () => {
+    const el = document.createElement("input");
+    document.body.appendChild(el);
+    const ref = { current: el };
+    const focused = useFocus(ref);
+    el.dispatchEvent(new FocusEvent("focus"));
+    el.dispatchEvent(new FocusEvent("blur"));
+    expect(focused()).toBe(false);
+    document.body.removeChild(el);
+  });
+});

package/src/__tests__/utilities.test.ts

@@ -0,0 +1,271 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+
+import { signal } from "@praxisjs/core/internal";
+
+import { usePagination, useClipboard, useGeolocation, useTimeAgo } from "../utilities";
+
+describe("usePagination", () => {
+  it("starts on page 1 by default", () => {
+    const p = usePagination({ total: 100, pageSize: 10 });
+    expect(p.page()).toBe(1);
+  });
+
+  it("respects initial page option", () => {
+    const p = usePagination({ total: 100, pageSize: 10, initial: 3 });
+    expect(p.page()).toBe(3);
+  });
+
+  it("computes total pages correctly", () => {
+    expect(usePagination({ total: 100, pageSize: 10 }).totalPages()).toBe(10);
+    expect(usePagination({ total: 101, pageSize: 10 }).totalPages()).toBe(11);
+    expect(usePagination({ total: 5, pageSize: 10 }).totalPages()).toBe(1);
+  });
+
+  it("computes offset", () => {
+    const p = usePagination({ total: 100, pageSize: 10 });
+    expect(p.offset()).toBe(0);
+    p.goTo(3);
+    expect(p.offset()).toBe(20);
+  });
+
+  it("next() advances the page", () => {
+    const p = usePagination({ total: 30, pageSize: 10 });
+    p.next();
+    expect(p.page()).toBe(2);
+  });
+
+  it("next() does nothing on last page", () => {
+    const p = usePagination({ total: 10, pageSize: 10 });
+    p.next();
+    expect(p.page()).toBe(1);
+  });
+
+  it("prev() goes back", () => {
+    const p = usePagination({ total: 30, pageSize: 10, initial: 3 });
+    p.prev();
+    expect(p.page()).toBe(2);
+  });
+
+  it("prev() does nothing on first page", () => {
+    const p = usePagination({ total: 30, pageSize: 10 });
+    p.prev();
+    expect(p.page()).toBe(1);
+  });
+
+  it("goTo() clamps to valid range", () => {
+    const p = usePagination({ total: 30, pageSize: 10 });
+    p.goTo(0);
+    expect(p.page()).toBe(1);
+    p.goTo(99);
+    expect(p.page()).toBe(3);
+  });
+
+  it("first() jumps to page 1", () => {
+    const p = usePagination({ total: 50, pageSize: 10, initial: 5 });
+    p.first();
+    expect(p.page()).toBe(1);
+  });
+
+  it("last() jumps to last page", () => {
+    const p = usePagination({ total: 50, pageSize: 10 });
+    p.last();
+    expect(p.page()).toBe(5);
+  });
+
+  it("hasNext is false on last page", () => {
+    const p = usePagination({ total: 10, pageSize: 10 });
+    expect(p.hasNext()).toBe(false);
+  });
+
+  it("hasPrev is false on first page", () => {
+    const p = usePagination({ total: 30, pageSize: 10 });
+    expect(p.hasPrev()).toBe(false);
+  });
+
+  it("pages() returns array of page numbers", () => {
+    const p = usePagination({ total: 30, pageSize: 10 });
+    expect(p.pages()).toEqual([1, 2, 3]);
+  });
+
+  it("pageSize() reflects the configured size", () => {
+    const p = usePagination({ total: 100, pageSize: 25 });
+    expect(p.pageSize()).toBe(25);
+  });
+
+  it("accepts a factory function for options", () => {
+    const p = usePagination(() => ({ total: 50, pageSize: 5 }));
+    expect(p.totalPages()).toBe(10);
+  });
+});
+
+// ── useClipboard ──────────────────────────────────────────────────────────────
+
+describe("useClipboard", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    Object.defineProperty(navigator, "clipboard", {
+      value: { writeText: vi.fn().mockResolvedValue(undefined) },
+      configurable: true,
+      writable: true,
+    });
+  });
+
+  afterEach(() => {
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("copied starts as false", () => {
+    const { copied } = useClipboard();
+    expect(copied()).toBe(false);
+  });
+
+  it("content starts as empty string", () => {
+    const { content } = useClipboard();
+    expect(content()).toBe("");
+  });
+
+  it("sets copied to true and content to the text after copy()", async () => {
+    const { copy, copied, content } = useClipboard();
+    await copy("hello");
+    expect(copied()).toBe(true);
+    expect(content()).toBe("hello");
+  });
+
+  it("resets copied to false after resetDelay", async () => {
+    const { copy, copied } = useClipboard(1000);
+    await copy("test");
+    expect(copied()).toBe(true);
+    vi.advanceTimersByTime(1000);
+    expect(copied()).toBe(false);
+  });
+
+  it("warns and does not update state on clipboard failure", async () => {
+    (navigator.clipboard as unknown as { writeText: ReturnType<typeof vi.fn> }).writeText =
+      vi.fn().mockRejectedValue(new Error("denied"));
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const { copy, copied } = useClipboard();
+    await copy("fail");
+    expect(copied()).toBe(false);
+    expect(warn).toHaveBeenCalled();
+    warn.mockRestore();
+  });
+});
+
+// ── useGeolocation ────────────────────────────────────────────────────────────
+
+describe("useGeolocation", () => {
+  it("starts with loading=true and lat/lng null", () => {
+    const successCb: PositionCallback[] = [];
+    Object.defineProperty(navigator, "geolocation", {
+      value: {
+        getCurrentPosition: (success: PositionCallback) => {
+          successCb.push(success);
+        },
+      },
+      configurable: true,
+    });
+
+    const geo = useGeolocation();
+    expect(geo.loading()).toBe(true);
+    expect(geo.lat()).toBeNull();
+    expect(geo.lng()).toBeNull();
+  });
+
+  it("updates lat/lng/loading on success", () => {
+    let successCb: PositionCallback | null = null;
+    Object.defineProperty(navigator, "geolocation", {
+      value: {
+        getCurrentPosition: (success: PositionCallback) => {
+          successCb = success;
+        },
+      },
+      configurable: true,
+    });
+
+    const geo = useGeolocation();
+
+    successCb!({
+      coords: { latitude: 10.5, longitude: 20.5 } as GeolocationCoordinates,
+    } as GeolocationPosition);
+
+    expect(geo.lat()).toBe(10.5);
+    expect(geo.lng()).toBe(20.5);
+    expect(geo.loading()).toBe(false);
+  });
+
+  it("sets error and loading=false on failure", () => {
+    let errorCb: PositionErrorCallback | null = null;
+    Object.defineProperty(navigator, "geolocation", {
+      value: {
+        getCurrentPosition: (_s: PositionCallback, error: PositionErrorCallback) => {
+          errorCb = error;
+        },
+      },
+      configurable: true,
+    });
+
+    const geo = useGeolocation();
+    const fakeError = { code: 1, message: "denied" } as GeolocationPositionError;
+    errorCb!(fakeError);
+
+    expect(geo.error()).toBe(fakeError);
+    expect(geo.loading()).toBe(false);
+  });
+});
+
+// ── useTimeAgo ────────────────────────────────────────────────────────────────
+
+describe("useTimeAgo", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.clearAllTimers();
+    vi.useRealTimers();
+  });
+
+  it("returns a computed string", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now);
+    expect(typeof t()).toBe("string");
+  });
+
+  it("formats seconds ago", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 30_000);
+    expect(t()).toMatch(/segundo|second/i);
+  });
+
+  it("formats minutes ago", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 5 * 60_000);
+    expect(t()).toMatch(/minuto|minute/i);
+  });
+
+  it("formats hours ago", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 2 * 3_600_000);
+    expect(t()).toMatch(/hora|hour/i);
+  });
+
+  it("formats days ago", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 3 * 86_400_000);
+    expect(t()).toMatch(/dia|day/i);
+  });
+
+  it("formats months ago", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 60 * 86_400_000);
+    expect(t()).toMatch(/mes|month/i);
+  });
+
+  it("accepts a signal source", () => {
+    const src = signal(Date.now() - 90_000);
+    const t = useTimeAgo(src);
+    expect(typeof t()).toBe("string");
+  });
+});