@alfadocs/ui-kit 1.25.1-calendar.7 → 1.26.0

package/dist/_chunks/{notes-panel-D4S2VwDx.js → notes-panel-CTNpsByN.js}

@@ -4,7 +4,7 @@ import { c as fe } from "./index-D2ZczOXr.js";
 import { useTranslation as me } from "react-i18next";
 import { u as ge } from "./registry-DvAUVLHh.js";
 import { C as he } from "./clinical-note-card-BBgFd2nB.js";
-import { R as ve } from "./rich-text-editor-VJATL1Tk.js";
+import { R as ve } from "./rich-text-editor-lSCiE0Zz.js";
 import { T as be } from "./text-area-Bt3p7Pt0.js";
 import { B as ye } from "./button-nJaPh_HC.js";
 import { C as xe } from "./checkbox-BuZ1u__2.js";
@@ -350,4 +350,4 @@ const Me = oe(
 export {
   Me as N
 };
-//# sourceMappingURL=notes-panel-D4S2VwDx.js.map
+//# sourceMappingURL=notes-panel-CTNpsByN.js.map

package/dist/_chunks/{patient-details-CdfursHt.js → patient-details-DYAmq76G.js}

@@ -17,8 +17,8 @@ import { S as be } from "./select-Bi8zril7.js";
 import { S as ye } from "./switch-OILsBLWo.js";
 import { T as he } from "./text-area-Bt3p7Pt0.js";
 import { T as ve } from "./text-input-CUvCb6ST.js";
-import { C as xe } from "./country-select-CfDNFG5c.js";
-import { P as Ne } from "./province-select-BaUnkg4S.js";
+import { C as xe } from "./country-select-DzbPFktV.js";
+import { P as Ne } from "./province-select-BBc7s7vR.js";
 import { P as Ce } from "./postal-code-input-BznBxVxf.js";
 import { C as Ve } from "./city-input-DaQc-Hbj.js";
 import { u as we } from "./registry-DvAUVLHh.js";
@@ -757,4 +757,4 @@ export {
   Ae as P,
   Oe as p
 };
-//# sourceMappingURL=patient-details-CdfursHt.js.map
+//# sourceMappingURL=patient-details-DYAmq76G.js.map

package/dist/_chunks/{province-select-BaUnkg4S.js → province-select-BBc7s7vR.js}

@@ -1,7 +1,7 @@
 import { jsx as l } from "react/jsx-runtime";
 import { forwardRef as N, useMemo as p, useCallback as O, useRef as h, useEffect as z } from "react";
 import { useTranslation as U } from "react-i18next";
-import { C as F } from "./combobox-DnSdYssy.js";
+import { C as F } from "./combobox-D7_NLE2Z.js";
 import { u as y } from "./use-controllable-state-BiY4xTzM.js";
 import { u as G } from "./registry-DvAUVLHh.js";
 const w = [
@@ -258,4 +258,4 @@ export {
   k as P,
   _ as p
 };
-//# sourceMappingURL=province-select-BaUnkg4S.js.map
+//# sourceMappingURL=province-select-BBc7s7vR.js.map

package/dist/_chunks/{rich-text-editor-VJATL1Tk.js → rich-text-editor-lSCiE0Zz.js}

@@ -19,7 +19,7 @@ import { a as pt } from "./tooltip-DvmfrNvB.js";
 import { P as q } from "./popover-DP6WCVwm.js";
 import { D as Ae } from "./dropdown-menu-DU-Hrf33.js";
 import { D as B } from "./dialog-UbKJCi1X.js";
-import { C as We } from "./color-picker-Bl5f0iK1.js";
+import { C as We } from "./color-picker-CU303VjY.js";
 import { T as Ie } from "./text-input-CUvCb6ST.js";
 import { C as Xt } from "./checkbox-BuZ1u__2.js";
 import { F as Ut } from "./file-upload-CwxdqkMK.js";
@@ -2626,4 +2626,4 @@ export {
   hn as r,
   Qn as w
 };
-//# sourceMappingURL=rich-text-editor-VJATL1Tk.js.map
+//# sourceMappingURL=rich-text-editor-lSCiE0Zz.js.map

package/dist/_chunks/signature-status-chip-n57D-hhv.js

@@ -0,0 +1,179 @@
+import { jsx as j } from "react/jsx-runtime";
+import { forwardRef as x } from "react";
+import { useTranslation as F } from "react-i18next";
+import { B as G } from "./badge-sTusUqZD.js";
+import { T as P } from "./tooltip-DvmfrNvB.js";
+function B(e) {
+  if (!e || typeof e == "string") return [];
+  const i = e.signedBy;
+  return i ? Array.isArray(i) ? i : [i] : [];
+}
+function d(e, i) {
+  if (e === "notRequired") return "notRequired";
+  const r = B(i).filter((t) => t.standing);
+  return r.length === 0 ? e : r.every((t) => t.standing === "signed") ? "signed" : "pending";
+}
+function M(e, i, r = "notRequired", t) {
+  const g = [
+    d(e, t == null ? void 0 : t.operator),
+    d(i, t == null ? void 0 : t.patient),
+    d(r, t == null ? void 0 : t.secondary)
+  ].filter((l) => l !== "notRequired");
+  if (g.length === 0) return "notRequired";
+  const f = g.filter((l) => l === "signed").length;
+  return f === 0 ? "unsigned" : f === g.length ? "signed" : "partial";
+}
+const K = {
+  // Traffic light: green when everyone required has signed, amber when at
+  // least one party is still missing, red when nobody has.
+  signed: "success",
+  partial: "warning",
+  unsigned: "error",
+  notRequired: "neutral"
+}, Y = {
+  operator: "Operator",
+  patient: "Patient",
+  secondary: "Second signee"
+}, z = {
+  signed: "signed",
+  pending: "pending"
+}, H = {
+  operator: "signatureStatusChip.missingOperator",
+  patient: "signatureStatusChip.missingPatient",
+  secondary: "signatureStatusChip.missingSecondary"
+}, J = {
+  operator: "Operator signature missing",
+  patient: "Patient signature missing",
+  secondary: "Second signee signature missing"
+};
+function S(e) {
+  return `⁨${e}⁩`;
+}
+function Q(e, i, r) {
+  const t = [];
+  return e !== "notRequired" && t.push({ role: "operator", standing: e }), i !== "notRequired" && t.push({ role: "patient", standing: i }), r !== "notRequired" && t.push({ role: "secondary", standing: r }), t;
+}
+const W = x(
+  ({
+    operator: e,
+    patient: i,
+    secondary: r = "notRequired",
+    names: t,
+    size: g = "md",
+    detail: f = !1,
+    tooltip: l = !1,
+    id: v,
+    className: V,
+    "aria-label": D,
+    title: w,
+    ...E
+  }, _) => {
+    const { t: n } = F(), y = M(e, i, r, t), T = Q(
+      d(e, t == null ? void 0 : t.operator),
+      d(i, t == null ? void 0 : t.patient),
+      d(r, t == null ? void 0 : t.secondary)
+    ), p = (() => {
+      switch (y) {
+        case "signed":
+          return n("signatureStatusChip.signed", { defaultValue: "Signed" });
+        case "unsigned":
+          return n("signatureStatusChip.unsigned", {
+            defaultValue: "Not signed"
+          });
+        case "notRequired":
+          return n("signatureStatusChip.notRequired", {
+            defaultValue: "No signature required"
+          });
+        case "partial": {
+          const u = T.filter((a) => a.standing === "pending");
+          if (u.length === 1) {
+            const a = u[0].role;
+            return n(H[a], {
+              defaultValue: J[a]
+            });
+          }
+          return n("signatureStatusChip.missingCount", {
+            defaultValue: "{{count}} signatures missing",
+            count: u.length
+          });
+        }
+      }
+    })(), o = T.map(({ role: u, standing: a }) => {
+      const b = n(`signatureStatusChip.party.${u}`, {
+        defaultValue: Y[u]
+      }), N = n(`signatureStatusChip.state.${a}`, {
+        defaultValue: z[a]
+      }), h = t == null ? void 0 : t[u];
+      if (!h)
+        return n("signatureStatusChip.breakdownItem", {
+          defaultValue: "{{party}} {{state}}",
+          party: b,
+          state: N
+        });
+      const C = typeof h == "string" ? { name: h } : h, q = B(C);
+      if (q.length > 0) {
+        const A = (s) => s.relationship ? n("signatureStatusChip.representative", {
+          defaultValue: "{{name}} ({{relationship}})",
+          name: S(s.name),
+          relationship: s.relationship
+        }) : S(s.name), O = (s) => s.standing ?? a, L = q.filter((s) => O(s) === "signed"), $ = q.filter((s) => O(s) === "pending"), R = [];
+        return L.length > 0 && R.push(
+          n("signatureStatusChip.signedByList", {
+            defaultValue: "signed by {{signers}}",
+            signers: L.map(A).join(", ")
+          })
+        ), $.length > 0 && R.push(
+          n("signatureStatusChip.awaitingList", {
+            defaultValue: "awaiting {{signers}}",
+            signers: $.map(A).join(", ")
+          })
+        ), n("signatureStatusChip.breakdownItemOnBehalf", {
+          defaultValue: "{{party}}: {{name}}, {{detail}}",
+          party: b,
+          name: S(C.name),
+          detail: R.join(", ")
+        });
+      }
+      return n("signatureStatusChip.breakdownItemNamed", {
+        defaultValue: "{{party}}: {{name}} ({{state}})",
+        party: b,
+        name: S(C.name),
+        state: N
+      });
+    }).join(" · "), k = o ? `${p}, ${o}` : p, U = f && o ? `${p} · ${o}` : p, c = l && o.length > 0, m = D ?? (c ? p : k), I = /* @__PURE__ */ j(
+      G,
+      {
+        ref: _,
+        variant: K[y],
+        size: g,
+        withDot: !0,
+        role: "img",
+        "aria-label": m,
+        title: c ? w : w ?? m,
+        tabIndex: c ? 0 : void 0,
+        "data-component": "signature-status-chip",
+        "data-status": y,
+        "data-component-id": v,
+        id: v,
+        className: c ? [
+          "ds:rounded-[var(--radius-full)]",
+          "ds:focus-visible:outline-[length:var(--focus-ring-width)]",
+          "ds:focus-visible:outline-solid",
+          "ds:focus-visible:outline-ring",
+          "ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+          V
+        ].filter(Boolean).join(" ") : V,
+        ...E,
+        children: U
+      }
+    );
+    return c ? /* @__PURE__ */ j(P, { label: o, children: I }) : I;
+  }
+);
+W.displayName = "SignatureStatusChip";
+export {
+  W as S,
+  d as e,
+  M as s
+};
+//# sourceMappingURL=signature-status-chip-n57D-hhv.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.25.1-calendar.7",
+  "packageVersion": "1.26.0",
   "components": [
     {
       "kind": "component",
@@ -17083,14 +17083,13 @@
             "control-room-rail.activeToolId"
           ],
           "apiActions": [
-            "patient.search",
             "appointment.create"
           ]
         },
         {
           "name": "edit_appointment",
           "safety": "phi",
-          "description": "Amend an existing appointment in the docked editor. A remote host first loads canonical data; loading, failure and whole-appointment refusal expose no editable form. 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.",
+          "description": "Amend an existing appointment. Clicking its card docks the SAME panel in details mode — the identity strip, the prefilled form, the read-only extras and the History sub-view — so there is one editing paradigm and no separate Edit jump. Change any field and save; for a member of a repeating series the save asks how far it reaches. On save the rail returns to the Appointments panel and a toast names the day, carrying a \"Go to\" action when that day is off screen, on a hidden weekend or filtered out. Writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.editAppointment",
           "uiActions": [
             "calendar.focus_event",
@@ -17112,8 +17111,6 @@
             "calendar.currentDate"
           ],
           "apiActions": [
-            "appointment.read",
-            "patient.search",
             "appointment.update",
             "appointmentSeries.applyScope"
           ]
@@ -17376,7 +17373,7 @@
         {
           "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. Completing writes patient-identifiable data.",
+          "description": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.triageOnlineBooking",
           "uiActions": [
             "calendar.focus_event",

package/dist/agent-i18n/en.json

@@ -173,7 +173,7 @@
         "dockTool": "Open one of the rail's tools — Appointments, the appointment editor / details panel, the waiting list, the online bookings or the free-slot finder — or read which one is docked. A host declares which of the five it can back with real data, so read the strip rather than assuming all five: a tool the host withheld is absent, and anything routed at it docks Appointments instead. Closing returns to the Appointments panel rather than collapsing the rail, so no path leaves an empty dock. Docking moves no focus; a polite live region announces the panel that arrived.",
         "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.",
         "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. A remote host first loads canonical data; loading, failure and whole-appointment refusal expose no editable form. 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.",
+        "editAppointment": "Amend an existing appointment. Clicking its card docks the SAME panel in details mode — the identity strip, the prefilled form, the read-only extras and the History sub-view — so there is one editing paradigm and no separate Edit jump. Change any field and save; for a member of a repeating series the save asks how far it reaches. On save the rail returns to the Appointments panel and a toast names the day, carrying a \"Go to\" action when that day is off screen, on a hidden weekend or filtered out. 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.",
         "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 (kept even when the appointment recurs, where the platform drops them) and, for a series member, the recurring scope. 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.",
@@ -187,7 +187,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; 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. 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). Read-only until a slot is booked.",
-        "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. Completing writes patient-identifiable data.",
+        "triageOnlineBooking": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. 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."
       }
     },

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-CZ0pEdEI.js";
 export {
   e as AddressFields,
   a as addressFieldsAgent

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

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-CvUFFEdS.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-Z2GaOIYQ.js";
+import { A as p } from "../../_chunks/appointment-card-Dzr3GeVz.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-4FUu_5NX.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   p as AppointmentCard,

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

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

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-B8C7jMrn.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-BtSOKjQu.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/calendar/index.js

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

package/dist/components/color-picker/index.js

@@ -1,4 +1,4 @@
-import { A as T, B as P, C as L, G as a } from "../../_chunks/color-picker-Bl5f0iK1.js";
+import { A as T, B as P, C as L, G as a } from "../../_chunks/color-picker-CU303VjY.js";
 export {
   T as APPOINTMENT_PALETTE,
   P as BRAND_PALETTE,

package/dist/components/combobox/combobox.d.ts

@@ -30,11 +30,6 @@ export interface ComboboxProps<T extends string = string> {
     onCreate?: (value: string) => void;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** Query typed by the user (including IME commits and Clear), or set
-     * through the agent handle. Selection and closing do not emit queries.
-     * Pair with `filter` for host-provided results and `emptyMessage` for
-     * their state. This callback also fires when there are no options. */
-    onQueryChange?: (query: string) => void;
     emptyMessage?: ReactNode;
     'aria-label'?: string;
     /**

package/dist/components/combobox/index.js

@@ -1,4 +1,4 @@
-import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox-DnSdYssy.js";
+import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox-D7_NLE2Z.js";
 export {
   b as Combobox,
   s as comboboxAgent,

package/dist/components/country-select/index.js

@@ -1,4 +1,4 @@
-import { C as o, I as t, a, c as n, r as s } from "../../_chunks/country-select-CfDNFG5c.js";
+import { C as o, I as t, a, c as n, r as s } from "../../_chunks/country-select-DzbPFktV.js";
 export {
   o as CountrySelect,
   t as ISO_3166_ALPHA2,

package/dist/components/face-scheme/index.js

@@ -1,4 +1,4 @@
-import { A as e, F as o, a as n, b as A, c as i, d as f, e as t, I, f as N, g as T, h as F, i as _, j as E, k as c, l as h, m as r, n as p, o as O, p as S, q as m, r as l, s as d, t as C, u as D } from "../../_chunks/face-scheme-l-CQyLs-.js";
+import { A as e, F as o, a as n, b as A, c as i, d as f, e as t, I, f as N, g as T, h as F, i as _, j as E, k as c, l as h, m as r, n as p, o as O, p as S, q as m, r as l, s as d, t as C, u as D } from "../../_chunks/face-scheme-DA2vjqaM.js";
 export {
   e as ANNOTATION_TOOL_KIND,
   o as FACE_ANNOTATION_TOOLS,

package/dist/components/notes-panel/index.js

@@ -1,4 +1,4 @@
-import { N as a } from "../../_chunks/notes-panel-D4S2VwDx.js";
+import { N as a } from "../../_chunks/notes-panel-CTNpsByN.js";
 export {
   a as NotesPanel
 };

package/dist/components/patient-details/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as i } from "../../_chunks/patient-details-CdfursHt.js";
+import { P as e, p as i } from "../../_chunks/patient-details-DYAmq76G.js";
 export {
   e as PatientDetails,
   i as patientDetailsAgent

package/dist/components/province-select/index.js

@@ -1,4 +1,4 @@
-import { I as o, P as r, p as t } from "../../_chunks/province-select-BaUnkg4S.js";
+import { I as o, P as r, p as t } from "../../_chunks/province-select-BBc7s7vR.js";
 export {
   o as IT_PROVINCES,
   r as ProvinceSelect,

package/dist/components/rich-text-editor/index.js

@@ -1,4 +1,4 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-VJATL1Tk.js";
+import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-lSCiE0Zz.js";
 export {
   a as RichTextEditor,
   e as richTextEditorAgent,

package/dist/components/signature-status-chip/index.d.ts

@@ -1,3 +1,3 @@
-export { SignatureStatusChip, signatureStatusOf, } from './signature-status-chip';
-export type { SignatureParty, SignatureStatus, SignatureStatusChipProps, } from './signature-status-chip';
+export { SignatureStatusChip, signatureStatusOf, effectiveStanding, } from './signature-status-chip';
+export type { SignatureParty, SignatureRole, SignerIdentity, SignerRepresentative, SignatureSignerNames, SignatureStatus, SignatureStatusChipProps, } from './signature-status-chip';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/signature-status-chip/index.js

@@ -1,6 +1,7 @@
-import { S as s, s as r } from "../../_chunks/signature-status-chip-DqrPIJtH.js";
+import { S as e, e as s, s as i } from "../../_chunks/signature-status-chip-n57D-hhv.js";
 export {
-  s as SignatureStatusChip,
-  r as signatureStatusOf
+  e as SignatureStatusChip,
+  s as effectiveStanding,
+  i as signatureStatusOf
 };
 //# sourceMappingURL=index.js.map

package/dist/components/signature-status-chip/signature-status-chip.d.ts

@@ -3,17 +3,102 @@ import { type HTMLAttributes } from 'react';
 export type SignatureParty = 'signed' | 'pending' | 'notRequired';
 /** The chip's derived state. */
 export type SignatureStatus = 'signed' | 'partial' | 'unsigned' | 'notRequired';
+/**
+ * The parties a document can require. `secondary` is the second signee on a
+ * two-signee envelope (platform: `secondary_signee_id`) — a guardian, parent
+ * or co-signer. It is optional: a document that does not need one leaves it
+ * `notRequired`, which is the default.
+ */
+export type SignatureRole = 'operator' | 'patient' | 'secondary';
+/**
+ * Who a party is, and — when they cannot sign for themselves — who signs in
+ * their place. A minor, or an adult who lacks capacity, is still the party
+ * the document is about; the parent, guardian or legal representative signs
+ * on their behalf. The standing (`signed` / `pending`) stays on the party,
+ * because it is their signature slot that is being filled.
+ */
+export interface SignerRepresentative {
+    /** The representative's display name. */
+    name: string;
+    /**
+     * Already-translated relationship to the party, e.g. "Mother",
+     * "Legal guardian". Same contract as `SignerRoster.relationship` — the
+     * host translates it, because the set is open.
+     */
+    relationship?: string;
+    /**
+     * This representative's own standing. Supply it when representatives can
+     * be at different stages — both parents must consent and only one has
+     * signed. Omit it and the representative inherits the party's standing,
+     * which is the right default when a single person signs.
+     */
+    standing?: Exclude<SignatureParty, 'notRequired'>;
+}
+export interface SignerIdentity {
+    /** The party's own display name. */
+    name: string;
+    /**
+     * Who signs in this party's place, when the party cannot sign for
+     * themselves. One representative for the ordinary guardian case; several
+     * where every one of them must sign — both parents consenting for a minor,
+     * where the minor never signs at all.
+     *
+     * When representatives carry their own `standing`, they become the source
+     * of truth for this party: the slot is `signed` only once every one of
+     * them has signed. Pass the same values to {@link signatureStatusOf} so
+     * host-side filtering agrees with the chip.
+     */
+    signedBy?: SignerRepresentative | SignerRepresentative[];
+}
+/**
+ * A party's effective standing. Representatives that carry their own
+ * `standing` override the party value, because they are the signatures that
+ * actually have to land: every one of them must sign before the slot is
+ * complete.
+ */
+export declare function effectiveStanding(party: SignatureParty, identity?: string | SignerIdentity): SignatureParty;
+/**
+ * Display names for the signers, when the host has them and chooses to show
+ * them. A bare string is the common case; pass a {@link SignerIdentity} where
+ * someone signs on the party's behalf.
+ */
+export type SignatureSignerNames = Partial<Record<SignatureRole, string | SignerIdentity>>;
 /**
  * The rule, exported so hosts can sort/filter by the same state the chip
  * shows: required = parties not `notRequired`; all signed → `signed`, some
  * signed → `partial`, none signed → `unsigned`, nobody required → `notRequired`.
+ *
+ * `secondary` is optional and defaults to `notRequired`, so existing
+ * two-argument calls keep their exact meaning.
  */
-export declare function signatureStatusOf(operator: SignatureParty, patient: SignatureParty): SignatureStatus;
+export declare function signatureStatusOf(operator: SignatureParty, patient: SignatureParty, secondary?: SignatureParty, names?: SignatureSignerNames): SignatureStatus;
 export interface SignatureStatusChipProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {
     /** The operator's standing. */
     operator: SignatureParty;
     /** The patient's standing. */
     patient: SignatureParty;
+    /**
+     * The second signee's standing on a two-signee envelope — a guardian,
+     * parent or co-signer. Defaults to `notRequired`, so a document with only
+     * an operator and a patient behaves exactly as before.
+     */
+    secondary?: SignatureParty;
+    /**
+     * Display names for the signers, keyed by role. Supply them and the
+     * breakdown reads "Operator: Dr Rossi (signed)" instead of "Operator
+     * signed"; omit them and only the roles are named.
+     *
+     * A role may be a bare name, or a {@link SignerIdentity} when someone
+     * signs on that party's behalf — a parent for a minor, a guardian for an
+     * adult who lacks capacity. Then the row reads "Patient: M. Bianchi,
+     * signed by A. Bianchi (Parent)".
+     *
+     * A name is shown in the chip's accessible name and its hover title, so
+     * pass one only where the viewer is already entitled to see that person —
+     * these are real people, and on the patient row usually a patient. Roles
+     * with no name fall back to the role alone, so a partial map is fine.
+     */
+    names?: SignatureSignerNames;
     /** Chip height — maps onto the Badge `sm` / `md` sizes. */
     size?: 'sm' | 'md';
     /**
@@ -22,6 +107,20 @@ export interface SignatureStatusChipProps extends Omit<HTMLAttributes<HTMLSpanEl
      * always in the accessible name / title.
      */
     detail?: boolean;
+    /**
+     * Make the breakdown reachable by keyboard and touch, not only on hover.
+     *
+     * The chip becomes focusable and the breakdown moves out of the accessible
+     * name into the kit's `Tooltip`, which exposes it as the accessible
+     * description. Screen readers then hear the summary once and the detail
+     * once, instead of the whole string twice.
+     *
+     * Off by default for two reasons. It adds a tab stop, and a table of forty
+     * chips should not add forty; and it **requires a `TooltipProvider` above
+     * it** — without one the kit's Tooltip throws. Turn it on where the
+     * breakdown is something the user has to act on.
+     */
+    tooltip?: boolean;
     /** Agent-readiness consumer id, surfaced as `data-component-id`. */
     id?: string;
 }

package/dist/i18n/locales/ar.d.ts

@@ -2878,10 +2878,23 @@ export declare const arUi: {
         readonly notRequired: "لا يلزم توقيع";
         readonly missingOperator: "توقيع المشغّل مفقود";
         readonly missingPatient: "توقيع المريض مفقود";
+        readonly missingSecondary: "Second signee signature missing";
+        readonly missingCount_zero: "{{count}} signatures missing";
+        readonly missingCount_one: "{{count}} signature missing";
+        readonly missingCount_two: "{{count}} signatures missing";
+        readonly missingCount_few: "{{count}} signatures missing";
+        readonly missingCount_many: "{{count}} signatures missing";
+        readonly missingCount_other: "{{count}} signatures missing";
         readonly breakdownItem: "{{party}}: {{state}}";
+        readonly breakdownItemNamed: "{{party}}: {{name}} ({{state}})";
+        readonly representative: "{{name}} ({{relationship}})";
+        readonly awaitingList: "awaiting {{signers}}";
+        readonly signedByList: "signed by {{signers}}";
+        readonly breakdownItemOnBehalf: "{{party}}: {{name}}, {{detail}}";
         readonly party: {
             readonly operator: "المشغّل";
             readonly patient: "المريض";
+            readonly secondary: "Second signee";
         };
         readonly state: {
             readonly signed: "تم التوقيع";

package/dist/i18n/locales/ar.js

@@ -2852,8 +2852,24 @@ const e = {
     notRequired: "لا يلزم توقيع",
     missingOperator: "توقيع المشغّل مفقود",
     missingPatient: "توقيع المريض مفقود",
+    missingSecondary: "Second signee signature missing",
+    missingCount_zero: "{{count}} signatures missing",
+    missingCount_one: "{{count}} signature missing",
+    missingCount_two: "{{count}} signatures missing",
+    missingCount_few: "{{count}} signatures missing",
+    missingCount_many: "{{count}} signatures missing",
+    missingCount_other: "{{count}} signatures missing",
     breakdownItem: "{{party}}: {{state}}",
-    party: { operator: "المشغّل", patient: "المريض" },
+    breakdownItemNamed: "{{party}}: {{name}} ({{state}})",
+    representative: "{{name}} ({{relationship}})",
+    awaitingList: "awaiting {{signers}}",
+    signedByList: "signed by {{signers}}",
+    breakdownItemOnBehalf: "{{party}}: {{name}}, {{detail}}",
+    party: {
+      operator: "المشغّل",
+      patient: "المريض",
+      secondary: "Second signee"
+    },
     state: { signed: "تم التوقيع", pending: "قيد الانتظار" }
   },
   signature: {