@webority-technologies/mobile 0.0.22 → 0.0.24

package/lib/typescript/module/components/ImageGallery/ImageGallery.d.ts

@@ -18,6 +18,7 @@
  */
 import React from 'react';
 import type { ImageSourcePropType, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export interface GalleryImage {
     source: ImageSourcePropType;
     caption?: string;
@@ -31,6 +32,11 @@ export interface ImageGalleryProps {
     enableLightbox?: boolean;
     enablePinchZoom?: boolean;
     onIndexChange?: (idx: number) => void;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     /**
      * When true, renders the component as its authored skeleton placeholder shape.
      * The placeholder mirrors the real layout's footprint so the UI doesn't reflow

package/lib/typescript/module/components/KeyboardAwareScrollView/KeyboardAwareScrollView.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { ScrollView } from 'react-native';
+import type { ScrollViewProps } from 'react-native';
+export interface KeyboardAwareScrollViewProps extends ScrollViewProps {
+    /** Gap kept between the focused field and the top of the keyboard. Default 24. */
+    extraScrollHeight?: number;
+    /** Disable the keyboard-following behaviour (still a normal ScrollView). Default false. */
+    disabled?: boolean;
+}
+/**
+ * A ScrollView that keeps the focused input visible above the keyboard — no
+ * native dependency. On keyboard show it pads the content by the keyboard
+ * height and scrolls the focused TextInput so its bottom sits `extraScrollHeight`
+ * above the keyboard, but only when it would otherwise be covered (so already-
+ * visible fields don't jump). The classic measure-and-scroll approach, in pure RN.
+ */
+declare const KeyboardAwareScrollView: React.ForwardRefExoticComponent<KeyboardAwareScrollViewProps & React.RefAttributes<ScrollView>>;
+export { KeyboardAwareScrollView };
+export default KeyboardAwareScrollView;
+//# sourceMappingURL=KeyboardAwareScrollView.d.ts.map

package/lib/typescript/module/components/KeyboardAwareScrollView/index.d.ts

@@ -0,0 +1,3 @@
+export { KeyboardAwareScrollView } from './KeyboardAwareScrollView';
+export type { KeyboardAwareScrollViewProps } from './KeyboardAwareScrollView';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/KeyboardToolbar/KeyboardToolbar.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface KeyboardToolbarProps {
+    /** Label for the dismiss button. Default 'Done'. */
+    doneLabel?: string;
+    /** Show the prev/next chevrons. Default: true when prev/next handlers resolve. */
+    showNavigation?: boolean;
+    /** Override the dismiss action. Default: `Keyboard.dismiss()`. */
+    onDone?: () => void;
+    /** Override "next field". Default: the surrounding `<Form>`'s `focusNext`. */
+    onNext?: () => void;
+    /** Override "previous field". Default: the surrounding `<Form>`'s `focusPrev`. */
+    onPrev?: () => void;
+    /** Custom content rendered between the nav chevrons and the Done button. */
+    leading?: React.ReactNode;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/**
+ * An accessory bar pinned just above the keyboard — pure RN, no native
+ * dependency. Shows a Done (dismiss) button and optional prev/next chevrons
+ * that, inside a `<Form>`, walk the registered field order. Render it at the
+ * screen root (a `flex: 1` ancestor) so its `bottom: keyboardHeight` offset
+ * lands it on top of the keyboard. Renders nothing while the keyboard is hidden.
+ */
+declare const KeyboardToolbar: React.FC<KeyboardToolbarProps>;
+export { KeyboardToolbar };
+export default KeyboardToolbar;
+//# sourceMappingURL=KeyboardToolbar.d.ts.map

package/lib/typescript/module/components/KeyboardToolbar/index.d.ts

@@ -0,0 +1,3 @@
+export { KeyboardToolbar } from './KeyboardToolbar';
+export type { KeyboardToolbarProps } from './KeyboardToolbar';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/ListItem/ListItem.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { GestureResponderEvent, StyleProp, TextStyle, View as RNView, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 import type { SwipeableAction } from '../Swipeable';
 export type ListItemSize = 'sm' | 'md' | 'lg';
 export interface ListItemProps {
@@ -15,6 +16,8 @@ export interface ListItemProps {
     left?: React.ReactNode;
     right?: React.ReactNode;
     onPress?: (event: GestureResponderEvent) => void;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     selected?: boolean;
     disabled?: boolean;
     size?: ListItemSize;

package/lib/typescript/module/components/Modal/Modal.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { StyleProp, View as RNView, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 export type ModalPresentation = 'centered' | 'bottom' | 'fullScreen';
 export interface ModalProps {
     visible: boolean;
@@ -21,6 +22,11 @@ export interface ModalProps {
      * Opt-in: when undefined, focus behaviour is unchanged.
      */
     restoreFocusRef?: React.RefObject<RNView | null>;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     testID?: string;
 }
 declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<View>>;

package/lib/typescript/module/components/NumberInput/NumberInput.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { StyleProp, TextInputProps, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type NumberInputSize = 'sm' | 'md' | 'lg';
 export type NumberInputVariant = 'inline' | 'horizontal' | 'stacked';
 export interface NumberInputRef {
@@ -8,8 +9,9 @@ export interface NumberInputRef {
     clear: () => void;
 }
 export interface NumberInputProps {
-    value: number;
-    onChange: (value: number) => void;
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number) => void;
     min?: number;
     max?: number;
     step?: number;
@@ -22,6 +24,8 @@ export interface NumberInputProps {
     size?: NumberInputSize;
     variant?: NumberInputVariant;
     unit?: string;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/OTPInput/OTPInput.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type OTPInputSize = 'sm' | 'md' | 'lg';
 export interface OTPInputRef {
     focus: () => void;
@@ -7,8 +8,9 @@ export interface OTPInputRef {
     clear: () => void;
 }
 export interface OTPInputProps {
-    value: string;
-    onChange: (value: string) => void;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
     onComplete?: (value: string) => void;
     length?: number;
     keyboardType?: 'number-pad' | 'default';
@@ -17,6 +19,11 @@ export interface OTPInputProps {
     error?: boolean | string;
     size?: OTPInputSize;
     secure?: boolean;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     cellStyle?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/Radio/Radio.d.ts

@@ -7,7 +7,7 @@ export type RadioTone = 'primary' | 'success' | 'warning' | 'error';
 export type RadioValue = string | number;
 export interface RadioGroupContextValue {
     selectedValue: RadioValue | undefined;
-    onSelect: (value: RadioValue) => void;
+    onChange: (value: RadioValue) => void;
     disabled: boolean;
 }
 export declare const RadioGroupContext: React.Context<RadioGroupContextValue | null>;
@@ -15,7 +15,7 @@ export declare const useRadioGroup: () => RadioGroupContextValue | null;
 export interface RadioProps extends Omit<PressableProps, 'style' | 'children' | 'onPress'> {
     value: RadioValue;
     selected?: boolean;
-    onSelect?: (value: RadioValue) => void;
+    onChange?: (value: RadioValue) => void;
     disabled?: boolean;
     label?: string;
     size?: RadioSize;

package/lib/typescript/module/components/Radio/RadioGroup.d.ts

@@ -2,8 +2,9 @@ import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 import type { RadioValue } from './Radio';
 export interface RadioGroupProps {
-    value: RadioValue;
-    onChange: (value: RadioValue) => void;
+    value?: RadioValue;
+    defaultValue?: RadioValue;
+    onChange?: (value: RadioValue) => void;
     children: React.ReactNode;
     disabled?: boolean;
     accessibilityLabel?: string;

package/lib/typescript/module/components/Rating/Rating.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { StyleProp, View as RNView, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 export type RatingTone = 'primary' | 'warning';
 export type RatingSize = 'sm' | 'md' | 'lg' | number;
 export interface RatingProps {
@@ -17,6 +18,11 @@ export interface RatingProps {
      * when data arrives. Use this while the data driving the component is being fetched.
      */
     loading?: boolean;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/SearchBar/SearchBar.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { TextInput } from 'react-native';
 import type { StyleProp, TextInputProps, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 export type SearchBarSize = 'sm' | 'md' | 'lg';
 export type SearchBarVariant = 'filled' | 'outlined';
 export interface SearchBarProps extends Omit<TextInputProps, 'style' | 'value' | 'onChangeText'> {
@@ -19,6 +20,8 @@ export interface SearchBarProps extends Omit<TextInputProps, 'style' | 'value' |
     size?: SearchBarSize;
     variant?: SearchBarVariant;
     cancelLabel?: string;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     style?: StyleProp<ViewStyle>;
     accessibilityLabel?: string;
     testID?: string;

package/lib/typescript/module/components/SegmentedControl/SegmentedControl.d.ts

@@ -8,6 +8,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type SegmentedControlSize = 'sm' | 'md';
 export type SegmentedControlTone = 'primary' | 'neutral';
 export type SegmentValue = string | number;
@@ -18,12 +19,15 @@ export interface SegmentItem {
 }
 export interface SegmentedControlProps {
     segments: SegmentItem[];
-    value: SegmentValue;
-    onChange: (value: SegmentValue) => void;
+    value?: SegmentValue;
+    defaultValue?: SegmentValue;
+    onChange?: (value: SegmentValue) => void;
     size?: SegmentedControlSize;
     fullWidth?: boolean;
     disabled?: boolean;
     tone?: SegmentedControlTone;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/Select/Select.d.ts

@@ -8,6 +8,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type SelectSize = 'sm' | 'md' | 'lg';
 export type SelectValue = string | number;
 export interface SelectOption {
@@ -38,6 +39,11 @@ interface BaseSelectProps<T = SelectOption> {
     getOptionIcon?: (option: T) => React.ReactNode;
     placeholder?: string;
     searchable?: boolean;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     label?: string;
     error?: string;
     disabled?: boolean;

package/lib/typescript/module/components/Slider/Slider.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type SliderTone = 'primary' | 'success' | 'warning' | 'error';
 export type SliderSize = 'sm' | 'md' | 'lg';
 interface SliderCommonProps {
@@ -13,6 +14,8 @@ interface SliderCommonProps {
     showLabel?: boolean;
     formatLabel?: (value: number) => string;
     accessibilityLabel?: string;
+    /** Haptic feedback for drag/step/tap. Pass false to disable; pass a HapticType to override. */
+    haptic?: HapticType | false;
     style?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;
     trackStyle?: StyleProp<ViewStyle>;
@@ -29,13 +32,15 @@ interface SliderCommonProps {
 }
 interface SliderSingleProps extends SliderCommonProps {
     range?: false;
-    value: number;
-    onChange: (value: number) => void;
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number) => void;
 }
 interface SliderRangeProps extends SliderCommonProps {
     range: true;
-    value: [number, number];
-    onChange: (value: [number, number]) => void;
+    value?: [number, number];
+    defaultValue?: [number, number];
+    onChange?: (value: [number, number]) => void;
 }
 export type SliderProps = SliderSingleProps | SliderRangeProps;
 declare const Slider: React.ForwardRefExoticComponent<SliderProps & React.RefAttributes<View>>;

package/lib/typescript/module/components/Spinner/Spinner.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { StyleProp, ViewStyle } from 'react-native';
-export type SpinnerSize = 'small' | 'medium' | 'large';
+export type SpinnerSize = 'sm' | 'md' | 'lg';
 export type SpinnerVariant = 'circular' | 'dots';
 export interface SpinnerProps {
     size?: SpinnerSize;

package/lib/typescript/module/components/Stepper/Stepper.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { StyleProp, TextStyle, View as RNView, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 export type StepperVariant = 'horizontal' | 'vertical';
 export type StepperTone = 'primary' | 'success';
 export interface StepperStep {
@@ -33,6 +34,11 @@ export interface StepperProps {
     circleStyle?: StyleProp<ViewStyle>;
     labelStyle?: StyleProp<TextStyle>;
     connectorStyle?: StyleProp<ViewStyle>;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
     testID?: string;
 }
 declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<RNView>> & {

package/lib/typescript/module/components/Swipeable/Swipeable.d.ts

@@ -16,6 +16,7 @@
  */
 import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type SwipeableTone = 'primary' | 'success' | 'warning' | 'error' | 'neutral';
 export interface SwipeableAction {
     key: string;
@@ -35,6 +36,8 @@ export interface SwipeableProps {
     onSwipeOpen?: (side: 'left' | 'right') => void;
     onSwipeClose?: () => void;
     disabled?: boolean;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     containerStyle?: StyleProp<ViewStyle>;
     contentStyle?: StyleProp<ViewStyle>;
     actionStyle?: StyleProp<ViewStyle>;

package/lib/typescript/module/components/Switch/Switch.d.ts

@@ -5,8 +5,9 @@ import type { HapticType } from '../../utils/hapticUtils';
 export type SwitchSize = 'sm' | 'md' | 'lg';
 export type SwitchTone = 'primary' | 'success' | 'warning' | 'error';
 export interface SwitchProps extends Omit<PressableProps, 'style' | 'children' | 'onPress'> {
-    value: boolean;
-    onValueChange: (value: boolean) => void;
+    value?: boolean;
+    defaultValue?: boolean;
+    onChange?: (value: boolean) => void;
     disabled?: boolean;
     size?: SwitchSize;
     tone?: SwitchTone;

package/lib/typescript/module/components/Tabs/Tabs.d.ts

@@ -11,6 +11,7 @@
 import React from 'react';
 import { Animated, View } from 'react-native';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
 export type TabsVariant = 'underline' | 'pills';
 export type TabsAlign = 'left' | 'center';
 export interface TabItem {
@@ -52,6 +53,8 @@ export interface TabsProps {
      * progress value catches up.
      */
     progress?: Animated.AnimatedInterpolation<number> | Animated.Value;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
     accessibilityLabel?: string;
     testID?: string;
 }

package/lib/typescript/module/components/Text/Text.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import { Text as RNText } from 'react-native';
+import type { StyleProp, TextProps as RNTextProps, TextStyle } from 'react-native';
+import type { FontWeightKey } from '../../theme';
+import type { TypographyScale } from '../../theme/types';
+export type TextVariant = 'display' | 'h1' | 'h2' | 'h3' | 'title' | 'body' | 'bodySmall' | 'caption' | 'label' | 'overline';
+export type TextColor = 'primary' | 'secondary' | 'tertiary' | 'inverse' | 'disabled' | 'link' | 'success' | 'warning' | 'error' | 'info';
+export interface TextProps extends Omit<RNTextProps, 'style'> {
+    variant?: TextVariant;
+    /** Text role token, semantic tone, or a raw colour string. Defaults per variant. */
+    color?: TextColor | (string & {});
+    /** Override the variant's weight. */
+    weight?: FontWeightKey;
+    /** Override the variant's size — a typography token or a pixel number. */
+    size?: keyof TypographyScale['fontSize'] | number;
+    align?: TextStyle['textAlign'];
+    italic?: boolean;
+    underline?: boolean;
+    children?: React.ReactNode;
+    style?: StyleProp<TextStyle>;
+}
+declare const Text: React.ForwardRefExoticComponent<TextProps & React.RefAttributes<RNText>>;
+export { Text };
+export default Text;
+//# sourceMappingURL=Text.d.ts.map

package/lib/typescript/module/components/Text/index.d.ts

@@ -0,0 +1,3 @@
+export { Text } from './Text';
+export type { TextProps, TextVariant, TextColor } from './Text';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/TimePicker/TimePicker.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
 import type { FieldBaseSize, FieldBaseVariant } from '../FieldBase';
 export type TimeFormat = '12h' | '24h';
 export type Period = 'AM' | 'PM';
@@ -11,19 +12,19 @@ export interface TimeValue {
 /**
  * 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.
  */
 export interface TimePickerProps {
     /** Controlled-modal visibility. When omitted, the component enters trigger mode. */
     visible?: boolean;
     value?: TimeValue | null;
-    onSelect?: (time: TimeValue) => void;
+    onChange?: (time: TimeValue) => void;
     onClose?: () => void;
     format?: TimeFormat;
     minuteStep?: MinuteStep;
@@ -52,6 +53,8 @@ export interface TimePickerProps {
     formatValue?: (time: TimeValue) => string;
     /** Style passed through to the PickerTrigger field row. */
     triggerStyle?: StyleProp<ViewStyle>;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
 }
 declare const TimePicker: React.FC<TimePickerProps>;
 export { TimePicker };

package/lib/typescript/module/components/index.d.ts

@@ -1,5 +1,7 @@
 export { Accordion, AccordionGroup } from './Accordion';
 export type { AccordionProps, AccordionGroupProps, AccordionVariant } from './Accordion';
+export { AnimatePresence } from './AnimatePresence';
+export type { AnimatePresenceProps, PresencePreset } from './AnimatePresence';
 export { Avatar, AvatarGroup } from './Avatar';
 export type { AvatarProps, AvatarShape, AvatarSize, AvatarStatus, AvatarGroupProps, AvatarGroupSpacing, AvatarGroupOverflowVariant } from './Avatar';
 export { Badge } from './Badge';
@@ -12,6 +14,14 @@ export { BottomSheet, useBottomSheet } from './BottomSheet';
 export type { BottomSheetContextValue, BottomSheetProps, BottomSheetRef } from './BottomSheet';
 export { Button } from './Button';
 export type { ButtonProps, ButtonVariant, ButtonTone, ButtonSize } from './Button';
+export { Box, Stack, Row, Spacer } from './Box';
+export type { BoxProps, StackProps, RowProps, SpacerProps } from './Box';
+export { Text } from './Text';
+export type { TextProps, TextVariant, TextColor } from './Text';
+export { KeyboardAwareScrollView } from './KeyboardAwareScrollView';
+export type { KeyboardAwareScrollViewProps } from './KeyboardAwareScrollView';
+export { KeyboardToolbar } from './KeyboardToolbar';
+export type { KeyboardToolbarProps } from './KeyboardToolbar';
 export { Card } from './Card';
 export type { CardProps, CardVariant, CardElevation, CardPadding, CardRadius } from './Card';
 export { Carousel } from './Carousel';

package/lib/typescript/module/form/FormContext.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { FormApi, FormValues } from './types';
+export interface FormProps {
+    /** The object returned by {@link useForm}. */
+    form: FormApi<FormValues>;
+    children: React.ReactNode;
+}
+/**
+ * Provides a {@link useForm} instance to descendants so `<FormField name>`,
+ * {@link useField} and {@link useFieldArray} can bind by name.
+ */
+export declare const Form: React.FC<FormProps>;
+/** Read the surrounding form. Throws if there is no `<Form>` ancestor. */
+export declare function useFormContext<Values extends FormValues = FormValues>(): FormApi<Values>;
+/** Read the surrounding form, or null when there is no `<Form>` ancestor. */
+export declare function useOptionalFormContext(): FormApi<FormValues> | null;
+//# sourceMappingURL=FormContext.d.ts.map

package/lib/typescript/module/form/index.d.ts

@@ -0,0 +1,9 @@
+export { useForm } from './useForm';
+export { useField, useFieldArray } from './useField';
+export type { FieldArrayApi } from './useField';
+export { Form, useFormContext, useOptionalFormContext } from './FormContext';
+export type { FormProps } from './FormContext';
+export { getPath, setPath, deletePath } from './path';
+export * as rules from './rules';
+export type { FormApi, FormConfig, FormValues, FormErrors, FormTouched, FieldState, FieldInputProps, FocusableNode, ValidationRule, ValidationResult, FieldRules, ValidationSchema, FormValidateFn, ValidateOn, SubmitHelpers } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/form/path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export declare const getPath: (obj: unknown, path: string) => unknown;
+export declare const setPath: <T>(obj: T, path: string, value: unknown) => T;
+export declare const deletePath: <T>(obj: T, path: string) => T;
+//# sourceMappingURL=path.d.ts.map

package/lib/typescript/module/form/rules.d.ts

@@ -0,0 +1,31 @@
+import type { PasswordRules } from '../validators';
+import type { FormValues, ValidationRule } from './types';
+export declare const required: (message?: string) => ValidationRule;
+export declare const email: (message?: string) => ValidationRule;
+export declare const mobile: (message?: string) => ValidationRule;
+export declare const phone: (message?: string) => ValidationRule;
+export declare const url: (message?: string) => ValidationRule;
+export declare const numeric: (message?: string) => ValidationRule;
+export declare const integer: (message?: string) => ValidationRule;
+export declare const alphanumeric: (message?: string) => ValidationRule;
+export declare const pincode: (message?: string) => ValidationRule;
+export declare const pan: (message?: string) => ValidationRule;
+export declare const gstin: (message?: string) => ValidationRule;
+export declare const aadhaar: (message?: string) => ValidationRule;
+export declare const ifsc: (message?: string) => ValidationRule;
+export declare const minLength: (length: number, message?: string) => ValidationRule;
+export declare const maxLength: (length: number, message?: string) => ValidationRule;
+export declare const min: (n: number, message?: string) => ValidationRule;
+export declare const max: (n: number, message?: string) => ValidationRule;
+export declare const pattern: (regex: RegExp, message?: string) => ValidationRule;
+export declare const oneOf: (allowed: readonly unknown[], message?: string) => ValidationRule;
+/** Cross-field equality (e.g. confirm-password). `otherField` is a field path. */
+export declare const matches: (otherField: string, message?: string) => ValidationRule<unknown, FormValues>;
+export declare const strongPassword: (rules?: PasswordRules, message?: string) => ValidationRule;
+/**
+ * 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 declare const custom: (fn: (value: any, allValues: FormValues) => boolean | string | Promise<boolean | string>, message?: string) => ValidationRule;
+//# sourceMappingURL=rules.d.ts.map