@alfadocs/ui-kit 1.47.1 → 1.48.0

package/dist/components/appointment-details-panel/appointment-details-panel.types.d.ts

@@ -0,0 +1,326 @@
+import type { CalendarEventStatus } from '../calendar';
+import type { NotesPanelNote } from '../notes-panel';
+/** A fixed phone-label vocabulary, so the label can be localised. The
+ *  platform's `DoctorPatientPhoneNumber.label` is free text: the host maps
+ *  it onto these three. */
+export type AppointmentPhoneLabel = 'mobile' | 'home' | 'work';
+/** One labelled number: platform pop-over `phoneNumbers[]`
+ *  (`getPrefixAndNumber()`, already masked by `PrivacyMaskedService` when
+ *  the user hides patient details). */
+export interface AppointmentPhoneNumber {
+    label: AppointmentPhoneLabel;
+    number: string;
+}
+/** One highlighted anamnesis answer, as the platform's details dialog lists
+ *  it: the question, yes or no, the free answer and the interview date.
+ *  Display strings, localised by the host. */
+export interface AppointmentAnamnesisAnswer {
+    question: string;
+    yes: boolean;
+    answer?: string;
+    interviewIso: string;
+}
+/**
+ * The patient as the details read carries them. Only `id` and `name` are
+ * required. An absent field prints no row, never "none on file". Masking is
+ * the host's, server-side.
+ */
+export interface AppointmentDetailsPatient {
+    /** Platform `Patient.patientId`. */
+    id: string;
+    /** Platform `Patient.name`, the display name. */
+    name: string;
+    /** Profile photo URL. Without one, the avatar shows initials. */
+    avatarSrc?: string;
+    /** Date of birth, 'YYYY-MM-DD': a local calendar day, never an instant. */
+    dobIso?: string;
+    /** The mobile, when `phones` is absent. */
+    phone?: string;
+    /** Every labelled number (platform pop-over `phoneNumbers`). */
+    phones?: AppointmentPhoneNumber[];
+    /** Platform pop-over `emailAddress`, masked server-side when the user
+     *  hides patient details. */
+    email?: string;
+    /** Street: platform `Patient.street`. */
+    address?: string;
+    /** Platform `Patient.postcode`. */
+    postalCode?: string;
+    /** Platform `Patient.city`. */
+    city?: string;
+    /** Platform pop-over `highlightedAnamnesisAnswers`, a COUNT
+     *  (`Patient::getNumberOfHighlightedAnamnesisAnswers`). */
+    highlightedAnamnesisCount?: number;
+    /** Platform pop-over `expiredAnamnesisCount` (`CountExpiredService`). */
+    expiredAnamnesisCount?: number;
+    /** The highlighted answers themselves. The pop-over only counts them;
+     *  the platform's details dialog lists them. */
+    highlightedAnamnesisAnswers?: AppointmentAnamnesisAnswer[];
+}
+/** The platform's six `recurrence_frequency` values. */
+export type AppointmentRecurrenceFrequency = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'semiannual' | 'yearly';
+/** How signing was requested: platform
+ *  `DoctorAppointment.requiredObjectsSignMode` `via_sms` or `via_email`. */
+export type AppointmentSignChannel = 'sms' | 'email';
+/** The form fields an edit can touch (the platform's audit vocabulary). */
+export type AppointmentHistoryField = 'patient' | 'type' | 'care' | 'operator' | 'chair' | 'colour' | 'time' | 'duration';
+/** One history line: who did what to the appointment, and when. `atIso` is
+ *  an instant, with a zone. */
+export type AppointmentHistoryEntry = {
+    id: string;
+    atIso: string;
+    actor: string;
+} & ({
+    kind: 'created';
+} | {
+    kind: 'moved';
+    fromIso: string;
+    toIso: string;
+} | {
+    kind: 'resized';
+    fromMin: number;
+    toMin: number;
+} | {
+    kind: 'status';
+    from: CalendarEventStatus;
+    to: CalendarEventStatus;
+} | {
+    kind: 'edited';
+    fields: AppointmentHistoryField[];
+} | {
+    kind: 'deleted';
+}
+/** The patient confirmed by link; the host sends `actor: ''`. */
+ | {
+    kind: 'confirmedByPatient';
+});
+export type AppointmentHistoryKind = AppointmentHistoryEntry['kind'];
+/** The create-document menu's kinds, as the platform's
+ *  AppointmentDocumentDropdownApp offers them. */
+export type AppointmentDocumentKind = 'folder' | 'template' | 'empty' | 'identification' | 'webcam' | 'bill';
+/**
+ * One occurrence as the host reads it (platform
+ * `getEventPopoverContentAction`, route
+ * `ic_dcp_doctor_appointment_calendar_get_event_popover_content`). Pure
+ * data, no callbacks.
+ */
+export interface AppointmentDetailsRead {
+    /** The occurrence id the host was asked for, echoed back. An answer for
+     *  another id is never shown. */
+    eventId: string;
+    appointment: {
+        /** Local wall clock of THIS occurrence, 'YYYY-MM-DDTHH:mm:ss', no zone:
+         *  the pop-over route's `{date}` with a T. Not an instant: parse it with
+         *  `parseAppointmentStartIso`. */
+        startIso: string;
+        /** Platform `DoctorAppointment.duration`, in minutes. */
+        durationMin: number;
+        /** Platform `DoctorAppointment.allDay`. */
+        allDay: boolean;
+        /** A video visit: the appointment has a `telehealthSessionId`. */
+        isTelehealth: boolean;
+        /** Platform `DoctorAppointment.state`. Absent = no status recorded. */
+        status?: CalendarEventStatus;
+        /** The free-text description: platform `DoctorAppointment.name`. */
+        name?: string;
+        /** The host's heading for the appointment, as on the grid card. */
+        title: string;
+        /** The appointment's colour as a hex. The platform stores a
+         *  `DoctorAppointment.colorId`; the host resolves it. */
+        colorHex?: string;
+        /** Platform `DoctorAppointment.operatorId` (a DoctorOperator, not a
+         *  practice user). Informational: the visible label is the `operator`
+         *  prop. */
+        operatorId?: string;
+        /** Platform `DoctorAppointment.chairId`. Informational: the visible
+         *  label is the `chair` prop. */
+        chairId?: string;
+        /** The branch's display name, when the practice has branches. */
+        branchLabel?: string;
+        /** Platform `DoctorAppointment::wasCreatedThroughBooking()`. */
+        bookedOnline: boolean;
+        /** The series this occurrence belongs to. `requiresScope` is
+         *  informational: the scope question belongs to the host's editor. */
+        recurrence?: {
+            frequency: AppointmentRecurrenceFrequency;
+            count?: number;
+            requiresScope: boolean;
+        };
+    };
+    /** The booked patient, when the host could read them. Absent with a
+     *  `patientId` prop reads "Patient record not loaded". */
+    patient?: AppointmentDetailsPatient;
+    /** Absent = not permitted. Each figure is gated on its own, in major
+     *  currency units. `billableAmount`: platform `GetBillableAmountService`
+     *  (needs accounting_show and doctor_care_plan_show). `unpaidAmount`:
+     *  platform `getUnpaidAmountByPatient` (needs accounting_show and
+     *  doctor_bill_show). Leave out a figure the user may not see, rather
+     *  than sending 0 as the pop-over does. */
+    money?: {
+        billableAmount?: number;
+        unpaidAmount?: number;
+    };
+    /** The treatments on this appointment: platform
+     *  `DoctorAppointment::getDoctorCarePlanEntries()`. */
+    care?: {
+        /** The linked plan (platform `DoctorAppointment.carePlanId`). Without
+         *  `number` the card shows the plan name alone. */
+        plan?: {
+            id: string;
+            number?: string;
+            name: string;
+        };
+        lines: Array<{
+            /** Platform `carePlanEntryId`. */
+            entryId: string;
+            /** Platform `careId`. */
+            careId: string;
+            /** Platform `Care.name`. */
+            name: string;
+            /** Platform `Care.code`. */
+            code?: string;
+            /** Platform `care_plan_entry_elements_as_string` (the teeth). */
+            elementsLabel?: string;
+            /** Platform `CarePlanEntry.done`. */
+            done: boolean;
+            /** At least one bill row for the entry (pop-over `dto.billed`). */
+            billed: boolean;
+            /** Platform `scheduledCarePhases` for this appointment. */
+            phases: string[];
+            /** Absent = prices withheld for this viewer. */
+            priceCents?: number;
+        }>;
+    };
+    /** What the online booking recorded (platform
+     *  `DoctorAppointment.booking*`). */
+    booking?: {
+        /** Platform `bookingFirstName` and `bookingLastName`. */
+        typedName?: string;
+        /** Platform `bookingPhoneNumber`. */
+        phone?: string;
+        email?: string;
+        /** Platform `bookingNote`. */
+        note?: string;
+        /** When the booking was made: an instant, with a zone. */
+        bookedAtIso?: string;
+        /** Platform pop-over `onlinePaidAmount` (the StripePayment amount), in
+         *  major currency units. */
+        paidOnlineAmount?: number;
+    };
+    /** Documents to sign for this patient. */
+    signing?: {
+        /** Platform pop-over `numberOfRequiredObjects`. */
+        required: number;
+        /** Platform pop-over `numberOfRequiredObjectsToSign`. */
+        toComplete: number;
+        requestedVia?: AppointmentSignChannel;
+        /** Platform pop-over `hasAdvancedElectronicSignatureSetup`. */
+        aesSetUp: boolean;
+    };
+    /** The appointment's history, read with the details. Absent = not sent
+     *  with this read: the History button then follows the panel's `history`
+     *  prop, and without that too it is withheld. `[]` = nothing recorded
+     *  yet. */
+    history?: AppointmentHistoryEntry[];
+}
+/**
+ * The appointment's history when the host reads it on its own, once the
+ * History sub-view opens (`onOpenHistory`). Present = the user may read it,
+ * so the header offers History whatever this read has reached.
+ */
+export interface AppointmentDetailsHistory {
+    /** The occurrence these entries answer for. Set it, and an answer for an
+     *  earlier appointment shows as loading instead of under this one. */
+    eventId?: string;
+    /** The entries once read, in any order. `[]` = nothing recorded yet. */
+    entries?: readonly AppointmentHistoryEntry[];
+    /** Absent: 'ready' when `entries` is set, 'loading' when it is not. */
+    status?: 'loading' | 'ready' | 'error';
+    /** The failure to show on 'error'. Default: the kit's load error. */
+    message?: string;
+    /** Read again after 'error'. Without it, the error offers no Retry. */
+    onRetry?: () => void;
+}
+/** What the panel shows. `ready` carries the read; the other three render
+ *  the shell: a skeleton, an error with Retry, or a refusal. */
+export type AppointmentDetailsState<T extends AppointmentDetailsRead = AppointmentDetailsRead> = {
+    status: 'loading';
+    eventId?: string;
+}
+/** `refreshing`: a re-read of the SAME occurrence is in flight. The body
+ *  stays on screen and is marked busy. */
+ | {
+    status: 'ready';
+    read: T;
+    refreshing?: boolean;
+}
+/** A transient failure. `message` defaults to the kit's load error.
+ *  `eventId`: the occurrence whose read failed, when known. */
+ | {
+    status: 'error';
+    eventId?: string;
+    message?: string;
+}
+/** Not visible to this user. Retry only when `retryable`. `eventId`: the
+ *  occurrence that was refused, when known. */
+ | {
+    status: 'refused';
+    eventId?: string;
+    reason: string;
+    retryable?: boolean;
+};
+/** One answer from the host's loader. */
+export type AppointmentDetailsSnapshot<T extends AppointmentDetailsRead = AppointmentDetailsRead> = {
+    status: 'ready';
+    details: T;
+} | {
+    status: 'refused';
+    reason: string;
+    retryable?: boolean;
+};
+/** Reads one occurrence. A rejected promise is a transient failure (error
+ *  with Retry); the rejection's message is shown when it has one. */
+export type AppointmentDetailsLoader<T extends AppointmentDetailsRead = AppointmentDetailsRead> = (eventId: string, options: {
+    signal: AbortSignal;
+}) => Promise<AppointmentDetailsSnapshot<T>>;
+export interface UseAppointmentDetailsReadOptions<T extends AppointmentDetailsRead = AppointmentDetailsRead> {
+    /** The occurrence to read. A new id aborts the previous read and shows
+     *  the skeleton. `null` = no selection: nothing is read, the read in
+     *  flight is aborted, and `state` is null, so render no panel. */
+    eventId: string | null;
+    /** Reads one occurrence. The latest function is always the one called,
+     *  so an inline loader is fine: a new identity alone never reads again.
+     *  To read again, change `reloadKey`. */
+    load: AppointmentDetailsLoader<T>;
+    /** Change it after a write made anywhere in the rail, or when the loader
+     *  now reads from somewhere else: the same occurrence is read again
+     *  while the current read stays on screen. */
+    reloadKey?: string | number;
+}
+/** The operator's label, resolved by the host from
+ *  `appointment.operatorId`. */
+export interface AppointmentDetailsOperatorLabel {
+    name: string;
+    avatarSrc?: string;
+}
+/** The chair's label, resolved by the host from `appointment.chairId`. */
+export interface AppointmentDetailsChairLabel {
+    name: string;
+}
+/** The patient's latest notes as the host holds them. The panel reads; it
+ *  never writes a note. They must be the notes of this appointment's
+ *  patient only: pass `patientId` so the panel can check. */
+export interface AppointmentDetailsNotesPreview {
+    /** The patient these notes belong to. Set it, and notes for another
+     *  patient show as loading, never under this appointment. */
+    patientId?: string;
+    /** Newest first. The panel shows the first three, pinned first. */
+    notes: readonly NotesPanelNote[];
+    /** Absent = 'ready'. */
+    status?: 'loading' | 'ready' | 'error';
+    /** The full count, for "See more (n more)". Absent or null = unknown, and
+     *  the list length is used once ready. */
+    total?: number | null;
+    /** Retry after status 'error'. Without it, the error has no Retry. */
+    onRetry?: () => void;
+}
+//# sourceMappingURL=appointment-details-panel.types.d.ts.map

package/dist/components/appointment-details-panel/index.d.ts

@@ -0,0 +1,8 @@
+export { AppointmentDetailsPanel } from './appointment-details-panel';
+export type { AppointmentDetailsPanelProps, AppointmentDetailsPanelHandle, } from './appointment-details-panel';
+export { useAppointmentDetailsRead } from './use-appointment-details-read';
+export type { AppointmentDetailsReadResult } from './use-appointment-details-read';
+export { parseAppointmentStartIso } from '../_shared/appointment-format';
+export type { AppointmentDetailsRead, AppointmentDetailsHistory, AppointmentDetailsPatient, AppointmentDetailsState, AppointmentDetailsSnapshot, AppointmentDetailsLoader, UseAppointmentDetailsReadOptions, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsChairLabel, AppointmentHistoryEntry, AppointmentHistoryKind, AppointmentHistoryField, AppointmentRecurrenceFrequency, AppointmentSignChannel, AppointmentDocumentKind, AppointmentPhoneNumber, AppointmentPhoneLabel, AppointmentAnamnesisAnswer, } from './appointment-details-panel.types';
+export { appointmentDetailsPanelAgent } from './appointment-details-panel.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/appointment-details-panel/index.js

@@ -0,0 +1,8 @@
+import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-D2FH-cHF.js";
+export {
+  e as AppointmentDetailsPanel,
+  n as appointmentDetailsPanelAgent,
+  p as parseAppointmentStartIso,
+  s as useAppointmentDetailsRead
+};
+//# sourceMappingURL=index.js.map

