@alfadocs/ui-kit 0.70.0 → 0.71.0

package/dist/agent-i18n/en.json

@@ -24,6 +24,15 @@
         "close": "Close the suggestion listbox."
       }
     },
+    "addressFields": {
+      "state": {
+        "value": "The current structured address: { street, city, postcode, province, country, formatted }."
+      },
+      "actions": {
+        "setValue": "Replace the entire address.",
+        "setField": "Set a single address field. Setting `country` also clears the now-stale province."
+      }
+    },
     "agendaTray": {
       "state": {
         "items": "Currently-displayed appointments. Ids + status only — never patient identity."
@@ -236,6 +245,16 @@
         "toggle": "Flip the checked state between checked and unchecked."
       }
     },
+    "cityInput": {
+      "state": {
+        "value": "Current city / town value.",
+        "isEmpty": "Whether the field has no value."
+      },
+      "actions": {
+        "setValue": "Replace the city value.",
+        "clear": "Empty the field. Loses any typed value."
+      }
+    },
     "clinicalNoteCard": {
       "state": {
         "noteId": "Stable identifier of the rendered note, when supplied.",
@@ -287,6 +306,15 @@
         "applyFilter": "Set the filter query."
       }
     },
+    "connectionStatus": {
+      "state": {
+        "status": "Connection state of the external service: 'connected', 'disconnected', 'pending', or 'error'."
+      },
+      "actions": {
+        "connect": "Begin connecting the external service — invokes the consumer-supplied onConnect handler.",
+        "disconnect": "Disconnect the external service — invokes the consumer-supplied onDisconnect handler."
+      }
+    },
     "contactProfileCard": {
       "state": {
         "profession": "Profession string the card is currently rendering — undefined when the consumer omitted it."
@@ -301,6 +329,15 @@
         "copy": "Programmatically trigger the clipboard write."
       }
     },
+    "countrySelect": {
+      "state": {
+        "value": "Selected ISO 3166-1 alpha-2 country code (lowercased), or null when nothing is selected."
+      },
+      "actions": {
+        "setValue": "Set the selected country by ISO alpha-2 code.",
+        "clearSelection": "Clear the selected country."
+      }
+    },
     "dataTable": {
       "state": {
         "selection": "Row ids of currently-selected rows.",
@@ -387,6 +424,25 @@
         "isValid": "True when the value is non-empty AND parses as a valid email per RFC 5322."
       }
     },
+    "entitySummary": {
+      "state": {
+        "sections": "Structural section list — ids, fixed category headings, tone and item counts. Never the entity name or the bullet items (both PHI).",
+        "generatedAtIso": "ISO-8601 instant the brief was generated, when known."
+      },
+      "actions": {
+        "regenerate": "Request the host to regenerate the AI brief. No-op when the regenerate affordance is not available.",
+        "close": "Dismiss the summary panel. No-op when the close affordance is not available (e.g. docked in the rail)."
+      }
+    },
+    "fieldArray": {
+      "state": {
+        "count": "Number of rows currently rendered."
+      },
+      "actions": {
+        "add": "Append a new row.",
+        "remove": "Remove the row at the given index."
+      }
+    },
     "fileUpload": {
       "state": {
         "files": "Files currently tracked by the uploader. Identifiers and metadata only — never file content."
@@ -424,6 +480,39 @@
         "setAccessibility": "Switch the accessibility preference."
       }
     },
