reactnatively-hooks 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2024 Hakizimana Fred
+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/index.d.mts

@@ -0,0 +1,197 @@
+import { Animated, View, LayoutChangeEvent } from 'react-native';
+import { ScrollHandlerProcessed, SharedValue } from 'react-native-reanimated';
+
+interface UseControllableOptions<T> {
+    /** The controlled value. When provided the hook operates in controlled mode. */
+    value?: T;
+    /** The default value for uncontrolled mode. */
+    defaultValue?: T;
+    /** Called when the value changes in uncontrolled mode. */
+    onChange?: (value: T) => void;
+}
+/**
+ * Bridges controlled and uncontrolled component patterns.
+ * Returns [resolvedValue, setValue] — handles both controlled and uncontrolled.
+ */
+declare function useControllable<T>({ value, defaultValue, onChange, }: UseControllableOptions<T>): [T | undefined, (next: T) => void];
+
+interface UseDisclosureOptions {
+    /** Initial open state for uncontrolled mode. */
+    defaultIsOpen?: boolean;
+    /** Controlled open state. */
+    isOpen?: boolean;
+    /** Called when the open state changes in controlled mode. */
+    onChange?: (isOpen: boolean) => void;
+}
+interface UseDisclosureReturn {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onToggle: () => void;
+}
+/**
+ * Manages open/close/toggle state for modals, drawers, menus, etc.
+ * Supports both controlled (external isOpen + onChange) and uncontrolled modes.
+ */
+declare function useDisclosure(options?: UseDisclosureOptions): UseDisclosureReturn;
+
+/**
+ * Returns a stable unique ID suitable for accessibility label pairing (aria-labelledby, etc.).
+ * Uses React.useId() in React 18+ and falls back to a module-level counter otherwise.
+ */
+declare function useId(prefix?: string): string;
+
+/**
+ * Returns the value from the previous render.
+ * On the first render, returns `undefined`.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Debounces a value by the given delay (in milliseconds).
+ * The returned value will only update after the input value
+ * has stopped changing for `delay` ms.
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
+/**
+ * Returns a throttled version of the provided callback.
+ * The callback will fire at most once per `delay` ms.
+ * Subsequent calls within the delay window are ignored.
+ * The returned function is stable across renders.
+ */
+declare function useThrottle<T extends (...args: Parameters<T>) => ReturnType<T>>(fn: T, delay: number): T;
+
+interface KeyboardState {
+    /** Whether the keyboard is currently visible. */
+    isVisible: boolean;
+    /** Current keyboard height in logical pixels. */
+    height: number;
+    /** Animated.Value tracking keyboard height — animates in sync with the keyboard. */
+    keyboardHeight: Animated.Value;
+}
+/**
+ * Tracks keyboard visibility and height.
+ * Uses React Native's built-in Keyboard API and Animated for smooth transitions.
+ * On web, keyboard events are not available — isVisible and height remain at defaults.
+ */
+declare function useKeyboard(): KeyboardState;
+
+type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+interface DimensionsState {
+    width: number;
+    height: number;
+    scale: number;
+    fontScale: number;
+    /** Current breakpoint based on screen width. */
+    breakpoint: Breakpoint;
+}
+/**
+ * Returns live window dimensions and a responsive breakpoint derived from width.
+ * Breakpoints: xs (<480), sm (<768), md (<1024), lg (<1280), xl (>=1280).
+ * Re-renders automatically when the screen size changes (rotation, resize).
+ */
+declare function useDimensions(): DimensionsState;
+
+interface AccessibilityState {
+    /** Whether the user has requested reduced motion. */
+    isReducedMotion: boolean;
+    /** Whether a screen reader (VoiceOver / TalkBack) is active. */
+    isScreenReader: boolean;
+    /** Whether bold text is enabled (iOS only; false on Android/Web). */
+    isBoldText: boolean;
+    /** Whether grayscale mode is enabled (iOS only; false on Android/Web). */
+    isGrayscale: boolean;
+    /** Whether colour inversion is enabled (iOS only; false on Android/Web). */
+    isInvertColors: boolean;
+}
+/**
+ * Subscribes to AccessibilityInfo and returns live accessibility flags.
+ * Handles graceful degradation: iOS-only flags always return false on Android/Web.
+ */
+declare function useAccessibility(): AccessibilityState;
+
+type HapticImpactStyle = 'light' | 'medium' | 'heavy';
+type HapticNotificationType = 'success' | 'warning' | 'error';
+interface UseHapticReturn {
+    /** Trigger an impact haptic feedback. */
+    impact: (style?: HapticImpactStyle) => Promise<void>;
+    /** Trigger a notification haptic feedback. */
+    notification: (type?: HapticNotificationType) => Promise<void>;
+    /** Trigger a selection haptic feedback. */
+    selection: () => Promise<void>;
+}
+/**
+ * Haptic feedback wrapper.
+ * Uses expo-haptics when available; falls back to no-ops gracefully.
+ * Haptics are automatically skipped on web where they are unsupported.
+ */
+declare function useHaptic(): UseHapticReturn;
+
+type ContainerBreakpoint = 'xs' | 'sm' | 'md' | 'lg';
+/**
+ * Container-based responsive breakpoints derived from the component's own width,
+ * not the screen width. Uses `onLayout` to measure the container.
+ *
+ * Container breakpoints: xs (<320), sm (<480), md (<640), lg (>=640).
+ *
+ * @returns [ref, breakpoint] — attach `ref` to the View you want to measure.
+ *
+ * @example
+ * const [ref, bp] = useContainerQuery();
+ * return <View ref={ref} onLayout={...}>...</View>;
+ */
+declare function useContainerQuery(): [
+    ref: (node: View | null) => void,
+    breakpoint: ContainerBreakpoint
+];
+/**
+ * Extended return type that includes an `onLayout` handler for measurement.
+ * Prefer this form for explicit usage:
+ *
+ * @example
+ * const { ref, breakpoint, onLayout } = useContainerQueryFull();
+ * return <View ref={ref} onLayout={onLayout}>...</View>;
+ */
+interface ContainerQueryResult {
+    ref: (node: View | null) => void;
+    breakpoint: ContainerBreakpoint;
+    onLayout: (event: LayoutChangeEvent) => void;
+}
+/**
+ * Object-API variant of `useContainerQuery` — easier to use when you need
+ * all three values without destructuring a tuple.
+ */
+declare function useContainerQueryFull(): ContainerQueryResult;
+
+/**
+ * useScrollHandler — scroll-driven animation values via Reanimated.
+ *
+ * This hook requires `react-native-reanimated` >= 3.6.0 as a peer dependency.
+ * It is guarded by a try/catch import so that the rest of the package remains
+ * importable when Reanimated is not installed (it will throw a clear error only
+ * when useScrollHandler itself is called).
+ */
+
+interface ScrollHandlerResult {
+    /** Pass this to the `onScroll` prop of Reanimated.ScrollView / FlatList. */
+    scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;
+    /** Shared value tracking current vertical scroll offset in pixels. */
+    scrollY: SharedValue<number>;
+    /** Shared value tracking scroll direction — updates when direction changes. */
+    scrollDirection: SharedValue<'up' | 'down'>;
+}
+/**
+ * Returns scroll-driven Reanimated shared values and a scroll handler.
+ *
+ * @example
+ * const { scrollHandler, scrollY, scrollDirection } = useScrollHandler();
+ * return (
+ *   <Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
+ *     ...
+ *   </Animated.ScrollView>
+ * );
+ */
+declare function useScrollHandler(): ScrollHandlerResult;
+
+export { type AccessibilityState, type Breakpoint, type ContainerBreakpoint, type ContainerQueryResult, type DimensionsState, type HapticImpactStyle, type HapticNotificationType, type KeyboardState, type ScrollHandlerResult, type UseControllableOptions, type UseDisclosureOptions, type UseDisclosureReturn, type UseHapticReturn, useAccessibility, useContainerQuery, useContainerQueryFull, useControllable, useDebounce, useDimensions, useDisclosure, useHaptic, useId, useKeyboard, usePrevious, useScrollHandler, useThrottle };

package/dist/index.d.ts

