formanitor 0.0.49 → 0.1.0

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;
@@ -10,7 +11,7 @@ interface ValidationRule {
     custom?: (value: any) => string | null;
 }
 interface Permission {
-    [role: string]: 'edit' | 'view' | 'hide';
+    [role: string]: "edit" | "view" | "hide";
 }
 interface DataSource {
     source: string;
@@ -18,7 +19,7 @@ interface DataSource {
     dependsOn?: string[];
 }
 interface EventDefinition {
-    trigger: 'onValueChange' | 'onBlur' | 'onFocus';
+    trigger: "onValueChange" | "onBlur" | "onFocus";
     condition?: Condition;
     emit: string;
 }
@@ -27,6 +28,34 @@ interface FieldPrefill {
     source?: string;
     field?: string;
 }
+/** Optional Tailwind (or other) class names applied on top of each field’s default styles. */
+interface FieldStyleClassNames {
+    /** Outermost wrapper around the field (typically the `space-y-*` column). */
+    wrapper?: string;
+    /** Primary field label (the `Label` next to the control). */
+    label?: string;
+    /** Main interactive control: input, textarea, select trigger, upload area, bordered option list, etc. */
+    control?: string;
+    /** Helper text under the field (`description` in schema). */
+    description?: string;
+    /** Validation / error line below the field. */
+    error?: string;
+    /** The red asterisk shown when `required` is true (only if `showRequiredAsterisk` is not false). */
+    requiredIndicator?: string;
+}
+/**
+ * Per-field presentation overrides. All keys optional — omitting `style` keeps existing behaviour.
+ */
+interface FieldStyleConfig {
+    /** When false, the primary label row is hidden (controls should use `aria-label`). Default true. */
+    labelVisible?: boolean;
+    /**
+     * When false, the red * for required fields is not rendered. Validation still uses `required`.
+     * Default true (show asterisk when required).
+     */
+    showRequiredAsterisk?: boolean;
+    classNames?: FieldStyleClassNames;
+}
 interface BaseFieldDef {
     id: string;
     type: FieldType;
@@ -48,7 +77,7 @@ interface BaseFieldDef {
      * - "center" is the main content column and is 2× the width of side columns.
      * Default: "center" when omitted.
      */
-    position?: 'left' | 'center' | 'right';
+    position?: "left" | "center" | "right";
     /**
      * How many layout columns this field spans horizontally.
      * - 1 = occupies its own column (e.g. just "left", just "center", or just "right")
@@ -62,6 +91,8 @@ interface BaseFieldDef {
      * shows the label in a colored block above the input).
      */
     theme?: string;
+    /** Optional layout and class overrides for this field (see {@link FieldStyleConfig}). */
+    style?: FieldStyleConfig;
     meta?: Record<string, unknown>;
     /**
      * When true, a microphone button is rendered alongside this field so the
@@ -71,22 +102,22 @@ interface BaseFieldDef {
     voice?: boolean;
 }
 interface TextFieldDef extends BaseFieldDef {
-    type: 'text' | 'textarea';
+    type: "text" | "textarea";
     /** For textarea: height in pixels. If omitted, uses default min height (80px). */
     height?: number;
 }
 /** Rich text (HTML) field with TipTap toolbar. Value is stored as HTML string. */
 interface RichTextFieldDef extends BaseFieldDef {
-    type: 'richtext';
+    type: "richtext";
     /** Minimum height of the editor body in pixels. Default: 160. */
     minHeight?: number;
 }
 interface NumberFieldDef extends BaseFieldDef {
-    type: 'number';
+    type: "number";
 }
 /** Single-thumb numeric slider (e.g. VAS 0–10). Value is a number. */
 interface SliderFieldDef extends BaseFieldDef {
-    type: 'slider';
+    type: "slider";
     /** Inclusive minimum. Default 0. */
     min?: number;
     /** Inclusive maximum. Default 10. */
@@ -101,35 +132,46 @@ interface SelectOption {
     score?: number;
 }
 interface SelectFieldDef extends BaseFieldDef {
-    type: 'select' | 'multiselect';
+    type: "select" | "multiselect";
     options?: SelectOption[];
 }
 interface RadioFieldDef extends BaseFieldDef {
-    type: 'radio';
+    type: "radio";
     options?: SelectOption[];
 }
 interface CheckboxFieldDef extends BaseFieldDef {
-    type: 'checkbox';
+    type: "checkbox";
     /** Options for the checkbox group; value is stored as array of selected option values. */
     options?: SelectOption[];
 }
 interface RepeatableFieldDef extends BaseFieldDef {
-    type: 'repeatable';
+    type: "repeatable";
     row: FieldDef[];
 }
 interface ImageUploadFieldDef extends BaseFieldDef {
-    type: 'image_upload';
+    type: "image_upload";
     maxSize?: number;
     acceptedTypes?: string[];
 }
 interface MediaUploadFieldDef extends BaseFieldDef {
-    type: 'media_upload';
+    type: "media_upload";
     maxSize?: number;
     /** 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;
+    /** When true, uploaded files render as a stacked list with removable rows. */
+    list?: boolean;
+}
 interface SignatureFieldDef extends BaseFieldDef {
-    type: 'signature';
+    type: "signature";
     canvasWidth?: number;
     canvasHeight?: number;
     strokeColor?: string;
@@ -143,7 +185,7 @@ interface EditableTableColumnDef {
     allowDelete?: boolean;
 }
 interface EditableTableFieldDef extends BaseFieldDef {
-    type: 'editable_table';
+    type: "editable_table";
     /** Initial columns. Per-column allowDelete controls whether that column can be removed. */
     columns?: EditableTableColumnDef[];
     allowAddRow?: boolean;
@@ -157,26 +199,26 @@ interface EditableTableFieldDef extends BaseFieldDef {
     /** Placeholder/hint for the new column name input. Default: "New Column Name". */
     newColumnNameHint?: string;
     /** How to capture new column name: "text" (input) or "datetime" (picker). Default: "text". */
-    newColumnNameInputType?: 'text' | 'datetime';
+    newColumnNameInputType?: "text" | "datetime";
     /** Minimum rows to keep; delete button is hidden when rows.length <= minRows. Default: 0. */
     minRows?: number;
 }
 interface StaticTextFieldDef extends BaseFieldDef {
-    type: 'static_text';
+    type: "static_text";
     /** Display size. Default: 'regular'. */
-    size?: 'regular' | 'large';
+    size?: "regular" | "large";
 }
 interface MedicationsFieldDef extends BaseFieldDef {
-    type: 'medications';
+    type: "medications";
 }
 interface InvestigationsFieldDef extends BaseFieldDef {
-    type: 'investigations';
+    type: "investigations";
 }
 interface ProceduresFieldDef extends BaseFieldDef {
-    type: 'procedures';
+    type: "procedures";
 }
 interface DifferentialDiagnosisFieldDef extends BaseFieldDef {
-    type: 'differential_diagnosis';
+    type: "differential_diagnosis";
 }
 /**
  * A read-only vitals panel populated by an external API fetch.
@@ -184,7 +226,7 @@ interface DifferentialDiagnosisFieldDef extends BaseFieldDef {
  * The fetched value (raw vitals object) is stored in form state and included in submission.
  */
 interface VitalsFieldDef extends BaseFieldDef {
-    type: 'vitals';
+    type: "vitals";
 }
 /** One selected referral. Stored in form state as an array of these. */
 interface ReferralItem {
@@ -197,22 +239,22 @@ interface ReferralItem {
  * Options via fieldHandlers[fieldId].onFetchOptions (e.g. { specializations: string[] }).
  */
 interface ReferralFieldDef extends BaseFieldDef {
-    type: 'referral';
+    type: "referral";
     options?: SelectOption[];
 }
 /** Stored value for followup field: false/null = no followup; object = one-time followup as number of days from current date. */
 interface FollowupValue {
-    followupType: 'one time';
+    followupType: "one time";
     /** Number of days from (current) date when set; always stored as string. */
     value: string;
-    unit: 'days';
+    unit: "days";
 }
 /**
  * Follow-up field: "No Follow-up" | "One Time" with schedule by duration (e.g. 7 days) or by date.
  * Value shape: false | FollowupValue.
  */
 interface FollowupFieldDef extends BaseFieldDef {
-    type: 'followup';
+    type: "followup";
 }
 /** A matched master record returned from a backend search API. */
 interface MatchedCondition {
@@ -252,7 +294,7 @@ interface DiagnosisTextareaValue {
  * Value shape: `SmartTextareaValue` — `{ text, extractedKeywords }`.
  */
 interface SmartTextareaFieldDef extends BaseFieldDef {
-    type: 'smart_textarea';
+    type: "smart_textarea";
     height?: number;
     /** Semantic label for the kind of content (e.g. 'allergies', 'chiefComplaints', 'symptoms'). */
     componentType: string;
@@ -266,7 +308,7 @@ interface SmartTextareaFieldDef extends BaseFieldDef {
  * Value shape in form state can be plain text (legacy) or `DiagnosisTextareaValue`.
  */
 interface DiagnosisTextareaFieldDef extends BaseFieldDef {
-    type: 'diagnosis_textarea';
+    type: "diagnosis_textarea";
     /** Height in pixels. If omitted, uses default min height (80px). */
     height?: number;
     /** Debounce delay in ms before API call triggers. Default: 700. */
@@ -284,7 +326,7 @@ interface DiagnosisTextareaFieldDef extends BaseFieldDef {
  * - `complaint_chips` is an alias type string for the same widget (e.g. chief complaints).
  */
 interface SuggestionTextareaFieldDef extends BaseFieldDef {
-    type: 'suggestion_textarea' | 'complaint_chips';
+    type: "suggestion_textarea" | "complaint_chips";
     options?: SelectOption[];
     /** Height in pixels for the textarea. */
     height?: number;
@@ -332,13 +374,13 @@ interface LensAssessmentValue {
  * optional clinical notes. Shown via schema rules (e.g. chief-complaint `contains`).
  */
 interface LensAssessmentFieldDef extends BaseFieldDef {
-    type: 'lens_assessment';
+    type: "lens_assessment";
     meta?: {
         cardTitle?: string;
     } & Record<string, unknown>;
 }
 /** Keys for the five-item functional impairment scale (0–3 each). */
-type FunctionalImpairmentDimension = 'reading' | 'nightDriving' | 'glare' | 'occupation' | 'adl';
+type FunctionalImpairmentDimension = "reading" | "nightDriving" | "glare" | "occupation" | "adl";
 /** Stored value for `functional_impairment_score` fields (sum 0–15). */
 interface FunctionalImpairmentScoreValue {
     reading: number;
@@ -351,13 +393,13 @@ interface FunctionalImpairmentScoreValue {
  * Cataract-related functional impairment: five 0–3 items and total /15.
  */
 interface FunctionalImpairmentScoreFieldDef extends BaseFieldDef {
-    type: 'functional_impairment_score';
+    type: "functional_impairment_score";
     meta?: {
         cardTitle?: string;
     } & Record<string, unknown>;
 }
 /** Biometry acquisition method (IOL workup). */
-type BiometryMethod = 'optical_biometry' | 'ascan_immersion' | 'ascan_contact';
+type BiometryMethod = "optical_biometry" | "ascan_immersion" | "ascan_contact";
 /** Value for `biometry_iol_workup` — bilateral inputs, shared formula/method, optional workup flags. */
 interface BiometryIolWorkupValue {
     axialLengthOD: string;
@@ -378,7 +420,7 @@ interface BiometryIolWorkupValue {
 }
 /** Table + IOL formula workup (Stage 7). */
 interface BiometryIolWorkupFieldDef extends BaseFieldDef {
-    type: 'biometry_iol_workup';
+    type: "biometry_iol_workup";
     meta?: {
         cardTitle?: string;
     } & Record<string, unknown>;
@@ -390,49 +432,49 @@ interface SurgicalRiskFlagsValue {
 }
 /** Bilateral cataract surgical risk flags with derived Low/Moderate/High badge per eye (Stage 11). */
 interface SurgicalRiskFlagsFieldDef extends BaseFieldDef {
-    type: 'surgical_risk_flags';
+    type: "surgical_risk_flags";
     meta?: {
         cardTitle?: string;
     } & Record<string, unknown>;
 }
 /** Urology OPD: dynamic smart history (SOCRATES, IPSS, haematuria, sexual). */
 interface UrologySmartHistoryFieldDef extends BaseFieldDef {
-    type: 'urology_smart_history';
+    type: "urology_smart_history";
 }
 /** Urology OPD: structured examination (general, abdomen, GU, DRE). */
 interface UrologyExaminationFieldDef extends BaseFieldDef {
-    type: 'urology_examination';
+    type: "urology_examination";
 }
 /** Urology OPD: objective pathway metrics and risk toggles (maps to `uro_pathway`). */
 interface UrologyPathwayFieldDef extends BaseFieldDef {
-    type: 'urology_pathway';
+    type: "urology_pathway";
     meta?: {
         subtitle?: string;
     } & Record<string, unknown>;
 }
 /** OB/GYN OPD: structured examination (general/abdomen/breast/pelvic + uterus size). */
 interface OBGExaminationFieldDef extends BaseFieldDef {
-    type: 'obg_examination';
+    type: "obg_examination";
 }
 /** OB/GYN OPD: consultant zoning + 5 pathway panels (menstrual / antenatal / gynae / infertility / postop). Antenatal panels render inside the Obstetric History widget. */
 interface OBGPathwayFieldDef extends BaseFieldDef {
-    type: 'obg_pathway';
+    type: "obg_pathway";
 }
 /** General surgery OPD: structured smart history (SOCRATES, swelling, GI, breast, anorectal, thyroid); HOPC is template field `symptoms` embedded in the widget. */
 interface GeneralSurgerySmartHistoryFieldDef extends BaseFieldDef {
-    type: 'general_surgery_smart_history';
+    type: "general_surgery_smart_history";
 }
 /** General surgery OPD: general signs, regional selection, structured abdomen + regional exam cards + notes. */
 interface GeneralSurgeryExaminationFieldDef extends BaseFieldDef {
-    type: 'general_surgery_examination';
+    type: "general_surgery_examination";
 }
 /** General surgery OPD: condition-wise grading (Clearsight triggers; no surgery column). */
 interface GeneralSurgeryGradingFieldDef extends BaseFieldDef {
-    type: 'general_surgery_grading';
+    type: "general_surgery_grading";
 }
 /** Pain scale (slider) + checkbox flags in one highlight-label shell; reusable across specialties. */
 interface PainScaleFlagsFieldDef extends BaseFieldDef {
-    type: 'pain_scale_flags';
+    type: "pain_scale_flags";
     min?: number;
     max?: number;
     step?: number;
@@ -457,13 +499,13 @@ interface MedicationFrequentItem {
     duration?: string;
     /** Optional structured duration components (preferred over duration when present). */
     duration_value?: string;
-    duration_unit?: 'days' | 'weeks' | 'months' | string;
+    duration_unit?: "days" | "weeks" | "months" | string;
     /** Optional schedule slots; when omitted, Forminator falls back to "0". */
     morning?: string;
     afternoon?: string;
     night?: string;
     /** Optional food-timing hint; when omitted, Forminator defaults to "AFTER FOOD". */
-    before_after?: 'AFTER FOOD' | 'BEFORE FOOD' | string;
+    before_after?: "AFTER FOOD" | "BEFORE FOOD" | string;
     /** Optional notes; when omitted, Forminator may derive a note from route. */
     notes?: string;
     usage_count?: number;
@@ -501,7 +543,7 @@ interface DiagnosticPackage {
     tests: DiagnosticPackageTest[];
 }
 interface PhoneInputFieldDef extends BaseFieldDef {
-    type: 'phone_input';
+    type: "phone_input";
     meta?: {
         /** ID of the sibling otp_input field to clear when the phone is edited after a send. */
         otpFieldId?: string;
@@ -510,7 +552,7 @@ interface PhoneInputFieldDef extends BaseFieldDef {
     };
 }
 interface OtpInputFieldDef extends BaseFieldDef {
-    type: 'otp_input';
+    type: "otp_input";
     meta?: {
         /** ID of the sibling phone_input field to read the number from. Defaults to "phone". */
         phoneFieldId?: string;
@@ -526,18 +568,18 @@ interface OtpVerifiedValue {
     code: string;
     token?: string;
 }
-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 | PhoneInputFieldDef | OtpInputFieldDef | BaseFieldDef;
+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';
+    type: "toggle";
 }
 interface ToggleFieldDef extends BaseFieldDef {
-    type: 'toggle';
+    type: "toggle";
     excludes?: string[];
 }
 interface Condition {
     field?: string;
-    op: '==' | '!=' | '>' | '<' | '>=' | '<=' | 'in' | 'contains';
+    op: "==" | "!=" | ">" | "<" | ">=" | "<=" | "in" | "contains";
     /**
      * For `op: "contains"`:
      * - If the field value is an **array**, checks `value.includes(condition.value)` (e.g. multiselect).
@@ -547,7 +589,7 @@ interface Condition {
     value: any;
 }
 interface RuleAction {
-    action: 'hide' | 'show' | 'disable' | 'enable' | 'setRequired';
+    action: "hide" | "show" | "disable" | "enable" | "setRequired";
     target: string;
 }
 interface Rule {
@@ -565,7 +607,7 @@ interface Workflow {
     transitions: WorkflowTransition[];
 }
 interface ColumnLayout {
-    type: 'column_layout';
+    type: "column_layout";
     id: string;
     /** Number of columns. Children take equal width. */
     columns: number;
@@ -576,19 +618,19 @@ interface ColumnLayout {
 /** Section child: either a field ID or a nested column_layout. */
 type SectionChild = string | ColumnLayout;
 interface Section {
-    type: 'section';
+    type: "section";
     id: string;
     title: string;
     children: SectionChild[];
 }
 interface MultiStepNode {
-    type: 'section';
+    type: "section";
     id: string;
     title: string;
     children: SectionChild[];
 }
 interface MultiStepLayoutNode {
-    type: 'multi_step';
+    type: "multi_step";
     id: string;
     title?: string;
     steps: MultiStepNode[];
@@ -596,14 +638,14 @@ interface MultiStepLayoutNode {
         /** Show step indicator header. Default true. */
         showStepper?: boolean;
         /** Visual style for the stepper. Default 'numbered'. */
-        stepperVariant?: 'numbered' | 'dots' | 'labels';
+        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';
+    method: "GET" | "POST" | "PUT";
     url: string;
 }
 interface ScoreRange {
@@ -613,31 +655,31 @@ interface ScoreRange {
 }
 interface ScoreComputation {
     target: string;
-    type: 'score';
+    type: "score";
     source: string;
     ranges: ScoreRange[];
 }
 interface SumComputation {
     target: string;
-    type: 'sum';
+    type: "sum";
     fields: string[];
 }
 /** Expression node for formula computation: field ref, number, or binary op. */
 type FormulaExpr = {
-    type: 'field';
+    type: "field";
     field: string;
 } | {
-    type: 'number';
+    type: "number";
     value: number;
 } | {
-    type: 'op';
-    op: '+' | '-' | '*' | '/' | '**';
+    type: "op";
+    op: "+" | "-" | "*" | "/" | "**";
     left: FormulaExpr;
     right: FormulaExpr;
 };
 interface FormulaComputation {
     target: string;
-    type: 'formula';
+    type: "formula";
     expression: FormulaExpr;
 }
 type Computation = SumComputation | ScoreComputation | FormulaComputation;
@@ -1009,6 +1051,16 @@ interface SmartFormProps {
  */
 declare const SmartForm: React.FC<SmartFormProps>;
 
+declare function isLabelVisible(fieldDef: Pick<BaseFieldDef, "style">): boolean;
+declare function FieldRequiredIndicator({ fieldDef, }: {
+    fieldDef: Pick<BaseFieldDef, "required" | "style">;
+}): react_jsx_runtime.JSX.Element | null;
+declare function fieldWrapperClass(fieldDef: Pick<BaseFieldDef, "style">, ...defaults: (string | undefined)[]): string;
+declare function fieldLabelClass(fieldDef: Pick<BaseFieldDef, "style">, ...defaults: (string | undefined)[]): string;
+declare function fieldControlClass(fieldDef: Pick<BaseFieldDef, "style">, ...defaults: (string | undefined)[]): string;
+declare function fieldDescriptionClass(fieldDef: Pick<BaseFieldDef, "style">, ...defaults: (string | undefined)[]): string;
+declare function fieldErrorClass(fieldDef: Pick<BaseFieldDef, "style">, ...defaults: (string | undefined)[]): string;
+
 interface FieldRendererProps {
     fieldId: string;
 }
@@ -1075,6 +1127,29 @@ interface FormControlsProps {
 }
 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;
+    /**
+     * When true, do not show "N files selected" in the drop zone; parent can render file rows.
+     */
+    listLayout?: boolean;
+}
+declare function Upload({ value, accept, multiple, disabled, onChange, className, formatsLabel, placeholder, beforeUploadContent, id: idProp, listLayout, }: UploadProps): react_jsx_runtime.JSX.Element;
+
+declare const FormFileUploadWidget: React.FC<{
+    fieldId: string;
+}>;
+
 declare const ImageUploadWidget: React.FC<{
     fieldId: string;
 }>;
@@ -1280,4 +1355,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, 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, 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, FieldRequiredIndicator, type FieldState, type FieldStyleClassNames, type FieldStyleConfig, 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, fieldControlClass, fieldDescriptionClass, fieldErrorClass, fieldLabelClass, fieldMetaRequestsMarMedicationOrdersButton, fieldWrapperClass, isLabelVisible, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };