@alfadocs/ui-kit 0.68.0 → 0.70.0

package/dist/_chunks/{message-tray-CVyJajVJ.js → message-tray-DwrBLJlf.js}

@@ -1,18 +1,18 @@
-import { jsx as s, jsxs as c, Fragment as B } from "react/jsx-runtime";
-import { forwardRef as re, useState as ne, useCallback as ie, useEffect as A, useRef as m, useMemo as de, useImperativeHandle as oe } from "react";
+import { jsx as s, jsxs as c, Fragment as q } from "react/jsx-runtime";
+import { forwardRef as re, useState as ne, useCallback as ie, useEffect as B, useRef as m, useMemo as de, useImperativeHandle as oe } from "react";
 import * as x from "@radix-ui/react-popover";
-import { c as C } from "./index-D2ZczOXr.js";
-import { useTranslation as q } from "react-i18next";
+import { c as S } from "./index-D2ZczOXr.js";
+import { useTranslation as L } from "react-i18next";
 import { u as ce } from "./use-controllable-state-BiY4xTzM.js";
 import { u as le } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
 import { I as me } from "./icon-button-LqoiKcUN.js";
-import { B as E } from "./button-DD_0Xdmr.js";
-import { S as L } from "./separator-CYU_bGFn.js";
+import { B as A } from "./button-DD_0Xdmr.js";
+import { S as E } from "./separator-CYU_bGFn.js";
 import { S as f } from "./skeleton-CZbwyJAA.js";
 import { M as pe } from "./message-card-Bx4GmLvf.js";
-import { u as ue } from "./registry-nPAVE19X.js";
+import { u as ge } from "./registry-DvAUVLHh.js";
 import { M as F } from "./mail-C8irm52s.js";
