@praxisjs/composables 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @praxisjs/composables
 
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [d11a10a]
+  - @praxisjs/core@0.4.2
+
+## 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,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) => ({
+                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();
+    });
+});
+// ---------- useMediaQuery — change event ----------
+describe("useMediaQuery change event", () => {
+    it("updates when the media query match state changes", () => {
+        let changeHandler = null;
+        Object.defineProperty(window, "matchMedia", {
+            writable: true,
+            value: vi.fn(() => ({
+                matches: false,
+                addEventListener: vi.fn((_event, handler) => {
+                    changeHandler = handler;
+                }),
+                removeEventListener: vi.fn(),
+            })),
+        });
+        const matches = useMediaQuery("(min-width: 768px)");
+        expect(matches()).toBe(false);
+        // Simulate the media query becoming true
+        changeHandler({ matches: true });
+        expect(matches()).toBe(true);
+        // Simulate it reverting
+        changeHandler({ matches: false });
+        expect(matches()).toBe(false);
+    });
+});
+//# 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,167 @@
+// @vitest-environment jsdom
+import { beforeEach, afterEach, describe, it, expect, vi } from "vitest";
+import { createRef, useWindowSize, useScrollPosition, useFocus, useElementSize, useIntersection } 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);
+    });
+    it("does nothing when ref.current is null", () => {
+        const ref = { current: null };
+        expect(() => useFocus(ref)).not.toThrow();
+    });
+});
+// ---------- useElementSize ----------
+describe("useElementSize", () => {
+    let observerCallback = () => { };
+    let mockDisconnect;
+    beforeEach(() => {
+        mockDisconnect = vi.fn();
+        observerCallback = () => { };
+        // Class-based mock so `new ResizeObserver(cb)` works correctly
+        globalThis.ResizeObserver = class {
+            constructor(cb) { observerCallback = cb; }
+            observe = vi.fn();
+            disconnect = mockDisconnect;
+        };
+    });
+    afterEach(() => {
+        // @ts-expect-error – removing test stub
+        delete globalThis.ResizeObserver;
+    });
+    it("starts at (0, 0) when ref.current is null", () => {
+        const ref = { current: null };
+        const { width, height } = useElementSize(ref);
+        expect(width()).toBe(0);
+        expect(height()).toBe(0);
+    });
+    it("calls stop() to disconnect the ResizeObserver", () => {
+        const el = document.createElement("div");
+        const ref = { current: el };
+        const { stop } = useElementSize(ref);
+        stop();
+        expect(mockDisconnect).toHaveBeenCalled();
+    });
+    it("updates width and height when ResizeObserver fires", () => {
+        const el = document.createElement("div");
+        const ref = { current: el };
+        const { width, height } = useElementSize(ref);
+        observerCallback([{ contentRect: { width: 300, height: 200 } }], null);
+        expect(width()).toBe(300);
+        expect(height()).toBe(200);
+    });
+});
+// ---------- useIntersection ----------
+describe("useIntersection", () => {
+    let intersectionCallback = () => { };
+    let capturedOptions;
+    beforeEach(() => {
+        intersectionCallback = () => { };
+        capturedOptions = undefined;
+        globalThis.IntersectionObserver = class {
+            constructor(cb, opts) {
+                intersectionCallback = cb;
+                capturedOptions = opts;
+            }
+            observe = vi.fn();
+            disconnect = vi.fn();
+        };
+    });
+    afterEach(() => {
+        // @ts-expect-error – removing test stub
+        delete globalThis.IntersectionObserver;
+    });
+    it("starts as false when ref.current is null", () => {
+        const ref = { current: null };
+        const visible = useIntersection(ref);
+        expect(visible()).toBe(false);
+    });
+    it("becomes true when IntersectionObserver fires with isIntersecting=true", () => {
+        const el = document.createElement("div");
+        const ref = { current: el };
+        const visible = useIntersection(ref);
+        intersectionCallback([{ isIntersecting: true }], null);
+        expect(visible()).toBe(true);
+    });
+    it("passes options to IntersectionObserver", () => {
+        const ref = { current: null };
+        const options = { threshold: 0.5 };
+        useIntersection(ref, options);
+        expect(capturedOptions).toEqual(options);
+    });
+});
+//# 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":"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"}

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,236 @@
+// @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");
+    });
+    it("ticks after 60 seconds via setInterval", () => {
+        const now = Date.now();
+        const t = useTimeAgo(() => now - 30_000);
+        const before = t();
+        vi.advanceTimersByTime(60_000);
+        // After ticking, the computed re-evaluates (may or may not change the string)
+        expect(typeof t()).toBe("string");
+        // The interval ran — just verify no errors
+        expect(before).toBeTruthy();
+    });
+});
+//# 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.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,8 +14,8 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "0.4.0",
-    "@praxisjs/shared": "0.2.0"
+    "@praxisjs/shared": "0.2.0",
+    "@praxisjs/core": "0.4.2"
   },
   "scripts": {
     "build": "tsc",

package/src/__tests__/browser.test.ts

@@ -0,0 +1,147 @@
+// @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();
+  });
+});
+
+// ---------- useMediaQuery — change event ----------
+
+describe("useMediaQuery change event", () => {
+  it("updates when the media query match state changes", () => {
+    let changeHandler: ((e: MediaQueryListEvent) => void) | null = null;
+    Object.defineProperty(window, "matchMedia", {
+      writable: true,
+      value: vi.fn(() => ({
+        matches: false,
+        addEventListener: vi.fn((_event: string, handler: (e: MediaQueryListEvent) => void) => {
+          changeHandler = handler;
+        }),
+        removeEventListener: vi.fn(),
+      })),
+    });
+
+    const matches = useMediaQuery("(min-width: 768px)");
+    expect(matches()).toBe(false);
+
+    // Simulate the media query becoming true
+    changeHandler!({ matches: true } as MediaQueryListEvent);
+    expect(matches()).toBe(true);
+
+    // Simulate it reverting
+    changeHandler!({ matches: false } as MediaQueryListEvent);
+    expect(matches()).toBe(false);
+  });
+});