package/dist/components/appointment-details-panel/use-appointment-details-read.d.ts

@@ -0,0 +1,32 @@
+import type { AppointmentDetailsRead, AppointmentDetailsState, UseAppointmentDetailsReadOptions } from './appointment-details-panel.types';
+export interface AppointmentDetailsReadResult<T extends AppointmentDetailsRead = AppointmentDetailsRead> {
+    /** Pass as AppointmentDetailsPanel `state`. Null while `eventId` is null:
+     *  there is no selection, so render no panel. */
+    state: AppointmentDetailsState<T> | null;
+    /** Pass as AppointmentDetailsPanel `onRetry`: reads the same occurrence
+     *  again. */
+    retry: () => void;
+}
+/**
+ * Reads one occurrence so that the latest selection always wins. A new
+ * `eventId` aborts the read in flight and shows the skeleton, even for an
+ * id shown before; a late answer for an earlier request is dropped. The
+ * error and refused states carry the `eventId` they answer. An answer for
+ * another appointment, or with an unreadable `startIso`, becomes an error,
+ * so the panel never shows one patient's name with another's appointment.
+ * A new `reloadKey` reads
+ * the same occurrence again while the current read stays on screen
+ * (`refreshing`); if that read fails, the panel shows the error rather than
+ * going back to the older read. A null `eventId` reads nothing and returns
+ * a null `state`.
+ *
+ * The latest `load` is the one called, so an inline loader never loops:
+ * only `eventId`, `reloadKey` and `retry` start a read.
+ */
+export declare function useAppointmentDetailsRead<T extends AppointmentDetailsRead = AppointmentDetailsRead>(options: UseAppointmentDetailsReadOptions<T> & {
+    eventId: string;
+}): AppointmentDetailsReadResult<T> & {
+    state: AppointmentDetailsState<T>;
+};
+export declare function useAppointmentDetailsRead<T extends AppointmentDetailsRead = AppointmentDetailsRead>(options: UseAppointmentDetailsReadOptions<T>): AppointmentDetailsReadResult<T>;
+//# sourceMappingURL=use-appointment-details-read.d.ts.map

