@webority-technologies/mobile 0.0.22 → 0.0.24

package/lib/commonjs/form/path.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setPath = exports.getPath = exports.deletePath = void 0;
+/**
+ * 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;
+};
+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;
+};
+exports.getPath = getPath;
+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;
+};
+exports.setPath = setPath;
+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;
+};
+exports.deletePath = deletePath;
+//# sourceMappingURL=path.js.map

package/lib/commonjs/form/rules.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.url = exports.strongPassword = exports.required = exports.pincode = exports.phone = exports.pattern = exports.pan = exports.oneOf = exports.numeric = exports.mobile = exports.minLength = exports.min = exports.maxLength = exports.max = exports.matches = exports.integer = exports.ifsc = exports.gstin = exports.email = exports.custom = exports.alphanumeric = exports.aadhaar = void 0;
+var _index = require("../validators/index.js");
+var _path = require("./path.js");
+/**
+ * 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.
+ */
+
+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;
+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;
+};
+exports.required = required;
+const email = exports.email = fromPredicate(_index.isEmail, 'Enter a valid email');
+const mobile = exports.mobile = fromPredicate(_index.isIndianMobile, 'Enter a valid mobile number');
+const phone = exports.phone = fromPredicate(_index.isPhone, 'Enter a valid phone number');
+const url = exports.url = fromPredicate(_index.isUrl, 'Enter a valid URL');
+const numeric = exports.numeric = fromPredicate(_index.isNumeric, 'Enter a valid number');
+const integer = exports.integer = fromPredicate(_index.isInteger, 'Enter a whole number');
+const alphanumeric = exports.alphanumeric = fromPredicate(_index.isAlphanumeric, 'Use letters and numbers only');
+const pincode = exports.pincode = fromPredicate(_index.isIndianPincode, 'Enter a valid 6-digit PIN code');
+const pan = exports.pan = fromPredicate(_index.isPan, 'Enter a valid PAN');
+const gstin = exports.gstin = fromPredicate(_index.isGstin, 'Enter a valid GSTIN');
+const aadhaar = exports.aadhaar = fromPredicate(_index.isAadhaar, 'Enter a valid Aadhaar number');
+const ifsc = exports.ifsc = fromPredicate(_index.isIfsc, 'Enter a valid IFSC code');
+const minLength = (length, message) => value => isEmptyValue(value) || String(value).length >= length ? undefined : message ?? `Must be at least ${length} characters`;
+exports.minLength = minLength;
+const maxLength = (length, message) => value => value == null || String(value).length <= length ? undefined : message ?? `Must be at most ${length} characters`;
+exports.maxLength = maxLength;
+const min = (n, message) => value => isEmptyValue(value) || Number(value) >= n ? undefined : message ?? `Must be at least ${n}`;
+exports.min = min;
+const max = (n, message) => value => isEmptyValue(value) || Number(value) <= n ? undefined : message ?? `Must be at most ${n}`;
+exports.max = max;
+const pattern = (regex, message = 'Invalid format') => value => isEmptyValue(value) || regex.test(String(value)) ? undefined : message;
+exports.pattern = pattern;
+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. */
+exports.oneOf = oneOf;
+const matches = (otherField, message = 'Values do not match') => (value, allValues) => value === (0, _path.getPath)(allValues, otherField) ? undefined : message;
+exports.matches = matches;
+const strongPassword = (rules, message = 'Password is too weak') => value => isEmptyValue(value) || (0, _index.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.
+ */
+exports.strongPassword = strongPassword;
+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;
+};
+exports.custom = custom;
+//# sourceMappingURL=rules.js.map

package/lib/commonjs/form/types.js

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