+    "ibanInput": {
+      "state": {
+        "value": "Current IBAN, normalised (uppercased, [A-Z0-9], no spaces, ≤34 characters).",
+        "isValid": "Whether the value is a structurally complete IBAN with a passing mod-97-10 checksum."
+      },
+      "actions": {
+        "setValue": "Replace the IBAN. The value is uppercased and stripped to [A-Z0-9], capped at 34 characters.",
+        "clear": "Empty the input. Loses any typed value.",
+        "focus": "Move keyboard focus to the IBAN input."
+      }
+    },
+    "iconPicker": {
+      "state": {
+        "value": "Id of the currently selected icon, or an empty string when nothing is picked.",
+        "isOpen": "True when the picker popover is currently open.",
+        "query": "Current search query filtering the icon grid by label."
+      },
+      "actions": {
+        "setValue": "Select the icon with the given id.",
+        "open": "Open the picker popover.",
+        "close": "Close the picker popover.",
+        "filter": "Filter the icon grid to labels containing the query."
+      }
+    },
+    "imageCropper": {
+      "state": {
+        "crop": "Current crop rectangle in normalised [0,1] coordinates: { x, y, width, height }."
+      },
+      "actions": {
+        "setCrop": "Set the crop rectangle (normalised [0,1]). Values are clamped to the image bounds and the minimum crop size.",
+        "reset": "Reset the crop to the centred default for the current aspect."
+      }
+    },
     "list": {
       "state": {
         "selection": "Ids of currently-selected list items. Empty array when none selected or list is presentational."
@@ -456,7 +545,9 @@
         "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."
+        "dismiss": "Request the host to dismiss / archive the message with the given id.",
+        "markAllRead": "Request the host to mark every message as read.",
+        "viewAll": "Navigate to the full inbox / message list."
       }
     },
     "multiSelect": {
@@ -473,6 +564,14 @@
         "close": "Close the option list."
       }
     },
+    "navGrid": {
+      "state": {
+        "itemCount": "Number of navigable tiles currently rendered in the grid."
+      },
+      "actions": {
+        "openItem": "Activate the tile with the given id (navigates or fires its select handler)."
+      }
+    },
     "navigationMenu": {
       "state": {
         "activeItem": "Id of the currently-active top-level navigation item, or null when none is active.",
@@ -484,6 +583,17 @@
         "close": "Close any open dropdown / mega-menu panel."
       }
     },
+    "notesPanel": {
+      "state": {
+        "notes": "Timeline note ids + pinned / flagged / clinical flags. Never the note body or author (both PHI).",
+        "canAddClinical": "Whether the current user may write clinical notes (the practice_add_clinical_note permission gate)."
+      },
+      "actions": {
+        "addNote": "Compose and commit a new note. A clinical note requires the clinical-note permission (read canAddClinical first).",
+        "togglePin": "Toggle the pinned state of the note with the given id.",
+        "toggleFlag": "Toggle the flagged state of the note with the given id."
+      }
+    },
     "notificationTray": {
       "state": {
         "items": "Currently-displayed notifications. Ids + read flag only — no PHI.",
@@ -495,7 +605,9 @@
         "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."
+        "dismiss": "Request the host to dismiss the notification with the given id.",
+        "markAllRead": "Request the host to mark every notification as read.",
+        "viewAll": "Navigate to the full notification list."
       }
     },
     "numberInput": {
@@ -607,6 +719,15 @@
         "deepPocketCount": "Number of sites with a probing depth at or above the 6mm severe threshold."
       }
     },
+    "permissionMatrix": {
+      "state": {
+        "selection": "Ids of currently-granted editable permissions. Locked owner permissions are excluded."
+      },
+      "actions": {
+        "setSelection": "Replace the granted permissions with the given ids. Locked and unknown ids are ignored.",
+        "clear": "Revoke every editable permission. Locked owner permissions are unaffected."
+      }
+    },
     "phoneInput": {
       "state": {
         "value": "Current E.164 phone number, or empty string when not yet valid.",
@@ -627,6 +748,24 @@
         "close": "Close the popover."
       }
     },
+    "positionGrid": {
+      "state": {
+        "value": "Currently selected position value (e.g. \"top-start\"), or empty string when none."
+      },
+      "actions": {
+        "setValue": "Select the cell with the given position value."
+      }
+    },
+    "postalCodeInput": {
+      "state": {
+        "value": "Current postal code value.",
+        "isEmpty": "Whether the field has no value."
+      },
+      "actions": {
+        "setValue": "Replace the postal code value.",
+        "clear": "Empty the field. Loses any typed value."
+      }
+    },
     "practiceResults": {
       "state": {
         "variant": "Active variant — one of `split-list-map`, `map-first`, `rich-cards`."
@@ -663,6 +802,15 @@
         "close": "Close the product-updates panel."
       }
     },
