@praxisjs/composables 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @praxisjs/composables
+
+## 0.1.0
+
+### Minor Changes
+
+- aaf7dab: Initial beta release
+
+### Patch Changes
+
+- Updated dependencies [aaf7dab]
+  - @praxisjs/core@0.1.0
+  - @praxisjs/shared@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser.d.ts

@@ -0,0 +1,13 @@
+import type { Computed } from "@praxisjs/shared";
+export declare function useMediaQuery(query: string): Computed<boolean>;
+export declare function useColorScheme(): {
+    isDark: Computed<boolean>;
+    isLight: Computed<boolean>;
+};
+export declare function useMouse(): {
+    x: Computed<number>;
+    y: Computed<number>;
+};
+export declare function useKeyCombo(combo: string): Computed<boolean>;
+export declare function useIdle(timeout?: number): Computed<boolean>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAO9D;AAED,wBAAgB,cAAc;;;EAI7B;AAED,wBAAgB,QAAQ;;;EAQvB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAe5D;AAED,wBAAgB,OAAO,CAAC,OAAO,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,CAa3D"}

package/dist/browser.js

@@ -0,0 +1,48 @@
+import { signal, computed } from "@praxisjs/core";
+export function useMediaQuery(query) {
+    const mql = window.matchMedia(query);
+    const matches = signal(mql.matches);
+    mql.addEventListener("change", (e) => { matches.set(e.matches); });
+    return computed(() => matches());
+}
+export function useColorScheme() {
+    const isDark = useMediaQuery("(prefers-color-scheme: dark)");
+    const isLight = computed(() => !isDark());
+    return { isDark, isLight };
+}
+export function useMouse() {
+    const x = signal(0);
+    const y = signal(0);
+    window.addEventListener("mousemove", (e) => {
+        x.set(e.clientX);
+        y.set(e.clientY);
+    });
+    return { x: computed(() => x()), y: computed(() => y()) };
+}
+export function useKeyCombo(combo) {
+    const parts = combo.toLowerCase().split("+");
+    const pressed = signal(false);
+    window.addEventListener("keydown", (e) => {
+        const ctrl = parts.includes("ctrl") ? e.ctrlKey : true;
+        const shift = parts.includes("shift") ? e.shiftKey : true;
+        const alt = parts.includes("alt") ? e.altKey : true;
+        const key = parts.find((p) => !["ctrl", "shift", "alt", "meta"].includes(p));
+        if (ctrl && shift && alt && (!key || e.key.toLowerCase() === key))
+            pressed.set(true);
+    });
+    window.addEventListener("keyup", () => { pressed.set(false); });
+    return computed(() => pressed());
+}
+export function useIdle(timeout = 60_000) {
+    const idle = signal(false);
+    let timer;
+    const reset = () => {
+        idle.set(false);
+        clearTimeout(timer);
+        timer = setTimeout(() => { idle.set(true); }, timeout);
+    };
+    ["mousemove", "keydown", "click", "scroll", "touchstart"].forEach((e) => { window.addEventListener(e, reset, { passive: true }); });
+    reset();
+    return computed(() => idle());
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/dom.d.ts

@@ -0,0 +1,26 @@
+import type { Computed } from "@praxisjs/shared";
+export declare function createRef(): {
+    current: HTMLElement | null;
+};
+export declare function useElementSize(ref: {
+    current: HTMLElement | null;
+}): {
+    width: Computed<number>;
+    height: Computed<number>;
+    stop: () => void;
+};
+export declare function useWindowSize(): {
+    width: Computed<number>;
+    height: Computed<number>;
+};
+export declare function useScrollPosition(target?: HTMLElement | Window): {
+    x: Computed<number>;
+    y: Computed<number>;
+};
+export declare function useIntersection(ref: {
+    current: HTMLElement | null;
+}, options?: IntersectionObserverInit): Computed<boolean>;
+export declare function useFocus(ref: {
+    current: HTMLElement | null;
+}): Computed<boolean>;
+//# sourceMappingURL=dom.d.ts.map

package/dist/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,SAAS,IAAI;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAE3D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE;;;;EAmBlE;AAED,wBAAgB,aAAa;;;EAQ5B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,WAAW,GAAG,MAAe;;;EAYtE;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,EACpC,OAAO,CAAC,EAAE,wBAAwB,GACjC,QAAQ,CAAC,OAAO,CAAC,CAWnB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE;IAC5B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B,GAAG,QAAQ,CAAC,OAAO,CAAC,CAepB"}

package/dist/dom.js

@@ -0,0 +1,70 @@
+import { signal, computed, effect } from "@praxisjs/core";
+export function createRef() {
+    return { current: null };
+}
+export function useElementSize(ref) {
+    const width = signal(0);
+    const height = signal(0);
+    const observer = new ResizeObserver(([entry]) => {
+        width.set(entry.contentRect.width);
+        height.set(entry.contentRect.height);
+    });
+    effect(() => {
+        if (ref.current) {
+            observer.observe(ref.current);
+            width.set(ref.current.offsetWidth);
+            height.set(ref.current.offsetHeight);
+        }
+    });
+    return {
+        width: computed(() => width()),
+        height: computed(() => height()),
+        stop: () => { observer.disconnect(); },
+    };
+}
+export function useWindowSize() {
+    const width = signal(window.innerWidth);
+    const height = signal(window.innerHeight);
+    window.addEventListener("resize", () => {
+        width.set(window.innerWidth);
+        height.set(window.innerHeight);
+    });
+    return { width: computed(() => width()), height: computed(() => height()) };
+}
+export function useScrollPosition(target = window) {
+    const x = signal(0);
+    const y = signal(0);
+    target.addEventListener("scroll", () => {
+        x.set(target === window ? window.scrollX : target.scrollLeft);
+        y.set(target === window ? window.scrollY : target.scrollTop);
+    });
+    return { x: computed(() => x()), y: computed(() => y()) };
+}
+export function useIntersection(ref, options) {
+    const visible = signal(false);
+    const observer = new IntersectionObserver(([entry]) => { visible.set(entry.isIntersecting); }, options);
+    effect(() => {
+        if (ref.current)
+            observer.observe(ref.current);
+        return () => { observer.disconnect(); };
+    });
+    return computed(() => visible());
+}
+export function useFocus(ref) {
+    const focused = signal(false);
+    effect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        const onFocus = () => { focused.set(true); };
+        const onBlur = () => { focused.set(false); };
+        el.addEventListener("focus", onFocus);
+        el.addEventListener("blur", onBlur);
+        return () => {
+            el.removeEventListener("focus", onFocus);
+            el.removeEventListener("blur", onBlur);
+        };
+    });
+    return computed(() => focused());
+}
+//# sourceMappingURL=dom.js.map

