@alfadocs/ui-kit 0.68.0 → 0.69.0

package/dist/_chunks/{search-bar-SY2BcV2N.js → search-bar-C_T3pBJn.js}

@@ -1,16 +1,18 @@
-import { jsx as a, jsxs as B, Fragment as ae } from "react/jsx-runtime";
-import { forwardRef as te, useState as _, useEffect as F, useRef as j, useMemo as E, useImperativeHandle as G, useId as ne, useCallback as P } from "react";
-import { c as A } from "./index-D2ZczOXr.js";
+import { jsx as t, jsxs as M, Fragment as te } from "react/jsx-runtime";
+import { forwardRef as ae, useState as j, useEffect as F, useRef as A, useMemo as E, useImperativeHandle as G, useId as ne, useCallback as D } from "react";
+import { c as V } from "./index-D2ZczOXr.js";
 import { useTranslation as U } from "react-i18next";
-import * as q from "@radix-ui/react-popover";
-import { S as oe } from "./search-input-DbxrnHkW.js";
-import { u as W } from "./registry-nPAVE19X.js";
+import * as P from "@radix-ui/react-popover";
+import { S as oe } from "./search-input-DQvGxR74.js";
+import { u as W } from "./registry-DvAUVLHh.js";
 import { n as O } from "./normalize-diacritics-BNGbFNlJ.js";
 import { S as ie } from "./search-BonnQsHv.js";
 import { u as de } from "./use-debounced-callback-BisrB-Fq.js";
 const J = {
   id: "search-bar",
-  capabilities: ["filter", "edit_inline", "submit"],
+  // The query is a transient filter (set_query/clear), not inline content
+  // editing — `filter` covers it. `submit` opens the palette / commits a hit.
+  capabilities: ["filter", "submit"],
   state: {
     query: {
       type: "string",
@@ -27,8 +29,17 @@ const J = {
   },
   actions: {
     set_query: {
+      // Pure ephemeral filter text — narrows the result popover, no persisted change.
       safety: "read",
       argsType: "{ query: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Filter text for the search." }
+        },
+        required: ["query"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.searchBar.actions.setQuery",
       description: "Replace the current query (inline mode only). No-op in launcher mode.",
       invoke: (s, r) => {
@@ -36,7 +47,9 @@ const J = {
       }
     },
     clear: {
+      // Clears transient search state — no user content lost.
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.searchBar.actions.clear",
       description: "Clear the query and close the result popover.",
       invoke: (s) => {
@@ -44,6 +57,7 @@ const J = {
       }
     },
     submit: {
+      // Opens the palette / commits the highlighted option — ephemeral UI navigation.
       safety: "read",
       descriptionKey: "ui.agent.searchBar.actions.submit",
       description: "In launcher mode opens the CommandPalette; in inline mode commits the highlighted option.",
@@ -53,6 +67,7 @@ const J = {
     },
     focus: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.searchBar.actions.focus",
       description: "Move keyboard focus to the SearchBar.",
       invoke: (s) => {
@@ -60,8 +75,20 @@ const J = {
       }
     },
     apply_saved_search: {
+      // Selects a stored search by id — pure UI routing into the existing handler.
       safety: "read",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Saved-search id resolved by the host handler."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.searchBar.actions.applySavedSearch",
       description: "Apply a saved-search by id. The host wires the actual query lookup; the adapter routes the id to its onApplySavedSearch handler. No-op when no handler is wired.",
       invoke: (s, r) => {
@@ -87,7 +114,7 @@ function ce() {
   const s = navigator.userAgentData, r = (s == null ? void 0 : s.platform) ?? navigator.platform ?? "";
   return /mac/i.test(r);
 }
-const le = A(
+const le = V(
   [
     "ds:inline-flex ds:items-center ds:gap-[var(--spacing-sm)]",
     "ds:rounded-[var(--radius-md)]",
@@ -127,7 +154,7 @@ const le = A(
       density: "default"
     }
   }
-), ue = A(
+), ue = V(
   ["ds:inline-flex ds:flex-col", "ds:w-full"].join(" "),
   {
     variants: {
@@ -146,7 +173,7 @@ const le = A(
       density: "default"
     }
   }
-), X = A(
+), X = V(
   [
     "ds:hidden ds:md:inline-flex ds:items-center ds:gap-[calc(var(--spacing-xs)/2)]",
     "ds:ms-auto",
@@ -160,7 +187,7 @@ const le = A(
     "ds:text-[length:var(--font-size-xs)] ds:text-[color:var(--foreground)]",
     "ds:font-[family-name:var(--font-mono)]"
   ].join(" ")
-), pe = A(
+), pe = V(
   [
     "ds:z-[var(--z-dropdown)]",
     "ds:rounded-[var(--radius-md)]",
@@ -184,14 +211,14 @@ function Ie(s, r) {
     )
   })).filter((i) => i.items.length > 0);
 }
-const he = te(
+const he = ae(
   (s, r) => {
     const {
       mode: o = "launcher",
       size: i = "md",
       density: f = "default",
       topLevel: l = !1,
-      placeholder: t,
+      placeholder: a,
       shortcutHint: g = !0,
       className: y,
       onOpenCommandPalette: n,
@@ -204,19 +231,19 @@ const he = te(
       onSelect: m,
       debounceMs: b,
       ...C
-    } = s, { t: v } = U(), [V, K] = _(!1);
+    } = s, { t: v } = U(), [_, q] = j(!1);
     F(() => {
-      K(ce());
+      q(ce());
     }, []);
-    const z = V ? "⌘K" : "Ctrl+K", x = "Meta+K Control+K", k = l ? { role: "search" } : { role: void 0 };
+    const z = _ ? "⌘K" : "Ctrl+K", x = "Meta+K Control+K", S = l ? { role: "search" } : { role: void 0 };
     if (o === "launcher") {
-      const I = t ?? v("search.placeholder", "Search…");
-      return /* @__PURE__ */ a(
+      const I = a ?? v("search.placeholder", "Search…");
+      return /* @__PURE__ */ t(
         fe,
         {
           forwardedRef: r,
           id: u,
-          landmarkProps: k,
+          landmarkProps: S,
           className: y,
           onOpenCommandPalette: n,
           onApplySavedSearch: p,
@@ -230,14 +257,14 @@ const he = te(
         }
       );
     }
-    return /* @__PURE__ */ a(
+    return /* @__PURE__ */ t(
       me,
       {
         forwardedRef: r,
         size: i,
         density: f,
-        landmarkProps: k,
-        placeholder: t,
+        landmarkProps: S,
+        placeholder: a,
         shortcutHint: g,
         shortcutLabel: z,
         ariaKeyshortcuts: x,
@@ -257,7 +284,7 @@ function fe(s) {
     landmarkProps: i,
     className: f,
     onOpenCommandPalette: l,
-    onApplySavedSearch: t,
+    onApplySavedSearch: a,
     resolvedPlaceholder: g,
     openLabel: y,
     ariaKeyshortcuts: n,
@@ -265,7 +292,7 @@ function fe(s) {
     shortcutHint: p,
     shortcutLabel: w,
     rest: N
-  } = s, d = j(null), c = j(null), m = E(
+  } = s, d = A(null), c = A(null), m = E(
     () => ({
       getQuery: () => "",
       // Launcher mode is stateless \u2014 it delegates to CommandPalette.
@@ -278,15 +305,15 @@ function fe(s) {
         var b;
         return (b = d.current) == null ? void 0 : b.focus();
       },
-      applySavedSearch: (b) => t == null ? void 0 : t(b)
+      applySavedSearch: (b) => a == null ? void 0 : a(b)
     }),
-    [l, t]
+    [l, a]
   );
   return G(
     r,
     () => c.current,
     []
-  ), W(J, m, o), /* @__PURE__ */ a(
+  ), W(J, m, o), /* @__PURE__ */ t(
     "div",
     {
       ref: c,
@@ -295,7 +322,7 @@ function fe(s) {
       "data-component-id": o,
       id: o,
       className: f,
-      children: /* @__PURE__ */ B(
+      children: /* @__PURE__ */ M(
         "button",
         {
           ref: d,
@@ -307,7 +334,7 @@ function fe(s) {
           className: u,
           ...N,
           children: [
-            /* @__PURE__ */ a(
+            /* @__PURE__ */ t(
               ie,
               {
                 "aria-hidden": !0,
@@ -315,8 +342,8 @@ function fe(s) {
                 focusable: "false"
               }
             ),
-            /* @__PURE__ */ a("span", { "aria-hidden": "true", className: "ds:truncate ds:text-start", children: g }),
-            p ? /* @__PURE__ */ a("kbd", { className: X(), children: w }) : null
+            /* @__PURE__ */ t("span", { "aria-hidden": "true", className: "ds:truncate ds:text-start", children: g }),
+            p ? /* @__PURE__ */ t("kbd", { className: X(), children: w }) : null
           ]
         }
       )
@@ -330,7 +357,7 @@ function me(s) {
     density: i,
     landmarkProps: f,
     placeholder: l,
-    shortcutHint: t,
+    shortcutHint: a,
     shortcutLabel: g,
     ariaKeyshortcuts: y,
     className: n,
@@ -342,27 +369,27 @@ function me(s) {
     results: c,
     onSelect: m,
     debounceMs: b = 150
-  } = s, { t: C } = U(), v = w !== void 0, [V, K] = _(N ?? ""), z = v ? w ?? "" : V, [x, k] = _(!1), [S, I] = _(0), H = j(null), D = ne(), $ = de((e) => {
+  } = s, { t: C } = U(), v = w !== void 0, [_, q] = j(N ?? ""), z = v ? w ?? "" : _, [x, S] = j(!1), [k, I] = j(0), H = A(null), B = ne(), $ = de((e) => {
     d == null || d(e);
   }, b), h = E(() => c ? c.flatMap((e) => e.items) : [], [c]);
   F(() => {
-    S > h.length - 1 && I(0);
-  }, [h.length, S]);
-  const Y = P(
+    k > h.length - 1 && I(0);
+  }, [h.length, k]);
+  const Y = D(
     (e) => {
-      v || K(e), $(e), k(e.trim().length > 0);
+      v || q(e), $(e), S(e.trim().length > 0);
     },
     [$, v]
-  ), M = P(
+  ), K = D(
     (e) => {
-      m == null || m(e), k(!1), v || K("");
+      m == null || m(e), S(!1), v || q("");
     },
     [m, v]
-  ), Z = P(
+  ), Z = D(
     (e) => {
       if (!(e.nativeEvent.isComposing || e.keyCode === 229)) {
         if (!x && e.key === "ArrowDown" && h.length > 0) {
-          e.preventDefault(), k(!0);
+          e.preventDefault(), S(!0);
           return;
         }
         if (x)
@@ -373,18 +400,18 @@ function me(s) {
               (R) => (R - 1 + Math.max(h.length, 1)) % Math.max(h.length, 1)
             );
           else if (e.key === "Enter") {
-            const R = h[S];
-            R && (e.preventDefault(), M(R));
-          } else e.key === "Escape" && (e.preventDefault(), k(!1));
+            const R = h[k];
+            R && (e.preventDefault(), K(R));
+          } else e.key === "Escape" && (e.preventDefault(), S(!1));
       }
     },
-    [x, h, S, M]
-  ), ee = l ?? C("search.placeholder", "Search…"), L = h.length > 0, se = x && L ? `${D}-option-${S}` : void 0, Q = P(
+    [x, h, k, K]
+  ), ee = l ?? C("search.placeholder", "Search…"), L = h.length > 0, se = x && L ? `${B}-option-${k}` : void 0, Q = D(
     (e) => {
-      v || K(e), d == null || d(e), k(e.trim().length > 0);
+      v || q(e), d == null || d(e), S(e.trim().length > 0);
     },
     [v, d]
-  ), T = j(null);
+  ), T = A(null);
   G(
     r,
     () => T.current,
@@ -398,8 +425,8 @@ function me(s) {
         Q("");
       },
       submit: () => {
-        const e = h[S];
-        e && M(e);
+        const e = h[k];
+        e && K(e);
       },
       focus: () => {
         var e;
@@ -411,12 +438,12 @@ function me(s) {
       z,
       Q,
       h,
-      S,
-      M,
+      k,
+      K,
       p
     ]
   );
-  return W(J, re, u), /* @__PURE__ */ a(q.Root, { open: x && L, onOpenChange: k, children: /* @__PURE__ */ B(
+  return W(J, re, u), /* @__PURE__ */ t(P.Root, { open: x && L, onOpenChange: S, children: /* @__PURE__ */ M(
     "div",
     {
       ref: T,
@@ -426,13 +453,13 @@ function me(s) {
       "data-component-id": u,
       className: [ue({ size: o, density: i }), n].filter(Boolean).join(" "),
       children: [
-        /* @__PURE__ */ a(q.Anchor, { asChild: !0, children: /* @__PURE__ */ B(
+        /* @__PURE__ */ t(P.Anchor, { asChild: !0, children: /* @__PURE__ */ M(
           "div",
           {
             className: "ds:relative ds:flex ds:items-center",
             onKeyDown: Z,
             children: [
-              /* @__PURE__ */ a(
+              /* @__PURE__ */ t(
                 oe,
                 {
                   ref: H,
@@ -444,11 +471,11 @@ function me(s) {
                   "aria-keyshortcuts": y,
                   role: "combobox",
                   "aria-expanded": x && L,
-                  "aria-controls": D,
+                  "aria-controls": B,
                   "aria-activedescendant": se
                 }
               ),
-              t ? /* @__PURE__ */ a(
+              a ? /* @__PURE__ */ t(
                 "kbd",
                 {
                   className: [
@@ -462,8 +489,8 @@ function me(s) {
             ]
           }
         ) }),
-        /* @__PURE__ */ a(q.Portal, { children: /* @__PURE__ */ a(
-          q.Content,
+        /* @__PURE__ */ t(P.Portal, { children: /* @__PURE__ */ t(
+          P.Content,
           {
             side: "bottom",
             align: "start",
@@ -474,20 +501,20 @@ function me(s) {
               pe(),
               "ds:w-[var(--radix-popover-trigger-width)]"
             ].join(" "),
-            children: /* @__PURE__ */ a(
+            children: /* @__PURE__ */ t(
               "div",
               {
-                id: D,
+                id: B,
                 role: "listbox",
                 "aria-label": C("search.resultsLabel", "Search results"),
                 className: "ds:flex ds:flex-col ds:gap-[calc(var(--spacing-xs)/2)]",
                 children: c && c.length > 0 ? ve(
                   c,
-                  S,
-                  D,
-                  M,
+                  k,
+                  B,
+                  K,
                   I
-                ) : /* @__PURE__ */ a(
+                ) : /* @__PURE__ */ t(
                   "div",
                   {
                     role: "presentation",
@@ -511,24 +538,24 @@ function me(s) {
 }
 function ve(s, r, o, i, f) {
   let l = 0;
-  return s.map((t, g) => {
-    const y = t.heading ? `${o}-group-${g}-heading` : void 0;
-    return /* @__PURE__ */ B(
+  return s.map((a, g) => {
+    const y = a.heading ? `${o}-group-${g}-heading` : void 0;
+    return /* @__PURE__ */ M(
       "div",
       {
-        role: t.heading ? "group" : "presentation",
+        role: a.heading ? "group" : "presentation",
         "aria-labelledby": y,
         children: [
-          t.heading ? /* @__PURE__ */ a(
+          a.heading ? /* @__PURE__ */ t(
             "div",
             {
               id: y,
               "aria-hidden": "true",
               className: "ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)] ds:pt-[var(--spacing-xs)] ds:pb-[var(--spacing-xs)] type-eyebrow ds:text-[color:var(--foreground)]",
-              children: t.heading
+              children: a.heading
             }
           ) : null,
-          t.items.map((n) => {
+          a.items.map((n) => {
             const u = l;
             l += 1;
             const p = u === r, w = `${o}-option-${u}`, N = ge(n.href), d = [
@@ -540,8 +567,8 @@ function ve(s, r, o, i, f) {
               "ds:no-underline ds:text-[color:var(--foreground)]",
               "ds:min-h-[var(--min-target-size)]",
               p ? "ds:bg-[var(--muted)]/40" : ""
-            ].join(" "), c = /* @__PURE__ */ B(ae, { children: [
-              n.icon ? /* @__PURE__ */ a(
+            ].join(" "), c = /* @__PURE__ */ M(te, { children: [
+              n.icon ? /* @__PURE__ */ t(
                 "span",
                 {
                   "aria-hidden": "true",
@@ -549,8 +576,8 @@ function ve(s, r, o, i, f) {
                   children: n.icon
                 }
               ) : null,
-              /* @__PURE__ */ a("span", { className: "ds:flex-1 ds:text-[length:var(--font-size-sm)]", children: n.label }),
-              n.meta ? /* @__PURE__ */ a("span", { className: "ds:ms-auto type-meta ds:text-[color:var(--foreground)]", children: n.meta }) : null
+              /* @__PURE__ */ t("span", { className: "ds:flex-1 ds:text-[length:var(--font-size-sm)]", children: n.label }),
+              n.meta ? /* @__PURE__ */ t("span", { className: "ds:ms-auto type-meta ds:text-[color:var(--foreground)]", children: n.meta }) : null
             ] }), m = {
               id: w,
               role: "option",
@@ -563,7 +590,7 @@ function ve(s, r, o, i, f) {
               onMouseEnter: () => f(u),
               className: d
             };
-            return N ? /* @__PURE__ */ a("a", { href: N, ...m, children: c }, n.id) : /* @__PURE__ */ a("div", { ...m, children: c }, n.id);
+            return N ? /* @__PURE__ */ t("a", { href: N, ...m, children: c }, n.id) : /* @__PURE__ */ t("div", { ...m, children: c }, n.id);
           })
         ]
       },
@@ -582,4 +609,4 @@ export {
   Ie as f,
   J as s
 };
-//# sourceMappingURL=search-bar-SY2BcV2N.js.map
+//# sourceMappingURL=search-bar-C_T3pBJn.js.map

package/dist/_chunks/{search-input-DbxrnHkW.js → search-input-DQvGxR74.js}

@@ -2,7 +2,7 @@ import { jsx as t, jsxs as ne } from "react/jsx-runtime";
 import { forwardRef as ie, useState as F, useRef as K, useCallback as V, useImperativeHandle as oe, useEffect as de } from "react";
 import { c as x } from "./index-D2ZczOXr.js";
 import { useTranslation as le } from "react-i18next";
-import { T as ce } from "./text-input-BaClJL8Y.js";
+import { T as ce } from "./text-input-B-OWQ1Je.js";
 import { S as ue } from "./spinner-hbwuKwMf.js";
 import { u as fe } from "./form-field-context-B3APVHKx.js";
 import { u as me } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
@@ -234,4 +234,4 @@ Ee.displayName = "SearchInput";
 export {
   Ee as S
 };
-//# sourceMappingURL=search-input-DbxrnHkW.js.map
+//# sourceMappingURL=search-input-DQvGxR74.js.map

package/dist/_chunks/{search-input.agent-CfZvViOd.js → search-input.agent-DRH54coT.js}

@@ -1,6 +1,8 @@
-const i = {
+const r = {
   id: "search-input",
-  capabilities: ["filter", "edit_inline"],
+  // The query is a transient filter (set_query/clear/submit-flush), not inline
+  // content editing — `filter` covers every action here.
+  capabilities: ["filter"],
   state: {
     query: {
       type: "string",
@@ -17,8 +19,17 @@ const i = {
   },
   actions: {
     set_query: {
+      // Pure ephemeral filter text — narrows the consumer's list, no persisted change.
       safety: "read",
       argsType: "{ query: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Filter text for the input." }
+        },
+        required: ["query"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.searchInput.actions.setQuery",
       description: "Replace the current query with the given string and fire onChange immediately.",
       invoke: (e, t) => {
@@ -26,7 +37,9 @@ const i = {
       }
     },
     clear: {
+      // Clears the transient filter — no user content lost.
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.searchInput.actions.clear",
       description: "Clear the query and return focus to the input.",
       invoke: (e) => {
@@ -34,6 +47,7 @@ const i = {
       }
     },
     submit: {
+      // Flushes the debounced query immediately — ephemeral, no data loss.
       safety: "read",
       descriptionKey: "ui.agent.searchInput.actions.submit",
       description: "Fire the current query without waiting for debounce.",
@@ -43,6 +57,7 @@ const i = {
     },
     focus: {
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.searchInput.actions.focus",
       description: 'Move keyboard focus to the input (expanding it first if `variant="expandable"`).',
       invoke: (e) => {
@@ -64,6 +79,6 @@ const i = {
   }
 };
 export {
-  i as s
+  r as s
 };
-//# sourceMappingURL=search-input.agent-CfZvViOd.js.map
+//# sourceMappingURL=search-input.agent-DRH54coT.js.map