+    "provinceSelect": {
+      "state": {
+        "value": "Selected province code (UPPERCASED sigla for Italy), or null when nothing is selected."
+      },
+      "actions": {
+        "setValue": "Set the selected province by code.",
+        "clearSelection": "Clear the selected province."
+      }
+    },
     "publicFooter": {
       "state": {
         "variant": "Active variant — one of `minimal`, `compact`, `full`.",
@@ -878,6 +1026,20 @@
         "dismiss": "Request the host to dismiss / remove the task with the given id."
       }
     },
+    "tasksPanel": {
+      "state": {
+        "items": "Currently-rendered tasks. Ids + status only — never task note / 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.",
+        "jumpToOverdue": "Re-anchor the panel scroll on the overdue tasks.",
+        "setFilter": "Set the task filters (status segment, type, assignee, overdue-only). Omitted keys are left unchanged.",
+        "changeScope": "Switch the task scope segment between this patient ('patient') and the operator's own tasks ('mine'). The host re-feeds the items.",
+        "loadMore": "Request the host to append the next page of tasks."
+      }
+    },
     "textArea": {
       "state": {
         "value": "Current value of the textarea.",
@@ -939,6 +1101,16 @@
         "dismissAll": "Dismiss every visible toast."
       }
     },
+    "tokenInsertMenu": {
+      "state": {
+        "isOpen": "True when the token menu is currently open."
+      },
+      "actions": {
+        "open": "Open the token menu.",
+        "close": "Close the token menu.",
+        "insert": "Emit a merge-token to the consumer for cursor insertion."
+      }
+    },
     "toothScheme": {
       "state": {
         "chart": "Current dental chart — findings (and marked surfaces) keyed by FDI id, or by a special-element id (quadrant / sextant / arch / general) for region-spanning findings.",
@@ -1003,6 +1175,7 @@
         "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.",
+        "retryMessage": "Re-send a message that failed to send. The failed message is located by its `data-status=\"error\"` ChatMessage (addressed via `data-component-id`); activating that message's built-in retry control re-submits it. No adapter action — the retry control is a DOM-click affordance on the errored message.",
         "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."
@@ -1027,6 +1200,21 @@
         "togglePasswordVisibility": "Reveal or hide the entered password."
       }
     },