package/dist/dom.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createRef, useElementSize, useWindowSize, useScrollPosition, useIntersection, useFocus, } from "./dom";
+export { useMediaQuery, useColorScheme, useMouse, useKeyCombo, useIdle, } from "./browser";
+export { useClipboard, useGeolocation, useTimeAgo, usePagination, } from "./utilities";
+export type { PaginationOptions } from "./utilities";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,QAAQ,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EACL,aAAa,EACb,cAAc,EACd,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createRef, useElementSize, useWindowSize, useScrollPosition, useIntersection, useFocus, } from "./dom";
+export { useMediaQuery, useColorScheme, useMouse, useKeyCombo, useIdle, } from "./browser";
+export { useClipboard, useGeolocation, useTimeAgo, usePagination, } from "./utilities";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,QAAQ,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EACL,aAAa,EACb,cAAc,EACd,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/utilities.d.ts

@@ -0,0 +1,33 @@
+import type { Signal, Computed } from "@praxisjs/shared";
+export declare function useClipboard(resetDelay?: number): {
+    copy: (text: string) => Promise<void>;
+    copied: Computed<boolean>;
+    content: Computed<string>;
+};
+export declare function useGeolocation(options?: PositionOptions): {
+    lat: Computed<number | null>;
+    lng: Computed<number | null>;
+    error: Computed<GeolocationPositionError | null>;
+    loading: Computed<boolean>;
+};
+export declare function useTimeAgo(source: Signal<Date | number> | Computed<Date | number> | (() => Date | number), locale?: string): Computed<string>;
+export interface PaginationOptions {
+    total: number;
+    pageSize: number;
+    initial?: number;
+}
+export declare function usePagination(options: PaginationOptions | (() => PaginationOptions)): {
+    page: Computed<number>;
+    totalPages: Computed<number>;
+    offset: Computed<number>;
+    hasNext: Computed<boolean>;
+    hasPrev: Computed<boolean>;
+    pageSize: Computed<number>;
+    pages: Computed<number[]>;
+    next(): void;
+    prev(): void;
+    goTo(p: number): void;
+    first(): void;
+    last(): void;
+};
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,YAAY,CAAC,UAAU,SAAO;iBAGlB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;;EAejD;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe;;;;;EAuBvD;AAED,wBAAgB,UAAU,CACxB,MAAM,EACF,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,GACrB,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,GACvB,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,EACzB,MAAM,SAAU,GACf,QAAQ,CAAC,MAAM,CAAC,CAkBlB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,GAAG,CAAC,MAAM,iBAAiB,CAAC;;;;;;;;;;YA2B5C,MAAM;;;EAUjB"}

