@alfadocs/ui-kit 1.46.0 → 1.47.1

package/dist/_chunks/{phone-input-BsZIoE36.js → phone-input-IWrGOCwm.js}

@@ -1,12 +1,12 @@
 import { jsxs as m, jsx as r } from "react/jsx-runtime";
-import { forwardRef as Te, useContext as Ae, useMemo as b, useState as $, useRef as B, useEffect as ue, useCallback as ce } from "react";
+import { forwardRef as Te, useContext as Ae, useMemo as b, useState as B, useRef as K, useEffect as ue, useCallback as ce } from "react";
 import { u as $e } from "./registry-DvAUVLHh.js";
 import { u as Be } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
-import * as K from "@radix-ui/react-popover";
+import * as L from "@radix-ui/react-popover";
 import { R as Ke, _ as N } from "./index-4xgbg-sn.js";
 import { c as ee } from "./index-D2ZczOXr.js";
 import { useTranslation as Le } from "react-i18next";
-import { getCountries as qe, parsePhoneNumberFromString as L, AsYouType as q, getCountryCallingCode as Me } from "libphonenumber-js/min";
+import { getCountries as qe, parsePhoneNumberFromString as q, AsYouType as M, getCountryCallingCode as Me } from "libphonenumber-js/min";
 import { u as He, F as _e } from "./form-field-context-B3APVHKx.js";
 import { c as Ge } from "./compose-refs-C0k0tdqF.js";
 import { n as J } from "./normalize-diacritics-BNGbFNlJ.js";
