@fogpipe/forma-react 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-import { FieldError, SelectOption, FieldDefinition, Forma, MatrixColumn, OptionsVisibilityResult, ValidationResult } from '@fogpipe/forma-core';
+import { FieldError, Forma, OptionsVisibilityResult, ValidationResult } from '@fogpipe/forma-core';
 export { ComputedField, FieldDefinition, FieldError, FieldType, Forma, PageDefinition, SelectOption, ValidationResult, ValidationRule } from '@fogpipe/forma-core';
-import * as React$1 from 'react';
-import React__default from 'react';
+import { G as GetFieldPropsResult, a as GetSelectFieldPropsResult, b as GetArrayHelpersResult, C as ComponentMap } from './FormRenderer-D_ZVK44t.js';
+export { v as ArrayComponentProps, A as ArrayFieldProps, j as ArrayHelpers, k as ArrayItemFieldProps, l as ArrayItemFieldPropsResult, B as BaseFieldProps, q as BooleanComponentProps, f as BooleanFieldProps, x as ComputedComponentProps, i as ComputedFieldProps, r as DateComponentProps, D as DateFieldProps, s as DateTimeComponentProps, g as DateTimeFieldProps, z as DisplayComponentProps, y as DisplayFieldProps, m as FieldComponentProps, e as FieldProps, K as FieldWrapperProps, F as FormRenderer, d as FormRendererHandle, c as FormRendererProps, p as IntegerComponentProps, I as IntegerFieldProps, J as LayoutProps, L as LegacyFieldProps, H as MatrixComponentProps, E as MatrixFieldProps, u as MultiSelectComponentProps, M as MultiSelectFieldProps, o as NumberComponentProps, N as NumberFieldProps, w as ObjectComponentProps, O as ObjectFieldProps, P as PageWrapperProps, t as SelectComponentProps, S as SelectFieldProps, h as SelectionFieldProps, n as TextComponentProps, T as TextFieldProps } from './FormRenderer-D_ZVK44t.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default from 'react';
 
 /**
  * Event system for forma-react
@@ -82,499 +84,6 @@ type FormaEvents = Partial<{
     [K in keyof FormaEventMap]: FormaEventListener<K>;
 }>;
 
-/**
- * Type definitions for forma-react components
- */
-
-/**
- * Base props shared by all field components
- */
-interface BaseFieldProps {
-    /** Field path/name */
-    name: string;
-    /** Field definition from the Forma spec */
-    field: FieldDefinition;
-    /** Current field value */
-    value: unknown;
-    /** Whether the field has been touched */
-    touched: boolean;
-    /** Whether the field is required */
-    required: boolean;
-    /** Whether the field is disabled */
-    disabled: boolean;
-    /** Validation errors for this field */
-    errors: FieldError[];
-    /** Handler for value changes */
-    onChange: (value: unknown) => void;
-    /** Handler for blur events */
-    onBlur: () => void;
-    /** Whether field is visible (always true since FormRenderer handles visibility) */
-    visible: boolean;
-    /** Whether field is enabled (inverse of disabled) */
-    enabled: boolean;
-    /** Whether field is readonly (visible, not editable, value still submitted) */
-    readonly: boolean;
-    /** Display label from field definition */
-    label: string;
-    /** Help text or description from field definition */
-    description?: string;
-    /** Placeholder text from field definition */
-    placeholder?: string;
-    /** Prefix adorner text (e.g., "$") - only for adornable field types */
-    prefix?: string;
-    /** Suffix adorner text (e.g., "kg") - only for adornable field types */
-    suffix?: string;
-    /** Presentation variant hint (e.g., "slider", "radio", "nps") */
-    variant?: string;
-    /** Variant-specific configuration */
-    variantConfig?: Record<string, unknown>;
-}
-/**
- * Props for text-based fields (text, email, password, url, textarea)
- */
-interface TextFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "text" | "phone" | "email" | "password" | "url" | "textarea";
-    value: string;
-    onChange: (value: string) => void;
-}
-/**
- * Props for number fields
- */
-interface NumberFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "number";
-    value: number | null;
-    onChange: (value: number | null) => void;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-/**
- * Props for integer fields
- */
-interface IntegerFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "integer";
-    value: number | null;
-    onChange: (value: number | null) => void;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-/**
- * Props for boolean fields
- */
-interface BooleanFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "boolean";
-    value: boolean;
-    onChange: (value: boolean) => void;
-}
-/**
- * Props for date fields
- */
-interface DateFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "date";
-    value: string | null;
-    onChange: (value: string | null) => void;
-}
-/**
- * Props for datetime fields
- */
-interface DateTimeFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "datetime";
-    value: string | null;
-    onChange: (value: string | null) => void;
-}
-/**
- * Props for select fields (single selection)
- */
-interface SelectFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "select";
-    value: string | null;
-    onChange: (value: string | null) => void;
-    options: SelectOption[];
-}
-/**
- * Props for multi-select fields
- */
-interface MultiSelectFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "multiselect";
-    value: string[];
-    onChange: (value: string[]) => void;
-    options: SelectOption[];
-}
-/**
- * Union type for all selection-based field props
- */
-type SelectionFieldProps = SelectFieldProps | MultiSelectFieldProps;
-/**
- * Array item field props returned by getItemFieldProps
- */
-interface ArrayItemFieldPropsResult {
-    /** Field path/name */
-    name: string;
-    /** Current field value */
-    value: unknown;
-    /** Field type */
-    type: string;
-    /** Display label */
-    label: string;
-    /** Help text or description */
-    description?: string;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether field is visible */
-    visible: boolean;
-    /** Whether field is enabled */
-    enabled: boolean;
-    /** Whether field is required */
-    required: boolean;
-    /** Whether field has been touched */
-    touched: boolean;
-    /** Validation errors for this field */
-    errors: FieldError[];
-    /** Handler for value changes */
-    onChange: (value: unknown) => void;
-    /** Handler for blur events */
-    onBlur: () => void;
-    /** Item index in the array */
-    itemIndex: number;
-    /** Field name within the item */
-    fieldName: string;
-    /** Options for select fields */
-    options?: SelectOption[];
-}
-/**
- * Array manipulation helpers
- */
-interface ArrayHelpers {
-    /** Current array items */
-    items: unknown[];
-    /** Add item to end of array */
-    push: (item?: unknown) => void;
-    /** Insert item at specific index */
-    insert: (index: number, item: unknown) => void;
-    /** Remove item at index */
-    remove: (index: number) => void;
-    /** Move item from one index to another */
-    move: (from: number, to: number) => void;
-    /** Swap items at two indices */
-    swap: (indexA: number, indexB: number) => void;
-    /** Get field props for an item field */
-    getItemFieldProps: (index: number, fieldName: string) => ArrayItemFieldPropsResult;
-    /** Minimum number of items allowed */
-    minItems: number;
-    /** Maximum number of items allowed */
-    maxItems: number;
-    /** Whether more items can be added */
-    canAdd: boolean;
-    /** Whether items can be removed */
-    canRemove: boolean;
-}
-/**
- * Props for array fields
- */
-interface ArrayFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "array";
-    value: unknown[];
-    onChange: (value: unknown[]) => void;
-    helpers: ArrayHelpers;
-    /** Item field definitions keyed by field name */
-    itemFields: Record<string, FieldDefinition>;
-    /** Explicit ordering for itemFields (jsonb does not preserve object key order) */
-    itemFieldOrder?: string[];
-    minItems?: number;
-    maxItems?: number;
-}
-/**
- * Props for object fields
- */
-interface ObjectFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "object";
-    value: Record<string, unknown>;
-    onChange: (value: Record<string, unknown>) => void;
-}
-/**
- * Props for computed fields (read-only)
- */
-interface ComputedFieldProps extends Omit<BaseFieldProps, "onChange"> {
-    fieldType: "computed";
-    value: unknown;
-    expression: string;
-    onChange?: never;
-}
-/**
- * Props for array item fields (within array context)
- */
-interface ArrayItemFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    /** The field type */
-    fieldType: string;
-    /** Current value */
-    value: unknown;
-    /** Change handler */
-    onChange: (value: unknown) => void;
-    /** Item index in the array */
-    itemIndex: number;
-    /** Field name within the item */
-    fieldName: string;
-}
-/**
- * Props for display fields (read-only presentation content)
- */
-interface DisplayFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "display";
-    /** Static content (markdown/text) */
-    content?: string;
-    /** Computed source value (resolved by useForma from display field's source property) */
-    sourceValue?: unknown;
-    /** Display format string */
-    format?: string;
-    /** No onChange - display fields are read-only */
-    onChange?: never;
-    value?: never;
-}
-/**
- * Props for matrix/grid fields
- */
-interface MatrixFieldProps extends Omit<BaseFieldProps, "value" | "onChange"> {
-    fieldType: "matrix";
-    /** Current matrix value: row ID → selected column value(s) */
-    value: Record<string, string | number | string[] | number[]> | null;
-    onChange: (value: Record<string, string | number | string[] | number[]>) => void;
-    /** Row definitions with visibility state */
-    rows: Array<{
-        id: string;
-        label: string;
-        visible: boolean;
-    }>;
-    /** Column definitions (shared options for all rows) */
-    columns: MatrixColumn[];
-    /** Whether multiple selections per row are allowed */
-    multiSelect: boolean;
-}
-/**
- * Union of all field prop types
- */
-type FieldProps = TextFieldProps | NumberFieldProps | IntegerFieldProps | BooleanFieldProps | DateFieldProps | DateTimeFieldProps | SelectFieldProps | MultiSelectFieldProps | ArrayFieldProps | ObjectFieldProps | ComputedFieldProps | DisplayFieldProps | MatrixFieldProps;
-/**
- * Map of field types to React components
- * Components receive wrapper props with { field, spec } structure
- */
-interface ComponentMap {
-    text?: React.ComponentType<TextComponentProps>;
-    phone?: React.ComponentType<TextComponentProps>;
-    email?: React.ComponentType<TextComponentProps>;
-    password?: React.ComponentType<TextComponentProps>;
-    url?: React.ComponentType<TextComponentProps>;
-    textarea?: React.ComponentType<TextComponentProps>;
-    number?: React.ComponentType<NumberComponentProps>;
-    integer?: React.ComponentType<IntegerComponentProps>;
-    boolean?: React.ComponentType<BooleanComponentProps>;
-    date?: React.ComponentType<DateComponentProps>;
-    datetime?: React.ComponentType<DateTimeComponentProps>;
-    select?: React.ComponentType<SelectComponentProps>;
-    multiselect?: React.ComponentType<MultiSelectComponentProps>;
-    array?: React.ComponentType<ArrayComponentProps>;
-    object?: React.ComponentType<ObjectComponentProps>;
-    computed?: React.ComponentType<ComputedComponentProps>;
-    display?: React.ComponentType<DisplayComponentProps>;
-    matrix?: React.ComponentType<MatrixComponentProps>;
-    fallback?: React.ComponentType<FieldComponentProps>;
-}
-/**
- * Props for custom layout components
- */
-interface LayoutProps {
-    children: React.ReactNode;
-    onSubmit: () => void;
-    isSubmitting: boolean;
-    isValid: boolean;
-}
-/**
- * Props for custom field wrapper components
- */
-interface FieldWrapperProps {
-    /** Field path/identifier */
-    fieldPath: string;
-    /** Field definition from the Forma spec */
-    field: FieldDefinition;
-    children: React.ReactNode;
-    errors: FieldError[];
-    touched: boolean;
-    required: boolean;
-    /**
-     * Whether to show the required indicator in the UI.
-     * False for boolean fields since false is a valid answer.
-     */
-    showRequiredIndicator: boolean;
-    visible: boolean;
-}
-/**
- * Props for page wrapper components (multi-page forms)
- */
-interface PageWrapperProps {
-    title: string;
-    description?: string;
-    children: React.ReactNode;
-    pageIndex: number;
-    totalPages: number;
-}
-/**
- * Wrapper type that includes spec alongside field props
- * Components receive { field, spec } instead of just FieldProps
- */
-interface TextComponentProps {
-    field: TextFieldProps;
-    spec: Forma;
-}
-interface NumberComponentProps {
-    field: NumberFieldProps;
-    spec: Forma;
-}
-interface IntegerComponentProps {
-    field: IntegerFieldProps;
-    spec: Forma;
-}
-interface BooleanComponentProps {
-    field: BooleanFieldProps;
-    spec: Forma;
-}
-interface DateComponentProps {
-    field: DateFieldProps;
-    spec: Forma;
-}
-interface DateTimeComponentProps {
-    field: DateTimeFieldProps;
-    spec: Forma;
-}
-interface SelectComponentProps {
-    field: SelectFieldProps;
-    spec: Forma;
-}
-interface MultiSelectComponentProps {
-    field: MultiSelectFieldProps;
-    spec: Forma;
-}
-interface ArrayComponentProps {
-    field: ArrayFieldProps;
-    spec: Forma;
-}
-interface ObjectComponentProps {
-    field: ObjectFieldProps;
-    spec: Forma;
-}
-interface ComputedComponentProps {
-    field: ComputedFieldProps;
-    spec: Forma;
-}
-interface DisplayComponentProps {
-    field: DisplayFieldProps;
-    spec: Forma;
-}
-interface MatrixComponentProps {
-    field: MatrixFieldProps;
-    spec: Forma;
-}
-/**
- * Generic field component props (for fallback/dynamic components)
- */
-interface FieldComponentProps {
-    field: FieldProps;
-    spec: Forma;
-}
-
-/**
- * Field props returned by getFieldProps()
- * Contains all field information needed for rendering
- */
-interface GetFieldPropsResult {
-    /** Field path/name */
-    name: string;
-    /** Current field value */
-    value: unknown;
-    /** Field type */
-    type: string;
-    /** Display label */
-    label: string;
-    /** Help text or description */
-    description?: string;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether field is visible */
-    visible: boolean;
-    /** Whether field is enabled (not disabled) */
-    enabled: boolean;
-    /** Whether field is readonly (visible, not editable, value still submitted) */
-    readonly: boolean;
-    /** Whether field is required (for validation) */
-    required: boolean;
-    /**
-     * Whether to show the required indicator in the UI.
-     * False for boolean fields since false is a valid answer.
-     */
-    showRequiredIndicator: boolean;
-    /** Whether field has been touched */
-    touched: boolean;
-    /** Validation errors for this field */
-    errors: FieldError[];
-    /** Handler for value changes */
-    onChange: (value: unknown) => void;
-    /** Handler for blur events */
-    onBlur: () => void;
-    /** ARIA: Indicates the field has validation errors */
-    "aria-invalid"?: boolean;
-    /** ARIA: ID of element(s) describing validation errors */
-    "aria-describedby"?: string;
-    /** ARIA: Indicates the field is required */
-    "aria-required"?: boolean;
-    /** Options for select/multiselect fields (filtered by visibleWhen) */
-    options?: SelectOption[];
-    /** Prefix adorner text (e.g., "$") */
-    prefix?: string;
-    /** Suffix adorner text (e.g., "kg") */
-    suffix?: string;
-    /** Presentation variant hint */
-    variant?: string;
-    /** Variant-specific configuration */
-    variantConfig?: Record<string, unknown>;
-}
-/**
- * Select field props returned by getSelectFieldProps()
- */
-interface GetSelectFieldPropsResult extends GetFieldPropsResult {
-    /** Available options for selection */
-    options: SelectOption[];
-}
-/**
- * Array helpers returned by getArrayHelpers()
- */
-interface GetArrayHelpersResult {
-    /** Current array items */
-    items: unknown[];
-    /** Add item to end of array */
-    push: (item: unknown) => void;
-    /** Remove item at index */
-    remove: (index: number) => void;
-    /** Move item from one index to another */
-    move: (from: number, to: number) => void;
-    /** Swap items at two indices */
-    swap: (indexA: number, indexB: number) => void;
-    /** Insert item at specific index */
-    insert: (index: number, item: unknown) => void;
-    /** Get field props for an item field */
-    getItemFieldProps: (index: number, fieldName: string) => GetFieldPropsResult;
-    /** Minimum number of items allowed */
-    minItems: number;
-    /** Maximum number of items allowed */
-    maxItems: number;
-    /** Whether more items can be added */
-    canAdd: boolean;
-    /** Whether items can be removed */
-    canRemove: boolean;
-}
-/**
- * @deprecated Use GetFieldPropsResult instead
- */
-type LegacyFieldProps = GetFieldPropsResult;
-
 /**
  * useForma Hook
  *
@@ -631,6 +140,12 @@ interface WizardHelpers {
     goToPage: (index: number) => void;
     nextPage: () => void;
     previousPage: () => void;
+    /**
+     * Safe "Next" handler for wizard navigation.
+     * Advances to the next page if one exists. Never triggers submission.
+     * Use this instead of conditionally calling nextPage/onSubmit in a single button.
+     */
+    handleNext: () => void;
     hasNextPage: boolean;
     hasPreviousPage: boolean;
     canProceed: boolean;
