@alfadocs/ui-kit 1.50.1 → 1.52.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.50.1",
+  "packageVersion": "1.52.0",
   "components": [
     {
       "kind": "component",
@@ -4340,7 +4340,8 @@
       "id": "dropdown-menu",
       "capabilities": [
         "open",
-        "close"
+        "close",
+        "set_value"
       ],
       "state": [
         {
@@ -4348,6 +4349,12 @@
           "type": "boolean",
           "description": "True when the menu is currently open.",
           "descriptionKey": "ui.agent.dropdownMenu.state.isOpen"
+        },
+        {
+          "name": "settings",
+          "type": "Array<{ setting: string; kind: \"choice\" | \"switch\"; value?: string; options?: string[]; checked?: boolean; disabled: boolean }>",
+          "description": "The menu's named settings rows and their current values: choice rows with the selected value and every option's value, switch rows with whether they are on. Rows are listed only while the menu is open; open it first to read them.",
+          "descriptionKey": "ui.agent.dropdownMenu.state.settings"
         }
       ],
       "actions": [
@@ -4364,6 +4371,81 @@
           "idempotent": true,
           "description": "Close the menu.",
           "descriptionKey": "ui.agent.dropdownMenu.actions.close"
+        },
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ setting: string; value: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "setting": {
+                "type": "string",
+                "description": "The row's name (its data-setting attribute)."
+              },
+              "value": {
+                "type": "string",
+                "description": "One of the row's option values."
+              }
+            },
+            "required": [
+              "setting",
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "errors": [
+            "No choice row with that name in this menu",
+            "The value is not one of the options, or it or the row is disabled"
+          ],
+          "examples": [
+            {
+              "args": {
+                "setting": "slotDensity",
+                "value": "comfortable"
+              },
+              "note": "Calendar display settings: switch to comfortable rows."
+            }
+          ],
+          "description": "Pick an option on a named choice row (ChoiceSub), as clicking it would. A closed menu opens for the moment and closes again.",
+          "descriptionKey": "ui.agent.dropdownMenu.actions.setValue"
+        },
+        {
+          "name": "set_checked",
+          "safety": "write",
+          "argsType": "{ setting: string; checked: boolean }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "setting": {
+                "type": "string",
+                "description": "The row's name (its data-setting attribute)."
+              },
+              "checked": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "setting",
+              "checked"
+            ]
+          },
+          "idempotent": true,
+          "errors": [
+            "No switch row with that name in this menu",
+            "The row is disabled"
+          ],
+          "examples": [
+            {
+              "args": {
+                "setting": "zebraRows",
+                "checked": true
+              },
+              "note": "Calendar display settings: turn zebra rows on."
+            }
+          ],
+          "description": "Turn a named switch row (SwitchItem) on or off, as clicking it would. A closed menu opens for the moment and closes again.",
+          "descriptionKey": "ui.agent.dropdownMenu.actions.setChecked"
         }
       ],
       "domHooks": {
@@ -4375,6 +4457,11 @@
           "attr": "data-component-id",
           "sourceProp": "id",
           "description": "Sourced from the id prop on DropdownMenu.Root."
+        },
+        "item": {
+          "attr": "data-setting",
+          "sourceProp": "name",
+          "description": "On a ChoiceSub or SwitchItem row given a name: the setting that set_value / set_checked address."
         }
       }
     },
@@ -16937,21 +17024,9 @@
           "as": "toolbarIcon"
         },
         {
-          "component": "popover",
+          "component": "dropdown-menu",
           "as": "displaySettings"
         },
-        {
-          "component": "select",
-          "as": "displayChoice"
-        },
-        {
-          "component": "switch",
-          "as": "displayToggle"
-        },
-        {
-          "component": "number-input",
-          "as": "defaultDuration"
-        },
         {
           "component": "date-picker",
           "as": "jumpToDate"
@@ -17193,13 +17268,9 @@
           "entity": "appointment"
         },
         {
-          "component": "popover",
+          "component": "dropdown-menu",
           "as": "backlogSettings"
         },