package/dist/utilities.js

@@ -0,0 +1,97 @@
+import { signal, computed } from "@praxisjs/core";
+export function useClipboard(resetDelay = 2000) {
+    const copied = signal(false);
+    const content = signal("");
+    async function copy(text) {
+        try {
+            await navigator.clipboard.writeText(text);
+            content.set(text);
+            copied.set(true);
+            setTimeout(() => { copied.set(false); }, resetDelay);
+        }
+        catch {
+            console.warn("[useClipboard] Falha ao copiar");
+        }
+    }
+    return {
+        copy,
+        copied: computed(() => copied()),
+        content: computed(() => content()),
+    };
+}
+export function useGeolocation(options) {
+    const lat = signal(null);
+    const lng = signal(null);
+    const error = signal(null);
+    const loading = signal(true);
+    navigator.geolocation.getCurrentPosition((pos) => {
+        lat.set(pos.coords.latitude);
+        lng.set(pos.coords.longitude);
+        loading.set(false);
+    }, (err) => {
+        error.set(err);
+        loading.set(false);
+    }, options);
+    return {
+        lat: computed(() => lat()),
+        lng: computed(() => lng()),
+        error: computed(() => error()),
+        loading: computed(() => loading()),
+    };
+}
+export function useTimeAgo(source, locale = "pt-BR") {
+    const read = typeof source === "function" ? source : source;
+    const tick = signal(Date.now());
+    setInterval(() => { tick.set(Date.now()); }, 60_000);
+    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+    return computed(() => {
+        void tick();
+        const diff = new Date(read()).getTime() - Date.now();
+        const abs = Math.abs(diff);
+        if (abs < 60_000)
+            return rtf.format(Math.round(diff / 1000), "second");
+        if (abs < 3_600_000)
+            return rtf.format(Math.round(diff / 60_000), "minute");
+        if (abs < 86_400_000)
+            return rtf.format(Math.round(diff / 3_600_000), "hour");
+        if (abs < 2_592_000_000)
+            return rtf.format(Math.round(diff / 86_400_000), "day");
+        return rtf.format(Math.round(diff / 2_592_000_000), "month");
+    });
+}
+export function usePagination(options) {
+    const getOpts = typeof options === "function" ? options : () => options;
+    const _page = signal(getOpts().initial ?? 1);
+    const totalPages = computed(() => Math.ceil(getOpts().total / getOpts().pageSize));
+    const page = computed(() => Math.min(_page(), totalPages()));
+    const offset = computed(() => (page() - 1) * getOpts().pageSize);
+    const hasNext = computed(() => page() < totalPages());
+    const hasPrev = computed(() => page() > 1);
+    return {
+        page,
+        totalPages,
+        offset,
+        hasNext,
+        hasPrev,
+        pageSize: computed(() => getOpts().pageSize),
+        pages: computed(() => Array.from({ length: totalPages() }, (_, i) => i + 1)),
+        next() {
+            if (hasNext())
+                _page.update((p) => p + 1);
+        },
+        prev() {
+            if (hasPrev())
+                _page.update((p) => p - 1);
+        },
+        goTo(p) {
+            _page.set(Math.max(1, Math.min(p, totalPages())));
+        },
+        first() {
+            _page.set(1);
+        },
+        last() {
+            _page.set(totalPages());
+        },
+    };
+}
+//# sourceMappingURL=utilities.js.map

