@medplum/react 5.1.26 → 5.1.28

package/dist/cjs/index.d.ts

@@ -52,8 +52,14 @@ import type { MantineColor } from '@mantine/core';
 import type { MeasureReport } from '@medplum/fhirtypes';
 import type { Media } from '@medplum/fhirtypes';
 import type { Medication } from '@medplum/fhirtypes';
+import type { MedicationCartClearRequest } from '@medplum/core';
+import type { MedicationCartManageResponse } from '@medplum/core';
+import type { MedicationCartRemoveRequest } from '@medplum/core';
+import type { MedicationCheckoutRequest } from '@medplum/core';
+import type { MedicationCheckoutResponse } from '@medplum/core';
 import type { MedicationOrderRequest } from '@medplum/core';
 import type { MedicationOrderResponse } from '@medplum/core';
+import type { MedicationRequest } from '@medplum/fhirtypes';
 import type { MedicationSearchParams } from '@medplum/core';
 import type { MedplumClient } from '@medplum/core';
 import { MemoExoticComponent } from 'react';
@@ -66,8 +72,10 @@ import type { ObservationDefinitionQualifiedInterval } from '@medplum/fhirtypes'
 import type { OperationOutcome } from '@medplum/fhirtypes';
 import type { OperationOutcomeIssue } from '@medplum/fhirtypes';
 import { Operator } from '@medplum/core';
+import type { OrderSetSyncResponse } from '@medplum/core';
 import type { Organization } from '@medplum/fhirtypes';
 import type { PaperProps } from '@mantine/core';
+import type { PasswordInputProps } from '@mantine/core';
 import type { Patient } from '@medplum/fhirtypes';
 import { PATIENT_PREFERRED_PHARMACY_URL } from '@medplum/core';
 import type { Period } from '@medplum/fhirtypes';
@@ -98,6 +106,7 @@ import { removePreferredPharmacyFromPatient } from '@medplum/core';
 import type { RequestGroup } from '@medplum/fhirtypes';
 import type { Resource } from '@medplum/fhirtypes';
 import type { ResourceArray } from '@medplum/core';
+import type { ResourceModifiedEvent } from '@medplum/core';
 import type { ResourceType } from '@medplum/fhirtypes';
 import type { Schedule } from '@medplum/fhirtypes';
 import type { SearchParameter } from '@medplum/fhirtypes';