+    "carePlanEditor": {
+      "workflows": {
+        "selectPlan": "Open one of the patient's care plans from the plan list. Activation is a native click on the plan row; the host loads the plan into the editor.",
+        "addPlan": "Create a new care plan for the patient.",
+        "inspectTooth": "Focus a tooth on the odontogram and read its charted dental status.",
+        "openToothRadiographs": "Open the radiograph drawer for a tooth that carries imaging (the docked Control Room radiographs tool).",
+        "markTreatmentDone": "Mark a planned treatment as executed from its row action in the treatments grid.",
+        "addTreatment": "Add a planned treatment row to the current plan.",
+        "removeTreatment": "Remove the selected planned treatment(s) from the plan (read data-table.selection for the targets).",
+        "savePlan": "Persist the current edits to the care plan.",
+        "addPlanNote": "Add a note to the plan via the docked Notes tool. A clinical note requires the clinical-note permission.",
+        "triagePlanTasks": "Open or complete a follow-up task from the docked Tasks tool.",
+        "regenerateSummary": "Regenerate the AI plan summary in the docked AI summary tool."
+      }
+    },
     "carePlans": {
       "workflows": {
         "selectPlans": "Select one or more plan or care rows in the register for a bulk action.",
@@ -1207,12 +1395,22 @@
     },
     "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.",
+        "openSection": "Open a settings section from the Hub or the grouped section nav. Read-only navigation.",
+        "editTextSetting": "Set a text field in the active section (e.g. practice name, booking address, bank IBAN); marks the form dirty and enables Save.",
+        "toggleSetting": "Turn a boolean setting on or off (e.g. yearly numbering, group services).",
+        "chooseOption": "Pick a single option from a select or radio group (e.g. tax regime, document type, stamp method).",
+        "setMultiChoice": "Select or clear members of a multi-choice group (e.g. accepted insurers, active branches, per-area permissions).",
+        "pickColour": "Choose a colour from the practice palette (e.g. booking page accent).",
+        "saveSection": "Persist the dirty section form. Save is disabled until a field changes.",
+        "addRecord": "Open the create dialog for a list section (cash & banks, chairs, payment types…) and persist a new record.",
+        "deleteRecord": "Remove a record from a list section after confirmation. Irreversible.",
+        "filterRecords": "Filter the rows of a list section by a column value.",
+        "uploadPracticePhoto": "Upload, crop, or remove the practice / profile photo.",
+        "copySecret": "Copy a read-only secret to the clipboard (API key, data-import key, support PIN, iCal feed URL).",
+        "revokeApiKey": "Revoke or regenerate an API key. Apps using the old key lose access immediately.",
+        "connectOnlinePayments": "Connect or disconnect the Stripe account used for online payments.",
+        "deleteArchive": "Delete the current archive after a password-gated confirmation. Permanently removes all of its data. Irreversible.",
+        "openTool": "Open or switch a Control-Room rail tool (inbox, Alia) without leaving Settings.",
         "collapseSidebar": "Collapse or expand the primary navigation sidebar."
       }
     },

package/dist/components/_shared/option.d.ts

@@ -1,8 +1,10 @@
+import type { ReactNode } from 'react';
 export interface OptionShape<T extends string = string> {
     value: T;
     label: string;
     group?: string;
     disabled?: boolean;
     description?: string;
+    startAdornment?: ReactNode;
 }
 //# sourceMappingURL=option.d.ts.map

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

@@ -27,7 +27,7 @@ import type { ReactElement, ReactNode } from 'react';
  */
 export type PatientFieldKind = 'sex' | 'age' | 'dob' | 'fiscalCode' | 'discount' | 'email' | 'phone';
 /** Editor control rendered when a field enters inline-edit mode. */