package/src/__tests__/dom.test.ts

@@ -0,0 +1,212 @@
+// @vitest-environment jsdom
+import { beforeEach, afterEach, describe, it, expect, vi } from "vitest";
+
+import { createRef, useWindowSize, useScrollPosition, useFocus, useElementSize, useIntersection } 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);
+  });
+
+  it("does nothing when ref.current is null", () => {
+    const ref: { current: HTMLElement | null } = { current: null };
+    expect(() => useFocus(ref)).not.toThrow();
+  });
+});
+
+// ---------- useElementSize ----------
+
+describe("useElementSize", () => {
+  let observerCallback: ResizeObserverCallback = () => {};
+  let mockDisconnect: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    mockDisconnect = vi.fn();
+    observerCallback = () => {};
+
+    // Class-based mock so `new ResizeObserver(cb)` works correctly
+    globalThis.ResizeObserver = class {
+      constructor(cb: ResizeObserverCallback) { observerCallback = cb; }
+      observe = vi.fn();
+      disconnect = mockDisconnect;
+    } as unknown as typeof ResizeObserver;
+  });
+
+  afterEach(() => {
+    // @ts-expect-error – removing test stub
+    delete globalThis.ResizeObserver;
+  });
+
+  it("starts at (0, 0) when ref.current is null", () => {
+    const ref: { current: HTMLElement | null } = { current: null };
+    const { width, height } = useElementSize(ref);
+    expect(width()).toBe(0);
+    expect(height()).toBe(0);
+  });
+
+  it("calls stop() to disconnect the ResizeObserver", () => {
+    const el = document.createElement("div");
+    const ref = { current: el };
+    const { stop } = useElementSize(ref);
+    stop();
+    expect(mockDisconnect).toHaveBeenCalled();
+  });
+
+  it("updates width and height when ResizeObserver fires", () => {
+    const el = document.createElement("div");
+    const ref = { current: el };
+    const { width, height } = useElementSize(ref);
+
+    observerCallback(
+      [{ contentRect: { width: 300, height: 200 } } as ResizeObserverEntry],
+      null as unknown as ResizeObserver,
+    );
+
+    expect(width()).toBe(300);
+    expect(height()).toBe(200);
+  });
+});
+
+// ---------- useIntersection ----------
+
+describe("useIntersection", () => {
+  let intersectionCallback: IntersectionObserverCallback = () => {};
+  let capturedOptions: IntersectionObserverInit | undefined;
+
+  beforeEach(() => {
+    intersectionCallback = () => {};
+    capturedOptions = undefined;
+
+    globalThis.IntersectionObserver = class {
+      constructor(cb: IntersectionObserverCallback, opts?: IntersectionObserverInit) {
+        intersectionCallback = cb;
+        capturedOptions = opts;
+      }
+      observe = vi.fn();
+      disconnect = vi.fn();
+    } as unknown as typeof IntersectionObserver;
+  });
+
+  afterEach(() => {
+    // @ts-expect-error – removing test stub
+    delete globalThis.IntersectionObserver;
+  });
+
+  it("starts as false when ref.current is null", () => {
+    const ref: { current: HTMLElement | null } = { current: null };
+    const visible = useIntersection(ref);
+    expect(visible()).toBe(false);
+  });
+
+  it("becomes true when IntersectionObserver fires with isIntersecting=true", () => {
+    const el = document.createElement("div");
+    const ref = { current: el };
+    const visible = useIntersection(ref);
+
+    intersectionCallback(
+      [{ isIntersecting: true } as IntersectionObserverEntry],
+      null as unknown as IntersectionObserver,
+    );
+    expect(visible()).toBe(true);
+  });
+
+  it("passes options to IntersectionObserver", () => {
+    const ref: { current: HTMLElement | null } = { current: null };
+    const options = { threshold: 0.5 };
+    useIntersection(ref, options);
+    expect(capturedOptions).toEqual(options);
+  });
+});

package/src/__tests__/utilities.test.ts

@@ -0,0 +1,282 @@
+// @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");
+  });
+
+  it("ticks after 60 seconds via setInterval", () => {
+    const now = Date.now();
+    const t = useTimeAgo(() => now - 30_000);
+    const before = t();
+    vi.advanceTimersByTime(60_000);
+    // After ticking, the computed re-evaluates (may or may not change the string)
+    expect(typeof t()).toBe("string");
+    // The interval ran — just verify no errors
+    expect(before).toBeTruthy();
+  });
+});