@medplum/react 5.1.7 → 5.1.8

package/dist/cjs/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';
@@ -523,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;
@@ -618,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'> {
@@ -1094,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 {
@@ -1683,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;
@@ -2401,6 +2441,8 @@ 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;
 

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';
@@ -523,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;
@@ -618,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'> {
@@ -1094,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 {
@@ -1683,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;
@@ -2401,6 +2441,8 @@ 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;