@webority-technologies/mobile 0.0.22 → 0.0.23

package/lib/module/components/Toast/Toast.js

@@ -39,6 +39,18 @@ const Toast = ({
   const translateX = useRef(createAnimatedValue(0)).current;
   const opacity = useRef(createAnimatedValue(0)).current;
   const dismissedRef = useRef(false);
+  const stackTranslate = position === 'top' ? index * stackOffset : -index * stackOffset;
+  const stackScale = Math.max(1 - index * stackScaleStep, stackMinScale);
+
+  // The stack offset rides on its own value so the enter spring (translateY)
+  // and the layout offset compose once instead of rebuilding a fresh
+  // `new Animated.Value` + `Animated.add` node on every render. setNativeValue
+  // keeps it in sync after the node has moved to the native driver.
+  const stackTranslateY = useRef(createAnimatedValue(stackTranslate)).current;
+  useEffect(() => {
+    setNativeValue(stackTranslateY, stackTranslate);
+  }, [stackTranslate, stackTranslateY]);
+  const composedTranslateY = useMemo(() => Animated.add(translateY, stackTranslateY), [translateY, stackTranslateY]);
   const dismiss = (animateOut = true) => {
     if (dismissedRef.current) return;
     dismissedRef.current = true;
@@ -57,7 +69,7 @@ const Toast = ({
     }
   };
   useEffect(() => {
-    Animated.parallel([Animated.spring(translateY, {
+    const enter = Animated.parallel([Animated.spring(translateY, {
       toValue: 0,
       damping: enterSpringDamping,
       stiffness: enterSpringStiffness,
@@ -67,13 +79,17 @@ const Toast = ({
       toValue: 1,
       duration: theme.motion.duration.fast,
       useNativeDriver: true
-    })]).start();
+    })]);
+    enter.start();
     const duration = toast.duration ?? defaultDurationMs;
     if (duration > 0) {
       const timer = setTimeout(() => dismiss(true), duration);
-      return () => clearTimeout(timer);
+      return () => {
+        enter.stop();
+        clearTimeout(timer);
+      };
     }
-    return undefined;
+    return () => enter.stop();
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
   const panResponder = useMemo(() => PanResponder.create({
@@ -108,11 +124,7 @@ const Toast = ({
         })]).start();
       }
     }
-  }),
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  []);
-  const stackTranslate = position === 'top' ? index * stackOffset : -index * stackOffset;
-  const stackScale = Math.max(1 - index * stackScaleStep, stackMinScale);
+  }), [translateX, opacity, swipeDismissThreshold, swipeVelocityThreshold, theme.motion.duration.fast, onDismiss, toast.id]);
   const handleActionPress = () => {
     toast.action?.onPress();
     dismiss(true);
@@ -152,7 +164,7 @@ const Toast = ({
       shadowColor: theme.shadows.md.shadowColor,
       opacity,
       transform: [{
-        translateY: Animated.add(translateY, new Animated.Value(stackTranslate))
+        translateY: composedTranslateY
       }, {
         translateX
       }, {

package/lib/module/components/Tooltip/Tooltip.js

@@ -102,6 +102,7 @@ const Tooltip = props => {
         }
       };
     }
+    let anim;
     if (visible) {
       measureAnchor();
       const enterAnims = [Animated.timing(opacity, {
@@ -118,7 +119,8 @@ const Tooltip = props => {
           useNativeDriver: true
         }));
       }
-      Animated.parallel(enterAnims).start();
+      anim = Animated.parallel(enterAnims);
+      anim.start();
       if (trigger === 'press') {
         if (autoHideTimer.current) clearTimeout(autoHideTimer.current);
         autoHideTimer.current = setTimeout(() => {
@@ -138,13 +140,15 @@ const Tooltip = props => {
           useNativeDriver: true
         }));
       }
-      Animated.parallel(exitAnims).start();
+      anim = Animated.parallel(exitAnims);
+      anim.start();
       if (autoHideTimer.current) {
         clearTimeout(autoHideTimer.current);
         autoHideTimer.current = null;
       }
     }
     return () => {
+      anim?.stop();
       if (autoHideTimer.current) {
         clearTimeout(autoHideTimer.current);
         autoHideTimer.current = null;

package/lib/module/components/index.js

@@ -7,6 +7,10 @@ export { Banner } from "./Banner/index.js";
 export { BottomNavigation } from "./BottomNavigation/index.js";
 export { BottomSheet, useBottomSheet } from "./BottomSheet/index.js";
 export { Button } from "./Button/index.js";
+export { Box, Stack, Row, Spacer } from "./Box/index.js";
+export { Text } from "./Text/index.js";
+export { KeyboardAwareScrollView } from "./KeyboardAwareScrollView/index.js";
+export { KeyboardToolbar } from "./KeyboardToolbar/index.js";
 export { Card } from "./Card/index.js";
 export { Carousel } from "./Carousel/index.js";
 export { Checkbox } from "./Checkbox/index.js";

package/lib/module/form/FormContext.js

@@ -0,0 +1,32 @@
+"use strict";
+
+import React, { createContext, useContext } from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+const FormContext = /*#__PURE__*/createContext(null);
+/**
+ * Provides a {@link useForm} instance to descendants so `<FormField name>`,
+ * {@link useField} and {@link useFieldArray} can bind by name.
+ */
+export const Form = ({
+  form,
+  children
+}) => /*#__PURE__*/_jsx(FormContext.Provider, {
+  value: form,
+  children: children
+});
+Form.displayName = 'Form';
+
+/** Read the surrounding form. Throws if there is no `<Form>` ancestor. */
+export function useFormContext() {
+  const ctx = useContext(FormContext);
+  if (!ctx) {
+    throw new Error('useFormContext / useField / <FormField name> must be rendered inside a <Form> from @webority-technologies/mobile.');
+  }
+  return ctx;
+}
+
+/** Read the surrounding form, or null when there is no `<Form>` ancestor. */
+export function useOptionalFormContext() {
+  return useContext(FormContext);
+}
+//# sourceMappingURL=FormContext.js.map

package/lib/module/form/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+export { useForm } from "./useForm.js";
+export { useField, useFieldArray } from "./useField.js";
+export { Form, useFormContext, useOptionalFormContext } from "./FormContext.js";
+export { getPath, setPath, deletePath } from "./path.js";
+
+// Validation rule presets (the dependency-free Yup replacement):
+//   import { rules } from '@webority-technologies/mobile';
+//   validate: { email: [rules.required(), rules.email()] }
+export * as rules from "./rules.js";
+//# sourceMappingURL=index.js.map

package/lib/module/form/path.js

@@ -0,0 +1,72 @@
+"use strict";
+
+/**
+ * Immutable get/set/delete for dot- and bracket-notation field paths
+ * ("address.city", "phones[0]", "items[2].qty"). Lets a single flat `name`
+ * string address nested values and array items, so the form engine can treat
+ * every field uniformly regardless of how deep it lives in the value tree.
+ */
+
+const tokenize = path => {
+  const tokens = [];
+  const re = /[^.[\]]+/g;
+  let m;
+  while ((m = re.exec(path)) !== null) {
+    const raw = m[0];
+    tokens.push(/^\d+$/.test(raw) ? Number(raw) : raw);
+  }
+  return tokens;
+};
+export const getPath = (obj, path) => {
+  const tokens = tokenize(path);
+  let cur = obj;
+  for (const t of tokens) {
+    if (cur == null || typeof cur !== 'object') return undefined;
+    cur = cur[t];
+  }
+  return cur;
+};
+export const setPath = (obj, path, value) => {
+  const tokens = tokenize(path);
+  if (tokens.length === 0) return obj;
+  const root = Array.isArray(obj) ? [...obj] : {
+    ...obj
+  };
+  let cur = root;
+  for (let i = 0; i < tokens.length - 1; i++) {
+    const t = tokens[i];
+    const next = tokens[i + 1];
+    const child = cur[t];
+    // Clone the existing branch so we never mutate the previous value tree;
+    // create the right container shape when the branch is missing.
+    const cloned = child != null && typeof child === 'object' ? Array.isArray(child) ? [...child] : {
+      ...child
+    } : typeof next === 'number' ? [] : {};
+    cur[t] = cloned;
+    cur = cloned;
+  }
+  cur[tokens[tokens.length - 1]] = value;
+  return root;
+};
+export const deletePath = (obj, path) => {
+  const tokens = tokenize(path);
+  if (tokens.length === 0) return obj;
+  const root = Array.isArray(obj) ? [...obj] : {
+    ...obj
+  };
+  let cur = root;
+  for (let i = 0; i < tokens.length - 1; i++) {
+    const t = tokens[i];
+    const child = cur[t];
+    if (child == null || typeof child !== 'object') return root;
+    const cloned = Array.isArray(child) ? [...child] : {
+      ...child
+    };
+    cur[t] = cloned;
+    cur = cloned;
+  }
+  const last = tokens[tokens.length - 1];
+  if (Array.isArray(cur) && typeof last === 'number') cur.splice(last, 1);else delete cur[last];
+  return root;
+};
+//# sourceMappingURL=path.js.map

package/lib/module/form/rules.js

@@ -0,0 +1,52 @@
+"use strict";
+
+/**
+ * Validation rule presets — the dependency-free replacement for Yup chains.
+ * Each factory returns a {@link ValidationRule}. Rules built on the project's
+ * `validators` module skip empty values (so `required()` owns emptiness and you
+ * don't get duplicate errors), and accept an optional custom message.
+ */
+import { isEmail, isIndianMobile, isPhone, isUrl, isNumeric, isInteger, isAlphanumeric, isStrongPassword, isIndianPincode, isPan, isGstin, isAadhaar, isIfsc } from "../validators/index.js";
+import { getPath } from "./path.js";
+const isEmptyValue = v => v == null || v === '' || Array.isArray(v) && v.length === 0;
+const fromPredicate = (predicate, defaultMsg) => message => value => isEmptyValue(value) || predicate(value) ? undefined : message ?? defaultMsg;
+export const required = (message = 'This field is required') => value => {
+  // A required boolean (e.g. "accept terms" checkbox) must be true.
+  if (typeof value === 'boolean') return value ? undefined : message;
+  return isEmptyValue(value) ? message : undefined;
+};
+export const email = fromPredicate(isEmail, 'Enter a valid email');
+export const mobile = fromPredicate(isIndianMobile, 'Enter a valid mobile number');
+export const phone = fromPredicate(isPhone, 'Enter a valid phone number');
+export const url = fromPredicate(isUrl, 'Enter a valid URL');
+export const numeric = fromPredicate(isNumeric, 'Enter a valid number');
+export const integer = fromPredicate(isInteger, 'Enter a whole number');
+export const alphanumeric = fromPredicate(isAlphanumeric, 'Use letters and numbers only');
+export const pincode = fromPredicate(isIndianPincode, 'Enter a valid 6-digit PIN code');
+export const pan = fromPredicate(isPan, 'Enter a valid PAN');
+export const gstin = fromPredicate(isGstin, 'Enter a valid GSTIN');
+export const aadhaar = fromPredicate(isAadhaar, 'Enter a valid Aadhaar number');
+export const ifsc = fromPredicate(isIfsc, 'Enter a valid IFSC code');
+export const minLength = (length, message) => value => isEmptyValue(value) || String(value).length >= length ? undefined : message ?? `Must be at least ${length} characters`;
+export const maxLength = (length, message) => value => value == null || String(value).length <= length ? undefined : message ?? `Must be at most ${length} characters`;
+export const min = (n, message) => value => isEmptyValue(value) || Number(value) >= n ? undefined : message ?? `Must be at least ${n}`;
+export const max = (n, message) => value => isEmptyValue(value) || Number(value) <= n ? undefined : message ?? `Must be at most ${n}`;
+export const pattern = (regex, message = 'Invalid format') => value => isEmptyValue(value) || regex.test(String(value)) ? undefined : message;
+export const oneOf = (allowed, message = 'Invalid selection') => value => isEmptyValue(value) || allowed.includes(value) ? undefined : message;
+
+/** Cross-field equality (e.g. confirm-password). `otherField` is a field path. */
+export const matches = (otherField, message = 'Values do not match') => (value, allValues) => value === getPath(allValues, otherField) ? undefined : message;
+export const strongPassword = (rules, message = 'Password is too weak') => value => isEmptyValue(value) || isStrongPassword(value, rules) ? undefined : message;
+
+/**
+ * Wrap any custom check. Return `true` (valid), `false` (invalid → default
+ * message), or a string (invalid → that message). Async is supported — return
+ * a Promise of the same.
+ */
+export const custom = (fn, message = 'Invalid value') => async (value, allValues) => {
+  const result = await fn(value, allValues);
+  if (result === true) return undefined;
+  if (result === false) return message;
+  return result;
+};
+//# sourceMappingURL=rules.js.map

package/lib/module/form/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/form/useField.js

@@ -0,0 +1,49 @@
+"use strict";
+
+import { getPath } from "./path.js";
+import { useFormContext } from "./FormContext.js";
+/**
+ * Bind a single field by name. Returns everything an input needs; pick the
+ * handler your control uses:
+ *   const email = useField('email');
+ *   <Input value={email.value} onChangeText={email.onChangeText} onBlur={email.onBlur} error={email.error} />
+ *   <Select value={country.value} onChange={country.onChange} error={country.error} />
+ *   <Switch value={!!agree.value} onChange={agree.onChange} />
+ */
+export function useField(name) {
+  const form = useFormContext();
+  return form.getFieldProps(name);
+}
+/**
+ * Manage a repeating list field (phone numbers, line items, etc.) by name.
+ * Each helper writes the whole array back through the form so validation and
+ * dirty-tracking stay correct.
+ */
+export function useFieldArray(name) {
+  const form = useFormContext();
+  const fields = getPath(form.values, name) ?? [];
+  const set = next => form.setFieldValue(name, next);
+  return {
+    fields,
+    length: fields.length,
+    push: item => set([...fields, item]),
+    remove: index => set(fields.filter((_, i) => i !== index)),
+    insert: (index, item) => {
+      const copy = [...fields];
+      copy.splice(index, 0, item);
+      set(copy);
+    },
+    move: (from, to) => {
+      const copy = [...fields];
+      const [moved] = copy.splice(from, 1);
+      copy.splice(to, 0, moved);
+      set(copy);
+    },
+    replace: (index, item) => {
+      const copy = [...fields];
+      copy[index] = item;
+      set(copy);
+    }
+  };
+}
+//# sourceMappingURL=useField.js.map

package/lib/module/form/useForm.js

@@ -0,0 +1,312 @@
+"use strict";
+
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { getPath, setPath } from "./path.js";
+// Loosely typed (Values -> any) so the generic schema from any useForm<Values>
+// instance flows in without variance friction; callers re-apply Values at use.
+const rulesFor = (validate, name) => {
+  if (!validate || typeof validate === 'function') return [];
+  const r = validate[name];
+  if (!r) return [];
+  return Array.isArray(r) ? r : [r];
+};
+
+/**
+ * Dependency-free form engine. Tracks values/errors/touched/dirty, runs
+ * synchronous and async validation (per-field rule maps or a form-level
+ * function), gates error display behind touched/submit, and on a failed submit
+ * focuses the first errored field. The returned object is rebuilt every render
+ * so `<Form>` consumers re-render on state changes.
+ */
+export function useForm(config) {
+  const configRef = useRef(config);
+  configRef.current = config;
+  const initialRef = useRef(config.initialValues);
+  const [values, setValuesState] = useState(config.initialValues);
+  const [errors, setErrorsState] = useState({});
+  const [touched, setTouchedState] = useState({});
+  const [isSubmitting, setSubmitting] = useState(false);
+  const [isValidating, setValidating] = useState(false);
+  const [submitCount, setSubmitCount] = useState(0);
+
+  // Mirror of the latest state so handlers (incl. async) never read stale
+  // closures and sequential setFieldValue calls in one tick compound correctly.
+  const ref = useRef({
+    values,
+    errors,
+    touched,
+    submitCount
+  });
+  ref.current = {
+    values,
+    errors,
+    touched,
+    submitCount
+  };
+  const fieldNodes = useRef(new Map());
+  const fieldOrder = useRef([]);
+  const focusedFieldRef = useRef(null);
+  useEffect(() => {
+    if (!configRef.current.enableReinitialize) return;
+    const next = configRef.current.initialValues;
+    initialRef.current = next;
+    ref.current.values = next;
+    ref.current.errors = {};
+    ref.current.touched = {};
+    setValuesState(next);
+    setErrorsState({});
+    setTouchedState({});
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [JSON.stringify(config.initialValues)]);
+  const validateField = useCallback(async name => {
+    const validate = configRef.current.validate;
+    const allValues = ref.current.values;
+    if (typeof validate === 'function') {
+      const map = (await validate(allValues)) ?? {};
+      return map[name] || undefined;
+    }
+    const value = getPath(allValues, name);
+    for (const rule of rulesFor(validate, name)) {
+      const res = await rule(value, allValues);
+      if (res) return res;
+    }
+    return undefined;
+  }, []);
+  const runAll = useCallback(async vals => {
+    const validate = configRef.current.validate;
+    if (!validate) return {};
+    if (typeof validate === 'function') return (await validate(vals)) ?? {};
+    const out = {};
+    await Promise.all(Object.keys(validate).map(async name => {
+      const value = getPath(vals, name);
+      for (const rule of rulesFor(validate, name)) {
+        const res = await rule(value, vals);
+        if (res) {
+          out[name] = res;
+          break;
+        }
+      }
+    }));
+    return out;
+  }, []);
+  const revalidateField = useCallback(async name => {
+    const err = await validateField(name);
+    setErrorsState(prev => {
+      if (prev[name] === err) return prev;
+      const next = {
+        ...prev
+      };
+      if (err) next[name] = err;else delete next[name];
+      ref.current.errors = next;
+      return next;
+    });
+  }, [validateField]);
+  const validate = useCallback(async () => {
+    setValidating(true);
+    const errs = await runAll(ref.current.values);
+    setValidating(false);
+    ref.current.errors = errs;
+    setErrorsState(errs);
+    return errs;
+  }, [runAll]);
+  const setFieldValue = useCallback((name, value, shouldValidate) => {
+    const next = setPath(ref.current.values, name, value);
+    ref.current.values = next;
+    setValuesState(next);
+    const cfg = configRef.current;
+    const willValidate = shouldValidate ?? (ref.current.touched[name] || ref.current.submitCount > 0 || cfg.validateOn === 'change');
+    if (willValidate) void revalidateField(name);
+  }, [revalidateField]);
+  const handleBlur = useCallback(name => {
+    setTouchedState(prev => {
+      if (prev[name]) return prev;
+      const next = {
+        ...prev,
+        [name]: true
+      };
+      ref.current.touched = next;
+      return next;
+    });
+    // Blur is the natural moment to surface a field's error.
+    void revalidateField(name);
+  }, [revalidateField]);
+  const setFieldTouched = useCallback((name, isTouched = true, shouldValidate) => {
+    const next = {
+      ...ref.current.touched,
+      [name]: isTouched
+    };
+    ref.current.touched = next;
+    setTouchedState(next);
+    if (shouldValidate ?? isTouched) void revalidateField(name);
+  }, [revalidateField]);
+  const setFieldError = useCallback((name, error) => {
+    setErrorsState(prev => {
+      const next = {
+        ...prev
+      };
+      if (error) next[name] = error;else delete next[name];
+      ref.current.errors = next;
+      return next;
+    });
+  }, []);
+  const setErrors = useCallback(errs => {
+    ref.current.errors = errs;
+    setErrorsState(errs);
+  }, []);
+  const setValues = useCallback((next, shouldValidate) => {
+    const resolved = typeof next === 'function' ? next(ref.current.values) : {
+      ...ref.current.values,
+      ...next
+    };
+    ref.current.values = resolved;
+    setValuesState(resolved);
+    if (shouldValidate) void validate();
+  }, [validate]);
+  const reset = useCallback(nextValues => {
+    const base = nextValues ? {
+      ...initialRef.current,
+      ...nextValues
+    } : initialRef.current;
+    initialRef.current = base;
+    ref.current.values = base;
+    ref.current.errors = {};
+    ref.current.touched = {};
+    ref.current.submitCount = 0;
+    setValuesState(base);
+    setErrorsState({});
+    setTouchedState({});
+    setSubmitCount(0);
+  }, []);
+  const registerField = useCallback((name, node) => {
+    if (node) {
+      fieldNodes.current.set(name, node);
+      if (!fieldOrder.current.includes(name)) fieldOrder.current.push(name);
+    } else {
+      fieldNodes.current.delete(name);
+      fieldOrder.current = fieldOrder.current.filter(n => n !== name);
+    }
+  }, []);
+  const handleFocus = useCallback(name => {
+    focusedFieldRef.current = name;
+  }, []);
+  const focusAdjacent = useCallback(direction => {
+    const order = fieldOrder.current;
+    const current = focusedFieldRef.current;
+    const index = current ? order.indexOf(current) : -1;
+    const target = order[index + direction];
+    if (!target) return;
+    focusedFieldRef.current = target;
+    fieldNodes.current.get(target)?.focus?.();
+  }, []);
+  const focusNext = useCallback(() => focusAdjacent(1), [focusAdjacent]);
+  const focusPrev = useCallback(() => focusAdjacent(-1), [focusAdjacent]);
+  const helpers = useMemo(() => ({
+    setErrors,
+    setFieldError,
+    reset,
+    setSubmitting
+  }), [setErrors, setFieldError, reset]);
+  const submit = useCallback(() => {
+    void (async () => {
+      const cfg = configRef.current;
+      const currentValues = ref.current.values;
+      ref.current.submitCount += 1;
+      setSubmitCount(c => c + 1);
+      setValidating(true);
+      const errs = await runAll(currentValues);
+      setValidating(false);
+      const keys = new Set([...fieldOrder.current, ...Object.keys(errs)]);
+      const nextTouched = {
+        ...ref.current.touched
+      };
+      keys.forEach(k => {
+        nextTouched[k] = true;
+      });
+      ref.current.touched = nextTouched;
+      ref.current.errors = errs;
+      setTouchedState(nextTouched);
+      setErrorsState(errs);
+      const firstError = fieldOrder.current.find(n => errs[n]) ?? Object.keys(errs).find(n => errs[n]);
+      if (firstError) {
+        fieldNodes.current.get(firstError)?.focus?.();
+        return;
+      }
+      setSubmitting(true);
+      try {
+        await cfg.onSubmit(currentValues, helpers);
+      } finally {
+        setSubmitting(false);
+      }
+    })();
+  }, [runAll, helpers]);
+  const uiErrors = useMemo(() => {
+    const gated = {};
+    for (const k of Object.keys(errors)) {
+      if (errors[k] && (touched[k] || submitCount > 0)) gated[k] = errors[k];
+    }
+    return gated;
+  }, [errors, touched, submitCount]);
+  const isValid = useMemo(() => {
+    const validateCfg = configRef.current.validate;
+    if (!validateCfg) return true;
+    // Form-level async fn can't run synchronously — fall back to known errors.
+    if (typeof validateCfg === 'function') return Object.values(errors).every(e => !e);
+    for (const name of Object.keys(validateCfg)) {
+      const value = getPath(values, name);
+      for (const rule of rulesFor(validateCfg, name)) {
+        const res = rule(value, values);
+        if (typeof res === 'string' && res) return false; // async rules (Promise) are skipped here
+      }
+    }
+    return true;
+  }, [values, errors]);
+  const dirty = useMemo(() => JSON.stringify(values) !== JSON.stringify(initialRef.current), [values]);
+  return {
+    values,
+    errors: uiErrors,
+    rawErrors: errors,
+    touched,
+    dirty,
+    isValid,
+    isSubmitting,
+    isValidating,
+    submitCount,
+    setFieldValue,
+    setFieldTouched,
+    setFieldError,
+    setValues,
+    setErrors,
+    reset,
+    validate,
+    validateField,
+    submit,
+    handleBlur,
+    focusNext,
+    focusPrev,
+    registerField,
+    getFieldState: name => {
+      const value = getPath(values, name);
+      const rawError = errors[name];
+      const isTouched = !!touched[name];
+      return {
+        value,
+        error: isTouched || submitCount > 0 ? rawError : undefined,
+        rawError,
+        touched: isTouched,
+        dirty: JSON.stringify(value) !== JSON.stringify(getPath(initialRef.current, name))
+      };
+    },
+    getFieldProps: name => ({
+      name,
+      value: getPath(values, name),
+      error: touched[name] || submitCount > 0 ? errors[name] : undefined,
+      touched: !!touched[name],
+      onChange: val => setFieldValue(name, val),
+      onChangeText: text => setFieldValue(name, text),
+      onBlur: () => handleBlur(name),
+      onFocus: () => handleFocus(name),
+      setValue: (val, sv) => setFieldValue(name, val, sv)
+    })
+  };
+}
+//# sourceMappingURL=useForm.js.map

package/lib/module/hooks/index.js

@@ -3,4 +3,6 @@
 export { useToggle } from "./useToggle.js";
 export { useDebounce } from "./useDebounce.js";
 export { usePressAnimation } from "./usePressAnimation.js";
+export { useReducedMotion } from "./useReducedMotion.js";
+export { useControllableState } from "./useControllableState.js";
 //# sourceMappingURL=index.js.map

package/lib/module/hooks/useControllableState.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import { useCallback, useRef, useState } from 'react';
+/**
+ * Bridges controlled and uncontrolled usage for a value+onChange pair. When
+ * `value` is provided the component is controlled (the hook just forwards it
+ * and calls `onChange`); otherwise the hook owns the state, seeded from
+ * `defaultValue`. The controlled/uncontrolled decision is locked on first
+ * render so a component never flips modes mid-life.
+ */
+export function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const isControlledRef = useRef(value !== undefined);
+  const isControlled = isControlledRef.current;
+  const [internal, setInternal] = useState(defaultValue);
+  const current = isControlled ? value : internal;
+  const setValue = useCallback(next => {
+    if (!isControlled) setInternal(next);
+    onChange?.(next);
+  }, [isControlled, onChange]);
+  return [current, setValue];
+}
+//# sourceMappingURL=useControllableState.js.map