@alfadocs/ui-kit 1.53.0 → 1.54.1

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.53.0",
+  "packageVersion": "1.54.1",
   "components": [
     {
       "kind": "component",
@@ -4173,6 +4173,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "dev-bypass-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dev-bypass-button",
+          "description": "Marks the development-only shortcut button. It must never appear in production HTML: the host renders it only when its server reports a development environment. The host pattern declares what the shortcut does and how safe it is."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "dialog",
@@ -16832,108 +16846,6 @@
         }
       ]
     },
-    {
-      "kind": "pattern",
-      "id": "auth-layout",
-      "composes": [
-        {
-          "component": "card",
-          "as": "shell"
-        },
-        {
-          "component": "logo",
-          "as": "brandmark"
-        },
-        {
-          "component": "form-field",
-          "as": "field"
-        },
-        {
-          "component": "text-input",
-          "as": "email"
-        },
-        {
-          "component": "password-input",
-          "as": "password"
-        },
-        {
-          "component": "checkbox",
-          "as": "acceptTerms"
-        },
-        {
-          "component": "button",
-          "as": "submit"
-        },
-        {
-          "component": "alert",
-          "as": "notice"
-        }
-      ],
-      "workflows": [
-        {
-          "name": "sign_in",
-          "safety": "write",
-          "description": "Fill the email + password fields and submit the login form.",
-          "descriptionKey": "ui.agent.authLayout.workflows.signIn",
-          "uiActions": [
-            "text-input.set_value",
-            "password-input.set_value"
-          ],
-          "stateReads": [
-            "text-input.value",
-            "password-input.isEmpty"
-          ],
-          "apiActions": [
-            "session.create"
-          ]
-        },
-        {
-          "name": "sign_up",
-          "safety": "write",
-          "description": "Fill name, work email, password + confirmation, accept the terms, and create an account.",
-          "descriptionKey": "ui.agent.authLayout.workflows.signUp",
-          "uiActions": [
-            "text-input.set_value",
-            "password-input.set_value",
-            "checkbox.set_checked"
-          ],
-          "stateReads": [
-            "checkbox.checked"
-          ],
-          "apiActions": [
-            "account.create"
-          ]
-        },
-        {
-          "name": "request_password_reset",
-          "safety": "write",
-          "description": "Enter the account email on the forgot-password form and request a reset link.",
-          "descriptionKey": "ui.agent.authLayout.workflows.requestPasswordReset",
-          "uiActions": [
-            "text-input.set_value"
-          ],
-          "stateReads": [
-            "text-input.value"
-          ],
-          "apiActions": [
-            "password.requestReset"
-          ]
-        },
-        {
-          "name": "toggle_password_visibility",
-          "safety": "read",
-          "description": "Reveal or hide the entered password.",
-          "descriptionKey": "ui.agent.authLayout.workflows.togglePasswordVisibility",
-          "uiActions": [
-            "password-input.toggle_visibility"
-          ],
-          "stateReads": [
-            "password-input.isRevealed"
-          ],
-          "apiActions": []
-        }
-      ]
-    },
     {
       "kind": "pattern",
       "id": "calendar",
@@ -19128,6 +19040,64 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "forgot-password-form",
+      "composes": [
+        {
+          "component": "card",
+          "as": "card"
+        },
+        {
+          "component": "alert",
+          "as": "formError"
+        },
+        {
+          "component": "alert",
+          "as": "confirmation"
+        },
+        {
+          "component": "form-field",
+          "as": "field"
+        },
+        {
+          "component": "email-input",
+          "as": "email"
+        },
+        {
+          "component": "button",
+          "as": "submit"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "read_form",
+          "safety": "read",
+          "description": "Read where the request stands. The root carries `data-state`: `asking` while the form shows, `sent` once the confirmation has taken its place (`data-slot=\"confirmation\"`). While asking, the email sits in `data-field=\"email\"`, with `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element when it has a problem; a message about the whole request is in `data-field=\"form\"`. The confirmation is the same for every address: it does not say whether an account exists.",
+          "descriptionKey": "ui.agent.forgotPasswordForm.workflows.readForm",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "request_reset_link",
+          "safety": "write",
+          "description": "Ask for a password reset link (`data-action=\"submit\"`). The person types the email themselves; the form does not submit until it is a valid address. The host then sends the link, through its `onSubmit` handler or a native form post, and shows the confirmation for every address, whether or not an account exists for it.",
+          "descriptionKey": "ui.agent.forgotPasswordForm.workflows.requestResetLink",
+          "uiActions": [],
+          "apiActions": [
+            "auth.requestPasswordReset"
+          ]
+        },
+        {
+          "name": "back_to_sign_in",
+          "safety": "read",
+          "description": "Go back to the sign-in page (`data-action=\"login\"`). Present only when the host gives its address.",
+          "descriptionKey": "ui.agent.forgotPasswordForm.workflows.backToSignIn",
+          "uiActions": [],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "help-me-write-templates",
@@ -19355,6 +19325,76 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "login-form",
+      "composes": [
+        {
+          "component": "card",
+          "as": "card"
+        },
+        {
+          "component": "alert",
+          "as": "formError"
+        },
+        {
+          "component": "form-field",
+          "as": "field"
+        },
+        {
+          "component": "email-input",
+          "as": "email"
+        },
+        {
+          "component": "password-input",
+          "as": "password"
+        },
+        {
+          "component": "button",
+          "as": "submit"
+        },
+        {
+          "component": "matrix-rain",
+          "as": "devCardBackdrop"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "read_form",
+          "safety": "read",
+          "description": "Read the sign-in form and what is wrong with it. Each field sits in a wrapper with `data-field` (`email`, `password`). A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form, such as a refused sign-in, is in `data-field=\"form\"`; it never says which of the two values was wrong. Never read or repeat the password.",
+          "descriptionKey": "ui.agent.loginForm.workflows.readForm",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "sign_in",
+          "safety": "write",
+          "description": "Sign in (`data-action=\"submit\"`). The person types the email and the password themselves; the form does not submit until the email is a valid address and the password is not empty, and moves focus to the first field that is not. The host then signs the person in: through its `onSubmit` handler, or as a native form post to its own field names.",
+          "descriptionKey": "ui.agent.loginForm.workflows.signIn",
+          "uiActions": [],
+          "apiActions": [
+            "auth.signIn"
+          ]
+        },
+        {
+          "name": "forgot_password",
+          "safety": "read",
+          "description": "Go to the page that asks for a password reset link (`data-action=\"forgot-password\"`). Present only when the host gives its address.",
+          "descriptionKey": "ui.agent.loginForm.workflows.forgotPassword",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "dev_sign_in",
+          "safety": "write",
+          "description": "Development only: follow one of the quick sign-in links (`data-action=\"dev-login\"`, inside `data-component=\"login-dev-card\"`). Each leads to a route on the host that signs a test account in. The kit holds no test data. The card is present only when the host's server reports a development environment, and the server refuses those routes anywhere else.",
+          "descriptionKey": "ui.agent.loginForm.workflows.devSignIn",
+          "uiActions": [],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "marketplace-app-shell",
@@ -21340,6 +21380,100 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "registration-form",
+      "composes": [
+        {
+          "component": "card",
+          "as": "card"
+        },
+        {
+          "component": "alert",
+          "as": "formError"
+        },
+        {
+          "component": "form-field",
+          "as": "field"
+        },
+        {
+          "component": "text-input",
+          "as": "firstName"
+        },
+        {
+          "component": "text-input",
+          "as": "lastName"
+        },
+        {
+          "component": "email-input",
+          "as": "email"
+        },
+        {
+          "component": "email-input",
+          "as": "emailConfirm"
+        },
+        {
+          "component": "password-input",
+          "as": "password"
+        },
+        {
+          "component": "password-input",
+          "as": "passwordConfirm"
+        },
+        {
+          "component": "phone-input",
+          "as": "phone"
+        },
+        {
+          "component": "select",
+          "as": "branch"
+        },
+        {
+          "component": "checkbox",
+          "as": "terms"
+        },
+        {
+          "component": "recaptcha-widget",
+          "as": "captcha"
+        },
+        {
+          "component": "button",
+          "as": "submit"
+        },
+        {
+          "component": "dev-bypass-button",
+          "as": "devBypass"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "read_form",
+          "safety": "read",
+          "description": "Read which fields the form asks for and which have a problem. The host picks the fields, so read them from the page: each one that shows sits in a wrapper with `data-field`. A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form is in `data-field=\"form\"`. An email the person cannot change is marked `readonly`. Never read or repeat the password fields.",
+          "descriptionKey": "ui.agent.registrationForm.workflows.readForm",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "register",
+          "safety": "write",
+          "description": "Create the account (`data-action=\"submit\"`). The person fills in the fields and accepts the terms themselves; the form does not submit until every field is valid, and moves focus to the first one that is not. The host then registers the account: through its `onSubmit` handler, or as a native form post to its own field names.",
+          "descriptionKey": "ui.agent.registrationForm.workflows.register",
+          "uiActions": [],
+          "apiActions": [
+            "account.register"
+          ]
+        },
+        {
+          "name": "dev_bypass",
+          "safety": "write",
+          "description": "Development only: press the shortcut (`data-component=\"dev-bypass-button\"`). It puts the values the host supplied into the fields that show, as if typed, and submits the form through the normal path when the host asked for that; a host may instead run a handler of its own, such as a development-only route. The kit holds no test data. The button is present only when the host's server reports a development environment, and what it submits is checked by the server like any other submit.",
+          "descriptionKey": "ui.agent.registrationForm.workflows.devBypass",
+          "uiActions": [],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "roi-dashboard",
@@ -22355,6 +22489,58 @@
         }
       ]
     },
+    {
+      "kind": "pattern",
+      "id": "signed-out-frame",
+      "composes": [
+        {
+          "component": "app-frame",
+          "as": "frame"
+        },
+        {
+          "component": "header",
+          "as": "header"
+        },
+        {
+          "component": "logo",
+          "as": "brand"
+        },
+        {
+          "component": "button",
+          "as": "headerLink"
+        },
+        {
+          "component": "public-footer",
+          "as": "footer"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "read_page",
+          "safety": "read",
+          "description": "Read the page a signed-out visitor is on. The page's content is inside `<main>` (the header's skip link points at it). The header (`role=\"banner\"`) holds the brand link and, when the host gives their addresses, links to the other signed-out pages: `data-action=\"login\"`, `data-action=\"register-doctor\"`, `data-action=\"register-patient\"`. There is no search, inbox or account menu before sign-in. The footer (`role=\"contentinfo\"`) links to the privacy policy and the terms.",
+          "descriptionKey": "ui.agent.signedOutFrame.workflows.readPage",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "go_to_sign_in",
+          "safety": "read",
+          "description": "Follow the header's \"Sign in\" link (`data-action=\"login\"`). Present on a registration or forgot-password page, when the host gives its address.",
+          "descriptionKey": "ui.agent.signedOutFrame.workflows.goToSignIn",
+          "uiActions": [],
+          "apiActions": []
+        },
+        {
+          "name": "go_to_registration",
+          "safety": "read",
+          "description": "Follow one of the header's registration links: `data-action=\"register-doctor\"` or `data-action=\"register-patient\"`. Present on the login page, for each address the host gives. Each link is in the page twice, once with its label for wide screens and once as an icon for narrow ones, and only one of the two is shown: follow the one that is visible.",
+          "descriptionKey": "ui.agent.signedOutFrame.workflows.goToRegistration",
+          "uiActions": [],
+          "apiActions": []
+        }
+      ]
+    },
     {
       "kind": "pattern",
       "id": "signing",

package/dist/agent-i18n/en.json

@@ -1664,14 +1664,6 @@
         "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."
-      }
-    },
     "aestheticCarePlanEditor": {
       "workflows": {
         "selectPlan": "Open one of the patient's aesthetic-medicine care plans from the plan list.",
@@ -1793,6 +1785,13 @@
         "retry": "Try the failed page again (`data-action=\"retry\"`). By default this reloads the page."
       }
     },
+    "forgotPasswordForm": {
+      "workflows": {
+        "readForm": "Read where the request stands. The root carries `data-state`: `asking` while the form shows, `sent` once the confirmation has taken its place (`data-slot=\"confirmation\"`). While asking, the email sits in `data-field=\"email\"`, with `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element when it has a problem; a message about the whole request is in `data-field=\"form\"`. The confirmation is the same for every address: it does not say whether an account exists.",
+        "requestResetLink": "Ask for a password reset link (`data-action=\"submit\"`). The person types the email themselves; the form does not submit until it is a valid address. The host then sends the link, through its `onSubmit` handler or a native form post, and shows the confirmation for every address, whether or not an account exists for it.",
+        "backToSignIn": "Go back to the sign-in page (`data-action=\"login\"`). Present only when the host gives its address."
+      }
+    },
     "helpMeWriteTemplates": {
       "workflows": {
         "runTemplate": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (default first). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
@@ -1812,6 +1811,14 @@
         "deleteInvoice": "Delete the selected invoice from its row action. Paid invoices cannot be deleted. Irreversible."
       }
     },
+    "loginForm": {
+      "workflows": {
+        "readForm": "Read the sign-in form and what is wrong with it. Each field sits in a wrapper with `data-field` (`email`, `password`). A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form, such as a refused sign-in, is in `data-field=\"form\"`; it never says which of the two values was wrong. Never read or repeat the password.",
+        "signIn": "Sign in (`data-action=\"submit\"`). The person types the email and the password themselves; the form does not submit until the email is a valid address and the password is not empty, and moves focus to the first field that is not. The host then signs the person in: through its `onSubmit` handler, or as a native form post to its own field names.",
+        "forgotPassword": "Go to the page that asks for a password reset link (`data-action=\"forgot-password\"`). Present only when the host gives its address.",
+        "devSignIn": "Development only: follow one of the quick sign-in links (`data-action=\"dev-login\"`, inside `data-component=\"login-dev-card\"`). Each leads to a route on the host that signs a test account in. The kit holds no test data. The card is present only when the host's server reports a development environment, and the server refuses those routes anywhere else."
+      }
+    },
     "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.",
@@ -1936,6 +1943,13 @@
         "abandonBooking": "Clear an in-progress booking back to an empty flow. Destructive: everything the patient has entered — service, operator, slot and any details already typed — is lost and cannot be recovered from the UI. Confirm with the patient first."
       }
     },
+    "registrationForm": {
+      "workflows": {
+        "readForm": "Read which fields the form asks for and which have a problem. The host picks the fields, so read them from the page: each one that shows sits in a wrapper with `data-field`. A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form is in `data-field=\"form\"`. An email the person cannot change is marked `readonly`. Never read or repeat the password fields.",
+        "register": "Create the account (`data-action=\"submit\"`). The person fills in the fields and accepts the terms themselves; the form does not submit until every field is valid, and moves focus to the first one that is not. The host then registers the account: through its `onSubmit` handler, or as a native form post to its own field names.",
+        "devBypass": "Development only: press the shortcut (`data-component=\"dev-bypass-button\"`). It puts the values the host supplied into the fields that show, as if typed, and submits the form through the normal path when the host asked for that; a host may instead run a handler of its own, such as a development-only route. The kit holds no test data. The button is present only when the host's server reports a development environment, and what it submits is checked by the server like any other submit."
+      }
+    },
     "roiDashboard": {
       "workflows": {
         "viewFunnel": "Read the patient-journey funnel — per-stage efficiency, time saved, and potential for the selected period.",
@@ -1999,6 +2013,13 @@
         "dismiss": "Close the modal without sending a signature request. Discards the in-progress operator, roster, channel, and OTP choices."
       }
     },
+    "signedOutFrame": {
+      "workflows": {
+        "readPage": "Read the page a signed-out visitor is on. The page's content is inside `<main>` (the header's skip link points at it). The header (`role=\"banner\"`) holds the brand link and, when the host gives their addresses, links to the other signed-out pages: `data-action=\"login\"`, `data-action=\"register-doctor\"`, `data-action=\"register-patient\"`. There is no search, inbox or account menu before sign-in. The footer (`role=\"contentinfo\"`) links to the privacy policy and the terms.",
+        "goToSignIn": "Follow the header's \"Sign in\" link (`data-action=\"login\"`). Present on a registration or forgot-password page, when the host gives its address.",
+        "goToRegistration": "Follow one of the header's registration links: `data-action=\"register-doctor\"` or `data-action=\"register-patient\"`. Present on the login page, for each address the host gives. Each link is in the page twice, once with its label for wide screens and once as an icon for narrow ones, and only one of the two is shown: follow the one that is visible."
+      }
+    },
     "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.",

package/dist/brand/logo-asset/Alfadocs_Logo_Main.d.ts

@@ -10,5 +10,6 @@
  * use `Alfadocs_Logo_Neg` or `Alfadocs_Logo_Mark`.
  */
 import { type SVGProps } from 'react';
-export declare const AlfadocsLogoMain: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+import type { AlfadocsMarkPieceProps } from './mark-piece';
+export declare const AlfadocsLogoMain: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement> & AlfadocsMarkPieceProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
 //# sourceMappingURL=Alfadocs_Logo_Main.d.ts.map

package/dist/brand/logo-asset/Alfadocs_Logo_Mark.d.ts

@@ -9,5 +9,6 @@
  * `--primary` (or to a consumer-provided tint).
  */
 import { type SVGProps } from 'react';
-export declare const AlfadocsLogoMark: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+import type { AlfadocsMarkPieceProps } from './mark-piece';
+export declare const AlfadocsLogoMark: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement> & AlfadocsMarkPieceProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
 //# sourceMappingURL=Alfadocs_Logo_Mark.d.ts.map

package/dist/brand/logo-asset/Alfadocs_Logo_Neg.d.ts

@@ -8,5 +8,6 @@
  * monochrome print, or the generic accessible theme.
  */
 import { type SVGProps } from 'react';
-export declare const AlfadocsLogoNeg: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+import type { AlfadocsMarkPieceProps } from './mark-piece';
+export declare const AlfadocsLogoNeg: import("react").ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement> & AlfadocsMarkPieceProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
 //# sourceMappingURL=Alfadocs_Logo_Neg.d.ts.map

package/dist/brand/logo-asset/index.d.ts

@@ -3,4 +3,5 @@ export { AlfadocsLogoNeg } from './Alfadocs_Logo_Neg';
 export { AlfadocsLogoPurple } from './Alfadocs_Logo_Purple';
 export { AlfadocsLogoBW } from './Alfadocs_Logo_BW';
 export { AlfadocsLogoMark } from './Alfadocs_Logo_Mark';
+export type { AlfadocsMarkPiece, AlfadocsMarkPieceProps } from './mark-piece';
 //# sourceMappingURL=index.d.ts.map

package/dist/brand/logo-asset/mark-piece.d.ts

@@ -0,0 +1,10 @@
+/** The four pieces of the mark, clockwise from the top. */
+export type AlfadocsMarkPiece = 'top' | 'right' | 'bottom' | 'left';
+export interface AlfadocsMarkPieceProps {
+    /**
+     * Extra classes for each piece of the mark, e.g. the prism's drift
+     * (`hooks/use-prism`). Each piece also carries `data-shape="<piece>"`.
+     */
+    pieceClassName?: Partial<Record<AlfadocsMarkPiece, string>>;
+}
+//# sourceMappingURL=mark-piece.d.ts.map

package/dist/components/_shared/safe-href.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Address checks for links and form targets that a host passes in.
+ *
+ * Both parse the address the way the browser will, so a `javascript:`
+ * address cannot slip through behind whitespace or a line break, and an
+ * address such as `//other.example`, `/\other.example` or a tab-split
+ * `/<tab>/other.example` cannot pass as a path on this site.
+ */
+/**
+ * True for an address a link may point at: a path on the same site, or a
+ * web, mail or phone address written out in full. A relative address
+ * that would lead off the site is refused.
+ */
+export declare function isSafeHref(href: string): boolean;
+/**
+ * True for an address on this site only: a path, or a web address whose
+ * origin is the page's own. Use it where data is sent, such as a form's
+ * `action`: another site must never receive what the user typed.
+ */
+export declare function isSameSiteHref(href: string): boolean;
+//# sourceMappingURL=safe-href.d.ts.map

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

@@ -1,4 +1,4 @@
-import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-Bp816Mb1.js";
+import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-BBZ0u_U1.js";
 export {
   o as AddressAutocomplete,
   t as addressAutocompleteAgent,

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

@@ -21,6 +21,13 @@ export interface AddressFieldsProps {
     /** …or a mock/real suggestion injector (wins over apiKey, like AddressAutocomplete). */
     getSuggestions?: GetSuggestions;
     layout?: 'stacked' | 'grid';
+    /** Marks fields as required: `true` for every field shown, or a list
+     *  of the ones that are (a province is mandatory in some countries
+     *  only). The host still validates. */
+    required?: boolean | readonly (AddressFieldKey | 'country')[];
+    /** An error message per field, shown under it. The host validates and
+     *  decides when to show each one. */
+    errors?: Partial<Record<AddressFieldKey | 'country', string>>;
     disabled?: boolean;
     id?: string;
     className?: string;

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

@@ -1,4 +1,4 @@
-import { A as e, a } from "../../_chunks/address-fields-BIL6cvLS.js";
+import { A as e, a } from "../../_chunks/address-fields-1pD-8hML.js";
 export {
   e as AddressFields,
   a as addressFieldsAgent

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

@@ -1,4 +1,4 @@
-import { A as r, a as g } from "../../_chunks/agenda-tray-C2a8OfKC.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-B8vuZKjH.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

package/dist/components/ai-credits-notice/index.js

@@ -1,4 +1,4 @@
-import { A as i } from "../../_chunks/ai-credits-notice-Da0fJPXO.js";
+import { A as i } from "../../_chunks/ai-credits-notice-D9_qP2xc.js";
 import { a as r } from "../../_chunks/ai-credits-notice.agent-C9L7orrP.js";
 export {
   i as AiCreditsNotice,

package/dist/components/ai-permission-notice/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-permission-notice-C5q_uHBA.js";
+import { A as e, a as o } from "../../_chunks/ai-permission-notice-Cr6o1f0f.js";
 export {
   e as AiConsentBanner,
   o as aiConsentBannerAgent

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

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

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

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

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

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