@alfadocs/ui-kit 0.6.1 → 0.7.1

package/dist/_chunks/{alert-B1sj8Ss0.js → alert-34A3K8y-.js}

@@ -1,15 +1,22 @@
 import { jsxs as D, jsx as t } from "react/jsx-runtime";
-import { forwardRef as a, useState as p, useRef as R, useCallback as B } from "react";
-import { c as E } from "./index-D2ZczOXr.js";
-import { useTranslation as V } from "react-i18next";
-import { X as F } from "./x-CCcI3eJp.js";
-import { C as L } from "./circle-x-Du2CmjaU.js";
-import { T as O } from "./triangle-alert-CBPUIzQo.js";
-import { C as X } from "./circle-check-9AeSgJD_.js";
-import { I as G } from "./info-B9XNKn05.js";
-const M = E(
+import { forwardRef as i, useState as _, useRef as R, useCallback as V, Children as O, isValidElement as F } from "react";
+import { c as L } from "./index-D2ZczOXr.js";
+import { useTranslation as W } from "react-i18next";
+import { X } from "./x-CCcI3eJp.js";
+import { C as G } from "./circle-x-Du2CmjaU.js";
+import { T as H } from "./triangle-alert-CBPUIzQo.js";
+import { C as M } from "./circle-check-9AeSgJD_.js";
+import { I as P } from "./info-B9XNKn05.js";
+const U = L(
   [
-    "ds:flex ds:items-start ds:gap-[var(--spacing-md)]",
+    // Default `items-center` keeps the icon + dismiss optically aligned
+    // with a single-line description. The `data-[has-title=true]`
+    // selector flips to `items-start` when an `<Alert.Title>` is
+    // present so the icon anchors to the heading's top instead of
+    // floating against the centre of the title+description block.
+    // For multi-line descriptions without a title, `items-center` still
+    // looks right at 2–3 lines and matches Toast / Notification.
+    "ds:flex ds:items-center ds:data-[has-title=true]:items-start ds:gap-[var(--spacing-md)]",
     "ds:rounded-[var(--radius-md)]",
     "ds:border ds:border-[length:var(--border-width-sm)]",
     "ds:p-[var(--spacing-md)]",
@@ -57,7 +64,7 @@ const M = E(
       variant: "info"
     }
   }
-), P = "ds:shrink-0 ds:size-5 ds:mt-0.5", U = [
+), h = "ds:shrink-0 ds:size-5", $ = `${h} ds:mt-0.5`, q = [
   "ds:ms-auto ds:shrink-0 ds:inline-flex ds:items-center ds:justify-center",
   "ds:rounded-[var(--radius-sm)]",
   "ds:min-h-[var(--min-target-size)] ds:min-w-[var(--min-target-size)]",
@@ -68,92 +75,95 @@ const M = E(
   "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid",
   "ds:focus-visible:outline-[color:var(--ring)] ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
   "ds:forced-colors:focus-visible:outline-[CanvasText]"
-].join(" "), W = {
-  info: { icon: /* @__PURE__ */ t(G, { "aria-hidden": "true" }), role: "status", live: "polite" },
+].join(" "), J = {
+  info: { icon: /* @__PURE__ */ t(P, { "aria-hidden": "true" }), role: "status", live: "polite" },
   success: {
-    icon: /* @__PURE__ */ t(X, { "aria-hidden": "true" }),
+    icon: /* @__PURE__ */ t(M, { "aria-hidden": "true" }),
     role: "status",
     live: "polite"
   },
   warning: {
-    icon: /* @__PURE__ */ t(O, { "aria-hidden": "true" }),
+    icon: /* @__PURE__ */ t(H, { "aria-hidden": "true" }),
     role: "alert",
     live: "assertive"
   },
   error: {
-    icon: /* @__PURE__ */ t(L, { "aria-hidden": "true" }),
+    icon: /* @__PURE__ */ t(G, { "aria-hidden": "true" }),
     role: "alert",
     live: "assertive"
   }
-}, b = a(
-  ({ as: s = "h5", className: r, ...o }, e) => /* @__PURE__ */ t(
+}, c = i(
+  ({ as: s = "h5", className: o, ...e }, r) => /* @__PURE__ */ t(
     s,
     {
-      ref: e,
-      className: ["type-title-item", r].filter(Boolean).join(" "),
-      ...o
+      ref: r,
+      className: ["type-title-item", o].filter(Boolean).join(" "),
+      ...e
     }
   )
 );
-b.displayName = "Alert.Title";
-const x = a(({ className: s, ...r }, o) => /* @__PURE__ */ t(
+c.displayName = "Alert.Title";
+const w = i(({ className: s, ...o }, e) => /* @__PURE__ */ t(
   "p",
   {
-    ref: o,
+    ref: e,
     className: ["ds:mt-[var(--spacing-xs)] type-body-sm", s].filter(Boolean).join(" "),
-    ...r
+    ...o
   }
 ));
-x.displayName = "Alert.Description";
-const _ = a(
-  ({ className: s, ...r }, o) => /* @__PURE__ */ t(
+w.displayName = "Alert.Description";
+const A = i(
+  ({ className: s, ...o }, e) => /* @__PURE__ */ t(
     "div",
     {
-      ref: o,
+      ref: e,
       className: [
         "ds:mt-[var(--spacing-sm)] ds:flex ds:flex-wrap ds:items-center ds:gap-[var(--spacing-sm)]",
         s
       ].filter(Boolean).join(" "),
-      ...r
+      ...o
     }
   )
 );
-_.displayName = "Alert.Action";
-const w = a(
+A.displayName = "Alert.Action";
+const N = i(
   ({
     variant: s = "info",
-    dismissible: r = !1,
-    open: o,
-    onOpenChange: e,
-    icon: l,
-    live: A,
-    className: h,
-    children: N,
-    ...y
+    dismissible: o = !1,
+    open: e,
+    onOpenChange: r,
+    icon: m,
+    live: y,
+    className: T,
+    children: u,
+    ...C
   }, j) => {
-    const { t: C } = V(), [T, k] = p(!0), [c, m] = p(!1), n = R(null), u = o !== void 0, S = u ? o : T, I = B(() => {
+    const { t: I } = W(), [k, S] = _(!0), [f, v] = _(!1), n = R(null), g = e !== void 0, E = g ? e : k, z = V(() => {
       if (typeof window > "u") return 200;
-      const v = window.getComputedStyle(document.documentElement).getPropertyValue("--animation-duration");
-      if (!v) return 200;
-      const g = v.trim(), d = parseFloat(g);
-      return Number.isFinite(d) ? g.endsWith("ms") ? d : d * 1e3 : 200;
+      const a = window.getComputedStyle(document.documentElement).getPropertyValue("--animation-duration");
+      if (!a) return 200;
+      const x = a.trim(), l = parseFloat(x);
+      return Number.isFinite(l) ? x.endsWith("ms") ? l : l * 1e3 : 200;
     }, []);
-    if (!S) return null;
-    const i = W[s], f = l !== void 0 ? l : i.icon, z = () => {
-      c || (m(!0), n.current && clearTimeout(n.current), n.current = setTimeout(() => {
-        m(!1), u || k(!1), e == null || e(!1);
-      }, I()));
+    if (!E) return null;
+    const d = J[s], p = m !== void 0 ? m : d.icon, b = O.toArray(u).some(
+      (a) => F(a) && a.type === c
+    ), B = () => {
+      f || (v(!0), n.current && clearTimeout(n.current), n.current = setTimeout(() => {
+        v(!1), g || S(!1), r == null || r(!1);
+      }, z()));
     };
     return /* @__PURE__ */ D(
       "div",
       {
         ref: j,
-        role: i.role,
-        "aria-live": A ?? i.live,
+        role: d.role,
+        "aria-live": y ?? d.live,
         "data-component": "alert",
-        "data-state": c ? "closing" : "open",
+        "data-has-title": b ? "true" : "false",
+        "data-state": f ? "closing" : "open",
         className: [
-          M({ variant: s, className: h }),
+          U({ variant: s, className: T }),
           // Entry: fade + slide-down on mount. Exit: fade + slide-up + slight
           // scale when dismissed. Driven by `tw-animate-css`. Respects
           // `prefers-reduced-motion` via `motion-safe:` and zeroes under the
@@ -167,18 +177,18 @@ const w = a(
           "ds:motion-safe:data-[state=closing]:fill-mode-forwards",
           "ds:motion-safe:duration-[var(--animation-duration)]"
         ].join(" "),
-        ...y,
+        ...C,
         children: [
-          f ? /* @__PURE__ */ t("span", { className: P, children: f }) : null,
-          /* @__PURE__ */ t("div", { className: "ds:flex-1 ds:min-w-0", children: N }),
-          r ? /* @__PURE__ */ t(
+          p ? /* @__PURE__ */ t("span", { className: b ? $ : h, children: p }) : null,
+          /* @__PURE__ */ t("div", { className: "ds:flex-1 ds:min-w-0", children: u }),
+          o ? /* @__PURE__ */ t(
             "button",
             {
               type: "button",
-              "aria-label": C("ui.common.close", "Close"),
-              onClick: z,
-              className: U,
-              children: /* @__PURE__ */ t(F, { "aria-hidden": "true", className: "ds:size-4" })
+              "aria-label": I("ui.common.close", "Close"),
+              onClick: B,
+              className: q,
+              children: /* @__PURE__ */ t(X, { "aria-hidden": "true", className: "ds:size-4" })
             }
           ) : null
         ]
@@ -186,13 +196,13 @@ const w = a(
     );
   }
 );
-w.displayName = "Alert";
-const st = Object.assign(w, {
-  Title: b,
-  Description: x,
-  Action: _
+N.displayName = "Alert";
+const at = Object.assign(N, {
+  Title: c,
+  Description: w,
+  Action: A
 });
 export {
-  st as A
+  at as A
 };
-//# sourceMappingURL=alert-B1sj8Ss0.js.map
+//# sourceMappingURL=alert-34A3K8y-.js.map

package/dist/_chunks/{audio-recorder-BdBbU-UK.js → audio-recorder-B60FLnUO.js}

@@ -6,7 +6,7 @@ import { B as G } from "./button-DD_0Xdmr.js";
 import { I as N } from "./icon-button-C4CGcYuz.js";
 import { S as ue } from "./select-BOU_Osnf.js";
 import { A as pe } from "./audio-visualiser-ByDEFLNm.js";
-import { A as F } from "./alert-B1sj8Ss0.js";
+import { A as F } from "./alert-34A3K8y-.js";
 import { u as le } from "./registry-C9nwlNyL.js";
 import { c as V } from "./createLucideIcon-CrFbzy84.js";
 import { S as me } from "./square-CZoGU14v.js";
@@ -454,4 +454,4 @@ export {
   Ne as A,
   Re as a
 };
-//# sourceMappingURL=audio-recorder-BdBbU-UK.js.map
+//# sourceMappingURL=audio-recorder-B60FLnUO.js.map

package/dist/_chunks/{freemium-paywall-CrVefV0M.js → freemium-paywall-BA02zIOx.js}

@@ -7,7 +7,7 @@ import { useTranslation as Z } from "react-i18next";
 import { u as $ } from "./registry-C9nwlNyL.js";
 import { B as j } from "./button-DD_0Xdmr.js";
 import { P as ee } from "./progress-C11tqhoI.js";
-import { f as se } from "./payment-form-B_BdHwjb.js";
+import { f as se } from "./payment-form-BIk2K3i3.js";
 import { T as ae } from "./triangle-alert-CBPUIzQo.js";
 import { C as re } from "./check-DPdL_Sm7.js";
 const te = {
@@ -264,4 +264,4 @@ export {
   de as F,
   te as f
 };
-//# sourceMappingURL=freemium-paywall-CrVefV0M.js.map
+//# sourceMappingURL=freemium-paywall-BA02zIOx.js.map

package/dist/_chunks/{payment-form-B_BdHwjb.js → payment-form-BIk2K3i3.js}

@@ -3,7 +3,7 @@ import { forwardRef as se, useState as E, useEffect as R, useRef as V, useMemo a
 import { c as z } from "./index-D2ZczOXr.js";
 import { useTranslation as q } from "react-i18next";
 import { S as J } from "./spinner-DLaYfLPl.js";
-import { A as W } from "./alert-B1sj8Ss0.js";
+import { A as W } from "./alert-34A3K8y-.js";
 import { loadStripe as de } from "@stripe/stripe-js";
 import { Elements as ce, useStripe as le, useElements as me, PaymentElement as ue, AddressElement as pe } from "@stripe/react-stripe-js";
 import { u as fe } from "./registry-C9nwlNyL.js";
@@ -587,4 +587,4 @@ export {
   ye as p,
   ee as s
 };
-//# sourceMappingURL=payment-form-B_BdHwjb.js.map
+//# sourceMappingURL=payment-form-BIk2K3i3.js.map

package/dist/_chunks/{pdf-viewer-CZIfY08H.js → pdf-viewer-DuPrR5Ty.js}

@@ -6,7 +6,7 @@ import { useTranslation as le } from "react-i18next";
 import * as X from "@radix-ui/react-popover";
 import Se from "pdfjs-dist/build/pdf.worker.min.mjs?url";
 import { S as Ee } from "./spinner-DLaYfLPl.js";
-import { A as ye } from "./alert-B1sj8Ss0.js";
+import { A as ye } from "./alert-34A3K8y-.js";
 import { u as _e } from "./registry-C9nwlNyL.js";
 import { X as Le } from "./x-CCcI3eJp.js";
 import { C as Ze } from "./chevron-left-CX1jqD2M.js";
@@ -892,4 +892,4 @@ export {
   tt as P,
   Je as p
 };
-//# sourceMappingURL=pdf-viewer-CZIfY08H.js.map
+//# sourceMappingURL=pdf-viewer-DuPrR5Ty.js.map

package/dist/_chunks/use-locale-C5rS3Xon.js

@@ -0,0 +1,71 @@
+import { useState as w, useEffect as d, useRef as h, useCallback as p } from "react";
+import "../i18n/config.js";
+import i from "i18next";
+function E(e) {
+  const [o, r] = w(() => typeof window > "u" || typeof window.matchMedia != "function" ? !1 : window.matchMedia(e).matches);
+  return d(() => {
+    if (typeof window > "u" || typeof window.matchMedia != "function")
+      return;
+    const t = window.matchMedia(e);
+    r(t.matches);
+    const n = (a) => r(a.matches);
+    return typeof t.addEventListener == "function" ? (t.addEventListener("change", n), () => t.removeEventListener("change", n)) : (t.addListener(n), () => t.removeListener(n));
+  }, [e]), o;
+}
+function S(e) {
+  return e != null && e.current ? e.current : typeof document > "u" ? null : document;
+}
+function y(e, o) {
+  const r = typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(e) : (
+    // SSR / jsdom fallback — drop every character that's
+    // significant in a CSS attribute selector. Conservative but
+    // robust enough for the test environment.
+    e.replace(/["'\\[\]]/g, "")
+  ), t = `[data-error-anchor="${r}"], [name="${r}"], [name$="[${r}]"]`, n = Array.from(o.querySelectorAll(t));
+  return n.length === 0 ? null : n.find((s) => s.offsetParent !== null) ?? n[0];
+}
+function M(e, o, r = {}) {
+  const {
+    scope: t,
+    scrollOptions: n = { behavior: "smooth", block: "center" },
+    focus: a = !0,
+    skipInitialMount: s = !0
+  } = r, m = h(!0), c = h(null), u = o.find((l) => !!e[l]) ?? null;
+  d(() => {
+    if (m.current && (m.current = !1, s)) {
+      c.current = u;
+      return;
+    }
+    if (!u) {
+      c.current = null;
+      return;
+    }
+    if (u === c.current || typeof window > "u") return;
+    const l = window.requestAnimationFrame(() => {
+      const g = S(t);
+      if (!g) return;
+      const f = y(u, g);
+      f && (f.scrollIntoView(n), a && f.focus({ preventScroll: !0 }), c.current = u);
+    });
+    return () => window.cancelAnimationFrame(l);
+  }, [u]);
+}
+function b() {
+  const [e, o] = w(() => i.language);
+  d(() => {
+    const n = (a) => o(a);
+    return i.on("languageChanged", n), i.language !== e && o(i.language), () => {
+      i.off("languageChanged", n);
+    };
+  }, [e]);
+  const r = p(async (n) => {
+    await i.changeLanguage(n);
+  }, []), t = i.dir(e) === "rtl" ? "rtl" : "ltr";
+  return { locale: e, dir: t, setLocale: r };
+}
+export {
+  E as a,
+  M as b,
+  b as u
+};
+//# sourceMappingURL=use-locale-C5rS3Xon.js.map

package/dist/_chunks/{warning-stack-VygGHSqC.js → warning-stack-CskQPAQ2.js}

@@ -2,7 +2,7 @@ import { jsxs as l, jsx as a } from "react/jsx-runtime";
 import { forwardRef as M, useId as N, useState as O, useRef as y, useEffect as V, useMemo as _, useCallback as j } from "react";
 import { c as W } from "./index-D2ZczOXr.js";
 import { useTranslation as q } from "react-i18next";
-import { A as u } from "./alert-B1sj8Ss0.js";
+import { A as u } from "./alert-34A3K8y-.js";
 import { B as F } from "./button-DD_0Xdmr.js";
 import { C as H } from "./chevron-down-BX_NP2Yh.js";
 const L = W(
@@ -176,4 +176,4 @@ P.displayName = "WarningStack";
 export {
   P as W
 };
-//# sourceMappingURL=warning-stack-VygGHSqC.js.map
+//# sourceMappingURL=warning-stack-CskQPAQ2.js.map

package/dist/_chunks/{workflow-map-Bi5liGzo.js → workflow-map-D6Vsc2nY.js}

@@ -10,7 +10,7 @@ import { I as S } from "./icon-button-C4CGcYuz.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-B1sj8Ss0.js";
+import { A as V } from "./alert-34A3K8y-.js";
 import { B as _e } from "./button-DD_0Xdmr.js";
 import { D as N } from "./dropdown-menu-dyV7gHh_.js";
 import { E } from "./empty-state-3CLJIXSj.js";
@@ -1412,4 +1412,4 @@ export {
   ee as r,
   D as w
 };
-//# sourceMappingURL=workflow-map-Bi5liGzo.js.map
+//# sourceMappingURL=workflow-map-D6Vsc2nY.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.6.1",
+  "packageVersion": "0.7.1",
   "components": [
     {
       "kind": "component",

package/dist/components/alert/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/alert-B1sj8Ss0.js";
+import { A as o } from "../../_chunks/alert-34A3K8y-.js";
 export {
   o as Alert
 };

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

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

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

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

package/dist/components/index.d.ts

@@ -1,5 +1,5 @@
-export { usePrefersReducedMotion, useMediaQuery, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, } from '../hooks';
-export type { LocaleDir, UseLocaleReturn, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, } from '../hooks';
+export { usePrefersReducedMotion, useMediaQuery, useScrollToFirstError, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, } from '../hooks';
+export type { LocaleDir, UseLocaleReturn, UseScrollToFirstErrorOptions, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, } from '../hooks';
 export * from './button';
 export * from './button-group';
 export * from './floating-action-button';

package/dist/components/matrix-rain/matrix-rain.d.ts

@@ -9,7 +9,7 @@ type GlyphPreset = keyof typeof GLYPH_PRESETS;
 declare const wrapperVariants: (props?: ({
     background?: "solid" | "transparent" | null | undefined;
     vibe?: "ghost" | "terminal" | "clean" | "hologram" | "synthwave" | "oscilloscope" | null | undefined;
-    mask?: "none" | "center" | null | undefined;
+    mask?: "center" | "none" | null | undefined;
     maskRadius?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type Tone = 'primary' | 'accent' | 'success' | 'error' | 'info';

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-B_BdHwjb.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-BIk2K3i3.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-CZIfY08H.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-DuPrR5Ty.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/sheet/sheet.d.ts

@@ -2,7 +2,7 @@ import { type ComponentPropsWithoutRef, type HTMLAttributes, type ReactNode } fr
 import * as RadixDialog from '@radix-ui/react-dialog';
 import { type VariantProps } from 'class-variance-authority';
 declare const contentVariants: (props?: ({
-    side?: "top" | "end" | "bottom" | "start" | null | undefined;
+    side?: "end" | "start" | "top" | "bottom" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface SheetHandle {
     getIsOpen: () => boolean;

package/dist/components/stat/stat.d.ts

@@ -3,7 +3,7 @@ import { type VariantProps } from 'class-variance-authority';
 declare const statVariants: (props?: ({
     variant?: "default" | "compact" | "outlined" | "elevated" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
-    align?: "end" | "start" | "center" | null | undefined;
+    align?: "center" | "end" | "start" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface StatProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof statVariants> {
     /** Metric label rendered above the value. */

package/dist/components/theme-toggle/theme-toggle.d.ts

@@ -2,7 +2,7 @@ import { type HTMLAttributes } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import { type AccessibilityPreference, type ThemePreference } from '../../hooks';
 declare const wrapperVariants: (props?: ({
-    variant?: "split" | "menu" | "compact" | null | undefined;
+    variant?: "menu" | "split" | "compact" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type ThemeToggleVariant = 'menu' | 'compact' | 'split';
 interface ThemeToggleBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof wrapperVariants> {

package/dist/components/warning-stack/index.js

@@ -1,4 +1,4 @@
-import { W as n } from "../../_chunks/warning-stack-VygGHSqC.js";
+import { W as n } from "../../_chunks/warning-stack-CskQPAQ2.js";
 export {
   n as WarningStack
 };

package/dist/components/workflow/index.js

@@ -1,4 +1,4 @@
-import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-Bi5liGzo.js";
+import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-D6Vsc2nY.js";
 export {
   r as CORE_PATIENT_FIELDS,
   e as WorkflowCard,

package/dist/hooks/index.d.ts

@@ -1,5 +1,7 @@
 export { usePrefersReducedMotion } from './use-prefers-reduced-motion';
 export { useMediaQuery } from './use-media-query';
+export { useScrollToFirstError } from './use-scroll-to-first-error';
+export type { UseScrollToFirstErrorOptions } from './use-scroll-to-first-error';
 export { useLocale } from './use-locale';
 export type { LocaleDir, UseLocaleReturn } from './use-locale';
 export { useTheme, resolveTheme, themeClassList, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, THEME_CLASS, } from './use-theme';

package/dist/hooks/index.js

@@ -1,15 +1,16 @@
-import { u as a } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
-import { u as o, a as u } from "../_chunks/use-locale-BuXR_Zl9.js";
-import { A as T, T as t, a as m, r as S, t as A, u as _ } from "../_chunks/use-theme-B1cwAXJR.js";
+import { u as r } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
+import { u as o, a as u, b as E } from "../_chunks/use-locale-C5rS3Xon.js";
+import { A as t, T as S, a as m, r as l, t as A, u as _ } from "../_chunks/use-theme-B1cwAXJR.js";
 export {
-  T as ACCESSIBILITY_STORAGE_KEY,
-  t as THEME_CLASS,
+  t as ACCESSIBILITY_STORAGE_KEY,
+  S as THEME_CLASS,
   m as THEME_STORAGE_KEY,
-  S as resolveTheme,
+  l as resolveTheme,
   A as themeClassList,
   o as useLocale,
   u as useMediaQuery,
-  a as usePrefersReducedMotion,
+  r as usePrefersReducedMotion,
+  E as useScrollToFirstError,
   _ as useTheme
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/use-scroll-to-first-error.d.ts

@@ -0,0 +1,64 @@
+import { type RefObject } from 'react';
+export interface UseScrollToFirstErrorOptions {
+    /**
+     * Limits the DOM query to this element. Useful when the page renders
+     * more than one form, or when an unrelated component happens to share
+     * a field name. Defaults to `document`.
+     */
+    scope?: RefObject<HTMLElement | null>;
+    /**
+     * Forwarded to `scrollIntoView`. Defaults to
+     * `{ behavior: 'smooth', block: 'center' }`. Pass
+     * `{ behavior: 'auto' }` (or omit `behavior`) on consumers that
+     * respect `prefers-reduced-motion` upstream — the kit doesn't shadow
+     * the user's motion preference inside the hook, since some consumers
+     * deliberately keep a near-instant snap for power-user form flows.
+     */
+    scrollOptions?: ScrollIntoViewOptions;
+    /**
+     * Move keyboard focus to the errored field after scrolling. Default
+     * `true`. The focus call uses `preventScroll: true` so the smooth
+     * scroll the hook just did isn't replaced by a snap.
+     *
+     * Setting this `false` defeats the keyboard-user side of WCAG 3.3.1
+     * — the viewport will scroll but the active element stays on the
+     * submit button, forcing a Shift+Tab back into the form. Only flip
+     * this off when an upstream concern (e.g. a custom error summary
+     * panel that owns its own focus) is taking responsibility.
+     */
+    focus?: boolean;
+    /**
+     * On the very first render, do nothing even if `errors` already has
+     * entries. Default `true`. Without this the hook would yank the
+     * viewport whenever a form is hydrated with server-rendered errors
+     * from a no-JS fallback path — bad UX, since the user landed on the
+     * page and hasn't asked for any movement yet. Set `false` only when
+     * the consumer explicitly wants the initial-mount scroll (rare).
+     */
+    skipInitialMount?: boolean;
+}
+/**
+ * Scrolls the first errored field into view and (by default) focuses
+ * it, after `errors` changes. Backs the standard AlfaDocs rebrand
+ * validation-error UX: after a 422 with `{ errors: { field: message } }`
+ * is rendered inline, the user shouldn't be left staring at red labels
+ * they can't see. Implements WCAG 3.3.1 / 3.3.3.
+ *
+ * The hook is stateless and never mutates the DOM beyond the
+ * `scrollIntoView` + `focus` calls.
+ *
+ * @example
+ *   const fieldOrder = ['firstName', 'email', 'fiscalCode'] as const;
+ *   const [errors, setErrors] = useState<Record<string, string>>({});
+ *   useScrollToFirstError(errors, fieldOrder);
+ *
+ * @example Radix-based field
+ *   <Checkbox data-error-anchor="consent" name="consent" />
+ *   // hook scrolls to the visible <button>, not Radix's hidden input.
+ *
+ * @example Scoped to one form
+ *   const formRef = useRef<HTMLFormElement>(null);
+ *   useScrollToFirstError(errors, fieldOrder, { scope: formRef });
+ */
+export declare function useScrollToFirstError(errors: Readonly<Record<string, string | undefined>>, fieldOrder: ReadonlyArray<string>, options?: UseScrollToFirstErrorOptions): void;
+//# sourceMappingURL=use-scroll-to-first-error.d.ts.map