@alfadocs/ui-kit-debug 1.31.0 → 1.33.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.31.0",
+  "packageVersion": "1.33.0",
   "components": [
     {
       "kind": "component",
@@ -11248,7 +11248,20 @@
           "name": "set_value",
           "safety": "write",
           "argsType": "{ value: string }",
-          "description": "Select the radio with the given value.",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string",
+                "description": "Value of the radio to select (its data-option-id)."
+              }
+            },
+            "required": [
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "description": "Select the radio with the given value. A value that matches no enabled radio is ignored.",
           "descriptionKey": "ui.agent.radioGroup.actions.setValue"
         }
       ],
@@ -11914,7 +11927,7 @@
               "note": "Select the \"it\" option."
             }
           ],
-          "description": "Select the option with the given value.",
+          "description": "Select the option with the given value. A value that is not among the options, or belongs to a disabled option, is ignored and the selection stays as it was.",
           "descriptionKey": "ui.agent.select.actions.setValue"
         },
         {
@@ -19411,6 +19424,14 @@
           "component": "document-preview",
           "as": "documentPreviewTool"
         },
+        {
+          "component": "button",
+          "as": "documentsToSign"
+        },
+        {
+          "component": "dialog",
+          "as": "signatureRequestModal"
+        },
         {
           "component": "chat-container",
           "as": "messageThread"
@@ -19739,14 +19760,33 @@
         {
           "name": "request_document_signature",
           "safety": "phi",
-          "description": "Send the selected document out for the patient's signature. The banner's unsigned-documents count is the same signal, so read it to see what is already pending before requesting another. Puts a patient-identifiable document into an outbound signing envelope.",
+          "description": "Send one document out for the patient's signature. A pending document's Request signature row action opens the signature request modal with that document's signed versions table above the request form; for Via QR, the QR step follows in the same dialog (the full contract is signature-request.agent.ts). The banner's unsigned-documents count is the same signal, so read it to see what is already pending before requesting another. Puts a patient-identifiable document into an outbound signing envelope.",
           "descriptionKey": "ui.agent.patientFolder.workflows.requestDocumentSignature",
           "uiActions": [
-            "file-manager.select_items"
+            "file-manager.select_items",
+            "dialog.close"
           ],
           "stateReads": [
             "file-manager.selection",
-            "patient-summary-card.summary"
+            "patient-summary-card.summary",
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "signatureRequest.create"
+          ]
+        },
+        {
+          "name": "request_required_signatures",
+          "safety": "phi",
+          "description": "Ask the patient to sign every outstanding item in one request. The banner's Documents to sign button (a user-driven button with no adapter action) opens the signature request modal in required documents mode: the unsigned documents and anamnesis interviews, each with its own operator picker, one signer roster for the batch, and a link sent outcome after submit. A signer the host marks as under 18 shows a warning that never blocks the request. Read the banner's counts first to know what will be listed.",
+          "descriptionKey": "ui.agent.patientFolder.workflows.requestRequiredSignatures",
+          "uiActions": [
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "patient-summary-card.summary",
+            "dialog.isOpen"
           ],
           "apiActions": [
             "signatureRequest.create"
@@ -21417,25 +21457,70 @@
           "component": "dialog",
           "as": "requestModal"
         },
+        {
+          "component": "skeleton",
+          "as": "signaturesLoading"
+        },
+        {
+          "component": "signature-status-chip",
+          "as": "signatureStatus",
+          "entity": "signature"
+        },
+        {
+          "component": "tooltip",
+          "as": "signerBreakdown",
+          "entity": "signature"
+        },
+        {
+          "component": "icon-button",
+          "as": "viewSignature",
+          "entity": "signature"
+        },
+        {
+          "component": "icon-button",
+          "as": "downloadSignature",
+          "entity": "signature"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "downloadMenu",
+          "entity": "signature"
+        },
+        {
+          "component": "icon-button",
+          "as": "shareSignature",
+          "entity": "signature"
+        },
+        {
+          "component": "dropdown-menu",
+          "as": "shareMenu",
+          "entity": "signature"
+        },
+        {
+          "component": "icon-button",
+          "as": "deleteSignature",
+          "entity": "signature"
+        },
+        {
+          "component": "dialog",
+          "as": "deleteConfirmation",
+          "entity": "signature"
+        },
         {
           "component": "select",
           "as": "operatorSigner"
         },
         {
-          "component": "checkbox",
+          "component": "select",
           "as": "operatorChannel"
         },
-        {
-          "component": "info-tip",
-          "as": "operatorChannelHint"
-        },
         {
           "component": "select",
           "as": "signerPerson",
           "entity": "signer"
         },
         {
-          "component": "checkbox",
+          "component": "select",
           "as": "signerChannel",
           "entity": "signer"
         },
@@ -21444,11 +21529,28 @@
           "as": "otpWaiver",
           "entity": "signer"
         },
+        {
+          "component": "select",
+          "as": "batchChannel"
+        },
+        {
+          "component": "switch",
+          "as": "batchOtpWaiver"
+        },
         {
           "component": "alert",
           "as": "otpWarning",
           "entity": "signer"
         },
+        {
+          "component": "alert",
+          "as": "batchOtpWarning"
+        },
+        {
+          "component": "alert",
+          "as": "minorSignerWarning",
+          "entity": "signer"
+        },
         {
           "component": "alert",
           "as": "submissionError"
@@ -21461,6 +21563,10 @@
           "component": "button",
           "as": "addSigner"
         },
+        {
+          "component": "button",
+          "as": "addSignee"
+        },
         {
           "component": "icon-button",
           "as": "removeSigner",
@@ -21473,13 +21579,149 @@
         {
           "component": "button",
           "as": "close"
+        },
+        {
+          "component": "spinner",
+          "as": "qrPending"
+        },
+        {
+          "component": "qr-code",
+          "as": "signingQrCode",
+          "entity": "signer"
+        },
+        {
+          "component": "alert",
+          "as": "qrMissing",
+          "entity": "signer"
+        },
+        {
+          "component": "button",
+          "as": "qrPrevious"
+        },
+        {
+          "component": "button",
+          "as": "qrNext"
+        },
+        {
+          "component": "button",
+          "as": "qrDone"
+        },
+        {
+          "component": "list",
+          "as": "requiredItemsList",
+          "entity": "requiredItem"
+        },
+        {
+          "component": "skeleton",
+          "as": "requiredItemsLoading"
+        },
+        {
+          "component": "select",
+          "as": "itemOperator",
+          "entity": "requiredItem"
+        },
+        {
+          "component": "select",
+          "as": "itemOperatorChannel",
+          "entity": "requiredItem"
+        },
+        {
+          "component": "button",
+          "as": "assignAllToMe"
+        },
+        {
+          "component": "alert",
+          "as": "assignLaterNote"
+        },
+        {
+          "component": "alert",
+          "as": "operatorChannelNote"
+        },
+        {
+          "component": "button",
+          "as": "buyMoreSignatures"
+        },
+        {
+          "component": "button",
+          "as": "outcomeCancel"
         }
       ],
       "workflows": [
+        {
+          "name": "review_signatures",
+          "safety": "phi",
+          "description": "When the host passes `signatures` (or `signaturesLoading`), the request form shows the document's past signature requests at its top, on the same screen as the operator and signers, as on platform: a table named Signed versions (section data-section=\"signed-versions\") with the columns Date, Signature type and Actions and one row per request (data-signature-id), newest first. Date is the weekday, date and time in the active locale; Signature type is the legal level (Simple or Advanced, hidden with showLegalLevel=false), the channel (SMS, e-mail, WhatsApp, on this device or Via QR) and a SignatureStatusChip whose tooltip names who signed, who is still awaited and who signed on a party's behalf. Loading shows skeleton rows; no records shows one line saying there are no signed versions. Hosts that pass neither prop get the plain form.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.reviewSignatures",
+          "uiActions": [],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "signature.list"
+          ]
+        },
+        {
+          "name": "view_signature",
+          "safety": "phi",
+          "description": "Open one signed document from its row's View button; the host receives onViewSignature(id). The button shows only when the host passes that callback.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.viewSignature",
+          "uiActions": [],
+          "apiActions": [
+            "signature.view"
+          ]
+        },
+        {
+          "name": "download_signature",
+          "safety": "phi",
+          "description": "Download one signed document from its row; the host receives onDownloadSignature(id, 'full' | 'anonymised'). When the record has an anonymised version the Download button opens a menu with Full version and Anonymised version (menu id signature-download-<record id>); otherwise it asks for 'full' directly. The button shows only when the host passes that callback.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.downloadSignature",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": [
+            "signature.download"
+          ]
+        },
+        {
+          "name": "share_signature",
+          "safety": "phi",
+          "description": "Share one signed document from its row's Share menu (menu id signature-share-<record id>): link, e-mail or WhatsApp, in that order. The host receives onShareSignature(id, 'link' | 'email' | 'whatsapp') and does the sharing. The host decides which targets a row offers: the record's shareTargets, else the modal's signatureShareTargets, else all three. The button shows only when the host passes that callback and the row has at least one target.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.shareSignature",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": [
+            "signature.share"
+          ]
+        },
+        {
+          "name": "delete_signature",
+          "safety": "destructive",
+          "description": "Delete one signed document from its row's Delete button. It opens a confirmation, an alert dialog (dialog id signature-delete-<record id>) asking whether to delete this signed document, with the row's date under the question and Cancel and Delete. Only Delete calls onDeleteSignature(id); the host deletes and drops the record. Cancel, Esc or dialog.close / dialog.dismiss close it without deleting, and focus returns to the row's Delete button. Once the host drops the record, focus moves to the next row's first action (else the previous row's, else the line saying there are no signed versions) and a polite status says the signature was deleted. The button shows only when the host passes that callback.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.deleteSignature",
+          "uiActions": [
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "signature.delete"
+          ]
+        },
         {
           "name": "assign_operator",
           "safety": "write",
-          "description": "Pick the operator who must counter-sign (or \"Assign later\" to leave the request unassigned). \"Assign to me\" claims it for the signed-in operator.",
+          "description": "Pick the operator who must counter-sign (or \"Assign later\" to leave the request unassigned). The operators are listed in host order, then \"Assign later\". An operator the host marks disabled shows greyed out with the host's reason under the name (the trigger is described by every greyed-out operator and reason) and cannot be picked; set_value refuses them. An operator the host marks deleted is listed only while they are the current value, and is never seeded. \"Assign to me\" claims it for the signed-in operator.",
           "descriptionKey": "ui.agent.signatureRequest.workflows.assignOperator",
           "uiActions": [
             "select.set_value"
@@ -21492,7 +21734,7 @@
         {
           "name": "manage_signer_roster",
           "safety": "write",
-          "description": "Build the patient-side signer roster: pick who signs in each row (the patient or their configured signee, e.g. a legal guardian), add a second signer up to the cap, or remove a row. People already on the roster are excluded from the other rows.",
+          "description": "Build the patient-side signer roster: pick who signs in each row (the patient or their configured signee, e.g. a legal guardian), add a second signer up to the cap, or remove a row. People already on the roster are excluded from the other rows; set_value with one of them, or anyone not offered in that row, leaves the row unchanged. In required documents mode the roster signs the whole batch: the main signer (row data-signer-role=\"main\"), then at most one second signee (data-signer-role=\"second\", a group named Second signee). The second signee is offered only when every listed item is a document that can carry a second signature (anamnesis interviews never can), the main signer's channel is on this device (the batch channel with channelMode batch, else the main signer's own row), and the main signer is a registered signee, not the patient (isPatient); otherwise Add signer is disabled and a visible line says why. The patient is never offered as the second signee. Changing the main signer removes the second signee, announced via a live region. Moving the main signer's channel off this device only hides them (they are not submitted) and announces why; back on this device they return. Per signer, the second signee has their own channel beside their name. A second signee who is the main signer again, is no longer on offer, or cannot receive their own channel (the batch channel in batch mode) shows a message under their row (data-note=\"second-signee-issue\") and keeps Request signature disabled. When the host marks a person as under 18 (isMinor), their row shows a warning note (data-note=\"minor-signer\") to check whether a second signee is needed; it never blocks the request, and the kit does not compute age. In required documents mode, while the patient has no registered signee (no signer option without isPatient) and the host passes onAddSignee, a link-style Add signatory button under the Patient signers heading calls it; it is user-driven with no adapter action, and the host adds the new person to signerOptions.",
           "descriptionKey": "ui.agent.signatureRequest.workflows.manageSignerRoster",
           "uiActions": [
             "select.set_value"
@@ -21505,20 +21747,20 @@
         {
           "name": "choose_delivery_channel",
           "safety": "write",
-          "description": "Choose how each signer's request is delivered via the per-row channel checkboxes (mutually exclusive — checking one channel unchecks the others): SMS, e-mail, WhatsApp, or signing on this device. On-device signers sign sequentially in roster order. The assigned operator has the same mutually exclusive checkboxes with SMS, e-mail, or on this device — the operator's own system-defined channel arrives pre-checked, and the on-device option is enabled only while a patient signer also signs on this device (an info tip explains the greyed-out state; an automatic fallback to the operator's default is announced via a live region when the last on-device patient row leaves).",
+          "description": "Choose how each signer's request is delivered in the channel dropdown beside their name, a select named Signature channel (one choice): SMS, e-mail, WhatsApp, signing on this device, or via QR (the signer scans a QR code the dialog shows in its QR step after the request; offered to every patient-side signer by default). Each signer row (data-signer-id) holds its dropdown, with the id signature-request-signer-channel-<row number>; the operator dropdown's id is signature-request-operator-channel. Each option carries data-option-id with the channel; set_value with a channel the dropdown does not offer or has disabled leaves the choice unchanged. A signer's available channels can hide any of these, Via QR included. A signer's unavailableChannels instead show a channel greyed out with the host's reason under it (e.g. SMS and WhatsApp with No mobile number): set_value refuses it, the row never falls back to it, and a signer with no channel left shows the reasons under the row and keeps Request signature disabled. On-device signers sign sequentially in roster order. The assigned operator has the same dropdown, named Operator signature channel, with SMS, e-mail, or on this device and never Via QR: the operator's own system-defined channel (defaultChannel, from their settings) arrives preselected and follows a newly picked operator, while a channel changed by hand is kept until the operator changes; the on-device option is enabled only while a patient signer also signs on this device (while disabled, its reason shows under the option and describes the trigger; an automatic fallback to the operator's default is announced via a live region when the last on-device patient row leaves). A host can replace that rule with resolveChannels: it receives the choices after every channel change (and on open) and returns the channels to use and to offer, e.g. the operator and the patient on this device together; set_value may then move another person's channel too (the operator or another signer), announced via the same live region. Channels are per signer by default, in the request form and in required documents mode. With channelMode batch there is no channel beside each name: one labelled Signature channel select (id signature-request-batch-channel) under the signers heading sets the channel for the whole roster, with SMS, e-mail, WhatsApp and Via QR offered when the main signer or the patient (isPatient) can receive them, greyed out only when neither can, and on this device always offered. It starts on e-mail, or SMS when the main signer is the patient and can receive it, unless the host passes initialBatchChannel; in required documents mode changing the main signer returns it to that default (initialBatchChannel is read only on open), announced via the live region. resolveChannels receives the batch channel as every signer's channel and moves the batch through the main signer's returned channel. In required documents mode with showOperatorChannels, each item with an assigned operator also has that operator's channel select (SMS, e-mail or on this device), named Operator signature channel for <item name> with the id signature-request-item-operator-channel-<item id>; it starts on the operator's defaultChannel and follows a newly picked operator (Assign to me included), keeping a channel changed by hand until then. Items on Assign later have none.",
           "descriptionKey": "ui.agent.signatureRequest.workflows.chooseDeliveryChannel",
           "uiActions": [
-            "checkbox.set_checked"
+            "select.set_value"
           ],
           "stateReads": [
-            "checkbox.checked"
+            "select.value"
           ],
           "apiActions": []
         },
         {
           "name": "waive_otp",
           "safety": "write",
-          "description": "Toggle a signer's on-device OTP waiver. Waiving OTP lowers the evidentiary value of that signature; the pattern surfaces a warning alert while waived.",
+          "description": "Toggle a signer's on-device OTP waiver. Waiving OTP lowers the evidentiary value of that signature; the pattern surfaces a warning alert while waived. With channelMode batch there is one switch for the whole roster (Do not require OTP from the patient), shown only while the batch channel is on this device: it starts on when the patient cannot receive SMS, whoever the main signer is, and is on and disabled when the main signer is the patient and cannot receive SMS. The choice resets when the batch channel changes. Its warning (batchOtpWarning) is one batch-level alert outside every signer row; as on platform it shows while the waiver is on, and on every channel while it is forced. Per signer in required documents mode, the main signer's own switch follows the same rules (starts on, or on and disabled, described by the warning) and resets when that row's channel changes; other rows are the user's choice.",
           "descriptionKey": "ui.agent.signatureRequest.workflows.waiveOtp",
           "uiActions": [
             "switch.toggle",
@@ -21532,14 +21774,13 @@
         {
           "name": "request_signature",
           "safety": "phi",
-          "description": "Send the signature request. Notifies every roster signer over their selected channel and hands the submission to the host.",
+          "description": "Send the signature request. Notifies every roster signer over their selected channel and hands the submission to the host. When any signer chose Via QR the dialog stays open and moves to its QR step. With channelMode batch the submission carries signMode (the batch channel, also on every signer). In required documents mode it also carries operatorAssignments (item id to operator id, null for assign later), requiredItemIds and, with showOperatorChannels, operatorChannels (item id to the operator's channel, for assigned items), with operatorChannel null; the main signer OTP waiver is skipOtp on the main signer, set only on this device.",
           "descriptionKey": "ui.agent.signatureRequest.workflows.requestSignature",
           "uiActions": [
             "dialog.close"
           ],
           "stateReads": [
             "select.value",
-            "checkbox.checked",
             "switch.checked",
             "dialog.isOpen"
           ],
@@ -21547,6 +21788,61 @@
             "signature.request"
           ]
         },
+        {
+          "name": "show_qr_code",
+          "safety": "phi",
+          "description": "After a request with a signer on the Via QR channel, the same dialog shows its QR step: a loading state until the host passes the server-issued links, then one code per QR signer with the signer name and expiry (the code or its error carries data-signer-id). With several QR signers, the user moves between codes with Previous and Next (\"1 of 2\"); Done on the last code tells the host the codes were handed over (onQrDone) and closes the dialog. Previous, Next and Done are user-driven buttons with no adapter action. Closing through dialog.close, or dismissing the waiting state with dialog.dismiss, does not fire onQrDone. A QR signer with no link shows an error in place of the code. The operator is never offered Via QR.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.showQrCode",
+          "uiActions": [
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "qr-code.value",
+            "dialog.isOpen"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "review_required_items",
+          "safety": "phi",
+          "description": "When the host passes `requiredItems` (or `requiredItemsLoading`), the form asks one patient to sign every outstanding item in one batch: documents to sign and anamnesis interviews to complete, as two lists named with their counts. Each row (data-required-item-id) shows the item name only, with no signing status: the documents API of the host says only whether an item is signed. Items marked signed are left out; when none is left the dialog shows the all signed outcome. Loading shows skeleton rows. The single operator row and the signed versions table do not appear in this mode.",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.reviewRequiredItems",
+          "uiActions": [],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": [
+            "signature.listRequired"
+          ]
+        },
+        {
+          "name": "assign_item_operators",
+          "safety": "write",
+          "description": "In required documents mode, pick the operator for each item that needs an operator signature (requiresOperator), or \"Assign later\", listed first. Each picker is named \"Operator for <item name>\" and has the id signature-request-item-operator-<item id>. Greyed-out and deleted operators follow the same rules as the single operator picker: a disabled operator shows its reason and set_value refuses them, a deleted one shows only in a picker still assigned to them. \"Assign to me\" (shown when the host passes currentOperatorId) sets every picker to the signed-in operator; it is a user-driven button with no adapter action. An info note shows while any picker is on Assign later, and another says each operator receives the request by e-mail or SMS per their own settings, unless the host passes showOperatorChannels: then each assigned item shows its operator's channel instead (see choose_delivery_channel).",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.assignItemOperators",
+          "uiActions": [
+            "select.set_value"
+          ],
+          "stateReads": [
+            "select.value"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "show_outcome",
+          "safety": "read",
+          "description": "When the host passes `outcome`, the dialog replaces every other view with a final screen whose heading and description carry the message, and focus moves to the heading: 'linkSent' (the secure link went out; in required documents mode the heading says the documents were sent to the patient), 'allSigned' (nothing left to sign) or 'creditsExhausted' (no electronic signature documents left). Close ends it; on 'creditsExhausted' a Buy more documents button calls onBuyMoreSignatures when the host passes it, and a Cancel button, when the host passes onOutcomeCancel, returns the dialog to the form and calls it so the host clears outcome (both user-driven, no adapter action).",
+          "descriptionKey": "ui.agent.signatureRequest.workflows.showOutcome",
+          "uiActions": [
+            "dialog.close",
+            "dialog.dismiss"
+          ],
+          "stateReads": [
+            "dialog.isOpen"
+          ],
+          "apiActions": []
+        },
         {
           "name": "dismiss",
           "safety": "destructive",

package/dist/agent-i18n/en.json

@@ -1160,7 +1160,7 @@
         "value": "Currently selected radio value, or empty string when none."
       },
       "actions": {
-        "setValue": "Select the radio with the given value."
+        "setValue": "Select the radio with the given value. A value that matches no enabled radio is ignored."
       }
     },
     "radiographPanel": {
@@ -1243,7 +1243,7 @@
         "isOpen": "Whether the option list is open."
       },
       "actions": {
-        "setValue": "Select the option with the given value.",
+        "setValue": "Select the option with the given value. A value that is not among the options, or belongs to a disabled option, is ignored and the selection stays as it was.",
         "clear": "Clear the current selection.",
         "open": "Open the option list.",
         "close": "Close the option list."
@@ -1792,7 +1792,8 @@
         "uploadDocument": "Upload one or more files into the open folder of the patient's document tree. Writes a patient-identifiable document.",
         "organiseDocuments": "Reorganise the document tree: create a folder, rename an item, or move the selected items into another folder. Only one of these action dialogs can be in flight at a time — read the active action before starting another. Reversible through the same toolbar.",
         "deleteDocuments": "Delete the selected files or folders from the patient's document tree. Deleting a folder takes everything nested beneath it. Not reversible from this surface — read the selection first and confirm.",
-        "requestDocumentSignature": "Send the selected document out for the patient's signature. The banner's unsigned-documents count is the same signal, so read it to see what is already pending before requesting another. Puts a patient-identifiable document into an outbound signing envelope.",
+        "requestDocumentSignature": "Send one document out for the patient's signature. A pending document's Request signature row action opens the signature request modal with that document's signed versions table above the request form; for Via QR, the QR step follows in the same dialog (the full contract is signature-request.agent.ts). The banner's unsigned-documents count is the same signal, so read it to see what is already pending before requesting another. Puts a patient-identifiable document into an outbound signing envelope.",
+        "requestRequiredSignatures": "Ask the patient to sign every outstanding item in one request. The banner's Documents to sign button (a user-driven button with no adapter action) opens the signature request modal in required documents mode: the unsigned documents and anamnesis interviews, each with its own operator picker, one signer roster for the batch, and a link sent outcome after submit. A signer the host marks as under 18 shows a warning that never blocks the request. Read the banner's counts first to know what will be listed.",
         "shareDocuments": "Share the selected documents with the patient. The shared files then appear as a document-share bubble in the Communications thread. Sends patient-identifiable documents out of the practice.",
         "readMessageThread": "Read the per-patient message thread in the Communications tab — App, SMS, Email and inbound WhatsApp messages in one chronological log, with SMS delivery status and campaign / workflow / document-share provenance on each bubble — and scroll back to the latest message. Read-only.",
         "composeMessage": "Draft a message to the patient: pick the outbound channel (App, SMS or Email — WhatsApp is inbound-only and never offered) and type the body. On SMS the composer counts GSM/Unicode segments including the appended practice sender name, so read the draft back before sending a long one. Nothing leaves the practice until the draft is submitted.",
@@ -1911,11 +1912,20 @@
     },
     "signatureRequest": {
       "workflows": {
-        "assignOperator": "Pick the operator who must counter-sign (or \"Assign later\" to leave the request unassigned). \"Assign to me\" claims it for the signed-in operator.",
-        "manageSignerRoster": "Build the patient-side signer roster: pick who signs in each row (the patient or their configured signee, e.g. a legal guardian), add a second signer up to the cap, or remove a row. People already on the roster are excluded from the other rows.",
-        "chooseDeliveryChannel": "Choose how each signer's request is delivered via the per-row channel checkboxes (mutually exclusive — checking one channel unchecks the others): SMS, e-mail, WhatsApp, or signing on this device. On-device signers sign sequentially in roster order. The assigned operator has the same mutually exclusive checkboxes with SMS, e-mail, or on this device — the operator's own system-defined channel arrives pre-checked, and the on-device option is enabled only while a patient signer also signs on this device (an info tip explains the greyed-out state; an automatic fallback to the operator's default is announced via a live region when the last on-device patient row leaves).",
-        "waiveOtp": "Toggle a signer's on-device OTP waiver. Waiving OTP lowers the evidentiary value of that signature; the pattern surfaces a warning alert while waived.",
-        "requestSignature": "Send the signature request. Notifies every roster signer over their selected channel and hands the submission to the host.",
+        "reviewSignatures": "When the host passes `signatures` (or `signaturesLoading`), the request form shows the document's past signature requests at its top, on the same screen as the operator and signers, as on platform: a table named Signed versions (section data-section=\"signed-versions\") with the columns Date, Signature type and Actions and one row per request (data-signature-id), newest first. Date is the weekday, date and time in the active locale; Signature type is the legal level (Simple or Advanced, hidden with showLegalLevel=false), the channel (SMS, e-mail, WhatsApp, on this device or Via QR) and a SignatureStatusChip whose tooltip names who signed, who is still awaited and who signed on a party's behalf. Loading shows skeleton rows; no records shows one line saying there are no signed versions. Hosts that pass neither prop get the plain form.",
+        "viewSignature": "Open one signed document from its row's View button; the host receives onViewSignature(id). The button shows only when the host passes that callback.",
+        "downloadSignature": "Download one signed document from its row; the host receives onDownloadSignature(id, 'full' | 'anonymised'). When the record has an anonymised version the Download button opens a menu with Full version and Anonymised version (menu id signature-download-<record id>); otherwise it asks for 'full' directly. The button shows only when the host passes that callback.",
+        "shareSignature": "Share one signed document from its row's Share menu (menu id signature-share-<record id>): link, e-mail or WhatsApp, in that order. The host receives onShareSignature(id, 'link' | 'email' | 'whatsapp') and does the sharing. The host decides which targets a row offers: the record's shareTargets, else the modal's signatureShareTargets, else all three. The button shows only when the host passes that callback and the row has at least one target.",
+        "deleteSignature": "Delete one signed document from its row's Delete button. It opens a confirmation, an alert dialog (dialog id signature-delete-<record id>) asking whether to delete this signed document, with the row's date under the question and Cancel and Delete. Only Delete calls onDeleteSignature(id); the host deletes and drops the record. Cancel, Esc or dialog.close / dialog.dismiss close it without deleting, and focus returns to the row's Delete button. Once the host drops the record, focus moves to the next row's first action (else the previous row's, else the line saying there are no signed versions) and a polite status says the signature was deleted. The button shows only when the host passes that callback.",
+        "assignOperator": "Pick the operator who must counter-sign (or \"Assign later\" to leave the request unassigned). The operators are listed in host order, then \"Assign later\". An operator the host marks disabled shows greyed out with the host's reason under the name (the trigger is described by every greyed-out operator and reason) and cannot be picked; set_value refuses them. An operator the host marks deleted is listed only while they are the current value, and is never seeded. \"Assign to me\" claims it for the signed-in operator.",
+        "manageSignerRoster": "Build the patient-side signer roster: pick who signs in each row (the patient or their configured signee, e.g. a legal guardian), add a second signer up to the cap, or remove a row. People already on the roster are excluded from the other rows; set_value with one of them, or anyone not offered in that row, leaves the row unchanged. In required documents mode the roster signs the whole batch: the main signer (row data-signer-role=\"main\"), then at most one second signee (data-signer-role=\"second\", a group named Second signee). The second signee is offered only when every listed item is a document that can carry a second signature (anamnesis interviews never can), the main signer's channel is on this device (the batch channel with channelMode batch, else the main signer's own row), and the main signer is a registered signee, not the patient (isPatient); otherwise Add signer is disabled and a visible line says why. The patient is never offered as the second signee. Changing the main signer removes the second signee, announced via a live region. Moving the main signer's channel off this device only hides them (they are not submitted) and announces why; back on this device they return. Per signer, the second signee has their own channel beside their name. A second signee who is the main signer again, is no longer on offer, or cannot receive their own channel (the batch channel in batch mode) shows a message under their row (data-note=\"second-signee-issue\") and keeps Request signature disabled. When the host marks a person as under 18 (isMinor), their row shows a warning note (data-note=\"minor-signer\") to check whether a second signee is needed; it never blocks the request, and the kit does not compute age. In required documents mode, while the patient has no registered signee (no signer option without isPatient) and the host passes onAddSignee, a link-style Add signatory button under the Patient signers heading calls it; it is user-driven with no adapter action, and the host adds the new person to signerOptions.",
+        "chooseDeliveryChannel": "Choose how each signer's request is delivered in the channel dropdown beside their name, a select named Signature channel (one choice): SMS, e-mail, WhatsApp, signing on this device, or via QR (the signer scans a QR code the dialog shows in its QR step after the request; offered to every patient-side signer by default). Each signer row (data-signer-id) holds its dropdown, with the id signature-request-signer-channel-<row number>; the operator dropdown's id is signature-request-operator-channel. Each option carries data-option-id with the channel; set_value with a channel the dropdown does not offer or has disabled leaves the choice unchanged. A signer's available channels can hide any of these, Via QR included. A signer's unavailableChannels instead show a channel greyed out with the host's reason under it (e.g. SMS and WhatsApp with No mobile number): set_value refuses it, the row never falls back to it, and a signer with no channel left shows the reasons under the row and keeps Request signature disabled. On-device signers sign sequentially in roster order. The assigned operator has the same dropdown, named Operator signature channel, with SMS, e-mail, or on this device and never Via QR: the operator's own system-defined channel (defaultChannel, from their settings) arrives preselected and follows a newly picked operator, while a channel changed by hand is kept until the operator changes; the on-device option is enabled only while a patient signer also signs on this device (while disabled, its reason shows under the option and describes the trigger; an automatic fallback to the operator's default is announced via a live region when the last on-device patient row leaves). A host can replace that rule with resolveChannels: it receives the choices after every channel change (and on open) and returns the channels to use and to offer, e.g. the operator and the patient on this device together; set_value may then move another person's channel too (the operator or another signer), announced via the same live region. Channels are per signer by default, in the request form and in required documents mode. With channelMode batch there is no channel beside each name: one labelled Signature channel select (id signature-request-batch-channel) under the signers heading sets the channel for the whole roster, with SMS, e-mail, WhatsApp and Via QR offered when the main signer or the patient (isPatient) can receive them, greyed out only when neither can, and on this device always offered. It starts on e-mail, or SMS when the main signer is the patient and can receive it, unless the host passes initialBatchChannel; in required documents mode changing the main signer returns it to that default (initialBatchChannel is read only on open), announced via the live region. resolveChannels receives the batch channel as every signer's channel and moves the batch through the main signer's returned channel. In required documents mode with showOperatorChannels, each item with an assigned operator also has that operator's channel select (SMS, e-mail or on this device), named Operator signature channel for <item name> with the id signature-request-item-operator-channel-<item id>; it starts on the operator's defaultChannel and follows a newly picked operator (Assign to me included), keeping a channel changed by hand until then. Items on Assign later have none.",
+        "waiveOtp": "Toggle a signer's on-device OTP waiver. Waiving OTP lowers the evidentiary value of that signature; the pattern surfaces a warning alert while waived. With channelMode batch there is one switch for the whole roster (Do not require OTP from the patient), shown only while the batch channel is on this device: it starts on when the patient cannot receive SMS, whoever the main signer is, and is on and disabled when the main signer is the patient and cannot receive SMS. The choice resets when the batch channel changes. Its warning (batchOtpWarning) is one batch-level alert outside every signer row; as on platform it shows while the waiver is on, and on every channel while it is forced. Per signer in required documents mode, the main signer's own switch follows the same rules (starts on, or on and disabled, described by the warning) and resets when that row's channel changes; other rows are the user's choice.",
+        "requestSignature": "Send the signature request. Notifies every roster signer over their selected channel and hands the submission to the host. When any signer chose Via QR the dialog stays open and moves to its QR step. With channelMode batch the submission carries signMode (the batch channel, also on every signer). In required documents mode it also carries operatorAssignments (item id to operator id, null for assign later), requiredItemIds and, with showOperatorChannels, operatorChannels (item id to the operator's channel, for assigned items), with operatorChannel null; the main signer OTP waiver is skipOtp on the main signer, set only on this device.",
+        "showQrCode": "After a request with a signer on the Via QR channel, the same dialog shows its QR step: a loading state until the host passes the server-issued links, then one code per QR signer with the signer name and expiry (the code or its error carries data-signer-id). With several QR signers, the user moves between codes with Previous and Next (\"1 of 2\"); Done on the last code tells the host the codes were handed over (onQrDone) and closes the dialog. Previous, Next and Done are user-driven buttons with no adapter action. Closing through dialog.close, or dismissing the waiting state with dialog.dismiss, does not fire onQrDone. A QR signer with no link shows an error in place of the code. The operator is never offered Via QR.",
+        "reviewRequiredItems": "When the host passes `requiredItems` (or `requiredItemsLoading`), the form asks one patient to sign every outstanding item in one batch: documents to sign and anamnesis interviews to complete, as two lists named with their counts. Each row (data-required-item-id) shows the item name only, with no signing status: the documents API of the host says only whether an item is signed. Items marked signed are left out; when none is left the dialog shows the all signed outcome. Loading shows skeleton rows. The single operator row and the signed versions table do not appear in this mode.",
+        "assignItemOperators": "In required documents mode, pick the operator for each item that needs an operator signature (requiresOperator), or \"Assign later\", listed first. Each picker is named \"Operator for <item name>\" and has the id signature-request-item-operator-<item id>. Greyed-out and deleted operators follow the same rules as the single operator picker: a disabled operator shows its reason and set_value refuses them, a deleted one shows only in a picker still assigned to them. \"Assign to me\" (shown when the host passes currentOperatorId) sets every picker to the signed-in operator; it is a user-driven button with no adapter action. An info note shows while any picker is on Assign later, and another says each operator receives the request by e-mail or SMS per their own settings, unless the host passes showOperatorChannels: then each assigned item shows its operator's channel instead (see choose_delivery_channel).",
+        "showOutcome": "When the host passes `outcome`, the dialog replaces every other view with a final screen whose heading and description carry the message, and focus moves to the heading: 'linkSent' (the secure link went out; in required documents mode the heading says the documents were sent to the patient), 'allSigned' (nothing left to sign) or 'creditsExhausted' (no electronic signature documents left). Close ends it; on 'creditsExhausted' a Buy more documents button calls onBuyMoreSignatures when the host passes it, and a Cancel button, when the host passes onOutcomeCancel, returns the dialog to the form and calls it so the host clears outcome (both user-driven, no adapter action).",
         "dismiss": "Close the modal without sending a signature request. Discards the in-progress operator, roster, channel, and OTP choices."
       }
     },

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

@@ -1,4 +1,4 @@
-import { A as e } from "../../_chunks/agenda-card-pdN49pMu.js";
+import { A as e } from "../../_chunks/agenda-card-DVz3jwTf.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-BweO8pDo.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-1oDWCJdB.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

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

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

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-D-oj_ugh.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-DCk8gHod.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-CymGHyIP.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-DXG6LTtO.js";
+import { A as r, a } from "../../_chunks/audio-recorder-11wClczr.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

package/dist/components/avatar/avatar.d.ts

@@ -6,6 +6,8 @@ export declare function nameToColorClass(name: string): string;
  * Extracts 1–2 uppercase initials:
  * - Single-word name: first two characters  ("John" → "JO")
  * - Multi-word name: first char of first word + first char of last word  ("John Doe" → "JD")
+ * - Parenthesised or bracketed parts and words with no letter are skipped
+ *   ("Lucy Danvers (daughter)" → "LD"), unless nothing else is left.
  */
 export declare function getInitials(name: string): string;
 declare const avatarVariants: (props?: ({

package/dist/components/avatar/avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA8DlE,8HAA8H;AAC9H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAID,QAAA,MAAM,cAAc;;8EAiCnB,CAAC;AAIF,MAAM,WAAW,WACf,SACE,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,EAC9C,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,eAAO,MAAM,MAAM,yGAwGlB,CAAC"}
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA8DlE,8HAA8H;AAC9H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYhD;AAID,QAAA,MAAM,cAAc;;8EAiCnB,CAAC;AAIF,MAAM,WAAW,WACf,SACE,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,EAC9C,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,eAAO,MAAM,MAAM,yGAwGlB,CAAC"}