package/lib/commonjs/form/useField.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useField = useField;
+exports.useFieldArray = useFieldArray;
+var _path = require("./path.js");
+var _FormContext = require("./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} />
+ */
+function useField(name) {
+  const form = (0, _FormContext.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.
+ */
+function useFieldArray(name) {
+  const form = (0, _FormContext.useFormContext)();
+  const fields = (0, _path.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/commonjs/form/useForm.js

@@ -0,0 +1,316 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useForm = useForm;
+var _react = require("react");
+var _path = require("./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.
+ */
+function useForm(config) {
+  const configRef = (0, _react.useRef)(config);
+  configRef.current = config;
+  const initialRef = (0, _react.useRef)(config.initialValues);
+  const [values, setValuesState] = (0, _react.useState)(config.initialValues);
+  const [errors, setErrorsState] = (0, _react.useState)({});
+  const [touched, setTouchedState] = (0, _react.useState)({});
+  const [isSubmitting, setSubmitting] = (0, _react.useState)(false);
+  const [isValidating, setValidating] = (0, _react.useState)(false);
+  const [submitCount, setSubmitCount] = (0, _react.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 = (0, _react.useRef)({
+    values,
+    errors,
+    touched,
+    submitCount
+  });
+  ref.current = {
+    values,
+    errors,
+    touched,
+    submitCount
+  };
+  const fieldNodes = (0, _react.useRef)(new Map());
+  const fieldOrder = (0, _react.useRef)([]);
+  const focusedFieldRef = (0, _react.useRef)(null);
+  (0, _react.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 = (0, _react.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 = (0, _path.getPath)(allValues, name);
+    for (const rule of rulesFor(validate, name)) {
+      const res = await rule(value, allValues);
+      if (res) return res;
+    }
+    return undefined;
+  }, []);
+  const runAll = (0, _react.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 = (0, _path.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 = (0, _react.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 = (0, _react.useCallback)(async () => {
+    setValidating(true);
+    const errs = await runAll(ref.current.values);
+    setValidating(false);
+    ref.current.errors = errs;
+    setErrorsState(errs);
+    return errs;
+  }, [runAll]);
+  const setFieldValue = (0, _react.useCallback)((name, value, shouldValidate) => {
+    const next = (0, _path.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 = (0, _react.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 = (0, _react.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 = (0, _react.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 = (0, _react.useCallback)(errs => {
+    ref.current.errors = errs;
+    setErrorsState(errs);
+  }, []);
+  const setValues = (0, _react.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 = (0, _react.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 = (0, _react.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 = (0, _react.useCallback)(name => {
+    focusedFieldRef.current = name;
+  }, []);
+  const focusAdjacent = (0, _react.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 = (0, _react.useCallback)(() => focusAdjacent(1), [focusAdjacent]);
+  const focusPrev = (0, _react.useCallback)(() => focusAdjacent(-1), [focusAdjacent]);
+  const helpers = (0, _react.useMemo)(() => ({
+    setErrors,
+    setFieldError,
+    reset,
+    setSubmitting
+  }), [setErrors, setFieldError, reset]);
+  const submit = (0, _react.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 = (0, _react.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 = (0, _react.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 = (0, _path.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 = (0, _react.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 = (0, _path.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((0, _path.getPath)(initialRef.current, name))
+      };
+    },
+    getFieldProps: name => ({
+      name,
+      value: (0, _path.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/commonjs/hooks/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "useControllableState", {
+  enumerable: true,
+  get: function () {
+    return _useControllableState.useControllableState;
+  }
+});
 Object.defineProperty(exports, "useDebounce", {
   enumerable: true,
   get: function () {
@@ -15,6 +21,12 @@ Object.defineProperty(exports, "usePressAnimation", {
     return _usePressAnimation.usePressAnimation;
   }
 });
+Object.defineProperty(exports, "useReducedMotion", {
+  enumerable: true,
+  get: function () {
+    return _useReducedMotion.useReducedMotion;
+  }
+});
 Object.defineProperty(exports, "useToggle", {
   enumerable: true,
   get: function () {
@@ -24,4 +36,6 @@ Object.defineProperty(exports, "useToggle", {
 var _useToggle = require("./useToggle.js");
 var _useDebounce = require("./useDebounce.js");
 var _usePressAnimation = require("./usePressAnimation.js");
+var _useReducedMotion = require("./useReducedMotion.js");
+var _useControllableState = require("./useControllableState.js");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/hooks/useControllableState.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useControllableState = useControllableState;
+var _react = require("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.
+ */
+function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const isControlledRef = (0, _react.useRef)(value !== undefined);
+  const isControlled = isControlledRef.current;
+  const [internal, setInternal] = (0, _react.useState)(defaultValue);
+  const current = isControlled ? value : internal;
+  const setValue = (0, _react.useCallback)(next => {
+    if (!isControlled) setInternal(next);
+    onChange?.(next);
+  }, [isControlled, onChange]);
+  return [current, setValue];
+}
+//# sourceMappingURL=useControllableState.js.map

package/lib/commonjs/hooks/useReducedMotion.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useReducedMotion = void 0;
+var _react = require("react");
+var _reactNative = require("react-native");
+/**
+ * Tracks the OS "Reduce Motion" accessibility setting. The library's
+ * ThemeProvider uses this to collapse `theme.motion` (durations → 0, springs →
+ * near-instant) so animations don't trigger vestibular discomfort; consumers
+ * can also read it directly to swap an animated path for a static one.
+ */
+const useReducedMotion = () => {
+  const [reduced, setReduced] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
+    let mounted = true;
+    _reactNative.AccessibilityInfo.isReduceMotionEnabled().then(value => {
+      if (mounted) setReduced(value);
+    });
+    const sub = _reactNative.AccessibilityInfo.addEventListener('reduceMotionChanged', value => setReduced(value));
+    return () => {
+      mounted = false;
+      sub.remove();
+    };
+  }, []);
+  return reduced;
+};
+exports.useReducedMotion = useReducedMotion;
+//# sourceMappingURL=useReducedMotion.js.map