formanitor 0.0.14 → 0.0.16

package/dist/index.d.cts

@@ -217,6 +217,52 @@ interface SmartTextareaFieldDef extends BaseFieldDef {
     /** Debounce delay in ms before NLP + search triggers. Default: 1000. */
     debounceDelay?: number;
 }
+interface MedicationFrequentItem {
+    id: string;
+    name: string;
+    short_name?: string;
+    /** Optional brand name to prefill into the medication row (falls back to name). */
+    brand_name?: string;
+    frequency?: string;
+    route?: string;
+    /**
+     * Optional human-readable duration like "5 days" or "2 weeks".
+     * If provided, Forminator will parse it unless duration_value/unit are set.
+     */
+    duration?: string;
+    /** Optional structured duration components (preferred over duration when present). */
+    duration_value?: 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;
+    /** Optional notes; when omitted, Forminator may derive a note from route. */
+    notes?: string;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface InvestigationFrequentItem {
+    id: string;
+    name: string;
+    code?: string | null;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface ProcedureFrequentItem {
+    id: string;
+    name: string;
+    code?: string | null;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface DoctorFrequentItems {
+    medications?: MedicationFrequentItem[];
+    investigations?: InvestigationFrequentItem[];
+    procedures?: ProcedureFrequentItem[];
+}
 type FieldDef = TextFieldDef | NumberFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | BaseFieldDef;
 interface Condition {
     field?: string;
@@ -493,10 +539,16 @@ type FieldHandler = {
 };
 type FieldHandlersMap = Record<string, FieldHandler>;
 declare function useFieldHandlers(fieldId: string): FieldHandler;
+declare function useFrequentItems(): DoctorFrequentItems;
 interface FormProviderProps {
     schema: FormDef;
     config?: StoreConfig;
     fieldHandlers?: FieldHandlersMap;
+    /**
+     * Doctor-scoped frequently used items (e.g. from GET /api/doctor-state/frequent-items/).
+     * Consumer fetches and passes this; Forminator flows it to medications, investigations, and procedures widgets.
+     */
+    frequentItems?: DoctorFrequentItems;
     children: React.ReactNode;
 }
 declare const FormProvider: React.FC<FormProviderProps>;
@@ -658,14 +710,14 @@ type AIMedication = {
 };
 
 type MedicationSearchResult = {
-    id: number;
+    id: string;
     name: string;
     generic_name?: string;
     manufacturer?: string;
     score?: number;
 };
 type Medication = {
-    id: number;
+    id: string;
     brand_name: string;
     generic_name: string;
     frequency: string;
@@ -684,6 +736,8 @@ type AddMedicationFieldProps = {
     onChange: (items: Medication[]) => void;
     onSearch: (query: string) => Promise<MedicationSearchResult[]>;
     recentlyUsed?: MedicationSearchResult[];
+    /** Doctor-scoped frequently used medications (from FormProvider frequentItems) */
+    frequentItems?: MedicationFrequentItem[];
     /** AI-suggested medications shown as badges; clicking adds to value */
     suggestedMedications?: AIMedication[];
 };
@@ -720,6 +774,8 @@ type AddInvestigationFieldProps = {
     onChange: (items: Investigation[]) => void;
     onSearch: (query: string) => Promise<InvestigationSearchResult[]>;
     recentlyUsed?: InvestigationSearchResult[];
+    /** Doctor-scoped frequently used investigations (from FormProvider frequentItems) */
+    frequentItems?: InvestigationFrequentItem[];
 };
 declare const AddInvestigationField: React.FC<AddInvestigationFieldProps>;
 
@@ -762,4 +818,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, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, 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 InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type MatchedCondition, type Medication, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type Permission, type PresignedUploadResponse, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, 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 ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, useField, useFieldHandlers, useForm, useFormStore, useSmartKeywords, validateField, validateForm };
+export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, 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, type MatchedCondition, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type Permission, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, 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 ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, useSmartKeywords, validateField, validateForm };

package/dist/index.d.ts

@@ -217,6 +217,52 @@ interface SmartTextareaFieldDef extends BaseFieldDef {
     /** Debounce delay in ms before NLP + search triggers. Default: 1000. */
     debounceDelay?: number;
 }
+interface MedicationFrequentItem {
+    id: string;
+    name: string;
+    short_name?: string;
+    /** Optional brand name to prefill into the medication row (falls back to name). */
+    brand_name?: string;
+    frequency?: string;
+    route?: string;
+    /**
+     * Optional human-readable duration like "5 days" or "2 weeks".
+     * If provided, Forminator will parse it unless duration_value/unit are set.
+     */
+    duration?: string;
+    /** Optional structured duration components (preferred over duration when present). */
+    duration_value?: 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;
+    /** Optional notes; when omitted, Forminator may derive a note from route. */
+    notes?: string;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface InvestigationFrequentItem {
+    id: string;
+    name: string;
+    code?: string | null;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface ProcedureFrequentItem {
+    id: string;
+    name: string;
+    code?: string | null;
+    usage_count?: number;
+    last_used_at?: string;
+}
+interface DoctorFrequentItems {
+    medications?: MedicationFrequentItem[];
+    investigations?: InvestigationFrequentItem[];
+    procedures?: ProcedureFrequentItem[];
+}
 type FieldDef = TextFieldDef | NumberFieldDef | SelectFieldDef | RadioFieldDef | CheckboxFieldDef | RepeatableFieldDef | ImageUploadFieldDef | SignatureFieldDef | EditableTableFieldDef | StaticTextFieldDef | MedicationsFieldDef | InvestigationsFieldDef | ProceduresFieldDef | DifferentialDiagnosisFieldDef | VitalsFieldDef | ReferralFieldDef | FollowupFieldDef | SmartTextareaFieldDef | BaseFieldDef;
 interface Condition {
     field?: string;
@@ -493,10 +539,16 @@ type FieldHandler = {
 };
 type FieldHandlersMap = Record<string, FieldHandler>;
 declare function useFieldHandlers(fieldId: string): FieldHandler;
+declare function useFrequentItems(): DoctorFrequentItems;
 interface FormProviderProps {
     schema: FormDef;
     config?: StoreConfig;
     fieldHandlers?: FieldHandlersMap;
+    /**
+     * Doctor-scoped frequently used items (e.g. from GET /api/doctor-state/frequent-items/).
+     * Consumer fetches and passes this; Forminator flows it to medications, investigations, and procedures widgets.
+     */
+    frequentItems?: DoctorFrequentItems;
     children: React.ReactNode;
 }
 declare const FormProvider: React.FC<FormProviderProps>;
@@ -658,14 +710,14 @@ type AIMedication = {
 };
 
 type MedicationSearchResult = {
-    id: number;
+    id: string;
     name: string;
     generic_name?: string;
     manufacturer?: string;
     score?: number;
 };
 type Medication = {
-    id: number;
+    id: string;
     brand_name: string;
     generic_name: string;
     frequency: string;
@@ -684,6 +736,8 @@ type AddMedicationFieldProps = {
     onChange: (items: Medication[]) => void;
     onSearch: (query: string) => Promise<MedicationSearchResult[]>;
     recentlyUsed?: MedicationSearchResult[];
+    /** Doctor-scoped frequently used medications (from FormProvider frequentItems) */
+    frequentItems?: MedicationFrequentItem[];
     /** AI-suggested medications shown as badges; clicking adds to value */
     suggestedMedications?: AIMedication[];
 };
@@ -720,6 +774,8 @@ type AddInvestigationFieldProps = {
     onChange: (items: Investigation[]) => void;
     onSearch: (query: string) => Promise<InvestigationSearchResult[]>;
     recentlyUsed?: InvestigationSearchResult[];
+    /** Doctor-scoped frequently used investigations (from FormProvider frequentItems) */
+    frequentItems?: InvestigationFrequentItem[];
 };
 declare const AddInvestigationField: React.FC<AddInvestigationFieldProps>;
 
@@ -762,4 +818,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, DifferentialDiagnosis, type DifferentialDiagnosisFieldDef, type DifferentialDiagnosisItem, type DifferentialDiagnosisProps, 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 InvestigationSearchResult, type InvestigationsFieldDef, type LayoutNode, type MatchedCondition, type Medication, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type Permission, type PresignedUploadResponse, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, 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 ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, useField, useFieldHandlers, useForm, useFormStore, useSmartKeywords, validateField, validateForm };
+export { type AIDifferentialDiagnosisItem, AddInvestigationField, type AddInvestigationFieldProps, AddMedicationField, type AddMedicationFieldProps, type BaseFieldDef, type CheckboxFieldDef, type ColumnLayout, type Computation, type Condition, type CreateUploadHandlerOptions, type DataSource, 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, type MatchedCondition, type Medication, type MedicationFrequentItem, type MedicationSearchResult, type MedicationsFieldDef, type NumberFieldDef, type Permission, type PresignedUploadResponse, type ProcedureFrequentItem, type ProceduresFieldDef, type RadioFieldDef, ReadOnlyForm, ReadOnlyImageUpload, ReadOnlySignature, ReadOnlyTable, type ReferralFieldDef, type ReferralItem, type RepeatableFieldDef, 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 ValidationRule, type VitalsFieldDef, type WebhookDef, type Workflow, type WorkflowTransition, createUploadHandler, evaluateRules, useField, useFieldHandlers, useForm, useFormStore, useFrequentItems, useSmartKeywords, validateField, validateForm };