@alfadocs/ui-kit 0.67.1 → 0.69.0

package/dist/_chunks/{slider-BHWzXdjt.js → slider-DN1CWkKB.js}

@@ -1,15 +1,17 @@
-import { jsxs as b, jsx as e } from "react/jsx-runtime";
-import { forwardRef as ca, useContext as ua, useState as ma, useCallback as pa, useRef as q, useMemo as fa } from "react";
+import { jsxs as b, jsx as t } from "react/jsx-runtime";
+import { forwardRef as ca, useContext as ua, useState as ma, useCallback as pa, useRef as C, useMemo as fa } from "react";
+import { u as va } from "./registry-DvAUVLHh.js";
 import * as g from "@radix-ui/react-slider";
-import { c as t } from "./index-D2ZczOXr.js";
-import { useTranslation as va } from "react-i18next";
-import { u as ha, F as ba } from "./form-field-context-B3APVHKx.js";
-import { c as ga } from "./compose-refs-C0k0tdqF.js";
-import { u as xa } from "./use-direction-Dp8h70PP.js";
-import { u as wa } from "./registry-nPAVE19X.js";
-const ya = {
+import { c as e } from "./index-D2ZczOXr.js";
+import { useTranslation as ha } from "react-i18next";
+import { u as ba, F as ga } from "./form-field-context-B3APVHKx.js";
+import { c as xa } from "./compose-refs-C0k0tdqF.js";
+import { u as ya } from "./use-direction-Dp8h70PP.js";
+const wa = {
   id: "slider",
-  capabilities: ["pick", "range_pick"],
+  // Persisted numeric value (value state + set_value) → set_value; the
+  // dual-thumb mode additionally supports a range, so range_pick stays.
+  capabilities: ["set_value", "range_pick"],
   state: {
     value: {
       type: "number[]",
@@ -22,8 +24,26 @@ const ya = {
     set_value: {
       safety: "write",
       argsType: "{ value: number[] }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          value: {
+            type: "array",
+            items: { type: "number" },
+            minItems: 1,
+            maxItems: 2,
+            description: "Thumb value(s): a 1-tuple for a single slider, a 2-tuple for a range."
+          }
+        },
+        required: ["value"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.slider.actions.setValue",
       description: "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range.",
+      examples: [
+        { args: { value: [50] }, note: "Set a single slider to 50." },
+        { args: { value: [20, 80] }, note: "Set a range to 20–80." }
+      ],
       invoke: (l, x) => {
         l.setValue(x.value);
       }
@@ -41,7 +61,7 @@ const ya = {
       description: "Sourced from the id prop."
     }
   }
-}, Va = t(
+}, Va = e(
   [
     "ds:relative ds:flex ds:touch-none ds:select-none ds:items-center",
     "ds:data-[orientation=horizontal]:w-full",
@@ -58,19 +78,19 @@ const ya = {
     },
     defaultVariants: { size: "md" }
   }
-), za = t(
+), za = e(
   [
     "ds:relative ds:grow ds:overflow-hidden ds:rounded-[var(--radius-full)] ds:bg-muted",
     "ds:data-[orientation=horizontal]:h-full",
     "ds:data-[orientation=vertical]:w-full"
   ].join(" ")
-), ka = t(
+), ka = e(
   [
     "ds:absolute ds:bg-primary ds:rounded-[var(--radius-full)]",
     "ds:data-[orientation=horizontal]:h-full",
     "ds:data-[orientation=vertical]:w-full"
   ].join(" ")
-), Na = t(
+), Sa = e(
   [
     "ds:group/thumb",
     "ds:relative ds:block ds:rounded-full",
@@ -91,7 +111,7 @@ const ya = {
     },
     defaultVariants: { size: "md" }
   }
-), Sa = t("ds:absolute ds:rounded-full", {
+), Na = e("ds:absolute ds:rounded-full", {
   variants: {
     size: {
       sm: "ds:-inset-[calc((var(--min-target-size)-1rem)/2)]",
@@ -100,7 +120,7 @@ const ya = {
     }
   },
   defaultVariants: { size: "md" }
-}), Fa = t(
+}), Fa = e(
   "ds:absolute ds:flex ds:pointer-events-none ds:items-center ds:justify-center",
   {
     variants: {
@@ -111,7 +131,7 @@ const ya = {
     },
     defaultVariants: { orientation: "horizontal" }
   }
-), Ra = t(
+), Ra = e(
   [
     "ds:whitespace-nowrap ds:bg-foreground ds:text-background",
     "ds:px-[var(--spacing-sm)] ds:py-[var(--spacing-xs)]",
@@ -132,7 +152,7 @@ const ya = {
     },
     defaultVariants: { orientation: "horizontal", alwaysShow: !1 }
   }
-), La = t("ds:absolute ds:pointer-events-none", {
+), La = e("ds:absolute ds:pointer-events-none", {
   variants: {
     orientation: {
       horizontal: "ds:start-0 ds:end-0 ds:top-full",
@@ -140,7 +160,7 @@ const ya = {
     }
   },
   defaultVariants: { orientation: "horizontal" }
-}), Ma = t("ds:absolute ds:flex ds:items-center", {
+}), ja = e("ds:absolute ds:flex ds:items-center", {
   variants: {
     orientation: {
       horizontal: "ds:flex-col ds:-translate-x-1/2 ds:rtl:translate-x-1/2",
@@ -148,7 +168,7 @@ const ya = {
     }
   },
   defaultVariants: { orientation: "horizontal" }
-}), ja = t("ds:bg-border", {
+}), Ia = e("ds:bg-border", {
   variants: {
     orientation: {
       horizontal: "ds:w-px ds:h-1",
@@ -156,9 +176,9 @@ const ya = {
     }
   },
   defaultVariants: { orientation: "horizontal" }
-}), Ta = t(
+}), Ma = e(
   "ds:text-muted-foreground type-meta ds:mt-[var(--spacing-xs)]"
-), Ia = t(
+), Ta = e(
   "ds:flex ds:items-center ds:gap-[var(--spacing-sm)]",
   {
     variants: {
@@ -169,52 +189,52 @@ const ya = {
     },
     defaultVariants: { orientation: "horizontal" }
   }
-), K = t(
+), K = e(
   "ds:text-muted-foreground type-meta ds:tabular-nums ds:shrink-0"
 ), Aa = ca((l, x) => {
   const {
     value: m,
     defaultValue: L,
-    marks: w,
-    minLabel: y,
+    marks: y,
+    minLabel: w,
     maxLabel: V,
-    formatValue: E,
-    alwaysShowValue: H = !1,
-    step: U = 1,
-    largeStep: M = 10,
+    formatValue: _,
+    alwaysShowValue: E = !1,
+    step: H = 1,
+    largeStep: j = 10,
     thumbLabels: p,
     size: z = "md",
     orientation: s = "horizontal",
     min: d = 0,
     max: k = 100,
-    disabled: W,
-    dir: _,
-    id: N,
+    disabled: U,
+    dir: W,
+    id: S,
     className: O,
     onValueChange: f,
     onValueCommit: r,
-    onKeyDown: S,
-    ...j
-  } = l, { t: F, i18n: T } = va(), i = ha(), G = ua(ba) !== null, c = m !== void 0, [J, Q] = ma(
+    onKeyDown: N,
+    ...I
+  } = l, { t: F, i18n: M } = ha(), i = ba(), G = ua(ga) !== null, c = m !== void 0, [J, Q] = ma(
     m ?? L ?? [d]
   ), u = c ? m : J, R = (a) => {
     c || Q(a), f == null || f(a);
-  }, I = !!(i.disabled || W), A = i.describedBy || void 0, X = N ?? i.id, Y = pa(
-    (a) => new Intl.NumberFormat(T.language).format(a),
-    [T.language]
-  ), B = E ?? Y, Z = F("inputs.slider.minLabel", "Minimum"), aa = F("inputs.slider.maxLabel", "Maximum"), ta = j["aria-label"], ea = (a) => p != null && p[a] ? p[a] : u.length === 2 ? a === 0 ? Z : aa : ta, sa = (a) => {
-    if (S == null || S(a), a.defaultPrevented || I || a.key !== "PageUp" && a.key !== "PageDown") return;
+  }, T = !!(i.disabled || U), A = i.describedBy || void 0, X = S ?? i.id, Y = pa(
+    (a) => new Intl.NumberFormat(M.language).format(a),
+    [M.language]
+  ), B = _ ?? Y, Z = F("inputs.slider.minLabel", "Minimum"), aa = F("inputs.slider.maxLabel", "Maximum"), ea = I["aria-label"], ta = (a) => p != null && p[a] ? p[a] : u.length === 2 ? a === 0 ? Z : aa : ea, sa = (a) => {
+    if (N == null || N(a), a.defaultPrevented || T || a.key !== "PageUp" && a.key !== "PageDown") return;
     a.preventDefault();
     const n = Array.from(
       a.currentTarget.querySelectorAll('[role="slider"]')
     ), o = Math.max(
       0,
       n.indexOf(document.activeElement)
-    ), v = a.key === "PageUp" ? M : -M, h = u.map(
-      (C, la) => la === o ? Math.max(d, Math.min(k, C + v)) : C
+    ), v = a.key === "PageUp" ? j : -j, h = u.map(
+      (q, la) => la === o ? Math.max(d, Math.min(k, q + v)) : q
     );
     R(h), r == null || r(h);
-  }, ra = k - d || 1, ia = (a) => (a - d) / ra * 100, D = q(null), na = ga(x, D), oa = xa(D), P = q(u);
+  }, ra = k - d || 1, ia = (a) => (a - d) / ra * 100, D = C(null), na = xa(x, D), oa = ya(D), P = C(u);
   P.current = u;
   const da = fa(
     () => ({
@@ -226,18 +246,18 @@ const ya = {
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [c, f, r]
   );
-  wa(ya, da, N);
+  va(wa, da, S);
   const $ = /* @__PURE__ */ b(
     g.Root,
     {
       ref: na,
       id: X,
-      dir: _ ?? oa,
+      dir: W ?? oa,
       orientation: s,
       min: d,
       max: k,
-      step: U,
-      disabled: I,
+      step: H,
+      disabled: T,
       value: c ? m : void 0,
       defaultValue: c ? void 0 : L ?? [d],
       onValueChange: R,
@@ -248,26 +268,26 @@ const ya = {
       "aria-required": i.required || void 0,
       className: Va({ size: z, className: O }),
       "data-component": "slider",
-      "data-component-id": N,
-      ...j,
+      "data-component-id": S,
+      ...I,
       "aria-label": void 0,
       children: [
-        /* @__PURE__ */ e(g.Track, { className: za(), children: /* @__PURE__ */ e(g.Range, { className: ka() }) }),
-        w && w.length > 0 ? /* @__PURE__ */ e(
+        /* @__PURE__ */ t(g.Track, { className: za(), children: /* @__PURE__ */ t(g.Range, { className: ka() }) }),
+        y && y.length > 0 ? /* @__PURE__ */ t(
           "span",
           {
             "aria-hidden": "true",
             className: La({ orientation: s }),
-            children: w.map((a) => {
+            children: y.map((a) => {
               const n = ia(a.value), o = s === "vertical" ? { insetBlockEnd: `${n}%` } : { insetInlineStart: `${n}%` };
               return /* @__PURE__ */ b(
                 "span",
                 {
-                  className: Ma({ orientation: s }),
+                  className: ja({ orientation: s }),
                   style: o,
                   children: [
-                    /* @__PURE__ */ e("span", { className: ja({ orientation: s }) }),
-                    a.label ? /* @__PURE__ */ e("span", { className: Ta(), children: a.label }) : null
+                    /* @__PURE__ */ t("span", { className: Ia({ orientation: s }) }),
+                    a.label ? /* @__PURE__ */ t("span", { className: Ma(), children: a.label }) : null
                   ]
                 },
                 `${a.value}-${a.label ?? ""}`
@@ -276,7 +296,7 @@ const ya = {
           }
         ) : null,
         u.map((a, n) => {
-          const o = ea(n), v = !o && G ? `${i.id}-label` : void 0, h = !o && !v ? F("inputs.slider.value", "Value") : void 0;
+          const o = ta(n), v = !o && G ? `${i.id}-label` : void 0, h = !o && !v ? F("inputs.slider.value", "Value") : void 0;
           return /* @__PURE__ */ b(
             g.Thumb,
             {
@@ -285,20 +305,20 @@ const ya = {
               "aria-valuetext": B(a),
               "aria-describedby": A,
               "aria-invalid": i.invalid || void 0,
-              className: Na({ size: z }),
+              className: Sa({ size: z }),
               children: [
-                /* @__PURE__ */ e("span", { "aria-hidden": "true", className: Sa({ size: z }) }),
-                /* @__PURE__ */ e(
+                /* @__PURE__ */ t("span", { "aria-hidden": "true", className: Na({ size: z }) }),
+                /* @__PURE__ */ t(
                   "span",
                   {
                     "aria-hidden": "true",
                     className: Fa({ orientation: s }),
-                    children: /* @__PURE__ */ e(
+                    children: /* @__PURE__ */ t(
                       "span",
                       {
                         className: Ra({
                           orientation: s,
-                          alwaysShow: H
+                          alwaysShow: E
                         }),
                         children: B(a)
                       }
@@ -313,14 +333,14 @@ const ya = {
       ]
     }
   );
-  return y !== void 0 || V !== void 0 ? /* @__PURE__ */ b("div", { className: Ia({ orientation: s }), children: [
-    y !== void 0 ? /* @__PURE__ */ e("span", { className: K(), children: y }) : null,
+  return w !== void 0 || V !== void 0 ? /* @__PURE__ */ b("div", { className: Ta({ orientation: s }), children: [
+    w !== void 0 ? /* @__PURE__ */ t("span", { className: K(), children: w }) : null,
     $,
-    V !== void 0 ? /* @__PURE__ */ e("span", { className: K(), children: V }) : null
+    V !== void 0 ? /* @__PURE__ */ t("span", { className: K(), children: V }) : null
   ] }) : $;
 });
 Aa.displayName = "Slider";
 export {
   Aa as S
 };
-//# sourceMappingURL=slider-BHWzXdjt.js.map
+//# sourceMappingURL=slider-DN1CWkKB.js.map

package/dist/_chunks/{sparkline-DGhCSw8M.js → sparkline-iOXYgvJe.js}

@@ -1,11 +1,11 @@
-import { jsx as v, jsxs as P } from "react/jsx-runtime";
-import { forwardRef as j, useId as G, useMemo as w, useRef as V, useState as A, useEffect as H, useImperativeHandle as Z } from "react";
-import { c as $ } from "./index-D2ZczOXr.js";
-import { useTranslation as q } from "react-i18next";
-import J from "react-apexcharts";
+import { jsx as w, jsxs as F } from "react/jsx-runtime";
+import { forwardRef as G, useId as L, useMemo as v, useRef as K, useState as A, useEffect as H, useImperativeHandle as V } from "react";
+import { c as Z } from "./index-D2ZczOXr.js";
+import { useTranslation as $ } from "react-i18next";
+import q from "react-apexcharts";
 import R from "apexcharts";
-import { g as D, u as K } from "./apexcharts-theme-BJigns_V.js";
-import { u as Q } from "./registry-nPAVE19X.js";
+import { g as U, u as J } from "./apexcharts-theme-BJigns_V.js";
+import { u as Q } from "./registry-DvAUVLHh.js";
 function X(n) {
   if (n.length < 2)
     return { slope: 0, direction: "steady" };
@@ -15,7 +15,7 @@ function X(n) {
     const o = s - a;
     i += o * (n[s] - c), l += o * o;
   }
-  const d = l === 0 ? 0 : i / l, k = 0.01 * (Math.max(...n) - Math.min(...n) || 1), u = Math.abs(d) < k ? "steady" : d > 0 ? "increasing" : "decreasing";
+  const d = l === 0 ? 0 : i / l, b = 0.01 * (Math.max(...n) - Math.min(...n) || 1), u = Math.abs(d) < b ? "steady" : d > 0 ? "increasing" : "decreasing";
   return { slope: d, direction: u };
 }
 const Y = {
@@ -24,15 +24,37 @@ const Y = {
   state: {},
   actions: {
     update_series: {
-      safety: "read",
+      // Replacing the rendered series mutates what the chart displays — write,
+      // not read.
+      safety: "write",
       argsType: "{ data: number[] }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          data: {
+            type: "array",
+            items: { type: "number" },
+            description: "The new data points to render."
+          }
+        },
+        required: ["data"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.sparkline.actions.updateSeries",
       description: "Replace the sparkline data without remounting.",
       invoke: (n, t) => {
         n.updateSeries(t.data);
       }
     },
     export_png: {
+      // Pure getter — returns an image of the current chart, no state change.
       safety: "read",
+      returns: "string",
+      returnsSchema: {
+        type: "string",
+        description: "A PNG image of the sparkline encoded as a data URI."
+      },
+      descriptionKey: "ui.agent.sparkline.actions.exportPng",
       description: "Return a PNG data URI of the sparkline.",
       invoke: (n) => n.dataURI()
     }
@@ -45,7 +67,7 @@ const Y = {
       description: "Sourced from the id prop."
     }
   }
-}, U = $("ds:relative ds:inline-block ds:w-full", {
+}, D = Z("ds:relative ds:inline-block ds:w-full", {
   variants: {
     size: {
       xs: "ds:h-6",
@@ -69,7 +91,7 @@ const Y = {
 function re() {
   return typeof window < "u" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 }
-const ne = j(
+const ne = G(
   ({
     id: n,
     data: t,
@@ -79,29 +101,29 @@ const ne = j(
     color: l,
     showEndpoint: d = !1,
     showTooltip: M = !1,
-    width: k,
+    width: b,
     height: u,
     className: s,
     ...o
-  }, _) => {
-    var S;
-    const { t: m, i18n: C } = q(), T = G(), p = w(
-      () => `sparkline-${T.replace(/[^a-zA-Z0-9-_]/g, "")}`,
-      [T]
-    ), h = V(null), [O, E] = A(0), { direction: y } = X(t), z = w(() => {
+  }, P) => {
+    var z;
+    const { t: p, i18n: C } = $(), S = L(), m = v(
+      () => `sparkline-${S.replace(/[^a-zA-Z0-9-_]/g, "")}`,
+      [S]
+    ), h = K(null), [T, _] = A(0), { direction: k } = X(t), N = v(() => {
       if (t.length === 0)
-        return m("sparkline.noData", "No data");
-      const e = (b) => new Intl.NumberFormat(C.language).format(b), r = m(`sparkline.direction.${y}`), g = {
+        return p("sparkline.noData", "No data");
+      const e = (y) => new Intl.NumberFormat(C.language).format(y), r = p(`sparkline.direction.${k}`), g = {
         min: e(Math.min(...t)),
         max: e(Math.max(...t)),
         current: e(t[t.length - 1]),
         direction: r
       };
-      return i ? m("sparkline.summary", { label: i, ...g }) : m("sparkline.summaryNoLabel", g);
-    }, [t, i, y, C.language, m]), [f, W] = A(
+      return i ? p("sparkline.summary", { label: i, ...g }) : p("sparkline.summaryNoLabel", g);
+    }, [t, i, k, C.language, p]), [f, E] = A(
       () => {
         try {
-          return D();
+          return U();
         } catch {
           return {};
         }
@@ -112,7 +134,7 @@ const ne = j(
       const r = new MutationObserver(() => {
         clearTimeout(e), e = setTimeout(() => {
           try {
-            W(D());
+            E(U());
           } catch {
           }
         }, 50);
@@ -127,56 +149,56 @@ const ne = j(
       const e = h.current;
       if (!e) return;
       const r = new ResizeObserver((g) => {
-        const b = g[0];
-        b && E(Math.floor(b.contentRect.width));
+        const y = g[0];
+        y && _(Math.floor(y.contentRect.width));
       });
       return r.observe(e), () => r.disconnect();
-    }, []), K(h);
-    const x = w(
+    }, []), J(h);
+    const x = v(
       () => ({
         updateSeries(e) {
           var r;
-          (r = R.getChartByID(p)) == null || r.updateSeries([{ data: e }]);
+          (r = R.getChartByID(m)) == null || r.updateSeries([{ data: e }]);
         },
         updateOptions(e) {
           var r;
-          (r = R.getChartByID(p)) == null || r.updateOptions(e);
+          (r = R.getChartByID(m)) == null || r.updateOptions(e);
         },
         async dataURI() {
-          const e = R.getChartByID(p);
+          const e = R.getChartByID(m);
           return e ? (await e.dataURI()).imgURI : "";
         }
       }),
-      [p]
+      [m]
     );
-    Z(_, () => x, [x]), Q(Y, x, n);
-    const I = l ?? ((S = f.colors) == null ? void 0 : S[0]) ?? "currentColor";
+    V(P, () => x, [x]), Q(Y, x, n);
+    const I = l ?? ((z = f.colors) == null ? void 0 : z[0]) ?? "currentColor";
     if (t.length === 0)
-      return /* @__PURE__ */ v(
+      return /* @__PURE__ */ w(
         "div",
         {
           ref: h,
           role: "img",
-          "aria-label": z,
+          "aria-label": N,
           dir: "ltr",
-          className: U({
+          className: D({
             size: u !== void 0 ? "auto" : c,
             className: s
           }),
           ...o
         }
       );
-    const N = re(), B = {
+    const O = re(), W = {
       ...f,
       chart: {
         ...f.chart,
-        id: p,
+        id: m,
         type: a,
         sparkline: { enabled: !0 },
         toolbar: { show: !1 },
         animations: {
-          enabled: !N,
-          dynamicAnimation: { enabled: !N }
+          enabled: !O,
+          dynamicAnimation: { enabled: !O }
         },
         zoom: { enabled: !1 },
         parentHeightOffset: 0
@@ -212,15 +234,15 @@ const ne = j(
         // The chart wrapper enforces dir="ltr" so these always resolve correctly.
         padding: { top: 2, right: 2, bottom: 2, left: 2 }
       }
-    }, F = k ?? (O > 0 ? O : "100%"), L = u ?? te[c ?? "md"];
-    return /* @__PURE__ */ P(
+    }, j = b ?? (T > 0 ? T : "100%"), B = u ?? te[c ?? "md"];
+    return /* @__PURE__ */ F(
       "div",
       {
         ref: h,
         role: "img",
-        "aria-label": z,
+        "aria-label": N,
         dir: "ltr",
-        className: U({
+        className: D({
           size: u !== void 0 ? "auto" : c,
           className: s
         }),
@@ -228,23 +250,23 @@ const ne = j(
         "data-component-id": n,
         ...o,
         children: [
-          /* @__PURE__ */ v(
-            J,
+          /* @__PURE__ */ w(
+            q,
             {
               type: a,
               series: [{ data: t }],
-              options: B,
-              width: F,
-              height: L,
+              options: W,
+              width: j,
+              height: B,
               "aria-hidden": "true"
             }
           ),
-          d && /* @__PURE__ */ v(
+          d && /* @__PURE__ */ w(
             "span",
             {
               "aria-hidden": "true",
               className: "ds:pointer-events-none ds:absolute ds:end-0 ds:top-0 ds:text-[length:var(--font-size-xs)] ds:leading-none",
-              children: ee[y]
+              children: ee[k]
             }
           )
         ]
@@ -258,4 +280,4 @@ export {
   Y as s,
   X as u
 };
-//# sourceMappingURL=sparkline-DGhCSw8M.js.map
+//# sourceMappingURL=sparkline-iOXYgvJe.js.map

package/dist/_chunks/{stepper-accordion.agent-C4quJ-MD.js → stepper-accordion.agent-cmEguIdx.js}

@@ -25,6 +25,12 @@ const o = {
     goto_step: {
       safety: "read",
       argsType: "{ step: number }",
+      argsSchema: {
+        type: "object",
+        properties: { step: { type: "integer", minimum: 0 } },
+        required: ["step"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.stepperAccordion.actions.gotoStep",
       description: "Activate the given step. Upcoming steps are gated by the consumer’s validation in onStepChange.",
       invoke: (e, t) => {
@@ -68,4 +74,4 @@ const o = {
 export {
   o as s
 };
-//# sourceMappingURL=stepper-accordion.agent-C4quJ-MD.js.map
+//# sourceMappingURL=stepper-accordion.agent-cmEguIdx.js.map