-        {
-          "component": "switch",
-          "as": "backlogGapToggle"
-        },
         {
           "component": "collapsible",
           "as": "finderFilters"
@@ -17283,21 +17354,17 @@
         {
           "name": "configure_display",
           "safety": "write",
-          "description": "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, whether the details panel offers the map link, the row density (compact or comfortable), the colour strength of the cards (tinted or solid), and whether cards show the operator or chair from the other axis. The same popover holds the appointment icon legend. 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.",
+          "description": "Set the per-user display knobs in the cog's settings menu (each setting's row shows its current value and opens a submenu of options; on/off settings are switch rows; the last item resets to the defaults) — 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 (a preset from 10 to 60 minutes, or the value already saved), whether operators read as an initials disc or a dot plus full name, whether chairs read as a full name or a short code, whether the details panel offers the map link, the row density (compact or comfortable), the colour strength of the cards (tinted or solid), and whether cards show the operator or chair from the other axis. The same menu holds the appointment icon legend as a submenu. An agent drives the menu with instance id calendar-display-settings: set_value with a choice row's name (orientation, slotDensity, window, slotDuration, eventColorStyle, colorAssociation, careDescription, operatorNameDisplay, chairNameDisplay, defaultDurationMin) and one of its option values, or set_checked with a switch row's name (zebraRows, showTime, showCardContext, mapsLink); the menu opens for the moment when closed. The settings state lists each row's name, value and options while the menu is open. 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.",
           "descriptionKey": "ui.agent.calendar.workflows.configureDisplay",
           "uiActions": [
-            "popover.open",
-            "popover.close",
-            "select.set_value",
-            "switch.set_checked",
-            "switch.toggle",
-            "number-input.set_value"
+            "dropdown-menu.open",
+            "dropdown-menu.close",
+            "dropdown-menu.set_value",
+            "dropdown-menu.set_checked"
           ],
           "stateReads": [
-            "popover.isOpen",
-            "select.value",
-            "switch.checked",
-            "number-input.value"
+            "dropdown-menu.isOpen",
+            "dropdown-menu.settings"
           ],
           "apiActions": [
             "calendarPreference.update"
@@ -17726,20 +17793,18 @@
         {
           "name": "triage_online_booking",
           "safety": "phi",
-          "description": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. A host addresses one booking with the focusBookingId prop (bump focusBookingKey to repeat it): the tool docks, then the card carrying that data-booking-id takes focus and aria-current; an id outside the queue addresses nothing. An Assign patient or Assign operator segment opens the editor focused on that field. A settings cog in the panel header (data-backlog-settings) opens a popover holding three switches — without a patient, without an operator, without a chair, the chair one only where the practice has chairs — all on by default; a card stays listed while at least one of its own gaps is still switched on. Read the cog before reading the list: while any switch is off it carries data-narrowed and its accessible name says the list is filtered, so a short queue is not an empty backlog. Selection only; completing writes patient-identifiable data.",
+          "description": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. A host addresses one booking with the focusBookingId prop (bump focusBookingKey to repeat it): the tool docks, then the card carrying that data-booking-id takes focus and aria-current; an id outside the queue addresses nothing. An Assign patient or Assign operator segment opens the editor focused on that field. A settings cog in the panel header (data-backlog-settings) opens a menu (instance id calendar-backlog-settings) of three switch rows — withoutPatient, withoutOperator, withoutChair, the chair one only where the practice has chairs — all on by default, then a Reset row that switches them all back on; set_checked with the name of a row flips it; a card stays listed while at least one of its own gaps is still switched on. Read the cog before reading the list: while any switch is off it carries data-narrowed and its accessible name says the list is filtered, so a short queue is not an empty backlog. Selection only; completing writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.triageOnlineBooking",
           "uiActions": [
             "calendar.focus_event",
             "control-room-rail.open",
-            "popover.open",
-            "popover.close",
-            "switch.set_checked",
-            "switch.toggle"
+            "dropdown-menu.open",
+            "dropdown-menu.close",
+            "dropdown-menu.set_checked"
           ],
           "stateReads": [
             "control-room-rail.activeToolId",
-            "popover.isOpen",
-            "switch.checked"
+            "dropdown-menu.isOpen"
           ],
           "apiActions": [
             "onlineBooking.list",

package/dist/agent-i18n/en.json

@@ -186,7 +186,7 @@
         "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, 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, whether the details panel offers the map link, the row density (compact or comfortable), the colour strength of the cards (tinted or solid), and whether cards show the operator or chair from the other axis. The same popover holds the appointment icon legend. 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.",
+        "configureDisplay": "Set the per-user display knobs in the cog's settings menu (each setting's row shows its current value and opens a submenu of options; on/off settings are switch rows; the last item resets to the defaults) — 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 (a preset from 10 to 60 minutes, or the value already saved), whether operators read as an initials disc or a dot plus full name, whether chairs read as a full name or a short code, whether the details panel offers the map link, the row density (compact or comfortable), the colour strength of the cards (tinted or solid), and whether cards show the operator or chair from the other axis. The same menu holds the appointment icon legend as a submenu. An agent drives the menu with instance id calendar-display-settings: set_value with a choice row's name (orientation, slotDensity, window, slotDuration, eventColorStyle, colorAssociation, careDescription, operatorNameDisplay, chairNameDisplay, defaultDurationMin) and one of its option values, or set_checked with a switch row's name (zebraRows, showTime, showCardContext, mapsLink); the menu opens for the moment when closed. The settings state lists each row's name, value and options while the menu is open. 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. 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 (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.",
@@ -207,7 +207,7 @@
         "manageWaitingListEntry": "Add, amend or remove a waiting-list entry. The four-field form opens as a rail SUB-VIEW — from the toolbar split button's plus segment, from Add entry, or from a row's pencil — with a back arrow to the queue. Editing is refused on a row already linked to an appointment, because those fields belong to the appointment; the pencil stays focusable and names that reason. Remove deletes at once with no confirmation, platform parity, and its toast carries an Undo that puts the entry back. Writes patient-identifiable data.",
         "scheduleWaitingPatient": "Give a waiting patient a slot. \"Schedule\" on an unlinked row hands off to the free-slot finder seeded from the entry — operator, chair, duration, patient, care and colour already filled in — and booking a slot opens the editor carrying the entry, so saving books the appointment and takes the entry off the list. A row already linked to an appointment reads \"Reschedule\" and seeds the same finder, but booking there MOVES the existing appointment rather than creating a second one. Writes patient-identifiable data.",
         "findFreeSlot": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; when the viewer may write appointments, a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care; read-only viewers see the list and projection only, under a lock note, with no Book. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Projected bands open a modal list of original options by click, Enter or Space; only an explicit Book action uses the finder booking path. Read-only viewers can scroll those options without Book. Dismissal restores focus to the band.",
-        "triageOnlineBooking": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. A host addresses one booking with the focusBookingId prop (bump focusBookingKey to repeat it): the tool docks, then the card carrying that data-booking-id takes focus and aria-current; an id outside the queue addresses nothing. An Assign patient or Assign operator segment opens the editor focused on that field. A settings cog in the panel header (data-backlog-settings) opens a popover holding three switches — without a patient, without an operator, without a chair, the chair one only where the practice has chairs — all on by default; a card stays listed while at least one of its own gaps is still switched on. Read the cog before reading the list: while any switch is off it carries data-narrowed and its accessible name says the list is filtered, so a short queue is not an empty backlog. Selection only; completing writes patient-identifiable data.",
+        "triageOnlineBooking": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. A host addresses one booking with the focusBookingId prop (bump focusBookingKey to repeat it): the tool docks, then the card carrying that data-booking-id takes focus and aria-current; an id outside the queue addresses nothing. An Assign patient or Assign operator segment opens the editor focused on that field. A settings cog in the panel header (data-backlog-settings) opens a menu (instance id calendar-backlog-settings) of three switch rows — withoutPatient, withoutOperator, withoutChair, the chair one only where the practice has chairs — all on by default, then a Reset row that switches them all back on; set_checked with the name of a row flips it; a card stays listed while at least one of its own gaps is still switched on. Read the cog before reading the list: while any switch is off it carries data-narrowed and its accessible name says the list is filtered, so a short queue is not an empty backlog. Selection only; completing writes patient-identifiable data.",
         "printDaySheet": "Print the front-desk call sheet. The toolbar's printer icon opens a dialog asking which day — one day, never the visible range — and Print renders that day's appointments through the browser, scoped by the filters in force and masked when privacy mode is on. Nothing is sent to a server, but the sheet itself is a patient-identifiable document."
       }
     },
@@ -507,11 +507,14 @@
     },
     "dropdownMenu": {
       "state": {
-        "isOpen": "True when the menu is currently open."
+        "isOpen": "True when the menu is currently open.",
+        "settings": "The menu's named settings rows and their current values: choice rows with the selected value and every option's value, switch rows with whether they are on. Rows are listed only while the menu is open; open it first to read them."
       },
       "actions": {
         "open": "Open the menu.",
-        "close": "Close the menu."
+        "close": "Close the menu.",
+        "setValue": "Pick an option on a named choice row (ChoiceSub), as clicking it would. A closed menu opens for the moment and closes again.",
+        "setChecked": "Turn a named switch row (SwitchItem) on or off, as clicking it would. A closed menu opens for the moment and closes again."
       }
     },
     "dueDateCalculator": {

package/dist/components/_shared/date-locale.d.ts

@@ -1,9 +1,9 @@
 import type { Locale } from 'date-fns';
-/** Resolve a date-fns locale by kit language code. Falls back to enUS. */
+/** Resolve a date-fns locale by kit language code. Base English and the fallback use enGB; en-US stays regional. */
 export declare function getDateFnsLocale(lang: string): Promise<Locale>;
 /** Subscribe a component to its date-fns locale. Returns `undefined` while
  *  the dynamic-import resolves; date-fns and react-day-picker both treat
- *  `undefined` as "use enUS defaults", so the UI degrades gracefully. */
+ *  `undefined` as English defaults; callers wait before rendering the calendar. */
 export declare function useDateFnsLocale(lang: string): Locale | undefined;
 /** Get short date format string for a locale. */
 export declare function getShortDateFormat(lang: string): string;

package/dist/components/_shared/day-picker-labels.d.ts

@@ -0,0 +1,6 @@
+import type { TFunction } from 'i18next';
+import type { Labels } from 'react-day-picker';
+/** The date-fns locale alone does not translate DayPicker's default ARIA prose. */
+export declare function useDayPickerLabels(): Partial<Labels>;
+export declare function buildDayPickerLabels(t: TFunction<'ui'>, language: string): Partial<Labels>;
+//# sourceMappingURL=day-picker-labels.d.ts.map

package/dist/components/_shared/entity-card/entity-card.d.ts

@@ -10,7 +10,7 @@ type BadgeVariant = NonNullable<BadgeProps['variant']>;
  */
 export declare const entitySurfaceVariants: (props?: ({
     surface?: "elevated" | "flat" | null | undefined;
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 /** Care-plan lifecycle state → Badge variant. */
 export declare const CARE_PLAN_STATE_BADGE: {

package/dist/components/_shared/intl-locale.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A BCP 47 tag that `Intl` accepts for a UI language. Hosts may report
+ * `it_IT`, which `Intl` rejects with a RangeError; an unusable tag falls
+ * back to English rather than breaking the render.
+ */
+export declare function canonicalLocale(language: string): string;
+/** The kit's formatting tag: base English is British and base Portuguese
+ * European, matching the date-fns locales the kit loads. */
+export declare function formatLocale(language: string): string;
+//# sourceMappingURL=intl-locale.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-Dp5uMvKP.js";
+import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-BVLoHU3E.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-QfC-N3pw.js";
+import { A as e, a } from "../../_chunks/address-fields-UiEXHxEX.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-CjjxlA9K.js";
+import { A as e } from "../../_chunks/agenda-card-CakEvwnM.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-BhZASyJm.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-C-_iu6Fo.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-C-kz_RrY.js";
+import { A as i } from "../../_chunks/ai-credits-notice-Da0fJPXO.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-BRZeS3mT.js";
+import { A as e, a as o } from "../../_chunks/ai-permission-notice-C5q_uHBA.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-CxvnXsAs.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-IObcUWqB.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

package/dist/components/alert/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/alert-CiQ5Pa3Q.js";
+import { A as o } from "../../_chunks/alert-BhCstf2h.js";
 export {
   o as Alert
 };

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

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

package/dist/components/anamnesis-summary-card/anamnesis-summary-card.d.ts

@@ -2,7 +2,7 @@ import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const rootVariants: (props?: ({
     surface?: "elevated" | "flat" | "bare" | null | undefined;
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface AnamnesisSummaryAnswer {
     /** Stable key (the intake field key). */

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

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

package/dist/components/annotation-marker/index.js

@@ -1,4 +1,4 @@
-import { A as o, M as t, m as A } from "../../_chunks/annotation-marker-CsUJGZjQ.js";
+import { A as o, M as t, m as A } from "../../_chunks/annotation-marker-D-M7y4R1.js";
 export {
   o as AnnotationMarker,
   t as MARKER_SHAPES,

package/dist/components/app-frame/index.js

@@ -1,4 +1,4 @@
-import { A as a } from "../../_chunks/app-frame-DIEMIC5V.js";
+import { A as a } from "../../_chunks/app-frame-Cos-GSfw.js";
 export {
   a as AppFrame
 };

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

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

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

@@ -54,6 +54,9 @@ export interface AppointmentDetailsPanelProps extends Omit<HTMLAttributes<HTMLDi
     /** History opened, from its button or the agent: start the host's read.
      *  Called on every opening. */
     onOpenHistory?: (eventId: string) => void;
+    /** In History, say "What changed was not recorded." under an edit that
+     *  carries no detail. Off by default. */
+    noteUnrecordedEdits?: boolean;
     /** 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. */

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

@@ -1,12 +1,26 @@
-import type { AppointmentHistoryEntry } from './appointment-details-panel.types';
+import type { AppointmentHistoryChange, 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;
+    /** Say "What changed was not recorded." under an edit that carries no
+     *  fields and no changes. Off by default: such an edit shows only its
+     *  title, as before. Turn it on once the host records changes, so the
+     *  older entries read as incomplete rather than empty. */
+    noteUnrecordedEdits?: boolean;
+    /** Privacy mode, as on the details cards: a patient or care change
+     *  names the field but not its values. */
+    privacy?: boolean;
 }
-/** 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;
+/** Every change an entry carries: the kind's own (a move's time, a
+ *  resize's duration, a status) first, then any further changes from the
+ *  same save, each field once. */
+export declare function historyChanges(entry: AppointmentHistoryEntry): AppointmentHistoryChange[];
+/** One row per history entry, reading what happened as exactly as the host
+ *  recorded it: a title naming the change, then each value before and
+ *  after (a status as two read-only pills). An edit recorded without
+ *  detail can say so (`noteUnrecordedEdits`); an empty history shows "No
+ *  changes recorded". */
+export declare function AppointmentHistoryTimeline({ history, locale, noteUnrecordedEdits, privacy, }: AppointmentHistoryTimelineProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=appointment-details-panel.history.d.ts.map

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

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import type { AppointmentDetailsChairLabel, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsRead } from './appointment-details-panel.types';
+import type { AppointmentDetailsChairLabel, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsRead, AppointmentHistoryEntry } from './appointment-details-panel.types';
 interface CardProps {
     details: AppointmentDetailsRead;
     locale: string;
@@ -24,12 +24,16 @@ export declare function DetailsPatientCard({ details, locale, currency, now, map
  * 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 & {
+export declare function DetailsAppointmentCard({ details, locale, currency, operator, chair, description, privacy, history, }: CardProps & {
     operator?: AppointmentDetailsOperatorLabel;
     chair?: AppointmentDetailsChairLabel;
     description?: ReactNode;
     /** Privacy mode: what the booker typed is dropped; when they booked stays. */
     privacy?: boolean;
+    /** The history the user may see, as the panel resolved it (the host's
+     *  own read, else the read's). Absent while withheld or not yet read:
+     *  then no "Created by" row. */
+    history?: readonly AppointmentHistoryEntry[];
 }): 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

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

@@ -63,8 +63,52 @@ export type AppointmentRecurrenceFrequency = 'daily' | 'weekly' | 'monthly' | 'q
 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 value an edit changed, before and after, so the history can say
+ * exactly what happened. The kit formats status (platform
+ * `DoctorAppointment.state`, the same six codes), time (`date`) and
+ * duration (`duration`, minutes) itself. `fromIso` / `toIso` take the
+ * appointment's zone-less wall clock, like `appointment.startIso`, or an
+ * instant with a zone; both show in the reader's local time. Every other
+ * field arrives as the host's display text, resolved when the history is
+ * read so it follows the reader's language and patient permissions:
+ * patient (`doctorPatient`), type (`type`: in practice or telehealth),
+ * care (the appointment's name, which the editor edits as care), operator
+ * (`doctorOperator`), chair (`chairId`, by name). Colour (`doctorColor`)
+ * has no name on the platform, only hex values: send the hex and the kit
+ * shows a swatch. A side is absent when the field was empty: first set (a
+ * status set for the first time has no `from`), or cleared.
+ *
+ * `changes` may cover only some of an edit's `fields`: the rest still show,
+ * named without values. In privacy mode the kit shows a patient or care
+ * change by its field name only.
+ *
+ * The platform does not record these yet: `doctor_action` stores which
+ * action ran, who and when (its `details` column is never written for
+ * appointments), so today's entries carry no changes and the kit shows
+ * what it has.
+ */
+export type AppointmentHistoryChange = {
+    field: 'status';
+    from?: CalendarEventStatus;
+    to?: CalendarEventStatus;
+} | {
+    field: 'time';
+    fromIso?: string;
+    toIso?: string;
+} | {
+    field: 'duration';
+    fromMin?: number;
+    toMin?: number;
+} | {
+    field: Exclude<AppointmentHistoryField, 'time' | 'duration'>;
+    from?: string;
+    to?: string;
+};
 /** One history line: who did what to the appointment, and when. `atIso` is
- *  an instant, with a zone. */
+ *  an instant, with a zone. A change entry may list further `changes` made
+ *  in the same save (a drop onto another chair's column moves the time and
+ *  the chair at once). */
 export type AppointmentHistoryEntry = {
     id: string;
     atIso: string;
@@ -75,17 +119,23 @@ export type AppointmentHistoryEntry = {
     kind: 'moved';
     fromIso: string;
     toIso: string;
+    changes?: AppointmentHistoryChange[];
 } | {
     kind: 'resized';
     fromMin: number;
     toMin: number;
+    changes?: AppointmentHistoryChange[];
 } | {
     kind: 'status';
     from: CalendarEventStatus;
     to: CalendarEventStatus;
+    changes?: AppointmentHistoryChange[];
 } | {
     kind: 'edited';
+    /** Which fields changed, when the host knows no more than that. */
     fields: AppointmentHistoryField[];
+    /** What each changed from and to, when the host recorded it. */
+    changes?: AppointmentHistoryChange[];
 } | {
     kind: 'deleted';
 }

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

@@ -3,6 +3,6 @@ export type { AppointmentDetailsPanelProps, AppointmentDetailsPanelHandle, } fro
 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 type { AppointmentDetailsRead, AppointmentDetailsHistory, AppointmentDetailsPatient, AppointmentDetailsState, AppointmentDetailsSnapshot, AppointmentDetailsLoader, UseAppointmentDetailsReadOptions, AppointmentDetailsNotesPreview, AppointmentDetailsOperatorLabel, AppointmentDetailsChairLabel, AppointmentHistoryEntry, AppointmentHistoryKind, AppointmentHistoryField, AppointmentHistoryChange, 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

@@ -1,4 +1,4 @@
-import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-5-hV-2xA.js";
+import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-YsuJgYeB.js";
 export {
   e as AppointmentDetailsPanel,
   n as appointmentDetailsPanelAgent,

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

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/appointment-peek-Dk11UOVW.js";
+import { A as o } from "../../_chunks/appointment-peek-DpPzeYXm.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-wQ-PdkFV.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-BZErHbD1.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-DZBtAvLH.js";
+import { A as r, a } from "../../_chunks/audio-recorder-BafA28cX.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

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

@@ -1,4 +1,4 @@
-import { A as r } from "../../_chunks/audio-visualiser-l6zPd0AG.js";
+import { A as r } from "../../_chunks/audio-visualiser-CK2JyQW1.js";
 export {
   r as AudioVisualiser
 };