@@ -0,0 +1,197 @@
+import { Animated, View, LayoutChangeEvent } from 'react-native';
+import { ScrollHandlerProcessed, SharedValue } from 'react-native-reanimated';
+
+interface UseControllableOptions<T> {
+    /** The controlled value. When provided the hook operates in controlled mode. */
+    value?: T;
+    /** The default value for uncontrolled mode. */
+    defaultValue?: T;
+    /** Called when the value changes in uncontrolled mode. */
+    onChange?: (value: T) => void;
+}
+/**
+ * Bridges controlled and uncontrolled component patterns.
+ * Returns [resolvedValue, setValue] — handles both controlled and uncontrolled.
+ */
+declare function useControllable<T>({ value, defaultValue, onChange, }: UseControllableOptions<T>): [T | undefined, (next: T) => void];
+
+interface UseDisclosureOptions {
+    /** Initial open state for uncontrolled mode. */
+    defaultIsOpen?: boolean;
+    /** Controlled open state. */
+    isOpen?: boolean;
+    /** Called when the open state changes in controlled mode. */
+    onChange?: (isOpen: boolean) => void;
+}
+interface UseDisclosureReturn {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onToggle: () => void;
+}
+/**
+ * Manages open/close/toggle state for modals, drawers, menus, etc.
+ * Supports both controlled (external isOpen + onChange) and uncontrolled modes.
+ */
+declare function useDisclosure(options?: UseDisclosureOptions): UseDisclosureReturn;
+
+/**
+ * Returns a stable unique ID suitable for accessibility label pairing (aria-labelledby, etc.).
+ * Uses React.useId() in React 18+ and falls back to a module-level counter otherwise.
+ */
+declare function useId(prefix?: string): string;
+
+/**
+ * Returns the value from the previous render.
+ * On the first render, returns `undefined`.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Debounces a value by the given delay (in milliseconds).
+ * The returned value will only update after the input value
+ * has stopped changing for `delay` ms.
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
+/**
+ * Returns a throttled version of the provided callback.
+ * The callback will fire at most once per `delay` ms.
+ * Subsequent calls within the delay window are ignored.
+ * The returned function is stable across renders.
+ */
+declare function useThrottle<T extends (...args: Parameters<T>) => ReturnType<T>>(fn: T, delay: number): T;
+
+interface KeyboardState {
+    /** Whether the keyboard is currently visible. */
+    isVisible: boolean;
+    /** Current keyboard height in logical pixels. */
+    height: number;
+    /** Animated.Value tracking keyboard height — animates in sync with the keyboard. */
+    keyboardHeight: Animated.Value;
+}
+/**
+ * Tracks keyboard visibility and height.
+ * Uses React Native's built-in Keyboard API and Animated for smooth transitions.
+ * On web, keyboard events are not available — isVisible and height remain at defaults.
+ */
+declare function useKeyboard(): KeyboardState;
+
+type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+interface DimensionsState {
+    width: number;
+    height: number;
+    scale: number;
+    fontScale: number;
+    /** Current breakpoint based on screen width. */
+    breakpoint: Breakpoint;
+}
+/**
+ * Returns live window dimensions and a responsive breakpoint derived from width.
+ * Breakpoints: xs (<480), sm (<768), md (<1024), lg (<1280), xl (>=1280).
+ * Re-renders automatically when the screen size changes (rotation, resize).
+ */
+declare function useDimensions(): DimensionsState;
+
+interface AccessibilityState {
+    /** Whether the user has requested reduced motion. */
+    isReducedMotion: boolean;
+    /** Whether a screen reader (VoiceOver / TalkBack) is active. */
+    isScreenReader: boolean;
+    /** Whether bold text is enabled (iOS only; false on Android/Web). */
+    isBoldText: boolean;
+    /** Whether grayscale mode is enabled (iOS only; false on Android/Web). */
+    isGrayscale: boolean;
+    /** Whether colour inversion is enabled (iOS only; false on Android/Web). */
+    isInvertColors: boolean;
+}
+/**
+ * Subscribes to AccessibilityInfo and returns live accessibility flags.
+ * Handles graceful degradation: iOS-only flags always return false on Android/Web.
+ */
+declare function useAccessibility(): AccessibilityState;
+
+type HapticImpactStyle = 'light' | 'medium' | 'heavy';
+type HapticNotificationType = 'success' | 'warning' | 'error';
+interface UseHapticReturn {
+    /** Trigger an impact haptic feedback. */
+    impact: (style?: HapticImpactStyle) => Promise<void>;
+    /** Trigger a notification haptic feedback. */
+    notification: (type?: HapticNotificationType) => Promise<void>;
+    /** Trigger a selection haptic feedback. */
+    selection: () => Promise<void>;
+}
+/**
+ * Haptic feedback wrapper.
+ * Uses expo-haptics when available; falls back to no-ops gracefully.
+ * Haptics are automatically skipped on web where they are unsupported.
+ */
+declare function useHaptic(): UseHapticReturn;
+
+type ContainerBreakpoint = 'xs' | 'sm' | 'md' | 'lg';
+/**
+ * Container-based responsive breakpoints derived from the component's own width,
+ * not the screen width. Uses `onLayout` to measure the container.
+ *
+ * Container breakpoints: xs (<320), sm (<480), md (<640), lg (>=640).
+ *
+ * @returns [ref, breakpoint] — attach `ref` to the View you want to measure.
+ *
+ * @example
+ * const [ref, bp] = useContainerQuery();
+ * return <View ref={ref} onLayout={...}>...</View>;
+ */
+declare function useContainerQuery(): [
+    ref: (node: View | null) => void,
+    breakpoint: ContainerBreakpoint
+];
+/**
+ * Extended return type that includes an `onLayout` handler for measurement.
+ * Prefer this form for explicit usage:
+ *
+ * @example
+ * const { ref, breakpoint, onLayout } = useContainerQueryFull();
+ * return <View ref={ref} onLayout={onLayout}>...</View>;
+ */
+interface ContainerQueryResult {
+    ref: (node: View | null) => void;
+    breakpoint: ContainerBreakpoint;
+    onLayout: (event: LayoutChangeEvent) => void;
+}
+/**
+ * Object-API variant of `useContainerQuery` — easier to use when you need
+ * all three values without destructuring a tuple.
+ */
+declare function useContainerQueryFull(): ContainerQueryResult;
+
+/**
+ * useScrollHandler — scroll-driven animation values via Reanimated.
+ *
+ * This hook requires `react-native-reanimated` >= 3.6.0 as a peer dependency.
+ * It is guarded by a try/catch import so that the rest of the package remains
+ * importable when Reanimated is not installed (it will throw a clear error only
+ * when useScrollHandler itself is called).
+ */
+
+interface ScrollHandlerResult {
+    /** Pass this to the `onScroll` prop of Reanimated.ScrollView / FlatList. */
+    scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;
+    /** Shared value tracking current vertical scroll offset in pixels. */
+    scrollY: SharedValue<number>;
+    /** Shared value tracking scroll direction — updates when direction changes. */
+    scrollDirection: SharedValue<'up' | 'down'>;
+}
+/**
+ * Returns scroll-driven Reanimated shared values and a scroll handler.
+ *
+ * @example
+ * const { scrollHandler, scrollY, scrollDirection } = useScrollHandler();
+ * return (
+ *   <Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
+ *     ...
+ *   </Animated.ScrollView>
+ * );
+ */
+declare function useScrollHandler(): ScrollHandlerResult;
+
+export { type AccessibilityState, type Breakpoint, type ContainerBreakpoint, type ContainerQueryResult, type DimensionsState, type HapticImpactStyle, type HapticNotificationType, type KeyboardState, type ScrollHandlerResult, type UseControllableOptions, type UseDisclosureOptions, type UseDisclosureReturn, type UseHapticReturn, useAccessibility, useContainerQuery, useContainerQueryFull, useControllable, useDebounce, useDimensions, useDisclosure, useHaptic, useId, useKeyboard, usePrevious, useScrollHandler, useThrottle };

package/dist/index.js