package/dist/components/appointment-peek/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/appointment-peek-BsfCpiJs.js";
+import { A as o } from "../../_chunks/appointment-peek--dmWznLZ.js";
 import { a as n } from "../../_chunks/appointment-peek.agent-C539tNFM.js";
 export {
   o as AppointmentPeek,

package/dist/components/appointment-timeline/index.js

@@ -1,4 +1,4 @@
-import { A as i, a as t } from "../../_chunks/appointment-timeline-Cs5f9viN.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-y9uYZMUd.js";
 export {
   i as AppointmentTimeline,
   t as appointmentTimelineAgent

package/dist/components/audio-recorder/index.js

@@ -1,4 +1,4 @@
-import { A as r, a } from "../../_chunks/audio-recorder-B7dT-Y3v.js";
+import { A as r, a } from "../../_chunks/audio-recorder-DZBtAvLH.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

package/dist/components/autocomplete/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o, b as m } from "../../_chunks/autocomplete-MpBhz-fG.js";
+import { A as e, a as o, b as m } from "../../_chunks/autocomplete-DSasZUf6.js";
 export {
   e as Autocomplete,
   o as autocompleteAgent,

package/dist/components/badge/index.js

@@ -1,4 +1,4 @@
-import { B as o } from "../../_chunks/badge-BudgzTe_.js";
+import { B as o } from "../../_chunks/badge-BAkd6_Pj.js";
 export {
   o as Badge
 };

package/dist/components/bishop-score/index.js

@@ -1,4 +1,4 @@
-import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-Cu70iv9C.js";
+import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-BMLRvXYF.js";
 export {
   O as BISHOP_COMPONENTS,
   S as BISHOP_MAX_SCORE,

package/dist/components/bmi-calculator/index.js

@@ -1,4 +1,4 @@
-import { B as m } from "../../_chunks/bmi-calculator-C9N19aLX.js";
+import { B as m } from "../../_chunks/bmi-calculator-DUhRyyrA.js";
 import { b as e, a as t, c as r, d as T, e as c, f as i, i as b, k as n, l as f } from "../../_chunks/bmi-BxD-tFzU.js";
 export {
   m as BmiCalculator,

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-C4MwImkS.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-BQYFDcrz.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/breadcrumb/index.js

@@ -1,4 +1,4 @@
-import { B as e, a as s, b, c as m, d as c, e as d, f as u } from "../../_chunks/breadcrumb-agut0PwN.js";
+import { B as e, a as s, b, c as m, d as c, e as d, f as u } from "../../_chunks/breadcrumb-D3boYzD4.js";
 export {
   e as Breadcrumb,
   s as BreadcrumbEllipsis,

package/dist/components/button/button.d.ts

@@ -20,7 +20,8 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, Va
     /**
      * Visually hide the label, leaving the icon(s) and a square footprint.
      * The children stay in the DOM screen-reader-only, so the accessible
-     * name is preserved. Ignored with `asChild` (the label is slotted).
+     * name is preserved. With `asChild` the slotted element's own children
+     * become the hidden label, so a link folds to its icon too.
      */
     hideLabel?: boolean;
     /**

package/dist/components/button/index.js

@@ -1,5 +1,5 @@
-import { B as r } from "../../_chunks/button-CaUe1uyd.js";
-import { I as e } from "../../_chunks/icon-button-CehAeZoP.js";
+import { B as r } from "../../_chunks/button-18oBsI3n.js";
+import { I as e } from "../../_chunks/icon-button-CY7GU_Se.js";
 import { b as f } from "../../_chunks/button.agent-BuGZBktn.js";
 export {
   r as Button,

package/dist/components/button-group/button-group.d.ts

@@ -1,4 +1,4 @@
-import { type HTMLAttributes } from 'react';
+import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import type { ButtonProps } from '../button/button';
 type ButtonIntent = NonNullable<ButtonProps['intent']>;
@@ -6,6 +6,15 @@ declare const buttonGroupVariants: (props?: ({
     orientation?: "vertical" | "horizontal" | null | undefined;
     separator?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** One entry of a child's own menu, as More repeats it in a submenu. */
+export interface ButtonGroupOverflowItem {
+    label: string;
+    icon?: ReactNode;
+    onSelect: () => void;
+    disabled?: boolean;
+    /** Carried onto the menu item as `data-action`. */
+    action?: string;
+}
 export interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof buttonGroupVariants> {
     /**
      * Accessible label for the group. Falls back to the translated
@@ -50,7 +59,15 @@ export interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement>, Varian
      * The group then fills its container's inline size, so give it a bounded
      * parent. Horizontal only. Children needing to stay in the strip set
      * `data-overflow-pin`; children without a string label or `aria-label`
-     * cannot be mirrored into the menu and are pinned automatically.
+     * cannot be mirrored into the menu and are pinned automatically. When the
+     * pinned children alone no longer fit beside the menu, trailing pins that
+     * are plain actions (an `onClick`, a link or `overflowItems`) move into
+     * it, so it stays reachable. A pin carrying `aria-expanded`,
+     * `aria-pressed` or `aria-haspopup`, a pin with no action, and a child
+     * set to `data-overflow-pin="always"` never move. A link child (`asChild`
+     * over an `<a href>`) becomes an item that clicks the host's own link, so
+     * its handler, target and download apply; a child with `overflowItems`
+     * and a string label or `aria-label` becomes a submenu.
      */
     overflow?: 'none' | 'menu';
     /**

package/dist/components/button-group/index.js

@@ -1,4 +1,4 @@
-import { B as t } from "../../_chunks/button-group-CA1tmu39.js";
+import { B as t } from "../../_chunks/button-group-BSDqso_C.js";
 export {
   t as ButtonGroup
 };

package/dist/components/calendar/calendar.d.ts

@@ -458,7 +458,11 @@ export interface CalendarProps {
     datesAboveResources?: boolean;
     /** Allow overlapping events in the same slot. */
     slotEventOverlap?: boolean;
-    /** Keep date headers pinned during scroll. */
+    /**
+     * Keep date headers pinned during scroll. The kit overrides a host sheet
+     * that clips `.fc-view` or its table, so the header, the list view's day
+     * headings and the timeline's footer scrollbar still stick there.
+     */
     stickyHeaderDates?: boolean;
     /** Show a now-indicator line on time-grid views. */
     nowIndicator?: boolean;

package/dist/components/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as l, r as n } from "../../_chunks/calendar-OzSeTb4V.js";
+import { C as r, c as l, r as n } from "../../_chunks/calendar-DjoJ9ovF.js";
 export {
   r as Calendar,
   l as calendarAgent,

package/dist/components/calendar-event-card/index.js

@@ -1,4 +1,4 @@
-import { C as e } from "../../_chunks/calendar-event-card-B6N5h1dO.js";
+import { C as e } from "../../_chunks/calendar-event-card-BUbKBPv_.js";
 export {
   e as CalendarEventCard
 };

package/dist/components/care-plan-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as C } from "../../_chunks/care-plan-card-BOv0NRle.js";
+import { C as e, c as C } from "../../_chunks/care-plan-card-ciBaaguw.js";
 export {
   e as CarePlanCard,
   C as carePlanCardAgent

package/dist/components/care-plan-entry-card/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as e } from "../../_chunks/care-plan-entry-card-d-rZD4li.js";
+import { C as n, c as e } from "../../_chunks/care-plan-entry-card-D7A0whiZ.js";
 export {
   n as CarePlanEntryCard,
   e as carePlanEntryCardAgent

package/dist/components/care-plan-header/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as n } from "../../_chunks/care-plan-header-CEmBXn6-.js";
+import { C as r, c as n } from "../../_chunks/care-plan-header-DKV1gLqv.js";
 export {
   r as CarePlanHeader,
   n as carePlanHeaderAgent

package/dist/components/carousel/index.js

@@ -1,4 +1,4 @@
-import { C as o, c as r } from "../../_chunks/carousel.agent-z1yLBpyC.js";
+import { C as o, c as r } from "../../_chunks/carousel.agent-DqDGR2yH.js";
 export {
   o as Carousel,
   r as carouselAgent

package/dist/components/chart/index.js

@@ -1,4 +1,4 @@
-import { C as t, c as s, a as c } from "../../_chunks/chart-D8ucl8hH.js";
+import { C as t, c as s, a as c } from "../../_chunks/chart-VjuXDXOZ.js";
 export {
   t as Chart,
   s as chartAgent,

package/dist/components/chat-input/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as p } from "../../_chunks/chat-input-Cj7ZYQr5.js";
+import { C as n, c as p } from "../../_chunks/chat-input-BVho_SqP.js";
 export {
   n as ChatInput,
   p as chatInputAgent

package/dist/components/chat-message/index.js

@@ -1,4 +1,4 @@
-import { C as s } from "../../_chunks/chat-message-BMVxiUIX.js";
+import { C as s } from "../../_chunks/chat-message-Co_NRGM4.js";
 export {
   s as ChatMessage
 };

package/dist/components/city-input/index.js

@@ -1,4 +1,4 @@
-import { C as p, c as a } from "../../_chunks/city-input-DaQc-Hbj.js";
+import { C as p, c as a } from "../../_chunks/city-input-BGYc4lRV.js";
 export {
   p as CityInput,
   a as cityInputAgent

package/dist/components/clinical-note-card/clinical-note-card.d.ts

@@ -69,11 +69,6 @@ export interface ClinicalNoteCardProps extends Omit<HTMLAttributes<HTMLDivElemen
     pinned?: boolean;
     /** Flag the note for follow-up / attention — shows a "Flagged" chip. */
     flagged?: boolean;
-    /**
-     * When provided, the pinned chip becomes an `aria-pressed` toggle button so
-     * the note can be (un)pinned in place — the pin glyph fills and tints to the
-     * accent when pinned (no button fill). Omit for a static, display-only card.
-     */
     /**
      * Host-owned actions for this note (edit, delete, share …), rendered
      * beside the pin and flag. They belong in the same cluster: a reader
@@ -81,9 +76,22 @@ export interface ClinicalNoteCardProps extends Omit<HTMLAttributes<HTMLDivElemen
      * in one place, not some in the card and the rest below it.
      */
     headerActions?: ReactNode;
+    /**
+     * When provided, the pinned chip becomes an `aria-pressed` toggle button so
+     * the note can be (un)pinned in place — the pin glyph fills and tints to the
+     * accent when pinned (no button fill). Omit for a static, display-only card.
+     */
     onTogglePin?: () => void;
     /** As `onTogglePin`, for the flagged state (warning-tinted when flagged). */
     onToggleFlag?: () => void;
+    /**
+     * A pin write is in flight. The toggle keeps showing `pinned`, is
+     * `aria-disabled`, dims and ignores clicks until the host answers. Only
+     * with `onTogglePin`.
+     */
+    pinPending?: boolean;
+    /** As `pinPending`, for the flag toggle. */
+    flagPending?: boolean;
     /**
      * Clamp the rendered body to five lines. When the body is taller than the
      * clamp, a "Read more" / "Read less" disclosure toggles the full text in

package/dist/components/clinical-note-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as i } from "../../_chunks/clinical-note-card-DdsGYMmI.js";
+import { C as e, c as i } from "../../_chunks/clinical-note-card-DYDQ3q2x.js";
 export {
   e as ClinicalNoteCard,
   i as clinicalNoteCardAgent