formanitor 0.0.48 → 0.0.50

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type FieldType = 'text' | 'number' | 'textarea' | 'diagnosis_textarea' | 'richtext' | 'select' | 'multiselect' | 'radio' | 'repeatable' | 'checkbox' | 'image_upload' | 'media_upload' | 'signature' | 'date' | 'datetime' | 'editable_table' | 'static_text' | 'medications' | 'investigations' | 'procedures' | 'vitals' | 'hidden_vitals' | 'referral' | 'followup' | 'toggle' | 'urology_smart_history' | 'urology_examination' | 'urology_pathway' | string;
+type FieldType = 'text' | 'number' | 'textarea' | 'diagnosis_textarea' | 'richtext' | 'select' | 'multiselect' | 'radio' | 'repeatable' | 'checkbox' | 'image_upload' | 'media_upload' | 'file_upload' | 'signature' | 'date' | 'datetime' | 'editable_table' | 'static_text' | 'medications' | 'investigations' | 'procedures' | 'vitals' | 'hidden_vitals' | 'referral' | 'followup' | 'toggle' | 'urology_smart_history' | 'urology_examination' | 'urology_pathway' | string;
 interface ValidationRule {
     min?: number;
     max?: number;
@@ -128,6 +129,15 @@ interface MediaUploadFieldDef extends BaseFieldDef {
     /** Default: images (image/*) and application/pdf */
     acceptedTypes?: string[];
 }
+interface FileUploadFieldDef extends BaseFieldDef {
+    type: 'file_upload';
+    /** HTML accept string, e.g. "application/pdf,image/*" */
+    accept?: string;
+    multiple?: boolean;
+    maxSize?: number;
+    uploadPlaceholder?: string;
+    uploadFormats?: string;
+}
 interface SignatureFieldDef extends BaseFieldDef {
     type: 'signature';
     canvasWidth?: number;
@@ -500,7 +510,33 @@ interface DiagnosticPackage {
     department?: string;
     tests: DiagnosticPackageTest[];
 }
-type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SliderFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | SuggestionTextareaFieldDef | LensAssessmentFieldDef | FunctionalImpairmentScoreFieldDef | ToggleFieldDef | BiometryIolWorkupFieldDef | SurgicalRiskFlagsFieldDef | GeneralSurgerySmartHistoryFieldDef | GeneralSurgeryExaminationFieldDef | GeneralSurgeryGradingFieldDef | UrologySmartHistoryFieldDef | UrologyExaminationFieldDef | UrologyPathwayFieldDef | OBGExaminationFieldDef | OBGPathwayFieldDef | PainScaleFlagsFieldDef | BaseFieldDef;
+interface PhoneInputFieldDef extends BaseFieldDef {
+    type: 'phone_input';
+    meta?: {
+        /** ID of the sibling otp_input field to clear when the phone is edited after a send. */
+        otpFieldId?: string;
+        /** Country code prefix, e.g. "+91". Defaults to "+91". */
+        countryCode?: string;
+    };
+}
+interface OtpInputFieldDef extends BaseFieldDef {
+    type: 'otp_input';
+    meta?: {
+        /** ID of the sibling phone_input field to read the number from. Defaults to "phone". */
+        phoneFieldId?: string;
+        /** Number of OTP digits. Defaults to 4. */
+        length?: 4 | 6;
+    };
+}
+/** Value shape stored in the form store after a successful OTP verification. */
+interface OtpVerifiedValue {
+    verified: true;
+    phone: string;
+    /** Digits the user entered; included so submissions can persist `otp_code`. */
+    code: string;
+    token?: string;
+}
+type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SliderFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | FileUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | SuggestionTextareaFieldDef | LensAssessmentFieldDef | FunctionalImpairmentScoreFieldDef | ToggleFieldDef | BiometryIolWorkupFieldDef | SurgicalRiskFlagsFieldDef | GeneralSurgerySmartHistoryFieldDef | GeneralSurgeryExaminationFieldDef | GeneralSurgeryGradingFieldDef | UrologySmartHistoryFieldDef | UrologyExaminationFieldDef | UrologyPathwayFieldDef | OBGExaminationFieldDef | OBGPathwayFieldDef | PainScaleFlagsFieldDef | PhoneInputFieldDef | OtpInputFieldDef | BaseFieldDef;
 /** Boolean switch; value is `true` | `false`. */
 interface ToggleFieldDef extends BaseFieldDef {
     type: 'toggle';
@@ -555,7 +591,27 @@ interface Section {
     title: string;
     children: SectionChild[];
 }
-type LayoutNode = Section | ColumnLayout;
+interface MultiStepNode {
+    type: 'section';
+    id: string;
+    title: string;
+    children: SectionChild[];
+}
+interface MultiStepLayoutNode {
+    type: 'multi_step';
+    id: string;
+    title?: string;
+    steps: MultiStepNode[];
+    meta?: {
+        /** Show step indicator header. Default true. */
+        showStepper?: boolean;
+        /** Visual style for the stepper. Default 'numbered'. */
+        stepperVariant?: 'numbered' | 'dots' | 'labels';
+        /** Collapse completed steps into an accordion. Default true. */
+        collapseCompleted?: boolean;
+    };
+}
+type LayoutNode = Section | ColumnLayout | MultiStepLayoutNode;
 interface WebhookDef {
     method: 'GET' | 'POST' | 'PUT';
     url: string;
@@ -662,6 +718,21 @@ type Listener = (state: FormState) => void;
 type EventListener = (event: string, payload?: any) => void;
 type UploadHandler = (file: File | Blob, filename: string) => Promise<string>;
 type DraftChangeHandler = (payload: SavedState) => void | Promise<void>;
+interface StoreAuthConfig {
+    /**
+     * Base URL for OTP API calls. Defaults to `process.env.NEXT_PUBLIC_API_URL` when not set.
+     * Set this in the host app to decouple the library from Next.js env vars.
+     */
+    baseUrl?: string;
+    /** Path to send OTP. Defaults to "/api/auth/otp/send/". */
+    sendPath?: string;
+    /** Path to resend OTP. Defaults to "/api/auth/otp/resend/". */
+    resendPath?: string;
+    /** Path to verify OTP. Defaults to "/api/auth/otp/verify/". */
+    verifyPath?: string;
+    /** Country code prefix for phone numbers. Defaults to "+91". */
+    defaultCountryCode?: string;
+}
 interface StoreConfig {
     persistence?: PersistenceProvider;
     prefillData?: Record<string, any>;
@@ -669,6 +740,11 @@ interface StoreConfig {
     onEvent?: EventListener;
     onUpload?: UploadHandler;
     onDraftChange?: DraftChangeHandler;
+    /**
+     * Auth / OTP configuration. Lets the host app supply the API base URL and
+     * paths so the library doesn't depend on Next.js environment variables.
+     */
+    auth?: StoreAuthConfig;
     /**
      * Voice dictation support.  When provided, fields marked with `voice: true`
      * in the schema will display a microphone button.
@@ -689,6 +765,7 @@ declare class FormStore {
     private persistence;
     private prefillData;
     private config;
+    private externalErrors;
     private saveTimeout;
     private draftCallbackTimeout;
     constructor(schema: FormDef, config?: StoreConfig);
@@ -702,6 +779,7 @@ declare class FormStore {
         disabled: boolean;
     };
     getSchema(): FormDef;
+    getConfig(): StoreConfig;
     getFieldDef(fieldId: string): FieldDef | undefined;
     getVoice(): StoreConfig['voice'];
     hasPersistence(): boolean;
@@ -715,6 +793,12 @@ declare class FormStore {
     setValues(partial: Record<string, any>, options?: {
         touch?: boolean;
     }): void;
+    /**
+     * Let a widget report an error that schema validation cannot express
+     * (e.g. "Send OTP to continue" until the API call succeeds).
+     * Pass `null` to clear a previously set external error.
+     */
+    setExternalError(fieldId: string, message: string | null): void;
     setTouched(fieldId: string): void;
     setRole(role: string): void;
     load(): Promise<void>;
@@ -773,7 +857,12 @@ declare class FormStore {
 }
 
 declare const EMAIL_REGEX: RegExp;
-declare function validateField(value: any, field: FieldDef): string | null;
+/**
+ * Validate a single field.
+ * Pass `allValues` when you need cross-field validation (e.g. otp_input checking the
+ * sibling phone field's value).
+ */
+declare function validateField(value: any, field: FieldDef, allValues?: Record<string, any>): string | null;
 declare function validateForm(values: Record<string, any>, fields: Record<string, FieldDef>): Record<string, string | null>;
 
 interface RuleResult {
@@ -887,6 +976,20 @@ interface DynamicFormV2Props {
  */
 declare const DynamicFormV2: React.FC<DynamicFormV2Props>;
 
+interface MultiStepFormProps {
+    /** When true, renders `schema.title` as the page heading. Default true. */
+    showTitle?: boolean;
+    className?: string;
+}
+/**
+ * Renders a form schema that may contain `multi_step` layout nodes in addition
+ * to the standard `section` / `column_layout` nodes.
+ *
+ * Multi-step groups unlock steps linearly: a step becomes visible only when
+ * all fields in the previous step are valid (no errors, required fields filled).
+ */
+declare const MultiStepForm: React.FC<MultiStepFormProps>;
+
 /** Shape of one differential diagnosis item from AI (must match form field value) */
 type AIDifferentialDiagnosisItem = {
     category: string;
@@ -977,9 +1080,30 @@ interface FormControlsProps {
     buttonClassName?: string;
     onSaveDraft?: () => void;
     onSubmit?: (to: string) => void;
+    /** Override the label on the submit/transition button. Defaults to "Submit". */
+    submitLabel?: string;
 }
 declare const FormControls: React.FC<FormControlsProps>;
 
+interface UploadProps {
+    accept?: string;
+    multiple?: boolean;
+    disabled?: boolean;
+    value?: FileList | File[] | null;
+    onChange: (files: FileList | null) => void;
+    className?: string;
+    /** Shown under placeholder, e.g. "PDF, PNG, JPG" */
+    formatsLabel?: string;
+    placeholder?: string;
+    beforeUploadContent?: React.ReactNode;
+    id?: string;
+}
+declare function Upload({ value, accept, multiple, disabled, onChange, className, formatsLabel, placeholder, beforeUploadContent, id: idProp, }: UploadProps): react_jsx_runtime.JSX.Element;
+
+declare const FormFileUploadWidget: React.FC<{
+    fieldId: string;
+}>;
+
 declare const ImageUploadWidget: React.FC<{
     fieldId: string;
 }>;
@@ -1185,4 +1309,4 @@ declare const SmartTextareaWidget: React.FC<{
     fieldId: string;
 }>;
 
-export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type BiometryIolWorkupFieldDef, type BiometryIolWorkupValue, type BiometryMethod, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, type DiagnosisGradeSelection, type DiagnosisTextareaFieldDef, type DiagnosisTextareaValue, type DiagnosticPackage, type DiagnosticPackageTest, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, type DoctorFrequentItems, DynamicForm, DynamicFormV2, type DynamicFormV2Props, type DynamicFormV2SectionMode, EMAIL_REGEX, type EditableTableColumnDef, type EditableTableFieldDef, type EventDefinition, type ExtractedKeywordMatch, type FieldDef, type FieldHandler, type FieldHandlersMap, type FieldPrefill, FieldRenderer, type FieldState, type FieldType, type FollowupFieldDef, type FollowupValue, FormControls, type FormControlsProps, type FormDef, type FormErrors, FormProvider, type FormState, FormStore, type FormValues, type FormulaComputation, type FormulaExpr, type FunctionalImpairmentDimension, type FunctionalImpairmentScoreFieldDef, type FunctionalImpairmentScoreValue, type GeneralSurgeryExaminationFieldDef, type GeneralSurgeryGradingFieldDef, type GeneralSurgerySmartHistoryFieldDef, type ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type LensAssessmentFieldDef, type LensAssessmentValue, type LocsGrades, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type OBGExaminationFieldDef, type OBGPathwayFieldDef, type PainScaleFlagsFieldDef, type Permission, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlyMediaUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, type RichTextFieldDef, RichTextWidget, type Rule, type RuleAction, type RuleResult, type ScoreComputation, type ScoreRange, type Section, type SectionChild, type SelectFieldDef, type SelectOption, type SignatureFieldDef, SignatureUploadWidget, type SliderFieldDef, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreConfig, type SubmissionData, type SuggestionTextareaFieldDef, type SumComputation, type SurgicalRiskFlagsFieldDef, type SurgicalRiskFlagsValue, type TextFieldDef, type ToggleFieldDef, type UrologyExaminationFieldDef, type UrologyPathwayFieldDef, type UrologySmartHistoryFieldDef, type ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, fieldMetaRequestsMarMedicationOrdersButton, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };
+export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type BiometryIolWorkupFieldDef, type BiometryIolWorkupValue, type BiometryMethod, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, type DiagnosisGradeSelection, type DiagnosisTextareaFieldDef, type DiagnosisTextareaValue, type DiagnosticPackage, type DiagnosticPackageTest, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, type DoctorFrequentItems, DynamicForm, DynamicFormV2, type DynamicFormV2Props, type DynamicFormV2SectionMode, EMAIL_REGEX, type EditableTableColumnDef, type EditableTableFieldDef, type EventDefinition, type ExtractedKeywordMatch, type FieldDef, type FieldHandler, type FieldHandlersMap, type FieldPrefill, FieldRenderer, type FieldState, type FieldType, type FileUploadFieldDef, type FollowupFieldDef, type FollowupValue, FormControls, type FormControlsProps, type FormDef, type FormErrors, FormFileUploadWidget, FormProvider, type FormState, FormStore, type FormValues, type FormulaComputation, type FormulaExpr, type FunctionalImpairmentDimension, type FunctionalImpairmentScoreFieldDef, type FunctionalImpairmentScoreValue, type GeneralSurgeryExaminationFieldDef, type GeneralSurgeryGradingFieldDef, type GeneralSurgerySmartHistoryFieldDef, type ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type LensAssessmentFieldDef, type LensAssessmentValue, type LocsGrades, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, MultiStepForm, type MultiStepFormProps, type MultiStepLayoutNode, type MultiStepNode, type NumberFieldDef, type OBGExaminationFieldDef, type OBGPathwayFieldDef, type OtpInputFieldDef, type OtpVerifiedValue, type PainScaleFlagsFieldDef, type Permission, type PhoneInputFieldDef, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlyMediaUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, type RichTextFieldDef, RichTextWidget, type Rule, type RuleAction, type RuleResult, type ScoreComputation, type ScoreRange, type Section, type SectionChild, type SelectFieldDef, type SelectOption, type SignatureFieldDef, SignatureUploadWidget, type SliderFieldDef, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreAuthConfig, type StoreConfig, type SubmissionData, type SuggestionTextareaFieldDef, type SumComputation, type SurgicalRiskFlagsFieldDef, type SurgicalRiskFlagsValue, type TextFieldDef, type ToggleFieldDef, Upload, type UploadProps, type UrologyExaminationFieldDef, type UrologyPathwayFieldDef, type UrologySmartHistoryFieldDef, type ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, fieldMetaRequestsMarMedicationOrdersButton, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type FieldType = 'text' | 'number' | 'textarea' | 'diagnosis_textarea' | 'richtext' | 'select' | 'multiselect' | 'radio' | 'repeatable' | 'checkbox' | 'image_upload' | 'media_upload' | 'signature' | 'date' | 'datetime' | 'editable_table' | 'static_text' | 'medications' | 'investigations' | 'procedures' | 'vitals' | 'hidden_vitals' | 'referral' | 'followup' | 'toggle' | 'urology_smart_history' | 'urology_examination' | 'urology_pathway' | string;
+type FieldType = 'text' | 'number' | 'textarea' | 'diagnosis_textarea' | 'richtext' | 'select' | 'multiselect' | 'radio' | 'repeatable' | 'checkbox' | 'image_upload' | 'media_upload' | 'file_upload' | 'signature' | 'date' | 'datetime' | 'editable_table' | 'static_text' | 'medications' | 'investigations' | 'procedures' | 'vitals' | 'hidden_vitals' | 'referral' | 'followup' | 'toggle' | 'urology_smart_history' | 'urology_examination' | 'urology_pathway' | string;
 interface ValidationRule {
     min?: number;
     max?: number;
@@ -128,6 +129,15 @@ interface MediaUploadFieldDef extends BaseFieldDef {
     /** Default: images (image/*) and application/pdf */
     acceptedTypes?: string[];
 }
+interface FileUploadFieldDef extends BaseFieldDef {
+    type: 'file_upload';
+    /** HTML accept string, e.g. "application/pdf,image/*" */
+    accept?: string;
+    multiple?: boolean;
+    maxSize?: number;
+    uploadPlaceholder?: string;
+    uploadFormats?: string;
+}
 interface SignatureFieldDef extends BaseFieldDef {
     type: 'signature';
     canvasWidth?: number;
@@ -500,7 +510,33 @@ interface DiagnosticPackage {
     department?: string;
     tests: DiagnosticPackageTest[];
 }
-type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SliderFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | SuggestionTextareaFieldDef | LensAssessmentFieldDef | FunctionalImpairmentScoreFieldDef | ToggleFieldDef | BiometryIolWorkupFieldDef | SurgicalRiskFlagsFieldDef | GeneralSurgerySmartHistoryFieldDef | GeneralSurgeryExaminationFieldDef | GeneralSurgeryGradingFieldDef | UrologySmartHistoryFieldDef | UrologyExaminationFieldDef | UrologyPathwayFieldDef | OBGExaminationFieldDef | OBGPathwayFieldDef | PainScaleFlagsFieldDef | BaseFieldDef;
+interface PhoneInputFieldDef extends BaseFieldDef {
+    type: 'phone_input';
+    meta?: {
+        /** ID of the sibling otp_input field to clear when the phone is edited after a send. */
+        otpFieldId?: string;
+        /** Country code prefix, e.g. "+91". Defaults to "+91". */
+        countryCode?: string;
+    };
+}
+interface OtpInputFieldDef extends BaseFieldDef {
+    type: 'otp_input';
+    meta?: {
+        /** ID of the sibling phone_input field to read the number from. Defaults to "phone". */
+        phoneFieldId?: string;
+        /** Number of OTP digits. Defaults to 4. */
+        length?: 4 | 6;
+    };
+}
+/** Value shape stored in the form store after a successful OTP verification. */
+interface OtpVerifiedValue {
+    verified: true;
+    phone: string;
+    /** Digits the user entered; included so submissions can persist `otp_code`. */
+    code: string;
+    token?: string;
+}
+type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SliderFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | FileUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | SuggestionTextareaFieldDef | LensAssessmentFieldDef | FunctionalImpairmentScoreFieldDef | ToggleFieldDef | BiometryIolWorkupFieldDef | SurgicalRiskFlagsFieldDef | GeneralSurgerySmartHistoryFieldDef | GeneralSurgeryExaminationFieldDef | GeneralSurgeryGradingFieldDef | UrologySmartHistoryFieldDef | UrologyExaminationFieldDef | UrologyPathwayFieldDef | OBGExaminationFieldDef | OBGPathwayFieldDef | PainScaleFlagsFieldDef | PhoneInputFieldDef | OtpInputFieldDef | BaseFieldDef;
 /** Boolean switch; value is `true` | `false`. */
 interface ToggleFieldDef extends BaseFieldDef {
     type: 'toggle';
@@ -555,7 +591,27 @@ interface Section {
     title: string;
     children: SectionChild[];
 }
-type LayoutNode = Section | ColumnLayout;
+interface MultiStepNode {
+    type: 'section';
+    id: string;
+    title: string;
+    children: SectionChild[];
+}
+interface MultiStepLayoutNode {
+    type: 'multi_step';
+    id: string;
+    title?: string;
+    steps: MultiStepNode[];
+    meta?: {
+        /** Show step indicator header. Default true. */
+        showStepper?: boolean;
+        /** Visual style for the stepper. Default 'numbered'. */
+        stepperVariant?: 'numbered' | 'dots' | 'labels';
+        /** Collapse completed steps into an accordion. Default true. */
+        collapseCompleted?: boolean;
+    };
+}
+type LayoutNode = Section | ColumnLayout | MultiStepLayoutNode;
 interface WebhookDef {
     method: 'GET' | 'POST' | 'PUT';
     url: string;
@@ -662,6 +718,21 @@ type Listener = (state: FormState) => void;
 type EventListener = (event: string, payload?: any) => void;
 type UploadHandler = (file: File | Blob, filename: string) => Promise<string>;
 type DraftChangeHandler = (payload: SavedState) => void | Promise<void>;
+interface StoreAuthConfig {
+    /**
+     * Base URL for OTP API calls. Defaults to `process.env.NEXT_PUBLIC_API_URL` when not set.
+     * Set this in the host app to decouple the library from Next.js env vars.
+     */
+    baseUrl?: string;
+    /** Path to send OTP. Defaults to "/api/auth/otp/send/". */
+    sendPath?: string;
+    /** Path to resend OTP. Defaults to "/api/auth/otp/resend/". */
+    resendPath?: string;
+    /** Path to verify OTP. Defaults to "/api/auth/otp/verify/". */
+    verifyPath?: string;
+    /** Country code prefix for phone numbers. Defaults to "+91". */
+    defaultCountryCode?: string;
+}
 interface StoreConfig {
     persistence?: PersistenceProvider;
     prefillData?: Record<string, any>;
@@ -669,6 +740,11 @@ interface StoreConfig {
     onEvent?: EventListener;
     onUpload?: UploadHandler;
     onDraftChange?: DraftChangeHandler;
+    /**
+     * Auth / OTP configuration. Lets the host app supply the API base URL and
+     * paths so the library doesn't depend on Next.js environment variables.
+     */
+    auth?: StoreAuthConfig;
     /**
      * Voice dictation support.  When provided, fields marked with `voice: true`
      * in the schema will display a microphone button.
@@ -689,6 +765,7 @@ declare class FormStore {
     private persistence;
     private prefillData;
     private config;
+    private externalErrors;
     private saveTimeout;
     private draftCallbackTimeout;
     constructor(schema: FormDef, config?: StoreConfig);
@@ -702,6 +779,7 @@ declare class FormStore {
         disabled: boolean;
     };
     getSchema(): FormDef;
+    getConfig(): StoreConfig;
     getFieldDef(fieldId: string): FieldDef | undefined;
     getVoice(): StoreConfig['voice'];
     hasPersistence(): boolean;
@@ -715,6 +793,12 @@ declare class FormStore {
     setValues(partial: Record<string, any>, options?: {
         touch?: boolean;
     }): void;
+    /**
+     * Let a widget report an error that schema validation cannot express
+     * (e.g. "Send OTP to continue" until the API call succeeds).
+     * Pass `null` to clear a previously set external error.
+     */
+    setExternalError(fieldId: string, message: string | null): void;
     setTouched(fieldId: string): void;
     setRole(role: string): void;
     load(): Promise<void>;
@@ -773,7 +857,12 @@ declare class FormStore {
 }
 
 declare const EMAIL_REGEX: RegExp;
-declare function validateField(value: any, field: FieldDef): string | null;
+/**
+ * Validate a single field.
+ * Pass `allValues` when you need cross-field validation (e.g. otp_input checking the
+ * sibling phone field's value).
+ */
+declare function validateField(value: any, field: FieldDef, allValues?: Record<string, any>): string | null;
 declare function validateForm(values: Record<string, any>, fields: Record<string, FieldDef>): Record<string, string | null>;
 
 interface RuleResult {
@@ -887,6 +976,20 @@ interface DynamicFormV2Props {
  */
 declare const DynamicFormV2: React.FC<DynamicFormV2Props>;
 
+interface MultiStepFormProps {
+    /** When true, renders `schema.title` as the page heading. Default true. */
+    showTitle?: boolean;
+    className?: string;
+}
+/**
+ * Renders a form schema that may contain `multi_step` layout nodes in addition
+ * to the standard `section` / `column_layout` nodes.
+ *
+ * Multi-step groups unlock steps linearly: a step becomes visible only when
+ * all fields in the previous step are valid (no errors, required fields filled).
+ */
+declare const MultiStepForm: React.FC<MultiStepFormProps>;
+
 /** Shape of one differential diagnosis item from AI (must match form field value) */
 type AIDifferentialDiagnosisItem = {
     category: string;
@@ -977,9 +1080,30 @@ interface FormControlsProps {
     buttonClassName?: string;
     onSaveDraft?: () => void;
     onSubmit?: (to: string) => void;
+    /** Override the label on the submit/transition button. Defaults to "Submit". */
+    submitLabel?: string;
 }
 declare const FormControls: React.FC<FormControlsProps>;
 
+interface UploadProps {
+    accept?: string;
+    multiple?: boolean;
+    disabled?: boolean;
+    value?: FileList | File[] | null;
+    onChange: (files: FileList | null) => void;
+    className?: string;
+    /** Shown under placeholder, e.g. "PDF, PNG, JPG" */
+    formatsLabel?: string;
+    placeholder?: string;
+    beforeUploadContent?: React.ReactNode;
+    id?: string;
+}
+declare function Upload({ value, accept, multiple, disabled, onChange, className, formatsLabel, placeholder, beforeUploadContent, id: idProp, }: UploadProps): react_jsx_runtime.JSX.Element;
+
+declare const FormFileUploadWidget: React.FC<{
+    fieldId: string;
+}>;
+
 declare const ImageUploadWidget: React.FC<{
     fieldId: string;
 }>;
@@ -1185,4 +1309,4 @@ declare const SmartTextareaWidget: React.FC<{
     fieldId: string;
 }>;
 
-export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type BiometryIolWorkupFieldDef, type BiometryIolWorkupValue, type BiometryMethod, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, type DiagnosisGradeSelection, type DiagnosisTextareaFieldDef, type DiagnosisTextareaValue, type DiagnosticPackage, type DiagnosticPackageTest, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, type DoctorFrequentItems, DynamicForm, DynamicFormV2, type DynamicFormV2Props, type DynamicFormV2SectionMode, EMAIL_REGEX, type EditableTableColumnDef, type EditableTableFieldDef, type EventDefinition, type ExtractedKeywordMatch, type FieldDef, type FieldHandler, type FieldHandlersMap, type FieldPrefill, FieldRenderer, type FieldState, type FieldType, type FollowupFieldDef, type FollowupValue, FormControls, type FormControlsProps, type FormDef, type FormErrors, FormProvider, type FormState, FormStore, type FormValues, type FormulaComputation, type FormulaExpr, type FunctionalImpairmentDimension, type FunctionalImpairmentScoreFieldDef, type FunctionalImpairmentScoreValue, type GeneralSurgeryExaminationFieldDef, type GeneralSurgeryGradingFieldDef, type GeneralSurgerySmartHistoryFieldDef, type ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type LensAssessmentFieldDef, type LensAssessmentValue, type LocsGrades, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type OBGExaminationFieldDef, type OBGPathwayFieldDef, type PainScaleFlagsFieldDef, type Permission, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlyMediaUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, type RichTextFieldDef, RichTextWidget, type Rule, type RuleAction, type RuleResult, type ScoreComputation, type ScoreRange, type Section, type SectionChild, type SelectFieldDef, type SelectOption, type SignatureFieldDef, SignatureUploadWidget, type SliderFieldDef, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreConfig, type SubmissionData, type SuggestionTextareaFieldDef, type SumComputation, type SurgicalRiskFlagsFieldDef, type SurgicalRiskFlagsValue, type TextFieldDef, type ToggleFieldDef, type UrologyExaminationFieldDef, type UrologyPathwayFieldDef, type UrologySmartHistoryFieldDef, type ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, fieldMetaRequestsMarMedicationOrdersButton, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };
+export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type BiometryIolWorkupFieldDef, type BiometryIolWorkupValue, type BiometryMethod, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, type DiagnosisGradeSelection, type DiagnosisTextareaFieldDef, type DiagnosisTextareaValue, type DiagnosticPackage, type DiagnosticPackageTest, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, type DoctorFrequentItems, DynamicForm, DynamicFormV2, type DynamicFormV2Props, type DynamicFormV2SectionMode, EMAIL_REGEX, type EditableTableColumnDef, type EditableTableFieldDef, type EventDefinition, type ExtractedKeywordMatch, type FieldDef, type FieldHandler, type FieldHandlersMap, type FieldPrefill, FieldRenderer, type FieldState, type FieldType, type FileUploadFieldDef, type FollowupFieldDef, type FollowupValue, FormControls, type FormControlsProps, type FormDef, type FormErrors, FormFileUploadWidget, FormProvider, type FormState, FormStore, type FormValues, type FormulaComputation, type FormulaExpr, type FunctionalImpairmentDimension, type FunctionalImpairmentScoreFieldDef, type FunctionalImpairmentScoreValue, type GeneralSurgeryExaminationFieldDef, type GeneralSurgeryGradingFieldDef, type GeneralSurgerySmartHistoryFieldDef, type ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type LensAssessmentFieldDef, type LensAssessmentValue, type LocsGrades, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, MultiStepForm, type MultiStepFormProps, type MultiStepLayoutNode, type MultiStepNode, type NumberFieldDef, type OBGExaminationFieldDef, type OBGPathwayFieldDef, type OtpInputFieldDef, type OtpVerifiedValue, type PainScaleFlagsFieldDef, type Permission, type PhoneInputFieldDef, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlyMediaUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, type RichTextFieldDef, RichTextWidget, type Rule, type RuleAction, type RuleResult, type ScoreComputation, type ScoreRange, type Section, type SectionChild, type SelectFieldDef, type SelectOption, type SignatureFieldDef, SignatureUploadWidget, type SliderFieldDef, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreAuthConfig, type StoreConfig, type SubmissionData, type SuggestionTextareaFieldDef, type SumComputation, type SurgicalRiskFlagsFieldDef, type SurgicalRiskFlagsValue, type TextFieldDef, type ToggleFieldDef, Upload, type UploadProps, type UrologyExaminationFieldDef, type UrologyPathwayFieldDef, type UrologySmartHistoryFieldDef, type ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, fieldMetaRequestsMarMedicationOrdersButton, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };