formanitor 0.0.37 → 0.0.39

package/dist/index.d.cts

@@ -84,6 +84,16 @@ interface RichTextFieldDef extends BaseFieldDef {
 interface NumberFieldDef extends BaseFieldDef {
     type: 'number';
 }
+/** Single-thumb numeric slider (e.g. VAS 0–10). Value is a number. */
+interface SliderFieldDef extends BaseFieldDef {
+    type: 'slider';
+    /** Inclusive minimum. Default 0. */
+    min?: number;
+    /** Inclusive maximum. Default 10. */
+    max?: number;
+    /** Default 1. */
+    step?: number;
+}
 /** Option for select/radio/checkbox. When score is set, sum computation uses it for aggregation. */
 interface SelectOption {
     label: string;
@@ -262,6 +272,149 @@ interface DiagnosisTextareaFieldDef extends BaseFieldDef {
     /** Debounce delay in ms before API call triggers. Default: 700. */
     debounceDelay?: number;
 }
+/**
+ * Reusable **textarea** with optional **suggestion chips** (schema `options` or `dataSource`).
+ * - Value is a **single string** (same as `textarea`); chip clicks append or remove that option’s
+ *   `value` as a comma‑separated token (default `", "`; override with `meta.appendSeparator`).
+ * - Schema `rules` with `op: "contains"` on this field match **token equality** after splitting
+ *   on commas (see `evaluateRules` / `suggestion_textarea` docs).
+ * - Optionally set **`meta.parallelChipFieldId`** to the id of a **`multiselect`** field (often
+ *   `hidden`) with the same `options`; that field’s array value is derived from chip tokens in
+ *   the textarea string so APIs can read a structured list without parsing commas.
+ * - `complaint_chips` is an alias type string for the same widget (e.g. chief complaints).
+ */
+interface SuggestionTextareaFieldDef extends BaseFieldDef {
+    type: 'suggestion_textarea' | 'complaint_chips';
+    options?: SelectOption[];
+    /** Height in pixels for the textarea. */
+    height?: number;
+    meta?: {
+        /** Join string when writing tokens (default `", "`). */
+        appendSeparator?: string;
+        /** `aria-label` for the chip group. */
+        suggestionsAriaLabel?: string;
+        /**
+         * ID of a sibling **`multiselect`** field (usually `hidden: true`). Its value is kept in sync
+         * as an array of selected chip values derived from the comma-separated textarea string.
+         */
+        parallelChipFieldId?: string;
+        /**
+         * Optional sibling field ids rendered **inside** the suggestion shell (between chips and the
+         * free-text area). Typically `text` / `select` fields (e.g. duration, onset). Those fields
+         * should use **`hidden: true`** and be **omitted from `layout`** so they are not shown twice.
+         */
+        embeddedFieldIds?: string[];
+    } & Record<string, unknown>;
+}
+/** LOCS III component grades for one eye (integer scales per LOCS III). */
+interface LocsGrades {
+    NO: number;
+    NC: number;
+    C: number;
+    PSC: number;
+}
+/** Value stored for `lens_assessment` fields. */
+interface LensAssessmentValue {
+    notes: string;
+    /**
+     * Legacy optional key from older templates; LOCS UI does not surface chips.
+     * Kept for backward compatibility with saved submissions.
+     */
+    assessmentKey?: string;
+    /** LOCS III grades; omitted in older payloads — normalized to zeros in the widget. */
+    locs?: {
+        OD: LocsGrades;
+        OS: LocsGrades;
+    };
+}
+/**
+ * Ophthalmology lens assessment: LOCS III grid (OD/OS), derived cataract-stage badges,
+ * optional clinical notes. Shown via schema rules (e.g. chief-complaint `contains`).
+ */
+interface LensAssessmentFieldDef extends BaseFieldDef {
+    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';
+/** Stored value for `functional_impairment_score` fields (sum 0–15). */
+interface FunctionalImpairmentScoreValue {
+    reading: number;
+    nightDriving: number;
+    glare: number;
+    occupation: number;
+    adl: number;
+}
+/**
+ * Cataract-related functional impairment: five 0–3 items and total /15.
+ */
+interface FunctionalImpairmentScoreFieldDef extends BaseFieldDef {
+    type: 'functional_impairment_score';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** Biometry acquisition method (IOL workup). */
+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;
+    axialLengthOS: string;
+    k1k2AxisOD: string;
+    k1k2AxisOS: string;
+    anteriorChamberDepthOD: string;
+    anteriorChamberDepthOS: string;
+    iolPowerOD: string;
+    iolPowerOS: string;
+    targetRefractionOD: string;
+    targetRefractionOS: string;
+    formula: string;
+    method: BiometryMethod;
+    cornealTopoUploaded: boolean;
+    specularMicroscopyDone: boolean;
+    endothelialCount: string;
+}
+/** Table + IOL formula workup (Stage 7). */
+interface BiometryIolWorkupFieldDef extends BaseFieldDef {
+    type: 'biometry_iol_workup';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** Per-eye surgical risk checkbox selections; Diabetes is kept in sync for OD and OS. */
+interface SurgicalRiskFlagsValue {
+    OD: string[];
+    OS: string[];
+}
+/** Bilateral cataract surgical risk flags with derived Low/Moderate/High badge per eye (Stage 11). */
+interface SurgicalRiskFlagsFieldDef extends BaseFieldDef {
+    type: 'surgical_risk_flags';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** General surgery OPD: structured smart history (SOCRATES, swelling, GI, breast, anorectal, thyroid + systemic). */
+interface GeneralSurgerySmartHistoryFieldDef extends BaseFieldDef {
+    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';
+}
+/** General surgery OPD: condition-wise grading (Clearsight triggers; no surgery column). */
+interface GeneralSurgeryGradingFieldDef extends BaseFieldDef {
+    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';
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: SelectOption[];
+}
 interface MedicationFrequentItem {
     id: string;
     name: string;
@@ -320,7 +473,11 @@ interface DiagnosticPackage {
     department?: string;
     tests: DiagnosticPackageTest[];
 }
-type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | ToggleFieldDef | BaseFieldDef;
+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 | PainScaleFlagsFieldDef | BaseFieldDef;
+/** Boolean switch; value is `true` | `false`. */
+interface ToggleFieldDef extends BaseFieldDef {
+    type: 'toggle';
+}
 interface ToggleFieldDef extends BaseFieldDef {
     type: 'toggle';
     excludes?: string[];
@@ -328,6 +485,12 @@ interface ToggleFieldDef extends BaseFieldDef {
 interface Condition {
     field?: string;
     op: '==' | '!=' | '>' | '<' | '>=' | '<=' | 'in' | 'contains';
+    /**
+     * For `op: "contains"`:
+     * - If the field value is an **array**, checks `value.includes(condition.value)` (e.g. multiselect).
+     * - If the field value is a **string** (e.g. `suggestion_textarea`), splits on commas, trims
+     *   tokens, and checks that one token equals `String(condition.value)` (chip values in text).
+     */
     value: any;
 }
 interface RuleAction {
@@ -958,4 +1121,4 @@ declare const SmartTextareaWidget: React.FC<{
     fieldId: string;
 }>;
 
-export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, 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, 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 ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, 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, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreConfig, type SubmissionData, type SumComputation, type TextFieldDef, type ToggleFieldDef, 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, 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 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 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

@@ -84,6 +84,16 @@ interface RichTextFieldDef extends BaseFieldDef {
 interface NumberFieldDef extends BaseFieldDef {
     type: 'number';
 }
+/** Single-thumb numeric slider (e.g. VAS 0–10). Value is a number. */
+interface SliderFieldDef extends BaseFieldDef {
+    type: 'slider';
+    /** Inclusive minimum. Default 0. */
+    min?: number;
+    /** Inclusive maximum. Default 10. */
+    max?: number;
+    /** Default 1. */
+    step?: number;
+}
 /** Option for select/radio/checkbox. When score is set, sum computation uses it for aggregation. */
 interface SelectOption {
     label: string;
@@ -262,6 +272,149 @@ interface DiagnosisTextareaFieldDef extends BaseFieldDef {
     /** Debounce delay in ms before API call triggers. Default: 700. */
     debounceDelay?: number;
 }
+/**
+ * Reusable **textarea** with optional **suggestion chips** (schema `options` or `dataSource`).
+ * - Value is a **single string** (same as `textarea`); chip clicks append or remove that option’s
+ *   `value` as a comma‑separated token (default `", "`; override with `meta.appendSeparator`).
+ * - Schema `rules` with `op: "contains"` on this field match **token equality** after splitting
+ *   on commas (see `evaluateRules` / `suggestion_textarea` docs).
+ * - Optionally set **`meta.parallelChipFieldId`** to the id of a **`multiselect`** field (often
+ *   `hidden`) with the same `options`; that field’s array value is derived from chip tokens in
+ *   the textarea string so APIs can read a structured list without parsing commas.
+ * - `complaint_chips` is an alias type string for the same widget (e.g. chief complaints).
+ */
+interface SuggestionTextareaFieldDef extends BaseFieldDef {
+    type: 'suggestion_textarea' | 'complaint_chips';
+    options?: SelectOption[];
+    /** Height in pixels for the textarea. */
+    height?: number;
+    meta?: {
+        /** Join string when writing tokens (default `", "`). */
+        appendSeparator?: string;
+        /** `aria-label` for the chip group. */
+        suggestionsAriaLabel?: string;
+        /**
+         * ID of a sibling **`multiselect`** field (usually `hidden: true`). Its value is kept in sync
+         * as an array of selected chip values derived from the comma-separated textarea string.
+         */
+        parallelChipFieldId?: string;
+        /**
+         * Optional sibling field ids rendered **inside** the suggestion shell (between chips and the
+         * free-text area). Typically `text` / `select` fields (e.g. duration, onset). Those fields
+         * should use **`hidden: true`** and be **omitted from `layout`** so they are not shown twice.
+         */
+        embeddedFieldIds?: string[];
+    } & Record<string, unknown>;
+}
+/** LOCS III component grades for one eye (integer scales per LOCS III). */
+interface LocsGrades {
+    NO: number;
+    NC: number;
+    C: number;
+    PSC: number;
+}
+/** Value stored for `lens_assessment` fields. */
+interface LensAssessmentValue {
+    notes: string;
+    /**
+     * Legacy optional key from older templates; LOCS UI does not surface chips.
+     * Kept for backward compatibility with saved submissions.
+     */
+    assessmentKey?: string;
+    /** LOCS III grades; omitted in older payloads — normalized to zeros in the widget. */
+    locs?: {
+        OD: LocsGrades;
+        OS: LocsGrades;
+    };
+}
+/**
+ * Ophthalmology lens assessment: LOCS III grid (OD/OS), derived cataract-stage badges,
+ * optional clinical notes. Shown via schema rules (e.g. chief-complaint `contains`).
+ */
+interface LensAssessmentFieldDef extends BaseFieldDef {
+    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';
+/** Stored value for `functional_impairment_score` fields (sum 0–15). */
+interface FunctionalImpairmentScoreValue {
+    reading: number;
+    nightDriving: number;
+    glare: number;
+    occupation: number;
+    adl: number;
+}
+/**
+ * Cataract-related functional impairment: five 0–3 items and total /15.
+ */
+interface FunctionalImpairmentScoreFieldDef extends BaseFieldDef {
+    type: 'functional_impairment_score';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** Biometry acquisition method (IOL workup). */
+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;
+    axialLengthOS: string;
+    k1k2AxisOD: string;
+    k1k2AxisOS: string;
+    anteriorChamberDepthOD: string;
+    anteriorChamberDepthOS: string;
+    iolPowerOD: string;
+    iolPowerOS: string;
+    targetRefractionOD: string;
+    targetRefractionOS: string;
+    formula: string;
+    method: BiometryMethod;
+    cornealTopoUploaded: boolean;
+    specularMicroscopyDone: boolean;
+    endothelialCount: string;
+}
+/** Table + IOL formula workup (Stage 7). */
+interface BiometryIolWorkupFieldDef extends BaseFieldDef {
+    type: 'biometry_iol_workup';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** Per-eye surgical risk checkbox selections; Diabetes is kept in sync for OD and OS. */
+interface SurgicalRiskFlagsValue {
+    OD: string[];
+    OS: string[];
+}
+/** Bilateral cataract surgical risk flags with derived Low/Moderate/High badge per eye (Stage 11). */
+interface SurgicalRiskFlagsFieldDef extends BaseFieldDef {
+    type: 'surgical_risk_flags';
+    meta?: {
+        cardTitle?: string;
+    } & Record<string, unknown>;
+}
+/** General surgery OPD: structured smart history (SOCRATES, swelling, GI, breast, anorectal, thyroid + systemic). */
+interface GeneralSurgerySmartHistoryFieldDef extends BaseFieldDef {
+    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';
+}
+/** General surgery OPD: condition-wise grading (Clearsight triggers; no surgery column). */
+interface GeneralSurgeryGradingFieldDef extends BaseFieldDef {
+    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';
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: SelectOption[];
+}
 interface MedicationFrequentItem {
     id: string;
     name: string;
@@ -320,7 +473,11 @@ interface DiagnosticPackage {
     department?: string;
     tests: DiagnosticPackageTest[];
 }
-type FieldDef = TextFieldDef | RichTextFieldDef | NumberFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | MediaUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | DiagnosisTextareaFieldDef | ToggleFieldDef | BaseFieldDef;
+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 | PainScaleFlagsFieldDef | BaseFieldDef;
+/** Boolean switch; value is `true` | `false`. */
+interface ToggleFieldDef extends BaseFieldDef {
+    type: 'toggle';
+}
 interface ToggleFieldDef extends BaseFieldDef {
     type: 'toggle';
     excludes?: string[];
@@ -328,6 +485,12 @@ interface ToggleFieldDef extends BaseFieldDef {
 interface Condition {
     field?: string;
     op: '==' | '!=' | '>' | '<' | '>=' | '<=' | 'in' | 'contains';
+    /**
+     * For `op: "contains"`:
+     * - If the field value is an **array**, checks `value.includes(condition.value)` (e.g. multiselect).
+     * - If the field value is a **string** (e.g. `suggestion_textarea`), splits on commas, trims
+     *   tokens, and checks that one token equals `String(condition.value)` (chip values in text).
+     */
     value: any;
 }
 interface RuleAction {
@@ -958,4 +1121,4 @@ declare const SmartTextareaWidget: React.FC<{
     fieldId: string;
 }>;
 
-export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, 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, 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 ImageUploadFieldDef, ImageUploadWidget, type Investigation, type InvestigationFrequentItem, type InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, MAR_MEDICATION_ORDERS_META_KEY, type MatchedCondition, type MediaUploadFieldDef, MediaUploadWidget, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, 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, SmartForm, type SmartFormProps, type SmartKeywordsResult, type SmartTextareaFieldDef, type SmartTextareaValue, SmartTextareaWidget, type StaticTextFieldDef, type StoreConfig, type SubmissionData, type SumComputation, type TextFieldDef, type ToggleFieldDef, 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, 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 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 ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, fieldMetaRequestsMarMedicationOrdersButton, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, usePackages, useSmartKeywords, validateField, validateForm };