package/dist/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,UAAU,YAAY,CAAC,UAAU,GAAG,IAAI;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,KAAK,UAAU,IAAI,CAAC,IAAY;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,GAAG,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAkC,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,CAAC,WAAW,CAAC,kBAAkB,CACtC,CAAC,GAAG,EAAE,EAAE;QACN,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;QACN,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,EACD,OAAO,CACR,CAAC;IACF,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAC1B,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAC1B,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAGyB,EACzB,MAAM,GAAG,OAAO;IAEhB,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAErE,OAAO,QAAQ,CAAC,GAAG,EAAE;QACnB,KAAK,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,GAAG,GAAG,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACvE,IAAI,GAAG,GAAG,SAAS;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5E,IAAI,GAAG,GAAG,UAAU;YAClB,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,GAAG,GAAG,aAAa;YACrB,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,UAAU,aAAa,CAC3B,OAAsD;IAEtD,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC,QAAQ,CAAC,CAChD,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI;QACJ,UAAU;QACV,MAAM;QACN,OAAO;QACP,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC;QAC5C,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,CACnB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CACtD;QACD,IAAI;YACF,IAAI,OAAO,EAAE;gBAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI;YACF,IAAI,OAAO,EAAE;gBAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,CAAS;YACZ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,KAAK;YACH,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QACD,IAAI;YACF,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@praxisjs/composables",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@praxisjs/core": "0.1.0",
+    "@praxisjs/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/browser.ts

@@ -0,0 +1,59 @@
+import { signal, computed } from "@praxisjs/core";
+import type { Computed } from "@praxisjs/shared";
+
+export function useMediaQuery(query: string): Computed<boolean> {
+  const mql = window.matchMedia(query);
+  const matches = signal(mql.matches);
+  mql.addEventListener("change", (e: MediaQueryListEvent) =>
+    { matches.set(e.matches); },
+  );
+  return computed(() => matches());
+}
+
+export function useColorScheme() {
+  const isDark = useMediaQuery("(prefers-color-scheme: dark)");
+  const isLight = computed(() => !isDark());
+  return { isDark, isLight };
+}
+
+export function useMouse() {
+  const x = signal(0);
+  const y = signal(0);
+  window.addEventListener("mousemove", (e) => {
+    x.set(e.clientX);
+    y.set(e.clientY);
+  });
+  return { x: computed(() => x()), y: computed(() => y()) };
+}
+
+export function useKeyCombo(combo: string): Computed<boolean> {
+  const parts = combo.toLowerCase().split("+");
+  const pressed = signal(false);
+  window.addEventListener("keydown", (e: KeyboardEvent) => {
+    const ctrl = parts.includes("ctrl") ? e.ctrlKey : true;
+    const shift = parts.includes("shift") ? e.shiftKey : true;
+    const alt = parts.includes("alt") ? e.altKey : true;
+    const key = parts.find(
+      (p) => !["ctrl", "shift", "alt", "meta"].includes(p),
+    );
+    if (ctrl && shift && alt && (!key || e.key.toLowerCase() === key))
+      pressed.set(true);
+  });
+  window.addEventListener("keyup", () => { pressed.set(false); });
+  return computed(() => pressed());
+}
+
+export function useIdle(timeout = 60_000): Computed<boolean> {
+  const idle = signal(false);
+  let timer: ReturnType<typeof setTimeout>;
+  const reset = () => {
+    idle.set(false);
+    clearTimeout(timer);
+    timer = setTimeout(() => { idle.set(true); }, timeout);
+  };
+  ["mousemove", "keydown", "click", "scroll", "touchstart"].forEach((e) =>
+    { window.addEventListener(e, reset, { passive: true }); },
+  );
+  reset();
+  return computed(() => idle());
+}

