@alfadocs/ui-kit 0.68.0 → 0.70.0

package/dist/_chunks/{date-range-picker-C5BWfH_T.js → date-range-picker-CTUeR6Bj.js}

@@ -1,15 +1,15 @@
-import { jsx as n, jsxs as m } from "react/jsx-runtime";
-import { forwardRef as Q, useState as I, useRef as U, useCallback as X, useMemo as Z, useImperativeHandle as z } from "react";
+import { jsx as n, jsxs as g } from "react/jsx-runtime";
+import { forwardRef as Q, useState as M, useRef as U, useCallback as X, useMemo as Z, useImperativeHandle as z } from "react";
 import { useTranslation as ee } from "react-i18next";
 import * as f from "@radix-ui/react-popover";
 import { u as te } from "./use-controllable-state-BiY4xTzM.js";
 import { u as ae } from "./form-field-context-B3APVHKx.js";
-import { b as ne, u as re, g as se, c as oe, e as T, s as W, d as ie, f as de, h as v, j as ce, k as le, t as pe, p as ge, D as ue, C as me, l as fe, m as he } from "./date-picker-variants-DAcSLTua.js";
+import { u as ne } from "./registry-DvAUVLHh.js";
+import { b as re, u as se, g as oe, c as ie, e as T, s as W, d as de, f as ce, h as v, j as le, k as pe, t as me, p as ue, D as ge, C as fe, l as he, m as ye } from "./date-picker-variants-DAcSLTua.js";
 import { s as R } from "./subDays-BcYv1Lxi.js";
