@multiplatform.one/forms 6.1.0 → 6.3.0

package/types/FieldDisplay/editMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editMode.d.ts","sourceRoot":"","sources":["../../src/FieldDisplay/editMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAwC9D,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAGzE"}

package/types/FieldDisplay/formatters.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared read-only value formatters.
+ *
+ * FieldDisplay (table cells) and frappe-ui's ReadOnly field both format
+ * through these so the same value renders identically in a table read cell
+ * and a Frappe read-only field. Keep formatting logic here, not inline in
+ * either component.
+ */
+export declare const EMPTY = "\u2014";
+export declare function asText(v: any): string;
+export interface NumericFormatOptions {
+    precision?: number;
+    /** ISO 4217 currency code, e.g. "USD". */
+    currency?: string;
+}
+export declare function formatNumericText(num: number, options?: NumericFormatOptions): string;
+export { ISO_DATE_ONLY } from "@multiplatform.one/theme";
+export interface DateFormatOptions {
+    withTime?: boolean;
+    dateFormat?: string;
+}
+/**
+ * Read-only date cells speak the house absolute register (LC-12 / DF-14):
+ * "Jul 1" / "Jul 1, 2025" (year auto-elided when current), "Aug 9, 3:30 PM"
+ * with time — one voice with Timeline and picker display values, never raw
+ * ISO or verbose locale output. `dateFormat` is accepted for compatibility
+ * but the register channel owns the shape.
+ */
+export declare function formatDateText(value: any, options?: DateFormatOptions): string;
+//# sourceMappingURL=formatters.d.ts.map

package/types/FieldDisplay/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/FieldDisplay/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,KAAK,WAAM,CAAC;AAEzB,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAYrC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAczF;AAGD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAIlF"}

