@alfadocs/ui-kit 0.68.0 → 0.69.0

package/dist/agent-i18n/en.json

@@ -0,0 +1,1175 @@
+{
+  "agent": {
+    "accordion": {
+      "state": {
+        "openItems": "Ids (values) of currently-expanded items. Single-mode accordions return an array with 0 or 1 entries."
+      },
+      "actions": {
+        "expand": "Expand the item with the given value.",
+        "collapse": "Collapse the item with the given value.",
+        "clear": "Collapse all items. Only meaningful for multi-mode accordions; single-mode equivalent to collapsing the active item."
+      }
+    },
+    "addressAutocomplete": {
+      "state": {
+        "value": "Current free-text value of the address input.",
+        "query": "Current query driving the suggestion listbox.",
+        "isOpen": "True when the suggestion listbox is visible."
+      },
+      "actions": {
+        "setValue": "Set the input text programmatically; opens and refreshes the suggestion list (issues an external address-lookup fetch).",
+        "applyFilter": "Set the query text, which refreshes the suggestion list via an external address-lookup fetch.",
+        "clear": "Clear the typed text and dismiss the suggestion list.",
+        "open": "Open the suggestion listbox.",
+        "close": "Close the suggestion listbox."
+      }
+    },
+    "agendaTray": {
+      "state": {
+        "items": "Currently-displayed appointments. Ids + status only — never patient identity."
+      },
+      "actions": {
+        "selectItem": "Activate the appointment with the given id."
+      }
+    },
+    "aiConsentBanner": {
+      "state": {
+        "consentState": "Current consent state. Structural only — never the grantee identity.",
+        "armed": "Whether the consent confirmation checkbox is ticked (required state only)."
+      }
+    },
+    "aiPromptInput": {
+      "state": {
+        "value": "Current text in the composer (no PHI processing).",
+        "isEmpty": "True when the composer has no text and no attachments.",
+        "isSubmitting": "True while an onSubmit invocation is in flight (best-effort)."
+      },
+      "actions": {
+        "setValue": "Replace the composer text with the given value.",
+        "clear": "Clear text and attachments. Irreversible from the same UI.",
+        "submit": "Submit the current composer state via onSubmit.",
+        "focus": "Move keyboard focus into the textarea."
+      }
+    },
+    "appointmentTray": {
+      "state": {
+        "items": "Currently-displayed appointments. Ids + lifecycle state only — never patient identity."
+      },
+      "actions": {
+        "selectItem": "Activate the appointment with the given id."
+      }
+    },
+    "audioRecorder": {
+      "state": {
+        "isRecording": "True while actively capturing audio (not paused).",
+        "duration": "Elapsed recording time in milliseconds (paused time excluded).",
+        "hasRecording": "True when a completed recording is available for submission."
+      },
+      "actions": {
+        "startRecording": "Request microphone permission and begin recording.",
+        "stopRecording": "Stop the current recording and finalise the blob.",
+        "discard": "Cancel the recording. Irreversible — the captured audio is dropped.",
+        "submit": "Stop the active recording, finalising it via onRecordingComplete."
+      }
+    },
+    "autocomplete": {
+      "state": {
+        "value": "Currently-selected option value, or null when nothing is committed.",
+        "query": "Current free-text query in the input.",
+        "isOpen": "True when the suggestion list is visible."
+      },
+      "actions": {
+        "setValue": "Set the committed value programmatically.",
+        "applyFilter": "Set the input query, which filters the suggestion list.",
+        "clear": "Clear the committed value and the query. Discards the typed input.",
+        "open": "Open the suggestion list.",
+        "close": "Close the suggestion list."
+      }
+    },
+    "bishopScore": {
+      "state": {
+        "selection": "The five cervical-exam findings keyed by component (dilation, effacement, station, consistency, position). Each value is an enumerated option key, not free text.",
+        "result": "Computed Bishop result — total (0–13) and favourability band (unfavourable / intermediate / favourable). Null until all five findings are set."
+      },
+      "actions": {
+        "setValue": "Set one cervical-exam finding to an enumerated option value. Unknown component/value pairs are ignored.",
+        "reset": "Clear all five findings and the computed result.",
+        "getResult": "Return the computed Bishop result, or null until all five findings are set."
+      }
+    },
+    "bmiCalculator": {
+      "state": {
+        "unitSystem": "Active unit system the inputs are entered in.",
+        "inputs": "Canonical metric measurements regardless of the active unit system — height in centimetres and weight in kilograms, or null when unset.",
+        "result": "Computed BMI (kg/m²) and WHO category (underweight / normal / overweight / obese). Null until both height and weight are valid."
+      },
+      "actions": {
+        "setValue": "Set height (cm) and/or weight (kg) in canonical metric units. Omitted fields are left unchanged.",
+        "setUnitSystem": "Switch the input unit system. Entered figures are preserved by conversion; the computed BMI is unchanged.",
+        "reset": "Clear height and weight and the computed result.",
+        "getResult": "Return the computed BMI + WHO category, or null until both inputs are valid."
+      }
+    },
+    "booking": {
+      "state": {
+        "variant": "Active variant — one of `inline-list`, `accordion`, `calendar`, `flexible`, `progress`."
+      },
+      "actions": {
+        "reset": "Clear the booking value back to an empty state. Use to abandon an in-progress flow.",
+        "gotoStep": "Jump to the given step. Implementations may clamp to the first incomplete step if the requested one is not reachable yet."
+      }
+    },
+    "breadcrumb": {
+      "state": {
+        "items": "Ordered list of crumb ids + hrefs in display order. Labels are intentionally excluded — they may contain PHI."
+      },
+      "actions": {
+        "navigateTo": "Activate the crumb with the given id — equivalent to clicking the link."
+      }
+    },
+    "calendar": {
+      "state": {
+        "currentView": "Active view name (e.g. dayGridMonth, timeGridWeek).",
+        "currentDate": "ISO date anchor of the visible range.",
+        "currentTitle": "Human title of the current range (e.g. \"April 2026\")."
+      },
+      "actions": {
+        "today": "Jump to the current day.",
+        "prev": "Move to the previous range.",
+        "next": "Move to the next range.",
+        "gotoDate": "Navigate to a specific date.",
+        "changeView": "Switch the calendar to the given view.",
+        "focusEvent": "Scroll an event into view and briefly highlight it."
+      }
+    },
+    "carePlanCard": {
+      "state": {
+        "state": "The plan lifecycle state. Enum value only — never the localised label or any PHI.",
+        "progress": "Line progress as done / total counts. Counts only — never treatment names or operator identity."
+      }
+    },
+    "carePlanEntryCard": {
+      "state": {
+        "done": "Whether the treatment line is marked executed.",
+        "phaseProgress": "Phase progress as executed / total counts. Counts only — never phase labels or operator identity."
+      }
+    },
+    "carousel": {
+      "state": {
+        "activeIndex": "Zero-based index of the currently snapped slide.",
+        "count": "Total slide count."
+      },
+      "actions": {
+        "scrollTo": "Scroll to the slide at the given index.",
+        "scrollPrev": "Scroll to the previous slide.",
+        "scrollNext": "Scroll to the next slide."
+      }
+    },
+    "chart": {
+      "actions": {
+        "updateSeries": "Replace the chart series without remounting.",
+        "exportPng": "Return a PNG data URI of the chart for export or screenshotting."
+      }
+    },
+    "chatContainer": {
+      "actions": {
+        "scrollToBottom": "Scroll the conversation viewport to the latest message."
+      }
+    },
+    "chatInput": {
+      "state": {
+        "value": "Current text in the composer.",
+        "isEmpty": "True when the composer has no text."
+      },
+      "actions": {
+        "setValue": "Replace the composer text.",
+        "clear": "Clear the composer. Irreversible from the same UI.",
+        "submit": "Submit the current composer state via onSubmit.",
+        "focus": "Move keyboard focus into the textarea."
+      }
+    },
+    "checkboxGroup": {
+      "state": {
+        "selection": "Values of currently-checked options."
+      },
+      "actions": {
+        "setSelection": "Replace the current selection with the given option values.",
+        "clearSelection": "Uncheck every option in the group."
+      }
+    },
+    "checkbox": {
+      "state": {
+        "checked": "Current checked state."
+      },
+      "actions": {
+        "setChecked": "Set the checked state to a specific value.",
+        "toggle": "Flip the checked state between checked and unchecked."
+      }
+    },
+    "clinicalNoteCard": {
+      "state": {
+        "noteId": "Stable identifier of the rendered note, when supplied.",
+        "pinned": "Whether the note is pinned to the top of the timeline.",
+        "flagged": "Whether the note is flagged for follow-up.",
+        "attachmentKind": "Structural kind the note is attached to. Never the attachment identity or content."
+      }
+    },
+    "collapsible": {
+      "state": {
+        "isOpen": "True when the content panel is expanded."
+      },
+      "actions": {
+        "toggle": "Toggle between open and closed.",
+        "open": "Expand the content panel.",
+        "close": "Collapse the content panel."
+      }
+    },
+    "colorPicker": {
+      "state": {
+        "value": "Currently picked colour as a hex string (e.g. \"#3b82f6\")."
+      },
+      "actions": {
+        "setValue": "Set the picked colour from a hex string."
+      }
+    },
+    "combobox": {
+      "state": {
+        "value": "Currently-selected option value, or null when nothing is selected.",
+        "query": "Current filter query in the combobox input.",
+        "isOpen": "True when the option list is visible."
+      },
+      "actions": {
+        "setValue": "Set the selected value programmatically.",
+        "applyFilter": "Set the filter query for the option list.",
+        "clearSelection": "Clear the current selection.",
+        "open": "Open the option list.",
+        "close": "Close the option list."
+      }
+    },
+    "commandPalette": {
+      "state": {
+        "query": "Current filter query in the command palette input.",
+        "isOpen": "True when the palette is visible."
+      },
+      "actions": {
+        "open": "Open the command palette.",
+        "close": "Close the command palette.",
+        "applyFilter": "Set the filter query."
+      }
+    },
+    "contactProfileCard": {
+      "state": {
+        "profession": "Profession string the card is currently rendering — undefined when the consumer omitted it."
+      }
+    },
+    "copyField": {
+      "state": {
+        "value": "The value displayed in the read-only field.",
+        "copied": "True for the brief window after a successful copy."
+      },
+      "actions": {
+        "copy": "Programmatically trigger the clipboard write."
+      }
+    },
+    "dataTable": {
+      "state": {
+        "selection": "Row ids of currently-selected rows.",
+        "filter": "Current ag-grid filter model, keyed by column id.",
+        "sort": "Active sort, in priority order.",
+        "currentPage": "Zero-indexed page number."
+      },
+      "actions": {
+        "selectRows": "Replace the current selection with the given row ids.",
+        "selectRange": "Select every row between fromId and toId, inclusive, in current sort order.",
+        "clearSelection": "Deselect all rows.",
+        "getSelection": "Return the row ids of the currently-selected rows.",
+        "applyFilter": "Replace the filter model with the given object.",
+        "sortBy": "Replace the active sort with the given list (priority order).",
+        "goToPage": "Navigate to the given zero-indexed page."
+      }
+    },
+    "datePicker": {
+      "state": {
+        "value": "Currently-selected ISO date, or null.",
+        "isOpen": "Whether the calendar popover is open."
+      },
+      "actions": {
+        "setDate": "Select a specific date (ISO yyyy-mm-dd).",
+        "clear": "Clear the selected date.",
+        "open": "Open the calendar popover.",
+        "close": "Close the calendar popover."
+      }
+    },
+    "dateRangePicker": {
+      "state": {
+        "range": "Currently-selected ISO date range endpoints, each possibly null.",
+        "isOpen": "Whether the range calendar popover is open."
+      },
+      "actions": {
+        "setRange": "Replace the selected range with the given ISO endpoints.",
+        "clear": "Clear the selected range.",
+        "open": "Open the range calendar popover.",
+        "close": "Close the range calendar popover."
+      }
+    },
+    "dateTimePicker": {
+      "state": {
+        "value": "Currently-selected ISO datetime, or null.",
+        "isOpen": "Whether the datetime popover is open."
+      },
+      "actions": {
+        "setDatetime": "Select a specific datetime (ISO string).",
+        "clear": "Clear the selected datetime.",
+        "open": "Open the datetime popover.",
+        "close": "Close the datetime popover."
+      }
+    },
+    "dependentSelector": {
+      "state": {
+        "value": "Id of the currently selected person, or empty string when none."
+      },
+      "actions": {
+        "setValue": "Select the person row with the given id."
+      }
+    },
+    "dialog": {
+      "state": {
+        "isOpen": "True when the dialog is currently open."
+      },
+      "actions": {
+        "open": "Open the dialog.",
+        "close": "Close the dialog. Reversible by reopening.",
+        "dismiss": "Dismiss the dialog. Loses any in-progress input that has not been committed."
+      }
+    },
+    "dropdownMenu": {
+      "state": {
+        "isOpen": "True when the menu is currently open."
+      },
+      "actions": {
+        "open": "Open the menu.",
+        "close": "Close the menu."
+      }
+    },
+    "emailInput": {
+      "state": {
+        "value": "The current email address typed into the field.",
+        "isValid": "True when the value is non-empty AND parses as a valid email per RFC 5322."
+      }
+    },
+    "fileUpload": {
+      "state": {
+        "files": "Files currently tracked by the uploader. Identifiers and metadata only — never file content."
+      },
+      "actions": {
+        "removeFile": "Remove the file with the given id from the upload list.",
+        "clear": "Remove all files from the upload list."
+      }
+    },
+    "fiscalCodeInput": {
+      "state": {
+        "value": "Current codice fiscale, normalised (uppercased, 0–16 [A-Z0-9] characters).",
+        "isValid": "Whether the value is 16 structurally-sound characters with a matching control character."
+      },
+      "actions": {
+        "setValue": "Replace the codice fiscale. The value is uppercased and stripped to [A-Z0-9], capped at 16 characters.",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the codice fiscale input."
+      }
+    },
+    "freemiumPaywall": {
+      "state": {
+        "isOpen": "True when the paywall dialog is open.",
+        "selectedPlanId": "Opaque id of the currently-selected plan."
+      },
+      "actions": {
+        "upgrade": "Fire onUpgrade with the currently-selected plan id.",
+        "dismiss": "Dismiss the paywall via the Not Now action. Irreversible from the same UI."
+      }
+    },
+    "headerSettings": {
+      "actions": {
+        "setLocale": "Switch the active locale to the given IETF tag.",
+        "setTheme": "Switch the theme preference.",
+        "setAccessibility": "Switch the accessibility preference."
+      }
+    },
+    "list": {
+      "state": {
+        "selection": "Ids of currently-selected list items. Empty array when none selected or list is presentational."
+      },
+      "actions": {
+        "setSelection": "Replace the current selection with the given item ids. No-op on presentational lists.",
+        "clearSelection": "Deselect all items."
+      }
+    },
+    "localePicker": {
+      "actions": {
+        "setLocale": "Switch the active locale to the given IETF tag."
+      }
+    },
+    "mapView": {
+      "actions": {
+        "panTo": "Pan the map to a new centre without changing zoom.",
+        "setZoom": "Set the map zoom level (typical range 1–20).",
+        "selectMarker": "Select a marker by id, or pass null to clear the selection."
+      }
+    },
+    "messageTray": {
+      "state": {
+        "items": "Currently-displayed messages. Ids + read flag only — no PHI / no sender names.",
+        "unreadCount": "Badge unread count surfaced by the host.",
+        "isOpen": "Whether the dropdown panel is currently open."
+      },
+      "actions": {
+        "open": "Open the message panel.",
+        "close": "Close the message panel.",
+        "selectItem": "Activate the message with the given id.",
+        "markRead": "Request the host to mark a message as read.",
+        "dismiss": "Request the host to dismiss / archive the message with the given id."
+      }
+    },
+    "multiSelect": {
+      "state": {
+        "selection": "Values of currently-selected options.",
+        "query": "Current filter query.",
+        "isOpen": "True when the option list is visible."
+      },
+      "actions": {
+        "setSelection": "Replace the current selection with the given list of values.",
+        "clearSelection": "Clear the current selection.",
+        "applyFilter": "Set the filter query for the option list.",
+        "open": "Open the option list.",
+        "close": "Close the option list."
+      }
+    },
+    "navigationMenu": {
+      "state": {
+        "activeItem": "Id of the currently-active top-level navigation item, or null when none is active.",
+        "isOpen": "Whether a dropdown / mega-menu panel is currently open."
+      },
+      "actions": {
+        "selectItem": "Activate (open) the top-level item with the given id.",
+        "open": "Open the dropdown / mega-menu panel for the given top-level item id.",
+        "close": "Close any open dropdown / mega-menu panel."
+      }
+    },
+    "notificationTray": {
+      "state": {
+        "items": "Currently-displayed notifications. Ids + read flag only — no PHI.",
+        "unreadCount": "Badge unread count surfaced by the host.",
+        "isOpen": "Whether the dropdown panel is currently open."
+      },
+      "actions": {
+        "open": "Open the notification panel.",
+        "close": "Close the notification panel.",
+        "selectItem": "Activate the notification with the given id.",
+        "markRead": "Request the host to mark a notification as read.",
+        "dismiss": "Request the host to dismiss the notification with the given id."
+      }
+    },
+    "numberInput": {
+      "state": {
+        "value": "Current numeric value, or null when empty.",
+        "isEmpty": "Whether the input has no value."
+      },
+      "actions": {
+        "setValue": "Replace the numeric value, or pass null to clear.",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the input."
+      }
+    },
+    "operatorHero": {
+      "state": {
+        "name": "Operator display name currently rendered.",
+        "hasColor": "Whether a calendar-colour identity dot is rendered. Structural flag only — never the colour id or any PHI."
+      }
+    },
+    "otpInput": {
+      "state": {
+        "value": "Current digits entered, packed into a single string.",
+        "isComplete": "Whether all required digits have been entered."
+      },
+      "actions": {
+        "setValue": "Replace the entered digits.",
+        "clear": "Empty all digit cells. Loses any typed value.",
+        "focus": "Move keyboard focus to the active digit cell."
+      }
+    },
+    "pagination": {
+      "state": {
+        "currentPage": "Current page index (1-based).",
+        "totalPages": "Total number of pages."
+      },
+      "actions": {
+        "goToPage": "Navigate to a specific 1-indexed page.",
+        "next": "Advance to the next page.",
+        "previous": "Step back to the previous page."
+      }
+    },
+    "passwordInput": {
+      "state": {
+        "value": "Current password value. Never log or persist this off-device.",
+        "isEmpty": "Whether the input has no value.",
+        "isRevealed": "Whether the password is currently shown in plain text."
+      },
+      "actions": {
+        "setValue": "Replace the password value.",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the input.",
+        "toggleVisibility": "Toggle between masked and plain-text display."
+      }
+    },
+    "patientSearch": {
+      "state": {
+        "variant": "Active variant — one of `who-where`, `who-where-when`, `faceted`, `discovery`."
+      },
+      "actions": {
+        "reset": "Clear the current search query (WHO, WHERE, WHEN, facets, geo) via the consumer-owned onChange.",
+        "focusPrimary": "Move keyboard focus to the most-relevant search field for the current variant."
+      }
+    },
+    "patientSummaryCard": {
+      "state": {
+        "summary": "Structural summary of the patient card — identifiers, counts, and consent flags only. Never patient identity or clinical content."
+      }
+    },
+    "paymentCard": {
+      "state": {
+        "number": "Payment number / reference currently rendered.",
+        "state": "Resolved headline financial state. Structural state only — never patient identity."
+      }
+    },
+    "paymentRequestCard": {
+      "state": {
+        "status": "Current lifecycle status of the payment request. Structural state only."
+      }
+    },
+    "paymentForm": {
+      "actions": {
+        "submit": "Submit the payment. Charges the configured payment method — irreversible.",
+        "reset": "Reset the form to its initial state. Loses any in-progress input."
+      }
+    },
+    "pdfViewer": {
+      "actions": {
+        "goToPage": "Navigate to a specific 1-indexed page.",
+        "setZoom": "Apply a zoom preset or numeric scale factor.",
+        "search": "Search the document for the given query and highlight matches.",
+        "print": "Open the browser print dialog for the document."
+      }
+    },
+    "periodontalChartCard": {
+      "state": {
+        "toothIds": "FDI ids of the teeth currently charted. Tooth identifiers only — no patient identity.",
+        "siteCount": "Total number of probing sites rendered.",
+        "deepPocketCount": "Number of sites with a probing depth at or above the 6mm severe threshold."
+      }
+    },
+    "phoneInput": {
+      "state": {
+        "value": "Current E.164 phone number, or empty string when not yet valid.",
+        "isEmpty": "Whether the input has no value."
+      },
+      "actions": {
+        "setValue": "Replace the phone number (E.164 or national format; parser will infer country).",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the phone-number input."
+      }
+    },
+    "popover": {
+      "state": {
+        "isOpen": "True when the popover is currently open."
+      },
+      "actions": {
+        "open": "Open the popover.",
+        "close": "Close the popover."
+      }
+    },
+    "practiceResults": {
+      "state": {
+        "variant": "Active variant — one of `split-list-map`, `map-first`, `rich-cards`."
+      },
+      "actions": {
+        "scrollToResult": "Scroll the result card with the given id into the visible viewport.",
+        "focusPin": "Highlight the map pin for the given result id (no-op on rich-cards)."
+      }
+    },
+    "privacyLock": {
+      "state": {
+        "isLocked": "True when the privacy overlay is open."
+      },
+      "actions": {
+        "lock": "Open the privacy overlay.",
+        "unlock": "Close the privacy overlay (consumer-confirmed action)."
+      }
+    },
+    "productHubPanel": {
+      "state": {
+        "items": "Currently-displayed releases. Ids + unseen flag only — no content.",
+        "unseenCount": "Number of displayed releases still marked unseen."
+      },
+      "actions": {
+        "selectItem": "Activate the release with the given id (fires the host analytics hook)."
+      }
+    },
+    "productHubTray": {
+      "state": {
+        "unseenCount": "Number of unseen product releases — the trigger badge count."
+      },
+      "actions": {
+        "open": "Open the product-updates panel.",
+        "close": "Close the product-updates panel."
+      }
+    },
+    "publicFooter": {
+      "state": {
+        "variant": "Active variant — one of `minimal`, `compact`, `full`.",
+        "legalUrls": "Resolved legal URLs for the active locale + marketingBaseUrl + overrides: `{ privacy, terms, contacts }`."
+      }
+    },
+    "publicHeader": {
+      "state": {
+        "menuOpen": "Whether the mobile drawer is currently open."
+      },
+      "actions": {
+        "openMenu": "Open the mobile drawer.",
+        "closeMenu": "Close the mobile drawer."
+      }
+    },
+    "qrCode": {
+      "state": {
+        "value": "The string (typically an https URL) encoded into the QR."
+      }
+    },
+    "radioGroup": {
+      "state": {
+        "value": "Currently selected radio value, or empty string when none."
+      },
+      "actions": {
+        "setValue": "Select the radio with the given value."
+      }
+    },
+    "recaptchaWidget": {
+      "state": {
+        "hasToken": "True when the widget currently holds a valid verification token."
+      },
+      "actions": {
+        "execute": "Programmatically trigger the captcha challenge. Issues a token via the callback.",
+        "reset": "Clear the current token and re-roll the captcha. Irreversible."
+      }
+    },
+    "resizable": {
+      "state": {
+        "sizes": "Current per-panel sizes as percentages of the group."
+      },
+      "actions": {
+        "setSizes": "Replace the panel sizes (percentages, summing to 100)."
+      }
+    },
+    "reviewsPanel": {
+      "state": {
+        "filter": "Active star-bucket filter — `\"all\"` or an integer 1..5. Reads the controlled `filter` prop.",
+        "visibleCount": "Number of reviews currently rendered after the filter is applied."
+      },
+      "actions": {
+        "setFilter": "Narrow the visible review list to a star bucket, or `\"all\"` to clear the filter."
+      }
+    },
+    "richTextEditor": {
+      "state": {
+        "html": "Sanitised HTML representation of the editor content.",
+        "text": "Plain-text content of the editor (tags stripped).",
+        "markdown": "Markdown representation of the editor content. The Redactor engine has no native Markdown serialiser, so this is always empty — read `html` instead."
+      },
+      "actions": {
+        "setContent": "Replace the editor content. Loses unsaved input.",
+        "insertAtCursor": "Insert content at the caret (replacing any selection). HTML is sanitised; pass asHtml:false for plain text. Seam for merge/template variables and AI-generated drafts.",
+        "applyFormat": "Toggle/apply a block or inline format on the current selection (bold, italic, strikethrough, bulleted/numbered list, heading, quote, paragraph).",
+        "clear": "Empty the editor. Loses unsaved input.",
+        "focus": "Move keyboard focus to the editor surface."
+      }
+    },
+    "searchBar": {
+      "state": {
+        "query": "Current raw query string (inline mode). Empty in launcher mode.",
+        "isEmpty": "True when the query is empty."
+      },
+      "actions": {
+        "setQuery": "Replace the current query (inline mode only). No-op in launcher mode.",
+        "clear": "Clear the query and close the result popover.",
+        "submit": "In launcher mode opens the CommandPalette; in inline mode commits the highlighted option.",
+        "focus": "Move keyboard focus to the SearchBar.",
+        "applySavedSearch": "Apply a saved-search by id. The host wires the actual query lookup; the adapter routes the id to its onApplySavedSearch handler. No-op when no handler is wired."
+      }
+    },
+    "searchInput": {
+      "state": {
+        "query": "Current raw query string (not debounced).",
+        "isEmpty": "True when the query is empty."
+      },
+      "actions": {
+        "setQuery": "Replace the current query with the given string and fire onChange immediately.",
+        "clear": "Clear the query and return focus to the input.",
+        "submit": "Fire the current query without waiting for debounce.",
+        "focus": "Move keyboard focus to the input (expanding it first if `variant=\"expandable\"`)."
+      }
+    },
+    "select": {
+      "state": {
+        "value": "Currently selected option value, or empty string when none.",
+        "isOpen": "Whether the option list is open."
+      },
+      "actions": {
+        "setValue": "Select the option with the given value.",
+        "clear": "Clear the current selection.",
+        "open": "Open the option list.",
+        "close": "Close the option list."
+      }
+    },
+    "sheet": {
+      "state": {
+        "isOpen": "True when the sheet is currently open."
+      },
+      "actions": {
+        "open": "Open the sheet.",
+        "close": "Close the sheet. Reversible by reopening.",
+        "dismiss": "Dismiss the sheet. Loses any in-progress input that has not been committed."
+      }
+    },
+    "sidebar": {
+      "state": {
+        "isCollapsed": "True when the sidebar is in its collapsed (rail) state."
+      },
+      "actions": {
+        "toggleCollapsed": "Toggle the sidebar between collapsed and expanded."
+      }
+    },
+    "signatureCapture": {
+      "state": {
+        "isEmpty": "True when no signature has been drawn or typed."
+      },
+      "actions": {
+        "clear": "Erase the current signature. Loses unsaved input.",
+        "undo": "Undo the last stroke.",
+        "confirm": "Commit the signature and return its serialised payload."
+      }
+    },
+    "slider": {
+      "state": {
+        "value": "Current thumb values; length 1 for a single slider, length 2 for a range."
+      },
+      "actions": {
+        "setValue": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range."
+      }
+    },
+    "sparkline": {
+      "actions": {
+        "updateSeries": "Replace the sparkline data without remounting.",
+        "exportPng": "Return a PNG data URI of the sparkline."
+      }
+    },
+    "stepperAccordion": {
+      "state": {
+        "currentStep": "Zero-indexed active step.",
+        "totalSteps": "Total number of steps in the flow.",
+        "openSteps": "Indices of currently-open step panels (singleton under Radix single mode)."
+      },
+      "actions": {
+        "gotoStep": "Activate the given step. Upcoming steps are gated by the consumer’s validation in onStepChange.",
+        "next": "Advance to the next step. Subject to the consumer’s onStepChange validation.",
+        "previous": "Return to the previous step (re-opens a completed step in edit mode)."
+      }
+    },
+    "stepperProgress": {
+      "state": {
+        "currentStep": "Zero-indexed active step.",
+        "totalSteps": "Total number of steps in the flow."
+      },
+      "actions": {
+        "gotoStep": "Request the host to activate the given step via onStepChange. No-op when no handler is wired.",
+        "next": "Request the host to advance one step via onStepChange.",
+        "previous": "Request the host to retreat one step via onStepChange."
+      }
+    },
+    "suggestionChip": {
+      "state": {
+        "value": "The chip's emitted value (its `value` prop or string child)."
+      },
+      "actions": {
+        "select": "Activate the chip — fires onSelect and (by default) self-removes.",
+        "dismiss": "Remove the chip without activating it."
+      }
+    },
+    "switch": {
+      "state": {
+        "checked": "Whether the switch is on."
+      },
+      "actions": {
+        "setChecked": "Set the on/off state to a specific value.",
+        "toggle": "Flip the on/off state."
+      }
+    },
+    "tabs": {
+      "state": {
+        "activeTab": "Value of the currently-active tab."
+      },
+      "actions": {
+        "selectTab": "Activate the tab with the given value."
+      }
+    },
+    "taskTray": {
+      "state": {
+        "items": "Currently-displayed tasks. Ids + status only — never task title / patient."
+      },
+      "actions": {
+        "selectItem": "Activate the task with the given id.",
+        "toggleDone": "Request the host to toggle the done state of a task.",
+        "dismiss": "Request the host to dismiss / remove the task with the given id."
+      }
+    },
+    "textArea": {
+      "state": {
+        "value": "Current value of the textarea.",
+        "isEmpty": "Whether the textarea has no value."
+      },
+      "actions": {
+        "setValue": "Replace the textarea value.",
+        "clear": "Empty the textarea. Loses any typed value.",
+        "focus": "Move keyboard focus to the textarea."
+      }
+    },
+    "textInput": {
+      "state": {
+        "value": "Current value of the text input.",
+        "isEmpty": "Whether the input has no value."
+      },
+      "actions": {
+        "setValue": "Replace the input value.",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the input."
+      }
+    },
+    "themeToggle": {
+      "state": {
+        "currentTheme": "Active theme preference: light, dark, or system.",
+        "currentAccessibility": "Active accessibility preference: default or accessible."
+      },
+      "actions": {
+        "setTheme": "Switch the theme preference.",
+        "setAccessibility": "Switch the accessibility preference."
+      }
+    },
+    "timePicker": {
+      "state": {
+        "value": "Currently-selected time as 24h HH:MM (always present — defaults to 00:00 when unset).",
+        "isOpen": "Whether the time popover is open. TimePicker has no popover of its own; always false."
+      },
+      "actions": {
+        "setTime": "Set the time using a 24h HH:MM string.",
+        "clear": "Clear the time (resets to 00:00).",
+        "open": "No-op: TimePicker has no popover of its own.",
+        "close": "No-op: TimePicker has no popover of its own."
+      }
+    },
+    "timeline": {
+      "state": {
+        "selectedEvent": "Opaque event id of the currently-active event, or null."
+      },
+      "actions": {
+        "selectEvent": "Scroll the given event into view and mark it as selected."
+      }
+    },
+    "toast": {
+      "state": {
+        "visibleToasts": "Snapshot of currently-visible toasts by opaque id. Never carries the toast body text."
+      },
+      "actions": {
+        "dismiss": "Dismiss the toast with the given id. Irreversible from the same UI.",
+        "dismissAll": "Dismiss every visible toast."
+      }
+    },
+    "toothScheme": {
+      "state": {
+        "chart": "Current dental chart — findings (and marked surfaces) keyed by FDI id.",
+        "chartedTeeth": "FDI ids of every tooth carrying at least one finding."
+      },
+      "actions": {
+        "focusTooth": "Move focus to a specific tooth by FDI id.",
+        "getTooth": "Read the findings recorded on one tooth (FDI id).",
+        "teethWith": "List the FDI ids of every tooth carrying a given finding (e.g. all teeth with caries).",
+        "setFinding": "Record a finding on a tooth (crown, implant, root canal, caries, …). Optionally mark the affected surfaces for a surface finding.",
+        "removeFinding": "Remove a single finding from a tooth.",
+        "clearTooth": "Clear every finding from a tooth."
+      }
+    },
+    "transcriptPanel": {
+      "state": {
+        "selectedTurn": "Opaque id (line index) of the currently-active turn, or null when none is active."
+      },
+      "actions": {
+        "focusTurn": "Scroll the given turn into view and focus its seek button.",
+        "copyTurn": "Copy the given turn's text to the clipboard."
+      }
+    },
+    "unitConverter": {
+      "state": {
+        "category": "Active measurement family. Determines which from/to units are selectable.",
+        "inputs": "Source value plus the from-unit and to-unit ids within the active category.",
+        "result": "Converted value in the to-unit, or null when the source value is empty."
+      },
+      "actions": {
+        "setValue": "Set the source value to convert.",
+        "setUnits": "Set the from-unit and/or to-unit. Ids outside the active category are ignored.",
+        "setCategory": "Switch the measurement family. Resets the from/to units to that category defaults.",
+        "getResult": "Return the converted value in the to-unit, or null when no source value is set."
+      }
+    },
+    "workflowEditor": {
+      "state": {
+        "totalSteps": "Total number of nodes currently in the workflow graph.",
+        "currentStep": "Opaque node id of the currently-focused step, or null."
+      },
+      "actions": {
+        "gotoStep": "Focus a node by its opaque id."
+      }
+    },
+    "alfascribeConsultation": {
+      "workflows": {
+        "toggleRecording": "Start or stop audio capture for the consultation; the level meter and transcript update while recording.",
+        "readTranscript": "Read the live transcript — focus or copy a specific turn (clinician / patient / AI).",
+        "addClinicianNote": "Type a clinician note or question into the composer and submit it into the transcript, optionally seeding it from a suggested follow-up chip.",
+        "regenerateSummary": "Regenerate the AI consultation summary; the new draft streams into the summary card.",
+        "copySummary": "Copy the AI summary to the clipboard; a success toast confirms the copy.",
+        "saveSummary": "Persist the reviewed consultation summary to the patient record."
+      }
+    },
+    "aliaAssistant": {
+      "workflows": {
+        "sendMessage": "Type a question into the composer and send it; Alia streams a reply into the conversation.",
+        "pickSuggestion": "Send one of the suggested prompts as the next user message.",
+        "stopGenerating": "Cancel the in-flight streaming response while Alia is generating.",
+        "togglePopout": "Open or close the floating Alia popout panel (FAB + Sheet) over the current page.",
+        "scrollToLatest": "Scroll the conversation log to the newest message.",
+        "reviewUsage": "Read the assistant usage meter; when the quota is full the composer locks behind an upgrade CTA."
+      }
+    },
+    "appointments": {
+      "workflows": {
+        "filterAppointments": "Narrow the agenda by date range, patient, operator, chair, type, or status using the per-column filters.",
+        "groupByOperator": "Toggle the \"group by operator\" view so appointments nest under their booked clinician.",
+        "addTreatment": "Add a treatment line to an appointment from its row action menu.",
+        "rescheduleAppointment": "Move an open appointment to a new slot via its row \"Reschedule\" action. Closed (done / absent / cancelled) appointments cannot be rescheduled.",
+        "cancelAppointment": "Cancel an open appointment via its row \"Cancel appointment\" action. Destructive — frees the chair and drops the booking.",
+        "executeTreatment": "Mark a planned treatment line as done from its line action menu.",
+        "contactPatient": "Message the patient on WhatsApp from the appointment row (e.g. send a confirmation reminder)."
+      }
+    },
+    "authLayout": {
+      "workflows": {
+        "signIn": "Fill the email + password fields and submit the login form.",
+        "signUp": "Fill name, work email, password + confirmation, accept the terms, and create an account.",
+        "requestPasswordReset": "Enter the account email on the forgot-password form and request a reset link.",
+        "togglePasswordVisibility": "Reveal or hide the entered password."
+      }
+    },
+    "carePlans": {
+      "workflows": {
+        "selectPlans": "Select one or more plan or care rows in the register for a bulk action.",
+        "filterByPeriod": "Choose a period preset (e.g. this month, this year) and filter the register to it.",
+        "createPlan": "Open the \"New plan\" action from the page header and persist a new treatment plan for the patient.",
+        "createAppointmentForCare": "From a planned care row action, schedule an appointment for that treatment.",
+        "generateInvoice": "Bill a completed treatment: create the doctor bill / invoice the selected care sits on.",
+        "exportCsv": "Download the current filtered register as a CSV from the page header.",
+        "deleteCare": "Delete the selected non-billed care row from its plan. Irreversible."
+      }
+    },
+    "confirmPhone": {
+      "workflows": {
+        "enterMobileNumber": "Type or edit the mobile number (Italy-default dial code, editable) in the phone field.",
+        "confirmMobileNumber": "Save the entered mobile number, enabling the SMS two-factor path. An invalid or landline number keeps the prompt open with an inline error.",
+        "skipPrompt": "Dismiss the prompt without saving. Access continues; the prompt re-appears at the next login.",
+        "reopenPrompt": "Open the confirm-phone prompt again after it was skipped."
+      }
+    },
+    "dashboardDailyQueues": {
+      "workflows": {
+        "completeTask": "Mark a task in the \"My next tasks\" tray as done so it drops out of the undone queue.",
+        "scheduleFromTask": "Open the \"Schedule appointment\" row action on a patient task to book a visit for the linked patient.",
+        "openAppointment": "Open one of the upcoming appointments in the agenda tray to view or edit the visit.",
+        "createTask": "Use the tasks tray quick-create (or empty-state CTA) to start a new follow-up / recall / collection task.",
+        "createAppointment": "Use the agenda tray quick-create (or empty-state CTA) to book a new appointment.",
+        "deleteTask": "Remove a task from the queue via its row \"Delete task\" action. Irreversible."
+      }
+    },
+    "dashboard": {
+      "workflows": {
+        "triageWarnings": "Review the outstanding-action notices and dismiss the ones that are handled. The strip folds away once every notice is cleared. Dismissal is delegated through the WarningStack item `onDismiss` callback, so there is no imperative ui action.",
+        "openInbox": "Open the inline-end AI tools rail to the Inbox tool to read the merged notifications / messages / product-update feed.",
+        "quickCreate": "Use a quick-entry tile CTA to start creating a new patient, appointment, treatment plan, or invoice.",
+        "navigateSection": "Jump to another workspace section (patients, schedule, documents, settings) from the Sidebar.",
+        "reviewEfficiency": "Read the Studio efficiency gauge and open the settings checklist to complete the remaining configuration steps."
+      }
+    },
+    "entityCreateSheet": {
+      "workflows": {
+        "openCreateSheet": "Open the quick-create sheet over the current list / dashboard without navigating away.",
+        "fillForm": "Populate the form fields: free-text inputs, the notes area, single-select choices, the autocomplete lookup, and the date/time field.",
+        "saveEntity": "Submit the form to create the new entity. Missing required fields keep the sheet open with inline errors; on success the sheet closes.",
+        "cancelCreate": "Dismiss the sheet without saving, discarding any entered values and returning to the underlying list."
+      }
+    },
+    "entityIndexTable": {
+      "workflows": {
+        "selectRows": "Select one or more rows in the table.",
+        "applyFilter": "Set the filter strip values and apply.",
+        "createEntity": "Open the create form and submit a new entity.",
+        "deleteSelected": "Delete every selected row. Irreversible.",
+        "exportCsv": "Trigger the CSV export of the current filtered set."
+      }
+    },
+    "marketplaceAppShell": {
+      "workflows": {
+        "navigate": "Navigate to one of the app sections via the sidebar nav (or the embedded tab strip). Routing is consumer-owned, so the destination resolves through the host router.",
+        "toggleSidebar": "Collapse or expand the main navigation rail and read its current collapsed state.",
+        "openAccountMenu": "Open the account dropdown to reach sign-out and account settings.",
+        "setAppearance": "Change the active theme, locale, or accessibility profile from the header settings.",
+        "connectAccount": "Start the AlfaDocs OAuth connect flow from the pre-auth screen. Persists an authorised session.",
+        "signOut": "Sign out of the connected AlfaDocs account from the account menu. Ends the session."
+      }
+    },
+    "multiSigneeSigning": {
+      "workflows": {
+        "verifyPartyIdentity": "The active party passes its own identity gate: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then verify.",
+        "signPartyFields": "The active party signs the surface filtered to its own fields: activate a field overlay, draw or type the signature in the capture dialog, and confirm it.",
+        "handOffToNextParty": "After the active party finishes, hand the device to the next party (same-device flow), switching the active session and re-filtering the surface to the next party’s fields.",
+        "completeEnvelope": "Finalise the envelope once every party has signed all of its fields."
+      }
+    },
+    "patientAiSummary": {
+      "workflows": {
+        "openTool": "Open one of the rail tools — the Patient Summary brief or the Ask Alia chat — making its panel the active complementary landmark.",
+        "readBrief": "Read the compiled patient brief — overview counts/flags, plan state and progress, and the latest payment record.",
+        "expandSection": "Expand one section of the brief accordion (overview, appointment, history, plan, or attention) to reveal its entity card.",
+        "grantAiConsent": "Record the patient AI-assistance consent that gates the brief, revealing the structured summary once granted.",
+        "askAlia": "Open the Ask Alia tool and send a question about this patient; Alia can answer with an in-conversation entity card."
+      }
+    },
+    "patientCheckIn": {
+      "workflows": {
+        "signInWithCode": "Request a one-time SMS/email code, enter it, and authenticate into the check-in flow.",
+        "setLanguage": "Pick the kiosk language for the check-in session.",
+        "selectSubject": "Choose who is checking in (self or a dependent) and confirm their personal data.",
+        "captureIdDocument": "Photograph or upload the health card / ID document for the visit.",
+        "signConsents": "Read each consent form, add the signature, and submit the signed consents.",
+        "payForVisit": "Pay the visit fee by card or digital wallet.",
+        "completeCheckIn": "Finalise the check-in once all steps are done; marks the patient as arrived."
+      }
+    },
+    "patientPortal": {
+      "workflows": {
+        "signInWithCode": "Request a one-time SMS/email code, enter it, and authenticate into the portal.",
+        "navigateSection": "Switch between the Appointments, Documents, and My details portal sections.",
+        "checkIn": "Start the day-of check-in for an upcoming appointment from the portal home.",
+        "cancelAppointment": "Cancel an upcoming appointment after confirming in the dialog. Frees the slot.",
+        "uploadDocument": "Upload a file (PDF/JPG/PNG) to the patient document library.",
+        "saveDetails": "Edit and save the patient personal details (contact, address, fiscal code)."
+      }
+    },
+    "patientShell": {
+      "workflows": {
+        "toggleSidebar": "Collapse or expand the flat patient navigation rail.",
+        "openSettings": "Open the header settings menu (fullscreen toggle and logout).",
+        "signOut": "Log the patient out and navigate to the configured logout URL."
+      }
+    },
+    "patients": {
+      "workflows": {
+        "filterFromNotice": "Apply a WarningStack notice’s \"View\" action to narrow the roster to the flagged patients (e.g. overdue balances, estimate-stage plans).",
+        "selectPatients": "Select one or more patient rows in the roster for a bulk action.",
+        "sendReminders": "Send an appointment or balance reminder to the selected patients through their eligible channel (email or SMS).",
+        "tagPatients": "Add a tag to every selected patient.",
+        "deletePatients": "Delete the selected patients. Archived patients cannot be deleted. Irreversible.",
+        "applyView": "Choose a saved view from the switcher to apply its filter and sort (and saved column layout) to the roster."
+      }
+    },
+    "practiceProfileHero": {
+      "workflows": {
+        "viewProfile": "Read the practice's public profile summary — name, tagline, average rating, review count, and trust badges."
+      }
+    },
+    "prenota": {
+      "workflows": {
+        "searchPractitioners": "Pick a specialty / clinic and a location in the hero search comboboxes and submit to find matching practitioners.",
+        "browseResults": "Scroll the search results list and focus a map pin to locate a practice geographically.",
+        "openPractice": "Open a practice or operator profile from a result card to view contact details and reviews.",
+        "filterReviews": "Filter the reviews panel on a profile by star rating to read targeted feedback.",
+        "bookVisit": "Start booking a visit from a result card next-available slot or a profile \"Book visit\" CTA.",
+        "navigateMenu": "Open the public header navigation (doctors, pricing, for-practices) or the sign-in / register actions."
+      }
+    },
+    "printInvoice": {
+      "workflows": {
+        "sortLineItems": "Sort the invoice line-items table by a column.",
+        "readFindings": "Read the charted odontogram findings on the treatment-plan variant.",
+        "generatePdf": "Render the current invoice (or treatment plan) to a print-ready PDF document.",
+        "sendInvoice": "Email the generated invoice document to the patient."
+      }
+    },
+    "roiDashboard": {
+      "workflows": {
+        "viewFunnel": "Read the patient-journey funnel — per-stage efficiency, time saved, and potential for the selected period.",
+        "setPeriod": "Change the reporting period for the whole funnel; every cubotto and KPI recomputes.",
+        "drillIntoStage": "Open a stage cubotto to its per-KPI drill-down breakdown (and the AI insight cubotto to the ROI overview).",
+        "switchRole": "Switch the dashboard to another role via the multi-role tab switcher and read the active role.",
+        "openInbox": "Open the inbox rail's notifications/messages tool and read which tool is active.",
+        "exportKpi": "Export a KPI chart as a PNG for a report, or request a full ROI report export.",
+        "dismissAlert": "Dismiss an item from the top-of-page alerts strip. Persists the dismissal so it stays hidden."
+      }
+    },
+    "settings": {
+      "workflows": {
+        "switchSection": "Switch the active settings section (Profile / Notifications / Billing / Security) via the vertical tab strip.",
+        "editDisplayName": "Set the display-name text field; changing it marks the form dirty and enables Save.",
+        "toggleEmailDigest": "Turn the weekly email digest preference on or off.",
+        "setLanguage": "Choose the display language from the language select.",
+        "saveSettings": "Persist the dirty profile form. Save is disabled until a field changes.",
+        "discardChanges": "Cancel and reset the form to its last-saved baseline, re-disabling Save.",
+        "collapseSidebar": "Collapse or expand the primary navigation sidebar."
+      }
+    },
+    "signingWizard": {
+      "workflows": {
+        "verifyIdentity": "Complete the Verify step: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then advance to the Sign step.",
+        "navigateSteps": "Move between the Verify → Sign → Done steps of the wizard.",
+        "readDocument": "Page through and zoom the document under signature on the Sign step.",
+        "signField": "Activate a field overlay on the Sign step, draw or type the signature in the capture dialog, and confirm it.",
+        "completeEnvelope": "Finalise the envelope once every required field is signed and the wizard reaches the Done step."
+      }
+    },
+    "signing": {
+      "workflows": {
+        "verifyIdentity": "Pass the identity gate before the document is shown: enter the 5-character SMS code, or tick the confirm-identity checkbox when no mobile number is on file, then verify.",
+        "readDocument": "Page through and zoom the document under signature before signing each field.",
+        "signField": "Activate a signature / initial / date field overlay, draw or type the signature in the capture dialog, and confirm it. Signing the last field auto-advances to the success terminal.",
+        "completeEnvelope": "Finalise the envelope once every required field carries a signature, persisting the completed document."
+      }
+    },
+    "twoFactorLogin": {
+      "workflows": {
+        "enterCode": "Type the 6-digit verification code into the OTP field.",
+        "verifyCode": "Submit the entered code to complete the second-factor challenge and sign in.",
+        "resendCode": "Request a fresh SMS code (capped at the configured resend limit).",
+        "switchMethod": "Switch between the SMS and authenticator-app verification methods, resetting the entry."
+      }
+    },
+    "upgradePractice": {
+      "workflows": {
+        "viewPackages": "List the available upgrade packages with their headline benefits and price.",
+        "openPackage": "Open a package card to its detail view with the quantified benefit rows.",
+        "configurePackage": "In the basket, set the quantity or tier for a tiered/quantity package and read back the chosen value; the monthly-price-increase summary recomputes.",
+        "confirmUpgrade": "Confirm the upgrade — add the configured package to the practice subscription and bill the prorated partial period. Persists a billing change."
+      }
+    }
+  }
+}