@medplum/react 5.1.27 → 5.1.29

package/dist/esm/index.d.ts

@@ -63,6 +63,7 @@ import type { MedicationRequest } from '@medplum/fhirtypes';
 import type { MedicationSearchParams } from '@medplum/core';
 import type { MedplumClient } from '@medplum/core';
 import { MemoExoticComponent } from 'react';
+import type { ModalProps as ModalProps_2 } from '@mantine/core';
 import type { Money } from '@medplum/fhirtypes';
 import type { MouseEvent as MouseEvent_2 } from 'react';
 import type { MouseEventHandler } from 'react';
@@ -114,6 +115,7 @@ import type { SearchRequest } from '@medplum/core';
 import type { ServiceRequest } from '@medplum/fhirtypes';
 import type { Signature } from '@medplum/fhirtypes';
 import type { Slot } from '@medplum/fhirtypes';
+import type { SpotlightActionData } from '@mantine/spotlight';
 import type { StructureDefinition } from '@medplum/fhirtypes';
 import type { Subscription } from '@medplum/fhirtypes';
 import type { SyntheticEvent } from 'react';
@@ -251,6 +253,7 @@ export declare interface AIRealTimeQuestionnaireFormProps extends QuestionnaireF
     readonly aiModel?: string;
     readonly onTranscript?: (fullTranscript: string, chunk: string) => void;
     readonly voiceInstructions?: ReactNode;
+    readonly silenceDebounceMs?: number;
 }
 
 /** Allergies section — searches for AllergyIntolerance resources. */
@@ -261,6 +264,23 @@ export declare function AnnotationInput(props: AnnotationInputProps): JSX.Elemen
 export declare interface AnnotationInputProps extends ComplexTypeInputProps<Annotation> {
 }
 
