@alfadocs/ui-kit 0.67.1 → 0.69.0

package/dist/_chunks/{locale-picker-C9JmBht3.js → locale-picker-ChYYSX2N.js}

@@ -4,12 +4,12 @@ import { c as B } from "./index-D2ZczOXr.js";
 import { useTranslation as T } from "react-i18next";
 import { _ as y, R as ee } from "./index-4xgbg-sn.js";
 import { I as ae } from "./icon-button-LqoiKcUN.js";
-import { P as C } from "./popover-DTbfAuR0.js";
+import { P as C } from "./popover-B2qCDhJC.js";
 import { h as A, a as _ } from "./flag-DZ6V7-hU.js";
 import { c as se, a as te, d as re } from "./input-surface-xyERuLU_.js";
 import { LOCALES_WITH_BUNDLES as j } from "../i18n/config.js";
 import { u as oe } from "./use-locale-BkCIHujH.js";
-import { u as ne } from "./registry-nPAVE19X.js";
+import { u as ne } from "./registry-DvAUVLHh.js";
 import { G as z } from "./globe-BkEFMNSg.js";
 import { M as ie } from "./monitor-D-SFdbrU.js";
 import { C as O } from "./check-DPdL_Sm7.js";
@@ -164,12 +164,24 @@ const de = [
   ...j.map((e) => k[e])
 ].sort((e, a) => e.englishName.localeCompare(a.englishName, "en")), le = {
   id: "locale-picker",
-  capabilities: ["view_change"],
+  // Persists a single locale choice via the handle's `setLocale` → set_value.
+  capabilities: ["set_value"],
   state: {},
   actions: {
     set_locale: {
       safety: "write",
       argsType: "{ locale: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          locale: {
+            type: "string",
+            description: 'IETF language tag (e.g. "en", "it"). Unsupported tags are a no-op.'
+          }
+        },
+        required: ["locale"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.localePicker.actions.setLocale",
       description: "Switch the active locale to the given IETF tag.",
       invoke: (e, a) => {
@@ -185,11 +197,11 @@ const de = [
     }
   }
 }, b = "alfadocs-ui.locale", g = "system";
-let G = !1;
+let U = !1;
 function h(e) {
   return typeof e == "string" && j.includes(e);
 }
-function U(e) {
+function G(e) {
   if (typeof window > "u") return null;
   try {
     return window.localStorage.getItem(e);
@@ -197,7 +209,7 @@ function U(e) {
     return null;
   }
 }
-function V(e, a) {
+function q(e, a) {
   if (!(typeof window > "u"))
     try {
       window.localStorage.setItem(e, a);
@@ -216,7 +228,7 @@ function L(e) {
   const a = document.documentElement;
   a.lang = e, a.dir = k[e].dir;
 }
-function q(e) {
+function V(e) {
   if (!(typeof window > "u"))
     try {
       window.localStorage.removeItem(e);
@@ -224,31 +236,31 @@ function q(e) {
     }
 }
 function J() {
-  const { locale: e, setLocale: a } = oe(), [m, d] = M(
-    () => U(b) === null
+  const { locale: e, setLocale: a } = oe(), [u, d] = M(
+    () => G(b) === null
   ), i = h(e) ? e : "en", l = R(
     (o) => {
       if (o === g) {
-        q(b);
+        V(b);
         const r = x();
         a(r), L(r), d(!0);
         return;
       }
-      h(o) && (a(o), L(o), V(b, o), d(!1));
+      h(o) && (a(o), L(o), q(b, o), d(!1));
     },
     [a]
   );
   return Z(() => {
-    if (G) return;
-    G = !0;
-    const o = U(b);
+    if (U) return;
+    U = !0;
+    const o = G(b);
     if (h(o)) {
       o !== e && a(o), L(o);
       return;
     }
     const r = x();
     a(r), L(r);
-  }, []), { locale: i, isSystemDefault: m, setLocale: l };
+  }, []), { locale: i, isSystemDefault: u, setLocale: l };
 }
 const K = B("ds:inline-flex ds:items-center", {
   variants: {
@@ -274,7 +286,7 @@ const K = B("ds:inline-flex ds:items-center", {
   "ds:bg-background ds:text-foreground ds:border ds:border-border",
   "ds:shadow-[var(--shadow-lg)]",
   "ds:overflow-hidden"
-].join(" "), me = B("ds:flex ds:flex-col", {
+].join(" "), ue = B("ds:flex ds:flex-col", {
   variants: {
     loading: {
       true: "ds:opacity-60 ds:pointer-events-none",
@@ -286,12 +298,12 @@ const K = B("ds:inline-flex ds:items-center", {
   ({
     value: e,
     onValueChange: a,
-    inputId: m,
+    inputId: u,
     disabled: d = !1,
     loading: i = !1,
     className: l
   }, o) => {
-    const { t: r } = T(), n = J(), E = n.locale, S = e ?? (n.isSystemDefault ? g : n.locale), p = $(), w = m ?? `${p}-search`, [P, v] = M(""), N = R(
+    const { t: r } = T(), n = J(), E = n.locale, S = e ?? (n.isSystemDefault ? g : n.locale), p = $(), w = u ?? `${p}-search`, [P, v] = M(""), N = R(
       (t) => {
         if (!(d || i)) {
           if (t === g) {
@@ -307,7 +319,7 @@ const K = B("ds:inline-flex ds:items-center", {
       "div",
       {
         ref: o,
-        className: [me({ loading: i }), l].filter(Boolean).join(" "),
+        className: [ue({ loading: i }), l].filter(Boolean).join(" "),
         "data-component": "locale-picker-search-list",
         children: /* @__PURE__ */ f(
           y,
@@ -498,10 +510,10 @@ const K = B("ds:inline-flex ds:items-center", {
   }
 );
 I.displayName = "LocalePicker.SearchList";
-function ue({
+function me({
   state: e,
   rest: a,
-  forwardedRef: m,
+  forwardedRef: u,
   className: d,
   disabled: i,
   loading: l,
@@ -511,7 +523,7 @@ function ue({
   return /* @__PURE__ */ s(
     "div",
     {
-      ref: m,
+      ref: u,
       "data-component": "locale-picker",
       "data-component-id": a.id,
       className: K({ variant: "icon", className: d }),
@@ -575,7 +587,7 @@ function ue({
 function ge({
   state: e,
   rest: a,
-  forwardedRef: m,
+  forwardedRef: u,
   className: d,
   disabled: i,
   loading: l,
@@ -585,7 +597,7 @@ function ge({
   return /* @__PURE__ */ s(
     "div",
     {
-      ref: m,
+      ref: u,
       "data-component": "locale-picker",
       "data-component-id": a.id,
       className: K({ variant: "compact", className: d }),
@@ -648,7 +660,7 @@ function ge({
 const Y = H(
   (e, a) => {
     const {
-      variant: m = "icon",
+      variant: u = "icon",
       value: d,
       onValueChange: i,
       disabled: l = !1,
@@ -658,16 +670,16 @@ const Y = H(
       id: E,
       ...S
     } = e, p = J(), w = d ?? p.locale, P = R(
-      (u) => {
+      (m) => {
         if (i) {
-          if (i(u), u === g) {
-            q(b);
+          if (i(m), m === g) {
+            V(b);
             const X = x();
             L(X);
-          } else h(u) && (L(u), V(b, u));
+          } else h(m) && (L(m), q(b, m));
           return;
         }
-        p.setLocale(u);
+        p.setLocale(m);
       },
       [i, p]
     ), v = D(
@@ -683,13 +695,13 @@ const Y = H(
     t.current = v;
     const c = D(
       () => ({
-        setLocale: (u) => {
-          h(u) && t.current.setLocale(u);
+        setLocale: (m) => {
+          h(m) && t.current.setLocale(m);
         }
       }),
       []
     );
-    return ne(le, c, E), m === "compact" ? /* @__PURE__ */ s(
+    return ne(le, c, E), u === "compact" ? /* @__PURE__ */ s(
       ge,
       {
         state: v,
@@ -701,7 +713,7 @@ const Y = H(
         popoverSide: r
       }
     ) : /* @__PURE__ */ s(
-      ue,
+      me,
       {
         state: v,
         rest: S,
@@ -724,4 +736,4 @@ export {
   I as b,
   k as c
 };
-//# sourceMappingURL=locale-picker-C9JmBht3.js.map
+//# sourceMappingURL=locale-picker-ChYYSX2N.js.map

package/dist/_chunks/{map-view-Tb5VfK9Y.js → map-view-BkOoGoX2.js}

@@ -1,39 +1,84 @@
-import { jsx as n, jsxs as p } from "react/jsx-runtime";
-import { forwardRef as J, useId as K, useMemo as h, useState as T, useEffect as u, useRef as O, useCallback as N, useImperativeHandle as Q } from "react";
+import { jsx as o, jsxs as m } from "react/jsx-runtime";
+import { forwardRef as F, useId as J, useMemo as h, useState as T, useEffect as u, useRef as O, useCallback as N, useImperativeHandle as Q } from "react";
 import { c } from "./index-D2ZczOXr.js";
-import { useTranslation as Z } from "react-i18next";
-import { A as W, M as X, a as Y, P as C, b as k, c as ee } from "./index.modern-D2LGACWg.js";
-import { B as se } from "./button-DD_0Xdmr.js";
-import { u as ae } from "./registry-nPAVE19X.js";
-import { M as te } from "./map-pin-B8STOPMJ.js";
-import { E as ne } from "./external-link-C6F25E6k.js";
-const oe = {
+import { useTranslation as j } from "react-i18next";
+import { A as W, M as X, a as Y, P as k, b as C, u as ee } from "./index.modern-Zta-A4Jm.js";
+import { B as te } from "./button-DD_0Xdmr.js";
+import { u as se } from "./registry-DvAUVLHh.js";
+import { M as ae } from "./map-pin-B8STOPMJ.js";
+import { E as oe } from "./external-link-C6F25E6k.js";
+const ne = {
   id: "map-view",
-  capabilities: [],
+  // pan → scroll (viewport move); set_zoom → set_value; select_marker → pick
+  // (NON-persisting marker focus, no value state slot).
+  capabilities: ["scroll", "set_value", "pick"],
   state: {},
   actions: {
     pan_to: {
+      // Ephemeral viewport move, no data loss → read.
       safety: "read",
       argsType: "{ position: { lat: number; lng: number } }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          position: {
+            type: "object",
+            properties: {
+              lat: { type: "number", description: "Latitude in degrees." },
+              lng: { type: "number", description: "Longitude in degrees." }
+            },
+            required: ["lat", "lng"]
+          }
+        },
+        required: ["position"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.mapView.actions.panTo",
       description: "Pan the map to a new centre without changing zoom.",
-      invoke: (t, o) => {
-        t.panTo(o.position);
+      invoke: (a, n) => {
+        a.panTo(n.position);
       }
     },
     set_zoom: {
+      // Ephemeral viewport zoom, no data loss → read.
       safety: "read",
       argsType: "{ zoom: number }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          zoom: {
+            type: "number",
+            description: "Zoom level, typical range 1–20."
+          }
+        },
+        required: ["zoom"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.mapView.actions.setZoom",
       description: "Set the map zoom level (typical range 1–20).",
-      invoke: (t, o) => {
-        t.setZoom(o.zoom);
+      invoke: (a, n) => {
+        a.setZoom(n.zoom);
       }
     },
     select_marker: {
+      // Ephemeral marker focus, no data loss → read.
       safety: "read",
       argsType: "{ id: string | null }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: ["string", "null"],
+            description: "Marker id to select, or null to clear the selection."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.mapView.actions.selectMarker",
       description: "Select a marker by id, or pass null to clear the selection.",
-      invoke: (t, o) => {
-        t.selectMarker(o.id);
+      invoke: (a, n) => {
+        a.selectMarker(n.id);
       }
     }
   },
@@ -92,61 +137,61 @@ const oe = {
     "ds:bg-[var(--muted)] ds:text-[var(--foreground)]",
     "ds:text-center"
   ].join(" ")
-), le = c("type-heading-3 ds:m-0"), I = c(
+), le = c("type-heading-3 ds:m-0"), Z = c(
   "type-body-sm ds:text-[var(--muted-foreground)] ds:[max-inline-size:28rem] ds:m-0"
 );
 function ce({
-  onHandleReady: t,
-  onMarkerSelect: o
+  onHandleReady: a,
+  onMarkerSelect: n
 }) {
-  const a = ee();
+  const s = ee();
   return u(() => {
-    a && t({
-      panTo: (i) => a.panTo(i),
-      setZoom: (i) => a.setZoom(i),
-      selectMarker: (i) => o(i)
+    s && a({
+      panTo: (i) => s.panTo(i),
+      setZoom: (i) => s.setZoom(i),
+      selectMarker: (i) => n(i)
     });
-  }, [a, t, o]), null;
+  }, [s, a, n]), null;
 }
-function me({
-  address: t,
-  description: o,
-  onLoadMap: a,
+function pe({
+  address: a,
+  description: n,
+  onLoadMap: s,
   openInGoogleMapsHref: i,
   consentCta: f
 }) {
-  const { t: l } = Z();
-  return /* @__PURE__ */ p("div", { className: de(), "data-testid": "map-view-consent", children: [
-    /* @__PURE__ */ n(
-      te,
+  const { t: l } = j();
+  return /* @__PURE__ */ m("div", { className: de(), "data-testid": "map-view-consent", children: [
+    /* @__PURE__ */ o(
+      ae,
       {
         "aria-hidden": "true",
         className: "ds:size-6 ds:text-[var(--muted-foreground)]"
       }
     ),
-    /* @__PURE__ */ n("p", { className: le(), children: l("mapView.consentTitle") }),
-    t ? /* @__PURE__ */ n(
+    /* @__PURE__ */ o("p", { className: le(), children: l("mapView.consentTitle") }),
+    a ? /* @__PURE__ */ o(
       "p",
       {
-        className: I(),
+        className: Z(),
         "data-testid": "map-view-address",
-        children: t
+        children: a
       }
     ) : null,
-    /* @__PURE__ */ n("p", { className: I(), children: o }),
-    /* @__PURE__ */ p("div", { className: "ds:flex ds:gap-[var(--spacing-sm)] ds:flex-wrap ds:items-center ds:justify-center", children: [
-      f ?? /* @__PURE__ */ n(
-        se,
+    /* @__PURE__ */ o("p", { className: Z(), children: n }),
+    /* @__PURE__ */ m("div", { className: "ds:flex ds:gap-[var(--spacing-sm)] ds:flex-wrap ds:items-center ds:justify-center", children: [
+      f ?? /* @__PURE__ */ o(
+        te,
         {
           type: "button",
           intent: "primary",
           size: "sm",
-          onClick: a,
+          onClick: s,
           "data-testid": "map-view-load-cta",
           children: l("mapView.consentCta")
         }
       ),
-      /* @__PURE__ */ p(
+      /* @__PURE__ */ m(
         "a",
         {
           href: i,
@@ -155,141 +200,141 @@ function me({
           className: "ds:inline-flex ds:items-center ds:gap-[var(--spacing-2xs)] ds:text-[var(--primary)] ds:underline ds:underline-offset-2",
           children: [
             l("mapView.openInGoogleMaps"),
-            /* @__PURE__ */ n(ne, { "aria-hidden": "true", className: "ds:size-3" })
+            /* @__PURE__ */ o(oe, { "aria-hidden": "true", className: "ds:size-3" })
           ]
         }
       )
     ] })
   ] });
 }
-const pe = J(
+const me = F(
   ({
-    id: t,
-    apiKey: o,
-    center: a,
+    id: a,
+    apiKey: n,
+    center: s,
     zoom: i = 15,
     markers: f,
     selectedMarkerId: l,
     onMarkerClick: r,
-    consentGranted: P = !1,
-    onConsentRequest: v,
-    address: m,
+    consentGranted: I = !1,
+    onConsentRequest: g,
+    address: p,
     consentDescription: L,
     consentCta: M,
-    mapId: w,
-    size: y,
-    surface: j,
-    ariaLabel: A,
-    className: S,
-    ..._
-  }, E) => {
-    const { t: b, i18n: H } = Z(), z = K(), R = h(
+    mapId: y,
+    size: w,
+    surface: S,
+    ariaLabel: P,
+    className: _,
+    ...q
+  }, A) => {
+    const { t: b, i18n: E } = j(), z = J(), H = h(
       () => `map-${z.replace(/[^a-zA-Z0-9-_]/g, "")}`,
       [z]
-    ), [V, $] = T(!1);
+    ), [V, R] = T(!1);
     u(() => {
       if (typeof window > "u") return;
-      const e = window.matchMedia("(prefers-reduced-motion: reduce)"), s = () => $(e.matches);
-      return s(), e.addEventListener("change", s), () => e.removeEventListener("change", s);
+      const e = window.matchMedia("(prefers-reduced-motion: reduce)"), t = () => R(e.matches);
+      return t(), e.addEventListener("change", t), () => e.removeEventListener("change", t);
     }, []);
-    const B = h(() => `https://www.google.com/maps/search/?api=1&query=${m ? encodeURIComponent(m) : `${a.lat},${a.lng}`}`, [m, a.lat, a.lng]), d = O(null), D = N((e) => {
+    const $ = h(() => `https://www.google.com/maps/search/?api=1&query=${p ? encodeURIComponent(p) : `${s.lat},${s.lng}`}`, [p, s.lat, s.lng]), d = O(null), B = N((e) => {
       d.current = e;
     }, []);
     Q(
-      E,
+      A,
       () => ({
         panTo: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.panTo(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.panTo(e);
         },
         setZoom: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.setZoom(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.setZoom(e);
         },
         selectMarker: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.selectMarker(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.selectMarker(e);
         }
       }),
       []
     );
-    const q = h(
+    const D = h(
       () => ({
         panTo: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.panTo(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.panTo(e);
         },
         setZoom: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.setZoom(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.setZoom(e);
         },
         selectMarker: (e) => {
-          var s;
-          return (s = d.current) == null ? void 0 : s.selectMarker(e);
+          var t;
+          return (t = d.current) == null ? void 0 : t.selectMarker(e);
         }
       }),
       []
     );
-    ae(oe, q, t), u(() => {
+    se(ne, D, a), u(() => {
       var e;
-      V || (e = d.current) == null || e.panTo(a);
-    }, [a.lat, a.lng, V]), u(() => {
+      V || (e = d.current) == null || e.panTo(s);
+    }, [s.lat, s.lng, V]), u(() => {
       var e;
       (e = d.current) == null || e.setZoom(i);
     }, [i]);
-    const [G, x] = T(!1), U = P || G, F = N(() => {
-      if (v) {
-        v(), x(!0);
+    const [K, x] = T(!1), G = I || K, U = N(() => {
+      if (g) {
+        g(), x(!0);
         return;
       }
       x(!0);
-    }, [v]);
-    return /* @__PURE__ */ n(
+    }, [g]);
+    return /* @__PURE__ */ o(
       "div",
       {
-        className: re({ size: y, surface: j, className: S }),
+        className: re({ size: w, surface: S, className: _ }),
         "data-component": "map-view",
-        "data-component-id": t ?? R,
+        "data-component-id": a ?? H,
         role: "region",
-        "aria-label": A ?? b("mapView.label"),
-        ..._,
-        children: /* @__PURE__ */ n("div", { className: ie({ size: y }), children: U ? /* @__PURE__ */ n(
+        "aria-label": P ?? b("mapView.label"),
+        ...q,
+        children: /* @__PURE__ */ o("div", { className: ie({ size: w }), children: G ? /* @__PURE__ */ o(
           W,
           {
-            apiKey: o,
-            language: H.language,
-            children: /* @__PURE__ */ p(
+            apiKey: n,
+            language: E.language,
+            children: /* @__PURE__ */ m(
               X,
               {
-                defaultCenter: a,
+                defaultCenter: s,
                 defaultZoom: i,
-                mapId: w,
+                mapId: y,
                 gestureHandling: "cooperative",
                 disableDefaultUI: !1,
                 onClick: () => r == null ? void 0 : r(null),
                 className: "ds:[inline-size:100%] ds:[block-size:100%]",
                 children: [
-                  /* @__PURE__ */ n(
+                  /* @__PURE__ */ o(
                     ce,
                     {
-                      onHandleReady: D,
+                      onHandleReady: B,
                       onMarkerSelect: (e) => r == null ? void 0 : r(e)
                     }
                   ),
                   (f ?? []).map((e) => {
-                    const s = l != null && l === e.id, g = b("mapView.markerLabel", {
+                    const t = l != null && l === e.id, v = b("mapView.markerLabel", {
                       label: e.label ?? e.id
                     });
-                    return w ? /* @__PURE__ */ n(
+                    return y ? /* @__PURE__ */ o(
                       Y,
                       {
                         position: e.position,
-                        title: g,
-                        "aria-label": g,
-                        "data-selected": s ? "true" : "false",
+                        title: v,
+                        "aria-label": v,
+                        "data-selected": t ? "true" : "false",
                         onClick: () => r == null ? void 0 : r(e.id),
-                        children: /* @__PURE__ */ n(
-                          C,
+                        children: /* @__PURE__ */ o(
+                          k,
                           {
                             background: "var(--primary)",
                             borderColor: "var(--primary)",
@@ -298,11 +343,11 @@ const pe = J(
                         )
                       },
                       e.id
-                    ) : /* @__PURE__ */ n(
-                      k,
+                    ) : /* @__PURE__ */ o(
+                      C,
                       {
                         position: e.position,
-                        title: g,
+                        title: v,
                         onClick: () => r == null ? void 0 : r(e.id)
                       },
                       e.id
@@ -312,22 +357,22 @@ const pe = J(
               }
             )
           }
-        ) : /* @__PURE__ */ n(
-          me,
+        ) : /* @__PURE__ */ o(
+          pe,
           {
-            address: m,
+            address: p,
             description: L ?? b("mapView.consentDescription"),
-            onLoadMap: F,
+            onLoadMap: U,
             consentCta: M,
-            openInGoogleMapsHref: B
+            openInGoogleMapsHref: $
           }
         ) })
       }
     );
   }
 );
-pe.displayName = "MapView";
+me.displayName = "MapView";
 export {
-  pe as M
+  me as M
 };
-//# sourceMappingURL=map-view-Tb5VfK9Y.js.map
+//# sourceMappingURL=map-view-BkOoGoX2.js.map