@@ -253,7 +253,7 @@ const rt = Te(
     popularCountries: V,
     allowedCountries: F,
     className: ge,
-    id: M,
+    id: H,
     name: be,
     required: ye,
     "aria-label": ve
@@ -265,7 +265,7 @@ const rt = Te(
       if (!F || F.length === 0) return null;
       const e = /* @__PURE__ */ new Set(), t = F.filter((n) => !h.has(n) || e.has(n) ? !1 : (e.add(n), !0));
       return t.length > 0 ? t : null;
-    }, [F, h]), xe = c !== null && c.length === 1, H = b(() => {
+    }, [F, h]), xe = c !== null && c.length === 1, _ = b(() => {
       const e = me(
         o,
         h,
@@ -274,23 +274,23 @@ const rt = Te(
         c
       ), t = a ?? l;
       if (t) {
-        const n = L(t);
+        const n = q(t);
         return n != null && n.country ? !c || c.includes(n.country) ? {
           country: n.country,
           display: n.formatNational(),
           pinned: !0
         } : {
           country: e,
-          display: new q(e).input(
+          display: new M(e).input(
             n.nationalNumber
           ),
           pinned: !0
         } : { country: e, display: t, pinned: !1 };
       }
       return { country: e, display: "", pinned: !1 };
-    }, []), [u, E] = $(H.country), [te, g] = $(
-      H.display
-    ), [_, G] = $(!1), [Ne, ne] = $(""), se = a !== void 0, O = B(""), j = B(null), D = B(H.pinned), T = B(null), we = Ge(Ce, T);
+    }, []), [u, E] = B(_.country), [te, g] = B(
+      _.display
+    ), [G, O] = B(!1), [Ne, ne] = B(""), se = a !== void 0, U = K(""), j = K(null), D = K(_.pinned), T = K(null), we = Ge(Ce, T);
     ue(() => {
       if (D.current) return;
       const e = me(
@@ -310,12 +310,12 @@ const rt = Te(
     ]), ue(() => {
       if (!se) return;
       const e = a ?? "";
-      if (e === O.current) return;
+      if (e === U.current) return;
       if (e === "") {
         g("");
         return;
       }
-      const t = L(e);
+      const t = q(e);
       t != null && t.country && (!c || c.includes(t.country)) ? (D.current = !0, E(t.country), g(t.formatNational())) : g(t ? t.formatNational() : e);
     }, [a, se, c]), Be(() => {
       if (j.current == null) return;
@@ -326,8 +326,8 @@ const rt = Te(
     });
     const C = ce(
       (e, t) => {
-        const n = L(e, t), p = (n == null ? void 0 : n.number) ?? "";
-        O.current = p, i == null || i(p, {
+        const n = q(e, t), p = (n == null ? void 0 : n.number) ?? "";
+        U.current = p, i == null || i(p, {
           country: t,
           isValid: (n == null ? void 0 : n.isValid()) ?? !1,
           isPossible: (n == null ? void 0 : n.isPossible()) ?? !1,
@@ -335,11 +335,11 @@ const rt = Te(
         });
       },
       [i]
-    ), ze = M ?? (k ? z.id : void 0), oe = (k ? z.disabled : !1) || !!y, Ie = (k ? z.required : !1) || !!ye, re = k ? z.invalid : !1, Se = re ? "error" : v, Re = k && z.describedBy ? z.describedBy : void 0, ke = he ?? w("inputs.phone.placeholder", "Phone number"), Pe = (e) => {
+    ), ze = H ?? (k ? z.id : void 0), oe = (k ? z.disabled : !1) || !!y, Ie = (k ? z.required : !1) || !!ye, re = k ? z.invalid : !1, Se = re ? "error" : v, Re = k && z.describedBy ? z.describedBy : void 0, ke = he ?? w("inputs.phone.placeholder", "Phone number"), Pe = (e) => {
       if (S) return;
-      const t = e.target, n = t.value, p = t.selectionStart ?? n.length, I = nt(n, p), Z = new q(u).input(n);
+      const t = e.target, n = t.value, p = t.selectionStart ?? n.length, I = nt(n, p), Z = new M(u).input(n);
       j.current = st(Z, I), g(Z), C(Z, u);
-    }, ae = O, Ve = b(
+    }, ae = U, Ve = b(
       () => ({
         getValue: () => ae.current,
         setValue: (e) => {
@@ -347,11 +347,11 @@ const rt = Te(
             g(""), C("", u);
             return;
           }
-          const t = L(e);
+          const t = q(e);
           if (t != null && t.country)
             D.current = !0, E(t.country), g(t.formatNational()), C(t.formatNational(), t.country);
           else {
-            const p = new q(u).input(e);
+            const p = new M(u).input(e);
             g(p), C(p, u);
           }
         },
@@ -365,14 +365,14 @@ const rt = Te(
       }),
       [u, C, ae]
     );
-    $e(Ue, Ve, M);
+    $e(Ue, Ve, H);
     const Fe = (e) => {
       if (e === u) {
-        G(!1);
+        O(!1);
         return;
       }
-      const t = te.replace(/\D/g, ""), n = new q(e), p = t ? n.input(t) : "";
-      D.current = !0, E(e), g(p), G(!1), ne(""), C(p, e), requestAnimationFrame(() => {
+      const t = te.replace(/\D/g, ""), n = new M(e), p = t ? n.input(t) : "";
+      D.current = !0, E(e), g(p), O(!1), ne(""), C(p, e), requestAnimationFrame(() => {
         var I;
         (I = T.current) == null || I.focus();
       });
@@ -386,16 +386,16 @@ const rt = Te(
       if (!V || V.length === 0) return [];
       const e = new Map(x.map((t) => [t.code, t]));
       return V.filter((t) => h.has(t)).map((t) => e.get(t)).filter((t) => !!t);
-    }, [V, x, h]), U = b(
+    }, [V, x, h]), W = b(
       () => new Set(P.map((e) => e.code)),
       [P]
     ), Ee = b(
-      () => U.size > 0 ? x.filter((e) => !U.has(e.code)) : x,
-      [x, U]
+      () => W.size > 0 ? x.filter((e) => !W.has(e.code)) : x,
+      [x, W]
     ), A = b(
       () => x.find((e) => e.code === u),
       [x, u]
-    ), W = A ? A.dialCode : "", ie = A ? A.name : u, Y = w("inputs.phone.countryPickerLabel", "Country"), je = `${Y}: ${ie}, +${W}`, De = ce(
+    ), Y = A ? A.dialCode : "", ie = A ? A.name : u, $ = w("inputs.phone.countryPickerLabel", "Country"), je = `${$}: ${ie}, +${Y}`, De = ce(
       (e, t, n) => {
         const p = J(e), I = J(t), le = n == null ? void 0 : n.map(J);
         return Ke(
@@ -431,7 +431,7 @@ const rt = Te(
       "div",
       {
         "data-component": "phone-input",
-        "data-component-id": M,
+        "data-component-id": H,
         "data-slot": "phone-input",
         className: We({
           size: d,
@@ -445,29 +445,29 @@ const rt = Te(
               "data-slot": "phone-country-fixed",
               className: `${pe({ size: d })} ds:cursor-default ds:hover:bg-transparent`,
               children: [
-                /* @__PURE__ */ r("span", { className: "ds:sr-only", children: `${Y}: ${ie}` }),
+                /* @__PURE__ */ r("span", { className: "ds:sr-only", children: `${$}: ${ie}` }),
                 /* @__PURE__ */ r(Q, { country: u, size: X[d] }),
                 /* @__PURE__ */ m("bdi", { dir: "ltr", className: "ds:tabular-nums", children: [
                   "+",
-                  W
+                  Y
                 ] })
               ]
             }
-          ) : /* @__PURE__ */ m(K.Root, { open: _, onOpenChange: G, children: [
-            /* @__PURE__ */ r(K.Trigger, { asChild: !0, children: /* @__PURE__ */ m(
+          ) : /* @__PURE__ */ m(L.Root, { open: G, onOpenChange: O, children: [
+            /* @__PURE__ */ r(L.Trigger, { asChild: !0, children: /* @__PURE__ */ m(
               "button",
               {
                 type: "button",
                 disabled: oe,
                 "aria-haspopup": "listbox",
-                "aria-expanded": _,
+                "aria-expanded": G,
                 "aria-label": je,
                 className: pe({ size: d }),
                 children: [
                   /* @__PURE__ */ r(Q, { country: u, size: X[d] }),
                   /* @__PURE__ */ m("bdi", { dir: "ltr", className: "ds:tabular-nums", children: [
                     "+",
-                    W
+                    Y
                   ] }),
                   /* @__PURE__ */ r(
                     Oe,
@@ -477,18 +477,19 @@ const rt = Te(
                         tt[d],
                         "ds:shrink-0 ds:text-muted-foreground",
                         "ds:transition-transform ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none",
-                        _ ? "ds:rotate-180" : ""
+                        G ? "ds:rotate-180" : ""
                       ].join(" ")
                     }
                   )
                 ]
               }
             ) }),
-            /* @__PURE__ */ r(K.Portal, { children: /* @__PURE__ */ r(
-              K.Content,
+            /* @__PURE__ */ r(L.Portal, { children: /* @__PURE__ */ r(
+              L.Content,
               {
                 sideOffset: 6,
                 align: "start",
+                "aria-label": $,
                 className: Ze,
                 children: /* @__PURE__ */ m(
                   N,
@@ -496,7 +497,7 @@ const rt = Te(
                     filter: De,
                     shouldFilter: !0,
                     loop: !0,
-                    label: Y,
+                    label: $,
                     children: [
                       /* @__PURE__ */ r(
                         N.Input,
@@ -577,4 +578,4 @@ export {
   pe as c,
   We as p
 };
-//# sourceMappingURL=phone-input-BsZIoE36.js.map
+//# sourceMappingURL=phone-input-IWrGOCwm.js.map

package/dist/_chunks/{stepper-accordion-DmVykr5F.js → stepper-accordion-jMR8NaOB.js}

@@ -176,6 +176,7 @@ const K = [
         value: w(n),
         onValueChange: I,
         collapsible: !1,
+        role: "group",
         "aria-label": V,
         id: x,
         "data-component": "stepper-accordion",
@@ -247,4 +248,4 @@ oe.displayName = "StepperAccordion";
 export {
   oe as S
 };
-//# sourceMappingURL=stepper-accordion-DmVykr5F.js.map
+//# sourceMappingURL=stepper-accordion-jMR8NaOB.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.46.0",
+  "packageVersion": "1.47.1",
   "components": [
     {
       "kind": "component",
@@ -1295,7 +1295,8 @@
           "safety": "destructive",
           "idempotent": true,
           "errors": [
-            "Resetting after submit has no effect — the flow is on step 8."
+            "Resetting after submit has no effect — the flow is on step 8.",
+            "Refused while a payment session is open (step 7): the consumer must cancel the hold first."
           ],
           "description": "Clear the booking value back to an empty state. Use to abandon an in-progress flow.",
           "descriptionKey": "ui.agent.booking.actions.reset"
@@ -8931,7 +8932,7 @@
         {
           "name": "complete",
           "type": "boolean",
-          "description": "True when Stripe reports the payment fields as complete. Read this before `submit` — outside preview mode the submit control is disabled while it is false, so the call will not be accepted.",
+          "description": "True when Stripe reports the payment fields, and any required billing address, as complete. Read this before `submit` — outside preview mode the submit control is disabled while it is false, so the call will not be accepted.",
           "descriptionKey": "ui.agent.paymentForm.state.complete"
         },
         {
@@ -8966,7 +8967,7 @@
           "name": "reset",
           "safety": "destructive",
           "idempotent": true,
-          "description": "Reset the form to its initial state. Loses any in-progress input, and discards the previous attempt — `status` returns to \"idle\" and `errorKey` / `paymentIntentId` to null.",
+          "description": "Clear recoverable errors and return their status to \"idle\". Stripe fields remain unchanged. Pending or paid attempts cannot be reset and require a new session.",
           "descriptionKey": "ui.agent.paymentForm.actions.reset"
         }
       ],

package/dist/agent-i18n/en.json

@@ -942,13 +942,13 @@
     "paymentForm": {
       "state": {
         "status": "Lifecycle of the current payment attempt. `succeeded` is only reached once Stripe confirmed the PaymentIntent; `failed` covers validation, decline and processor errors alike. Still `idle` after `submit` means the attempt never fired — Stripe had not mounted.",
-        "complete": "True when Stripe reports the payment fields as complete. Read this before `submit` — outside preview mode the submit control is disabled while it is false, so the call will not be accepted.",
+        "complete": "True when Stripe reports the payment fields, and any required billing address, as complete. Read this before `submit` — outside preview mode the submit control is disabled while it is false, so the call will not be accepted.",
         "errorKey": "i18n key of the current error (e.g. `payment.error.cardDeclined`), or null. The key is the structural datum — the translated message is free text and is never exposed.",
         "paymentIntentId": "Opaque Stripe PaymentIntent id once a charge succeeded, else null. The receipt — the attribution handle for the money that moved. Never the client secret."
       },
       "actions": {
         "submit": "Submit the payment. Charges the configured payment method — irreversible. Resolves once the attempt has settled; the outcome is never in the resolved value, so read `status`, then `errorKey` on failure or `paymentIntentId` on success.",
-        "reset": "Reset the form to its initial state. Loses any in-progress input, and discards the previous attempt — `status` returns to \"idle\" and `errorKey` / `paymentIntentId` to null."
+        "reset": "Clear recoverable errors and return their status to \"idle\". Stripe fields remain unchanged. Pending or paid attempts cannot be reset and require a new session."
       }
     },
     "pdfViewer": {

package/dist/components/booking/booking-types.d.ts

@@ -13,6 +13,48 @@ export interface BookingSpecialty {
     /** Restrict to operators-on-page when lockedOperatorId is set. */
     operatorIds?: string[];
 }
+/**
+ * One appointment payment, in currency minor units. Set it only when the
+ * platform AppointmentBookingReason.requireAdvancePayment is true.
+ */
+export interface BookingServicePayment {
+    /** No platform field: the consumer derives it, e.g. deposit when advanceAmount < price. */
+    kind: 'full' | 'deposit';
+    /** Platform advanceAmount (euros) x 100. NOT price, which only feeds priceLabel. */
+    amountCents: number;
+    /** Defaults to EUR, the only currency production charges. */
+    currencyCode?: string;
+}
+export interface BookingResolvedPayment extends BookingServicePayment {
+    serviceId: string;
+    currencyCode: string;
+}
+export interface BookingPaymentSession {
+    /** Opaque hold identity. Keep Stripe credentials in the consumer, keyed by this id. */
+    id: string;
+    payment: BookingResolvedPayment;
+}
+export interface BookingSubmitResult {
+    paymentSession: BookingPaymentSession;
+}
+export type BookingPaymentState = {
+    sessionId: string;
+    status: 'ready' | 'cancelled' | 'paid';
+} | {
+    sessionId: string;
+    status: 'processing';
+    phase: 'payment' | 'completion';
+} | {
+    sessionId: string;
+    status: 'failed';
+    phase: 'payment' | 'completion';
+    error?: ReactNode;
+};
+export interface BookingPaymentRenderContext {
+    session: BookingPaymentSession;
+    payment: BookingResolvedPayment;
+    state: BookingPaymentState;
+}
 export interface BookingService {
     id: string;
     label: string;
@@ -27,6 +69,8 @@ export interface BookingService {
      * string verbatim. Added in 1.6.0.
      */
     priceLabel?: string;
+    /** Mandatory online payment for this service only. Never inferred from priceLabel. */
+    payment?: BookingServicePayment;
     /** Required when useSpecialties is true. */
     specialtyId?: string;
     /** Operators who can perform this service. */
@@ -50,6 +94,8 @@ export interface BookingOperator {
 export interface BookingSlot {
     /** Opaque unique key within `availableSlots[date]`. */
     key: string;
+    /** Actual service booked when serviceIds contains several search alternatives. */
+    serviceId?: string;
     /** HH:mm 24h — used for display. */
     time: string;
     available: boolean;
@@ -70,6 +116,8 @@ export interface BookingDetails {
      * only when the service carries that text; omitted otherwise.
      */
     criticalInformationAccepted?: boolean;
+    /** Included only when the patient accepts this service's payment quote. */
+    paymentAccepted?: boolean;
     codiceFiscale?: string;
     dateOfBirth?: string;
     insuranceNumber?: string;
@@ -122,6 +170,7 @@ export interface BookingSubmitPayload {
     value: BookingValue;
     /** Fully populated + validated (privacy + terms ticked, required fields filled). */
     details: BookingDetails;
+    payment?: BookingResolvedPayment;
 }
 export interface BookingValidationResult {
     valid: boolean;
@@ -179,6 +228,16 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
     showReturningPatientFlag?: boolean;
     privacyPolicyUrl?: string;
     termsUrl?: string;
+    paymentTermsUrl?: string;
+    /** Publish paid only after the server verifies payment AND saves the appointment. */
+    paymentState?: BookingPaymentState;
+    /** Render PaymentForm here. The consumer owns Stripe credentials and completion calls. */
+    renderPayment?: (context: BookingPaymentRenderContext) => ReactNode;
+    /**
+     * Completion retry only: never render card entry or start another payment here.
+     * Supply it with renderPayment; without it a failed completion shows only the error.
+     */
+    renderPaymentCompletion?: (context: BookingPaymentRenderContext) => ReactNode;
     validateCodiceFiscale?: BookingValidator;
     validateInsuranceNumber?: BookingValidator;
     /** Default: false. Specialty auto-select on length=1 is always on. */
@@ -198,7 +257,7 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
     defaultConfirmationChannels?: ConfirmationChannel[];
     value: BookingValue;
     onChange: (next: BookingValue) => void;
-    onSubmit: (payload: BookingSubmitPayload) => void | Promise<void>;
+    onSubmit: (payload: BookingSubmitPayload) => void | BookingSubmitResult | Promise<void | BookingSubmitResult>;
     /**
      * Calendar/date-strip shimmer — set true while `availableDates` is being
      * fetched. When omitted, the kit falls back to `loadingSlots` for the

package/dist/components/booking/booking.d.ts

@@ -1,5 +1,5 @@
 import type { BookingProps } from './booking-types';
-export type { BookingDetails, BookingHandle, BookingOperator, BookingProps, BookingService, BookingSlot, BookingSpecialty, BookingSubmitPayload, BookingValidationResult, BookingValidator, BookingValue, BookingVariant, ConfirmationChannel, InsuranceType, } from './booking-types';
+export type { BookingPaymentSession, BookingPaymentState, BookingPaymentRenderContext, BookingSubmitResult, BookingServicePayment, BookingResolvedPayment, BookingDetails, BookingHandle, BookingOperator, BookingProps, BookingService, BookingSlot, BookingSpecialty, BookingSubmitPayload, BookingValidationResult, BookingValidator, BookingValue, BookingVariant, ConfirmationChannel, InsuranceType, } from './booking-types';
 export { CONFIRMATION_CHANNEL_ORDER } from './booking-types';
 export { OPERATORS_ALL } from './cascade';
 export declare const Booking: import("react").ForwardRefExoticComponent<BookingProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/booking/details-form.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import type { BookingDetails, BookingValidator, ConfirmationChannel } from './booking-types';
+import type { BookingDetails, BookingResolvedPayment, BookingValidator, ConfirmationChannel } from './booking-types';
 export interface BookingDetailsFormProps {
     value: Partial<BookingDetails>;
     onChange: (next: Partial<BookingDetails>) => void;
@@ -13,6 +13,10 @@ export interface BookingDetailsFormProps {
     showReturningPatientFlag?: boolean;
     privacyPolicyUrl?: string;
     termsUrl?: string;
+    payment?: BookingResolvedPayment;
+    paymentTermsUrl?: string;
+    /** Prevent submit when the selected service's payment cannot be resolved. */
+    paymentBlocked?: boolean;
     /**
      * The selected service's `criticalInformationToAccept`. When set (and not
      * blank), a "Before you book" block renders above the consents and the

package/dist/components/booking/index.d.ts

@@ -1,5 +1,5 @@
 export { Booking } from './booking';
-export type { BookingProps, BookingHandle, BookingVariant, BookingValue, BookingService, BookingSpecialty, BookingSlot, BookingOperator, BookingDetails, BookingSubmitPayload, BookingValidator, BookingValidationResult, ConfirmationChannel, InsuranceType, } from './booking';
+export type { BookingPaymentSession, BookingPaymentState, BookingPaymentRenderContext, BookingSubmitResult, BookingServicePayment, BookingResolvedPayment, BookingProps, BookingHandle, BookingVariant, BookingValue, BookingService, BookingSpecialty, BookingSlot, BookingOperator, BookingDetails, BookingSubmitPayload, BookingValidator, BookingValidationResult, ConfirmationChannel, InsuranceType, } from './booking';
 export { CONFIRMATION_CHANNEL_ORDER, OPERATORS_ALL } from './booking';
 export { bookingAgent } from './booking.agent';
 //# sourceMappingURL=index.d.ts.map

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

package/dist/components/booking/payment.d.ts

@@ -0,0 +1,9 @@
+import type { BookingResolvedPayment, BookingService, BookingSlot } from './booking-types';
+export declare function resolveServicePayment(service: BookingService): BookingResolvedPayment | undefined;
+/** Selected services are search alternatives, never a shopping basket. */
+export declare function resolveBookingPayment(services: BookingService[], serviceIds: string[], slot?: BookingSlot): {
+    payment?: BookingResolvedPayment;
+    blocked: boolean;
+};
+export declare function paymentIdentity(payment?: BookingResolvedPayment): string;
+//# sourceMappingURL=payment.d.ts.map

package/dist/components/booking/use-booking-payment.d.ts

@@ -0,0 +1,14 @@
+import type { BookingDetails, BookingPaymentSession, BookingProps, BookingSubmitPayload } from './booking-types';
+export declare function useBookingPayment({ services, value, availableSlots, onSubmit, onChange, paymentState, submitting, paymentTermsUrl, renderPayment, }: Pick<BookingProps, 'services' | 'value' | 'availableSlots' | 'onSubmit' | 'onChange' | 'paymentState' | 'submitting' | 'paymentTermsUrl' | 'renderPayment'>): {
+    payment: import("./booking-types").BookingResolvedPayment | undefined;
+    blocked: boolean;
+    state: import("./booking-types").BookingPaymentState | undefined;
+    activeSession: BookingPaymentSession | undefined;
+    submit: (details: BookingDetails) => Promise<void>;
+    reset: () => void;
+    status: "idle" | "submitting" | "payment" | "success" | "error";
+    snapshot?: BookingSubmitPayload;
+    session?: BookingPaymentSession;
+    cancelled?: boolean;
+};
+//# sourceMappingURL=use-booking-payment.d.ts.map

package/dist/components/control-room-rail/control-room-rail.d.ts

@@ -3,6 +3,11 @@ import { type ToolRailHandle, type ToolRailProps, type ToolRailTool } from '../t
 export type ControlRoomTool = ToolRailTool;
 /** Imperative handle — open / collapse a tool panel without the DOM. */
 export type ControlRoomRailHandle = ToolRailHandle;
+/** What one favourites write did, for the tool the user acted on. */
+export interface ControlRoomFavoriteChange {
+    toolId: string;
+    action: 'pin' | 'unpin' | 'reorder';
+}
 export interface ControlRoomRailProps extends Omit<ToolRailProps, 'tools' | 'onReorder' | 'formatReorderAnnouncement' | 'renderToolAffordance' | 'renderPanelHeader'> {
     /**
      * Explicit tool set. Omit to read the merged global + contextual tools from
@@ -35,8 +40,10 @@ export interface ControlRoomRailProps extends Omit<ToolRailProps, 'tools' | 'onR
      * marked `scope: 'global'` (Alia, Inbox) — pinning them on top by default.
      */
     defaultFavoriteIds?: string[];
-    /** Fires with the next favourites order whenever the user pins / reorders. */
-    onFavoriteIdsChange?: (next: string[]) => void;
+    /** Fires with the next favourites order whenever the user pins / reorders.
+     *  `change` names the tool acted on and what happened to it; it is
+     *  absent when the write changed nothing. */
+    onFavoriteIdsChange?: (next: string[], change?: ControlRoomFavoriteChange) => void;
     /** localStorage key for the uncontrolled favourites. */
     persistFavoritesKey?: string;
     /**

package/dist/components/control-room-rail/index.d.ts

@@ -1,5 +1,5 @@
 export { ControlRoomRail } from './control-room-rail';
-export type { ControlRoomRailProps, ControlRoomRailHandle, ControlRoomTool, } from './control-room-rail';
+export type { ControlRoomRailProps, ControlRoomRailHandle, ControlRoomFavoriteChange, ControlRoomTool, } from './control-room-rail';
 export { controlRoomRailAgent } from './control-room-rail.agent';
 export { ControlRoomProvider, useControlRoomTools, useControlRoomMergedTools, useControlRoomActions, } from './control-room-context';
 export type { ControlRoomProviderProps } from './control-room-context';

package/dist/components/control-room-rail/index.js

@@ -1,4 +1,4 @@
-import { C as r, a as l, c as a, u as t, b as e, d as n } from "../../_chunks/control-room-rail-Cv7GpMqX.js";
+import { C as r, a as l, c as a, u as t, b as e, d as n } from "../../_chunks/control-room-rail-CdBOXIqX.js";
 export {
   r as ControlRoomProvider,
   l as ControlRoomRail,

package/dist/components/freemium-paywall/index.js

@@ -1,4 +1,4 @@
-import { F as m, f as l } from "../../_chunks/freemium-paywall-Cz-O9lQD.js";
+import { F as m, f as l } from "../../_chunks/freemium-paywall-BaW5ODc9.js";
 export {
   m as FreemiumPaywall,
   l as freemiumPaywallAgent

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

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

package/dist/components/patient-summary-card/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as m } from "../../_chunks/patient-summary-card-DNzdYjxE.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-CmEFflGS.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/payment-form/index.d.ts

@@ -1,4 +1,4 @@
 export { PaymentForm, formatPaymentAmount, stripCardLikeDigits, stripeErrorCodeToI18nKey, paymentFormVariants, paymentSubmitButtonVariants, } from './payment-form';
-export type { PaymentFormProps, PaymentFormHandle, PaymentFormStatus, PaymentCurrency, } from './payment-form';
+export type { PaymentFormProps, PaymentFormHandle, PaymentFormStatus, PaymentFormIntentStatus, PaymentFormBillingDetails, PaymentCurrency, } from './payment-form';
 export { paymentFormAgent } from './payment-form.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/payment-form/index.js

@@ -1,4 +1,4 @@
-import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-BHMDqW9C.js";
+import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-DqJFiplX.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,

package/dist/components/payment-form/payment-form.d.ts

@@ -1,5 +1,19 @@
-import { type Stripe } from '@stripe/stripe-js';
+import type { Stripe } from '@stripe/stripe-js';
 export type PaymentCurrency = string;
+/** Stripe's known PaymentIntent states. Only `succeeded` means paid. */
+export type PaymentFormIntentStatus = 'requires_payment_method' | 'requires_confirmation' | 'requires_action' | 'processing' | 'requires_capture' | 'canceled' | 'succeeded';
+/** Complete invoicing address only. Never contains card details. */
+export interface PaymentFormBillingDetails {
+    name: string;
+    address: {
+        line1: string;
+        line2: string | null;
+        city: string;
+        state: string;
+        postalCode: string;
+        country: string;
+    };
+}
 export interface PaymentFormProps {
     /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
     id?: string;
@@ -18,6 +32,8 @@ export interface PaymentFormProps {
      * own intent type wins). Defaults to `'payment'`.
      */
     mode?: 'payment' | 'setup';
+    /** Restrict deferred Elements to cards. With a client secret, the server intent controls methods. */
+    cardOnly?: boolean;
     /**
      * Deferred-confirm callback. Called at submit time (after client-side
      * field validation succeeds) so your server can mint a PaymentIntent and
@@ -27,14 +43,20 @@ export interface PaymentFormProps {
      * charge is attempted.
      */
     onCreatePaymentIntent?: () => Promise<string>;
+    /** Preview-only validation completed. Awaited without creating or confirming a payment. */
+    onPreviewValidated?: () => void | Promise<void>;
     /** Stripe publishable key (`pk_test_…` / `pk_live_…`). */
     publishableKey: string;
+    /** Connected account used to create the intent. Ignored by an injected Stripe instance. */
+    stripeAccount?: string;
     /** ISO-4217 currency code (e.g. 'EUR', 'USD', 'JPY'). */
     currency: PaymentCurrency;
     /** Amount in the currency's smallest unit (cents for EUR/USD, yen for JPY). */
     amount: number;
     /** Called with the PaymentIntent id on successful confirmation. */
     onSuccess?: (paymentIntentId: string) => void;
+    /** Observes confirmed intent states, including payments still awaiting completion. */
+    onPaymentStatusChange?: (status: PaymentFormIntentStatus, paymentIntentId: string) => void;
     /** Called with a sanitised error (no PAN digits, no Stripe English strings). */
     onError?: (error: {
         code: string;
@@ -42,6 +64,16 @@ export interface PaymentFormProps {
     }) => void;
     /** Show the billing-address collector below the payment fields. */
     billingAddress?: boolean;
+    /** Show and require a complete billing address before confirming payment. */
+    requireBillingAddress?: boolean;
+    /** Initial name/address for each Elements session. Does not enable or validate the collector. */
+    defaultBillingDetails?: PaymentFormBillingDetails;
+    /**
+     * Save complete billing details before confirmation or any redirect. Enables
+     * the address collector; rejection blocks payment and permits a retry.
+     * Not called in validation-only preview mode. Never logs or stores details.
+     */
+    onBillingDetails?: (details: PaymentFormBillingDetails) => void | Promise<void>;
     /** Locale override — defaults to the active i18next locale. */
     locale?: string;
     /** Accessible label for the form. */
@@ -72,12 +104,12 @@ export interface PaymentFormHandle {
      * `getStatus()` / `getErrorKey()` afterwards for the outcome.
      */
     submit: () => Promise<void>;
-    /** Reset the form to its initial state. */
+    /** Clear recoverable errors. A pending or paid attempt requires a new session. */
     reset: () => void;
     /** Lifecycle of the current attempt. */
     getStatus: () => PaymentFormStatus;
     /**
-     * True when Stripe reports the payment fields as complete. `submit`
+     * True when Stripe reports the payment fields, and any required billing address, as complete. `submit`
      * is refused (the button is disabled) while this is false outside
      * preview mode.
      */