@alfadocs/ui-kit 0.25.2 → 0.30.1

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

@@ -0,0 +1,167 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+export type BookingVariant = 'inline-list' | 'accordion' | 'calendar' | 'flexible' | 'progress';
+export type InsuranceType = 'private' | 'public';
+/** Channels the patient can pick to receive the confirmation link. */
+export type ConfirmationChannel = 'email' | 'whatsapp' | 'sms';
+/** Fixed order — email first, then WhatsApp, then SMS. */
+export declare const CONFIRMATION_CHANNEL_ORDER: readonly ConfirmationChannel[];
+export interface BookingSpecialty {
+    id: string;
+    label: string;
+    /** Optional ordering hint; falls back to array order. */
+    sequenceNumber?: number;
+    /** Restrict to operators-on-page when lockedOperatorId is set. */
+    operatorIds?: string[];
+}
+export interface BookingService {
+    id: string;
+    label: string;
+    /** Minutes — required for slot fetching. */
+    durationMin: number;
+    /** Required when useSpecialties is true. */
+    specialtyId?: string;
+    /** Operators who can perform this service. */
+    operatorIds?: string[];
+}
+export interface BookingOperator {
+    id: string;
+    name: string;
+    specialtyIds?: string[];
+    appointmentBookingReasonIds?: string[];
+}
+export interface BookingSlot {
+    /** Opaque unique key within `availableSlots[date]`. */
+    key: string;
+    /** HH:mm 24h — used for display. */
+    time: string;
+    available: boolean;
+    /** Opaque passthrough so the consumer can resolve operatorId / chairId
+     *  / dateTime when `onSubmit` fires. */
+    meta?: Record<string, unknown>;
+}
+export interface BookingDetails {
+    firstName: string;
+    lastName: string;
+    email: string;
+    mobilePhone: string;
+    privacyConsent: boolean;
+    termsConsent: boolean;
+    codiceFiscale?: string;
+    dateOfBirth?: string;
+    insuranceNumber?: string;
+    note?: string;
+    returningPatient?: boolean;
+    /**
+     * Channels the patient picked for the confirmation link. Guaranteed to
+     * be a non-empty subset of the practice's enabled `confirmationChannels`
+     * when present. Omitted when only one channel is enabled (implicit —
+     * backend infers from the practice config).
+     */
+    confirmationChannels?: ConfirmationChannel[];
+}
+export interface BookingValue {
+    insuranceType?: InsuranceType;
+    specialtyId?: string;
+    serviceId?: string;
+    /** May be the literal `'all'` sentinel to mean "no operator preference". */
+    operatorId?: string;
+    /** YYYY-MM-DD. */
+    date?: string;
+    /** Opaque key from `availableSlots[date]`. */
+    slotKey?: string;
+    /** Partial details — fully populated when the user is ready to submit. */
+    details?: Partial<BookingDetails>;
+}
+export interface BookingSubmitPayload {
+    slot: BookingSlot;
+    value: BookingValue;
+    /** Fully populated + validated (privacy + terms ticked, required fields filled). */
+    details: BookingDetails;
+}
+export interface BookingValidationResult {
+    valid: boolean;
+    /** Optional localised hint shown next to the field on failure. */
+    hint?: string;
+}
+export type BookingValidator = (value: string) => Promise<BookingValidationResult>;
+export interface BookingHandle {
+    getVariant: () => BookingVariant;
+    /** Clear `value` back to an empty state via `onChange`. */
+    reset: () => void;
+    /**
+     * Jump to a specific step. Implementations may clamp to the first
+     * incomplete step if the requested one isn't reachable yet.
+     */
+    goToStep: (step: 1 | 2 | 3 | 4 | 5 | 6 | 7) => void;
+}
+export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'aria-label' | 'onChange' | 'onSubmit'> {
+    variant?: BookingVariant;
+    country?: string;
+    useSpecialties?: boolean;
+    allowOperatorSelection?: boolean;
+    /** Pins step 4 to this operator. */
+    lockedOperatorId?: string;
+    specialties?: BookingSpecialty[];
+    services: BookingService[];
+    operators?: BookingOperator[];
+    availableDates: string[];
+    availableSlots: Record<string, BookingSlot[]>;
+    /** Server-side hint of the next free date when the current window is empty. */
+    nextAvailableDate?: string;
+    requireCodiceFiscale?: boolean;
+    requireDateOfBirth?: boolean;
+    requireInsuranceNumber?: boolean;
+    showNote?: boolean;
+    showReturningPatientFlag?: boolean;
+    privacyPolicyUrl?: string;
+    termsUrl?: string;
+    validateCodiceFiscale?: BookingValidator;
+    validateInsuranceNumber?: BookingValidator;
+    /** Default: false. Specialty auto-select on length=1 is always on. */
+    autoSelectSingleService?: boolean;
+    /**
+     * Channels the practice has enabled. The picker renders one checkbox
+     * per channel; when length === 1, the picker is hidden and the single
+     * channel is implicit. Defaults to `['email']` when omitted.
+     */
+    confirmationChannels?: ConfirmationChannel[];
+    /**
+     * Pre-checked channels. Intersected with `confirmationChannels` for
+     * safety. When omitted, the kit applies a smart default (always email;
+     * +whatsapp when mobile is plausibly filled; +sms when whatsapp isn't
+     * available).
+     */
+    defaultConfirmationChannels?: ConfirmationChannel[];
+    value: BookingValue;
+    onChange: (next: BookingValue) => void;
+    onSubmit: (payload: BookingSubmitPayload) => void | Promise<void>;
+    loadingSlots?: boolean;
+    submitting?: boolean;
+    /**
+     * Surface a submit-failure message inside the form (Alert variant=destructive
+     * above the submit button). The consumer owns the state — set it after an
+     * `onSubmit` rejection, clear it when retrying or on a field edit. When set,
+     * the kit's normal "form stays mounted on rejected promise" behaviour is
+     * unchanged; this just gives the failure a sanctioned slot to render.
+     */
+    submitError?: ReactNode;
+    /**
+     * @default 'live'
+     * In `'demo'` mode the kit's step-8 success view swaps its description to
+     * a localised "This was a demo — no confirmation was sent." so the copy
+     * stays honest when no real API call was made.
+     */
+    mode?: 'live' | 'demo';
+    /**
+     * @default true
+     * Render a "Modify booking" button on the step-8 success view that returns
+     * to step 7 without clearing `value`/`details`. Practices that want a
+     * one-shot booking flow can hide this.
+     */
+    showModifyOnSuccess?: boolean;
+    emptyServicesSlot?: ReactNode;
+    onboardingIncompleteSlot?: ReactNode;
+    'aria-label'?: string;
+    id?: string;
+}
+//# sourceMappingURL=booking-types.d.ts.map

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

