@webority-technologies/mobile 0.0.21 → 0.0.23

package/lib/module/components/Switch/Switch.js

@@ -3,6 +3,7 @@
 import React, { forwardRef, useEffect, useMemo, useRef } from 'react';
 import { Animated, Easing, Pressable, StyleSheet, Text, View } from 'react-native';
 import { useTheme, createAnimatedValue } from "../../theme/index.js";
+import { useControllableState } from "../../hooks/index.js";
 import { triggerHaptic } from "../../utils/hapticUtils.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const sizeMap = {
@@ -41,7 +42,8 @@ const toneColor = (theme, tone) => {
 const Switch = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     value,
-    onValueChange,
+    defaultValue,
+    onChange,
     disabled = false,
     size = 'md',
     tone = 'primary',
@@ -56,6 +58,11 @@ const Switch = /*#__PURE__*/forwardRef((props, ref) => {
     testID,
     ...rest
   } = props;
+  const [current, setCurrent] = useControllableState({
+    value,
+    defaultValue: defaultValue ?? false,
+    onChange
+  });
   const theme = useTheme();
   const sizeStyles = {
     ...sizeMap[size],
@@ -65,25 +72,29 @@ const Switch = /*#__PURE__*/forwardRef((props, ref) => {
   const styles = useMemo(() => buildStyles(theme), [theme]);
   const offTrackColor = theme.mode === 'dark' ? theme.colors.secondary : theme.colors.surface.disabled;
   const onTrackColor = toneColor(theme, tone);
-  const progress = useRef(createAnimatedValue(value ? 1 : 0)).current;
+  const progress = useRef(createAnimatedValue(current ? 1 : 0)).current;
   useEffect(() => {
-    Animated.spring(progress, {
-      toValue: value ? 1 : 0,
+    const anim = Animated.spring(progress, {
+      toValue: current ? 1 : 0,
       damping: theme.motion.spring.snappy.damping,
       stiffness: theme.motion.spring.snappy.stiffness,
       mass: theme.motion.spring.snappy.mass,
       useNativeDriver: true
-    }).start();
-  }, [value, progress, theme.motion.spring.snappy]);
-  const trackBgAnim = useRef(createAnimatedValue(value ? 1 : 0)).current;
+    });
+    anim.start();
+    return () => anim.stop();
+  }, [current, progress, theme.motion.spring.snappy]);
+  const trackBgAnim = useRef(createAnimatedValue(current ? 1 : 0)).current;
   useEffect(() => {
-    Animated.timing(trackBgAnim, {
-      toValue: value ? 1 : 0,
+    const anim = Animated.timing(trackBgAnim, {
+      toValue: current ? 1 : 0,
       duration: theme.motion.duration.fast,
       easing: Easing.out(Easing.ease),
       useNativeDriver: false
-    }).start();
-  }, [value, trackBgAnim, theme.motion.duration.fast]);
+    });
+    anim.start();
+    return () => anim.stop();
+  }, [current, trackBgAnim, theme.motion.duration.fast]);
   const offX = sizeStyles.padding;
   const onX = sizeStyles.trackWidth - sizeStyles.thumbSize - sizeStyles.padding;
   const translateX = progress.interpolate({
@@ -102,7 +113,7 @@ const Switch = /*#__PURE__*/forwardRef((props, ref) => {
       isFirstRender.current = false;
       return;
     }
-    Animated.sequence([Animated.spring(bounceScale, {
+    const anim = Animated.sequence([Animated.spring(bounceScale, {
       toValue: 1.15,
       damping: 10,
       stiffness: 220,
@@ -114,12 +125,14 @@ const Switch = /*#__PURE__*/forwardRef((props, ref) => {
       stiffness: 240,
       mass: 1,
       useNativeDriver: true
-    })]).start();
-  }, [value, bounce, bounceScale]);
+    })]);
+    anim.start();
+    return () => anim.stop();
+  }, [current, bounce, bounceScale]);
   const handlePress = event => {
     if (disabled) return;
     if (haptic !== false) triggerHaptic(haptic);
-    onValueChange(!value);
+    setCurrent(!current);
     rest.onPressOut?.(event);
   };
   const accessibleLabel = accessibilityLabel ?? label;
@@ -130,7 +143,7 @@ const Switch = /*#__PURE__*/forwardRef((props, ref) => {
     accessibilityRole: "switch",
     accessibilityLabel: accessibleLabel,
     accessibilityState: {
-      checked: value,
+      checked: current,
       disabled
     },
     testID: testID,

package/lib/module/components/Tabs/Tabs.js

@@ -82,7 +82,7 @@ const Tabs = /*#__PURE__*/forwardRef((props, ref) => {
     if (!activeLayout) return;
     if (useProgress) return;
     const spring = theme.motion.spring.snappy;
-    Animated.parallel([
+    const anim = Animated.parallel([
     // Both must use the JS driver: width can't run on native, and mixing
     // drivers on the same view (transform native + width JS) trips RN's
     // "node already moved to native" guard under the new architecture.
@@ -98,7 +98,9 @@ const Tabs = /*#__PURE__*/forwardRef((props, ref) => {
       stiffness: spring.stiffness,
       mass: spring.mass,
       useNativeDriver: false
-    })]).start();
+    })]);
+    anim.start();
+    return () => anim.stop();
   }, [activeLayout, activeKey, indicatorTranslateX, indicatorWidth, theme.motion.spring.snappy, useProgress]);
   const handleLayout = useCallback(key => e => {
     const {

package/lib/module/components/Text/Text.js

@@ -0,0 +1,138 @@
+"use strict";
+
+import React, { forwardRef, useMemo } from 'react';
+import { Text as RNText } from 'react-native';
+import { fontFor, useTheme } from "../../theme/index.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const VARIANTS = {
+  display: {
+    size: '4xl',
+    weight: 'bold',
+    line: 'tight',
+    color: 'primary',
+    heading: true
+  },
+  h1: {
+    size: '3xl',
+    weight: 'bold',
+    line: 'tight',
+    color: 'primary',
+    heading: true
+  },
+  h2: {
+    size: '2xl',
+    weight: 'semibold',
+    line: 'tight',
+    color: 'primary',
+    heading: true
+  },
+  h3: {
+    size: 'xl',
+    weight: 'semibold',
+    line: 'tight',
+    color: 'primary',
+    heading: true
+  },
+  title: {
+    size: 'lg',
+    weight: 'semibold',
+    line: 'normal',
+    color: 'primary'
+  },
+  body: {
+    size: 'base',
+    weight: 'normal',
+    line: 'normal',
+    color: 'primary'
+  },
+  bodySmall: {
+    size: 'sm',
+    weight: 'normal',
+    line: 'normal',
+    color: 'secondary'
+  },
+  caption: {
+    size: 'xs',
+    weight: 'normal',
+    line: 'normal',
+    color: 'tertiary'
+  },
+  label: {
+    size: 'sm',
+    weight: 'medium',
+    line: 'normal',
+    color: 'secondary'
+  },
+  overline: {
+    size: 'xs',
+    weight: 'semibold',
+    line: 'normal',
+    color: 'secondary',
+    uppercase: true,
+    letterSpacing: 'wide'
+  }
+};
+const TEXT_ROLES = {
+  primary: true,
+  secondary: true,
+  tertiary: true,
+  inverse: true,
+  disabled: true,
+  link: true
+};
+const SEMANTIC = {
+  success: true,
+  warning: true,
+  error: true,
+  info: true
+};
+const resolveColor = (theme, color) => {
+  // Text roles win over the same-named brand colour ('primary' -> text.primary),
+  // which is the intent the vast majority of the time for text.
+  if (TEXT_ROLES[color]) return theme.colors.text[color];
+  if (SEMANTIC[color]) return theme.colors[color];
+  return color; // raw colour string
+};
+const Text = /*#__PURE__*/forwardRef((props, ref) => {
+  const {
+    variant = 'body',
+    color,
+    weight,
+    size,
+    align,
+    italic,
+    underline,
+    style,
+    children,
+    ...rest
+  } = props;
+  const theme = useTheme();
+  const textStyle = useMemo(() => {
+    const spec = VARIANTS[variant];
+    const fontSize = typeof size === 'number' ? size : theme.typography.fontSize[size ?? spec.size];
+    const lineHeight = Math.round(fontSize * theme.typography.lineHeight[spec.line]);
+    return {
+      fontSize,
+      lineHeight,
+      color: resolveColor(theme, color ?? spec.color),
+      textAlign: align,
+      textTransform: spec.uppercase ? 'uppercase' : undefined,
+      letterSpacing: spec.letterSpacing ? theme.typography.letterSpacing[spec.letterSpacing] : undefined,
+      fontStyle: italic ? 'italic' : undefined,
+      textDecorationLine: underline ? 'underline' : undefined,
+      ...fontFor(theme, weight ?? spec.weight)
+    };
+  }, [theme, variant, color, weight, size, align, italic, underline]);
+  const heading = VARIANTS[variant].heading;
+  return /*#__PURE__*/_jsx(RNText, {
+    ref: ref,
+    style: [textStyle, style],
+    accessibilityRole: heading ? 'header' : rest.accessibilityRole,
+    ...rest,
+    children: children
+  });
+});
+Text.displayName = 'Text';
+export { Text };
+export default Text;
+//# sourceMappingURL=Text.js.map

package/lib/module/components/Text/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { Text } from "./Text.js";
+//# sourceMappingURL=index.js.map

package/lib/module/components/TimePicker/TimePicker.js

@@ -11,12 +11,12 @@ import { PickerTrigger } from "../PickerTrigger/PickerTrigger.js";
 /**
  * TimePicker supports two modes:
  *
- * 1. Controlled-modal mode — pass `visible`, `onSelect`, `onClose`. The
+ * 1. Controlled-modal mode — pass `visible`, `onChange`, `onClose`. The
  *    component renders only the modal sheet and the caller owns open/close
  *    state plus its own trigger UI.
  * 2. Trigger mode — omit `visible`. The component renders a PickerTrigger
  *    field (label / value / placeholder / chevron / clear / helper / error)
- *    and manages its own modal open state. `onSelect` is still called on
+ *    and manages its own modal open state. `onChange` is still called on
  *    confirm.
  */
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
@@ -217,7 +217,7 @@ const TimePicker = props => {
   const {
     visible,
     value,
-    onSelect,
+    onChange,
     onClose,
     format = '12h',
     minuteStep = 1,
@@ -304,8 +304,9 @@ const TimePicker = props => {
   const opacity = useRef(createAnimatedValue(0)).current;
   const translateY = useRef(createAnimatedValue(40)).current;
   useEffect(() => {
+    let anim;
     if (open) {
-      Animated.parallel([
+      anim = Animated.parallel([
       // Backdrop opacity uses JS driver — see Modal.tsx for the Fabric reason.
       Animated.timing(opacity, {
         toValue: 1,
@@ -318,11 +319,13 @@ const TimePicker = props => {
         stiffness: theme.motion.spring.snappy.stiffness,
         mass: theme.motion.spring.snappy.mass,
         useNativeDriver: true
-      })]).start();
+      })]);
+      anim.start();
     } else {
       opacity.setValue(0);
       setNativeValue(translateY, 40);
     }
+    return () => anim?.stop();
   }, [open, opacity, translateY, theme.motion]);
   const announce = useCallback(msg => {
     if (Platform.OS === 'ios' || Platform.OS === 'android') {
@@ -351,12 +354,12 @@ const TimePicker = props => {
     const hour24 = to24h(displayHour, period, format);
     const minute = minutes[minuteIndex] ?? 0;
     if (theme.components.timePicker?.haptic) triggerHaptic('notificationSuccess');
-    onSelect?.({
+    onChange?.({
       hour: hour24,
       minute
     });
     handleCloseModal();
-  }, [hours, hourIndex, periods, periodIndex, minutes, minuteIndex, format, onSelect, handleCloseModal, theme.components.timePicker]);
+  }, [hours, hourIndex, periods, periodIndex, minutes, minuteIndex, format, onChange, handleCloseModal, theme.components.timePicker]);
   const summary = useMemo(() => {
     const displayHour = hours[hourIndex] ?? 0;
     const minute = minutes[minuteIndex] ?? 0;

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

@@ -5,8 +5,12 @@ export { Avatar, AvatarGroup } from "./Avatar/index.js";
 export { Badge } from "./Badge/index.js";
 export { Banner } from "./Banner/index.js";
 export { BottomNavigation } from "./BottomNavigation/index.js";
-export { BottomSheet } from "./BottomSheet/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