@alfadocs/ui-kit 0.25.1 → 0.30.0

package/dist/_chunks/use-theme-C2dHKUAN.js

@@ -0,0 +1,145 @@
+import { useSyncExternalStore as D, useEffect as b, useCallback as p } from "react";
+const y = "alfadocs-ui.theme", w = "alfadocs-ui.accessibility", r = {
+  light: "theme-light",
+  dark: "theme-dark",
+  accessible: "theme-accessible"
+}, M = "(prefers-color-scheme: dark)", C = "(prefers-contrast: more)";
+function g(e) {
+  if (typeof window > "u") return null;
+  try {
+    return window.localStorage.getItem(e);
+  } catch {
+    return null;
+  }
+}
+function S(e, t) {
+  if (!(typeof window > "u"))
+    try {
+      t === null ? window.localStorage.removeItem(e) : window.localStorage.setItem(e, t);
+    } catch {
+    }
+}
+function L(e) {
+  return e === "light" || e === "dark" || e === "system";
+}
+function T(e) {
+  return e === "default" || e === "accessible" || e === "system";
+}
+function O() {
+  const e = g(y), t = g(w), i = typeof window < "u" && typeof window.matchMedia == "function", s = typeof document < "u" ? document.documentElement.classList : null, A = s ? s.contains(r.dark) ? "dark" : s.contains(r.light) ? "light" : null : null, _ = s != null && s.contains(r.accessible) ? "accessible" : null;
+  return {
+    theme: L(e) ? e : A ?? "system",
+    accessibility: T(t) ? t : _ ?? "system",
+    prefersDark: i ? window.matchMedia(M).matches : !1,
+    prefersMoreContrast: i ? window.matchMedia(C).matches : !1
+  };
+}
+let n = O();
+const h = /* @__PURE__ */ new Set();
+function c(e) {
+  e.theme === n.theme && e.accessibility === n.accessibility && e.prefersDark === n.prefersDark && e.prefersMoreContrast === n.prefersMoreContrast || (n = e, h.forEach((t) => t()));
+}
+function I(e) {
+  return h.add(e), () => {
+    h.delete(e);
+  };
+}
+function R() {
+  return n;
+}
+function V() {
+  return {
+    theme: "system",
+    accessibility: "system",
+    prefersDark: !1,
+    prefersMoreContrast: !1
+  };
+}
+let d = 0, u = null, f = null, l = null;
+function v(e) {
+  c({ ...n, prefersDark: e.matches });
+}
+function H(e) {
+  c({ ...n, prefersMoreContrast: e.matches });
+}
+function Y(e) {
+  if (e.key === y) {
+    const t = L(e.newValue) ? e.newValue : "system";
+    c({ ...n, theme: t });
+  } else if (e.key === w) {
+    const t = T(e.newValue) ? e.newValue : "system";
+    c({ ...n, accessibility: t });
+  }
+}
+function E(e, t) {
+  return typeof e.addEventListener == "function" ? (e.addEventListener("change", t), () => e.removeEventListener("change", t)) : (e.addListener(t), () => e.removeListener(t));
+}
+function G() {
+  return d += 1, d > 1 || typeof window > "u" || (typeof window.matchMedia == "function" && (u = window.matchMedia(M), f = window.matchMedia(C), c({
+    ...n,
+    prefersDark: u.matches,
+    prefersMoreContrast: f.matches
+  }), o = E(u, v), a = E(f, H)), l = Y, window.addEventListener("storage", l)), m;
+}
+let o = null, a = null;
+function m() {
+  d -= 1, !(d > 0) && (o == null || o(), a == null || a(), o = null, a = null, u = null, f = null, l && typeof window < "u" && window.removeEventListener("storage", l), l = null);
+}
+function k(e) {
+  const t = e.theme === "system" ? e.prefersDark ? "dark" : "light" : e.theme, i = e.accessibility === "system" ? e.prefersMoreContrast : e.accessibility === "accessible";
+  return t === "dark" && i ? "dark-accessible" : t === "dark" ? "dark" : i ? "light-accessible" : "light";
+}
+function K(e) {
+  switch (e) {
+    case "light":
+      return [r.light];
+    case "dark":
+      return [r.dark];
+    case "light-accessible":
+      return [r.light, r.accessible];
+    case "dark-accessible":
+      return [r.dark, r.accessible];
+  }
+}
+const Q = [
+  r.light,
+  r.dark,
+  r.accessible
+];
+function U(e) {
+  if (typeof document > "u") return;
+  const t = document.documentElement, i = new Set(K(e));
+  Q.forEach((s) => {
+    i.has(s) ? t.classList.add(s) : t.classList.remove(s);
+  });
+}
+function N() {
+  const e = D(I, R, V);
+  b(() => G(), []), b(() => {
+    U(k(e));
+  }, [e]);
+  const t = p((s) => {
+    S(y, s === "system" ? null : s), c({ ...n, theme: s });
+  }, []), i = p((s) => {
+    S(
+      w,
+      s === "system" ? null : s
+    ), c({ ...n, accessibility: s });
+  }, []);
+  return {
+    theme: e.theme,
+    accessibility: e.accessibility,
+    resolvedTheme: k(e),
+    setTheme: t,
+    setAccessibility: i
+  };
+}
+export {
+  w as A,
+  r as T,
+  y as a,
+  k as r,
+  K as t,
+  N as u
+};
+//# sourceMappingURL=use-theme-C2dHKUAN.js.map