package/src/dom.ts

@@ -0,0 +1,86 @@
+import { signal, computed, effect } from "@praxisjs/core";
+import type { Computed } from "@praxisjs/shared";
+
+export function createRef(): { current: HTMLElement | null } {
+  return { current: null };
+}
+
+export function useElementSize(ref: { current: HTMLElement | null }) {
+  const width = signal(0);
+  const height = signal(0);
+  const observer = new ResizeObserver(([entry]) => {
+    width.set(entry.contentRect.width);
+    height.set(entry.contentRect.height);
+  });
+  effect(() => {
+    if (ref.current) {
+      observer.observe(ref.current);
+      width.set(ref.current.offsetWidth);
+      height.set(ref.current.offsetHeight);
+    }
+  });
+  return {
+    width: computed(() => width()),
+    height: computed(() => height()),
+    stop: () => { observer.disconnect(); },
+  };
+}
+
+export function useWindowSize() {
+  const width = signal(window.innerWidth);
+  const height = signal(window.innerHeight);
+  window.addEventListener("resize", () => {
+    width.set(window.innerWidth);
+    height.set(window.innerHeight);
+  });
+  return { width: computed(() => width()), height: computed(() => height()) };
+}
+
+export function useScrollPosition(target: HTMLElement | Window = window) {
+  const x = signal(0);
+  const y = signal(0);
+  target.addEventListener("scroll", () => {
+    x.set(
+      target === window ? window.scrollX : (target as HTMLElement).scrollLeft,
+    );
+    y.set(
+      target === window ? window.scrollY : (target as HTMLElement).scrollTop,
+    );
+  });
+  return { x: computed(() => x()), y: computed(() => y()) };
+}
+
+export function useIntersection(
+  ref: { current: HTMLElement | null },
+  options?: IntersectionObserverInit,
+): Computed<boolean> {
+  const visible = signal(false);
+  const observer = new IntersectionObserver(
+    ([entry]) => { visible.set(entry.isIntersecting); },
+    options,
+  );
+  effect(() => {
+    if (ref.current) observer.observe(ref.current);
+    return () => { observer.disconnect(); };
+  });
+  return computed(() => visible());
+}
+
+export function useFocus(ref: {
+  current: HTMLElement | null;
+}): Computed<boolean> {
+  const focused = signal(false);
+  effect(() => {
+    const el = ref.current;
+    if (!el) return;
+    const onFocus = () => { focused.set(true); };
+    const onBlur = () => { focused.set(false); };
+    el.addEventListener("focus", onFocus);
+    el.addEventListener("blur", onBlur);
+    return () => {
+      el.removeEventListener("focus", onFocus);
+      el.removeEventListener("blur", onBlur);
+    };
+  });
+  return computed(() => focused());
+}

package/src/index.ts

@@ -0,0 +1,22 @@
+export {
+  createRef,
+  useElementSize,
+  useWindowSize,
+  useScrollPosition,
+  useIntersection,
+  useFocus,
+} from "./dom";
+export {
+  useMediaQuery,
+  useColorScheme,
+  useMouse,
+  useKeyCombo,
+  useIdle,
+} from "./browser";
+export {
+  useClipboard,
+  useGeolocation,
+  useTimeAgo,
+  usePagination,
+} from "./utilities";
+export type { PaginationOptions } from "./utilities";