-export type PatientFieldEditType = 'text' | 'textarea' | 'select' | 'boolean' | 'date' | 'number' | 'email' | 'phone' | 'fiscalCode';
+export type PatientFieldEditType = 'text' | 'textarea' | 'select' | 'boolean' | 'date' | 'number' | 'email' | 'phone' | 'fiscalCode' | 'province' | 'country' | 'postalCode' | 'city';
 /** A choice for an `editType: 'select'` field. */
 export interface PatientFieldOption {
     value: string;

package/dist/components/address-fields/address-fields.agent.d.ts

@@ -0,0 +1,9 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { StructuredAddress } from '../address-autocomplete';
+export interface AddressFieldsHandle {
+    getValue: () => StructuredAddress;
+    setValue: (value: StructuredAddress) => void;
+    setField: (field: keyof StructuredAddress, value: string) => void;
+}
+export declare const addressFieldsAgent: AgentAdapter<AddressFieldsHandle>;
+//# sourceMappingURL=address-fields.agent.d.ts.map

package/dist/components/address-fields/address-fields.d.ts

@@ -0,0 +1,29 @@
+import { type CityLoaderContext } from '../city-input/city-input';
+import { type GetSuggestions, type StructuredAddress } from '../address-autocomplete';
+import type { OptionShape } from '../_shared/option';
+export type AddressFieldKey = 'street' | 'city' | 'postcode' | 'province';
+export interface AddressFieldsProps {
+    /** The controlled address value. */
+    value?: StructuredAddress;
+    /** Fires with the next full address on any field change. */
+    onChange?: (next: StructuredAddress) => void;
+    /**
+     * Which address-line fields to render, in order. The country picker
+     * always renders first. Default resolves from the selected country.
+     */
+    fields?: AddressFieldKey[];
+    /** Async city suggestion loader, forwarded to CityInput. */
+    loadCities?: (query: string, ctx: CityLoaderContext) => Promise<OptionShape[]>;
+    /** Float these countries to the top of the country picker. */
+    popularCountries?: string[];
+    /** Enable the "find address" bar — provide a Places API key… */
+    apiKey?: string;
+    /** …or a mock/real suggestion injector (wins over apiKey, like AddressAutocomplete). */
+    getSuggestions?: GetSuggestions;
+    layout?: 'stacked' | 'grid';
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+}
+export declare const AddressFields: import("react").ForwardRefExoticComponent<AddressFieldsProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=address-fields.d.ts.map

package/dist/components/address-fields/index.d.ts

@@ -0,0 +1,5 @@
+export { AddressFields } from './address-fields';
+export type { AddressFieldsProps, AddressFieldKey } from './address-fields';
+export { addressFieldsAgent } from './address-fields.agent';
+export type { AddressFieldsHandle } from './address-fields.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { A as e, a } from "../../_chunks/address-fields-CPbFJ8e8.js";
+export {
+  e as AddressFields,
+  a as addressFieldsAgent
+};
+//# sourceMappingURL=index.js.map

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

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

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

@@ -1,4 +1,4 @@
-import { A as s, a as t, D as S, F as o, b as m, S as r, c as A, e as n, f as F, g as _, d as g, r as i, v as E } from "../../_chunks/anatomy-scheme-CJB6dI6p.js";
+import { A as s, a as t, D as S, F as o, b as m, S as r, c as A, e as n, f as F, g as _, d as g, r as i, v as E } from "../../_chunks/anatomy-scheme-CXSk11UJ.js";
 export {
   s as ANATOMY_VIEWS,
   t as AnatomyScheme,

package/dist/components/app-frame/app-frame.d.ts

@@ -1,9 +1,9 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const mainVariants: (props?: ({
+declare const mainContentVariants: (props?: ({
     padded?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface AppFrameProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof mainVariants> {
+export interface AppFrameProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof mainContentVariants> {
     /** `<Header>` instance rendered full-width at the block-start of the shell. */
     header: ReactNode;
     /** `<Sidebar>` instance rendered inline-start of the row beneath the header on ≥ md viewports. */

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

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

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

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-C06aZqA7.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-DRRw5ROi.js";
+import { A as p } from "../../_chunks/appointment-card-DVaeJNVB.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-B16QPGbm.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-BJM0S_Fg.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-PJgnrjFb.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-Cpdk5qpQ.js";
+import { A as r, a } from "../../_chunks/audio-recorder-DNDsOLqO.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

package/dist/components/autocomplete/autocomplete.d.ts

@@ -39,6 +39,16 @@ export interface AutocompleteProps<T extends string = string> extends Pick<CVAPr
     id?: string;
     className?: string;
     'aria-label'?: string;
+    /**
+     * Invalid-state fallback for use OUTSIDE a `<FormField>` (e.g. an inline
+     * editor). Inside a FormField the context wins.
+     */
+    'aria-invalid'?: boolean;
+    /**
+     * Error-message id fallback for use OUTSIDE a `<FormField>`. Inside a
+     * FormField the context's `describedBy` wins.
+     */
+    'aria-describedby'?: string;
 }
 interface AutocompleteComponent {
     <T extends string = string>(props: AutocompleteProps<T> & {

package/dist/components/autocomplete/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o, b as m } from "../../_chunks/autocomplete-DOeGouCL.js";
+import { A as e, a as o, b as m } from "../../_chunks/autocomplete-BrONKN8l.js";
 export {
   e as Autocomplete,
   o as autocompleteAgent,

package/dist/components/bishop-score/index.js

@@ -1,4 +1,4 @@
-import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-DnYWtZa_.js";
+import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-Cym_TeQY.js";
 export {
   O as BISHOP_COMPONENTS,
   S as BISHOP_MAX_SCORE,

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-DUBI0oqt.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-C7do4vaR.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/button-group/index.js

@@ -1,4 +1,4 @@
-import { B as t } from "../../_chunks/button-group-Ciq6J4IW.js";
+import { B as t } from "../../_chunks/button-group-CvEnVzY7.js";
 export {
   t as ButtonGroup
 };

package/dist/components/care-plan-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as C } from "../../_chunks/care-plan-card-C5sTfY9G.js";
+import { C as e, c as C } from "../../_chunks/care-plan-card-DzPDYgtK.js";
 export {
   e as CarePlanCard,
   C as carePlanCardAgent

package/dist/components/care-plan-entry-card/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as e } from "../../_chunks/care-plan-entry-card-CXnxGCWA.js";
+import { C as n, c as e } from "../../_chunks/care-plan-entry-card-CEnQy7YP.js";
 export {
   n as CarePlanEntryCard,
   e as carePlanEntryCardAgent

package/dist/components/care-plan-header/care-plan-header.d.ts

@@ -59,12 +59,18 @@ export interface CarePlanHeaderHandle {
 export interface CarePlanHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
     /** Agent-readiness instance id, surfaced as `data-component-id`. */
     id?: string;
-    /** Plan number — rendered in the eyebrow (or as the heading when no `name`). */
+    /**
+     * Plan number — used as the heading when no `name` is given (matching
+     * platform's `getPresentationName()`, which falls back to `Piano #{number}`)
+     * and as the plan's structural identity for the agent layer.
+     */
     number: string | number;
     /**
-     * Override the eyebrow's plan-number label (e.g. a consumer's own
-     * `Plan #15`). Defaults to the localised `Care plan {{number}}` shared with
-     * `CarePlanCard`, so the two surfaces read alike unless a consumer opts out.
+     * Override the number-as-heading label (e.g. a consumer's own `Plan #15`),
+     * used ONLY when no `name` is given. Defaults to the localised
+     * `Care plan {{number}}` shared with `CarePlanCard`, so the two surfaces read
+     * alike unless a consumer opts out. With a `name` present the number is not
+     * shown — platform draws no separate plan-number eyebrow.
      */
     numberLabel?: ReactNode;
     /** Plan name — the title heading. Omit for a number-only header. */
@@ -77,7 +83,12 @@ export interface CarePlanHeaderProps extends Omit<HTMLAttributes<HTMLElement>, '
     alerts?: CarePlanHeaderAlert[];
     /** Consumer-labelled meta facts (operator, price list, …) in the footer. */
     meta?: CarePlanHeaderMetaItem[];
-    /** Lifecycle dates rendered as a muted `Timestamp` line. */
+    /**
+     * Lifecycle dates. The date matching the current `state` is folded into the
+     * lifecycle badge (e.g. "Accepted · {date}"), making the badge self-describing;
+     * any other date (e.g. the acceptance date of a now-closed plan) renders as a
+     * muted `Timestamp` line beneath the meta.
+     */
     dates?: CarePlanHeaderDates;
     /** Inline-end actions slot (e.g. Share / Print). */
     actions?: ReactNode;

package/dist/components/care-plan-header/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as n } from "../../_chunks/care-plan-header-BUwqDTtz.js";
+import { C as r, c as n } from "../../_chunks/care-plan-header-DcXFXWit.js";
 export {
   r as CarePlanHeader,
   n as carePlanHeaderAgent

package/dist/components/chat-message/index.js

@@ -1,4 +1,4 @@
-import { C as s } from "../../_chunks/chat-message-3V54YipB.js";
+import { C as s } from "../../_chunks/chat-message-DzpcJR-q.js";
 export {
   s as ChatMessage
 };

package/dist/components/city-input/city-input.agent.d.ts

@@ -0,0 +1,8 @@
+import type { AgentAdapter } from '../../agent/types';
+export interface CityInputHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+}
+export declare const cityInputAgent: AgentAdapter<CityInputHandle>;
+//# sourceMappingURL=city-input.agent.d.ts.map