@@ -703,57 +218,6 @@ interface UseFormaReturn {
  */
 declare function useForma(options: UseFormaOptions): UseFormaReturn;
 
-/**
- * FormRenderer Component
- *
- * Renders a complete form from a Forma specification.
- * Supports single-page and multi-page (wizard) forms.
- */
-
-/**
- * Props for FormRenderer component
- */
-interface FormRendererProps {
-    /** The Forma specification */
-    spec: Forma;
-    /** Initial form data */
-    initialData?: Record<string, unknown>;
-    /** Submit handler */
-    onSubmit?: (data: Record<string, unknown>) => void | Promise<void>;
-    /** Change handler */
-    onChange?: (data: Record<string, unknown>, computed?: Record<string, unknown>) => void;
-    /** Component map for rendering fields */
-    components: ComponentMap;
-    /** Custom layout component */
-    layout?: React__default.ComponentType<LayoutProps>;
-    /** Custom field wrapper component */
-    fieldWrapper?: React__default.ComponentType<FieldWrapperProps>;
-    /** Custom page wrapper component */
-    pageWrapper?: React__default.ComponentType<PageWrapperProps>;
-    /** When to validate */
-    validateOn?: "change" | "blur" | "submit";
-    /** Current page for controlled wizard */
-    page?: number;
-}
-/**
- * Imperative handle for FormRenderer
- */
-interface FormRendererHandle {
-    submitForm: () => Promise<void>;
-    resetForm: () => void;
-    validateForm: () => ValidationResult;
-    focusField: (path: string) => void;
-    focusFirstError: () => void;
-    getValues: () => Record<string, unknown>;
-    setValues: (values: Record<string, unknown>) => void;
-    isValid: boolean;
-    isDirty: boolean;
-}
-/**
- * FormRenderer component
- */
-declare const FormRenderer: React__default.ForwardRefExoticComponent<FormRendererProps & React__default.RefAttributes<FormRendererHandle>>;
-
 /**
  * Props for FieldRenderer component
  */
@@ -831,11 +295,11 @@ declare class FormaErrorBoundary extends React__default.Component<FormaErrorBoun
 /**
  * Context for sharing form state across components
  */
-declare const FormaContext: React$1.Context<UseFormaReturn | null>;
+declare const FormaContext: React.Context<UseFormaReturn | null>;
 /**
  * Hook to access Forma context
  * @throws Error if used outside of FormaContext.Provider
  */
 declare function useFormaContext(): UseFormaReturn;
 
-export { type ArrayComponentProps, type ArrayFieldProps, type ArrayHelpers, type ArrayItemFieldProps, type ArrayItemFieldPropsResult, type BaseFieldProps, type BooleanComponentProps, type BooleanFieldProps, type ComponentMap, type ComputedComponentProps, type ComputedFieldProps, type DateComponentProps, type DateFieldProps, type DateTimeComponentProps, type DateTimeFieldProps, type DisplayComponentProps, type DisplayFieldProps, type FieldComponentProps, type FieldProps, FieldRenderer, type FieldRendererProps, type FieldWrapperProps, FormRenderer, type FormRendererHandle, type FormRendererProps, type UseFormaReturn as FormState, FormaContext, FormaErrorBoundary, type FormaErrorBoundaryProps, type FormaEventListener, type FormaEventMap, type FormaEvents, type GetArrayHelpersResult, type GetFieldPropsResult, type GetSelectFieldPropsResult, type IntegerComponentProps, type IntegerFieldProps, type LayoutProps, type LegacyFieldProps, type MatrixComponentProps, type MatrixFieldProps, type MultiSelectComponentProps, type MultiSelectFieldProps, type NumberComponentProps, type NumberFieldProps, type ObjectComponentProps, type ObjectFieldProps, type PageState, type PageWrapperProps, type SelectComponentProps, type SelectFieldProps, type SelectionFieldProps, type TextComponentProps, type TextFieldProps, type UseFormaOptions, type UseFormaReturn, type WizardHelpers, useForma, useFormaContext };
+export { ComponentMap, FieldRenderer, type FieldRendererProps, type UseFormaReturn as FormState, FormaContext, FormaErrorBoundary, type FormaErrorBoundaryProps, type FormaEventListener, type FormaEventMap, type FormaEvents, GetArrayHelpersResult, GetFieldPropsResult, GetSelectFieldPropsResult, type PageState, type UseFormaOptions, type UseFormaReturn, type WizardHelpers, useForma, useFormaContext };