package/src/utilities.ts

@@ -0,0 +1,119 @@
+import { signal, computed } from "@praxisjs/core";
+import type { Signal, Computed } from "@praxisjs/shared";
+
+export function useClipboard(resetDelay = 2000) {
+  const copied = signal(false);
+  const content = signal("");
+  async function copy(text: string): Promise<void> {
+    try {
+      await navigator.clipboard.writeText(text);
+      content.set(text);
+      copied.set(true);
+      setTimeout(() => { copied.set(false); }, resetDelay);
+    } catch {
+      console.warn("[useClipboard] Falha ao copiar");
+    }
+  }
+  return {
+    copy,
+    copied: computed(() => copied()),
+    content: computed(() => content()),
+  };
+}
+
+export function useGeolocation(options?: PositionOptions) {
+  const lat = signal<number | null>(null);
+  const lng = signal<number | null>(null);
+  const error = signal<GeolocationPositionError | null>(null);
+  const loading = signal(true);
+  navigator.geolocation.getCurrentPosition(
+    (pos) => {
+      lat.set(pos.coords.latitude);
+      lng.set(pos.coords.longitude);
+      loading.set(false);
+    },
+    (err) => {
+      error.set(err);
+      loading.set(false);
+    },
+    options,
+  );
+  return {
+    lat: computed(() => lat()),
+    lng: computed(() => lng()),
+    error: computed(() => error()),
+    loading: computed(() => loading()),
+  };
+}
+
+export function useTimeAgo(
+  source:
+    | Signal<Date | number>
+    | Computed<Date | number>
+    | (() => Date | number),
+  locale = "pt-BR",
+): Computed<string> {
+  const read = typeof source === "function" ? source : source;
+  const tick = signal(Date.now());
+  setInterval(() => { tick.set(Date.now()); }, 60_000);
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+
+  return computed(() => {
+    void tick();
+    const diff = new Date(read() as Date).getTime() - Date.now();
+    const abs = Math.abs(diff);
+    if (abs < 60_000) return rtf.format(Math.round(diff / 1000), "second");
+    if (abs < 3_600_000) return rtf.format(Math.round(diff / 60_000), "minute");
+    if (abs < 86_400_000)
+      return rtf.format(Math.round(diff / 3_600_000), "hour");
+    if (abs < 2_592_000_000)
+      return rtf.format(Math.round(diff / 86_400_000), "day");
+    return rtf.format(Math.round(diff / 2_592_000_000), "month");
+  });
+}
+
+export interface PaginationOptions {
+  total: number;
+  pageSize: number;
+  initial?: number;
+}
+
+export function usePagination(
+  options: PaginationOptions | (() => PaginationOptions),
+) {
+  const getOpts = typeof options === "function" ? options : () => options;
+  const _page = signal(getOpts().initial ?? 1);
+  const totalPages = computed(() =>
+    Math.ceil(getOpts().total / getOpts().pageSize),
+  );
+  const page = computed(() => Math.min(_page(), totalPages()));
+  const offset = computed(() => (page() - 1) * getOpts().pageSize);
+  const hasNext = computed(() => page() < totalPages());
+  const hasPrev = computed(() => page() > 1);
+  return {
+    page,
+    totalPages,
+    offset,
+    hasNext,
+    hasPrev,
+    pageSize: computed(() => getOpts().pageSize),
+    pages: computed(() =>
+      Array.from({ length: totalPages() }, (_, i) => i + 1),
+    ),
+    next() {
+      if (hasNext()) _page.update((p) => p + 1);
+    },
+    prev() {
+      if (hasPrev()) _page.update((p) => p - 1);
+    },
+    goTo(p: number) {
+      _page.set(Math.max(1, Math.min(p, totalPages())));
+    },
+    first() {
+      _page.set(1);
+    },
+    last() {
+      _page.set(totalPages());
+    },
+  };
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}