@entropy-softworks/ui 2026.7.31

package/lib/hooks/useAuth.jsx

@@ -0,0 +1,404 @@
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { useNavigation } from "../context/NavigationContext";
+import { useAppConfig } from "../context/AppConfigContext";
+import AuthService from "../services/auth.service";
+const AuthContext = createContext(undefined);
+export function AuthProvider({ children, onAfterLogin, onAfterRegister, onBeforeLogout, onBeforeCheckAuth, loginWithPasskey: providedLoginWithPasskey, unlockWithPassword: providedUnlockWithPassword, onError, }) {
+    // Stable wrapper so `console.warn`-then-onError stays a single
+    // pattern across every silent catch in this provider.
+    const reportError = useCallback((error, context) => {
+        if (__DEV__) {
+            console.warn(`[auth:${context}]`, error);
+        }
+        try {
+            onError?.(error, context);
+        }
+        catch {
+            // Telemetry must never crash the auth flow.
+        }
+    }, [onError]);
+    const [user, setUser] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isAuthenticated, setIsAuthenticated] = useState(false);
+    const [error, setError] = useState(null);
+    const router = useNavigation();
+    const { routes } = useAppConfig();
+    const authCheckRef = useRef(false);
+    const sessionGenRef = useRef(0);
+    const clearError = useCallback(() => {
+        setError(null);
+    }, []);
+    const routeAfterAuth = useCallback((response, email) => {
+        const step = response.user.onboarding_step;
+        if (step === "email_verification") {
+            router.replace({ pathname: routes.verifyEmail, params: { email } });
+        }
+        else if (step === "mfa_enrollment") {
+            router.replace(routes.mfaEnroll);
+        }
+        else if (step === "import") {
+            router.replace(routes.importData);
+        }
+        else if (step === "complete" || step == null) {
+            router.replace(routes.home);
+        }
+        else {
+            // Unknown step (server added a new onboarding step the
+            // client doesn't recognize). Route home — the consumer's
+            // route guards will catch the still-incomplete state and
+            // either prompt an app update or re-route to welcome.
+            // Don't strand the user in the auth flow.
+            router.replace(routes.home);
+        }
+    }, [router, routes]);
+    const checkAuth = useCallback(async () => {
+        if (authCheckRef.current) {
+            return;
+        }
+        authCheckRef.current = true;
+        const gen = ++sessionGenRef.current;
+        try {
+            setIsLoading(true);
+            const isAuth = await AuthService.isAuthenticated();
+            if (gen !== sessionGenRef.current) {
+                return;
+            }
+            if (isAuth) {
+                const userData = await AuthService.getCurrentUser();
+                if (gen !== sessionGenRef.current) {
+                    return;
+                }
+                if (userData) {
+                    // Unblock navigation immediately with cached data.
+                    setUser(userData);
+                    setIsAuthenticated(true);
+                    setIsLoading(false);
+                    authCheckRef.current = false;
+                    // Refresh from the server in the background.
+                    AuthService.refreshUserData()
+                        .then((fresh) => {
+                        if (fresh && gen === sessionGenRef.current) {
+                            setUser(fresh);
+                        }
+                    })
+                        .catch((e) => reportError(e, "background-refresh"));
+                    return;
+                }
+                else {
+                    await AuthService.logout();
+                    if (gen !== sessionGenRef.current) {
+                        return;
+                    }
+                    setUser(null);
+                    setIsAuthenticated(false);
+                }
+            }
+            else {
+                setUser(null);
+                setIsAuthenticated(false);
+            }
+        }
+        catch (e) {
+            // Distinguish a transport failure (server unreachable on cold
+            // start) from a real auth failure. Falling through to
+            // "logged out" on transient network errors paints the welcome
+            // screen unjustly to a user whose cookie is still valid, then
+            // flips back the moment a request lands. Keep any persisted
+            // user record while we wait for the next probe.
+            if (gen !== sessionGenRef.current) {
+                return;
+            }
+            const persisted = await AuthService.getCurrentUser().catch(() => null);
+            if (gen !== sessionGenRef.current) {
+                return;
+            }
+            if (persisted) {
+                setUser(persisted);
+                setIsAuthenticated(true);
+                reportError(e instanceof Error ? e : new Error(String(e)), "check-auth-transient");
+            }
+            else {
+                setUser(null);
+                setIsAuthenticated(false);
+            }
+        }
+        finally {
+            if (gen === sessionGenRef.current) {
+                setIsLoading(false);
+            }
+            authCheckRef.current = false;
+        }
+    }, [reportError]);
+    useEffect(() => {
+        AuthService.loadServerUrlOverride()
+            .then(() => (onBeforeCheckAuth ? onBeforeCheckAuth() : undefined))
+            .catch((e) => reportError(e, "pre-check-auth"))
+            .then(() => checkAuth());
+    }, [checkAuth, onBeforeCheckAuth, reportError]);
+    const login = useCallback(async (email, password) => {
+        try {
+            setIsLoading(true);
+            setError(null);
+            const response = await AuthService.login(email, password);
+            if (onAfterLogin) {
+                try {
+                    await onAfterLogin(password, response);
+                }
+                catch (hookErr) {
+                    await AuthService.logout();
+                    const message = hookErr instanceof Error ? hookErr.message : "Post-login hook failed";
+                    // Deliberately do NOT attach `cause: hookErr` — the inner
+                    // error from the consumer's post-login hook may carry
+                    // key-derivation context (raw masterPassword references,
+                    // server payloads) that would be exposed if downstream
+                    // logging surfaces `err.cause` (Sentry, devtools, …).
+                    throw new Error(message);
+                }
+            }
+            setUser(response.user);
+            setIsAuthenticated(true);
+            routeAfterAuth(response, email);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Login failed";
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [onAfterLogin, routeAfterAuth]);
+    const register = useCallback(async (email, username, password, displayName) => {
+        try {
+            setIsLoading(true);
+            setError(null);
+            const response = await AuthService.register(email, username, password, displayName);
+            if (onAfterRegister) {
+                try {
+                    await onAfterRegister(password, response);
+                }
+                catch (hookErr) {
+                    await AuthService.logout();
+                    const message = hookErr instanceof Error ? hookErr.message : "Post-register hook failed";
+                    // No `cause` chain — see login() above for rationale.
+                    throw new Error(message);
+                }
+            }
+            setUser(response.user);
+            setIsAuthenticated(true);
+            routeAfterAuth(response, email);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Registration failed";
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [onAfterRegister, routeAfterAuth]);
+    const logout = useCallback(async () => {
+        sessionGenRef.current++;
+        setIsLoading(true);
+        // Flip React auth state FIRST so any in-flight queries that
+        // re-render against `user` / `isAuthenticated` see "logged out"
+        // immediately. Previously this happened after `AuthService.logout()`
+        // resolved, opening a window where the pre-logout hook had already
+        // torn down KeyManager / queryClient / WS but components still
+        // rendered as authenticated — any React-Query refetch in that
+        // window would hit a half-disassembled client.
+        setUser(null);
+        setIsAuthenticated(false);
+        if (onBeforeLogout) {
+            try {
+                await onBeforeLogout();
+            }
+            catch (e) {
+                // pre-logout hook errors are non-fatal — proceed to clear
+                // state. Telemetry sees it via the onError surface.
+                reportError(e, "pre-logout-hook");
+            }
+        }
+        router.replace(routes.login);
+        // Server-side revoke runs in the background. Failure is also
+        // surfaced through the onError hook so consumers can detect
+        // half-broken logouts (server session still alive after the
+        // user thinks they're gone).
+        try {
+            await AuthService.logout();
+        }
+        catch (e) {
+            reportError(e, "logout-revoke");
+        }
+        setIsLoading(false);
+    }, [onBeforeLogout, router, routes, reportError]);
+    const refreshUser = useCallback(async () => {
+        try {
+            const userData = await AuthService.refreshUserData();
+            if (userData) {
+                setUser(userData);
+                setIsAuthenticated(true);
+            }
+            else {
+                setUser(null);
+                setIsAuthenticated(false);
+                router.replace(routes.login);
+            }
+        }
+        catch {
+            // Refresh failed — try again on next interval.
+        }
+    }, [router, routes]);
+    const deleteAccount = useCallback(async (password) => {
+        sessionGenRef.current++;
+        try {
+            setIsLoading(true);
+            await AuthService.deleteAccount(password);
+            if (onBeforeLogout) {
+                try {
+                    await onBeforeLogout();
+                }
+                catch {
+                    // ignore
+                }
+            }
+            setUser(null);
+            setIsAuthenticated(false);
+            router.replace(routes.welcome);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Failed to delete account";
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [onBeforeLogout, router, routes]);
+    const loginWithPasskey = useCallback(async (email, signal) => {
+        if (!providedLoginWithPasskey) {
+            throw new Error("entropy-ui: loginWithPasskey() called but AuthProvider wasn't given a loginWithPasskey handler.");
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            const result = await providedLoginWithPasskey(email, signal);
+            setUser(result.user);
+            setIsAuthenticated(true);
+            return result;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Passkey sign-in failed";
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [providedLoginWithPasskey]);
+    const unlockWithPassword = useCallback(async (password) => {
+        if (!providedUnlockWithPassword) {
+            throw new Error("entropy-ui: unlockWithPassword() called but AuthProvider wasn't given an unlockWithPassword handler.");
+        }
+        await providedUnlockWithPassword(password);
+    }, [providedUnlockWithPassword]);
+    const value = useMemo(() => ({
+        user,
+        isLoading,
+        isAuthenticated,
+        login,
+        loginWithPasskey,
+        unlockWithPassword,
+        register,
+        logout,
+        refreshUser,
+        deleteAccount,
+        checkAuth,
+        error,
+        clearError,
+    }), [
+        user,
+        isLoading,
+        isAuthenticated,
+        login,
+        loginWithPasskey,
+        unlockWithPassword,
+        register,
+        logout,
+        refreshUser,
+        deleteAccount,
+        checkAuth,
+        error,
+        clearError,
+    ]);
+    return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
+}
+export function useAuth() {
+    const context = useContext(AuthContext);
+    if (context === undefined) {
+        throw new Error("useAuth must be used within an AuthProvider");
+    }
+    return context;
+}
+export function useRole(requiredRole) {
+    const { user } = useAuth();
+    if (!user) {
+        return false;
+    }
+    if (requiredRole === "User") {
+        return true;
+    }
+    return user.role === "Admin";
+}
+export function useRequireAuth(redirectTo) {
+    const { isAuthenticated, isLoading } = useAuth();
+    const router = useNavigation();
+    const { routes } = useAppConfig();
+    const target = redirectTo ?? routes.login;
+    useEffect(() => {
+        if (!isLoading && !isAuthenticated) {
+            router.replace(target);
+        }
+    }, [isAuthenticated, isLoading, router, target]);
+    return { isAuthenticated, isLoading };
+}
+export function useSession() {
+    const { user, refreshUser, isAuthenticated } = useAuth();
+    const intervalRef = useRef(undefined);
+    const refreshingRef = useRef(false);
+    useEffect(() => {
+        if (isAuthenticated) {
+            intervalRef.current = setInterval(() => {
+                if (refreshingRef.current) {
+                    return;
+                }
+                refreshingRef.current = true;
+                refreshUser()
+                    .catch((e) => {
+                    // `useSession` lives outside the provider's
+                    // reportError closure; auto-refresh failures only
+                    // surface in dev. The `refreshUser()` impl itself
+                    // reports via onError when wired.
+                    if (__DEV__) {
+                        console.warn("[auth:session-refresh-interval]", e);
+                    }
+                })
+                    .finally(() => {
+                    refreshingRef.current = false;
+                });
+            }, 10 * 60 * 1000);
+        }
+        return () => {
+            if (intervalRef.current) {
+                clearInterval(intervalRef.current);
+            }
+        };
+    }, [isAuthenticated, refreshUser]);
+    return { user };
+}
+// Validators live in `utils/validation` and are re-exported via the
+// utils barrel. Existing consumers that imported them from this module
+// pull them from the package root barrel instead.
+export { validateEmail, validatePassword, validateUsername } from "../utils/validation";
+export default useAuth;
+//# sourceMappingURL=useAuth.jsx.map

package/lib/hooks/useAuth.jsx.map

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

package/lib/hooks/useAutoLock.d.ts

@@ -0,0 +1,22 @@
+export interface UseAutoLockOptions {
+    /**
+     * Reports whether the session is currently "unlocked" (vault-style
+     * apps) or any other state where the auto-lock should still fire.
+     * Returning `false` short-circuits the lock call.
+     */
+    isUnlocked: () => boolean;
+    /** Called when the lock should fire. App owns side-effects. */
+    onLock: () => void;
+    /** Reports whether auto-lock is enabled for this user (settings flag). */
+    isEnabled?: () => boolean | Promise<boolean>;
+    /** Idle threshold in milliseconds. Defaults to 10 minutes. */
+    idleLockMs?: number;
+}
+/**
+ * Auto-lock a session after a period of inactivity. Generic over the
+ * lock predicate — vault wires `KeyManager.isUnlocked` / `KeyManager.lock`,
+ * other apps wire their own state. Web uses an idle-timer only; native
+ * additionally locks immediately when the app goes to the background.
+ */
+export declare function useAutoLock(options: UseAutoLockOptions): void;
+//# sourceMappingURL=useAutoLock.d.ts.map

package/lib/hooks/useAutoLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoLock.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAmF7D"}

package/lib/hooks/useAutoLock.js

@@ -0,0 +1,85 @@
+import { useEffect } from "react";
+import { AppState as RNAppState, Platform } from "react-native";
+const DEFAULT_IDLE_LOCK_MS = 10 * 60 * 1000;
+/**
+ * Auto-lock a session after a period of inactivity. Generic over the
+ * lock predicate — vault wires `KeyManager.isUnlocked` / `KeyManager.lock`,
+ * other apps wire their own state. Web uses an idle-timer only; native
+ * additionally locks immediately when the app goes to the background.
+ */
+export function useAutoLock(options) {
+    const { isUnlocked, onLock, isEnabled, idleLockMs = DEFAULT_IDLE_LOCK_MS } = options;
+    useEffect(() => {
+        let idleTimer = null;
+        let lastActivityAt = Date.now();
+        const lockIfEnabled = () => {
+            if (idleTimer !== null) {
+                clearTimeout(idleTimer);
+                idleTimer = null;
+            }
+            if (!isUnlocked()) {
+                return;
+            }
+            Promise.resolve(isEnabled ? isEnabled() : true)
+                .then((enabled) => {
+                if (enabled && isUnlocked()) {
+                    onLock();
+                }
+            })
+                .catch(() => { });
+        };
+        const armIdleTimer = () => {
+            if (idleTimer !== null) {
+                clearTimeout(idleTimer);
+            }
+            const remaining = idleLockMs - (Date.now() - lastActivityAt);
+            if (remaining <= 0) {
+                lockIfEnabled();
+                return;
+            }
+            idleTimer = setTimeout(lockIfEnabled, remaining);
+        };
+        const onActivity = () => {
+            lastActivityAt = Date.now();
+            armIdleTimer();
+        };
+        // On web, RN Web's AppState mirrors document visibility — tab-hidden
+        // becomes 'background', which would otherwise fire an immediate lock.
+        // Only treat 'background' as a lock signal on real native platforms.
+        const subscription = RNAppState.addEventListener("change", (nextState) => {
+            if (nextState === "background" && Platform.OS !== "web") {
+                lockIfEnabled();
+            }
+            else if (nextState === "active") {
+                armIdleTimer();
+            }
+        });
+        const cleanups = [];
+        if (Platform.OS === "web" && typeof document !== "undefined") {
+            const onVisibility = () => {
+                if (document.visibilityState === "visible") {
+                    armIdleTimer();
+                }
+            };
+            document.addEventListener("visibilitychange", onVisibility);
+            cleanups.push(() => document.removeEventListener("visibilitychange", onVisibility));
+            const activityEvents = ["mousemove", "mousedown", "keydown", "touchstart", "scroll"];
+            for (const e of activityEvents) {
+                window.addEventListener(e, onActivity, { passive: true });
+                cleanups.push(() => window.removeEventListener(e, onActivity));
+            }
+        }
+        armIdleTimer();
+        return () => {
+            subscription.remove();
+            for (const fn of cleanups) {
+                fn();
+            }
+            if (idleTimer !== null) {
+                clearTimeout(idleTimer);
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+}
+//# sourceMappingURL=useAutoLock.js.map

package/lib/hooks/useAutoLock.js.map

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

package/lib/hooks/useDebouncedValue.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns a debounced copy of `value` that only updates after `value` has
+ * stopped changing for `delayMs`. Use it to keep a controlled input
+ * responsive (bind the input to the raw value) while throttling the
+ * expensive work it drives — a network query, a react-query cache key, a
+ * filter over a large list.
+ *
+ * The pending update is cancelled on unmount and whenever `value` changes
+ * again, so a fast typer never fires an update per keystroke and there is no
+ * setState-after-unmount on the trailing edge.
+ *
+ * @example
+ * const [term, setTerm] = useState("");
+ * const debouncedTerm = useDebouncedValue(term, 300);
+ * // <Input value={term} onChangeText={setTerm} />  — instant feedback
+ * // useQuery({ queryKey: ["search", debouncedTerm], ... })  — one fetch per pause
+ */
+export declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
+//# sourceMappingURL=useDebouncedValue.d.ts.map

package/lib/hooks/useDebouncedValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebouncedValue.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,SAAM,GAAG,CAAC,CAU/D"}

package/lib/hooks/useDebouncedValue.js

@@ -0,0 +1,29 @@
+import { useEffect, useState } from "react";
+import { debounce } from "../utils/debounce";
+/**
+ * Returns a debounced copy of `value` that only updates after `value` has
+ * stopped changing for `delayMs`. Use it to keep a controlled input
+ * responsive (bind the input to the raw value) while throttling the
+ * expensive work it drives — a network query, a react-query cache key, a
+ * filter over a large list.
+ *
+ * The pending update is cancelled on unmount and whenever `value` changes
+ * again, so a fast typer never fires an update per keystroke and there is no
+ * setState-after-unmount on the trailing edge.
+ *
+ * @example
+ * const [term, setTerm] = useState("");
+ * const debouncedTerm = useDebouncedValue(term, 300);
+ * // <Input value={term} onChangeText={setTerm} />  — instant feedback
+ * // useQuery({ queryKey: ["search", debouncedTerm], ... })  — one fetch per pause
+ */
+export function useDebouncedValue(value, delayMs = 300) {
+    const [debounced, setDebounced] = useState(value);
+    useEffect(() => {
+        const update = debounce((next) => setDebounced(next), delayMs);
+        update(value);
+        return update.cancel;
+    }, [value, delayMs]);
+    return debounced;
+}
+//# sourceMappingURL=useDebouncedValue.js.map

package/lib/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","sourceRoot":"","sources":["../../src/hooks/useDebouncedValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,OAAO,GAAG,GAAG;IAC1D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,IAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/hooks/useShakeAnimation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Horizontal-shake animation for invalid-input feedback. Wrap the target
+ * in an `Animated.View` with the returned `animatedStyle`, then call
+ * `shake()` to trigger.
+ */
+export declare function useShakeAnimation(): {
+    animatedStyle: import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+        transform: {
+            rotate: string;
+        }[];
+    }>;
+    flashStyle: import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+        opacity: number;
+    }>;
+    shake: () => void;
+};
+//# sourceMappingURL=useShakeAnimation.d.ts.map

package/lib/hooks/useShakeAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShakeAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useShakeAnimation.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,iBAAiB;;;;;;;;;;EA4BhC"}

package/lib/hooks/useShakeAnimation.js

@@ -0,0 +1,22 @@
+import { useSharedValue, useAnimatedStyle, withSequence, withTiming, Easing, } from "react-native-reanimated";
+/**
+ * Horizontal-shake animation for invalid-input feedback. Wrap the target
+ * in an `Animated.View` with the returned `animatedStyle`, then call
+ * `shake()` to trigger.
+ */
+export function useShakeAnimation() {
+    const rotation = useSharedValue(0);
+    const flash = useSharedValue(0);
+    const animatedStyle = useAnimatedStyle(() => ({
+        transform: [{ rotate: `${rotation.value}deg` }],
+    }));
+    const flashStyle = useAnimatedStyle(() => ({
+        opacity: flash.value,
+    }));
+    const shake = () => {
+        rotation.value = withSequence(withTiming(-2.5, { duration: 55, easing: Easing.linear }), withTiming(2.5, { duration: 55, easing: Easing.linear }), withTiming(-2, { duration: 55, easing: Easing.linear }), withTiming(2, { duration: 55, easing: Easing.linear }), withTiming(-1, { duration: 45, easing: Easing.linear }), withTiming(0, { duration: 45, easing: Easing.linear }));
+        flash.value = withSequence(withTiming(0.18, { duration: 120, easing: Easing.out(Easing.quad) }), withTiming(0, { duration: 380, easing: Easing.out(Easing.quad) }));
+    };
+    return { animatedStyle, flashStyle, shake };
+}
+//# sourceMappingURL=useShakeAnimation.js.map

package/lib/hooks/useShakeAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShakeAnimation.js","sourceRoot":"","sources":["../../src/hooks/useShakeAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,MAAM,GACP,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAEhC,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;KAChD,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,CAAC,KAAK;KACrB,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,QAAQ,CAAC,KAAK,GAAG,YAAY,CAC3B,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EACzD,UAAU,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EACxD,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EACvD,UAAU,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EACtD,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EACvD,UAAU,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CACvD,CAAC;QACF,KAAK,CAAC,KAAK,GAAG,YAAY,CACxB,UAAU,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EACpE,UAAU,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAClE,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC"}