-import { u as ke } from "./registry-nPAVE19X.js";
-import { C as ye } from "./calendar-B6soK1Yb.js";
+import { C as ke } from "./calendar-B6soK1Yb.js";
 function be(a, s, i) {
-  return ne(a, -1, i);
+  return re(a, -1, i);
 }
 const ve = {
   id: "date-range-picker",
@@ -39,14 +39,39 @@ const ve = {
     set_range: {
       safety: "write",
       argsType: "{ from: string, to: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          from: {
+            type: "string",
+            format: "date",
+            description: "ISO start date (inclusive)."
+          },
+          to: {
+            type: "string",
+            format: "date",
+            description: "ISO end date (inclusive)."
+          }
+        },
+        required: ["from", "to"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.dateRangePicker.actions.setRange",
       description: "Replace the selected range with the given ISO endpoints.",
+      examples: [
+        {
+          args: { from: "2026-06-01", to: "2026-06-30" },
+          note: "Select all of June 2026."
+        }
+      ],
       invoke: (a, s) => {
         a.setRange({ from: new Date(s.from), to: new Date(s.to) });
       }
     },
     clear: {
+      // Discards the selected range — loses the user's input.
       safety: "destructive",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateRangePicker.actions.clear",
       description: "Clear the selected range.",
       invoke: (a) => {
@@ -55,6 +80,7 @@ const ve = {
     },
     open: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateRangePicker.actions.open",
       description: "Open the range calendar popover.",
       invoke: (a) => {
@@ -63,6 +89,7 @@ const ve = {
     },
     close: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateRangePicker.actions.close",
       description: "Close the range calendar popover.",
       invoke: (a) => {
@@ -92,21 +119,21 @@ const ve = {
     presets: h,
     mergePresets: K = !1,
     size: D = "md",
-    disabled: F,
-    placeholder: j,
+    disabled: j,
+    placeholder: F,
     className: L,
     id: A
   }, B) => {
-    const { t: r, i18n: w } = ee(), c = ae(), k = A ?? c.id, P = c.disabled || F, H = c.invalid ? "error" : "default", o = re(w.language), y = se(w.language), _ = j ?? r("inputs.dateRangePicker.placeholder", "Select date range"), [$, C] = te({
+    const { t: r, i18n: w } = ee(), c = ae(), y = A ?? c.id, P = c.disabled || j, H = c.invalid ? "error" : "default", o = se(w.language), k = oe(w.language), _ = F ?? r("inputs.dateRangePicker.placeholder", "Select date range"), [$, C] = te({
       value: a,
       defaultValue: s ?? {},
       onChange: i
-    }), t = $ ?? {}, [p, g] = I(!1), [Y, x] = I(t.from ?? /* @__PURE__ */ new Date()), q = U(null), d = X(
+    }), t = $ ?? {}, [p, m] = M(!1), [q, O] = M(t.from ?? /* @__PURE__ */ new Date()), J = U(null), d = X(
       (e) => {
         C(e);
       },
       [C]
-    ), E = oe(l, V), O = [
+    ), Y = ie(l, V), S = [
       {
         label: r("inputs.dateRangePicker.presets.today", "Today"),
         range: () => {
@@ -148,8 +175,8 @@ const ve = {
       {
         label: r("inputs.dateRangePicker.presets.thisMonth", "This month"),
         range: () => ({
-          from: de(/* @__PURE__ */ new Date()),
-          to: ie(/* @__PURE__ */ new Date())
+          from: ce(/* @__PURE__ */ new Date()),
+          to: de(/* @__PURE__ */ new Date())
         })
       },
       {
@@ -159,20 +186,20 @@ const ve = {
           to: /* @__PURE__ */ new Date()
         })
       }
-    ], S = h ? K ? [...O, ...h] : h : O, G = (e) => {
+    ], x = h ? K ? [...S, ...h] : h : S, E = (e) => {
       d(e ? { from: e.from, to: e.to } : {});
-    }, J = (e) => {
+    }, G = (e) => {
       const u = e.range();
-      d(u), x(u.from), g(!1);
+      d(u), O(u.from), m(!1);
     }, N = (() => {
       if (t.from && t.to) {
-        const e = v(t.from, y, { locale: o }), u = v(t.to, y, { locale: o });
+        const e = v(t.from, k, { locale: o }), u = v(t.to, k, { locale: o });
         return `${e} – ${u}`;
       }
-      return t.from ? v(t.from, y, { locale: o }) : "";
-    })(), M = (() => {
+      return t.from ? v(t.from, k, { locale: o }) : "";
+    })(), I = (() => {
       if (t.from && t.to) {
-        const e = ce(t.to, t.from) + 1;
+        const e = le(t.to, t.from) + 1;
         return r("inputs.dateRangePicker.days", "{{count}} days", {
           count: e
         });
@@ -184,30 +211,30 @@ const ve = {
         setRange: (e) => d(e),
         clear: () => d({}),
         isOpen: () => p,
-        open: () => g(!0),
-        close: () => g(!1)
+        open: () => m(!0),
+        close: () => m(!1)
       }),
       [t, d, p]
     );
-    return z(B, () => b, [b]), ke(ve, b, k), /* @__PURE__ */ n(f.Root, { open: p, onOpenChange: g, children: /* @__PURE__ */ m(
+    return z(B, () => b, [b]), ne(ve, b, y), /* @__PURE__ */ n(f.Root, { open: p, onOpenChange: m, children: /* @__PURE__ */ g(
       "div",
       {
         className: L,
         "data-component": "date-range-picker",
-        "data-component-id": k,
+        "data-component-id": y,
         children: [
-          /* @__PURE__ */ n(f.Trigger, { asChild: !0, disabled: P, children: /* @__PURE__ */ m(
+          /* @__PURE__ */ n(f.Trigger, { asChild: !0, disabled: P, children: /* @__PURE__ */ g(
             "button",
             {
-              ref: q,
-              id: k,
+              ref: J,
+              id: y,
               type: "button",
               disabled: P,
               "aria-describedby": c.describedBy || void 0,
               "aria-invalid": c.invalid || void 0,
               "aria-haspopup": "dialog",
               "aria-expanded": p,
-              className: pe({ size: D, tone: H }),
+              className: me({ size: D, tone: H }),
               children: [
                 /* @__PURE__ */ n(
                   "span",
@@ -228,8 +255,8 @@ const ve = {
                   "span",
                   {
                     "aria-hidden": "true",
-                    className: le({ size: D }),
-                    children: /* @__PURE__ */ n(ye, {})
+                    className: pe({ size: D }),
+                    children: /* @__PURE__ */ n(ke, {})
                   }
                 )
               ]
@@ -240,44 +267,44 @@ const ve = {
             {
               sideOffset: 4,
               align: "start",
-              className: he(),
-              children: /* @__PURE__ */ m("div", { className: "ds:flex ds:gap-[var(--spacing-md)]", children: [
-                S.length > 0 ? /* @__PURE__ */ n("div", { className: "ds:flex ds:flex-col ds:gap-[var(--spacing-xs)] ds:min-w-[8rem] ds:border-e ds:border-border ds:pe-[var(--spacing-md)]", children: S.map((e) => /* @__PURE__ */ n(
+              className: ye(),
+              children: /* @__PURE__ */ g("div", { className: "ds:flex ds:gap-[var(--spacing-md)]", children: [
+                x.length > 0 ? /* @__PURE__ */ n("div", { className: "ds:flex ds:flex-col ds:gap-[var(--spacing-xs)] ds:min-w-[8rem] ds:border-e ds:border-border ds:pe-[var(--spacing-md)]", children: x.map((e) => /* @__PURE__ */ n(
                   "button",
                   {
                     type: "button",
-                    onClick: () => J(e),
-                    className: ge(),
+                    onClick: () => G(e),
+                    className: ue(),
                     children: e.label
                   },
                   e.label
                 )) }) : null,
-                /* @__PURE__ */ m("div", { children: [
+                /* @__PURE__ */ g("div", { children: [
                   /* @__PURE__ */ n(
-                    ue,
+                    ge,
                     {
                       mode: "range",
                       selected: t.from ? { from: t.from, to: t.to } : void 0,
-                      onSelect: G,
-                      month: Y,
-                      onMonthChange: x,
+                      onSelect: E,
+                      month: q,
+                      onMonthChange: O,
                       numberOfMonths: 2,
-                      disabled: E,
+                      disabled: Y,
                       locale: o,
                       showOutsideDays: !0,
                       fixedWeeks: !0,
                       pagedNavigation: !0,
-                      classNames: fe,
-                      components: { Chevron: me }
+                      classNames: he,
+                      components: { Chevron: fe }
                     }
                   ),
-                  M ? /* @__PURE__ */ n(
+                  I ? /* @__PURE__ */ n(
                     "div",
                     {
                       role: "status",
                       "aria-live": "polite",
                       className: "type-body-sm ds:text-muted-foreground ds:mt-[var(--spacing-sm)] ds:text-center",
-                      children: M
+                      children: I
                     }
                   ) : null
                 ] })
@@ -294,4 +321,4 @@ export {
   Re as D,
   ve as d
 };
-//# sourceMappingURL=date-range-picker-C5BWfH_T.js.map
+//# sourceMappingURL=date-range-picker-CTUeR6Bj.js.map

package/dist/_chunks/{date-time-picker-Ze1My59T.js → date-time-picker-BhoogS5Q.js}

@@ -5,22 +5,24 @@ import { useTranslation as ue } from "react-i18next";
 import * as k from "@radix-ui/react-popover";
 import { u as me } from "./use-controllable-state-BiY4xTzM.js";
 import { u as pe } from "./form-field-context-B3APVHKx.js";
-import { T as fe } from "./time-picker-B5umYwfv.js";
-import { u as ge, c as he, n as ve, i as be, h as ye, k as Te, t as ke, D as we, C as Ce, l as De, m as Pe } from "./date-picker-variants-DAcSLTua.js";
-import { u as xe } from "./registry-nPAVE19X.js";
+import { T as fe } from "./time-picker-BPlJWm8w.js";
+import { u as ge } from "./registry-DvAUVLHh.js";
+import { u as he, c as ve, n as be, i as ye, h as Te, k as ke, t as we, D as Ce, C as De, l as Pe, m as xe } from "./date-picker-variants-DAcSLTua.js";
 import { C as Oe } from "./calendar-B6soK1Yb.js";
-import { t as B } from "./isSameDay-DUEiAT0G.js";
+import { t as A } from "./isSameDay-DUEiAT0G.js";
 function K(e, t, r) {
-  const i = B(e, r == null ? void 0 : r.in);
+  const i = A(e, r == null ? void 0 : r.in);
   return i.setHours(t), i;
 }
-function A(e, t, r) {
-  const i = B(e, r == null ? void 0 : r.in);
+function Z(e, t, r) {
+  const i = A(e, r == null ? void 0 : r.in);
   return i.setMinutes(t), i;
 }
 const Ne = {
   id: "date-time-picker",
-  capabilities: ["pick", "open", "close"],
+  // Persisted single datetime (value state + set_datetime) → select_single +
+  // set_value, plus open/close of the combined popover.
+  capabilities: ["select_single", "set_value", "open", "close"],
   state: {
     value: {
       type: "iso-datetime",
@@ -42,14 +44,34 @@ const Ne = {
     set_datetime: {
       safety: "write",
       argsType: "{ datetime: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          datetime: {
+            type: "string",
+            format: "date-time",
+            description: 'ISO datetime, e.g. "2026-06-23T14:30:00Z".'
+          }
+        },
+        required: ["datetime"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.dateTimePicker.actions.setDatetime",
       description: "Select a specific datetime (ISO string).",
+      examples: [
+        {
+          args: { datetime: "2026-06-23T14:30:00Z" },
+          note: "Select 23 Jun 2026, 14:30 UTC."
+        }
+      ],
       invoke: (e, t) => {
         e.setValue(new Date(t.datetime));
       }
     },
     clear: {
+      // Discards the selected datetime — loses the user's input.
       safety: "destructive",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateTimePicker.actions.clear",
       description: "Clear the selected datetime.",
       invoke: (e) => {
@@ -58,6 +80,7 @@ const Ne = {
     },
     open: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateTimePicker.actions.open",
       description: "Open the datetime popover.",
       invoke: (e) => {
@@ -66,6 +89,7 @@ const Ne = {
     },
     close: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.dateTimePicker.actions.close",
       description: "Close the datetime popover.",
       invoke: (e) => {
@@ -86,7 +110,7 @@ const Ne = {
     }
   }
 };
-function Me(e, t) {
+function Se(e, t) {
   var r;
   try {
     const i = { timeZoneName: "short" };
@@ -97,7 +121,7 @@ function Me(e, t) {
     return "";
   }
 }
-function Ve(e) {
+function Me(e) {
   if (!e || e === "local") return !1;
   try {
     const t = Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -106,7 +130,7 @@ function Ve(e) {
     return !1;
   }
 }
-const Se = ce(
+const Ve = ce(
   [
     "ds:w-full ds:rounded-[var(--radius-sm)]",
     "ds:bg-primary ds:text-primary-foreground",
@@ -135,18 +159,18 @@ const Se = ce(
     showTimezone: w,
     minDate: d,
     maxDate: p,
-    hour12: Z,
+    hour12: _,
     minuteStep: j = 1,
     size: f = "md",
-    disabled: _,
-    placeholder: z,
-    className: E,
-    id: U
+    disabled: B,
+    placeholder: U,
+    className: z,
+    id: E
   }, W) => {
-    const { t: l, i18n: N } = ue(), c = pe(), C = U ?? c.id, M = c.disabled || _, q = c.invalid ? "error" : "default", V = ge(N.language), G = z ?? l("inputs.dateTimePicker.placeholder", "Select date and time"), J = l("inputs.dateTimePicker.apply", "Apply"), Q = l(
+    const { t: l, i18n: N } = ue(), c = pe(), C = E ?? c.id, S = c.disabled || B, q = c.invalid ? "error" : "default", M = he(N.language), J = U ?? l("inputs.dateTimePicker.placeholder", "Select date and time"), G = l("inputs.dateTimePicker.apply", "Apply"), Q = l(
       "inputs.dateTimePicker.outOfRange",
       "Date/time is out of allowed range"
-    ), S = (w !== void 0 ? w : Ve(i)) ? Me(N.language, i) : "", [X, I] = me({
+    ), V = (w !== void 0 ? w : Me(i)) ? Se(N.language, i) : "", [X, I] = me({
       value: e,
       defaultValue: t,
       onChange: r
@@ -155,20 +179,20 @@ const Se = ce(
         I(a);
       },
       [I]
-    ), $ = he(d, p), P = F(
-      (a) => !(d && ve(a, d) || p && be(a, p)),
+    ), $ = ve(d, p), P = F(
+      (a) => !(d && be(a, d) || p && ye(a, p)),
       [d, p]
     ), ee = (a) => {
       a && (g(n ?? /* @__PURE__ */ new Date()), D(n ?? /* @__PURE__ */ new Date()), u(!1)), v(a);
     }, te = (a) => {
       if (!a) return;
-      const O = o ?? /* @__PURE__ */ new Date(), m = A(
+      const O = o ?? /* @__PURE__ */ new Date(), m = Z(
         K(a, O.getHours()),
         O.getMinutes()
       );
       g(m), u(!P(m));
     }, ae = (a) => {
-      const m = A(K(o ?? /* @__PURE__ */ new Date(), a.hours), a.minutes);
+      const m = Z(K(o ?? /* @__PURE__ */ new Date(), a.hours), a.minutes);
       g(m), u(!P(m));
     }, se = () => {
       var a;
@@ -179,7 +203,7 @@ const Se = ce(
         }
         b(o), v(!1), (a = L.current) == null || a.focus();
       }
-    }, H = n ? ye(n, "MMM d, yyyy HH:mm", { locale: V }) : "", re = l("inputs.datePicker.gridLabel", "Calendar"), ie = l("inputs.timePicker.groupLabel", "Time"), x = de(
+    }, H = n ? Te(n, "MMM d, yyyy HH:mm", { locale: M }) : "", re = l("inputs.datePicker.gridLabel", "Calendar"), ie = l("inputs.timePicker.groupLabel", "Time"), x = de(
       () => ({
         getValue: () => n,
         setValue: (a) => b(a),
@@ -193,38 +217,38 @@ const Se = ce(
       }),
       [n, b, h]
     );
-    return le(W, () => x, [x]), xe(Ne, x, C), /* @__PURE__ */ s(k.Root, { open: h, onOpenChange: ee, children: /* @__PURE__ */ y(
+    return le(W, () => x, [x]), ge(Ne, x, C), /* @__PURE__ */ s(k.Root, { open: h, onOpenChange: ee, children: /* @__PURE__ */ y(
       "div",
       {
-        className: E,
+        className: z,
         "data-component": "date-time-picker",
         "data-component-id": C,
         children: [
-          /* @__PURE__ */ s(k.Trigger, { asChild: !0, disabled: M, children: /* @__PURE__ */ y(
+          /* @__PURE__ */ s(k.Trigger, { asChild: !0, disabled: S, children: /* @__PURE__ */ y(
             "button",
             {
               ref: L,
               id: C,
               type: "button",
-              disabled: M,
+              disabled: S,
               "aria-describedby": c.describedBy || void 0,
               "aria-invalid": c.invalid || void 0,
               "aria-haspopup": "dialog",
               "aria-expanded": h,
-              className: ke({ size: f, tone: q }),
+              className: we({ size: f, tone: q }),
               children: [
                 /* @__PURE__ */ s(
                   "span",
                   {
                     className: H ? "ds:text-foreground" : "ds:text-muted-foreground",
-                    children: H || G
+                    children: H || J
                   }
                 ),
                 /* @__PURE__ */ s(
                   "span",
                   {
                     "aria-hidden": "true",
-                    className: Te({ size: f }),
+                    className: ke({ size: f }),
                     children: /* @__PURE__ */ s(Oe, {})
                   }
                 )
@@ -236,10 +260,10 @@ const Se = ce(
             {
               sideOffset: 4,
               align: "start",
-              className: Pe(),
+              className: xe(),
               children: /* @__PURE__ */ y("div", { className: "ds:flex ds:flex-col ds:sm:flex-row ds:gap-[var(--spacing-md)]", children: [
                 /* @__PURE__ */ s("div", { role: "region", "aria-label": re, children: /* @__PURE__ */ s(
-                  we,
+                  Ce,
                   {
                     mode: "single",
                     selected: o,
@@ -247,11 +271,11 @@ const Se = ce(
                     month: Y,
                     onMonthChange: D,
                     disabled: $,
-                    locale: V,
+                    locale: M,
                     showOutsideDays: !0,
                     fixedWeeks: !0,
-                    classNames: De,
-                    components: { Chevron: Ce }
+                    classNames: Pe,
+                    components: { Chevron: De }
                   }
                 ) }),
                 /* @__PURE__ */ y(
@@ -269,12 +293,12 @@ const Se = ce(
                             minutes: o.getMinutes()
                           } : { hours: 0, minutes: 0 },
                           onChange: ae,
-                          hour12: Z,
+                          hour12: _,
                           minuteStep: j,
                           size: f
                         }
                       ),
-                      S ? /* @__PURE__ */ s("span", { className: "type-meta ds:text-muted-foreground", children: S }) : null,
+                      V ? /* @__PURE__ */ s("span", { className: "type-meta ds:text-muted-foreground", children: V }) : null,
                       R ? /* @__PURE__ */ s(
                         "span",
                         {
@@ -289,8 +313,8 @@ const Se = ce(
                           type: "button",
                           onClick: se,
                           disabled: !o || R,
-                          className: Se({ size: f }),
-                          children: J
+                          className: Ve({ size: f }),
+                          children: G
                         }
                       )
                     ]
@@ -309,4 +333,4 @@ export {
   Ie as D,
   Ne as d
 };
-//# sourceMappingURL=date-time-picker-Ze1My59T.js.map
+//# sourceMappingURL=date-time-picker-BhoogS5Q.js.map