@molecule/app-react 1.0.0

package/dist/hooks/usePromise.d.ts

@@ -0,0 +1,39 @@
+/**
+ * React hook for tracking async function state.
+ *
+ * @module
+ */
+import type { PromiseStatus } from '@molecule/app-utilities';
+/**
+ * Extended promise state with actions.
+ */
+export interface UsePromiseState<T> {
+    status: PromiseStatus;
+    value: T | null;
+    error: Error | null;
+    cancel: (message?: string) => void;
+    reset: () => void;
+}
+/**
+ * Hook that wraps an async function with state tracking.
+ *
+ * @param asyncFn - The async function to wrap
+ * @returns Tuple of [state, wrappedFunction]
+ *
+ * @example
+ * ```tsx
+ * const [state, fetchUser] = usePromise((id: string) => api.getUser(id))
+ *
+ * return (
+ *   <div>
+ *     <button onClick={() => fetchUser('123')} disabled={state.status === 'pending'}>
+ *       {state.status === 'pending' ? 'Loading...' : 'Fetch User'}
+ *     </button>
+ *     {state.value && <div>{state.value.name}</div>}
+ *     {state.error && <div>Error: {state.error.message}</div>}
+ *   </div>
+ * )
+ * ```
+ */
+export declare const usePromise: <T extends (...args: any[]) => Promise<any>>(asyncFn: T) => [UsePromiseState<Awaited<ReturnType<T>>>, (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>];
+//# sourceMappingURL=usePromise.d.ts.map

package/dist/hooks/usePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromise.d.ts","sourceRoot":"","sources":["../../src/hooks/usePromise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACnE,SAAS,CAAC,KACT,CACD,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EACvC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CA+F5D,CAAA"}

package/dist/hooks/usePromise.js

@@ -0,0 +1,92 @@
+/**
+ * React hook for tracking async function state.
+ *
+ * @module
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { useEffect, useMemo, useRef, useState } from 'react';
+/**
+ * Hook that wraps an async function with state tracking.
+ *
+ * @param asyncFn - The async function to wrap
+ * @returns Tuple of [state, wrappedFunction]
+ *
+ * @example
+ * ```tsx
+ * const [state, fetchUser] = usePromise((id: string) => api.getUser(id))
+ *
+ * return (
+ *   <div>
+ *     <button onClick={() => fetchUser('123')} disabled={state.status === 'pending'}>
+ *       {state.status === 'pending' ? 'Loading...' : 'Fetch User'}
+ *     </button>
+ *     {state.value && <div>{state.value.name}</div>}
+ *     {state.error && <div>Error: {state.error.message}</div>}
+ *   </div>
+ * )
+ * ```
+ */
+export const usePromise = (asyncFn) => {
+    const [status, setStatus] = useState('idle');
+    const [value, setValue] = useState(null);
+    const [error, setError] = useState(null);
+    const isUnmounted = useRef(false);
+    const callIdRef = useRef(0);
+    const cancelledRef = useRef(false);
+    useEffect(() => {
+        isUnmounted.current = false;
+        return () => {
+            isUnmounted.current = true;
+        };
+    }, []);
+    const cancel = useMemo(() => (message) => {
+        cancelledRef.current = true;
+        callIdRef.current += 1;
+        if (!isUnmounted.current) {
+            setStatus('rejected');
+            setError(message ? new Error(message) : null);
+        }
+    }, []);
+    const reset = useMemo(() => () => {
+        cancelledRef.current = false;
+        if (!isUnmounted.current) {
+            setStatus('idle');
+            setValue(null);
+            setError(null);
+        }
+    }, []);
+    const callAsyncFn = useMemo(() => (...args) => {
+        cancelledRef.current = false;
+        callIdRef.current += 1;
+        const thisCallId = callIdRef.current;
+        if (!isUnmounted.current) {
+            setStatus('pending');
+            setError(null);
+        }
+        const promise = asyncFn(...args);
+        return promise.then((resolved) => {
+            if (thisCallId === callIdRef.current && !isUnmounted.current) {
+                setStatus('resolved');
+                setValue(resolved);
+                setError(null);
+            }
+            return resolved;
+        }, (err) => {
+            const rejection = err instanceof Error ? err : new Error(String(err));
+            if (thisCallId === callIdRef.current && !isUnmounted.current) {
+                setStatus('rejected');
+                setError(rejection);
+            }
+            throw rejection;
+        });
+    }, [asyncFn]);
+    const state = useMemo(() => ({
+        status,
+        value,
+        error,
+        cancel,
+        reset,
+    }), [status, value, error, cancel, reset]);
+    return [state, callAsyncFn];
+};
+//# sourceMappingURL=usePromise.js.map

package/dist/hooks/usePromise.js.map

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

package/dist/hooks/usePush.d.ts

@@ -0,0 +1,50 @@
+/**
+ * React hook for push notifications.
+ *
+ * @module
+ */
+import type { NotificationActionListener, NotificationReceivedListener, PermissionStatus, PushRegisterOptions, PushToken, TokenChangeListener } from '@molecule/app-push';
+/**
+ * Hook return type.
+ */
+export interface UsePushResult {
+    permission: PermissionStatus | null;
+    token: PushToken | null;
+    checkPermission: () => Promise<PermissionStatus>;
+    requestPermission: () => Promise<PermissionStatus>;
+    register: (options?: PushRegisterOptions) => Promise<PushToken>;
+    unregister: () => Promise<void>;
+    onNotificationReceived: (listener: NotificationReceivedListener) => () => void;
+    onNotificationAction: (listener: NotificationActionListener) => () => void;
+    onTokenChange: (listener: TokenChangeListener) => () => void;
+    setBadge: (count: number) => Promise<void>;
+    clearBadge: () => Promise<void>;
+}
+/**
+ * Options for the usePush hook (e.g. check permission on mount).
+ */
+export interface UsePushOptions {
+    /**
+     * Whether to check permission status on mount.
+     */
+    checkOnMount?: boolean;
+}
+/**
+ * Hook for push notification state and actions.
+ *
+ * Uses module-level `getProvider()` — push is a singleton, not context-provided.
+ *
+ * @param options - Hook options
+ * @returns Push notification state and action methods
+ *
+ * @example
+ * ```tsx
+ * const { permission, token, requestPermission, register } = usePush({ checkOnMount: true })
+ *
+ * if (permission === 'default') {
+ *   return <button onClick={requestPermission}>Enable Notifications</button>
+ * }
+ * ```
+ */
+export declare function usePush(options?: UsePushOptions): UsePushResult;
+//# sourceMappingURL=usePush.d.ts.map

package/dist/hooks/usePush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePush.d.ts","sourceRoot":"","sources":["../../src/hooks/usePush.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,gBAAgB,EAEhB,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACpB,MAAM,oBAAoB,CAAA;AAG3B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACnC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,eAAe,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAClD,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/D,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,sBAAsB,EAAE,CAAC,QAAQ,EAAE,4BAA4B,KAAK,MAAM,IAAI,CAAA;IAC9E,oBAAoB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,MAAM,IAAI,CAAA;IAC1E,aAAa,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,MAAM,IAAI,CAAA;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CA0E/D"}

package/dist/hooks/usePush.js

@@ -0,0 +1,89 @@
+/**
+ * React hook for push notifications.
+ *
+ * @module
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getProvider } from '@molecule/app-push';
+/**
+ * Hook for push notification state and actions.
+ *
+ * Uses module-level `getProvider()` — push is a singleton, not context-provided.
+ *
+ * @param options - Hook options
+ * @returns Push notification state and action methods
+ *
+ * @example
+ * ```tsx
+ * const { permission, token, requestPermission, register } = usePush({ checkOnMount: true })
+ *
+ * if (permission === 'default') {
+ *   return <button onClick={requestPermission}>Enable Notifications</button>
+ * }
+ * ```
+ */
+export function usePush(options) {
+    const { checkOnMount = false } = options ?? {};
+    const providerRef = useRef(getProvider());
+    const [permission, setPermission] = useState(null);
+    const [token, setToken] = useState(null);
+    // Check permission on mount if requested
+    useEffect(() => {
+        if (checkOnMount) {
+            providerRef.current
+                .checkPermission()
+                .then(setPermission)
+                .catch(() => {
+                // Silently fail
+            });
+        }
+    }, [checkOnMount]);
+    const checkPermission = useCallback(async () => {
+        const status = await providerRef.current.checkPermission();
+        setPermission(status);
+        return status;
+    }, []);
+    const requestPermission = useCallback(async () => {
+        const status = await providerRef.current.requestPermission();
+        setPermission(status);
+        return status;
+    }, []);
+    const register = useCallback(async (options) => {
+        const pushToken = await providerRef.current.register(options);
+        setToken(pushToken);
+        return pushToken;
+    }, []);
+    const unregister = useCallback(async () => {
+        await providerRef.current.unregister();
+        setToken(null);
+    }, []);
+    const onNotificationReceived = useCallback((listener) => {
+        return providerRef.current.onNotificationReceived(listener);
+    }, []);
+    const onNotificationAction = useCallback((listener) => {
+        return providerRef.current.onNotificationAction(listener);
+    }, []);
+    const onTokenChange = useCallback((listener) => {
+        return providerRef.current.onTokenChange(listener);
+    }, []);
+    const setBadge = useCallback(async (count) => {
+        await providerRef.current.setBadge(count);
+    }, []);
+    const clearBadge = useCallback(async () => {
+        await providerRef.current.clearBadge();
+    }, []);
+    return {
+        permission,
+        token,
+        checkPermission,
+        requestPermission,
+        register,
+        unregister,
+        onNotificationReceived,
+        onNotificationAction,
+        onTokenChange,
+        setBadge,
+        clearBadge,
+    };
+}
+//# sourceMappingURL=usePush.js.map

package/dist/hooks/usePush.js.map

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

package/dist/hooks/useRouter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * React hook for routing.
+ *
+ * @module
+ */
+import type { NavigateOptions, QueryParams, RouteLocation, RouteParams, Router } from '@molecule/app-routing';
+import type { UseRouterResult } from '../types.js';
+/**
+ * Hook to access the router from context.
+ *
+ * @returns The router from context
+ * @throws {Error} Error if used outside of RouterProvider
+ */
+export declare function useRouterInstance(): Router;
+/**
+ * Hook for routing state and actions.
+ *
+ * @returns Router state and navigation methods
+ *
+ * @example
+ * ```tsx
+ * const { location, params, navigate, back } = useRouter()
+ *
+ * return (
+ *   <div>
+ *     <p>Current path: {location.pathname}</p>
+ *     <button onClick={() => navigate('/home')}>Go Home</button>
+ *   </div>
+ * )
+ * ```
+ */
+export declare function useRouter(): UseRouterResult;
+/**
+ * Hook to get the current location.
+ *
+ * @returns The current route location
+ */
+export declare function useLocation(): RouteLocation;
+/**
+ * Hook to get route parameters.
+ *
+ * @returns The current route parameters
+ */
+export declare function useParams<T extends Record<string, string> = RouteParams>(): T;
+/**
+ * Hook to get query parameters.
+ *
+ * @returns The current query parameters
+ */
+export declare function useQuery<T extends QueryParams = QueryParams>(): T;
+/**
+ * Hook to get the navigate function.
+ *
+ * @returns The navigate function
+ */
+export declare function useNavigate(): (path: string, options?: NavigateOptions) => void;
+/**
+ * Hook to check if a path is active.
+ *
+ * @param path - The path to check
+ * @param exact - Whether to match exactly (default: false)
+ * @returns Whether the path is active
+ */
+export declare function useIsActive(path: string, exact?: boolean): boolean;
+//# sourceMappingURL=useRouter.d.ts.map

package/dist/hooks/useRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouter.d.ts","sourceRoot":"","sources":["../../src/hooks/useRouter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,eAAe,CA8C3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAG3C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,KAAK,CAAC,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,CAAC,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,IAAI,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAQhE"}

package/dist/hooks/useRouter.js

@@ -0,0 +1,120 @@
+/**
+ * React hook for routing.
+ *
+ * @module
+ */
+import { useCallback, useContext, useEffect, useState, useSyncExternalStore } from 'react';
+import { t } from '@molecule/app-i18n';
+import { RouterContext } from '../contexts.js';
+/**
+ * Hook to access the router from context.
+ *
+ * @returns The router from context
+ * @throws {Error} Error if used outside of RouterProvider
+ */
+export function useRouterInstance() {
+    const router = useContext(RouterContext);
+    if (!router) {
+        throw new Error(t('react.error.useRouterOutsideProvider', undefined, {
+            defaultValue: 'useRouterInstance must be used within a RouterProvider',
+        }));
+    }
+    return router;
+}
+/**
+ * Hook for routing state and actions.
+ *
+ * @returns Router state and navigation methods
+ *
+ * @example
+ * ```tsx
+ * const { location, params, navigate, back } = useRouter()
+ *
+ * return (
+ *   <div>
+ *     <p>Current path: {location.pathname}</p>
+ *     <button onClick={() => navigate('/home')}>Go Home</button>
+ *   </div>
+ * )
+ * ```
+ */
+export function useRouter() {
+    const router = useRouterInstance();
+    const [location, setLocation] = useState(() => router.getLocation());
+    const [params, setParams] = useState(() => router.getParams());
+    const [query, setQuery] = useState(() => router.getQuery());
+    useEffect(() => {
+        const unsubscribe = router.subscribe(() => {
+            setLocation(router.getLocation());
+            setParams(router.getParams());
+            setQuery(router.getQuery());
+        });
+        return unsubscribe;
+    }, [router]);
+    // Memoized action wrappers
+    const navigate = useCallback((path, options) => router.navigate(path, options), [router]);
+    const navigateTo = useCallback((name, params, query, options) => router.navigateTo(name, params, query, options), [router]);
+    const back = useCallback(() => router.back(), [router]);
+    const forward = useCallback(() => router.forward(), [router]);
+    const isActive = useCallback((path, exact) => router.isActive(path, exact), [router]);
+    return {
+        location,
+        params,
+        query,
+        navigate,
+        navigateTo,
+        back,
+        forward,
+        isActive,
+    };
+}
+/**
+ * Hook to get the current location.
+ *
+ * @returns The current route location
+ */
+export function useLocation() {
+    const { location } = useRouter();
+    return location;
+}
+/**
+ * Hook to get route parameters.
+ *
+ * @returns The current route parameters
+ */
+export function useParams() {
+    const { params } = useRouter();
+    return params;
+}
+/**
+ * Hook to get query parameters.
+ *
+ * @returns The current query parameters
+ */
+export function useQuery() {
+    const { query } = useRouter();
+    return query;
+}
+/**
+ * Hook to get the navigate function.
+ *
+ * @returns The navigate function
+ */
+export function useNavigate() {
+    const router = useRouterInstance();
+    return useCallback((path, options) => router.navigate(path, options), [router]);
+}
+/**
+ * Hook to check if a path is active.
+ *
+ * @param path - The path to check
+ * @param exact - Whether to match exactly (default: false)
+ * @returns Whether the path is active
+ */
+export function useIsActive(path, exact = false) {
+    const router = useRouterInstance();
+    const getSnapshot = useCallback(() => router.isActive(path, exact), [router, path, exact]);
+    const subscribe = useCallback((onChange) => router.subscribe(onChange), [router]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+//# sourceMappingURL=useRouter.js.map

package/dist/hooks/useRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouter.js","sourceRoot":"","sources":["../../src/hooks/useRouter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAE1F,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAStC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAG9C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,CAAC,CAAC,sCAAsC,EAAE,SAAS,EAAE;YACnD,YAAY,EAAE,wDAAwD;SACvE,CAAC,CACH,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAElC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IACnF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAyB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IACtF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAc,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;IAExE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;YACxC,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;YACjC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;YAC7B,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;QACF,OAAO,WAAW,CAAA;IACpB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAY,EAAE,OAAyB,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAC3E,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,IAAY,EAAE,MAAoB,EAAE,KAAmB,EAAE,OAAyB,EAAE,EAAE,CACrF,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EACjD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACvD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAE7D,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAY,EAAE,KAAe,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAC/D,CAAC,MAAM,CAAC,CACT,CAAA;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK;QACL,QAAQ;QACR,UAAU;QACV,IAAI;QACJ,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAA;IAChC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;IAC9B,OAAO,MAAW,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAAA;IAC7B,OAAO,KAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,OAAO,WAAW,CAChB,CAAC,IAAY,EAAE,OAAyB,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAC3E,CAAC,MAAM,CAAC,CACT,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAK,GAAG,KAAK;IACrD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAElC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAE1F,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,QAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAE7F,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AAClE,CAAC"}

package/dist/hooks/useSignup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * React hook for registration with async state tracking.
+ *
+ * @module
+ */
+import type { AuthResult, RegisterData } from '@molecule/app-auth';
+import { type UsePromiseState } from './usePromise.js';
+/**
+ * Return type for useSignup hook.
+ */
+export interface UseSignupReturn<T = unknown> {
+    status: UsePromiseState<AuthResult<T>>['status'];
+    value: UsePromiseState<AuthResult<T>>['value'];
+    error: UsePromiseState<AuthResult<T>>['error'];
+    signup: (data: RegisterData) => Promise<AuthResult<T>>;
+    reset: () => void;
+}
+/**
+ * Hook for user registration with async state tracking.
+ *
+ * @returns Signup state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, signup } = useSignup()
+ *
+ * return (
+ *   <button onClick={() => signup({ email, password, name })} disabled={status === 'pending'}>
+ *     {status === 'pending' ? 'Creating account...' : 'Sign Up'}
+ *   </button>
+ * )
+ * ```
+ */
+export declare function useSignup<T = unknown>(): UseSignupReturn<T>;
+//# sourceMappingURL=useSignup.d.ts.map

package/dist/hooks/useSignup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSignup.d.ts","sourceRoot":"","sources":["../../src/hooks/useSignup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGlE,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAChD,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9C,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACtD,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,CAc3D"}

package/dist/hooks/useSignup.js

@@ -0,0 +1,37 @@
+/**
+ * React hook for registration with async state tracking.
+ *
+ * @module
+ */
+import { useCallback } from 'react';
+import { useAuthClient } from './useAuth.js';
+import { usePromise } from './usePromise.js';
+/**
+ * Hook for user registration with async state tracking.
+ *
+ * @returns Signup state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, signup } = useSignup()
+ *
+ * return (
+ *   <button onClick={() => signup({ email, password, name })} disabled={status === 'pending'}>
+ *     {status === 'pending' ? 'Creating account...' : 'Sign Up'}
+ *   </button>
+ * )
+ * ```
+ */
+export function useSignup() {
+    const client = useAuthClient();
+    const registerFn = useCallback((data) => client.register(data), [client]);
+    const [state, call] = usePromise(registerFn);
+    return {
+        status: state.status,
+        value: state.value,
+        error: state.error,
+        signup: call,
+        reset: state.reset,
+    };
+}
+//# sourceMappingURL=useSignup.js.map

package/dist/hooks/useSignup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSignup.js","sourceRoot":"","sources":["../../src/hooks/useSignup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAInC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAalE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,aAAa,EAAK,CAAA;IAEjC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,IAAkB,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEvF,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IAE5C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAA;AACH,CAAC"}

package/dist/hooks/useStorage.d.ts

@@ -0,0 +1,72 @@
+/**
+ * React hook for storage.
+ *
+ * @module
+ */
+import type { StorageProvider } from '@molecule/app-storage';
+/**
+ * Hook to access the storage provider from context.
+ *
+ * @returns The storage provider from context
+ * @throws {Error} Error if used outside of StorageProvider
+ */
+export declare function useStorageProvider(): StorageProvider;
+/**
+ * Options for useStorageValue hook.
+ */
+export interface UseStorageValueOptions<T> {
+    /**
+     * Default value if key doesn't exist.
+     */
+    defaultValue?: T;
+    /**
+     * Whether to sync across tabs/windows (if supported by storage provider).
+     */
+    sync?: boolean;
+}
+/**
+ * Result of useStorageValue hook.
+ */
+export interface UseStorageValueResult<T> {
+    value: T | undefined;
+    setValue: (value: T) => Promise<void>;
+    removeValue: () => Promise<void>;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to manage a single storage value with React state sync.
+ *
+ * @param key - Storage key
+ * @param options - Hook options
+ *
+ * @example
+ * ```tsx
+ * const { value: theme, setValue: setTheme, loading } = useStorageValue<string>('theme', {
+ *   defaultValue: 'light'
+ * })
+ *
+ * if (loading) return <Spinner />
+ * return (
+ *   <select value={theme} onChange={(e) => setTheme(e.target.value)}>
+ *     <option value="light">Light</option>
+ *     <option value="dark">Dark</option>
+ *   </select>
+ * )
+ * ```
+ * @returns Storage value state (value, loading, error) and mutators (setValue, removeValue).
+ */
+export declare function useStorageValue<T>(key: string, options?: UseStorageValueOptions<T>): UseStorageValueResult<T>;
+/**
+ * Hook for simple storage operations without React state sync.
+ *
+ * @returns Storage operation methods
+ */
+export declare function useStorage(): {
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T) => Promise<void>;
+    remove: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+    keys: () => Promise<string[]>;
+};
+//# sourceMappingURL=useStorage.d.ts.map

package/dist/hooks/useStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAUpD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,qBAAqB,CAAC,CAAC,CAAC,CAsF1B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC9B,CAoBA"}