@medplum/react 5.1.36 → 5.1.38

package/dist/cjs/index.d.ts

@@ -517,7 +517,7 @@ export declare interface CalendarDateInputProps {
     /** Called with the day picked. */
     readonly onClick: (date: Date) => void;
     readonly month?: Date;
-    /** The day chosen. Ignored while a range is given. */
+    /** An extra day to mark as picked, alongside any `range`. Ignored while a drag is under way. */
     readonly selected?: Date;
     readonly allowUnavailableDates?: boolean;
     readonly earliestDate?: Date;
@@ -1081,6 +1081,19 @@ export declare interface InfoBarProps {
     readonly children: ReactNode;
 }
 
+/**
+ * Loading placeholder that mirrors the InfoBar layout: an optional avatar followed by
+ * key/value entries of varying width.
+ * @param props - The skeleton props.
+ * @returns The InfoBarSkeleton React node.
+ */
+export declare function InfoBarSkeleton(props: InfoBarSkeletonProps): JSX.Element;
+
+export declare interface InfoBarSkeletonProps {
+    readonly withAvatar?: boolean;
+    readonly entries?: number;
+}
+
 export declare interface InfoBarValueProps {
     readonly children: ReactNode;
 }
@@ -1669,6 +1682,18 @@ export declare interface PatientSummarySectionConfig {
     readonly component: ComponentType<SectionRenderContext>;
 }
 
+/**
+ * Loading placeholder that mirrors the PatientSummary layout: the patient header followed by
+ * demographic rows and a set of collapsible sections with their items.
+ * @param props - The skeleton props.
+ * @returns The PatientSummarySkeleton React node.
+ */
+export declare function PatientSummarySkeleton(props: PatientSummarySkeletonProps): JSX.Element;
+
+export declare interface PatientSummarySkeletonProps {
+    readonly sections?: number;
+}
+
 export declare function PatientTimeline(props: PatientTimelineProps): JSX.Element;
 
 export declare interface PatientTimelineProps extends Pick<ResourceTimelineProps<Patient>, 'getMenu'> {
@@ -2739,6 +2764,18 @@ export declare interface TimelineItemProps<T extends Resource = Resource> extend
     readonly popupMenuItems?: ReactNode;
 }
 
+/**
+ * Loading placeholder that mirrors the TimelineItem layout: an avatar with name and date lines
+ * in the header, followed by a title bar and full-width body rows.
+ * @param props - The skeleton props.
+ * @returns The TimelineItemSkeleton React node.
+ */
+export declare function TimelineItemSkeleton(props: TimelineItemSkeletonProps): JSX.Element;
+
+export declare interface TimelineItemSkeletonProps {
+    readonly lines?: number;
+}
+
 export declare interface TimelineProps {
     readonly children?: ReactNode;
 }
@@ -3130,6 +3167,26 @@ export declare function useSearchOne<K extends ResourceType>(resourceType: K, qu
  */
 export declare function useSearchResources<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: SearchOptions): [ResourceArray<WithId<ExtractResource<K>>> | undefined, boolean, OperationOutcome | undefined];
 
+/**
+ * Returns a referentially stable wrapper around `callback` that always invokes the most recent
+ * value passed in. This allows consumers to pass inline callbacks without invalidating effects
+ * that depend on them.
+ *
+ * The returned function is always defined, even when `callback` is undefined; in that case it
+ * is a no-op returning undefined. Do not use the result as a "was a handler provided?" signal.
+ *
+ * The returned function may not be current during rendering. Synchronous usage in renders
+ * should invoke the original function instead of the stabilized wrapper.
+ *
+ * In React v19.2+, when the callback is only used in effects, this can be replaced with
+ * `useEffectEvent`. This package supports embedding in applications using React 18.0, so that
+ * technique can not be used in this library yet.
+ *
+ * @param callback - The callback to stabilize. May be undefined.
+ * @returns A stable function that forwards to the latest `callback`.
+ */
+export declare function useStabilizedCallback<Args extends unknown[], R>(callback: ((...args: Args) => R) | undefined): (...args: Args) => R | undefined;
+
 /**
  * Creates an in-memory `Subscription` resource with the given criteria on the Medplum server and calls the given callback when an event notification is triggered by a resource interaction over a WebSocket connection.
  *

package/dist/esm/index.d.ts

@@ -517,7 +517,7 @@ export declare interface CalendarDateInputProps {
     /** Called with the day picked. */
     readonly onClick: (date: Date) => void;
     readonly month?: Date;
-    /** The day chosen. Ignored while a range is given. */
+    /** An extra day to mark as picked, alongside any `range`. Ignored while a drag is under way. */
     readonly selected?: Date;
     readonly allowUnavailableDates?: boolean;
     readonly earliestDate?: Date;
@@ -1081,6 +1081,19 @@ export declare interface InfoBarProps {
     readonly children: ReactNode;
 }
 
+/**
+ * Loading placeholder that mirrors the InfoBar layout: an optional avatar followed by
+ * key/value entries of varying width.
+ * @param props - The skeleton props.
+ * @returns The InfoBarSkeleton React node.
+ */
+export declare function InfoBarSkeleton(props: InfoBarSkeletonProps): JSX.Element;
+
+export declare interface InfoBarSkeletonProps {
+    readonly withAvatar?: boolean;
+    readonly entries?: number;
+}
+
 export declare interface InfoBarValueProps {
     readonly children: ReactNode;
 }
@@ -1669,6 +1682,18 @@ export declare interface PatientSummarySectionConfig {
     readonly component: ComponentType<SectionRenderContext>;
 }
 
+/**
+ * Loading placeholder that mirrors the PatientSummary layout: the patient header followed by
+ * demographic rows and a set of collapsible sections with their items.
+ * @param props - The skeleton props.
+ * @returns The PatientSummarySkeleton React node.
+ */
+export declare function PatientSummarySkeleton(props: PatientSummarySkeletonProps): JSX.Element;
+
+export declare interface PatientSummarySkeletonProps {
+    readonly sections?: number;
+}
+
 export declare function PatientTimeline(props: PatientTimelineProps): JSX.Element;
 
 export declare interface PatientTimelineProps extends Pick<ResourceTimelineProps<Patient>, 'getMenu'> {
@@ -2739,6 +2764,18 @@ export declare interface TimelineItemProps<T extends Resource = Resource> extend
     readonly popupMenuItems?: ReactNode;
 }
 
+/**
+ * Loading placeholder that mirrors the TimelineItem layout: an avatar with name and date lines
+ * in the header, followed by a title bar and full-width body rows.
+ * @param props - The skeleton props.
+ * @returns The TimelineItemSkeleton React node.
+ */
+export declare function TimelineItemSkeleton(props: TimelineItemSkeletonProps): JSX.Element;
+
+export declare interface TimelineItemSkeletonProps {
+    readonly lines?: number;
+}
+
 export declare interface TimelineProps {
     readonly children?: ReactNode;
 }
@@ -3130,6 +3167,26 @@ export declare function useSearchOne<K extends ResourceType>(resourceType: K, qu
  */
 export declare function useSearchResources<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: SearchOptions): [ResourceArray<WithId<ExtractResource<K>>> | undefined, boolean, OperationOutcome | undefined];
 
+/**
+ * Returns a referentially stable wrapper around `callback` that always invokes the most recent
+ * value passed in. This allows consumers to pass inline callbacks without invalidating effects
+ * that depend on them.
+ *
+ * The returned function is always defined, even when `callback` is undefined; in that case it
+ * is a no-op returning undefined. Do not use the result as a "was a handler provided?" signal.
+ *
+ * The returned function may not be current during rendering. Synchronous usage in renders
+ * should invoke the original function instead of the stabilized wrapper.
+ *
+ * In React v19.2+, when the callback is only used in effects, this can be replaced with
+ * `useEffectEvent`. This package supports embedding in applications using React 18.0, so that
+ * technique can not be used in this library yet.
+ *
+ * @param callback - The callback to stabilize. May be undefined.
+ * @returns A stable function that forwards to the latest `callback`.
+ */
+export declare function useStabilizedCallback<Args extends unknown[], R>(callback: ((...args: Args) => R) | undefined): (...args: Args) => R | undefined;
+
 /**
  * Creates an in-memory `Subscription` resource with the given criteria on the Medplum server and calls the given callback when an event notification is triggered by a resource interaction over a WebSocket connection.
  *