package/types/FieldDisplay/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * FieldDisplay — read-only render variants for every field type.
+ *
+ * The DataTable cell pipeline mounts FieldDisplay (cheap, view-only) when a
+ * cell is read-only, and the full Field component (Edit variant) only when
+ * the cell is being edited. This keeps large tables performant and gives
+ * heavy fields (FileUpload, Signature, ColorPicker, etc.) a purpose-built
+ * compact representation rather than rendering their edit UI in disabled state.
+ *
+ * Field type union mirrors `DataTableField` in @multiplatform.one/table; we
+ * keep the dispatcher centralized here so forms owns both Edit and Display
+ * variants. If a type isn't mapped, we fall back to a plain truncated text node.
+ *
+ * Slice 1 covers six representative types (input, numeric, date, choice,
+ * boolean, color) to validate the dispatch pattern. Remaining types fall
+ * through to the text fallback until expanded.
+ */
+export type FieldDisplayType = "input" | "textarea" | "mentioninput" | "stepper" | "slider" | "select" | "combobox" | "radiogroup" | "togglegroup" | "checkbox" | "switch" | "datepicker" | "datetimepicker" | "timepicker" | "daterangepicker" | "multidatepicker" | "duration" | "colorpicker" | "phoneinput" | "otp" | "barcode" | "rating" | "progress" | "fileupload" | "image" | "signature" | "geolocation" | "richtexteditor" | "markdowneditor" | "codeeditor" | "custom";
+export interface FieldDisplayProps {
+    field?: FieldDisplayType;
+    value: any;
+    fieldProps?: Record<string, any>;
+    /** For linked daterange columns. */
+    linkedValue?: any;
+}
+export declare function FieldDisplay({ field, value, fieldProps, linkedValue, }: FieldDisplayProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/types/FieldDisplay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/FieldDisplay/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,UAAU,GACV,cAAc,GACd,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,aAAa,GACb,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,KAAK,GACL,SAAS,GACT,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,OAAO,GACP,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,oCAAoC;IACpC,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AA2OD,wBAAgB,YAAY,CAAC,EAC3B,KAAe,EACf,KAAK,EACL,UAAU,EACV,WAAW,GACZ,EAAE,iBAAiB,2CAkEnB"}

package/types/FieldGroup.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+import { type FormGridColumns } from "./FormGrid";
+export interface FieldGroupProps {
+    /** Visible legend / group label (required — DG-FORM-06 fieldset grouping). */
+    legend: string;
+    children: ReactNode;
+    /**
+     * Multi-field horizontal group. Defaults to 1; use 2 for side-by-side pairs
+     * that collapse on narrow containers via FormGrid.
+     */
+    columns?: FormGridColumns;
+    /** Gap between fields. Default: formFieldGap token. */
+    gap?: number | string;
+}
+/**
+ * Groups related fields with a legend (fieldset on web).
+ *
+ * Field gap uses {@link formFieldGap}; nest inside {@link FormSection} so
+ * section spacing stays larger than field spacing.
+ */
+export declare function FieldGroup({ legend, children, columns, gap }: FieldGroupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FieldGroup.d.ts.map

package/types/FieldGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldGroup.d.ts","sourceRoot":"","sources":["../src/FieldGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAW,EAAE,GAAkB,EAAE,EAAE,eAAe,2CAsDhG"}

package/types/FloatingPanel/index.d.ts

@@ -0,0 +1,81 @@
+import type { ReactNode } from "react";
+export { useFloatingPanel, panelAnimationDuration, panelGrowDuration, panelTransition, panelViewportPadding, } from "./useFloatingPanel";
+export type { UseFloatingPanelOptions, UseFloatingPanelReturn } from "./useFloatingPanel";
+export interface FloatingPanelProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    trigger: ReactNode;
+    /**
+     * Optional control rendered beside the trigger but OUTSIDE the native press
+     * capture (e.g. DatePicker/ColorPicker clear). On native the trigger subtree
+     * uses pointerEvents="none" so XGroup cannot steal the open gesture; anything
+     * that must keep its own onPress belongs here.
+     */
+    triggerEnd?: ReactNode;
+    children: ReactNode;
+    scrollable?: boolean;
+    disabled?: boolean;
+    /**
+     * Force Sheet mode (slide-up panel) even on desktop.
+     * When undefined: Sheet on native and sm screens (≤860px),
+     * floating panel on larger web screens.
+     */
+    sheet?: boolean;
+    /**
+     * Sizing mode for the web floating panel.
+     * - `"grow"` (default): opens from the trigger to the nearest viewport
+     *    edge, then grows as the user scrolls.
+     * - `"fill"`: opens at the maximum available viewport size immediately.
+     *    If content is smaller it shrinks to fit (same as "grow" visually).
+     */
+    sizing?: "grow" | "fill";
+    /**
+     * When true, the floating panel width is based on its content rather than
+     * matching the trigger element width. Useful for pickers like Calendar
+     * and ColorPicker that have fixed-width content.
+     */
+    fitContent?: boolean;
+    /**
+     * Content padding for both sheet and web floating panel.
+     * Use "none" for self-contained widgets (ColorPicker, DatePicker, TimePicker)
+     * that handle their own internal spacing.
+     */
+    contentPadding?: "none" | "default";
+    /**
+     * Tamagui transition token for sheet/overlay animations.
+     */
+    transition?: string;
+    /**
+     * Fixed header rendered above the scrollable content (e.g. search bar in Combobox).
+     * Only applies in sheet mode.
+     */
+    header?: ReactNode;
+    /**
+     * Native sheet mode: open the sheet at its full height (85% of the window)
+     * with the scroll area filling it, instead of content-driven height.
+     * For search-driven panels whose result list streams in as the user types
+     * (Awesomebar, Link fields) a content-fit sheet opens as a sliver showing
+     * only the search input. Web small-viewport sheets get the tall treatment
+     * from `scrollable` (percent snap points) instead.
+     */
+    sheetFill?: boolean;
+    /**
+     * Props passed to Sheet.ScrollView when scrollable. Use for onScroll (e.g. infinite load).
+     */
+    scrollViewProps?: Record<string, unknown>;
+    /**
+     * Native-only (iOS/Android): explicit VoiceOver/TalkBack name, value, and
+     * hint for the sheet trigger Pressable. On native the trigger subtree is
+     * pointerEvents="none", so its aria wiring never reaches the screen reader —
+     * the strings must live on the Pressable itself. Web ignores this.
+     */
+    triggerA11y?: {
+        label?: string;
+        value?: string;
+        hint?: string;
+    };
+}
+/** Viewport-based gtSm that updates on resize (useMedia may not re-render on resize). */
+export declare function useViewportGtSm(): boolean;
+export declare function FloatingPanel(props: FloatingPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/types/FloatingPanel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/FloatingPanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,OAAO,CAAC;AAYhD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAI1F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,SAAS,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAOD,yFAAyF;AACzF,wBAAgB,eAAe,YAW9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAUtD"}

package/types/FloatingPanel/index.native.d.ts

@@ -0,0 +1,39 @@
+/**
+ * FloatingPanel (native) — React Native Modal bottom sheet.
+ *
+ * The web implementation (./index.tsx) anchors a floating-ui panel to the
+ * trigger and falls back to a Tamagui `Sheet modal` on small viewports and
+ * native. On device (Expo Go, tamagui 2.0.0-rc.41) the modal Sheet's
+ * portal/animation machinery never presents — tapping a Select or Date
+ * trigger flips `open` and nothing appears. This native variant swaps the
+ * overlay for a core React Native `Modal`, which is a native view-controller
+ * presentation: no portal host, no animation driver, no DOM measurement.
+ *
+ * Same public API as ./index.tsx. Web bundles never load this file
+ * (tamagui-build emits it only into the *.native.js outputs).
+ *
+ * Semantics preserved from the sheet path:
+ * - tap trigger → sheet slides up from the bottom (full width, themed
+ *   surface, drag-handle affordance, safe-area padding)
+ * - selecting a value commits (the field's own onValueChange) and the field
+ *   closes the panel
+ * - backdrop tap and the Android back button dismiss WITHOUT committing
+ *
+ * Hit-testing / open-race notes:
+ * - Fabric + Tamagui XGroup steal the responder without firing onPress, so
+ *   this Pressable owns the open gesture and forces pointerEvents="none" on
+ *   the trigger tree. Interactive siblings (clear) MUST use `triggerEnd`.
+ * - If both this Pressable and a child onPress toggle `open` in the same
+ *   gesture, React batches setOpen(true) then setOpen(prev => !prev) → false
+ *   and the sheet never appears. Fields should not also toggle open on native.
+ * - Opening a Modal under the same finger can synthesize a backdrop press;
+ *   backdrop dismiss is armed only after Modal.onShow + a short delay.
+ */
+import type { FloatingPanelProps } from "./index";
+export { useFloatingPanel, panelAnimationDuration, panelGrowDuration, panelTransition, panelViewportPadding, } from "./useFloatingPanel";
+export type { UseFloatingPanelOptions, UseFloatingPanelReturn } from "./useFloatingPanel";
+export type { FloatingPanelProps } from "./index";
+/** Native never has a >sm web viewport; AdaptivePopup uses this to pick Sheet mode. */
+export declare function useViewportGtSm(): boolean;
+export declare function FloatingPanel({ open, onOpenChange, trigger, triggerEnd, children, scrollable, disabled, contentPadding, header, scrollViewProps, triggerA11y, sheetFill, }: FloatingPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.native.d.ts.map

package/types/FloatingPanel/index.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../src/FloatingPanel/index.native.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAgBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAKlD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,uFAAuF;AACvF,wBAAgB,eAAe,YAE9B;AAOD,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,cAA0B,EAC1B,MAAM,EACN,eAAe,EACf,WAAW,EACX,SAAS,GACV,EAAE,kBAAkB,2CA+IpB"}

package/types/FloatingPanel/useFloatingPanel.d.ts

@@ -0,0 +1,64 @@
+import type { Middleware, Placement } from "@floating-ui/react";
+import { useFloating } from "@floating-ui/react";
+import { useResolvedKnobs } from "@multiplatform.one/theme";
+import { type Dispatch, type RefObject, type SetStateAction } from "react";
+export declare const panelAnimationDuration = 180;
+export declare const panelGrowDuration = 200;
+export declare const panelViewportPadding = 10;
+export declare const panelTransition = "opacity 180ms ease-out, transform 180ms ease-out, top 200ms ease-out, max-height 200ms ease-out, height 200ms ease-out";
+export interface UseFloatingPanelOptions {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    disabled?: boolean;
+    /** Called just before the panel opens (e.g. to reset consumer-owned refs). */
+    onBeforeOpen?: () => void;
+    /** Consumer's reposition function — called on page scroll / resize. */
+    repositionRef?: RefObject<(() => void) | null>;
+    /**
+     * When provided, page-scroll is also blocked when the user scrolls
+     * past the boundary of this element (useful when the scroll area is
+     * a child of the floating element, e.g. Combobox list area).
+     */
+    scrollBoundaryRef?: RefObject<HTMLElement | null>;
+    /** Override default middleware ([offset, size]). Pass [] to disable. */
+    middleware?: Middleware[];
+    /** Enable floating-ui autoUpdate (default true). */
+    useAutoUpdate?: boolean;
+    /**
+     * Boolean ref set to true on inside-panel wheel events.
+     * The scroll-lock handler (document-level capture) flips this and
+     * calls repositionRef, so consumers don't need a separate wheel listener.
+     */
+    wheelGrowRef?: RefObject<boolean>;
+    /**
+     * When true, the floating panel width is based on its content rather than
+     * matching the trigger element width.
+     */
+    fitContent?: boolean;
+}
+export interface UseFloatingPanelReturn {
+    context: ReturnType<typeof useFloating>["context"];
+    refs: ReturnType<typeof useFloating>["refs"];
+    x: number;
+    y: number;
+    strategy: ReturnType<typeof useFloating>["strategy"];
+    update: () => void;
+    mounted: boolean;
+    visible: boolean;
+    placement: Placement;
+    arrowUp: boolean;
+    arrowDown: boolean;
+    triggerRef: RefObject<HTMLElement | null>;
+    arrowScrollDirRef: RefObject<"up" | "down" | null>;
+    floatingStyleRef: RefObject<Record<string, any>>;
+    initializingRef: RefObject<boolean>;
+    computePlacement: () => void;
+    updateArrows: (element: HTMLElement) => void;
+    setReferenceRef: (node: HTMLElement | null) => void;
+    setMounted: Dispatch<SetStateAction<boolean>>;
+    dropdownRadius: string | 0;
+    hasBorder: boolean;
+    knobProps: ReturnType<typeof useResolvedKnobs>["knobProps"];
+}
+export declare function useFloatingPanel({ open, onOpenChange, disabled, onBeforeOpen, repositionRef, scrollBoundaryRef, middleware: middlewareProp, useAutoUpdate: useAutoUpdateProp, wheelGrowRef, fitContent, }: UseFloatingPanelOptions): UseFloatingPanelReturn;
+//# sourceMappingURL=useFloatingPanel.d.ts.map

package/types/FloatingPanel/useFloatingPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingPanel.d.ts","sourceRoot":"","sources":["../../src/FloatingPanel/useFloatingPanel.ts"],"names":[],"mappings":"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"}

package/types/Form/index.d.ts

@@ -0,0 +1,43 @@
+import { type FormApi, type FormOptions } from "@tanstack/react-form";
+import { type ReactNode } from "react";
+import { type FormProps as TamaguiFormProps } from "tamagui";
+import { type FormValidateOn } from "./validateOn";
+export type { FormValidateOn } from "./validateOn";
+export { resolveEffectiveValidateOn, remapValidatorsForTiming, type EffectiveValidateOn, } from "./validateOn";
+export declare const FormContext: import("react").Context<FormApi<any, any, any, any, any, any, any, any, any, any, any, any> | undefined>;
+export declare function useFormContext<TParentData, _TFormValidator = any>(): FormApi<TParentData, any, any, any, any, any, any, any, any, any, any, any>;
+export interface FormValidateContextValue {
+    validateOn: FormValidateOn;
+    /** True after ≥1 submit attempt (upgrades `"submit"` → blur-then-change). */
+    hasSubmitted: boolean;
+}
+export declare const FormValidateContext: import("react").Context<FormValidateContextValue>;
+export declare function useFormValidate(): FormValidateContextValue;
+export interface FormProps<TFormData, _TFormValidator = any> extends Omit<TamaguiFormProps, "onSubmit"> {
+    children: ReactNode;
+    form?: FormApi<TFormData, any, any, any, any, any, any, any, any, any, any, any>;
+    formOptions?: FormOptions<TFormData, any, any, any, any, any, any, any, any, any, any, any>;
+    onSubmit?: (values: TFormData) => void | Promise<void>;
+    syncWithUrl?: boolean;
+    urlDebounceMs?: number;
+    submitText?: string;
+    /**
+     * When true (default), render {@link ErrorSummary} above fields after a
+     * failed submit that produced field errors. Set false to opt out
+     * (embedded/inline forms).
+     */
+    showErrorSummary?: boolean;
+    /** Heading for the auto ErrorSummary. */
+    errorSummaryTitle?: string;
+    /**
+     * Preferred validation timing (DG-VAL-01). Default `"submit"`.
+     * After the first submit attempt, `"submit"` remaps field `onSubmit`
+     * validators onto blur + change so errors clear live (blur-then-change).
+     * Explicit `"blur"` / `"change"` always attach those listeners.
+     */
+    validateOn?: FormValidateOn;
+}
+export declare function Form<TFormData extends Record<string, any>, TFormValidator = any>({ children, form: providedForm, formOptions, onSubmit, syncWithUrl, urlDebounceMs, submitText: _submitText, showErrorSummary, errorSummaryTitle, validateOn, ...tamaguiFormProps }: FormProps<TFormData, TFormValidator>): import("react/jsx-runtime").JSX.Element;
+/** @internal test helper — effective timing for current FormValidate context. */
+export declare function useEffectiveValidateOn(): import("./validateOn").EffectiveValidateOn;
+//# sourceMappingURL=index.d.ts.map

package/types/Form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Form/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,EAAuB,KAAK,SAAS,IAAI,gBAAgB,EAAS,MAAM,SAAS,CAAC;AAGzF,OAAO,EAAE,KAAK,cAAc,EAA8B,MAAM,cAAc,CAAC;AAE/E,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,WAAW,0GAEZ,CAAC;AAEb,wBAAgB,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,GAAG,KAC7B,OAAO,CACvC,WAAW,EACX,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CACF;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,cAAc,CAAC;IAC3B,6EAA6E;IAC7E,YAAY,EAAE,OAAO,CAAC;CACvB;AAOD,eAAO,MAAM,mBAAmB,mDAAkE,CAAC;AAEnG,wBAAgB,eAAe,IAAI,wBAAwB,CAE1D;AAED,MAAM,WAAW,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,GAAG,CAAE,SAAQ,IAAI,CACvE,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACjF,WAAW,CAAC,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AA6ED,wBAAgB,IAAI,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,GAAG,EAAE,EAChF,QAAQ,EACR,IAAI,EAAE,YAAY,EAClB,WAAW,EACX,QAAQ,EACR,WAAmB,EACnB,aAAmB,EACnB,UAAU,EAAE,WAAW,EACvB,gBAAuB,EACvB,iBAAiB,EACjB,UAAqB,EACrB,GAAG,gBAAgB,EACpB,EAAE,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,2CAgHtC;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,+CAGrC"}

package/types/Form/validateOn.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Validation timing helpers (DG-VAL-01 / W2 residual).
+ *
+ * Default is submit-only. After the first submit attempt, `"submit"` upgrades
+ * to blur-then-change so inline errors clear live as the user edits.
+ */
+export type FormValidateOn = "submit" | "blur" | "change";
+/** Resolved listener set after applying the post-submit upgrade. */
+export type EffectiveValidateOn = "submit" | "blur" | "change" | "blur-then-change";
+export declare function resolveEffectiveValidateOn(validateOn: FormValidateOn, hasSubmitted: boolean): EffectiveValidateOn;
+/**
+ * Remap `onSubmit` validators onto blur/change listeners per timing policy.
+ * Existing onBlur/onChange validators are preserved and composed (run first).
+ */
+export declare function remapValidatorsForTiming(validators: Record<string, unknown> | undefined, effective: EffectiveValidateOn): Record<string, unknown> | undefined;
+//# sourceMappingURL=validateOn.d.ts.map

package/types/Form/validateOn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateOn.d.ts","sourceRoot":"","sources":["../../src/Form/validateOn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAEpF,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,cAAc,EAC1B,YAAY,EAAE,OAAO,GACpB,mBAAmB,CAKrB;AAUD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAuBrC"}

package/types/FormGrid.d.ts

@@ -0,0 +1,30 @@
+import { type ReactNode } from "react";
+/** Container/media width below which multi-column form grids collapse to 1 col. */
+export declare const FORM_GRID_COLLAPSE_WIDTH = 480;
+export type FormGridColumns = 1 | 2;
+export interface FormGridProps {
+    /**
+     * Requested columns when the container is comfortable.
+     * Default: 1 (DG-FORM-01 single-column default).
+     */
+    columns?: FormGridColumns;
+    /**
+     * Hard cap on columns (DG-FORM-01 / responsive 2-col groups).
+     * Default: 2.
+     */
+    maxColumns?: FormGridColumns;
+    /** Gap between fields in pixels. Default: 16 */
+    gap?: number;
+    children: ReactNode;
+}
+/**
+ * Lays out form fields in a grid with correct tab order (left-to-right across rows).
+ *
+ * List children in visual row order: [row1col1, row1col2, row2col1, row2col2, ...]
+ *
+ * Defaults to a single column. When `columns={2}`, expands to two columns only when
+ * the container is at least {@link FORM_GRID_COLLAPSE_WIDTH} wide (container measure
+ * on web; viewport media on native).
+ */
+export declare function FormGrid({ columns, maxColumns, gap, children }: FormGridProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FormGrid.d.ts.map

package/types/FormGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormGrid.d.ts","sourceRoot":"","sources":["../src/FormGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB;AASD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAW,EAAE,UAAc,EAAE,GAAQ,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAgB1F"}

package/types/FormSection.d.ts

@@ -0,0 +1,54 @@
+import type { ReactNode } from "react";
+export interface FormSectionProps {
+    /** Section heading / legend. */
+    label?: string;
+    children: ReactNode;
+    /**
+     * Cap readable width (DG-FORM-08). Pass `"fluid"` to opt out.
+     * Default: {@link formReadableMaxWidth} (560).
+     */
+    maxWidth?: number | "fluid";
+    /**
+     * Gap between fields inside the section. Defaults to the semantic
+     * within-group gap (`knobProps.gap`, DG-LAY-03) so the space knob
+     * restyles form rhythm; explicit values eject.
+     */
+    gap?: number | string;
+    /** Extra props forwarded to the outer stack (e.g. test ids). */
+    testID?: string;
+    /**
+     * When true (default), render semantic `<fieldset>` + `<legend>` on web
+     * so assistive tech groups the fields. Native keeps a heading label.
+     */
+    fieldset?: boolean;
+}
+/**
+ * Labeled form section with semantic gap rhythm.
+ *
+ * Field gap defaults to the within-group semantic gap (`knobProps.gap`);
+ * stack multiple sections with {@link FormSectionStack}, whose gap defaults
+ * to the between-groups gap (`knobProps.gapLg`) — always one step larger, so
+ * section rhythm stays larger than field rhythm at every space knob value
+ * (DG-FORM-06 / DG-LAY-03). Gallery **Fieldset** is this component (also
+ * exported as {@link Fieldset}).
+ */
+export declare function FormSection({ label, children, maxWidth, gap, testID, fieldset, }: FormSectionProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Gallery Fieldset — semantic fieldset/legend grouping.
+ * Alias of {@link FormSection} (same API, form-section rhythm tokens).
+ */
+export declare const Fieldset: typeof FormSection;
+export type FieldsetProps = FormSectionProps;
+export interface FormSectionStackProps {
+    children: ReactNode;
+    /**
+     * Gap between sections. Defaults to the semantic between-groups gap
+     * (`knobProps.gapLg`) — one step above the field gap at every space
+     * knob value (DG-FORM-06). Explicit values eject.
+     */
+    gap?: number | string;
+}
+/** Stacks FormSections with section > field spacing. */
+export declare function FormSectionStack({ children, gap }: FormSectionStackProps): import("react/jsx-runtime").JSX.Element;
+export { formFieldGap, formReadableMaxWidth, formSectionGap } from "./formSpacing";
+//# sourceMappingURL=FormSection.d.ts.map

package/types/FormSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.d.ts","sourceRoot":"","sources":["../src/FormSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,QAA+B,EAC/B,GAAG,EACH,MAAM,EACN,QAAe,GAChB,EAAE,gBAAgB,2CAgDlB;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,oBAAc,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,qBAAqB,2CAaxE;AAED,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}