@@ -1,4 +1,4 @@
 import type { AgentAdapter } from '../../agent/types';
-import type { BookingHandle } from './booking';
+import type { BookingHandle } from './booking-types';
 export declare const bookingAgent: AgentAdapter<BookingHandle>;
 //# sourceMappingURL=booking.agent.d.ts.map

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

@@ -1,91 +1,6 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
-import { type VariantProps } from 'class-variance-authority';
-export type BookingVariant = 'inline-list' | 'accordion' | 'calendar' | 'flexible' | 'progress';
-/** Service offering rendered in the service selector of every variant. */
-export interface BookingService {
-    id: string;
-    /** Already-translated label (consumer owns data i18n). */
-    label: string;
-    /** Duration in minutes — shown alongside the label. */
-    durationMin: number;
-    /** Optional secondary line, e.g. "Prima visita o consulto". */
-    description?: string;
-    /** Optional price token — already formatted by the consumer. */
-    price?: string;
-    /** Optional payment hint — "Paga in studio" / "Paga online". */
-    paymentHint?: string;
-    /** Optional specialty id used to filter when a specialty chip is active. */
-    specialtyId?: string;
-    /** Optional icon — defaults to a stethoscope glyph. */
-    icon?: ReactNode;
-}
-/** Specialty chip rendered above the service list in `inline-list`. */
-export interface BookingSpecialty {
-    id: string;
-    label: string;
-    /**
-     * Optional icon override. When omitted, a keyword-based heuristic picks
-     * an icon from the specialty's label (cardio → HeartPulse, derma →
-     * Sparkles, etc.) and renders it in the accent colour.
-     */
-    icon?: ReactNode;
-}
-/** One slot in an `availableSlots[date]` array. */
-export interface BookingSlot {
-    /** Stable key — consumer-defined. Opaque to the component. */
-    key: string;
-    /** HH:mm 24h. */
-    time: string;
-    available: boolean;
-    /** Optional tooltip explaining a disabled slot. */
-    unavailableReason?: string;
-}
-/** Booking selection — controlled by the consumer. */
-export interface BookingValue {
-    serviceId?: string;
-    specialtyId?: string;
-    /** ISO yyyy-mm-dd. */
-    date?: string;
-    /** HH:mm 24h. */
-    time?: string;
-    /** Slot lookup key — opaque to the component; passed through to onSubmit. */
-    slotKey?: string;
-}
-declare const rootVariants: (props?: ({
-    variant?: "progress" | "calendar" | "accordion" | "inline-list" | "flexible" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'aria-label' | 'onChange' | 'onSubmit'>, VariantProps<typeof rootVariants> {
-    services: BookingService[];
-    /** Optional — hides the specialty chip row when absent. */
-    specialties?: BookingSpecialty[];
-    availableDates: string[];
-    availableSlots: Record<string, BookingSlot[]>;
-    value: BookingValue;
-    onChange: (next: BookingValue) => void;
-    onSubmit?: (value: BookingValue) => void;
-    /** Optional pre-filter slot rendered above the variant body. */
-    filtersSlot?: ReactNode;
-    /** Optional details/contact form rendered after the slot pick. */
-    detailsSlot?: ReactNode;
-    /** Optional sticky CTA strip below the body. */
-    ctaSlot?: ReactNode;
-    /** Header content. `null` omits the header. Defaults to variant title + subtitle. */
-    heading?: ReactNode;
-    loadingDates?: boolean;
-    loadingSlots?: boolean;
-    /** Override aria-label on the root region. */
-    'aria-label'?: string;
-    /** Agent-readiness instance id. */
-    id?: string;
-}
-export interface BookingHandle {
-    getCurrentStep: () => number;
-    getTotalSteps: () => number;
-    gotoStep: (step: number) => void;
-    next: () => void;
-    previous: () => void;
-    getVariant: () => BookingVariant;
-}
+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 { CONFIRMATION_CHANNEL_ORDER } from './booking-types';
+export { OPERATORS_ALL } from './cascade';
 export declare const Booking: import("react").ForwardRefExoticComponent<BookingProps & import("react").RefAttributes<HTMLDivElement>>;
-export {};
 //# sourceMappingURL=booking.d.ts.map

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

@@ -0,0 +1,96 @@
+import type { BookingOperator, BookingService, BookingSlot, BookingSpecialty, BookingValue, ConfirmationChannel, InsuranceType } from './booking-types';
+/**
+ * Sentinel for the operator filter's "All operators" pseudo-option. Mirrors
+ * `OPERATORS_ALL = '0'` in the legacy `useBookingState.js`, but the kit
+ * uses `'all'` as the well-known string so consumers can't accidentally
+ * collide with a real operator id of `'0'`.
+ */
+export declare const OPERATORS_ALL: "all";
+export interface CascadePolicy {
+    /** ISO 3166-1 alpha-2 country code. Currently only `'de'` toggles a gate. */
+    country?: string;
+    useSpecialties?: boolean;
+    allowOperatorSelection?: boolean;
+    /** When set, locks step 4 to this operator id and hides the picker. */
+    lockedOperatorId?: string;
+    /** Defaults to `false`. When true, single-service lists auto-pre-fill. */
+    autoSelectSingleService?: boolean;
+}
+export interface CascadeInputs extends CascadePolicy {
+    specialties: BookingSpecialty[];
+    services: BookingService[];
+    operators: BookingOperator[];
+    availableDates: string[];
+    availableSlots: Record<string, BookingSlot[]>;
+    value: BookingValue;
+}
+export interface CascadeGates {
+    insurance: boolean;
+    specialty: boolean;
+    service: boolean;
+    operator: boolean;
+    date: boolean;
+    slot: boolean;
+    details: boolean;
+    /** True when a service is picked but no eligible operators can perform it. */
+    onboardingIncomplete: boolean;
+}
+export interface CascadeFiltered {
+    specialties: BookingSpecialty[];
+    services: BookingService[];
+    /**
+     * Eligible operators for the active specialty (when `useSpecialties=true`)
+     * OR the active service. Excludes the "All operators" sentinel — that's
+     * always prepended in the UI layer.
+     */
+    operators: BookingOperator[];
+}
+/** Step number — 1-indexed, matches the docs / a11y order. */
+export type CascadeStep = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export interface CascadeOutputs {
+    gates: CascadeGates;
+    filtered: CascadeFiltered;
+    /** Current step: the first visible step that has an unfulfilled requirement. */
+    currentStep: CascadeStep;
+    /** Total visible steps (1..7 minus any auto-skipped). */
+    totalSteps: number;
+    /** Ordered list of the visible step indices, used by variants that show a stepper. */
+    visibleSteps: CascadeStep[];
+    /** Whether every required step is satisfied — the submit button is gated on this. */
+    isReadyToSubmit: boolean;
+    /** Selected service's duration, if any — needed for slot fetching. */
+    durationMin?: number;
+    /** Selected slot resolved from `value.date` + `value.slotKey`. */
+    selectedSlot?: BookingSlot;
+}
+export declare function deriveCascade(inputs: CascadeInputs): CascadeOutputs;
+export declare function resetOnInsuranceChange(value: BookingValue, next: InsuranceType | undefined): BookingValue;
+export declare function resetOnSpecialtyChange(value: BookingValue, next: string | undefined): BookingValue;
+export declare function resetOnServiceChange(value: BookingValue, next: string | undefined): BookingValue;
+export declare function resetOnOperatorChange(value: BookingValue, next: string | undefined): BookingValue;
+export declare function resetOnDateChange(value: BookingValue, next: string | undefined): BookingValue;
+export declare function resetOnSlotChange(value: BookingValue, next: string | undefined): BookingValue;
+export declare function applyAutoSelects(value: BookingValue, inputs: CascadePolicy & {
+    specialties: BookingSpecialty[];
+    services: BookingService[];
+}): BookingValue;
+/** Resolve the active operator id, treating the `'all'` sentinel as `undefined`. */
+export declare function resolveOperatorId(value: BookingValue): string | undefined;
+/**
+ * Resolve the effective list of enabled channels. Falls back to `['email']`
+ * when the consumer omits the prop, preserving the pre-amendment behaviour.
+ */
+export declare function resolveConfirmationChannels(enabled: ConfirmationChannel[] | undefined): ConfirmationChannel[];
+/**
+ * Compute the channels to pre-check. Result is intersected with `enabled`
+ * for safety so a channel the practice didn't enable never gets ticked.
+ *
+ * Rules (per spec):
+ *  1. Always include 'email'.
+ *  2. Include 'whatsapp' if enabled AND mobile looks plausible.
+ *  3. Include 'sms' ONLY when whatsapp is NOT in `enabled`.
+ *  4. If the consumer passes `override`, honour it verbatim (still
+ *     intersected with `enabled` for safety).
+ */
+export declare function defaultConfirmationSelection(enabled: ConfirmationChannel[] | undefined, mobile: string | undefined, override?: ConfirmationChannel[]): ConfirmationChannel[];
+//# sourceMappingURL=cascade.d.ts.map

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

@@ -0,0 +1,39 @@
+import { type ReactNode } from 'react';
+import type { BookingDetails, BookingValidator, ConfirmationChannel } from './booking-types';
+export interface BookingDetailsFormProps {
+    value: Partial<BookingDetails>;
+    onChange: (next: Partial<BookingDetails>) => void;
+    onSubmit: (details: BookingDetails) => void | Promise<void>;
+    requireCodiceFiscale?: boolean;
+    requireDateOfBirth?: boolean;
+    /** When `true` AND `insuranceType === 'public'`, render the Versichertennummer field. */
+    requireInsuranceNumber?: boolean;
+    insuranceType?: 'private' | 'public';
+    showNote?: boolean;
+    showReturningPatientFlag?: boolean;
+    privacyPolicyUrl?: string;
+    termsUrl?: string;
+    validateCodiceFiscale?: BookingValidator;
+    validateInsuranceNumber?: BookingValidator;
+    submitting?: boolean;
+    /** Optional summary node rendered above the form (e.g. confirm-time chip). */
+    summarySlot?: ReactNode;
+    defaultPhoneCountry?: string;
+    /**
+     * Channels the practice has enabled. When omitted, defaults to
+     * `['email']` (picker hidden — single implicit channel). When the
+     * resolved list has length 1 the picker stays hidden.
+     */
+    confirmationChannels?: ConfirmationChannel[];
+    /** Pre-checked channels override; falls back to a smart default. */
+    defaultConfirmationChannels?: ConfirmationChannel[];
+    /**
+     * Render an error Alert above the submit button. Set after an
+     * `onSubmit` rejection, clear before retrying. The kit doesn't
+     * disable the submit button while this is set — the patient can
+     * re-submit immediately.
+     */
+    submitError?: ReactNode;
+}
+export declare const BookingDetailsForm: import("react").ForwardRefExoticComponent<BookingDetailsFormProps & import("react").RefAttributes<HTMLFormElement>>;
+//# sourceMappingURL=details-form.d.ts.map

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

@@ -1,4 +1,5 @@
 export { Booking } from './booking';
-export type { BookingProps, BookingHandle, BookingVariant, BookingValue, BookingService, BookingSpecialty, BookingSlot, } from './booking';
+export type { 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,6 +1,8 @@
-import { B as n, b as a } from "../../_chunks/booking-CXngC-1u.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-Bw9eOU4k.js";
 export {
-  n as Booking,
-  a as bookingAgent
+  A as Booking,
+  R as CONFIRMATION_CHANNEL_ORDER,
+  a as OPERATORS_ALL,
+  s as bookingAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as l, r as n } from "../../_chunks/calendar-9eOXumpH.js";
+import { C as r, c as l, r as n } from "../../_chunks/calendar-WWNx448i.js";
 export {
   r as Calendar,
   l as calendarAgent,

package/dist/components/checkbox/checkbox.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentPropsWithoutRef } from 'react';
+import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import * as RadixCheckbox from '@radix-ui/react-checkbox';
 import { type VariantProps } from 'class-variance-authority';
 /** Agent-readiness curated handle for Checkbox. */
@@ -12,7 +12,11 @@ declare const checkboxVariants: (props?: ({
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type RadixRootProps = ComponentPropsWithoutRef<typeof RadixCheckbox.Root>;
 export interface CheckboxProps extends Omit<RadixRootProps, 'checked' | 'onCheckedChange' | 'children'>, VariantProps<typeof checkboxVariants> {
-    label: string;
+    /**
+     * Visible label rendered next to the box. Accepts a string or any React
+     * node — useful for consent labels that embed a privacy / T&C link.
+     */
+    label: ReactNode;
     checked?: boolean | 'indeterminate';
     onCheckedChange?: (checked: boolean | 'indeterminate') => void;
     size?: 'sm' | 'md' | 'lg';

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

@@ -1,4 +1,4 @@
-import { C as r } from "../../_chunks/contact-card-CeEfEAxh.js";
+import { C as r } from "../../_chunks/contact-card-DYbp--s-.js";
 export {
   r as ContactCard
 };

package/dist/components/header/index.js

@@ -1,4 +1,4 @@
-import { H as r, a as d, b as H, c as s, d as n, e as t, f as i, g as o } from "../../_chunks/header-B8V_sNPy.js";
+import { H as r, a as d, b as H, c as s, d as n, e as t, f as i, g as o } from "../../_chunks/header-CkMb1TZS.js";
 export {
   r as Header,
   d as HeaderBrand,

package/dist/components/index.d.ts

@@ -65,6 +65,7 @@ export * from './header';
 export * from './navigation-menu';
 export * from './link';
 export * from './pagination';
+export * from './public-footer';
 export * from './public-header';
 export * from './search-bar';
 export * from './sidebar';
@@ -116,8 +117,10 @@ export * from './transcript-panel';
 export * from './typing-indicator';
 export * from './booking';
 export * from './calendar';
+export * from './patient-search';
 export * from './payment-form';
 export * from './pdf-viewer';
+export * from './reviews-panel';
 export * from './rich-text-editor';
 export * from './signature-capture';
 export * from './slot-grid';

package/dist/components/link/index.js

@@ -1,4 +1,4 @@
-import { L } from "../../_chunks/link-DmM5IevO.js";
+import { L } from "../../_chunks/link-DrD_cRUg.js";
 export {
   L as Link
 };

package/dist/components/link/link.d.ts

@@ -23,6 +23,13 @@ export interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>,
      * trailing `ExternalLink` icon with an i18n'd aria-label.
      */
     external?: boolean;
+    /**
+     * Render the trailing external-link glyph. Default `true` — set to
+     * `false` for surfaces (footer, social rows, dense nav) where the
+     * indicator adds visual noise. The `target` / `rel` / "opens in new
+     * tab" aria-label are still applied.
+     */
+    externalIcon?: boolean;
     /**
      * Render the link in a non-interactive disabled state. Strips `href`,
      * adds `aria-disabled` + `role="link"`, suppresses the underline.

package/dist/components/patient-search/index.d.ts

@@ -0,0 +1,4 @@
+export { PatientSearch } from './patient-search';
+export type { PatientSearchProps, PatientSearchHandle, PatientSearchVariant, PatientSearchObject, PatientSearchPlace, DiscoveryCard, FacetGroup, FacetOption, SearchValue, WhenFilter, } from './patient-search';
+export { patientSearchAgent } from './patient-search.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { P as t, p as r } from "../../_chunks/patient-search-DuSoGG2t.js";
+export {
+  t as PatientSearch,
+  r as patientSearchAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/patient-search/patient-search.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { PatientSearchHandle } from './patient-search';
+export declare const patientSearchAgent: AgentAdapter<PatientSearchHandle>;
+//# sourceMappingURL=patient-search.agent.d.ts.map

package/dist/components/patient-search/patient-search.d.ts

@@ -0,0 +1,112 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+export type PatientSearchVariant = 'who-where' | 'who-where-when' | 'faceted' | 'discovery';
+export type WhenFilter = 'today' | 'tomorrow' | 'this_week' | 'anytime';
+/** Result from `loadObjects` — a profession, specialty, operator, or practice. */
+export interface PatientSearchObject {
+    /** Stable opaque key, e.g. `"profession:dentista"` or `"operator:mario-rossi-9001"`. */
+    value: string;
+    label: string;
+    description?: string;
+    /** Opaque consumer payload — used in `onObjectSelect` to route. */
+    __payload?: unknown;
+}
+/** Result from `loadPlaces` — a Google-Places-style place prediction. */
+export interface PatientSearchPlace {
+    /** Place ID or stable text. */
+    value: string;
+    /** Display label, e.g. `"Milano, Italia"`. */
+    label: string;
+    lat?: number;
+    lng?: number;
+}
+/** Curated card for the `discovery` variant. */
+export interface DiscoveryCard {
+    id: string;
+    label: string;
+    description?: string;
+    href: string;
+    icon?: ReactNode;
+    /**
+     * Accent token. `auto` rotates through the brand palette by row index.
+     * Defaults to `auto`.
+     */
+    accent?: 'violet' | 'purple' | 'magenta' | 'blue' | 'auto';
+    badge?: string;
+}
+export interface FacetOption {
+    value: string;
+    label: string;
+}
+export interface FacetGroup {
+    /** Stable key — e.g. `"insurance"`, `"language"`. */
+    key: string;
+    /** Display label, e.g. `"Convenzione"`. */
+    label: string;
+    /** Empty array = boolean toggle chip. Non-empty = dropdown chip. */
+    options: FacetOption[];
+    /** Whether multiple options can be selected. Default false. */
+    multi?: boolean;
+}
+export interface SearchValue {
+    object?: PatientSearchObject;
+    place?: PatientSearchPlace;
+    when?: WhenFilter;
+    facets?: Record<string, string[]>;
+    geo?: {
+        lat: number;
+        lng: number;
+        radiusKm: number;
+        label?: string;
+    };
+}
+/** Curated imperative handle — used by the agent adapter. */
+export interface PatientSearchHandle {
+    getVariant: () => PatientSearchVariant;
+    reset: () => void;
+    /** Move focus to the most-relevant field for the current variant. */
+    focusPrimary: () => void;
+}
+declare const rootVariants: (props?: ({
+    variant?: "who-where" | "who-where-when" | "faceted" | "discovery" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface PatientSearchProps extends Omit<ComponentPropsWithoutRef<'div'>, 'aria-label' | 'onChange' | 'onSubmit'>, VariantProps<typeof rootVariants> {
+    variant: PatientSearchVariant;
+    loadObjects: (query: string, ctx: {
+        signal: AbortSignal;
+    }) => Promise<PatientSearchObject[]>;
+    loadPlaces: (query: string, ctx: {
+        signal: AbortSignal;
+    }) => Promise<PatientSearchPlace[]>;
+    onObjectSelect?: (option: PatientSearchObject) => void;
+    onPlaceSelect?: (place: PatientSearchPlace) => void;
+    facets?: FacetGroup[];
+    /** Default radius in km when geolocation is granted. Snaps to the nearest preset. */
+    defaultRadiusKm?: number;
+    /** Reverse-geocode lat/lng → human label. Optional. */
+    reverseGeocode?: (lat: number, lng: number) => Promise<string>;
+    discoveryCards?: DiscoveryCard[];
+    /** Forwarded to the consumer's loaders if they want to constrain by country. */
+    countryCode?: 'it' | 'de' | string;
+    value: SearchValue;
+    onChange: (next: SearchValue) => void;
+    onSubmit: (value: SearchValue) => void | Promise<void>;
+    submitting?: boolean;
+    /** Custom CTA label override; defaults to `ui.patientSearch.submit.cta`. */
+    submitLabel?: string;
+    /**
+     * @default false
+     * By default the kit disables the submit button until at least one
+     * search dimension is set (object, place, geo, non-anytime when, or
+     * a facet). Set to `true` to allow an empty submit — useful for
+     * "browse all" patterns where the consumer wants to show all results
+     * with no initial filter.
+     */
+    allowEmptySubmit?: boolean;
+    'aria-label'?: string;
+    /** Agent-readiness instance id. */
+    id?: string;
+}
+export declare const PatientSearch: import("react").ForwardRefExoticComponent<PatientSearchProps & import("react").RefAttributes<PatientSearchHandle>>;
+export {};
+//# sourceMappingURL=patient-search.d.ts.map

package/dist/components/public-footer/index.d.ts

@@ -0,0 +1,6 @@
+export { PublicFooter } from './public-footer';
+export type { PublicFooterProps, PublicFooterHandle, PublicFooterVariant, PublicFooterLink, PublicFooterLinkGroup, PublicFooterSocial, } from './public-footer';
+export { DEFAULT_MARKETING_BASE_URL, composeLegalUrls, type LegalUrlOverrides, type ResolvedLegalUrls, } from './legal-urls';
+export { SOCIAL_NETWORKS, DEFAULT_SOCIAL_URLS, type SocialNetwork, } from './socials';
+export { publicFooterAgent } from './public-footer.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/public-footer/index.js

@@ -0,0 +1,10 @@
+import { D as s, a as A, P as L, S as e, c as S, p as _ } from "../../_chunks/public-footer.agent-DivkKdG4.js";
+export {
+  s as DEFAULT_MARKETING_BASE_URL,
+  A as DEFAULT_SOCIAL_URLS,
+  L as PublicFooter,
+  e as SOCIAL_NETWORKS,
+  S as composeLegalUrls,
+  _ as publicFooterAgent
+};
+//# sourceMappingURL=index.js.map