@alfadocs/ui-kit 1.47.1 → 1.48.0

package/dist/agent-i18n/en.json

@@ -73,6 +73,23 @@
         "selectItem": "Activate the appointment with the given id."
       }
     },
+    "appointmentDetailsPanel": {
+      "state": {
+        "eventId": "The occurrence on screen or being read, as the host identifies it. After a failed or refused read, the occurrence it was for when the host says so. Null when there is none, or the host did not say.",
+        "loadStatus": "Where the read is: loading, ready, failed (with Retry) or refused. Actions need ready.",
+        "appointmentStatus": "The appointment status as last saved here or read. Null when none is recorded or nothing is on screen.",
+        "allowedStatuses": "The statuses set_status accepts now, in menu order. Empty when the status is read-only.",
+        "offeredActions": "The footer actions on offer, as their data-action values (for example edit-appointment, delete-appointment), in footer order, including any folded into More.",
+        "historyOpen": "Whether the History sub-view covers the details.",
+        "privacy": "Whether privacy mode is on. The patient identity and personal fields are then masked on screen."
+      },
+      "actions": {
+        "openHistory": "Slide the appointment's history over the details, as its header button does; the host reads it then if it did not send it with the details. It lists who changed what, and when.",
+        "closeHistory": "Return from History to the details.",
+        "setStatus": "Save a new appointment status through the host, as the footer control does. Resolves once the host has saved it.",
+        "retry": "Ask the host to read the appointment again, after a failed read or a refusal it marked retryable."
+      }
+    },
     "appointmentTimeline": {
       "state": {
         "items": "Currently-rendered appointments. Ids + lifecycle state only — never patient identity."
@@ -168,19 +185,20 @@
       "workflows": {
         "browseAgenda": "Navigate the agenda: today, previous / next range, jump to a date through the navigation row's date picker, or change what the grid shows from the one view menu — a range (day, three days, week, month, also reachable as the bare keys D · X · W · M) and a column axis (plain, chairs, operators), plus a remembered \"Show weekends\" item that hides Saturday and Sunday in every range. Each range change hands the new window to the host, which fetches the appointments for it.",
         "filterColumns": "Narrow the grid to particular chairs or operators from the two filter popovers, with the platform's semantics: nothing ticked shows everyone and ticking narrows. Operators list under their groups with a tri-state row per group; \"Only available operators\" is on by default in the operator views, and a session-local \"Show disabled operators\" switch reveals the operators the practice has disabled. A count badge rides each filter button while it narrows, and the \"Reset filters\" chip beside them clears both selections and restores both switches without ever changing the view. Selection only — no appointment is touched.",
-        "maskPatientNames": "Turn privacy mode on or off from the toolbar. While on, patient identity is masked across the grid and the whole rail: the cards, the hover peek, the Appointments panel, the appointment details panel (patient card, description, booking contact, notes preview and the WhatsApp link are hidden), the online bookings, the waiting list and the printed call sheet; the Notes tool and the edit form show a notice instead of their content. The page can stay open beside a waiting patient. It is a display mask, not a permission: it is not persisted and it changes no record.",
+        "maskPatientNames": "Turn privacy mode on or off from the toolbar. While on, patient identity is masked across the grid and the whole rail: the cards, the hover peek, the Appointments panel, the appointment details panel (patient card, description, booking contact, notes preview and the WhatsApp link are hidden), the online bookings, the waiting list and the printed call sheet; the Notes tool and the edit form show a notice instead of their content, and so does a tool the host adds, unless the host masks it itself. The page can stay open beside a waiting patient. It is a display mask, not a permission: it is not persisted and it changes no record.",
         "configureDisplay": "Set the per-user display knobs in the cog popover — layout, zebra rows, show times, slot precision, the day window, the care-description mode, what the cards are coloured by, the default duration of a new appointment (5–240 minutes), whether operators read as an initials disc or a dot plus full name, whether chairs read as a full name or a short code, and whether the details panel offers the map link. The choices are remembered per user through the host's preferences adapter under `calendarWorkspace.*` keys, so they persist beyond the page load; they change presentation only and touch no patient record.",
-        "dockTool": "Open a workspace rail tool: Appointments, appointment editor / details, waiting list, patient notes, online bookings or free-slot finder. Read the actual strip: hosts may withhold tools, and patient-notes is registered only with patient context. Notes uses the host's note permissions, independently of appointment-edit rights. Clearing its patient context returns to the previous available tool and focuses its rail button. Opening notes from a panel may address a note id and moves focus into Notes. Closing other tools returns to Appointments.",
+        "dockTool": "Open a workspace rail tool: Appointments, appointment editor / details, waiting list, patient notes, online bookings or free-slot finder. Read the actual strip: hosts may withhold tools, and patient-notes is registered only with patient context. Notes uses the host's note permissions, independently of appointment-edit rights. Clearing its patient context returns to the previous available tool and focuses its rail button. Opening notes from a panel may address a note id and moves focus into Notes. Closing other tools returns to Appointments. A host may add its own tools after these; they carry the host's ids, so read the strip's data-tool-id before opening one. open ignores an id no tool carries; select_tool with one, or a host tool the host withdraws while open, docks Appointments. patient-notes is the exception: withheld or without a patient, it returns to the previous tool, unannounced.",
         "reviewUpcoming": "Read the rail's resting panel: the practice's upcoming appointments — now to the end of the seventh day, cancelled excluded, earliest first — each row led by the patient. The preset row, the jump-to-date picker and the edge loaders widen the derived window up to ±180 days. Activating a row selects that appointment on the grid, which docks its details. Read-only; the rows carry ids and lifecycle state, never patient identity.",
-        "readAppointmentDetails": "Read one appointment in the docked details panel. With the host's details read, any card click, including a patient-less block and a chip whose names are still loading, focuses the appointment and docks a read-only panel: appointment, booking, money, contact, treatments, signing and series sections, the patient's latest three notes and a History sub-view. See more or a note opens the separate Notes rail tool when the host offers it. While the read is loading, failed or refused the panel shows that status instead. Edit, withheld from a read-only viewer, opens the editor. Without the host's read a pending chip stays inert and the editor form is the details. Reads patient-identifiable data.",
+        "readAppointmentDetails": "Read one appointment in the docked details panel (appointment-details-panel). With the host's details read, any card click, including a patient-less block and a chip whose names are still loading, focuses the appointment and docks a read-only panel: appointment, booking, money, contact, treatments, signing and series sections, the patient's latest three notes and a History sub-view. See more or a note opens the separate Notes rail tool when the host offers it. While the read is loading, failed or refused the panel shows that status instead. Edit, withheld from a read-only viewer, opens the editor. Without the host's read a pending chip stays inert and the editor form is the details. Reads patient-identifiable data.",
         "createAppointment": "Book a new appointment in the editor panel, docked from the New appointment button, from a click on an empty slot (prefilled with the slot, the clicked column and the cog's default duration) or from an online booking being processed. Set the patient, the linked care or care-plan lines, the date, start time and duration, the operator, chair, branch and colour, the description (255 characters at most — a longer one blocks the save), and, once a patient is chosen, the SMS and e-mail reminders, the first-visit question and — where the patient has unsigned required documents — how they are asked to sign. Busy chair, busy operator and operator-away warnings are advisory and do not hold the save; only a practice closure does. Enter submits from any text field. Writes patient-identifiable data.",
         "editAppointment": "Amend an existing appointment in the docked editor. With the host's details read the editor opens from Edit on the details panel and Cancel or Save returns there; without it the details panel is the form. A remote host first loads canonical data; loading, failure and whole-appointment refusal expose no editable form. When that data carries a series, the editor first asks the scope: this occurrence, this and following, or the whole series. Honour the returned patient, care, description and recurrence capabilities. A refused recurring scope cannot be treated as an ordinary edit. Save waits for host acceptance before closing or announcing success; rejection preserves the entered draft for correction or retry. Writes patient-identifiable data.",
-        "changeAppointmentStatus": "Set an appointment's attendance status from the Status select in the details panel. The status is patient-identifiable attendance data.",
+        "changeAppointmentStatus": "Set an appointment's attendance status from the status control in the details panel (appointment-details-panel). The workspace offers all six statuses; allowedStatuses lists what set_status accepts. A refusal keeps the previous status and shows the host's message. The status is patient-identifiable attendance data.",
         "moveAppointment": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels and, for a series member, the recurring scope. A host recurring parent always confirms, asks the scope and hides the notify channels, as the platform does. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
         "resizeAppointment": "Change an appointment's duration by dragging its card edge. Unlike a move this SAVES AT ONCE with no confirmation, exactly as the platform does; the toast that follows carries an Undo that restores the previous duration and logs both changes on the appointment's history. Writes patient-identifiable data.",
         "copyAppointment": "Duplicate an appointment onto another slot: arm \"Copy…\" in the details panel, then click the target. The copy lands immediately with no confirmation, and its toast carries an Undo. A plan-linked appointment first asks whether to copy the appointment only or the appointment and its treatments. Writes patient-identifiable data.",
         "deleteAppointment": "Remove an appointment from the details panel behind an alert dialog. The dialog asks for the recurring scope when the appointment belongs to a series, and for the care-plan cleanup when it is the parent of a price-list recurrence — so confirming can drop far more than the one card. Irreversible from this surface.",
-        "managePatientNotes": "Read and write the patient's notes from the conditional Notes rail tool: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author. The kit attributes nothing to a clinical note. An HTML note edits in a rich text editor and saves as HTML; a clinical or deleted note offers no edit. With no host seam, or when the host's seam is not writable, the tool is a read-only timeline. Explicit note permissions take precedence over appointment-edit permission. Details and the editor have no Notes sub-view. The rows carry ids and pin / flag / clinical markers only; the body and author are never exposed as state. Writes patient-identifiable clinical data.",
+        "managePatientNotes": "Read and write the patient's notes from the conditional Notes rail tool: add a note through the composer, edit one in place, pin or flag one, or delete one behind the panel's alert dialog. Every write goes to the host on the click, and the host stamps the note's id, time and author. The kit attributes nothing to a clinical note. A refused delete, pin or flag is rolled back and explained in the panel. An HTML note edits in a rich text editor and saves as HTML; a clinical or deleted note offers no edit. With no host seam, or when the host's seam is not writable, the tool is a read-only timeline. Explicit note permissions take precedence over appointment-edit permission. Details and the editor have no Notes sub-view. The rows carry ids and pin / flag / clinical markers only; the body and author are never exposed as state. Writes patient-identifiable clinical data.",
+        "manageTask": "Create, edit, complete or delete a practice task in the editor tool's slot, in the published task editor. The toolbar's New task member opens an empty task, dated from the grid's selection or now; a click on a task row on the grid opens that task, read through the host. Set the date, the note, the type, the assignee and at most one counterpart (a patient, a company or an operator), then save through the host. Done and Delete act on a saved task at once. Each action is withheld when the host passes no seam for it. A task can link a patient, so writes are patient-identifiable.",
         "readModificationHistory": "Open the History sub-view of the details panel and read the appointment's modification ledger, newest first — what changed, from what to what, and when. No mutation.",
         "requestSignature": "Ask the patient to sign the appointment's documents from the details panel, by SMS or e-mail through the kit menu. The chip beside it reports the channel a request has already gone out on. There is no \"On this device…\" item: on-device signing is the host's own e-signature surface and no seam here mounts it, so the menu offers only the two channels it can honour. Sends a patient-identifiable request.",
         "createDocument": "Open the appointment details create menu through data-action=\"open-create-document\" and select an offered data-action=\"create-document-<kind>\" item: bill, folder, template, empty, identification or webcam. The host supplies permitted kinds and owns navigation, confirmation and persistence. Appointment read-only mode does not withhold document rights. A selection starts the host workflow; it does not prove that a document or bill was created. May write patient-identifiable data.",
@@ -811,14 +829,14 @@
     },
     "notesPanel": {
       "state": {
-        "notes": "Timeline note ids + pinned / flagged / clinical flags. Never the note body or author (both PHI).",
+        "notes": "Timeline note ids + pinned / flagged / clinical / deleted flags. Never the note body or author (both PHI). A note whose delete is in flight is left out; a pin or flag in flight is reported with its new value. A deleted note takes no pin or flag.",
         "canAddClinical": "Whether the current user may write clinical notes (the practice_add_clinical_note permission gate).",
         "currentNoteId": "Id of the note the host has addressed — the one marked, scrolled to and focused. Null when none is. An id only, never note content."
       },
       "actions": {
         "addNote": "Compose and commit a new note. A clinical note requires the clinical-note permission (read canAddClinical first).",
-        "togglePin": "Toggle the pinned state of the note with the given id. Refused for a deleted note or one whose actions.pin is false.",
-        "toggleFlag": "Toggle the flagged state of the note with the given id."
+        "togglePin": "Toggle the pinned state of the note with the given id. Returns the host's promise; a refusal restores the pin and the panel shows the host's message. Rejects without reaching the host when the panel refuses: a deleted note, actions.pin false, or a write for the note still pending.",
+        "toggleFlag": "Toggle the flagged state of the note with the given id. Returns the host's promise; a refusal restores the flag and the panel shows the host's message. Rejects without reaching the host when the panel refuses: a deleted note, or a write for the note still pending."
       }
     },
     "notificationTray": {
@@ -1394,6 +1412,20 @@
         "selectTab": "Activate the tab with the given value."
       }
     },
+    "taskEditor": {
+      "state": {
+        "status": "Where the form is: loading the task, ready, failed to load, locked (edit mode with nothing to load) or withheld behind the privacy notice. Writes need 'ready'.",
+        "draft": "The draft as Save would send it: ids and structure only, never the note body. done is the last value the host confirmed.",
+        "canSave": "Whether save would reach the host now: the form is ready, the note is filled, a chosen counterpart has an id and no write is pending."
+      },
+      "actions": {
+        "setFields": "Set draft fields. Ids must come from the host lists, a patient the host search returned, or equal the stored one. At most one counterpart per call, and it selects its branch; assigneeId null is nobody. Nothing is saved.",
+        "save": "Save the task through the host. Resolves once the write lands and rejects with the host error, which the form also shows.",
+        "setDone": "Mark an existing task done or not done through the host. A rejection rolls the switch back.",
+        "delete": "Delete the task through the host, without the confirmation dialog. Resolves once the delete lands.",
+        "cancel": "Close the editor without saving. Anything typed since the last save is lost. Refused while a save or delete is in flight."
+      }
+    },
     "taskTray": {
       "state": {
         "items": "Currently-displayed tasks. Ids + status only — never task title / patient."
@@ -1413,7 +1445,7 @@
         "toggleDone": "Request the host to toggle the done state of a task.",
         "dismiss": "Request the host to dismiss / remove the task with the given id.",
         "jumpToOverdue": "Re-anchor the panel scroll on the overdue tasks.",
-        "setFilter": "Set the task filters (status segment, type, assignee, overdue-only). Omitted keys are left unchanged.",
+        "setFilter": "Set the task filters (status segment, type, assignee, overdue-only). Omitted keys are left unchanged. Unchanged values are not re-sent. In server-filtered panels, choosing status 'done' clears overdueOnly.",
         "changeScope": "Switch the task scope segment between this patient ('patient') and the operator's own tasks ('mine'). The host re-feeds the items.",
         "loadMore": "Request the host to append the next page of tasks."
       }

package/dist/components/_shared/appointment-format.d.ts

@@ -0,0 +1,52 @@
+import type { AppointmentPhoneNumber, AppointmentRecurrenceFrequency } from '../appointment-details-panel/appointment-details-panel.types';
+/** A date-only value (a birthday, an all-day start) is already a local day;
+ *  anything else parses as the wall clock it carries. */
+export declare function parseEventDate(value: string | Date): Date;
+/** "Wednesday, 24 June 2026" in the reader's locale; '' when unreadable. */
+export declare function formatDay(locale: string, value: Date | string): string;
+/** "09:00–09:45" in the reader's locale, 24-hour; '' when unreadable. */
+export declare function formatTimeRange(locale: string, start: Date | string, end?: Date | string): string;
+/** Absolute stamp for booked-at and history lines: day and time. */
+export declare const DETAIL_STAMP_FORMAT: Intl.DateTimeFormatOptions;
+/** Completed years between a birth date and `on`, the practice's clock
+ *  rather than the real one, so the figure never drifts under a test. */
+export declare function ageInYears(dobIso: string, on: Date | string): number;
+/** The host's zone-less wall clock as a local Date, or undefined when it is
+ * not a real 'YYYY-MM-DDTHH:mm:ss' reading. Ranges are checked rather than
+ * round-tripped, so a time inside a daylight-saving gap still parses. */
+export declare function parseAppointmentStartIso(startIso: string | undefined): Date | undefined;
+/** A Timeline set to 'newest-first' is a plain column, so the DOM order
+ *  must already be newest first. Unreadable dates stay last, in input
+ *  order; equal instants keep theirs. The input is not changed. */
+export declare function sortHistoryNewestFirst<T extends {
+    atIso: string;
+}>(entries: readonly T[]): T[];
+/** The editor's label key for each frequency, under
+ *  `calendarWorkspace.editor.*`. A literal map, so key extractors see
+ *  every key. */
+export declare const RECURRENCE_LABEL_KEY: Record<AppointmentRecurrenceFrequency, string>;
+/** What a patient record needs for its phones. */
+export interface PhonesSource {
+    phone?: string;
+    phones?: AppointmentPhoneNumber[];
+}
+/** Every labelled phone number. The single `phone` is the mobile when the
+ *  record carries no list. A record with neither has no numbers, which is
+ *  not the same as one labelled blank: the list comes back empty and the
+ *  caller omits the rows. */
+export declare function patientPhones(patient: PhonesSource): AppointmentPhoneNumber[];
+/** What a patient record needs for its address. */
+export interface AddressSource {
+    address?: string;
+    postalCode?: string;
+    city?: string;
+}
+/** The address as one line, the map search's text. Empty when the host
+ *  sent no address at all: the caller then offers no search. */
+export declare function patientAddressLine(patient: AddressSource): string;
+/** The map link's visible label: street and city, as the platform popover
+ *  prints them. The postcode belongs in the search, not in the label. */
+export declare function patientAddressLabel(patient: AddressSource): string;
+/** Google Maps search for the patient's address: the popover's map link. */
+export declare function patientMapsUrl(patient: AddressSource): string;
+//# sourceMappingURL=appointment-format.d.ts.map

package/dist/{patterns/calendar/calendar-editor-fields.d.ts → components/_shared/compact-editor-fields.d.ts}

@@ -1,8 +1,9 @@
 /**
- * Compact fields for the calendar's three editors (appointment, task and
- * waiting-list entry): 32px high with `--radius-md` corners, the height and
- * shape of the calendar toolbar's controls, where the kit default is 44px
- * with `--radius-sm`.
+ * Compact fields for the calendar's appointment and waiting-list entry
+ * editors and for the published TaskEditor, which the calendar's task route
+ * also renders: 32px high with `--radius-md` corners, the height and shape
+ * of the calendar toolbar's controls, where the kit default is 44px with
+ * `--radius-sm`. Shared here so a published component can use it.
  *
  * INTENTIONAL EXCEPTION — do not "fix" these back to 44px. 32px sits below
  * `--min-target-size` on purpose: it is the toolbar's sanctioned sub-target
@@ -30,4 +31,4 @@ export declare const EDITOR_COMPACT_FIELDS_CLASS: string;
  * give each segment `--min-target-size` back and let the track grow.
  */
 export declare const EDITOR_COMPACT_SEGMENTED_CLASS: string;
-//# sourceMappingURL=calendar-editor-fields.d.ts.map
+//# sourceMappingURL=compact-editor-fields.d.ts.map

package/dist/components/_shared/handled-rejection.d.ts

@@ -0,0 +1,2 @@
+export declare function handledRejection<T = void>(reason: unknown): Promise<T>;
+//# sourceMappingURL=handled-rejection.d.ts.map

package/dist/components/_shared/menu-row.d.ts

@@ -0,0 +1,17 @@
+export declare const MENU_ROW_HIGHLIGHT: {
+    /** Radix DropdownMenu and Select items: `data-highlighted` is present. */
+    readonly highlighted: string;
+    /** cmdk items: `data-selected="true"` (cmdk writes the same flag to aria-selected). */
+    readonly selected: string;
+    /** Hand-rolled listboxes (VariablesMenu, AddressAutocomplete, SearchBar): `data-active="true"`. */
+    readonly active: string;
+    /** Radix SubTrigger while its submenu is open, so the path stays lit. */
+    readonly open: string;
+};
+export type MenuRowHighlightState = keyof typeof MENU_ROW_HIGHLIGHT;
+/** Text in the row's ink on a lit row, e.g. a status dot. */
+export declare const MENU_ROW_INK: string;
+/** A bordered chip (Badge, Tag) on a lit row: no fill, an outline and text in
+ *  the row's ink, whatever its tone. */
+export declare const MENU_ROW_CHIP: string;
+//# sourceMappingURL=menu-row.d.ts.map

package/dist/components/_shared/patient-identity.d.ts

@@ -0,0 +1,7 @@
+/** The least a surface needs to name a patient: a stable id and a display
+ *  name. Richer shapes, such as `CalendarPatient`, satisfy it. */
+export interface PatientIdentity {
+    id: string;
+    name: string;
+}
+//# sourceMappingURL=patient-identity.d.ts.map

package/dist/components/_shared/patient-picker.d.ts

@@ -0,0 +1,24 @@
+import type { PatientIdentity } from './patient-identity';
+/** Host typeahead. Called 250 ms after typing stops, for non-blank trimmed
+ *  queries only. Abort a superseded call through `signal`. The host's order
+ *  is kept, so matches by phone or number stay. Reject on failure; `[]` is a
+ *  successful search with no match. */
+export type PatientSearch = (query: string, options: {
+    signal: AbortSignal;
+}) => Promise<readonly PatientIdentity[]>;
+export interface PatientPickerProps {
+    value: string;
+    onValueChange: (value: string) => void;
+    /** Filtered on the client when `searchPatients` is absent. */
+    patients?: readonly PatientIdentity[];
+    /** Wins over `patients` for listing. */
+    searchPatients?: PatientSearch;
+    /** Names `value` when neither the list nor a search result does. */
+    selectedLabel?: string;
+    /** Already translated. Also the idle line under a search. */
+    placeholder: string;
+    size?: 'sm' | 'md';
+    disabled?: boolean;
+}
+export declare function PatientPicker({ patients, searchPatients, ...props }: PatientPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=patient-picker.d.ts.map

package/dist/components/_shared/privacy-mask.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+/** The mask privacy mode shows for a name. TOTAL, as `maskedTitle` is: an
+ *  empty or absent host mask degrades to the bullets, never to a blank. */
+export declare function privacyMask(mask?: string): string;
+/** One muted line where a personal value would have been. */
+export declare function PrivacyHiddenLine({ block }: {
+    block?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** The patient card under privacy: the grid's mask, no photo, no contact
+ *  fields and no chips. Keeps `data-card="patient"` for host hooks. */
+export declare function PrivacyIdentityCard({ mask }: {
+    mask?: string;
+}): import("react/jsx-runtime").JSX.Element;
+interface PrivacyNoticeProps {
+    /** Absent: the notice explains, and the toolbar's toggle is the way out. */
+    onTurnOff?: () => void;
+}
+/** The notice alone, with no heading of its own: for a surface that already
+ *  has one, such as a PanelSubview body. */
+export declare function PrivacyNotice({ onTurnOff }: PrivacyNoticeProps): import("react/jsx-runtime").JSX.Element;
+/** A whole rail panel withheld under privacy: a form or a notes list that
+ *  could only open by showing what the mask hides. */
+export declare function PrivacyNoticePanel({ title, icon, onTurnOff, }: PrivacyNoticeProps & {
+    /** The panel's own title, so the rail still says which tool this is. */
+    title: string;
+    icon?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=privacy-mask.d.ts.map

package/dist/components/address-autocomplete/index.js

@@ -1,4 +1,4 @@
-import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-Bq-1n1UX.js";
+import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-Dp5uMvKP.js";
 export {
   o as AddressAutocomplete,
   t as addressAutocompleteAgent,

package/dist/components/address-fields/index.js

@@ -1,4 +1,4 @@
-import { A as e, a } from "../../_chunks/address-fields-jFfjxOQR.js";
+import { A as e, a } from "../../_chunks/address-fields-QfC-N3pw.js";
 export {
   e as AddressFields,
   a as addressFieldsAgent

package/dist/components/agenda-card/index.js

@@ -1,4 +1,4 @@
-import { A as e } from "../../_chunks/agenda-card-DyQtHb9z.js";
+import { A as e } from "../../_chunks/agenda-card-C4h0xMGi.js";
 import { a as d } from "../../_chunks/agenda-card.agent-Cb5tuEh3.js";
 import { i as g } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {

package/dist/components/agenda-tray/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as g } from "../../_chunks/agenda-tray-CBaJASb5.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-DNZYW2xt.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

package/dist/components/ai-credits-notice/index.js

@@ -1,4 +1,4 @@
-import { A as i } from "../../_chunks/ai-credits-notice-xszqOZTC.js";
+import { A as i } from "../../_chunks/ai-credits-notice-C-kz_RrY.js";
 import { a as r } from "../../_chunks/ai-credits-notice.agent-C9L7orrP.js";
 export {
   i as AiCreditsNotice,

package/dist/components/ai-permission-notice/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-permission-notice-D7I2U-cz.js";
+import { A as e, a as o } from "../../_chunks/ai-permission-notice-BRZeS3mT.js";
 export {
   e as AiConsentBanner,
   o as aiConsentBannerAgent

package/dist/components/ai-prompt-input/index.js

@@ -1,4 +1,4 @@
-import { A as a, a as o } from "../../_chunks/ai-prompt-input-DXknpQCB.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-CxvnXsAs.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

package/dist/components/anamnesis-card/index.js

@@ -1,4 +1,4 @@
-import { A as s } from "../../_chunks/anamnesis-card-xtEhyojD.js";
+import { A as s } from "../../_chunks/anamnesis-card-D8Si-2GV.js";
 export {
   s as AnamnesisCard
 };

package/dist/components/anamnesis-summary-card/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as s } from "../../_chunks/anamnesis-summary-card-CclBbiXg.js";
+import { A as r, a as s } from "../../_chunks/anamnesis-summary-card-DPyScUMM.js";
 export {
   r as AnamnesisSummaryCard,
   s as anamnesisSummaryCardAgent

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

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-DluZy8Iv.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-CLrGGnKR.js";
+import { A as p } from "../../_chunks/appointment-card-CvGU0QP6.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-BTecNeSb.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   p as AppointmentCard,

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

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { AppointmentDetailsPanelHandle } from './appointment-details-panel';
+export declare const appointmentDetailsPanelAgent: AgentAdapter<AppointmentDetailsPanelHandle>;
+//# sourceMappingURL=appointment-details-panel.agent.d.ts.map

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

@@ -0,0 +1,134 @@
+import { type HTMLAttributes } from 'react';
+import type { CalendarEventStatus } from '../calendar';
+import type { AppointmentDetailsChairLabel, AppointmentDetailsHistory, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsState, AppointmentDocumentKind } from './appointment-details-panel.types';
+export interface AppointmentDetailsPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'title' | 'onCopy'> {
+    /** The read, or the shell state while there is none. Pair it with
+     *  `useAppointmentDetailsRead`, which keeps the latest selection. */
+    state: AppointmentDetailsState;
+    /** Retry from the error shell and from a retryable refusal. Without it,
+     *  no Retry button. */
+    onRetry?: () => void;
+    /** The appointment's patient id when the read carries no record: an id
+     *  without a record reads "Patient record not loaded", never "no
+     *  patient". Default `read.patient?.id`. */
+    patientId?: string;
+    /** The operator's label, resolved by the host from
+     *  `appointment.operatorId`. Absent = no operator row. */
+    operator?: AppointmentDetailsOperatorLabel;
+    /** The chair's label. Absent = no chair row. */
+    chair?: AppointmentDetailsChairLabel;
+    /** ISO 4217 code for the money chips, the paid-online row and the
+     *  treatment prices. Default 'EUR'. */
+    currency?: string;
+    /** The practice clock the patient's age is computed against. Default:
+     *  the real clock. */
+    now?: Date | string;
+    /** Locale for dates, times and amounts. Default: the active language. */
+    locale?: string;
+    /** Header title. Default "Appointment details". Ignored under `privacy`,
+     *  so a patient name can never reach the header. */
+    title?: string;
+    /** Privacy mode: the identity is masked; the photo, contact fields,
+     *  chips, description, notes, the booker's contact, the plan name and
+     *  `whatsappUrl` are withheld. Time, operator, chair, status, treatments
+     *  and History stay. A display mask on top of the host's server-side
+     *  masking, never instead of it. */
+    privacy?: boolean;
+    /** The grid's mask for this appointment; bullets without one. Read only
+     *  under `privacy`. */
+    privacyTitle?: string;
+    /** The user's map-link setting (platform `showPatientAddressMapLink`). */
+    mapsLink?: boolean;
+    /** The latest notes of this appointment's patient, and only theirs: set
+     *  `patientId` and notes for another patient show as loading. Without
+     *  it, no notes card. Pass it only when the appointment has a patient. */
+    notesPreview?: AppointmentDetailsNotesPreview;
+    /** Open the host's Notes tool, at one note when a note was clicked.
+     *  Without it, the preview opens nothing. */
+    onOpenNotes?: (noteId?: string) => void;
+    /** The appointment's history, read by the host once History opens.
+     *  Present = the user may read it, so the header offers History. Set its
+     *  `eventId`: entries for another occurrence show as loading. Wins over
+     *  `read.history`, the shortcut for a history sent with the read. */
+    history?: AppointmentDetailsHistory;
+    /** History opened, from its button or the agent: start the host's read.
+     *  Called on every opening. */
+    onOpenHistory?: (eventId: string) => void;
+    /** Withholds Edit, Move, Copy, Delete, the status change and the
+     *  description edit. Join, WhatsApp, Create task and the documents menu
+     *  are the host's to withhold. */
+    readOnly?: boolean;
+    /** Save a new status. Reject with a translated Error: the control keeps
+     *  the old status and shows the message. Absent = status read-only.
+     *  Every handler's last argument is the event id of the read it acted
+     *  on: write to that appointment, never to "the current selection". */
+    onStatusChange?: (status: CalendarEventStatus, eventId: string) => Promise<void>;
+    /** The statuses this user may set, in any order; the menu keeps the
+     *  platform's. Default: all six. The current status is always shown, and
+     *  disabled when not allowed. With no status to move to (an empty list,
+     *  or the current one alone) the status is shown read-only. */
+    allowedStatuses?: readonly CalendarEventStatus[];
+    /** Save a new description from the pencil's sub-view. Reject with a
+     *  translated Error: the sub-view stays open and shows it. Absent = the
+     *  description is read-only. */
+    onDescriptionChange?: (description: string, eventId: string) => Promise<void>;
+    /** Hand over to the host's editor. */
+    onEdit?: (eventId: string) => void;
+    /** Arm the host's move placement. */
+    onMove?: (eventId: string) => void;
+    /** Start the host's copy. With treatments on the read, a menu asks for
+     *  the appointment alone or with its treatments. */
+    onCopy?: (withTreatments: boolean, eventId: string) => void;
+    /** Start the host's delete. The host owns the confirmation, the series
+     *  scope and any care-plan clean-up. */
+    onDelete?: (eventId: string) => void;
+    /** Join the video visit. The host keeps the session code. */
+    onJoinTelehealth?: (eventId: string) => void;
+    /** The host's WhatsApp bridge. Wins over `whatsappUrl` as the one
+     *  button. Withhold it yourself where the user may not message the
+     *  patient. */
+    onWhatsApp?: (eventId: string) => void;
+    /** A host-composed WhatsApp link, opened in a new tab. Withheld under
+     *  `privacy`, because it carries the patient's number. */
+    whatsappUrl?: string;
+    /** Server-built link to the task page, opened in the same tab. */
+    createTaskUrl?: string;
+    /** The create-document kinds the user may use, and what each does. The
+     *  menu keeps the platform's order. */
+    documents?: {
+        kinds: readonly AppointmentDocumentKind[];
+        onCreate: (kind: AppointmentDocumentKind, eventId: string) => void;
+    };
+}
+/** Curated agent handle: ids and enums only, never patient data. */
+export interface AppointmentDetailsPanelHandle {
+    /** The occurrence on screen or being read, or the one a failed or
+     *  refused read was for when the state says; null otherwise. */
+    getEventId: () => string | null;
+    getLoadStatus: () => AppointmentDetailsState['status'];
+    /** The status as last saved here or read; null for none, or no read. */
+    getAppointmentStatus: () => CalendarEventStatus | null;
+    /** The statuses `setAppointmentStatus` accepts now; [] when the status
+     *  cannot be changed. */
+    getAllowedStatuses: () => CalendarEventStatus[];
+    /** The footer's `data-action` values, in footer order. */
+    getOfferedActions: () => string[];
+    isHistoryOpen: () => boolean;
+    isPrivacy: () => boolean;
+    /** Throws when History is not offered. */
+    openHistory: () => void;
+    closeHistory: () => void;
+    /** The footer control's own path: it shows the saving state and any
+     *  refusal. Rejects when the change is not offered, not allowed, or a
+     *  save is in flight, including one started in the same tick. */
+    setAppointmentStatus: (status: CalendarEventStatus) => Promise<void>;
+    /** Throws when no Retry is offered. */
+    retry: () => void;
+}
+/**
+ * The appointment details panel: a props-driven rail panel for one
+ * occurrence. Mount it as a `fill` tool in ControlRoomRail, which adds its
+ * favourite and close controls to the panel's own header.
+ */
+export declare const AppointmentDetailsPanel: import("react").ForwardRefExoticComponent<AppointmentDetailsPanelProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=appointment-details-panel.d.ts.map

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

@@ -0,0 +1,7 @@
+/** Hands focus to `target` only when focus fell to the page: a control that
+ *  held it was removed. Focus the user put elsewhere stays there. */
+export declare function rescueFocus(target: HTMLElement | null | undefined): void;
+/** A heading, made focusable on demand: where focus goes when the control
+ *  that held it leaves the panel or one of its cards. */
+export declare function focusHeading(headingId: string): void;
+//# sourceMappingURL=appointment-details-panel.focus.d.ts.map

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

@@ -0,0 +1,12 @@
+import type { AppointmentHistoryEntry } from './appointment-details-panel.types';
+export interface AppointmentHistoryTimelineProps {
+    /** In any order: the timeline sorts a copy, newest first. */
+    history: readonly AppointmentHistoryEntry[];
+    /** Locale for the stamps. Defaults to the active i18n language. */
+    locale?: string;
+}
+/** One row per history entry. A status change reads as two read-only
+ *  status pills with an accessible "From → To" label; an empty history
+ *  shows "No changes recorded". */
+export declare function AppointmentHistoryTimeline({ history, locale, }: AppointmentHistoryTimelineProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=appointment-details-panel.history.d.ts.map

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

@@ -0,0 +1,41 @@
+import type { CalendarEvent, CalendarEventStatus } from '../calendar';
+import type { AppointmentAnamnesisAnswer } from './appointment-details-panel.types';
+type StatusBadgeVariant = 'success' | 'info' | 'warning' | 'error' | 'accentSoft';
+/** The Badge variant a status wears as a chip, beside the grid card's disc.
+ *  The glyph and the label come from the shared workflow status options. */
+export declare const APPOINTMENT_STATUS_BADGE_VARIANT: Record<CalendarEventStatus, StatusBadgeVariant>;
+/** The card flags the chips spell out. */
+export type IndicatorFlags = Pick<CalendarEvent, 'isBookedOnline' | 'hasUnassignedPatient' | 'hasHighlightedAnamnesis' | 'hasBillableAmount' | 'isTelehealth' | 'isRecurring'>;
+/** Wherever a grid card carries the disc symbols, the peek and the details
+ *  panel spell them out: a glyph and the full label in a semantic Badge,
+ *  in the same tones as the discs. */
+export declare function IndicatorChips({ event }: {
+    event: IndicatorFlags;
+}): import("react/jsx-runtime").JSX.Element | null;
+export interface AppointmentIdentityStripProps {
+    /** The name to show, never blank: the record's, else the appointment's
+     *  title, else "Patient record not loaded". */
+    name: string;
+    avatarSrc?: string;
+    /** Someone is booked but their record did not load: says so once, beside
+     *  the name, so it never reads as "no patient". */
+    unresolved?: boolean;
+    status?: CalendarEventStatus;
+    /** The flags the indicator chips spell out. */
+    flags: IndicatorFlags;
+    /** Completed years, printed beside the name. Absent = no age. */
+    age?: number;
+    /** Set = the name becomes a link-styled button to the patient folder. */
+    onOpenPatient?: () => void;
+    highlightedAnamnesisCount?: number;
+    expiredAnamnesisCount?: number;
+    /** The highlighted answers themselves, listed under the warning. */
+    anamnesisAnswers?: readonly AppointmentAnamnesisAnswer[];
+    /** Locale for the interview dates. Defaults to the active language. */
+    locale?: string;
+}
+/** Identity strip above the details or the editor: avatar, name, status
+ *  badge and chips, the read-at-a-glance layer. */
+export declare function AppointmentIdentityStrip({ name, avatarSrc, unresolved, status, flags, age, onOpenPatient, highlightedAnamnesisCount, expiredAnamnesisCount, anamnesisAnswers, locale, }: AppointmentIdentityStripProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=appointment-details-panel.identity.d.ts.map

package/dist/{patterns/calendar/calendar-info-hover.d.ts → components/appointment-details-panel/appointment-details-panel.info-hover.d.ts}

@@ -29,4 +29,4 @@ export declare function InfoHover({ id, eyebrow, heading, facts, children, }: {
     /** The chip; its visible text is the trigger's accessible name. */
     children: ReactNode;
 }): ReactNode;
-//# sourceMappingURL=calendar-info-hover.d.ts.map
+//# sourceMappingURL=appointment-details-panel.info-hover.d.ts.map

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

@@ -0,0 +1,51 @@
+import { type ReactNode } from 'react';
+import type { AppointmentDetailsChairLabel, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsRead } from './appointment-details-panel.types';
+interface CardProps {
+    details: AppointmentDetailsRead;
+    locale: string;
+    /** ISO 4217 code for every amount. */
+    currency: string;
+}
+/**
+ * The kit's PatientSummaryCard: identity, the attention chips, the money
+ * chips and the contact fields. Every chip explains itself in a hover
+ * card; money reads worst first (owed, to invoice, paid online), labelled
+ * and without glyphs.
+ */
+export declare function DetailsPatientCard({ details, locale, currency, now, mapsLink, }: CardProps & {
+    /** The practice clock the age is computed against. */
+    now: Date | string;
+    /** The user's map-link setting (platform `showPatientAddressMapLink`). */
+    mapsLink?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * When, how long, who and where, the series rule, and what the booking
+ * site recorded. Operator and chair names are the caller's labels, so an
+ * id without one prints no row. `description` is the caller's slot for the
+ * description, above the facts.
+ */
+export declare function DetailsAppointmentCard({ details, locale, currency, operator, chair, description, privacy, }: CardProps & {
+    operator?: AppointmentDetailsOperatorLabel;
+    chair?: AppointmentDetailsChairLabel;
+    description?: ReactNode;
+    /** Privacy mode: what the booker typed is dropped; when they booked stays. */
+    privacy?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/** The linked plan, by number when the host has one, and the kit's
+ *  TreatmentReceipt: one line per treatment, a price only when the host
+ *  sends one (the editor's price gate), and a total only when every line
+ *  is priced. */
+export declare function DetailsTreatmentsCard({ details, locale, currency, privacy, }: CardProps & {
+    /** Privacy mode: the plan's free-text name goes, as on the hover peek. */
+    privacy?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** The patient's latest notes, pinned first, as the host holds them. A
+ *  click on a note opens the Notes tool at it; the header button opens the
+ *  tool from the keyboard. */
+export declare function DetailsNotesCard({ preview, onOpenNotes, locale, }: {
+    preview: AppointmentDetailsNotesPreview;
+    onOpenNotes?: (noteId?: string) => void;
+    locale?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=appointment-details-panel.sections.d.ts.map