package/dist/_chunks/{workflow-map-BR6txfFX.js → workflow-map-BKsKdYvZ.js}

@@ -2,18 +2,18 @@ import { jsx as t, jsxs as u, Fragment as ve } from "react/jsx-runtime";
 import { forwardRef as O, useMemo as R, useRef as j, useCallback as W, useState as ge, useImperativeHandle as ke, useEffect as ye } from "react";
 import { c as L } from "./index-D2ZczOXr.js";
 import { useTranslation as z } from "react-i18next";
-import { C } from "./card-C353dU-H.js";
+import { C } from "./card-DKTMLVrw.js";
 import { B as be } from "./badge-cLYVGlMh.js";
-import { K as Z } from "./key-value-pair-DBuOCtIc.js";
+import { K as Z } from "./key-value-pair-CqeKiP__.js";
 import { T as xe } from "./timestamp-BV2lC-wV.js";
-import { I as S } from "./icon-button-C4CGcYuz.js";
+import { I as S } from "./icon-button-BRHSSFmZ.js";
 import { c as _ } from "./createLucideIcon-CrFbzy84.js";
 import { C as Ne } from "./circle-BkqTgYmt.js";
 import { u as Ce } from "./registry-C9nwlNyL.js";
 import { A as V } from "./alert-ywPR59NE.js";
 import { B as _e } from "./button-DD_0Xdmr.js";
 import { D as N } from "./dropdown-menu-DZxwF23X.js";
-import { E } from "./empty-state-3CLJIXSj.js";
+import { E } from "./empty-state-BLy7tigq.js";
 import { P as ae } from "./plus-CYKNmfuA.js";
 import { G as ne } from "./globe-BkEFMNSg.js";
 import { S as de } from "./square-check-big-Jr-0202D.js";
@@ -1412,4 +1412,4 @@ export {
   ee as r,
   D as w
 };