@@ -0,0 +1,355 @@
+'use strict';
+
+var React = require('react');
+var reactNative = require('react-native');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+function useControllable({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const isControlled = value !== void 0;
+  const [internalValue, setInternalValue] = React.useState(defaultValue);
+  const onChangeRef = React.useRef(onChange);
+  onChangeRef.current = onChange;
+  const setValue = React.useCallback(
+    (next) => {
+      if (!isControlled) {
+        setInternalValue(next);
+      }
+      onChangeRef.current?.(next);
+    },
+    [isControlled]
+  );
+  return [isControlled ? value : internalValue, setValue];
+}
+function useDisclosure(options = {}) {
+  const { defaultIsOpen = false, isOpen: controlledIsOpen, onChange } = options;
+  const [isOpen, setIsOpen] = useControllable({
+    value: controlledIsOpen,
+    defaultValue: defaultIsOpen,
+    onChange
+  });
+  const resolvedIsOpen = isOpen ?? false;
+  const onOpen = React.useCallback(() => {
+    setIsOpen(true);
+  }, [setIsOpen]);
+  const onClose = React.useCallback(() => {
+    setIsOpen(false);
+  }, [setIsOpen]);
+  const onToggle = React.useCallback(() => {
+    setIsOpen(!resolvedIsOpen);
+  }, [setIsOpen, resolvedIsOpen]);
+  return { isOpen: resolvedIsOpen, onOpen, onClose, onToggle };
+}
+var counter = 0;
+function generateId(prefix) {
+  counter += 1;
+  return `${prefix}-${counter}`;
+}
+function useId2(prefix = "rn") {
+  if (typeof React__namespace.useId === "function") {
+    const id = React__namespace.useId();
+    return `${prefix}${id}`;
+  }
+  const idRef = React__namespace.useRef(null);
+  if (idRef.current === null) {
+    idRef.current = generateId(prefix);
+  }
+  return idRef.current;
+}
+function usePrevious(value) {
+  const ref = React.useRef(void 0);
+  React.useEffect(() => {
+    ref.current = value;
+  });
+  return ref.current;
+}
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = React.useState(value);
+  React.useEffect(() => {
+    const timer = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(timer);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+function useThrottle(fn, delay) {
+  const lastCallRef = React.useRef(0);
+  const fnRef = React.useRef(fn);
+  fnRef.current = fn;
+  return React.useCallback(
+    (...args) => {
+      const now = Date.now();
+      if (now - lastCallRef.current >= delay) {
+        lastCallRef.current = now;
+        return fnRef.current(...args);
+      }
+      return void 0;
+    },
+    [delay]
+  );
+}
+function useKeyboard() {
+  const [isVisible, setIsVisible] = React.useState(false);
+  const [height, setHeight] = React.useState(0);
+  const keyboardHeight = React.useRef(new reactNative.Animated.Value(0)).current;
+  React.useEffect(() => {
+    if (reactNative.Platform.OS === "web") return;
+    function handleShow(event) {
+      const keyHeight = event.endCoordinates.height;
+      setIsVisible(true);
+      setHeight(keyHeight);
+      reactNative.Animated.timing(keyboardHeight, {
+        toValue: keyHeight,
+        duration: event.duration ?? 250,
+        useNativeDriver: false
+      }).start();
+    }
+    function handleHide(event) {
+      setIsVisible(false);
+      setHeight(0);
+      reactNative.Animated.timing(keyboardHeight, {
+        toValue: 0,
+        duration: event.duration ?? 200,
+        useNativeDriver: false
+      }).start();
+    }
+    const showEvent = reactNative.Platform.OS === "ios" ? "keyboardWillShow" : "keyboardDidShow";
+    const hideEvent = reactNative.Platform.OS === "ios" ? "keyboardWillHide" : "keyboardDidHide";
+    const showSub = reactNative.Keyboard.addListener(showEvent, handleShow);
+    const hideSub = reactNative.Keyboard.addListener(hideEvent, handleHide);
+    return () => {
+      showSub.remove();
+      hideSub.remove();
+    };
+  }, [keyboardHeight]);
+  return { isVisible, height, keyboardHeight };
+}
+function getBreakpoint(width) {
+  if (width < 480) return "xs";
+  if (width < 768) return "sm";
+  if (width < 1024) return "md";
+  if (width < 1280) return "lg";
+  return "xl";
+}
+function useDimensions() {
+  const { width, height, scale, fontScale } = reactNative.useWindowDimensions();
+  const breakpoint = React.useMemo(() => getBreakpoint(width), [width]);
+  return { width, height, scale, fontScale, breakpoint };
+}
+var defaults = {
+  isReducedMotion: false,
+  isScreenReader: false,
+  isBoldText: false,
+  isGrayscale: false,
+  isInvertColors: false
+};
+function useAccessibility() {
+  const [state, setState] = React.useState(defaults);
+  React.useEffect(() => {
+    let cancelled = false;
+    async function init() {
+      const [
+        isReducedMotion,
+        isScreenReader,
+        isBoldText,
+        isGrayscale,
+        isInvertColors
+      ] = await Promise.all([
+        reactNative.AccessibilityInfo.isReduceMotionEnabled(),
+        reactNative.AccessibilityInfo.isScreenReaderEnabled(),
+        reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.isBoldTextEnabled() : Promise.resolve(false),
+        reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.isGrayscaleEnabled() : Promise.resolve(false),
+        reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.isInvertColorsEnabled() : Promise.resolve(false)
+      ]);
+      if (!cancelled) {
+        setState({ isReducedMotion, isScreenReader, isBoldText, isGrayscale, isInvertColors });
+      }
+    }
+    void init();
+    const reduceMotionSub = reactNative.AccessibilityInfo.addEventListener(
+      "reduceMotionChanged",
+      (isReducedMotion) => setState((prev) => ({ ...prev, isReducedMotion }))
+    );
+    const screenReaderSub = reactNative.AccessibilityInfo.addEventListener(
+      "screenReaderChanged",
+      (isScreenReader) => setState((prev) => ({ ...prev, isScreenReader }))
+    );
+    const boldTextSub = reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.addEventListener(
+      "boldTextChanged",
+      (isBoldText) => setState((prev) => ({ ...prev, isBoldText }))
+    ) : null;
+    const grayscaleSub = reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.addEventListener(
+      "grayscaleChanged",
+      (isGrayscale) => setState((prev) => ({ ...prev, isGrayscale }))
+    ) : null;
+    const invertColorsSub = reactNative.Platform.OS === "ios" ? reactNative.AccessibilityInfo.addEventListener(
+      "invertColorsChanged",
+      (isInvertColors) => setState((prev) => ({ ...prev, isInvertColors }))
+    ) : null;
+    return () => {
+      cancelled = true;
+      reduceMotionSub.remove();
+      screenReaderSub.remove();
+      boldTextSub?.remove();
+      grayscaleSub?.remove();
+      invertColorsSub?.remove();
+    };
+  }, []);
+  return state;
+}
+var expoHaptics = void 0;
+function loadExpoHaptics() {
+  if (expoHaptics !== void 0) return expoHaptics;
+  try {
+    const mod = __require("expo-haptics");
+    expoHaptics = mod;
+    return mod;
+  } catch {
+    expoHaptics = null;
+    return null;
+  }
+}
+var noop = () => Promise.resolve();
+function useHaptic() {
+  const impact = React.useCallback(async (style = "medium") => {
+    if (reactNative.Platform.OS === "web") return;
+    const haptics = loadExpoHaptics();
+    if (!haptics) return;
+    const styleMap = {
+      light: haptics.ImpactFeedbackStyle.Light,
+      medium: haptics.ImpactFeedbackStyle.Medium,
+      heavy: haptics.ImpactFeedbackStyle.Heavy
+    };
+    await haptics.impactAsync(styleMap[style]);
+  }, []);
+  const notification = React.useCallback(
+    async (type = "success") => {
+      if (reactNative.Platform.OS === "web") return;
+      const haptics = loadExpoHaptics();
+      if (!haptics) return;
+      const typeMap = {
+        success: haptics.NotificationFeedbackType.Success,
+        warning: haptics.NotificationFeedbackType.Warning,
+        error: haptics.NotificationFeedbackType.Error
+      };
+      await haptics.notificationAsync(typeMap[type]);
+    },
+    []
+  );
+  const selection = React.useCallback(async () => {
+    if (reactNative.Platform.OS === "web") return;
+    const haptics = loadExpoHaptics();
+    if (!haptics) return;
+    await haptics.selectionAsync();
+  }, []);
+  if (reactNative.Platform.OS === "web") {
+    return { impact: noop, notification: noop, selection: noop };
+  }
+  return { impact, notification, selection };
+}
+function getContainerBreakpoint(width) {
+  if (width < 320) return "xs";
+  if (width < 480) return "sm";
+  if (width < 640) return "md";
+  return "lg";
+}
+function useContainerQuery() {
+  const [breakpoint, setBreakpoint] = React.useState("xs");
+  const ref = React.useCallback((_node) => {
+  }, []);
+  const onLayout = React.useCallback((event) => {
+    const { width } = event.nativeEvent.layout;
+    setBreakpoint(getContainerBreakpoint(width));
+  }, []);
+  return Object.assign([ref, breakpoint], { onLayout });
+}
+function useContainerQueryFull() {
+  const [breakpoint, setBreakpoint] = React.useState("xs");
+  const ref = React.useCallback((_node) => {
+  }, []);
+  const onLayout = React.useCallback((event) => {
+    const { width } = event.nativeEvent.layout;
+    setBreakpoint(getContainerBreakpoint(width));
+  }, []);
+  return { ref, breakpoint, onLayout };
+}
+
+// src/useScrollHandler.ts
+var reanimated = null;
+function loadReanimated() {
+  if (reanimated) return reanimated;
+  try {
+    reanimated = __require("react-native-reanimated");
+    return reanimated;
+  } catch {
+    throw new Error(
+      "[reactnatively-hooks] useScrollHandler requires react-native-reanimated >= 3.6.0. Install it with: npx expo install react-native-reanimated"
+    );
+  }
+}
+function useScrollHandler() {
+  const rn = loadReanimated();
+  const { useSharedValue, useAnimatedScrollHandler } = rn;
+  const scrollY = useSharedValue(0);
+  const scrollDirection = useSharedValue("down");
+  const scrollHandler = useAnimatedScrollHandler({
+    onScroll(event) {
+      "worklet";
+      const y = event.contentOffset.y;
+      if (y > scrollY.value) {
+        scrollDirection.value = "down";
+      } else if (y < scrollY.value) {
+        scrollDirection.value = "up";
+      }
+      scrollY.value = y;
+    }
+  });
+  return { scrollHandler, scrollY, scrollDirection };
+}
+
+exports.useAccessibility = useAccessibility;
+exports.useContainerQuery = useContainerQuery;
+exports.useContainerQueryFull = useContainerQueryFull;
+exports.useControllable = useControllable;
+exports.useDebounce = useDebounce;
+exports.useDimensions = useDimensions;
+exports.useDisclosure = useDisclosure;
+exports.useHaptic = useHaptic;
+exports.useId = useId2;
+exports.useKeyboard = useKeyboard;
+exports.usePrevious = usePrevious;
+exports.useScrollHandler = useScrollHandler;
+exports.useThrottle = useThrottle;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useControllable.ts","../src/useDisclosure.ts","../src/useId.ts","../src/usePrevious.ts","../src/useDebounce.ts","../src/useThrottle.ts","../src/useKeyboard.ts","../src/useDimensions.ts","../src/useAccessibility.ts","../src/useHaptic.ts","../src/useContainerQuery.ts","../src/useScrollHandler.ts"],"names":["useState","useRef","useCallback","useId","React","useEffect","Animated","Platform","Keyboard","useWindowDimensions","useMemo","AccessibilityInfo"],"mappings":"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","file":"index.js","sourcesContent":["import { useState, useCallback, useRef } from 'react';\n\nexport interface UseControllableOptions<T> {\n  /** The controlled value. When provided the hook operates in controlled mode. */\n  value?: T;\n  /** The default value for uncontrolled mode. */\n  defaultValue?: T;\n  /** Called when the value changes in uncontrolled mode. */\n  onChange?: (value: T) => void;\n}\n\n/**\n * Bridges controlled and uncontrolled component patterns.\n * Returns [resolvedValue, setValue] — handles both controlled and uncontrolled.\n */\nexport function useControllable<T>({\n  value,\n  defaultValue,\n  onChange,\n}: UseControllableOptions<T>): [T | undefined, (next: T) => void] {\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState<T | undefined>(defaultValue);\n\n  // Keep a stable ref to onChange to avoid re-creating setValue\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) {\n        setInternalValue(next);\n      }\n      onChangeRef.current?.(next);\n    },\n    [isControlled],\n  );\n\n  return [isControlled ? value : internalValue, setValue];\n}\n","import { useCallback } from 'react';\nimport { useControllable } from './useControllable';\n\nexport interface UseDisclosureOptions {\n  /** Initial open state for uncontrolled mode. */\n  defaultIsOpen?: boolean;\n  /** Controlled open state. */\n  isOpen?: boolean;\n  /** Called when the open state changes in controlled mode. */\n  onChange?: (isOpen: boolean) => void;\n}\n\nexport interface UseDisclosureReturn {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  onToggle: () => void;\n}\n\n/**\n * Manages open/close/toggle state for modals, drawers, menus, etc.\n * Supports both controlled (external isOpen + onChange) and uncontrolled modes.\n */\nexport function useDisclosure(options: UseDisclosureOptions = {}): UseDisclosureReturn {\n  const { defaultIsOpen = false, isOpen: controlledIsOpen, onChange } = options;\n\n  const [isOpen, setIsOpen] = useControllable<boolean>({\n    value: controlledIsOpen,\n    defaultValue: defaultIsOpen,\n    onChange,\n  });\n\n  const resolvedIsOpen = isOpen ?? false;\n\n  const onOpen = useCallback(() => {\n    setIsOpen(true);\n  }, [setIsOpen]);\n\n  const onClose = useCallback(() => {\n    setIsOpen(false);\n  }, [setIsOpen]);\n\n  const onToggle = useCallback(() => {\n    setIsOpen(!resolvedIsOpen);\n  }, [setIsOpen, resolvedIsOpen]);\n\n  return { isOpen: resolvedIsOpen, onOpen, onClose, onToggle };\n}\n","import * as React from 'react';\n\nlet counter = 0;\n\nfunction generateId(prefix: string): string {\n  counter += 1;\n  return `${prefix}-${counter}`;\n}\n\n/**\n * Returns a stable unique ID suitable for accessibility label pairing (aria-labelledby, etc.).\n * Uses React.useId() in React 18+ and falls back to a module-level counter otherwise.\n */\nexport function useId(prefix: string = 'rn'): string {\n  // React 18+ provides useId natively\n  if (typeof (React as { useId?: () => string }).useId === 'function') {\n    // eslint-disable-next-line react-hooks/rules-of-hooks\n    const id = (React as { useId: () => string }).useId();\n    return `${prefix}${id}`;\n  }\n\n  // Fallback: stable counter-based ID (not SSR-safe, but RN has no SSR)\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const idRef = React.useRef<string | null>(null);\n  if (idRef.current === null) {\n    idRef.current = generateId(prefix);\n  }\n  return idRef.current;\n}\n","import { useRef, useEffect } from 'react';\n\n/**\n * Returns the value from the previous render.\n * On the first render, returns `undefined`.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T | undefined>(undefined);\n\n  useEffect(() => {\n    ref.current = value;\n  });\n\n  return ref.current;\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Debounces a value by the given delay (in milliseconds).\n * The returned value will only update after the input value\n * has stopped changing for `delay` ms.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n\n    return () => {\n      clearTimeout(timer);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n}\n","import { useCallback, useRef } from 'react';\n\n/**\n * Returns a throttled version of the provided callback.\n * The callback will fire at most once per `delay` ms.\n * Subsequent calls within the delay window are ignored.\n * The returned function is stable across renders.\n */\nexport function useThrottle<T extends (...args: Parameters<T>) => ReturnType<T>>(\n  fn: T,\n  delay: number,\n): T {\n  const lastCallRef = useRef<number>(0);\n  const fnRef = useRef<T>(fn);\n  fnRef.current = fn;\n\n  return useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const now = Date.now();\n      if (now - lastCallRef.current >= delay) {\n        lastCallRef.current = now;\n        return fnRef.current(...args);\n      }\n      return undefined;\n    },\n    [delay],\n  ) as T;\n}\n","import { useState, useEffect, useRef } from 'react';\nimport { Keyboard, Animated, Platform } from 'react-native';\nimport type { KeyboardEvent } from 'react-native';\n\nexport interface KeyboardState {\n  /** Whether the keyboard is currently visible. */\n  isVisible: boolean;\n  /** Current keyboard height in logical pixels. */\n  height: number;\n  /** Animated.Value tracking keyboard height — animates in sync with the keyboard. */\n  keyboardHeight: Animated.Value;\n}\n\n/**\n * Tracks keyboard visibility and height.\n * Uses React Native's built-in Keyboard API and Animated for smooth transitions.\n * On web, keyboard events are not available — isVisible and height remain at defaults.\n */\nexport function useKeyboard(): KeyboardState {\n  const [isVisible, setIsVisible] = useState(false);\n  const [height, setHeight] = useState(0);\n  const keyboardHeight = useRef(new Animated.Value(0)).current;\n\n  useEffect(() => {\n    // Web does not support Keyboard events in RN\n    if (Platform.OS === 'web') return;\n\n    function handleShow(event: KeyboardEvent) {\n      const keyHeight = event.endCoordinates.height;\n      setIsVisible(true);\n      setHeight(keyHeight);\n      Animated.timing(keyboardHeight, {\n        toValue: keyHeight,\n        duration: event.duration ?? 250,\n        useNativeDriver: false,\n      }).start();\n    }\n\n    function handleHide(event: KeyboardEvent) {\n      setIsVisible(false);\n      setHeight(0);\n      Animated.timing(keyboardHeight, {\n        toValue: 0,\n        duration: event.duration ?? 200,\n        useNativeDriver: false,\n      }).start();\n    }\n\n    // iOS uses keyboardWillShow/Hide for smooth animation;\n    // Android uses keyboardDidShow/Hide.\n    const showEvent =\n      Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow';\n    const hideEvent =\n      Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide';\n\n    const showSub = Keyboard.addListener(showEvent, handleShow);\n    const hideSub = Keyboard.addListener(hideEvent, handleHide);\n\n    return () => {\n      showSub.remove();\n      hideSub.remove();\n    };\n  }, [keyboardHeight]);\n\n  return { isVisible, height, keyboardHeight };\n}\n","import { useMemo } from 'react';\nimport { useWindowDimensions } from 'react-native';\n\nexport type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n\nexport interface DimensionsState {\n  width: number;\n  height: number;\n  scale: number;\n  fontScale: number;\n  /** Current breakpoint based on screen width. */\n  breakpoint: Breakpoint;\n}\n\nfunction getBreakpoint(width: number): Breakpoint {\n  if (width < 480) return 'xs';\n  if (width < 768) return 'sm';\n  if (width < 1024) return 'md';\n  if (width < 1280) return 'lg';\n  return 'xl';\n}\n\n/**\n * Returns live window dimensions and a responsive breakpoint derived from width.\n * Breakpoints: xs (<480), sm (<768), md (<1024), lg (<1280), xl (>=1280).\n * Re-renders automatically when the screen size changes (rotation, resize).\n */\nexport function useDimensions(): DimensionsState {\n  const { width, height, scale, fontScale } = useWindowDimensions();\n\n  const breakpoint = useMemo(() => getBreakpoint(width), [width]);\n\n  return { width, height, scale, fontScale, breakpoint };\n}\n","import { useState, useEffect } from 'react';\nimport { AccessibilityInfo, Platform } from 'react-native';\n\nexport interface AccessibilityState {\n  /** Whether the user has requested reduced motion. */\n  isReducedMotion: boolean;\n  /** Whether a screen reader (VoiceOver / TalkBack) is active. */\n  isScreenReader: boolean;\n  /** Whether bold text is enabled (iOS only; false on Android/Web). */\n  isBoldText: boolean;\n  /** Whether grayscale mode is enabled (iOS only; false on Android/Web). */\n  isGrayscale: boolean;\n  /** Whether colour inversion is enabled (iOS only; false on Android/Web). */\n  isInvertColors: boolean;\n}\n\nconst defaults: AccessibilityState = {\n  isReducedMotion: false,\n  isScreenReader: false,\n  isBoldText: false,\n  isGrayscale: false,\n  isInvertColors: false,\n};\n\n/**\n * Subscribes to AccessibilityInfo and returns live accessibility flags.\n * Handles graceful degradation: iOS-only flags always return false on Android/Web.\n */\nexport function useAccessibility(): AccessibilityState {\n  const [state, setState] = useState<AccessibilityState>(defaults);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function init() {\n      const [\n        isReducedMotion,\n        isScreenReader,\n        isBoldText,\n        isGrayscale,\n        isInvertColors,\n      ] = await Promise.all([\n        AccessibilityInfo.isReduceMotionEnabled(),\n        AccessibilityInfo.isScreenReaderEnabled(),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isBoldTextEnabled()\n          : Promise.resolve(false),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isGrayscaleEnabled()\n          : Promise.resolve(false),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isInvertColorsEnabled()\n          : Promise.resolve(false),\n      ]);\n\n      if (!cancelled) {\n        setState({ isReducedMotion, isScreenReader, isBoldText, isGrayscale, isInvertColors });\n      }\n    }\n\n    void init();\n\n    const reduceMotionSub = AccessibilityInfo.addEventListener(\n      'reduceMotionChanged',\n      (isReducedMotion) => setState((prev) => ({ ...prev, isReducedMotion })),\n    );\n\n    const screenReaderSub = AccessibilityInfo.addEventListener(\n      'screenReaderChanged',\n      (isScreenReader) => setState((prev) => ({ ...prev, isScreenReader })),\n    );\n\n    // iOS-only events — addEventListener returns undefined for unknown events on Android\n    const boldTextSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('boldTextChanged', (isBoldText) =>\n            setState((prev) => ({ ...prev, isBoldText })),\n          )\n        : null;\n\n    const grayscaleSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('grayscaleChanged', (isGrayscale) =>\n            setState((prev) => ({ ...prev, isGrayscale })),\n          )\n        : null;\n\n    const invertColorsSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('invertColorsChanged', (isInvertColors) =>\n            setState((prev) => ({ ...prev, isInvertColors })),\n          )\n        : null;\n\n    return () => {\n      cancelled = true;\n      reduceMotionSub.remove();\n      screenReaderSub.remove();\n      boldTextSub?.remove();\n      grayscaleSub?.remove();\n      invertColorsSub?.remove();\n    };\n  }, []);\n\n  return state;\n}\n","import { useCallback } from 'react';\nimport { Platform } from 'react-native';\n\nexport type HapticImpactStyle = 'light' | 'medium' | 'heavy';\nexport type HapticNotificationType = 'success' | 'warning' | 'error';\n\nexport interface UseHapticReturn {\n  /** Trigger an impact haptic feedback. */\n  impact: (style?: HapticImpactStyle) => Promise<void>;\n  /** Trigger a notification haptic feedback. */\n  notification: (type?: HapticNotificationType) => Promise<void>;\n  /** Trigger a selection haptic feedback. */\n  selection: () => Promise<void>;\n}\n\n// Lazily resolved expo-haptics module (null when unavailable)\nlet expoHaptics: ExpoHapticsModule | null | undefined = undefined;\n\ninterface ExpoHapticsModule {\n  ImpactFeedbackStyle: {\n    Light: string;\n    Medium: string;\n    Heavy: string;\n  };\n  NotificationFeedbackType: {\n    Success: string;\n    Warning: string;\n    Error: string;\n  };\n  impactAsync: (style: string) => Promise<void>;\n  notificationAsync: (type: string) => Promise<void>;\n  selectionAsync: () => Promise<void>;\n}\n\nfunction loadExpoHaptics(): ExpoHapticsModule | null {\n  if (expoHaptics !== undefined) return expoHaptics;\n  try {\n    // Dynamic require so bundlers can tree-shake when expo-haptics is absent\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const mod = require('expo-haptics') as ExpoHapticsModule;\n    expoHaptics = mod;\n    return mod;\n  } catch {\n    expoHaptics = null;\n    return null;\n  }\n}\n\nconst noop = () => Promise.resolve();\n\n/**\n * Haptic feedback wrapper.\n * Uses expo-haptics when available; falls back to no-ops gracefully.\n * Haptics are automatically skipped on web where they are unsupported.\n */\nexport function useHaptic(): UseHapticReturn {\n  const impact = useCallback(async (style: HapticImpactStyle = 'medium'): Promise<void> => {\n    if (Platform.OS === 'web') return;\n    const haptics = loadExpoHaptics();\n    if (!haptics) return;\n\n    const styleMap: Record<HapticImpactStyle, string> = {\n      light: haptics.ImpactFeedbackStyle.Light,\n      medium: haptics.ImpactFeedbackStyle.Medium,\n      heavy: haptics.ImpactFeedbackStyle.Heavy,\n    };\n    await haptics.impactAsync(styleMap[style]);\n  }, []);\n\n  const notification = useCallback(\n    async (type: HapticNotificationType = 'success'): Promise<void> => {\n      if (Platform.OS === 'web') return;\n      const haptics = loadExpoHaptics();\n      if (!haptics) return;\n\n      const typeMap: Record<HapticNotificationType, string> = {\n        success: haptics.NotificationFeedbackType.Success,\n        warning: haptics.NotificationFeedbackType.Warning,\n        error: haptics.NotificationFeedbackType.Error,\n      };\n      await haptics.notificationAsync(typeMap[type]);\n    },\n    [],\n  );\n\n  const selection = useCallback(async (): Promise<void> => {\n    if (Platform.OS === 'web') return;\n    const haptics = loadExpoHaptics();\n    if (!haptics) return;\n    await haptics.selectionAsync();\n  }, []);\n\n  if (Platform.OS === 'web') {\n    return { impact: noop, notification: noop, selection: noop };\n  }\n\n  return { impact, notification, selection };\n}\n","import { useState, useCallback } from 'react';\nimport type { View, LayoutChangeEvent } from 'react-native';\n\nexport type ContainerBreakpoint = 'xs' | 'sm' | 'md' | 'lg';\n\nfunction getContainerBreakpoint(width: number): ContainerBreakpoint {\n  if (width < 320) return 'xs';\n  if (width < 480) return 'sm';\n  if (width < 640) return 'md';\n  return 'lg';\n}\n\n/**\n * Container-based responsive breakpoints derived from the component's own width,\n * not the screen width. Uses `onLayout` to measure the container.\n *\n * Container breakpoints: xs (<320), sm (<480), md (<640), lg (>=640).\n *\n * @returns [ref, breakpoint] — attach `ref` to the View you want to measure.\n *\n * @example\n * const [ref, bp] = useContainerQuery();\n * return <View ref={ref} onLayout={...}>...</View>;\n */\nexport function useContainerQuery(): [\n  ref: (node: View | null) => void,\n  breakpoint: ContainerBreakpoint,\n] {\n  const [breakpoint, setBreakpoint] = useState<ContainerBreakpoint>('xs');\n\n  // We use an onLayout callback rather than a ref callback with a MutationObserver\n  // because React Native measures happen through the layout event system.\n  // The ref here is returned as a convenience so consumers can attach it, but the\n  // actual measurement is done via the onLayout prop that we also expose.\n  const ref = useCallback((_node: View | null) => {\n    // The ref callback is a no-op — measurement happens via onLayout below.\n  }, []);\n\n  const onLayout = useCallback((event: LayoutChangeEvent) => {\n    const { width } = event.nativeEvent.layout;\n    setBreakpoint(getContainerBreakpoint(width));\n  }, []);\n\n  // We augment the returned tuple with an onLayout so callers can use it.\n  // Return value is [ref, breakpoint, onLayout] for ergonomics.\n  // Keep the public API as [ref, breakpoint] per the spec, but attach onLayout\n  // to the ref callback so callers that spread the returned ref also get measurement.\n  // Actually — return three values and document properly.\n  return Object.assign([ref, breakpoint] as [typeof ref, ContainerBreakpoint], { onLayout });\n}\n\n/**\n * Extended return type that includes an `onLayout` handler for measurement.\n * Prefer this form for explicit usage:\n *\n * @example\n * const { ref, breakpoint, onLayout } = useContainerQueryFull();\n * return <View ref={ref} onLayout={onLayout}>...</View>;\n */\nexport interface ContainerQueryResult {\n  ref: (node: View | null) => void;\n  breakpoint: ContainerBreakpoint;\n  onLayout: (event: LayoutChangeEvent) => void;\n}\n\n/**\n * Object-API variant of `useContainerQuery` — easier to use when you need\n * all three values without destructuring a tuple.\n */\nexport function useContainerQueryFull(): ContainerQueryResult {\n  const [breakpoint, setBreakpoint] = useState<ContainerBreakpoint>('xs');\n\n  const ref = useCallback((_node: View | null) => {\n    // Measurement is driven by onLayout, not the ref callback.\n  }, []);\n\n  const onLayout = useCallback((event: LayoutChangeEvent) => {\n    const { width } = event.nativeEvent.layout;\n    setBreakpoint(getContainerBreakpoint(width));\n  }, []);\n\n  return { ref, breakpoint, onLayout };\n}\n","/**\n * useScrollHandler — scroll-driven animation values via Reanimated.\n *\n * This hook requires `react-native-reanimated` >= 3.6.0 as a peer dependency.\n * It is guarded by a try/catch import so that the rest of the package remains\n * importable when Reanimated is not installed (it will throw a clear error only\n * when useScrollHandler itself is called).\n */\n\n// We import types only here so TypeScript can check the rest of this file even\n// when the peer is absent at runtime. The actual module is loaded lazily.\nimport type {\n  SharedValue,\n  ScrollHandlerProcessed,\n} from 'react-native-reanimated';\n\nexport interface ScrollHandlerResult {\n  /** Pass this to the `onScroll` prop of Reanimated.ScrollView / FlatList. */\n  scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;\n  /** Shared value tracking current vertical scroll offset in pixels. */\n  scrollY: SharedValue<number>;\n  /** Shared value tracking scroll direction — updates when direction changes. */\n  scrollDirection: SharedValue<'up' | 'down'>;\n}\n\nlet reanimated: typeof import('react-native-reanimated') | null = null;\n\nfunction loadReanimated(): typeof import('react-native-reanimated') {\n  if (reanimated) return reanimated;\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    reanimated = require('react-native-reanimated') as typeof import('react-native-reanimated');\n    return reanimated;\n  } catch {\n    throw new Error(\n      '[reactnatively-hooks] useScrollHandler requires react-native-reanimated >= 3.6.0. ' +\n        'Install it with: npx expo install react-native-reanimated',\n    );\n  }\n}\n\n/**\n * Returns scroll-driven Reanimated shared values and a scroll handler.\n *\n * @example\n * const { scrollHandler, scrollY, scrollDirection } = useScrollHandler();\n * return (\n *   <Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>\n *     ...\n *   </Animated.ScrollView>\n * );\n */\nexport function useScrollHandler(): ScrollHandlerResult {\n  const rn = loadReanimated();\n  const { useSharedValue, useAnimatedScrollHandler } = rn;\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollY = useSharedValue<number>(0);\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollDirection = useSharedValue<'up' | 'down'>('down');\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollHandler = useAnimatedScrollHandler({\n    onScroll(event) {\n      'worklet';\n      const y = event.contentOffset.y;\n      if (y > scrollY.value) {\n        scrollDirection.value = 'down';\n      } else if (y < scrollY.value) {\n        scrollDirection.value = 'up';\n      }\n      scrollY.value = y;\n    },\n  });\n\n  return { scrollHandler, scrollY, scrollDirection };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,322 @@
+import * as React from 'react';
+import { useState, useRef, useCallback, useEffect, useMemo } from 'react';
+import { Animated, Platform, Keyboard, useWindowDimensions, AccessibilityInfo } from 'react-native';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+function useControllable({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const isControlled = value !== void 0;
+  const [internalValue, setInternalValue] = useState(defaultValue);
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const setValue = useCallback(
+    (next) => {
+      if (!isControlled) {
+        setInternalValue(next);
+      }
+      onChangeRef.current?.(next);
+    },
+    [isControlled]
+  );
+  return [isControlled ? value : internalValue, setValue];
+}
+function useDisclosure(options = {}) {
+  const { defaultIsOpen = false, isOpen: controlledIsOpen, onChange } = options;
+  const [isOpen, setIsOpen] = useControllable({
+    value: controlledIsOpen,
+    defaultValue: defaultIsOpen,
+    onChange
+  });
+  const resolvedIsOpen = isOpen ?? false;
+  const onOpen = useCallback(() => {
+    setIsOpen(true);
+  }, [setIsOpen]);
+  const onClose = useCallback(() => {
+    setIsOpen(false);
+  }, [setIsOpen]);
+  const onToggle = useCallback(() => {
+    setIsOpen(!resolvedIsOpen);
+  }, [setIsOpen, resolvedIsOpen]);
+  return { isOpen: resolvedIsOpen, onOpen, onClose, onToggle };
+}
+var counter = 0;
+function generateId(prefix) {
+  counter += 1;
+  return `${prefix}-${counter}`;
+}
+function useId2(prefix = "rn") {
+  if (typeof React.useId === "function") {
+    const id = React.useId();
+    return `${prefix}${id}`;
+  }
+  const idRef = React.useRef(null);
+  if (idRef.current === null) {
+    idRef.current = generateId(prefix);
+  }
+  return idRef.current;
+}
+function usePrevious(value) {
+  const ref = useRef(void 0);
+  useEffect(() => {
+    ref.current = value;
+  });
+  return ref.current;
+}
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(timer);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+function useThrottle(fn, delay) {
+  const lastCallRef = useRef(0);
+  const fnRef = useRef(fn);
+  fnRef.current = fn;
+  return useCallback(
+    (...args) => {
+      const now = Date.now();
+      if (now - lastCallRef.current >= delay) {
+        lastCallRef.current = now;
+        return fnRef.current(...args);
+      }
+      return void 0;
+    },
+    [delay]
+  );
+}
+function useKeyboard() {
+  const [isVisible, setIsVisible] = useState(false);
+  const [height, setHeight] = useState(0);
+  const keyboardHeight = useRef(new Animated.Value(0)).current;
+  useEffect(() => {
+    if (Platform.OS === "web") return;
+    function handleShow(event) {
+      const keyHeight = event.endCoordinates.height;
+      setIsVisible(true);
+      setHeight(keyHeight);
+      Animated.timing(keyboardHeight, {
+        toValue: keyHeight,
+        duration: event.duration ?? 250,
+        useNativeDriver: false
+      }).start();
+    }
+    function handleHide(event) {
+      setIsVisible(false);
+      setHeight(0);
+      Animated.timing(keyboardHeight, {
+        toValue: 0,
+        duration: event.duration ?? 200,
+        useNativeDriver: false
+      }).start();
+    }
+    const showEvent = Platform.OS === "ios" ? "keyboardWillShow" : "keyboardDidShow";
+    const hideEvent = Platform.OS === "ios" ? "keyboardWillHide" : "keyboardDidHide";
+    const showSub = Keyboard.addListener(showEvent, handleShow);
+    const hideSub = Keyboard.addListener(hideEvent, handleHide);
+    return () => {
+      showSub.remove();
+      hideSub.remove();
+    };
+  }, [keyboardHeight]);
+  return { isVisible, height, keyboardHeight };
+}
+function getBreakpoint(width) {
+  if (width < 480) return "xs";
+  if (width < 768) return "sm";
+  if (width < 1024) return "md";
+  if (width < 1280) return "lg";
+  return "xl";
+}
+function useDimensions() {
+  const { width, height, scale, fontScale } = useWindowDimensions();
+  const breakpoint = useMemo(() => getBreakpoint(width), [width]);
+  return { width, height, scale, fontScale, breakpoint };
+}
+var defaults = {
+  isReducedMotion: false,
+  isScreenReader: false,
+  isBoldText: false,
+  isGrayscale: false,
+  isInvertColors: false
+};
+function useAccessibility() {
+  const [state, setState] = useState(defaults);
+  useEffect(() => {
+    let cancelled = false;
+    async function init() {
+      const [
+        isReducedMotion,
+        isScreenReader,
+        isBoldText,
+        isGrayscale,
+        isInvertColors
+      ] = await Promise.all([
+        AccessibilityInfo.isReduceMotionEnabled(),
+        AccessibilityInfo.isScreenReaderEnabled(),
+        Platform.OS === "ios" ? AccessibilityInfo.isBoldTextEnabled() : Promise.resolve(false),
+        Platform.OS === "ios" ? AccessibilityInfo.isGrayscaleEnabled() : Promise.resolve(false),
+        Platform.OS === "ios" ? AccessibilityInfo.isInvertColorsEnabled() : Promise.resolve(false)
+      ]);
+      if (!cancelled) {
+        setState({ isReducedMotion, isScreenReader, isBoldText, isGrayscale, isInvertColors });
+      }
+    }
+    void init();
+    const reduceMotionSub = AccessibilityInfo.addEventListener(
+      "reduceMotionChanged",
+      (isReducedMotion) => setState((prev) => ({ ...prev, isReducedMotion }))
+    );
+    const screenReaderSub = AccessibilityInfo.addEventListener(
+      "screenReaderChanged",
+      (isScreenReader) => setState((prev) => ({ ...prev, isScreenReader }))
+    );
+    const boldTextSub = Platform.OS === "ios" ? AccessibilityInfo.addEventListener(
+      "boldTextChanged",
+      (isBoldText) => setState((prev) => ({ ...prev, isBoldText }))
+    ) : null;
+    const grayscaleSub = Platform.OS === "ios" ? AccessibilityInfo.addEventListener(
+      "grayscaleChanged",
+      (isGrayscale) => setState((prev) => ({ ...prev, isGrayscale }))
+    ) : null;
+    const invertColorsSub = Platform.OS === "ios" ? AccessibilityInfo.addEventListener(
+      "invertColorsChanged",
+      (isInvertColors) => setState((prev) => ({ ...prev, isInvertColors }))
+    ) : null;
+    return () => {
+      cancelled = true;
+      reduceMotionSub.remove();
+      screenReaderSub.remove();
+      boldTextSub?.remove();
+      grayscaleSub?.remove();
+      invertColorsSub?.remove();
+    };
+  }, []);
+  return state;
+}
+var expoHaptics = void 0;
+function loadExpoHaptics() {
+  if (expoHaptics !== void 0) return expoHaptics;
+  try {
+    const mod = __require("expo-haptics");
+    expoHaptics = mod;
+    return mod;
+  } catch {
+    expoHaptics = null;
+    return null;
+  }
+}
+var noop = () => Promise.resolve();
+function useHaptic() {
+  const impact = useCallback(async (style = "medium") => {
+    if (Platform.OS === "web") return;
+    const haptics = loadExpoHaptics();
+    if (!haptics) return;
+    const styleMap = {
+      light: haptics.ImpactFeedbackStyle.Light,
+      medium: haptics.ImpactFeedbackStyle.Medium,
+      heavy: haptics.ImpactFeedbackStyle.Heavy
+    };
+    await haptics.impactAsync(styleMap[style]);
+  }, []);
+  const notification = useCallback(
+    async (type = "success") => {
+      if (Platform.OS === "web") return;
+      const haptics = loadExpoHaptics();
+      if (!haptics) return;
+      const typeMap = {
+        success: haptics.NotificationFeedbackType.Success,
+        warning: haptics.NotificationFeedbackType.Warning,
+        error: haptics.NotificationFeedbackType.Error
+      };
+      await haptics.notificationAsync(typeMap[type]);
+    },
+    []
+  );
+  const selection = useCallback(async () => {
+    if (Platform.OS === "web") return;
+    const haptics = loadExpoHaptics();
+    if (!haptics) return;
+    await haptics.selectionAsync();
+  }, []);
+  if (Platform.OS === "web") {
+    return { impact: noop, notification: noop, selection: noop };
+  }
+  return { impact, notification, selection };
+}
+function getContainerBreakpoint(width) {
+  if (width < 320) return "xs";
+  if (width < 480) return "sm";
+  if (width < 640) return "md";
+  return "lg";
+}
+function useContainerQuery() {
+  const [breakpoint, setBreakpoint] = useState("xs");
+  const ref = useCallback((_node) => {
+  }, []);
+  const onLayout = useCallback((event) => {
+    const { width } = event.nativeEvent.layout;
+    setBreakpoint(getContainerBreakpoint(width));
+  }, []);
+  return Object.assign([ref, breakpoint], { onLayout });
+}
+function useContainerQueryFull() {
+  const [breakpoint, setBreakpoint] = useState("xs");
+  const ref = useCallback((_node) => {
+  }, []);
+  const onLayout = useCallback((event) => {
+    const { width } = event.nativeEvent.layout;
+    setBreakpoint(getContainerBreakpoint(width));
+  }, []);
+  return { ref, breakpoint, onLayout };
+}
+
+// src/useScrollHandler.ts
+var reanimated = null;
+function loadReanimated() {
+  if (reanimated) return reanimated;
+  try {
+    reanimated = __require("react-native-reanimated");
+    return reanimated;
+  } catch {
+    throw new Error(
+      "[reactnatively-hooks] useScrollHandler requires react-native-reanimated >= 3.6.0. Install it with: npx expo install react-native-reanimated"
+    );
+  }
+}
+function useScrollHandler() {
+  const rn = loadReanimated();
+  const { useSharedValue, useAnimatedScrollHandler } = rn;
+  const scrollY = useSharedValue(0);
+  const scrollDirection = useSharedValue("down");
+  const scrollHandler = useAnimatedScrollHandler({
+    onScroll(event) {
+      "worklet";
+      const y = event.contentOffset.y;
+      if (y > scrollY.value) {
+        scrollDirection.value = "down";
+      } else if (y < scrollY.value) {
+        scrollDirection.value = "up";
+      }
+      scrollY.value = y;
+    }
+  });
+  return { scrollHandler, scrollY, scrollDirection };
+}
+
+export { useAccessibility, useContainerQuery, useContainerQueryFull, useControllable, useDebounce, useDimensions, useDisclosure, useHaptic, useId2 as useId, useKeyboard, usePrevious, useScrollHandler, useThrottle };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useControllable.ts","../src/useDisclosure.ts","../src/useId.ts","../src/usePrevious.ts","../src/useDebounce.ts","../src/useThrottle.ts","../src/useKeyboard.ts","../src/useDimensions.ts","../src/useAccessibility.ts","../src/useHaptic.ts","../src/useContainerQuery.ts","../src/useScrollHandler.ts"],"names":["useCallback","useId","useRef","useState","useEffect","Platform"],"mappings":"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","file":"index.mjs","sourcesContent":["import { useState, useCallback, useRef } from 'react';\n\nexport interface UseControllableOptions<T> {\n  /** The controlled value. When provided the hook operates in controlled mode. */\n  value?: T;\n  /** The default value for uncontrolled mode. */\n  defaultValue?: T;\n  /** Called when the value changes in uncontrolled mode. */\n  onChange?: (value: T) => void;\n}\n\n/**\n * Bridges controlled and uncontrolled component patterns.\n * Returns [resolvedValue, setValue] — handles both controlled and uncontrolled.\n */\nexport function useControllable<T>({\n  value,\n  defaultValue,\n  onChange,\n}: UseControllableOptions<T>): [T | undefined, (next: T) => void] {\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState<T | undefined>(defaultValue);\n\n  // Keep a stable ref to onChange to avoid re-creating setValue\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) {\n        setInternalValue(next);\n      }\n      onChangeRef.current?.(next);\n    },\n    [isControlled],\n  );\n\n  return [isControlled ? value : internalValue, setValue];\n}\n","import { useCallback } from 'react';\nimport { useControllable } from './useControllable';\n\nexport interface UseDisclosureOptions {\n  /** Initial open state for uncontrolled mode. */\n  defaultIsOpen?: boolean;\n  /** Controlled open state. */\n  isOpen?: boolean;\n  /** Called when the open state changes in controlled mode. */\n  onChange?: (isOpen: boolean) => void;\n}\n\nexport interface UseDisclosureReturn {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  onToggle: () => void;\n}\n\n/**\n * Manages open/close/toggle state for modals, drawers, menus, etc.\n * Supports both controlled (external isOpen + onChange) and uncontrolled modes.\n */\nexport function useDisclosure(options: UseDisclosureOptions = {}): UseDisclosureReturn {\n  const { defaultIsOpen = false, isOpen: controlledIsOpen, onChange } = options;\n\n  const [isOpen, setIsOpen] = useControllable<boolean>({\n    value: controlledIsOpen,\n    defaultValue: defaultIsOpen,\n    onChange,\n  });\n\n  const resolvedIsOpen = isOpen ?? false;\n\n  const onOpen = useCallback(() => {\n    setIsOpen(true);\n  }, [setIsOpen]);\n\n  const onClose = useCallback(() => {\n    setIsOpen(false);\n  }, [setIsOpen]);\n\n  const onToggle = useCallback(() => {\n    setIsOpen(!resolvedIsOpen);\n  }, [setIsOpen, resolvedIsOpen]);\n\n  return { isOpen: resolvedIsOpen, onOpen, onClose, onToggle };\n}\n","import * as React from 'react';\n\nlet counter = 0;\n\nfunction generateId(prefix: string): string {\n  counter += 1;\n  return `${prefix}-${counter}`;\n}\n\n/**\n * Returns a stable unique ID suitable for accessibility label pairing (aria-labelledby, etc.).\n * Uses React.useId() in React 18+ and falls back to a module-level counter otherwise.\n */\nexport function useId(prefix: string = 'rn'): string {\n  // React 18+ provides useId natively\n  if (typeof (React as { useId?: () => string }).useId === 'function') {\n    // eslint-disable-next-line react-hooks/rules-of-hooks\n    const id = (React as { useId: () => string }).useId();\n    return `${prefix}${id}`;\n  }\n\n  // Fallback: stable counter-based ID (not SSR-safe, but RN has no SSR)\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const idRef = React.useRef<string | null>(null);\n  if (idRef.current === null) {\n    idRef.current = generateId(prefix);\n  }\n  return idRef.current;\n}\n","import { useRef, useEffect } from 'react';\n\n/**\n * Returns the value from the previous render.\n * On the first render, returns `undefined`.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T | undefined>(undefined);\n\n  useEffect(() => {\n    ref.current = value;\n  });\n\n  return ref.current;\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Debounces a value by the given delay (in milliseconds).\n * The returned value will only update after the input value\n * has stopped changing for `delay` ms.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n\n    return () => {\n      clearTimeout(timer);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n}\n","import { useCallback, useRef } from 'react';\n\n/**\n * Returns a throttled version of the provided callback.\n * The callback will fire at most once per `delay` ms.\n * Subsequent calls within the delay window are ignored.\n * The returned function is stable across renders.\n */\nexport function useThrottle<T extends (...args: Parameters<T>) => ReturnType<T>>(\n  fn: T,\n  delay: number,\n): T {\n  const lastCallRef = useRef<number>(0);\n  const fnRef = useRef<T>(fn);\n  fnRef.current = fn;\n\n  return useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const now = Date.now();\n      if (now - lastCallRef.current >= delay) {\n        lastCallRef.current = now;\n        return fnRef.current(...args);\n      }\n      return undefined;\n    },\n    [delay],\n  ) as T;\n}\n","import { useState, useEffect, useRef } from 'react';\nimport { Keyboard, Animated, Platform } from 'react-native';\nimport type { KeyboardEvent } from 'react-native';\n\nexport interface KeyboardState {\n  /** Whether the keyboard is currently visible. */\n  isVisible: boolean;\n  /** Current keyboard height in logical pixels. */\n  height: number;\n  /** Animated.Value tracking keyboard height — animates in sync with the keyboard. */\n  keyboardHeight: Animated.Value;\n}\n\n/**\n * Tracks keyboard visibility and height.\n * Uses React Native's built-in Keyboard API and Animated for smooth transitions.\n * On web, keyboard events are not available — isVisible and height remain at defaults.\n */\nexport function useKeyboard(): KeyboardState {\n  const [isVisible, setIsVisible] = useState(false);\n  const [height, setHeight] = useState(0);\n  const keyboardHeight = useRef(new Animated.Value(0)).current;\n\n  useEffect(() => {\n    // Web does not support Keyboard events in RN\n    if (Platform.OS === 'web') return;\n\n    function handleShow(event: KeyboardEvent) {\n      const keyHeight = event.endCoordinates.height;\n      setIsVisible(true);\n      setHeight(keyHeight);\n      Animated.timing(keyboardHeight, {\n        toValue: keyHeight,\n        duration: event.duration ?? 250,\n        useNativeDriver: false,\n      }).start();\n    }\n\n    function handleHide(event: KeyboardEvent) {\n      setIsVisible(false);\n      setHeight(0);\n      Animated.timing(keyboardHeight, {\n        toValue: 0,\n        duration: event.duration ?? 200,\n        useNativeDriver: false,\n      }).start();\n    }\n\n    // iOS uses keyboardWillShow/Hide for smooth animation;\n    // Android uses keyboardDidShow/Hide.\n    const showEvent =\n      Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow';\n    const hideEvent =\n      Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide';\n\n    const showSub = Keyboard.addListener(showEvent, handleShow);\n    const hideSub = Keyboard.addListener(hideEvent, handleHide);\n\n    return () => {\n      showSub.remove();\n      hideSub.remove();\n    };\n  }, [keyboardHeight]);\n\n  return { isVisible, height, keyboardHeight };\n}\n","import { useMemo } from 'react';\nimport { useWindowDimensions } from 'react-native';\n\nexport type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n\nexport interface DimensionsState {\n  width: number;\n  height: number;\n  scale: number;\n  fontScale: number;\n  /** Current breakpoint based on screen width. */\n  breakpoint: Breakpoint;\n}\n\nfunction getBreakpoint(width: number): Breakpoint {\n  if (width < 480) return 'xs';\n  if (width < 768) return 'sm';\n  if (width < 1024) return 'md';\n  if (width < 1280) return 'lg';\n  return 'xl';\n}\n\n/**\n * Returns live window dimensions and a responsive breakpoint derived from width.\n * Breakpoints: xs (<480), sm (<768), md (<1024), lg (<1280), xl (>=1280).\n * Re-renders automatically when the screen size changes (rotation, resize).\n */\nexport function useDimensions(): DimensionsState {\n  const { width, height, scale, fontScale } = useWindowDimensions();\n\n  const breakpoint = useMemo(() => getBreakpoint(width), [width]);\n\n  return { width, height, scale, fontScale, breakpoint };\n}\n","import { useState, useEffect } from 'react';\nimport { AccessibilityInfo, Platform } from 'react-native';\n\nexport interface AccessibilityState {\n  /** Whether the user has requested reduced motion. */\n  isReducedMotion: boolean;\n  /** Whether a screen reader (VoiceOver / TalkBack) is active. */\n  isScreenReader: boolean;\n  /** Whether bold text is enabled (iOS only; false on Android/Web). */\n  isBoldText: boolean;\n  /** Whether grayscale mode is enabled (iOS only; false on Android/Web). */\n  isGrayscale: boolean;\n  /** Whether colour inversion is enabled (iOS only; false on Android/Web). */\n  isInvertColors: boolean;\n}\n\nconst defaults: AccessibilityState = {\n  isReducedMotion: false,\n  isScreenReader: false,\n  isBoldText: false,\n  isGrayscale: false,\n  isInvertColors: false,\n};\n\n/**\n * Subscribes to AccessibilityInfo and returns live accessibility flags.\n * Handles graceful degradation: iOS-only flags always return false on Android/Web.\n */\nexport function useAccessibility(): AccessibilityState {\n  const [state, setState] = useState<AccessibilityState>(defaults);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function init() {\n      const [\n        isReducedMotion,\n        isScreenReader,\n        isBoldText,\n        isGrayscale,\n        isInvertColors,\n      ] = await Promise.all([\n        AccessibilityInfo.isReduceMotionEnabled(),\n        AccessibilityInfo.isScreenReaderEnabled(),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isBoldTextEnabled()\n          : Promise.resolve(false),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isGrayscaleEnabled()\n          : Promise.resolve(false),\n        Platform.OS === 'ios'\n          ? AccessibilityInfo.isInvertColorsEnabled()\n          : Promise.resolve(false),\n      ]);\n\n      if (!cancelled) {\n        setState({ isReducedMotion, isScreenReader, isBoldText, isGrayscale, isInvertColors });\n      }\n    }\n\n    void init();\n\n    const reduceMotionSub = AccessibilityInfo.addEventListener(\n      'reduceMotionChanged',\n      (isReducedMotion) => setState((prev) => ({ ...prev, isReducedMotion })),\n    );\n\n    const screenReaderSub = AccessibilityInfo.addEventListener(\n      'screenReaderChanged',\n      (isScreenReader) => setState((prev) => ({ ...prev, isScreenReader })),\n    );\n\n    // iOS-only events — addEventListener returns undefined for unknown events on Android\n    const boldTextSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('boldTextChanged', (isBoldText) =>\n            setState((prev) => ({ ...prev, isBoldText })),\n          )\n        : null;\n\n    const grayscaleSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('grayscaleChanged', (isGrayscale) =>\n            setState((prev) => ({ ...prev, isGrayscale })),\n          )\n        : null;\n\n    const invertColorsSub =\n      Platform.OS === 'ios'\n        ? AccessibilityInfo.addEventListener('invertColorsChanged', (isInvertColors) =>\n            setState((prev) => ({ ...prev, isInvertColors })),\n          )\n        : null;\n\n    return () => {\n      cancelled = true;\n      reduceMotionSub.remove();\n      screenReaderSub.remove();\n      boldTextSub?.remove();\n      grayscaleSub?.remove();\n      invertColorsSub?.remove();\n    };\n  }, []);\n\n  return state;\n}\n","import { useCallback } from 'react';\nimport { Platform } from 'react-native';\n\nexport type HapticImpactStyle = 'light' | 'medium' | 'heavy';\nexport type HapticNotificationType = 'success' | 'warning' | 'error';\n\nexport interface UseHapticReturn {\n  /** Trigger an impact haptic feedback. */\n  impact: (style?: HapticImpactStyle) => Promise<void>;\n  /** Trigger a notification haptic feedback. */\n  notification: (type?: HapticNotificationType) => Promise<void>;\n  /** Trigger a selection haptic feedback. */\n  selection: () => Promise<void>;\n}\n\n// Lazily resolved expo-haptics module (null when unavailable)\nlet expoHaptics: ExpoHapticsModule | null | undefined = undefined;\n\ninterface ExpoHapticsModule {\n  ImpactFeedbackStyle: {\n    Light: string;\n    Medium: string;\n    Heavy: string;\n  };\n  NotificationFeedbackType: {\n    Success: string;\n    Warning: string;\n    Error: string;\n  };\n  impactAsync: (style: string) => Promise<void>;\n  notificationAsync: (type: string) => Promise<void>;\n  selectionAsync: () => Promise<void>;\n}\n\nfunction loadExpoHaptics(): ExpoHapticsModule | null {\n  if (expoHaptics !== undefined) return expoHaptics;\n  try {\n    // Dynamic require so bundlers can tree-shake when expo-haptics is absent\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const mod = require('expo-haptics') as ExpoHapticsModule;\n    expoHaptics = mod;\n    return mod;\n  } catch {\n    expoHaptics = null;\n    return null;\n  }\n}\n\nconst noop = () => Promise.resolve();\n\n/**\n * Haptic feedback wrapper.\n * Uses expo-haptics when available; falls back to no-ops gracefully.\n * Haptics are automatically skipped on web where they are unsupported.\n */\nexport function useHaptic(): UseHapticReturn {\n  const impact = useCallback(async (style: HapticImpactStyle = 'medium'): Promise<void> => {\n    if (Platform.OS === 'web') return;\n    const haptics = loadExpoHaptics();\n    if (!haptics) return;\n\n    const styleMap: Record<HapticImpactStyle, string> = {\n      light: haptics.ImpactFeedbackStyle.Light,\n      medium: haptics.ImpactFeedbackStyle.Medium,\n      heavy: haptics.ImpactFeedbackStyle.Heavy,\n    };\n    await haptics.impactAsync(styleMap[style]);\n  }, []);\n\n  const notification = useCallback(\n    async (type: HapticNotificationType = 'success'): Promise<void> => {\n      if (Platform.OS === 'web') return;\n      const haptics = loadExpoHaptics();\n      if (!haptics) return;\n\n      const typeMap: Record<HapticNotificationType, string> = {\n        success: haptics.NotificationFeedbackType.Success,\n        warning: haptics.NotificationFeedbackType.Warning,\n        error: haptics.NotificationFeedbackType.Error,\n      };\n      await haptics.notificationAsync(typeMap[type]);\n    },\n    [],\n  );\n\n  const selection = useCallback(async (): Promise<void> => {\n    if (Platform.OS === 'web') return;\n    const haptics = loadExpoHaptics();\n    if (!haptics) return;\n    await haptics.selectionAsync();\n  }, []);\n\n  if (Platform.OS === 'web') {\n    return { impact: noop, notification: noop, selection: noop };\n  }\n\n  return { impact, notification, selection };\n}\n","import { useState, useCallback } from 'react';\nimport type { View, LayoutChangeEvent } from 'react-native';\n\nexport type ContainerBreakpoint = 'xs' | 'sm' | 'md' | 'lg';\n\nfunction getContainerBreakpoint(width: number): ContainerBreakpoint {\n  if (width < 320) return 'xs';\n  if (width < 480) return 'sm';\n  if (width < 640) return 'md';\n  return 'lg';\n}\n\n/**\n * Container-based responsive breakpoints derived from the component's own width,\n * not the screen width. Uses `onLayout` to measure the container.\n *\n * Container breakpoints: xs (<320), sm (<480), md (<640), lg (>=640).\n *\n * @returns [ref, breakpoint] — attach `ref` to the View you want to measure.\n *\n * @example\n * const [ref, bp] = useContainerQuery();\n * return <View ref={ref} onLayout={...}>...</View>;\n */\nexport function useContainerQuery(): [\n  ref: (node: View | null) => void,\n  breakpoint: ContainerBreakpoint,\n] {\n  const [breakpoint, setBreakpoint] = useState<ContainerBreakpoint>('xs');\n\n  // We use an onLayout callback rather than a ref callback with a MutationObserver\n  // because React Native measures happen through the layout event system.\n  // The ref here is returned as a convenience so consumers can attach it, but the\n  // actual measurement is done via the onLayout prop that we also expose.\n  const ref = useCallback((_node: View | null) => {\n    // The ref callback is a no-op — measurement happens via onLayout below.\n  }, []);\n\n  const onLayout = useCallback((event: LayoutChangeEvent) => {\n    const { width } = event.nativeEvent.layout;\n    setBreakpoint(getContainerBreakpoint(width));\n  }, []);\n\n  // We augment the returned tuple with an onLayout so callers can use it.\n  // Return value is [ref, breakpoint, onLayout] for ergonomics.\n  // Keep the public API as [ref, breakpoint] per the spec, but attach onLayout\n  // to the ref callback so callers that spread the returned ref also get measurement.\n  // Actually — return three values and document properly.\n  return Object.assign([ref, breakpoint] as [typeof ref, ContainerBreakpoint], { onLayout });\n}\n\n/**\n * Extended return type that includes an `onLayout` handler for measurement.\n * Prefer this form for explicit usage:\n *\n * @example\n * const { ref, breakpoint, onLayout } = useContainerQueryFull();\n * return <View ref={ref} onLayout={onLayout}>...</View>;\n */\nexport interface ContainerQueryResult {\n  ref: (node: View | null) => void;\n  breakpoint: ContainerBreakpoint;\n  onLayout: (event: LayoutChangeEvent) => void;\n}\n\n/**\n * Object-API variant of `useContainerQuery` — easier to use when you need\n * all three values without destructuring a tuple.\n */\nexport function useContainerQueryFull(): ContainerQueryResult {\n  const [breakpoint, setBreakpoint] = useState<ContainerBreakpoint>('xs');\n\n  const ref = useCallback((_node: View | null) => {\n    // Measurement is driven by onLayout, not the ref callback.\n  }, []);\n\n  const onLayout = useCallback((event: LayoutChangeEvent) => {\n    const { width } = event.nativeEvent.layout;\n    setBreakpoint(getContainerBreakpoint(width));\n  }, []);\n\n  return { ref, breakpoint, onLayout };\n}\n","/**\n * useScrollHandler — scroll-driven animation values via Reanimated.\n *\n * This hook requires `react-native-reanimated` >= 3.6.0 as a peer dependency.\n * It is guarded by a try/catch import so that the rest of the package remains\n * importable when Reanimated is not installed (it will throw a clear error only\n * when useScrollHandler itself is called).\n */\n\n// We import types only here so TypeScript can check the rest of this file even\n// when the peer is absent at runtime. The actual module is loaded lazily.\nimport type {\n  SharedValue,\n  ScrollHandlerProcessed,\n} from 'react-native-reanimated';\n\nexport interface ScrollHandlerResult {\n  /** Pass this to the `onScroll` prop of Reanimated.ScrollView / FlatList. */\n  scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;\n  /** Shared value tracking current vertical scroll offset in pixels. */\n  scrollY: SharedValue<number>;\n  /** Shared value tracking scroll direction — updates when direction changes. */\n  scrollDirection: SharedValue<'up' | 'down'>;\n}\n\nlet reanimated: typeof import('react-native-reanimated') | null = null;\n\nfunction loadReanimated(): typeof import('react-native-reanimated') {\n  if (reanimated) return reanimated;\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    reanimated = require('react-native-reanimated') as typeof import('react-native-reanimated');\n    return reanimated;\n  } catch {\n    throw new Error(\n      '[reactnatively-hooks] useScrollHandler requires react-native-reanimated >= 3.6.0. ' +\n        'Install it with: npx expo install react-native-reanimated',\n    );\n  }\n}\n\n/**\n * Returns scroll-driven Reanimated shared values and a scroll handler.\n *\n * @example\n * const { scrollHandler, scrollY, scrollDirection } = useScrollHandler();\n * return (\n *   <Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>\n *     ...\n *   </Animated.ScrollView>\n * );\n */\nexport function useScrollHandler(): ScrollHandlerResult {\n  const rn = loadReanimated();\n  const { useSharedValue, useAnimatedScrollHandler } = rn;\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollY = useSharedValue<number>(0);\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollDirection = useSharedValue<'up' | 'down'>('down');\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const scrollHandler = useAnimatedScrollHandler({\n    onScroll(event) {\n      'worklet';\n      const y = event.contentOffset.y;\n      if (y > scrollY.value) {\n        scrollDirection.value = 'down';\n      } else if (y < scrollY.value) {\n        scrollDirection.value = 'up';\n      }\n      scrollY.value = y;\n    },\n  });\n\n  return { scrollHandler, scrollY, scrollDirection };\n}\n"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "reactnatively-hooks",
+  "version": "0.1.0",
+  "description": "Shared UI hooks for the Reactnatively framework",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "reactnatively-theme": "0.1.0",
+    "reactnatively-utils": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.73.0",
+    "react-native-reanimated": ">=3.6.0",
+    "react-native-safe-area-context": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-reanimated": {
+      "optional": true
+    },
+    "react-native-safe-area-context": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.2.4",
+    "typescript": "^5.5.3",
+    "@reactnatively/tsconfig": "0.0.0"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "hooks",
+    "ui",
+    "design-system",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hakizimana-fred/reactnatively.git",
+    "directory": "packages/hooks"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}