@alfadocs/ui-kit 0.68.0 → 0.69.0

package/dist/_chunks/{navigation-menu-C6lBYVv9.js → navigation-menu-DRUi6sSj.js}

@@ -1,15 +1,19 @@
-import { jsxs as v, jsx as s } from "react/jsx-runtime";
-import { forwardRef as i, useRef as M, useMemo as j, useImperativeHandle as I } from "react";
+import { jsxs as p, jsx as s } from "react/jsx-runtime";
+import { forwardRef as n, useRef as M, useMemo as j, useImperativeHandle as I } from "react";
 import * as o from "@radix-ui/react-navigation-menu";
 import { Slot as C } from "@radix-ui/react-slot";
 import { c as k } from "./index-D2ZczOXr.js";
 import { useTranslation as z } from "react-i18next";
 import { u as V } from "./use-controllable-state-BiY4xTzM.js";
-import { u as B } from "./registry-nPAVE19X.js";
-import { u as R } from "./use-direction-Dp8h70PP.js";
-import { C as L } from "./chevron-down-BX_NP2Yh.js";
-const T = {
+import { u as B } from "./registry-DvAUVLHh.js";
+import { u as S } from "./use-direction-Dp8h70PP.js";
+import { C as R } from "./chevron-down-BX_NP2Yh.js";
+const q = {
   id: "navigation-menu",
+  // `navigate` is host-delegated: route changes happen through the rendered
+  // NavigationMenuLink anchors / the consumer's router, not the handle. The
+  // handle only opens panels + sets the active top-level item (`select_item`).
+  // The capability is kept so a bridge can discover the menu drives navigation.
   capabilities: ["select_single", "navigate", "open", "close"],
   state: {
     activeItem: {
@@ -27,17 +31,44 @@ const T = {
   },
   actions: {
     select_item: {
+      // Sets the active top-level item (opens its panel) — ephemeral view, read.
       safety: "read",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Stable opaque top-level item id (emitted as data-nav-id)."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.navigationMenu.actions.selectItem",
       description: "Activate (open) the top-level item with the given id.",
+      examples: [
+        { args: { id: "products" }, note: 'Open the "products" menu.' }
+      ],
       invoke: (e, t) => {
         e.selectItem(t.id);
       }
     },
     open: {
+      // Opens one item's panel — ephemeral view, read.
       safety: "read",
       argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Stable opaque top-level item id whose panel to open (data-nav-id)."
+          }
+        },
+        required: ["id"]
+      },
+      idempotent: !0,
       descriptionKey: "ui.agent.navigationMenu.actions.open",
       description: "Open the dropdown / mega-menu panel for the given top-level item id.",
       invoke: (e, t) => {
@@ -45,7 +76,9 @@ const T = {
       }
     },
     close: {
+      // Closes any open panel — ephemeral view, read.
       safety: "read",
+      idempotent: !0,
       descriptionKey: "ui.agent.navigationMenu.actions.close",
       description: "Close any open dropdown / mega-menu panel.",
       invoke: (e) => {
@@ -69,25 +102,25 @@ const T = {
       description: "Stable opaque id of a top-level navigation item. Selection / open targets this attribute."
     }
   }
-}, A = [
+}, L = [
   "ds:relative ds:z-[var(--z-dropdown)]",
   "ds:flex ds:max-w-max ds:items-center ds:justify-center"
-].join(" "), K = i(
+].join(" "), O = n(
   ({
     "aria-label": e,
     className: t,
     children: a,
-    id: n,
+    id: i,
     value: l,
-    defaultValue: p,
+    defaultValue: g,
     onValueChange: f,
     ...h
   }, b) => {
-    const { t: N } = z(), m = M(null), w = R(m), [y, d] = V({
+    const { t: N } = z(), m = M(null), y = S(m), [w, d] = V({
       value: l,
-      defaultValue: p ?? "",
+      defaultValue: g ?? "",
       onChange: f
-    }), r = y ?? "", x = j(
+    }), r = w ?? "", x = j(
       () => ({
         getActiveItem: () => r || null,
         getIsOpen: () => !!r,
@@ -101,44 +134,44 @@ const T = {
       b,
       () => m.current,
       []
-    ), B(T, x, n), /* @__PURE__ */ v(
+    ), B(q, x, i), /* @__PURE__ */ p(
       o.Root,
       {
         ref: m,
-        dir: w,
+        dir: y,
         "aria-label": e ?? N("navigation.nav.label"),
-        className: [A, t].filter(Boolean).join(" "),
-        id: n,
+        className: [L, t].filter(Boolean).join(" "),
+        id: i,
         "data-component": "navigation-menu",
-        "data-component-id": n,
+        "data-component-id": i,
         value: r,
         onValueChange: d,
         ...h,
         children: [
           a,
-          /* @__PURE__ */ s(g, {})
+          /* @__PURE__ */ s(v, {})
         ]
       }
     );
   }
 );
-K.displayName = "NavigationMenu";
-const O = [
+O.displayName = "NavigationMenu";
+const T = [
   "ds:group ds:flex ds:flex-1",
   "ds:list-none ds:items-center ds:justify-center",
   "ds:gap-[var(--spacing-xs)]",
   "ds:m-0 ds:ps-0"
-].join(" "), S = i(({ className: e, ...t }, a) => /* @__PURE__ */ s(
+].join(" "), A = n(({ className: e, ...t }, a) => /* @__PURE__ */ s(
   o.List,
   {
     ref: a,
-    className: [O, e].filter(Boolean).join(" "),
+    className: [T, e].filter(Boolean).join(" "),
     ...t
   }
 ));
-S.displayName = "NavigationMenuList";
-const q = i(({ navId: e, ...t }, a) => /* @__PURE__ */ s(o.Item, { ref: a, "data-nav-id": e, ...t }));
-q.displayName = "NavigationMenuItem";
+A.displayName = "NavigationMenuList";
+const K = n(({ navId: e, ...t }, a) => /* @__PURE__ */ s(o.Item, { ref: a, "data-nav-id": e, ...t }));
+K.displayName = "NavigationMenuItem";
 const D = [
   "ds:group ds:inline-flex ds:items-center ds:justify-center",
   "ds:min-h-[var(--min-target-size)]",
@@ -157,15 +190,15 @@ const D = [
   "ds:size-3 ds:transition-transform ds:duration-[var(--animation-duration)]",
   "ds:group-data-[state=open]:rotate-180",
   "ds:rtl:-scale-x-100 ds:motion-reduce:transition-none"
-].join(" "), P = i(({ className: e, children: t, ...a }, n) => /* @__PURE__ */ v(
+].join(" "), P = n(({ className: e, children: t, ...a }, i) => /* @__PURE__ */ p(
   o.Trigger,
   {
-    ref: n,
+    ref: i,
     className: [D, e].filter(Boolean).join(" "),
     ...a,
     children: [
       t,
-      /* @__PURE__ */ s(L, { "aria-hidden": "true", className: H })
+      /* @__PURE__ */ s(R, { "aria-hidden": "true", className: H })
     ]
   }
 ));
@@ -194,10 +227,10 @@ const _ = [
     }
   },
   defaultVariants: { layout: "simple" }
-}), E = i(({ layout: e, className: t, ...a }, n) => /* @__PURE__ */ s(
+}), E = n(({ layout: e, className: t, ...a }, i) => /* @__PURE__ */ s(
   o.Content,
   {
-    ref: n,
+    ref: i,
     className: W({ layout: e, className: t }),
     ...a
   }
@@ -218,13 +251,13 @@ const c = [
   "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid",
   "ds:focus-visible:outline-[var(--ring)] ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
   "ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none"
-].join(" "), F = i(({ asChild: e = !1, className: t, children: a, ...n }, l) => /* @__PURE__ */ s(
+].join(" "), F = n(({ asChild: e = !1, className: t, children: a, ...i }, l) => /* @__PURE__ */ s(
   o.Link,
   {
     ref: l,
     asChild: e,
     className: e ? void 0 : [c, t].filter(Boolean).join(" "),
-    ...n,
+    ...i,
     children: e ? /* @__PURE__ */ s(C, { className: [c, t].filter(Boolean).join(" "), children: a }) : a
   }
 ));
@@ -234,7 +267,7 @@ const G = [
   "ds:data-[state=visible]:animate-in ds:data-[state=hidden]:animate-out",
   "ds:data-[state=visible]:fade-in ds:data-[state=hidden]:fade-out",
   "ds:motion-reduce:animate-none"
-].join(" "), J = i(({ className: e, ...t }, a) => /* @__PURE__ */ s(
+].join(" "), J = n(({ className: e, ...t }, a) => /* @__PURE__ */ s(
   o.Indicator,
   {
     ref: a,
@@ -254,7 +287,7 @@ const Q = [
   "ds:data-[state=open]:animate-in ds:data-[state=closed]:animate-out",
   "ds:data-[state=open]:zoom-in-90 ds:data-[state=closed]:zoom-out-95",
   "ds:motion-reduce:animate-none"
-].join(" "), g = i(({ className: e, ...t }, a) => /* @__PURE__ */ s("div", { className: "ds:absolute ds:start-0 ds:top-full ds:flex ds:justify-center", children: /* @__PURE__ */ s(
+].join(" "), v = n(({ className: e, ...t }, a) => /* @__PURE__ */ s("div", { className: "ds:absolute ds:start-0 ds:top-full ds:flex ds:justify-center", children: /* @__PURE__ */ s(
   o.Viewport,
   {
     ref: a,
@@ -262,16 +295,16 @@ const Q = [
     ...t
   }
 ) }));
-g.displayName = "NavigationMenuViewport";
+v.displayName = "NavigationMenuViewport";
 export {
-  K as N,
+  O as N,
   E as a,
   J as b,
-  q as c,
+  K as c,
   F as d,
-  S as e,
+  A as e,
   P as f,
-  g,
-  T as n
+  v as g,
+  q as n
 };
-//# sourceMappingURL=navigation-menu-C6lBYVv9.js.map
+//# sourceMappingURL=navigation-menu-DRUi6sSj.js.map

package/dist/_chunks/{notification-card.agent-Rqt3ofk9.js → notification-card.agent-DxGBZb8T.js}

@@ -1,5 +1,9 @@
 const t = {
   id: "notification-card",
+  // `dismiss` is host-delegated: the card itself declares no imperative handle —
+  // the owning NotificationTray (or the consumer) performs the dismiss via its
+  // own handle. The capability is kept to document that a rendered card is
+  // addressable + dismissable through its host. See notification-tray.agent.ts.
   capabilities: ["dismiss"],
   state: {},
   actions: {},
@@ -19,4 +23,4 @@ const t = {
 export {
   t as n
 };
-//# sourceMappingURL=notification-card.agent-Rqt3ofk9.js.map
+//# sourceMappingURL=notification-card.agent-DxGBZb8T.js.map