-//# sourceMappingURL=workflow-map-BR6txfFX.js.map
+//# sourceMappingURL=workflow-map-BKsKdYvZ.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.25.1",
+  "packageVersion": "0.30.0",
   "components": [
     {
       "kind": "component",
@@ -401,6 +401,46 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "booking",
+      "capabilities": [
+        "navigate",
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "variant",
+          "type": "string",
+          "description": "Active variant — one of `inline-list`, `accordion`, `calendar`, `flexible`, `progress`."
+        }
+      ],
+      "actions": [
+        {
+          "name": "reset",
+          "safety": "write",
+          "description": "Clear the booking value back to an empty state. Use to abandon an in-progress flow."
+        },
+        {
+          "name": "goto_step",
+          "safety": "read",
+          "argsType": "{ step: 1 | 2 | 3 | 4 | 5 | 6 | 7 }",
+          "description": "Jump to the given step. Implementations may clamp to the first incomplete step if the requested one is not reachable yet."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "booking",
+          "description": "Marks the Booking root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "breadcrumb",
@@ -2394,6 +2434,45 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "patient-search",
+      "capabilities": [
+        "navigate",
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "variant",
+          "type": "string",
+          "description": "Active variant — one of `who-where`, `who-where-when`, `faceted`, `discovery`."
+        }
+      ],
+      "actions": [
+        {
+          "name": "reset",
+          "safety": "write",
+          "description": "Clear the current selection (WHO, WHERE, WHEN, facets, geo) via the consumer-owned onChange."
+        },
+        {
+          "name": "focus_primary",
+          "safety": "read",
+          "description": "Move keyboard focus to the most-relevant field for the current variant."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "patient-search",
+          "description": "Marks the PatientSearch root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "payment-form",
@@ -2622,6 +2701,38 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "public-footer",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "variant",
+          "type": "string",
+          "description": "Active variant — one of `minimal`, `compact`, `full`."
+        },
+        {
+          "name": "legalUrls",
+          "type": "object",
+          "description": "Resolved legal URLs for the active locale + marketingBaseUrl + overrides: `{ privacy, terms, contacts }`."
+        }
+      ],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "public-footer",
+          "description": "Marks the PublicFooter root region. The root also carries `data-variant=\"minimal|compact|full\"` for CSS + agent selectors."
+        },
+        "instanceId": {
+          "attr": "id",
+          "sourceProp": "id",
+          "description": "Sourced from the `id` prop when provided."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "public-header",
@@ -2801,6 +2912,45 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "reviews-panel",
+      "capabilities": [
+        "filter"
+      ],
+      "state": [
+        {
+          "name": "filter",
+          "type": "string",
+          "description": "Active star-bucket filter — `\"all\"` or an integer 1..5. Reads the controlled `filter` prop."
+        },
+        {
+          "name": "visibleCount",
+          "type": "number",
+          "description": "Number of reviews currently rendered after the filter is applied."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_filter",
+          "safety": "read",
+          "argsType": "{ filter: \"all\" | 1 | 2 | 3 | 4 | 5 }",
+          "description": "Narrow the visible review list to a star bucket, or `\"all\"` to clear the filter."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "reviews-panel",
+          "description": "Marks the ReviewsPanel root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "rich-text-editor",
@@ -3396,56 +3546,6 @@
         }
       }
     },
-    {
-      "kind": "component",
-      "id": "stepper-calendar",
-      "capabilities": [
-        "navigate",
-        "view_change"
-      ],
-      "state": [
-        {
-          "name": "currentStep",
-          "type": "number",
-          "description": "Zero-indexed active step (0 = service, 1 = date, 2 = time, 3 = details)."
-        },
-        {
-          "name": "totalSteps",
-          "type": "number",
-          "description": "Total number of steps in the booking flow (always 4)."
-        }
-      ],
-      "actions": [
-        {
-          "name": "goto_step",
-          "safety": "read",
-          "argsType": "{ step: number }",
-          "description": "Jump to the given step. Steps beyond the first-incomplete are gated internally."
-        },
-        {
-          "name": "next",
-          "safety": "read",
-          "description": "Advance to the next step when the current step has a valid value."
-        },
-        {
-          "name": "previous",
-          "safety": "read",
-          "description": "Return to the previous step."
-        }
-      ],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "stepper-calendar",
-          "description": "Marks the StepperCalendar root region."
-        },
-        "instanceId": {
-          "attr": "data-component-id",
-          "sourceProp": "id",
-          "description": "Sourced from the id prop."
-        }
-      }
-    },
     {
       "kind": "component",
       "id": "stepper-progress",

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

@@ -1,4 +1,4 @@
-import { A as r, i as d } from "../../_chunks/agenda-card-BmpaUG1h.js";
+import { A as r, i as d } from "../../_chunks/agenda-card-CznB7K8e.js";
 import { a as n } from "../../_chunks/agenda-card.agent-B_R47-c9.js";
 export {
   r as AgendaCard,

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

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

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

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

package/dist/components/audio-recorder/index.js

@@ -1,4 +1,4 @@
-import { A as r, a } from "../../_chunks/audio-recorder-D4xM3H5i.js";
+import { A as r, a } from "../../_chunks/audio-recorder-OB6IV9B1.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

package/dist/components/autocomplete/index.js

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

package/dist/components/avatar/index.js

@@ -1,4 +1,4 @@
-import { A as o, g as r, n as t } from "../../_chunks/avatar-BpFohgWG.js";
+import { A as o, g as r, n as t } from "../../_chunks/avatar-D_H4emLo.js";
 export {
   o as Avatar,
   r as getInitials,

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

@@ -1,4 +1,4 @@
-import { B as a } from "../../_chunks/benefit-card-DXmrAyfn.js";
+import { B as a } from "../../_chunks/benefit-card-CjYM8vNr.js";
 export {
   a as BenefitCard
 };

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

@@ -0,0 +1,145 @@
+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;
+    emptyServicesSlot?: ReactNode;
+    onboardingIncompleteSlot?: ReactNode;
+    'aria-label'?: string;
+    id?: string;
+}
+//# sourceMappingURL=booking-types.d.ts.map

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

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+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

@@ -0,0 +1,6 @@
+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>>;
+//# sourceMappingURL=booking.d.ts.map