-const ge = {
+const ue = {
   id: "message-tray",
   capabilities: ["open", "close", "select_single", "dismiss"],
   state: {
@@ -37,7 +37,9 @@ const ge = {
   },
   actions: {
     open: {
+      // Pure ephemeral panel-visibility change — read.
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.messageTray.actions.open",
       description: "Open the message panel.",
       invoke: (a) => {
@@ -45,7 +47,9 @@ const ge = {
       }
     },
     close: {
+      // Pure ephemeral panel-visibility change — read.
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.messageTray.actions.close",
       description: "Close the message panel.",
       invoke: (a) => {
@@ -53,17 +57,43 @@ const ge = {
       }
     },
     select_item: {
+      // Activates (navigates to) a message — ephemeral view change, read.
       safety: "read",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Stable message id to activate (sourced from item.id)."
+          }
+        },
+        required: ["id"]
+      },
       descriptionKey: "ui.agent.messageTray.actions.selectItem",
       description: "Activate the message with the given id.",
+      examples: [
+        { args: { id: "msg-1" }, note: 'Open the message with id "msg-1".' }
+      ],
       invoke: (a, t) => {
         a.selectItem(t.id);
       }
     },
     mark_read: {
+      // Persists read-intent for one message, reversible via the same UI — write.
       safety: "write",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Stable message id to mark as read."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.messageTray.actions.markRead",
       description: "Request the host to mark a message as read.",
       invoke: (a, t) => {
@@ -71,8 +101,20 @@ const ge = {
       }
     },
     dismiss: {
+      // Archives / removes a message — irreversible from this UI, destructive.
       safety: "destructive",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Stable message id to dismiss / archive."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.messageTray.actions.dismiss",
       description: "Request the host to dismiss / archive the message with the given id.",
       invoke: (a, t) => {
@@ -96,7 +138,7 @@ const ge = {
       description: "Stable message id emitted on each rendered MessageCard inside the tray."
     }
   }
-}, fe = C("ds:relative ds:inline-flex ds:items-center", {
+}, fe = S("ds:relative ds:inline-flex ds:items-center", {
   variants: {
     size: {
       sm: "",
@@ -106,7 +148,7 @@ const ge = {
   defaultVariants: {
     size: "md"
   }
-}), ve = C(
+}), ve = S(
   [
     "ds:flex ds:flex-col",
     "ds:bg-[var(--popover)] ds:text-[var(--popover-foreground)]",
@@ -142,7 +184,7 @@ const ge = {
       size: "md"
     }
   }
-), he = C(
+), he = S(
   [
     "ds:absolute ds:-top-[var(--spacing-xs)] ds:-end-[var(--spacing-xs)]",
     "ds:inline-flex ds:items-center ds:justify-center",
@@ -176,7 +218,7 @@ function z() {
   );
 }
 function xe() {
-  const { t: a } = q();
+  const { t: a } = L();
   return /* @__PURE__ */ c(
     "div",
     {
@@ -206,12 +248,12 @@ const be = re(
     open: H,
     onOpenChange: _,
     onItemClick: p,
-    onDismiss: u,
+    onDismiss: g,
     onMarkRead: v,
-    onMarkAllRead: M,
+    onMarkAllRead: C,
     loading: U = !1,
     maxVisible: W,
-    viewAllLabel: R,
+    viewAllLabel: M,
     onViewAll: Y,
     align: G = "end",
     side: J = "bottom",
@@ -220,13 +262,13 @@ const be = re(
     ...X
   }, Z) => {
     var K;
-    const { t: d } = q(), [$, h] = ce({
+    const { t: d } = L(), [$, h] = ce({
       value: H,
       defaultValue: !1,
       onChange: _
-    }), w = $ ?? !1, [g, S] = ne(
+    }), w = $ ?? !1, [u, R] = ne(
       () => t.map((e) => ({ item: e, leaving: !1 }))
-    ), O = ie(() => {
+    ), j = ie(() => {
       if (typeof window > "u") return 200;
       const e = window.getComputedStyle(document.documentElement).getPropertyValue("--animation-duration");
       if (!e) return 200;
@@ -234,7 +276,7 @@ const be = re(
       return Number.isFinite(n) ? r.endsWith("ms") ? n : n * 1e3 : 200;
     }, []);
     le(() => {
-      S((e) => {
+      R((e) => {
         const r = new Set(t.map((i) => i.id)), n = new Set(e.map((i) => i.item.id)), o = e.map((i) => {
           if (r.has(i.item.id)) {
             const P = t.find((te) => te.id === i.item.id);
@@ -246,17 +288,17 @@ const be = re(
           n.has(i.id) || o.push({ item: i, leaving: !1 });
         return o;
       });
-    }, [t]), A(() => {
-      if (!g.some((n) => n.leaving)) return;
-      const e = O(), r = setTimeout(() => {
-        S((n) => n.filter((o) => !o.leaving));
+    }, [t]), B(() => {
+      if (!u.some((n) => n.leaving)) return;
+      const e = j(), r = setTimeout(() => {
+        R((n) => n.filter((o) => !o.leaving));
       }, e);
       return () => clearTimeout(r);
-    }, [g, O]);
-    const N = m(null), k = m((K = t[0]) == null ? void 0 : K.id);
-    A(() => {
+    }, [u, j]);
+    const N = m(null), O = m((K = t[0]) == null ? void 0 : K.id);
+    B(() => {
       var n;
-      const e = (n = t[0]) == null ? void 0 : n.id, r = k.current;
+      const e = (n = t[0]) == null ? void 0 : n.id, r = O.current;
       if (r && e && r !== e && N.current) {
         const o = t[0];
         o && !o.read && (N.current.textContent = d("messageTray.newMessage", {
@@ -264,7 +306,7 @@ const be = re(
           defaultValue: "New message from {{sender}}"
         }));
       }
-      k.current = e;
+      O.current = e;
     }, [t, d]);
     const y = b ?? 0, D = y > 0 ? d("messageTray.triggerLabel", {
       count: y,
@@ -274,8 +316,8 @@ const be = re(
       d("messageTray.badgeCountOverflow", "99+")
     ), se = ve({ size: T }), l = m(t);
     l.current = t;
-    const j = m(b);
-    j.current = b;
+    const k = m(b);
+    k.current = b;
     const I = m(w);
     I.current = w;
     const ae = de(
@@ -284,7 +326,7 @@ const be = re(
         close: () => h(!1),
         isOpen: () => I.current,
         getItems: () => l.current.map((e) => ({ id: e.id, read: !!e.read })),
-        getUnreadCount: () => j.current ?? l.current.filter((e) => !e.read).length,
+        getUnreadCount: () => k.current ?? l.current.filter((e) => !e.read).length,
         selectItem: (e) => {
           const r = l.current.find((n) => n.id === e);
           r && (p == null || p(r));
@@ -295,12 +337,12 @@ const be = re(
         },
         dismiss: (e) => {
           const r = l.current.find((n) => n.id === e);
-          r && (u == null || u(r));
+          r && (g == null || g(r));
         }
       }),
-      [h, p, v, u]
+      [h, p, v, g]
     ), V = m(null);
-    return oe(Z, () => V.current, []), ue(ge, ae, a), /* @__PURE__ */ s(
+    return oe(Z, () => V.current, []), ge(ue, ae, a), /* @__PURE__ */ s(
       "div",
       {
         ref: V,
@@ -350,52 +392,52 @@ const be = re(
               children: [
                 /* @__PURE__ */ c("div", { className: "ds:flex ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)] ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)] ds:pb-[var(--spacing-xs)]", children: [
                   /* @__PURE__ */ s("h3", { className: "ds:m-0 type-title-card ds:text-[color:var(--foreground)]", children: d("messageTray.panelTitle", "Messages") }),
-                  M && t.some((e) => !e.read) ? /* @__PURE__ */ s(
-                    E,
+                  C && t.some((e) => !e.read) ? /* @__PURE__ */ s(
+                    A,
                     {
                       intent: "link",
                       size: "sm",
-                      onClick: M,
+                      onClick: C,
                       className: "ds:text-[length:var(--font-size-xs)]",
                       children: d("messageTray.markAllRead", "Mark all as read")
                     }
                   ) : null
                 ] }),
-                /* @__PURE__ */ s(L, {}),
+                /* @__PURE__ */ s(E, {}),
                 /* @__PURE__ */ s(
                   "div",
                   {
-                    role: g.length > 0 ? "list" : void 0,
+                    role: u.length > 0 ? "list" : void 0,
                     "data-max-visible": W,
                     className: "ds:flex ds:flex-col ds:gap-[var(--spacing-xs)] ds:overflow-y-auto ds:pt-[var(--spacing-xs)] ds:flex-1 ds:sm:flex-none ds:sm:[max-block-size:var(--message-tray-max-block-size,26rem)]",
-                    children: U ? /* @__PURE__ */ c(B, { children: [
+                    children: U ? /* @__PURE__ */ c(q, { children: [
                       /* @__PURE__ */ s(z, {}),
                       /* @__PURE__ */ s(z, {}),
                       /* @__PURE__ */ s(z, {})
-                    ] }) : g.length === 0 ? /* @__PURE__ */ s(xe, {}) : g.map(({ item: e, leaving: r }) => /* @__PURE__ */ s(
+                    ] }) : u.length === 0 ? /* @__PURE__ */ s(xe, {}) : u.map(({ item: e, leaving: r }) => /* @__PURE__ */ s(
                       pe,
                       {
                         item: e,
                         variant: "compact",
                         leaving: r,
                         onActivate: p,
-                        onDismiss: u,
+                        onDismiss: g,
                         "data-message-id": e.id
                       },
                       e.id
                     ))
                   }
                 ),
-                R ? /* @__PURE__ */ c(B, { children: [
-                  /* @__PURE__ */ s(L, {}),
+                M ? /* @__PURE__ */ c(q, { children: [
+                  /* @__PURE__ */ s(E, {}),
                   /* @__PURE__ */ s("div", { className: "ds:pt-[var(--spacing-xs)]", children: /* @__PURE__ */ s(
-                    E,
+                    A,
                     {
                       intent: "link",
                       size: "sm",
                       onClick: Y,
                       className: "ds:w-full ds:justify-center",
-                      children: R
+                      children: M
                     }
                   ) })
                 ] }) : null
@@ -410,6 +452,6 @@ const be = re(
 be.displayName = "MessageTray";
 export {
   be as M,
-  ge as m
+  ue as m
 };
-//# sourceMappingURL=message-tray-CVyJajVJ.js.map
+//# sourceMappingURL=message-tray-DwrBLJlf.js.map