@@ -242,6 +251,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. */
@@ -252,6 +262,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 {
@@ -469,6 +496,16 @@ export declare function buildInitialResponse(questionnaire: Questionnaire, quest
 
 export declare function buildInitialResponseItem(item: QuestionnaireItem): QuestionnaireResponseItem;
 
+/**
+ * Returns a display label for a search parameter code.
+ *
+ * Meta fields keep their underscore-prefixed code so they don't collide with same-named
+ * elements (e.g. `ProjectMembership.project` vs `_project`).
+ * @param code - The search parameter code.
+ * @returns The display label for the search parameter.
+ */
+export declare function buildSearchParamFieldLabel(code: string): string;
+
 export declare function CalendarDateInput(props: CalendarDateInputProps): JSX.Element;
 
 export declare interface CalendarDateInputProps {
@@ -1048,6 +1085,13 @@ export declare function isCheckboxCell(el: Element): boolean;
  */
 export declare function isChoiceQuestion(item: QuestionnaireItem): boolean;
 
+/**
+ * Returns true if the given search parameter code refers to a resource metadata field.
+ * @param code - The search parameter code.
+ * @returns True if the code is a meta search parameter.
+ */
+export declare function isMetaSearchParam(code: string): boolean;
+
 export { isOrganizationArray }
 
 /**
@@ -1062,6 +1106,15 @@ export declare function isSortDescending(definition: SearchRequest): boolean;
 
 export declare function isSupportedProfileStructureDefinition(profile?: StructureDefinition): profile is SupportedProfileStructureDefinition;
 
+/**
+ * Returns true if an error thrown while expanding a ValueSet means the value set itself is
+ * unavailable — a permanent 400/404 (e.g. "ValueSet not found"). Transient failures (429 rate
+ * limit, 401, 5xx, network) return false so a blip never disables a field.
+ * @param err - The error thrown by `valueSetExpand`.
+ * @returns True for a permanent 400/404, false for a transient failure.
+ */
+export declare function isValueSetUnavailableError(err: unknown): boolean;
+
 /**
  * Kills a browser event.
  * Prevents default behavior.
@@ -1084,14 +1137,14 @@ 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.
  */
 export declare function ListWithDetailPane<T extends {
-    id: string;
-} = WithId<Resource>>(props: ListWithDetailPaneProps<T>): JSX.Element;
+    id?: string;
+} = Resource>(props: ListWithDetailPaneProps<T>): JSX.Element;
 
 export declare interface ListWithDetailPaneDetailContext {
     readonly refresh: () => Promise<void>;
@@ -1101,48 +1154,58 @@ export declare interface ListWithDetailPaneDetailContext {
 export declare type ListWithDetailPaneHeaderProps = ListWithDetailPaneTextHeaderProps | ListWithDetailPaneTabsHeaderProps;
 
 export declare interface ListWithDetailPaneItemContext<T extends {
-    id: string;
-} = WithId<Resource>> {
+    id?: string;
+} = Resource> {
     readonly selected: boolean;
     readonly index: number;
     readonly items: T[];
 }
 
 export declare type ListWithDetailPaneProps<T extends {
-    id: string;
-} = WithId<Resource>> = ListWithDetailPanePropsBase<T> & ListWithDetailPaneHeaderProps;
-
-/** Props shared by every ListWithDetailPane, independent of the header style. */
+    id?: string;
+} = Resource> = ListWithDetailPanePropsBase<T> & ListWithDetailPaneHeaderProps;
+
+/**
+ * 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;
-} = WithId<Resource>> {
-    /** The current page of items to render in the list. */
+    id?: string;
+} = Resource> {
     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;
 }
 
@@ -1154,24 +1217,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;
@@ -1189,8 +1253,13 @@ export declare interface MeasureReportDisplayProps {
     readonly measureReport: MeasureReport | Reference<MeasureReport>;
 }
 
+/** Thrown by {@link UseMedicationCartReturn.checkout} when an {@link UseMedicationCartReturn.addToCart} call is still in flight. */
+export declare const MEDICATION_CART_ADD_IN_PROGRESS = "Cannot checkout while a medication is still being added to the cart";
+
 export declare interface MedicationIFrameOptions {
     readonly patientId?: string;
+    /** Selected practice location for multi-practice deployments. */
+    readonly organization?: Reference<Organization>;
     readonly onPatientSyncSuccess?: () => void;
     readonly onIframeSuccess?: (url: string) => void;
     readonly onError?: (err: unknown) => void;
@@ -1439,6 +1508,7 @@ export declare function OperationOutcomeAlert(props: OperationOutcomeAlertProps)
 export declare interface OperationOutcomeAlertProps extends AlertProps {
     readonly outcome?: OperationOutcome;
     readonly issues?: OperationOutcomeIssue[];
+    readonly displayOkOutcomes?: boolean;
 }
 
 export declare function Panel(props: PanelProps): JSX.Element;
@@ -1463,6 +1533,15 @@ export declare interface ParticipantFilterProps {
     readonly onFilterChange: (participants: Reference<Patient | Practitioner>[]) => void;
 }
 
+/**
+ * Mantine's `PasswordInput` sets `tabIndex={-1}` and `aria-hidden` on the visibility toggle button
+ * unless `visibilityToggleButtonProps` is provided, which removes it from the keyboard tab order and
+ * hides it from assistive technology. This wrapper defaults the toggle to be keyboard accessible.
+ * @param props - The password input props.
+ * @returns The password input component.
+ */
+export declare function PasswordInput(props: PasswordInputProps): JSX.Element;
+
 export { PATIENT_PREFERRED_PHARMACY_URL }
 
 export declare function PatientAccountsForm(props: PatientAccountsFormProps): JSX.Element;
@@ -1645,6 +1724,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";
@@ -1862,6 +1943,7 @@ export declare interface RegisterFormProps {
     readonly recaptchaSiteKey?: string;
     readonly children?: ReactNode;
     readonly onSuccess: () => void;
+    readonly onSignIn?: () => void;
 }
 
 /**
@@ -1973,61 +2055,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;
 }
 
@@ -2209,6 +2284,22 @@ export declare class SearchClickEvent extends Event {
  */
 export declare function SearchControl(props: SearchControlProps): JSX.Element;
 
+/**
+ * An additional, computed column appended after the search-result columns.
+ *
+ * Unlike the columns derived from {@link SearchControlProps.search} fields, an
+ * additional column is not backed by a search parameter and has no sort/filter
+ * menu: it renders arbitrary content per row. Use it for values that must be
+ * computed or fetched separately from the searched resource (e.g. a related
+ * resource's status).
+ */
+export declare interface SearchControlAdditionalColumn {
+    /** The column header text. */
+    readonly name: string;
+    /** Renders the cell contents for the given row resource. */
+    readonly renderCell: (resource: Resource) => ReactNode;
+}
+
 /**
  * The SearchControlField type describes a field in the search control.
  *
@@ -2245,6 +2336,8 @@ export declare interface SearchControlField {
 export declare interface SearchControlProps {
     readonly search: SearchRequest;
     readonly checkboxesEnabled?: boolean;
+    /** Additional computed columns rendered after the search-result columns. */
+    readonly additionalColumns?: readonly SearchControlAdditionalColumn[];
     readonly hideToolbar?: boolean;
     readonly hideFilters?: boolean;
     readonly onLoad?: (e: SearchLoadEvent) => void;
@@ -2523,10 +2616,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;
@@ -2535,6 +2632,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;
@@ -2542,6 +2640,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;
@@ -2583,8 +2684,63 @@ export declare type TranscriptItem = {
 
 export declare function typedValueToResponseItem(item: QuestionnaireItem, value: TypedValue): QuestionnaireResponseItemAnswer | undefined;
 
+export declare function UnavailableNote({ text, color, message }: UnavailableNoteProps): JSX.Element;
+
+export declare interface UnavailableNoteProps {
+    readonly text: string;
+    readonly color: string;
+    readonly message: string;
+}
+
 export declare const useCachedBinaryUrl: (binaryUrl: string | undefined) => string | undefined;
 
+/**
+ * Vendor-neutral hook for the full **medication cart** lifecycle: add a draft
+ * line (`createResource`), check out a set of drafts into the vendor's batch
+ * approval queue (`$checkout-medications`), and remove/clear cart lines
+ * (`$remove-cart-medication` / `$clear-cart`).
+ *
+ * Cart checkout / remove / clear hit project-scoped **FHIR custom operations**
+ * whose backing Bot is chosen at deploy time via an `OperationDefinition`
+ * carrying the `operationDefinition-implementation` extension — see
+ * [bot operations docs](https://www.medplum.com/docs/bots/custom-fhir-operations).
+ * The server's `tryCustomOperation` dispatch handles the OD → Bot lookup, so
+ * projects swap vendors by deploying a different bot under the same code.
+ *
+ * `addToCart` is plain FHIR `createResource` (no `$add-cart` operation): the
+ * Medplum-side cart is the set of draft `MedicationRequest`s. Vendor staging
+ * (e.g. ScriptSure MedCart) happens at checkout. Vendors without a batch
+ * approval queue (e.g. DoseSpot iframe-first) simply never call `checkout` /
+ * `removeFromCart` / `clearCart`.
+ *
+ * Requests for the custom operations are encoded as `Parameters` bodies and
+ * decoded by the matching `@medplum/core` helpers. Per-line outcomes arrive in
+ * `response.items`.
+ *
+ * @returns Cart add / checkout / remove / clear callbacks plus `adding` state.
+ */
+export declare function useMedicationCart(): UseMedicationCartReturn;
+
+export declare interface UseMedicationCartReturn {
+    /**
+     * Persist a draft `MedicationRequest` as a cart line via plain FHIR
+     * `createResource` (no custom operation). Vendor staging happens later at
+     * {@link UseMedicationCartReturn.checkout}.
+     */
+    addToCart: (medicationRequest: MedicationRequest) => Promise<MedicationRequest>;
+    /** True while one or more {@link UseMedicationCartReturn.addToCart} calls are in flight. */
+    adding: boolean;
+    /**
+     * Submit draft cart lines to the vendor's batch approval queue and return an
+     * embeddable approval-widget URL. Refuses while {@link UseMedicationCartReturn.adding} is true.
+     */
+    checkout: (input: MedicationCheckoutRequest) => Promise<MedicationCheckoutResponse>;
+    /** Remove a single draft `MedicationRequest` from the patient's vendor cart. */
+    removeFromCart: (input: MedicationCartRemoveRequest) => Promise<MedicationCartManageResponse>;
+    /** Remove every item from the patient's vendor cart. */
+    clearCart: (input: MedicationCartClearRequest) => Promise<MedicationCartManageResponse>;
+}
+
 /**
  * Generic React hook that syncs a patient to a medication-order vendor and
  * returns the chart iframe URL.
@@ -2668,6 +2824,8 @@ export declare interface UseMedicationOrderSetOptions {
     /** Vendor-side order set id, when picked directly (escape hatch when no synced PD exists yet). */
     readonly vendorOrderSetId?: number | string;
     readonly appId?: string;
+    /** Selected practice location for multi-practice deployments. */
+    readonly organization?: Reference<Organization>;
 }
 
 export declare interface UseMedicationOrderSetReturn {
@@ -2812,7 +2970,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;
 }
@@ -2831,6 +2988,30 @@ export declare interface UseResourceBoardResult<T extends Resource = Resource> {
     readonly refresh: () => Promise<void>;
 }
 
+/**
+ * React hook for observing FHIR resource modifications made through the Medplum client.
+ *
+ * The callback is invoked whenever this client instance creates, updates, patches, or deletes
+ * a resource of one of the given types, including modifications announced with
+ * `MedplumClient.notifyResourceModified`. Use it to keep local component state in sync with
+ * mutations made elsewhere in the application. Subscribing to a single resource type narrows
+ * the event so `event.resource` is typed to that resource, no type guard required:
+ *
+ * ```tsx
+ * useResourceModified('Slot', (event) => {
+ *   // event.resource is `WithId<Slot> | undefined`
+ * });
+ * useResourceModified(['Slot', 'Appointment'], () => refreshSchedule());
+ * ```
+ *
+ * Modifications made by other clients (or other users) are not observed;
+ * use `useSubscription` for server-side change notifications.
+ *
+ * @param resourceType - The resource type or types to observe.
+ * @param callback - Invoked with the event payload for each matching modification.
+ */
+export declare function useResourceModified<K extends ResourceType>(resourceType: K | K[], callback: (event: ResourceModifiedEvent<ExtractResource<K>>) => void): void;
+
 /**
  * React hook for searching FHIR resources.
  *
@@ -2904,13 +3085,18 @@ export declare type UseSubscriptionOptions = {
  * to the configured e-prescribing vendor via the `$sync-orderset` custom FHIR operation
  * (`POST /fhir/R4/PlanDefinition/$sync-orderset`).
  *
- * Silently no-ops when the operation is not deployed (i.e. no e-prescribing vendor
- * is configured for the project), so callers do not need to guard against missing
- * integrations.
+ * Resolves with the decoded `OrderSetSyncResponse` so callers can surface
+ * per-action failures (`results[i].status === 'failed'` / `failedCount > 0`) —
+ * without this, an order set that only partially synced would silently apply
+ * with fewer meds than the PlanDefinition requested.
+ *
+ * Resolves with `undefined` when the operation is not deployed (i.e. no
+ * e-prescribing vendor is configured for the project), so callers do not need to
+ * guard against missing integrations.
  *
- * @returns A stable `syncOrderSet(planDefinitionId)` callback.
+ * @returns A stable `syncOrderSet(planDefinitionId, organization?)` callback.
  */
-export declare function useSyncOrderSet(): (planDefinitionId: string) => Promise<void>;
+export declare function useSyncOrderSet(): (planDefinitionId: string, organization?: Reference<Organization>) => Promise<OrderSetSyncResponse | undefined>;
 
 export declare function useThreadInbox({ query, threadId }: UseThreadInboxOptions): UseThreadInboxReturn;
 
@@ -2930,6 +3116,30 @@ export declare interface UseThreadInboxReturn {
     refreshThreadMessages: () => Promise<void>;
 }
 
+/**
+ * Probes a set of ValueSet URLs for availability, each with a filter-free, count-limited expansion.
+ *
+ * A filter-free probe means a 400/404 unambiguously describes the value set itself (unlike a
+ * user-typed search, whose 400 can be filter-specific), so the verdict is safe to act on. Repeated
+ * probes of the same URL are deduplicated by the `MedplumClient` request cache, which caches
+ * rejections too, so many fields bound to the same missing value set cost one request. Recovery
+ * after a value set is imported happens on the next mount (i.e. a page refresh) — there is no live
+ * subscription. Transient failures (429/5xx/network) resolve as available so a blip never disables
+ * a field; only a permanent 400/404 marks a URL unavailable.
+ * @param urls - The ValueSet URLs to probe. Falsy entries are ignored, and duplicates collapse to a
+ * single probe.
+ * @returns The availability verdict, with `loading` true until every requested URL has settled.
+ */
+export declare function useValueSetAvailabilities(urls: readonly (string | undefined)[]): ValueSetAvailability;
+
+/**
+ * Probes a single ValueSet's availability once on mount. A thin wrapper around
+ * {@link useValueSetAvailabilities} for the common single-value-set case.
+ * @param url - The ValueSet URL, or undefined for unbound inputs (always available).
+ * @returns undefined while the probe is in flight, true if available, false if unavailable.
+ */
+export declare function useValueSetAvailability(url: string | undefined): boolean | undefined;
+
 export declare function useWhisper({ language, model, onTranscript, idleTimeoutMs, }: UseWhisperOptions): UseWhisperResult;
 
 export declare type UseWhisperOptions = {
@@ -2971,6 +3181,18 @@ export declare interface ValueSetAutocompleteProps extends Omit<AsyncAutocomplet
     readonly withHelpText?: boolean;
 }
 
+/**
+ * The result of probing one or more ValueSet URLs for availability.
+ */
+export declare interface ValueSetAvailability {
+    /** True while at least one requested URL is still being probed. */
+    readonly loading: boolean;
+    /** The subset of requested URLs known to be available. */
+    readonly available: string[];
+    /** The subset of requested URLs known to be unavailable (a permanent 400/404). */
+    readonly unavailable: string[];
+}
+
 export declare function valueSetElementToCoding(element: ValueSetExpansionContains): Coding;
 
 /** Vitals section — searches for Observation resources with category vital-signs. */