@medplum/react 5.1.6 → 5.1.8

package/dist/esm/index.d.ts

@@ -36,6 +36,7 @@ import type { ErrorInfo } from 'react';
 import type { ExtendedInternalSchemaElement } from '@medplum/core';
 import type { ExtractResource } from '@medplum/fhirtypes';
 import type { Filter } from '@medplum/core';
+import { ForwardRefExoticComponent } from 'react';
 import { getPreferredPharmaciesFromPatient } from '@medplum/core';
 import type { HumanName } from '@medplum/fhirtypes';
 import type { HumanNameFormatOptions } from '@medplum/core';
@@ -83,6 +84,7 @@ import type { QuestionnaireResponseItemAnswer } from '@medplum/fhirtypes';
 import type { Range as Range_2 } from '@medplum/fhirtypes';
 import type { Ratio } from '@medplum/fhirtypes';
 import type { ReactNode } from 'react';
+import { RefAttributes } from 'react';
 import type { Reference } from '@medplum/fhirtypes';
 import { removePreferredPharmacyFromPatient } from '@medplum/core';
 import type { RequestGroup } from '@medplum/fhirtypes';
@@ -226,6 +228,9 @@ export declare function addYearToDateFilter(definition: SearchRequest, field: st
  */
 export declare function addYesterdayFilter(definition: SearchRequest, field: string): SearchRequest;
 
+/** Allergies section — searches for AllergyIntolerance resources. */
+export declare const AllergiesSection: PatientSummarySectionConfig;
+
 export declare function AnnotationInput(props: AnnotationInputProps): JSX.Element;
 
 export declare interface AnnotationInputProps extends ComplexTypeInputProps<Annotation> {
@@ -520,6 +525,8 @@ export declare interface CodingInputProps extends Omit<ValueSetAutocompleteProps
     readonly response?: QuestionnaireResponseItem;
 }
 
+export declare function codingToValueSetElement(coding: Coding): ValueSetExpansionContains;
+
 export declare type Command<T = string> = {
     command: string;
     value?: T;
@@ -570,6 +577,23 @@ export declare function convertIsoToLocal(isoString: string | undefined): string
  */
 export declare function convertLocalToIso(localString: string | undefined): string;
 
+/**
+ * Labs section — searches for both ServiceRequest and DiagnosticReport resources.
+ * Accepts an optional `onRequestLabs` callback via closure.
+ * @param onRequestLabs - Optional callback invoked when the user requests labs.
+ * @returns A section config for labs.
+ */
+export declare function createLabsSection(onRequestLabs?: () => void): PatientSummarySectionConfig;
+
+/**
+ * Pharmacies section — no FHIR searches; the Pharmacies component resolves its own data
+ * from patient extensions.
+ * Accepts an optional `pharmacyDialogComponent` via closure.
+ * @param pharmacyDialogComponent - Optional component for the pharmacy search dialog.
+ * @returns A section config for pharmacies.
+ */
+export declare function createPharmaciesSection(pharmacyDialogComponent?: ComponentType<PharmacyDialogBaseProps>): PatientSummarySectionConfig;
+
 export { createPreferredPharmacyExtension }
 
 /**
@@ -598,6 +622,12 @@ export declare interface DateTimeInputProps extends PrimitiveTypeInputProps {
     readonly onChange?: (value: string) => void;
 }
 
+/**
+ * Default item component for resource autocomplete inputs.
+ * Displays the resource avatar, display name, and birth date or ID.
+ */
+export declare const DefaultResourceItemComponent: ForwardRefExoticComponent<AsyncAutocompleteOption<Resource> & RefAttributes<HTMLDivElement>>;
+
 export declare function DefaultResourceTimeline(props: DefaultResourceTimelineProps): JSX.Element;
 
 export declare interface DefaultResourceTimelineProps extends Pick<ResourceTimelineProps<Resource>, 'getMenu'> {
@@ -612,6 +642,9 @@ export declare interface DefaultResourceTimelineProps extends Pick<ResourceTimel
  */
 export declare function deleteFilter(definition: SearchRequest, index: number): SearchRequest;
 
+/** Demographics section — no FHIR searches, renders patient info items directly. */
+export declare const DemographicsSection: PatientSummarySectionConfig;
+
 export declare function DescriptionList(props: DescriptionListProps): JSX.Element;
 
 export declare function DescriptionListEntry(props: DescriptionListEntryProps): JSX.Element;
@@ -664,6 +697,13 @@ export declare interface EncounterTimelineProps extends Pick<ResourceTimelinePro
     readonly encounter: Encounter | Reference<Encounter>;
 }
 
+export declare interface EPrescribingIFrameOptions {
+    readonly patientId?: string;
+    readonly onPatientSyncSuccess?: () => void;
+    readonly onIframeSuccess?: (url: string) => void;
+    readonly onError?: (err: unknown) => void;
+}
+
 /**
  * ErrorBoundary is a React component that handles errors in its child components.
  * See: https://reactjs.org/docs/error-boundaries.html
@@ -729,6 +769,20 @@ export declare interface FhirPathTableProps {
     readonly onBulk?: (ids: string[]) => void;
 }
 
+/** Descriptor for a single FHIR search that a section needs. */
+export declare interface FhirSearchDescriptor {
+    /** Unique key used to access this search's results via `SectionResults[key]`. */
+    readonly key: string;
+    readonly resourceType: ResourceType;
+    /** Which search param references the patient. Defaults to 'subject'. Examples: 'patient', 'beneficiary'. */
+    readonly patientParam?: string;
+    /**
+     * Additional search params — same format as the 2nd arg to medplum.searchResources().
+     * When using a string, do not include _count or _sort; they are appended automatically.
+     */
+    readonly query?: QueryTypes;
+}
+
 export declare function Form(props: FormProps): JSX.Element;
 
 export declare interface FormProps {
@@ -759,6 +813,14 @@ export declare interface FormSectionProps {
  */
 export declare function getAppName(): string;
 
+/**
+ * Returns the default set of sections, matching the original hardcoded PatientSummary layout.
+ * The `onRequestLabs` callback is threaded through to the Labs section.
+ * @param onRequestLabs - Optional callback invoked when the user requests labs.
+ * @returns The default array of section configs.
+ */
+export declare function getDefaultSections(onRequestLabs?: () => void): PatientSummarySectionConfig[];
+
 export declare function getErrorsForInput(outcome: OperationOutcome | undefined, expression: string | undefined): string | undefined;
 
 /**
@@ -895,6 +957,9 @@ export declare interface InfoBarValueProps {
  */
 export declare function initRecaptcha(siteKey: string): void;
 
+/** Insurance section — searches for Coverage resources. */
+export declare const InsuranceSection: PatientSummarySectionConfig;
+
 export declare type IntervalGroup = {
     id: string;
     filters: Record<string, any>;
@@ -947,6 +1012,9 @@ export declare function isSupportedProfileStructureDefinition(profile?: Structur
  */
 export declare function killEvent(e: Event | SyntheticEvent): void;
 
+/** Default Labs section constant (no onRequestLabs callback). */
+export declare const LabsSection: PatientSummarySectionConfig;
+
 export declare function LinkTabs(props: LinkTabsProps): JSX.Element;
 
 export declare interface LinkTabsProps extends Omit<TabsProps, 'value' | 'onChange'> {
@@ -970,6 +1038,9 @@ export declare interface MeasureReportDisplayProps {
     readonly measureReport: MeasureReport | Reference<MeasureReport>;
 }
 
+/** Medications section — searches for MedicationRequest resources. */
+export declare const MedicationsSection: PatientSummarySectionConfig;
+
 export declare interface MedplumContext {
     medplum: MedplumClient;
     navigate: MedplumNavigateFunction;
@@ -1033,6 +1104,29 @@ export declare interface MoneyInputProps extends ComplexTypeInputProps<Money> {
     readonly placeholder?: string;
 }
 
+export declare function MultiResourceInput<T extends Resource = Resource>(props: MultiResourceInputProps<T>): JSX.Element | null;
+
+export declare interface MultiResourceInputProps<T extends Resource = Resource> {
+    readonly resourceType: T['resourceType'];
+    readonly name: string;
+    /**
+     * Initial selected values. Each entry may be a full resource or a reference that will be
+     * resolved on mount. Treated as uncontrolled — changes after mount are ignored.
+     */
+    readonly defaultValue?: (T | Reference<T>)[];
+    readonly searchCriteria?: Record<string, string>;
+    readonly placeholder?: string;
+    readonly required?: boolean;
+    readonly itemComponent?: (props: AsyncAutocompleteOption<T>) => JSX.Element | ReactNode;
+    /** Called whenever the selection changes. Receives the full array of selected resources. */
+    readonly onChange?: (value: T[]) => void;
+    readonly disabled?: boolean;
+    readonly label?: AsyncAutocompleteProps<T>['label'];
+    readonly error?: AsyncAutocompleteProps<T>['error'];
+    /** Maximum number of resources that can be selected. Defaults to uncapped. */
+    readonly maxValues?: number;
+}
+
 export declare function Navbar(props: NavbarProps): JSX.Element;
 
 export declare interface NavbarLink {
@@ -1150,6 +1244,13 @@ export declare interface ParticipantFilterProps {
 
 export { PATIENT_PREFERRED_PHARMACY_URL }
 
+export declare function PatientAccountsForm(props: PatientAccountsFormProps): JSX.Element;
+
+export declare interface PatientAccountsFormProps {
+    readonly patient: Patient;
+    readonly onSaved?: () => void;
+}
+
 export declare function PatientExportForm(props: PatientExportFormProps): JSX.Element;
 
 export declare interface PatientExportFormProps {
@@ -1164,11 +1265,34 @@ export declare interface PatientHeaderProps {
 
 export declare function PatientSummary(props: PatientSummaryProps): JSX.Element | null;
 
+export declare interface PatientSummaryData {
+    /** One SectionResults map per section, indexed to match the sections array. */
+    readonly sectionData: SectionResults[];
+    readonly loading: boolean;
+    readonly error: Error | undefined;
+}
+
 export declare interface PatientSummaryProps {
     readonly patient: Patient | Reference<Patient>;
     readonly onClickResource?: (resource: Resource) => void;
     readonly onRequestLabs?: () => void;
-    readonly pharmacyDialogComponent?: ComponentType<PharmacyDialogBaseProps>;
+    readonly sections?: PatientSummarySectionConfig[];
+}
+
+/**
+ * Configuration for a single section in the PatientSummary.
+ * The `searches` field is an array to support sections like Labs which need multiple resource types.
+ */
+export declare interface PatientSummarySectionConfig {
+    readonly key: string;
+    readonly title: string;
+    readonly searches?: FhirSearchDescriptor[];
+    /**
+     * React component that renders this section.
+     * Using ComponentType (rather than a render-prop function) ensures React treats it as a real
+     * component, so hooks inside custom sections work correctly.
+     */
+    readonly component: ComponentType<SectionRenderContext>;
 }
 
 export declare function PatientTimeline(props: PatientTimelineProps): JSX.Element;
@@ -1186,6 +1310,9 @@ export declare interface PharmaciesProps {
     readonly pharmacyDialogComponent?: ComponentType<PharmacyDialogBaseProps>;
 }
 
+/** Default Pharmacies section constant (no pharmacy dialog component). */
+export declare const PharmaciesSection: PatientSummarySectionConfig;
+
 export { PHARMACY_PREFERENCE_TYPE_SYSTEM }
 
 export { PHARMACY_TYPE_PREFERRED }
@@ -1238,6 +1365,9 @@ export declare interface PrimitiveTypeInputProps {
     readonly disabled?: boolean;
 }
 
+/** Problem List section — searches for Condition resources. */
+export declare const ProblemListSection: PatientSummarySectionConfig;
+
 export declare function QuantityDisplay(props: QuantityDisplayProps): JSX.Element | null;
 
 export declare interface QuantityDisplayProps {
@@ -1586,8 +1716,15 @@ export declare interface ResourceHistoryTableProps {
     readonly id?: string;
 }
 
+/**
+ * @param props - The props for the ResourceInput component.
+ * @returns The ResourceInput component.
+ */
 export declare function ResourceInput<T extends Resource = Resource>(props: ResourceInputProps<T>): JSX.Element | null;
 
+/**
+ * @deprecated Use MultiResourceInput instead, which supports multiple default and selected values.
+ */
 export declare interface ResourceInputProps<T extends Resource = Resource> {
     readonly resourceType: T['resourceType'];
     readonly name: string;
@@ -1786,8 +1923,20 @@ export declare class SearchLoadEvent extends Event {
 
 export declare type SearchOptions = {
     debounceMs?: number;
+    enabled?: boolean;
 };
 
+/** Context passed to every section's component. */
+export declare interface SectionRenderContext {
+    readonly patient: Patient;
+    readonly onClickResource?: (resource: Resource) => void;
+    /** Named results for each search in the section's `searches` array, keyed by `FhirSearchDescriptor.key`. */
+    readonly results: SectionResults;
+}
+
+/** Named map of FHIR results for a section: `results[searchKey]` returns the Resource[] for that search. */
+export declare type SectionResults = Record<string, Resource[]>;
+
 /**
  * Sends a structured command to the iframe using postMessage.
  *
@@ -1853,6 +2002,9 @@ export declare function setQuestionnaireItemReferenceTargetTypes(item: Questionn
  */
 export declare function setSort(definition: SearchRequest, sort: string, desc?: boolean): SearchRequest;
 
+/** Sexual Orientation section — searches for Observation resources by LOINC 76690-7. */
+export declare const SexualOrientationSection: PatientSummarySectionConfig;
+
 export declare function SignatureInput(props: SignatureInputProps): JSX.Element;
 
 export declare interface SignatureInputProps extends PaperProps {
@@ -1912,6 +2064,9 @@ export declare interface SmartSearchResponse {
     };
 }
 
+/** Smoking Status section — searches for Observation resources by LOINC 72166-2. */
+export declare const SmokingStatusSection: PatientSummarySectionConfig;
+
 /**
  * Sorts an array of resources in place by meta.lastUpdated ascending.
  * @param resources - Array of resources.
@@ -1935,6 +2090,44 @@ export declare function SubmitButton(props: ButtonProps): JSX.Element;
 
 export declare type SubmitButtonProps = Omit<ButtonProps, 'type' | 'loading'>;
 
+export declare interface SummaryResourceListOptions {
+    /** Unique key for React reconciliation. */
+    readonly key: string;
+    /** Section title displayed in the collapsible header. */
+    readonly title: string;
+    /** FHIR search configuration. */
+    readonly search: {
+        readonly resourceType: ResourceType;
+        /** Which search param references the patient. Defaults to 'subject'. */
+        readonly patientParam?: string;
+        /** Additional search params. */
+        readonly query?: Record<string, string | number | boolean | undefined>;
+    };
+    /** Override the default display string for each resource. */
+    readonly getDisplayString?: (resource: Resource) => string;
+    /** Return a status badge config, or undefined to show no badge. */
+    readonly getStatus?: (resource: Resource) => {
+        label: string;
+        color: string;
+    } | undefined;
+    /** Return secondary text (shown dimmed below the primary text). */
+    readonly getSecondaryText?: (resource: Resource) => string | undefined;
+    /** Filter resources before display. */
+    readonly filter?: (resource: Resource) => boolean;
+    /** Sort resources before display. */
+    readonly sort?: (a: Resource, b: Resource) => number;
+    /** Callback for the "+" add button. If omitted, no add button is shown. */
+    readonly onAdd?: () => void;
+}
+
+/**
+ * Creates a `PatientSummarySectionConfig` that renders a list of resources
+ * using the same visual pattern as built-in sections (CollapsibleSection + SummaryItem + StatusBadge).
+ * @param options - Configuration for the resource list section.
+ * @returns A section config that renders a generic resource list.
+ */
+export declare function summaryResourceListSection(options: SummaryResourceListOptions): PatientSummarySectionConfig;
+
 export declare type SupportedProfileStructureDefinition = StructureDefinition & {
     url: NonNullable<StructureDefinition['url']>;
     name: NonNullable<StructureDefinition['name']>;
@@ -1966,7 +2159,7 @@ export declare function ThreadInbox(props: ThreadInboxProps): JSX.Element;
  * @param threadId - The id of the thread to select.
  * @param subject - The default subject when creating a new thread.
  * @param showPatientSummary - Whether to show the patient summary.
- * @param pharmacyDialogComponent - Optional component to render as the pharmacy dialog in the patient summary.
+ * @param sections - Optional sections configuration for the patient summary.
  * @param onNew - A function to handle a new thread.
  * @param getThreadUri - A function to build thread URIs.
  * @param onChange - A function to handle search changes.
@@ -1978,7 +2171,7 @@ export declare interface ThreadInboxProps {
     readonly threadId: string | undefined;
     readonly subject?: Reference<Patient> | Patient;
     readonly showPatientSummary?: boolean;
-    readonly pharmacyDialogComponent?: ComponentType<PharmacyDialogBaseProps>;
+    readonly sections?: PatientSummarySectionConfig[];
     readonly onNew: (message: Communication) => void;
     readonly getThreadUri: (topic: Communication) => string;
     readonly onChange: (search: SearchRequest) => void;
@@ -2025,6 +2218,23 @@ export declare function typedValueToResponseItem(item: QuestionnaireItem, value:
 
 export declare const useCachedBinaryUrl: (binaryUrl: string | undefined) => string | undefined;
 
+/**
+ * Generic React hook that syncs a patient to an e-prescribing system and
+ * returns the iframe URL.
+ *
+ * Executes the patient-sync bot first (if patientId is provided), then
+ * the iframe bot to obtain the prescribing UI URL.
+ *
+ * Uses an effect cleanup flag so React 18 Strict Mode double-mount does not
+ * trigger duplicate bot executions.
+ *
+ * @param syncBotIdentifier - Bot identifier for the patient sync bot.
+ * @param iframeBotIdentifier - Bot identifier for the iframe URL bot.
+ * @param options - Configuration and callback options.
+ * @returns The e-prescribing iframe URL, or undefined while loading.
+ */
+export declare function useEPrescribingIFrame(syncBotIdentifier: Identifier, iframeBotIdentifier: Identifier, options: EPrescribingIFrameOptions): string | undefined;
+
 /**
  * Returns the MedplumClient instance.
  * This is a shortcut for useMedplumContext().medplum.
@@ -2069,6 +2279,38 @@ export declare interface UseNotificationCountOptions {
     readonly subscriptionCriteria: string;
 }
 
+/**
+ * Hook that collects all FHIR searches from section configs, deduplicates them,
+ * executes them in parallel, and routes results back to each section.
+ * Uses Promise.allSettled so a single failing search does not block all sections —
+ * sections whose searches fail gracefully receive empty arrays.
+ * @param patient - The patient or patient reference to fetch data for.
+ * @param sections - The section configs defining which searches to execute.
+ * @returns Section data, loading state, and any error.
+ */
+export declare function usePatientSummaryData(patient: Patient | Reference<Patient>, sections: {
+    readonly key: string;
+    readonly searches?: FhirSearchDescriptor[];
+}[]): PatientSummaryData;
+
+/**
+ * Generic React hook that provides pharmacy search and add-to-favorites
+ * functionality for any e-prescribing integration.
+ *
+ * Encapsulates calls to a search-pharmacy bot and an add-patient-pharmacy bot,
+ * and can be composed with the generic `PharmacyDialog` component from `@medplum/react`.
+ *
+ * @param searchBotIdentifier - Bot identifier for the pharmacy search bot.
+ * @param addPharmacyBotIdentifier - Bot identifier for the add-patient-pharmacy bot.
+ * @returns An object with `searchPharmacies` and `addToFavorites` callbacks.
+ */
+export declare function usePharmacySearch(searchBotIdentifier: Identifier, addPharmacyBotIdentifier: Identifier): UsePharmacySearchReturn;
+
+export declare interface UsePharmacySearchReturn {
+    searchPharmacies: (params: PharmacySearchParams) => Promise<Organization[]>;
+    addToFavorites: (params: AddFavoriteParams) => Promise<AddPharmacyResponse>;
+}
+
 /**
  * React Hook to keep track of the passed-in value from the previous render of the containing component.
  * @param value - The value to track.
@@ -2199,4 +2441,9 @@ export declare interface ValueSetAutocompleteProps extends Omit<AsyncAutocomplet
     readonly withHelpText?: boolean;
 }
 
+export declare function valueSetElementToCoding(element: ValueSetExpansionContains): Coding;
+
+/** Vitals section — searches for Observation resources with category vital-signs. */
+export declare const VitalsSection: PatientSummarySectionConfig;
+
 export { }