+/**
+ * Applies the `questionnaire-optionExclusive` rule to an answer change.
+ *
+ * Given the previous and newly requested answers for an item, enforces that selecting an answer
+ * option marked exclusive clears every other answer, and selecting any other option clears a
+ * previously selected exclusive answer. Returns the new answers unchanged if the item has no
+ * exclusive options or the change only removed answers.
+ *
+ * See: https://hl7.org/fhir/extensions/StructureDefinition-questionnaire-optionExclusive.html
+ *
+ * @param item - The questionnaire item being answered.
+ * @param previousAnswers - The item's answers before the change.
+ * @param newAnswers - The answers requested by the change.
+ * @returns The reconciled answers.
+ */
+export declare function applyOptionExclusive(item: QuestionnaireItem, previousAnswers: QuestionnaireResponseItemAnswer[] | undefined, newAnswers: QuestionnaireResponseItemAnswer[]): QuestionnaireResponseItemAnswer[];
+
 export declare function AppShell(props: AppShellProps): JSX.Element;
 
 export declare interface AppShellAnnouncement {
@@ -288,6 +308,7 @@ export declare interface AppShellProps {
     readonly layoutVersion?: 'v1' | 'v2';
     readonly showLayoutVersionToggle?: boolean;
     readonly spotlightPatientsOnly?: boolean;
+    readonly spotlightActions?: SpotlightLinkAction[];
 }
 
 export declare function AsyncAutocomplete<T>(props: AsyncAutocompleteProps<T>): JSX.Element;
@@ -1119,8 +1140,8 @@ export declare interface LinkTabsProps extends Omit<TabsProps, 'value' | 'onChan
 /**
  * ListWithDetailPane is a generic, presentational master-detail shell: a left sidebar
  * with optional pill tabs, header actions, a scrollable list, and pagination, plus a
- * detail area for the selected item. It does no data fetching or routing — it renders
- * what it is given and emits `onTabChange` / `onPageChange` callbacks.
+ * detail area for the selected item. It does no data fetching — it renders what it is
+ * given, navigates via links, and emits `onPageChange` / `onSelectFirst` callbacks.
  * @param props - The ListWithDetailPane React props.
  * @returns The ListWithDetailPane React node.
  */
@@ -1147,37 +1168,47 @@ export declare type ListWithDetailPaneProps<T extends {
     id?: string;
 } = Resource> = ListWithDetailPanePropsBase<T> & ListWithDetailPaneHeaderProps;
 
-/** Props shared by every ListWithDetailPane, independent of the header style. */
+/**
+ * Props shared by every ListWithDetailPane, independent of the header style.
+ * @param items - The current page of items to render in the list.
+ * @param loading - When true, the list area shows the skeleton instead of items.
+ * @param selectedKey - Id of the highlighted row.
+ * @param renderItem - Renders one row of the list sidebar.
+ * @param emptyList - Shown when the list is empty. Default: dimmed "No items found".
+ * @param skeleton - Shown while loading. Default: built-in skeleton rows.
+ * @param listWidth - Sidebar width in pixels. Default 350.
+ * @param headerActions - Right-aligned slot in the sidebar header row: action buttons, filter popovers.
+ * @param selected - The resolved selected item, or undefined when nothing is selected.
+ * @param renderDetail - Renders the detail pane for the selected item.
+ * @param emptyDetail - Shown when nothing is selected. Default: dimmed prompt.
+ * @param refresh - Passed through to the detail render context.
+ * @param onSelectFirst - Auto-select escape hatch. Fired with the first item when the list has finished loading
+ * (`loading` false) with items while nothing is selected (`selectedKey` undefined). The consumer decides how to
+ * navigate (typically with history replace). Pass an id-driven `selectedKey` (e.g. the URL route param) so a
+ * selection that is still resolving does not read as "nothing selected", and keep `loading` true from the render a
+ * new search starts on, so this never fires against a stale list.
+ * @param page - Current 1-based page. Pagination is hidden unless this, `pageCount`, and `onPageChange` are set.
+ * @param pageCount - Total number of pages. Pagination is hidden when this is less than or equal to 1.
+ * @param onPageChange - Fired by the built-in pagination with the new 1-based page.
+ */
 export declare interface ListWithDetailPanePropsBase<T extends {
     id?: string;
 } = Resource> {
-    /** The current page of items to render in the list. */
     readonly items: T[];
-    /** When true, the list area shows the skeleton instead of items. */
     readonly loading: boolean;
-    /** Id of the highlighted row. */
     readonly selectedKey?: string;
     readonly renderItem: (item: T, ctx: ListWithDetailPaneItemContext<T>) => ReactNode;
-    /** Shown when the list is empty. Default: dimmed "No items found". */
     readonly emptyList?: ReactNode;
-    /** Shown while loading. Default: built-in skeleton rows. */
     readonly skeleton?: ReactNode;
-    /** Sidebar width in pixels. Default 350. */
     readonly listWidth?: number;
-    /** Right-aligned slot in the sidebar header row: action buttons, filter popovers. */
     readonly headerActions?: ReactNode;
-    /** The resolved selected item, or undefined when nothing is selected. */
     readonly selected: T | undefined;
     readonly renderDetail: (selected: T, ctx: ListWithDetailPaneDetailContext) => ReactNode;
-    /** Shown when nothing is selected. Default: dimmed prompt. */
     readonly emptyDetail?: ReactNode;
-    /** Passed through to the detail render context. */
     readonly refresh: () => Promise<void>;
-    /** Current 1-based page. Pagination is hidden unless this, `pageCount`, and `onPageChange` are set. */
+    readonly onSelectFirst?: (item: T) => void;
     readonly page?: number;
-    /** Total number of pages. Pagination is hidden when this is less than or equal to 1. */
     readonly pageCount?: number;
-    /** Fired by the built-in pagination with the new 1-based page. */
     readonly onPageChange?: (page: number) => void;
 }
 
@@ -1189,24 +1220,25 @@ export declare interface ListWithDetailPaneTab {
 
 /**
  * Pill-tab header. Declares `headerText` as `never` so tabs can't be mixed with a title.
+ * Each tab renders as a link to its `uri`, so tab switching needs no change callback.
+ * @param tabs - Sidebar header tabs. Selecting a tab navigates to its URI.
+ * @param activeTab - Controlled active tab value; consumers derive it from the URL.
  */
 export declare interface ListWithDetailPaneTabsHeaderProps {
     readonly tabs: ListWithDetailPaneTab[];
     readonly activeTab?: string;
-    readonly onTabChange?: (value: string) => void;
     readonly headerText?: never;
 }
 
 /**
  * Plain-text header (or no header at all). Declares the tab fields as `never` so a title
  * can't be mixed with tabs.
+ * @param headerText - Plain title shown at the left of the header.
  */
 export declare interface ListWithDetailPaneTextHeaderProps {
-    /** Plain title shown at the left of the header. */
     readonly headerText?: ReactNode;
     readonly tabs?: never;
     readonly activeTab?: never;
-    readonly onTabChange?: never;
 }
 
 export declare function Loading(): JSX.Element;
@@ -1352,6 +1384,39 @@ export declare interface MfaVerificationFormProps {
     readonly buttonText?: string;
 }
 
+/**
+ * A modal with the standard Medplum chrome: a bold title above a border, one scrolling body, and
+ * action buttons pinned to the bottom edge. Owns the layout so call sites pass content and actions
+ * rather than assembling a shell out of `Stack`, `Divider` and `styles` overrides.
+ *
+ * All other Mantine `Modal` props pass through. `scrollAreaComponent` does not, because it inserts
+ * an element between the content and the body that breaks the flex chain the pinned footer needs.
+ * @param props - The Modal React props.
+ * @returns The Modal React node.
+ */
+export declare function Modal(props: ModalProps): JSX.Element;
+
+/**
+ * Props for {@link Modal}.
+ * @property children - Modal body, rendered in the scrolling region between the header and the
+ * footer.
+ * @property actions - Buttons pinned to the bottom edge of the modal above a full-bleed border.
+ * They stretch to the full width with the primary action first; wrap them in a
+ * `Group justify="flex-end"` for a right-aligned row instead. Omit for modals that only display
+ * content - the footer and its border are then not rendered.
+ * @property onSubmit - Wraps the body and the footer in a {@link Form}, so a `SubmitButton` in
+ * `actions` submits the named inputs in `children`. A `SubmitButton` without this has no form to
+ * submit and does nothing.
+ * @property bodyHeight - Fixed body height as a CSS length, e.g. `'60vh'`, for modals whose content
+ * is a fixed layout rather than a form that should size to its fields. Omit to size to the content.
+ */
+export declare interface ModalProps extends Omit<ModalProps_2, 'children' | 'onSubmit' | 'scrollAreaComponent'> {
+    readonly children: ReactNode;
+    readonly actions?: ReactNode;
+    readonly onSubmit?: (formData: Record<string, string>) => Promise<void> | void;
+    readonly bodyHeight?: string;
+}
+
 export declare function MoneyDisplay(props: MoneyDisplayProps): JSX.Element | null;
 
 export declare interface MoneyDisplayProps {
@@ -1422,6 +1487,7 @@ export declare interface NavbarProps {
     readonly closeNavbar: () => void;
     readonly spotlightEnabled?: boolean;
     readonly patientsOnly?: boolean;
+    readonly spotlightActions?: SpotlightLinkAction[];
     readonly userMenuEnabled?: boolean;
     readonly displayAddBookmark?: boolean;
     readonly resourceTypeSearchDisabled?: boolean;
@@ -1695,6 +1761,8 @@ export declare const QUESTIONNAIRE_HIDDEN_URL = "http://hl7.org/fhir/StructureDe
 
 export declare const QUESTIONNAIRE_ITEM_CONTROL_URL = "http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl";
 
+export declare const QUESTIONNAIRE_OPTION_EXCLUSIVE_URL = "http://hl7.org/fhir/StructureDefinition/questionnaire-optionExclusive";
+
 export declare const QUESTIONNAIRE_REFERENCE_FILTER_URL = "http://hl7.org/fhir/StructureDefinition/questionnaire-referenceFilter";
 
 export declare const QUESTIONNAIRE_REFERENCE_RESOURCE_URL = "http://hl7.org/fhir/StructureDefinition/questionnaire-referenceResource";
@@ -2024,61 +2092,54 @@ export declare interface ResourceBoardLoadResult<T extends Resource = Resource>
     readonly total?: number;
 }
 
+/**
+ * Props for the ResourceBoard component.
+ * @param search - The search definition (resourceType + filters + count/offset), like SearchControl. Default
+ * fetching searches with `_total=accurate` and `cache: 'no-cache'`. Deep-equality memoized internally, so parents
+ * may pass object literals.
+ * @param selectedId - Selected resource id, typically driven by the URL route param.
+ * @param loadItems - Custom fetcher replacing the default search (e.g. GraphQL batching, client-side filtering).
+ * Re-runs whenever its identity or the search changes — wrap in useCallback.
+ * @param resolveSelected - Selected-resource resolution. Default: find in items by id, else
+ * `medplum.readResource(search.resourceType, id)`.
+ * @param reloadKey - Manual refresh trigger: change this value (e.g. a counter) to re-run the load without changing
+ * the search. Reloads in place — no skeleton.
+ * @param headerText - Plain title shown at the left of the header when no `tabs` are provided.
+ * @param tabs - Sidebar header tabs. Selecting a tab navigates to its URI.
+ * @param activeTab - Controlled active tab value; consumers derive it from the URL.
+ * @param headerActions - Right-aligned slot in the sidebar header row: action buttons, filter popovers.
+ * @param renderItem - Renders one row of the list sidebar.
+ * @param emptyList - Shown when the list loads empty. Default: dimmed "No items found".
+ * @param skeleton - Shown while the initial or search-change load is in flight. Default: built-in skeleton rows.
+ * @param listWidth - Sidebar width in pixels. Default 350.
+ * @param renderDetail - Renders the detail pane for the resolved selection.
+ * @param emptyDetail - Shown when nothing is selected or the selection cannot be resolved.
+ * @param onChange - Fired by the built-in pagination with the updated offset.
+ * @param onSelectFirst - Auto-select escape hatch. Fired with the first item when a load for the current search
+ * settles with items while nothing is selected (owned by ListWithDetailPane). The consumer decides how to navigate
+ * (e.g. with history replace).
+ * @param onLoad - Fired after every successful load.
+ * @param onError - List-load and selection-resolution errors. Default: console.error.
+ */
 export declare interface ResourceBoardProps<T extends Resource = Resource> {
-    /**
-     * The search definition (resourceType + filters + count/offset), like SearchControl.
-     * Default fetching searches with `_total=accurate` and `cache: 'no-cache'`.
-     * Deep-equality memoized internally, so parents may pass object literals.
-     */
     readonly search: SearchRequest;
-    /** Selected resource id, typically driven by the URL route param. */
     readonly selectedId?: string;
-    /**
-     * Custom fetcher replacing the default search (e.g. GraphQL batching, client-side
-     * filtering). Re-runs whenever its identity or the search changes — wrap in useCallback.
-     */
     readonly loadItems?: (search: SearchRequest, medplum: MedplumClient) => Promise<ResourceBoardLoadResult<T>>;
-    /**
-     * Selected-resource resolution. Default: find in items by id, else
-     * `medplum.readResource(search.resourceType, id)`.
-     */
     readonly resolveSelected?: (id: string, items: WithId<T>[], medplum: MedplumClient) => Promise<WithId<T> | undefined>;
-    /**
-     * Manual refresh trigger: change this value (e.g. a counter) to re-run the load
-     * without changing the search. Reloads in place — no skeleton.
-     */
     readonly reloadKey?: unknown;
-    /** Plain title shown at the left of the header when no `tabs` are provided. */
     readonly headerText?: ReactNode;
-    /** Sidebar header tabs. Selecting a tab navigates to its URI. */
     readonly tabs?: ResourceBoardTab[];
-    /** Controlled active tab value; consumers derive it from the URL. */
     readonly activeTab?: string;
-    /** Right-aligned slot in the sidebar header row: action buttons, filter popovers. */
     readonly headerActions?: ReactNode;
     readonly renderItem: (item: WithId<T>, ctx: ResourceBoardItemContext<T>) => ReactNode;
-    /** Shown when the list loads empty. Default: dimmed "No items found". */
     readonly emptyList?: ReactNode;
-    /** Shown while the initial or search-change load is in flight. Default: built-in skeleton rows. */
     readonly skeleton?: ReactNode;
-    /** Sidebar width in pixels. Default 350. */
     readonly listWidth?: number;
     readonly renderDetail: (selected: WithId<T>, ctx: ResourceBoardDetailContext) => ReactNode;
-    /** Shown when nothing is selected or the selection cannot be resolved. */
     readonly emptyDetail?: ReactNode;
-    /**
-     * Fired by the built-in pagination with the updated offset.
-     */
     readonly onChange?: (search: SearchRequest) => void;
-    /**
-     * Auto-select escape hatch. Called with the first item when a load for the
-     * current search completes with items while `selectedId` is undefined.
-     * The consumer decides how to navigate (e.g. with history replace).
-     */
     readonly onSelectFirst?: (item: WithId<T>) => void;
-    /** Fired after every successful load. */
     readonly onLoad?: (items: WithId<T>[], total: number | undefined) => void;
-    /** List-load and selection-resolution errors. Default: console.error. */
     readonly onError?: (error: unknown) => void;
 }
 
@@ -2505,10 +2566,21 @@ export declare const SmokingStatusSection: PatientSummarySectionConfig;
  */
 export declare function sortByDateAndPriority(resources: Resource[], timelineResource?: Resource): void;
 
-export declare function Spotlight({ patientsOnly }: SpotlightProps): JSX.Element;
+export declare function Spotlight({ patientsOnly, staticActions }: SpotlightProps): JSX.Element;
+
+/**
+ * A Spotlight entry. Setting `href` renders it as an anchor rather than a button, so the browser's
+ * "Open link in new tab" context menu and Cmd/Ctrl+click both work. A plain click is handed to the
+ * SPA router instead of triggering a full page load; pass `onClick` to do something other than
+ * navigate to `href`.
+ */
+export declare interface SpotlightLinkAction extends SpotlightActionData {
+    readonly href?: string;
+}
 
 export declare interface SpotlightProps {
     readonly patientsOnly?: boolean;
+    readonly staticActions?: SpotlightLinkAction[];
 }
 
 export declare function StatusBadge(props: StatusBadgeProps): JSX.Element;
@@ -2592,10 +2664,14 @@ export declare function ThreadInbox(props: ThreadInboxProps): JSX.Element;
  * @param showPatientSummary - Whether to show the patient summary.
  * @param sections - Optional sections configuration for the patient summary.
  * @param onNew - A function to handle a new thread.
+ * @param onSelectFirst - Fired with the first thread when the list loads with nothing selected; use it to navigate to that thread (with replace) so the inbox auto-selects it.
  * @param getThreadUri - A function to build thread URIs.
  * @param onChange - A function to handle search changes.
  * @param inProgressUri - The URI for in-progress threads.
  * @param completedUri - The URI for completed threads.
+ * @param newTopicOpened - Controlled open state for the new topic dialog. When provided, use `onNewTopicOpen` and `onNewTopicClose` to update it.
+ * @param onNewTopicOpen - Called when the user clicks the new message button. Required when `newTopicOpened` is provided.
+ * @param onNewTopicClose - Called when the new topic dialog is closed. Required when `newTopicOpened` is provided.
  */
 export declare interface ThreadInboxProps {
     readonly query: string;
@@ -2604,6 +2680,7 @@ export declare interface ThreadInboxProps {
     readonly showPatientSummary?: boolean;
     readonly sections?: PatientSummarySectionConfig[];
     readonly onNew: (message: Communication) => void;
+    readonly onSelectFirst?: (thread: Communication) => void;
     readonly getThreadUri: (topic: Communication) => string;
     readonly onChange: (search: SearchRequest) => void;
     readonly inProgressUri: string;
@@ -2611,6 +2688,9 @@ export declare interface ThreadInboxProps {
     readonly uploadEnabled?: boolean;
     readonly onViewInDocuments?: (reference: Reference<DocumentReference>) => void;
     readonly allowPatientSelection?: boolean;
+    readonly newTopicOpened?: boolean;
+    readonly onNewTopicOpen?: () => void;
+    readonly onNewTopicClose?: () => void;
 }
 
 export declare function Timeline(props: TimelineProps): JSX.Element;
@@ -2938,7 +3018,6 @@ export declare interface UseResourceBoardProps<T extends Resource = Resource> {
      * without changing the search. Reloads in place — no skeleton — like `refresh()`.
      */
     readonly reloadKey?: unknown;
-    readonly onSelectFirst?: (item: WithId<T>) => void;
     readonly onLoad?: (items: WithId<T>[], total: number | undefined) => void;
     readonly onError?: (error: unknown) => void;
 }