@alfadocs/ui-kit 0.68.0 → 0.70.0

package/dist/_chunks/ai-tools-rail-B5NEghsp.js

@@ -0,0 +1,511 @@
+import { jsxs as D, jsx as f } from "react/jsx-runtime";
+import { forwardRef as Ie, useRef as m, useState as E, useMemo as T, useId as xe, useCallback as U, useEffect as Te, useImperativeHandle as Re, Fragment as ke } from "react";
+import { c as w } from "./index-D2ZczOXr.js";
+import { useTranslation as Ae } from "react-i18next";
+import { I as _e } from "./icon-button-LqoiKcUN.js";
+import { S as ze } from "./scroll-area-5wNK0Cyz.js";
+import { a as De } from "./tooltip-DvmfrNvB.js";
+import { u as Ee } from "./use-controllable-state-BiY4xTzM.js";
+import { u as Se } from "./use-edge-resize-ZnGG7gyO.js";
+import { u as ae } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
+import { u as Ne } from "./registry-DvAUVLHh.js";
+const Ve = {
+  id: "ai-tools-rail",
+  capabilities: ["open", "close", "select_single"],
+  state: {
+    activeToolId: {
+      type: "string | null",
+      descriptionKey: "ui.aiToolsRail.agent.state.activeToolId",
+      description: "Id of the tool whose panel is currently open, or null when the rail is collapsed to its strip. No panel content is ever exposed.",
+      read: (o) => o.getActiveToolId()
+    }
+  },
+  actions: {
+    open: {
+      // Pure ephemeral panel state (open) — no data loss, no external effect.
+      safety: "read",
+      argsType: "{ id: string }",
+      argsSchema: {
+        type: "object",
+        properties: { id: { type: "string" } },
+        required: ["id"]
+      },
+      idempotent: !0,
+      // descriptionKey shape is intentionally pre-existing — already resolves to
+      // real multi-locale translations; do not canonicalise.
+      descriptionKey: "ui.aiToolsRail.agent.actions.open",
+      description: "Open the given tool's panel.",
+      examples: [{ args: { id: "inbox" }, note: "Open the inbox tool panel." }],
+      invoke: (o, a) => {
+        o.open(a.id);
+      }
+    },
+    close: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.aiToolsRail.agent.actions.close",
+      description: "Collapse the rail to its strip (no active tool).",
+      invoke: (o) => {
+        o.close();
+      }
+    },
+    select_tool: {
+      safety: "read",
+      argsType: "{ id: string | null }",
+      argsSchema: {
+        type: "object",
+        properties: { id: { type: ["string", "null"] } },
+        required: ["id"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.aiToolsRail.agent.actions.selectTool",
+      description: "Set the active tool by id (opens its panel), or pass null to collapse.",
+      invoke: (o, a) => {
+        o.setActiveTool(a.id);
+      }
+    }
+  },
+  domHooks: {
+    root: {
+      attr: "data-component",
+      value: "ai-tools-rail",
+      description: "Marks the AiToolsRail wrapper."
+    },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop. Required to address a specific rail from the agent."
+    },
+    item: {
+      attr: "data-tool-id",
+      description: "Stable tool id emitted on each strip IconButton. The active icon also carries data-active set to its id."
+    }
+  }
+}, Ce = "ds:[inline-size:3rem]", Le = "ds:[inline-size:var(--ai-tools-rail-panel-inline-size,22rem)]", te = "--ai-tools-rail-panel-inline-size", Ke = 288, je = 640, Pe = 352, Me = w(
+  ["ds:flex ds:shrink-0 ds:h-full", "ds:bg-[var(--background)]"].join(" "),
+  {
+    variants: {
+      side: {
+        // Strip docks inline-end; the panel mounts inline-start of it
+        // (flex-row, panel rendered first). Shadow faces the main area —
+        // no border against main (the rail stays line-free; the only seam
+        // is the strip↔panel divider on the open panel, see render).
+        // Accessible (AAA) theme swaps the soft chrome shadow for a solid 1px
+        // border on the content-facing edge (border-s for end-docked).
+        end: "ds:flex-row ds:shadow-[var(--shadow-chrome-start)] ds:[.theme-accessible_&]:border-s ds:[.theme-accessible_&]:border-[var(--border)] ds:[.theme-accessible_&]:shadow-none",
+        // Strip docks inline-start; the panel mounts inline-end of it.
+        start: "ds:flex-row-reverse ds:shadow-[var(--shadow-chrome-end)] ds:[.theme-accessible_&]:border-e ds:[.theme-accessible_&]:border-[var(--border)] ds:[.theme-accessible_&]:shadow-none"
+      }
+    },
+    defaultVariants: { side: "end" }
+  }
+), Be = w(
+  [
+    "ds:flex ds:shrink-0 ds:flex-col ds:items-center",
+    "ds:pt-[var(--spacing-md)] ds:pb-[var(--spacing-md)]",
+    "ds:gap-[var(--spacing-xs)]",
+    Ce
+  ].join(" ")
+), Ue = w(
+  [
+    "ds:relative ds:flex ds:min-h-0 ds:flex-col ds:h-full",
+    "ds:bg-[var(--background)]",
+    Le,
+    // Defensive: the panel doesn't animate its width today, but if a
+    // consumer adds a transition on the var, suppress it mid-drag.
+    "ds:data-[resizing]:transition-none"
+  ].join(" ")
+), qe = w(
+  [
+    "ds:absolute ds:[inset-block:0] ds:z-[1] ds:select-none ds:touch-none",
+    "ds:[inline-size:var(--resizable-handle-size)] ds:cursor-col-resize",
+    "ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none",
+    "ds:hover:bg-[var(--accent)] ds:focus-visible:bg-[var(--accent)] ds:data-[resizing]:bg-[var(--accent)]",
+    "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid",
+    "ds:focus-visible:outline-[color:var(--ring)] ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+    "ds:forced-colors:focus-visible:outline-[CanvasText]",
+    "ds:before:absolute ds:before:content-['']",
+    "ds:before:[block-size:100%]",
+    "ds:before:[inline-size:var(--min-target-size)]",
+    "ds:before:[inset-block:0]",
+    "ds:before:[inset-inline:calc(0px_-_(var(--min-target-size)_-_var(--resizable-handle-size))_/_2)]"
+  ],
+  {
+    variants: {
+      edge: {
+        "inline-start": "ds:start-0",
+        "inline-end": "ds:end-0"
+      }
+    },
+    defaultVariants: { edge: "inline-start" }
+  }
+), Fe = w(
+  [
+    "ds:absolute ds:-top-[var(--spacing-xs)] ds:-end-[var(--spacing-xs)]",
+    "ds:inline-flex ds:items-center ds:justify-center",
+    "ds:min-w-[calc(var(--spacing-md)+var(--spacing-xs))]",
+    "ds:h-[calc(var(--spacing-md)+var(--spacing-xs))]",
+    "ds:ps-[calc(var(--spacing-xs)/1.5)] ds:pe-[calc(var(--spacing-xs)/1.5)]",
+    "ds:rounded-[var(--radius-full)]",
+    "ds:bg-[color:var(--destructive)] ds:text-[color:var(--destructive-foreground)]",
+    "ds:text-[length:var(--font-size-xs)] ds:font-semibold ds:leading-none",
+    "ds:pointer-events-none ds:select-none",
+    "ds:forced-colors:outline ds:forced-colors:outline-1 ds:forced-colors:outline-[CanvasText]"
+  ].join(" ")
+), He = w(
+  // `group/rail-tool` lets an affordance overlay (e.g. a pin star) reveal on
+  // hover / focus-within of the whole slot.
+  ["ds:group/rail-tool ds:relative", "ds:rounded-[var(--radius-sm)]"],
+  {
+    variants: {
+      dragging: { true: "ds:opacity-60", false: "" },
+      dropTarget: {
+        true: "ds:outline-[length:var(--focus-ring-width)] ds:outline-dashed ds:outline-[var(--primary)] ds:outline-offset-[-2px]",
+        false: ""
+      },
+      reorderable: {
+        true: "ds:cursor-grab ds:active:cursor-grabbing",
+        false: ""
+      }
+    },
+    defaultVariants: {
+      dragging: !1,
+      dropTarget: !1,
+      reorderable: !1
+    }
+  }
+);
+function Oe(o, a) {
+  return o > 99 ? a : String(o);
+}
+const $e = Ie(
+  ({
+    id: o,
+    tools: a,
+    activeToolId: re,
+    defaultActiveToolId: ie = null,
+    onActiveToolChange: ne,
+    side: R = "end",
+    railLabel: oe,
+    resizablePanel: k = !1,
+    onReorder: A,
+    formatReorderAnnouncement: S,
+    renderToolAffordance: N,
+    renderPanelHeader: q,
+    className: le
+  }, de) => {
+    var Q;
+    const { t: p } = Ae(), [ce, v] = Ee({
+      value: re,
+      defaultValue: ie,
+      onChange: ne
+    }), g = ce ?? null, V = m([]), _ = m(null), [C, L] = E(0), h = m(!1), K = m(!1), b = T(
+      () => a.findIndex((e) => e.id === g),
+      [a, g]
+    ), l = b >= 0 ? a[b] : null, ue = T(
+      () => a.findIndex((e) => !e.disabled),
+      [a]
+    ), F = T(() => {
+      var s;
+      const e = (s = a[0]) == null ? void 0 : s.scope;
+      return e ? a.findIndex((t) => t.scope && t.scope !== e) : -1;
+    }, [a]), fe = F > 0, d = T(() => {
+      var t;
+      const e = a.findIndex((n) => n.reorderable);
+      if (e < 0) return null;
+      let s = e;
+      for (; s + 1 < a.length && ((t = a[s + 1]) != null && t.reorderable); ) s += 1;
+      return { first: e, last: s };
+    }, [a]), H = !!A && d !== null, pe = xe(), [I, j] = E(null), [O, z] = E(null), [ve, ge] = E(""), P = m(!1), $ = U(
+      (e, s) => {
+        if (!A || !d) return;
+        const t = Math.max(
+          d.first,
+          Math.min(d.last, s)
+        );
+        if (t === e) return;
+        A(e, t);
+        const n = a[e];
+        if (n) {
+          const i = S ? S({ tool: n, from: e, to: t }) : p("aiToolsRail.reorderAnnounce", {
+            tool: n.label,
+            to: t - d.first + 1,
+            total: d.last - d.first + 1,
+            defaultValue: "{{tool}} moved to position {{to}} of {{total}}"
+          });
+          i && (P.current = !P.current, ge(P.current ? i : `${i}​`));
+        }
+      },
+      [A, d, a, p, S]
+    ), x = b >= 0 ? b : C >= 0 && !((Q = a[C]) != null && Q.disabled) ? C : ue, be = U(
+      (e, s) => {
+        const t = a.find((n) => n.id === e);
+        !t || t.disabled || (h.current = s, v(g === e ? null : e));
+      },
+      [a, g, v]
+    ), me = U(
+      (e) => {
+        var y, r, u;
+        const s = a.length;
+        if (s === 0 || e.altKey) return;
+        let t = null;
+        if (e.key === "ArrowDown" ? t = (x + 1) % s : e.key === "ArrowUp" ? t = (x - 1 + s) % s : e.key === "Home" ? t = 0 : e.key === "End" && (t = s - 1), t === null) return;
+        const n = e.key === "ArrowUp" || e.key === "End";
+        let i = t, c = 0;
+        for (; c < s && ((y = a[i]) != null && y.disabled); )
+          i = n ? (i - 1 + s) % s : (i + 1) % s, c += 1;
+        (r = a[i]) != null && r.disabled || (e.preventDefault(), L(i), (u = V.current[i]) == null || u.focus());
+      },
+      [a, x]
+    ), M = m(null);
+    Te(() => {
+      const e = M.current;
+      if (!e) return;
+      const s = (t) => {
+        if (t.key !== "Escape" || b < 0) return;
+        t.preventDefault();
+        const n = b;
+        v(null), L(n), requestAnimationFrame(() => {
+          var i;
+          (i = V.current[n]) == null || i.focus();
+        });
+      };
+      return e.addEventListener("keydown", s), () => e.removeEventListener("keydown", s);
+    }, [b, v]), ae(() => {
+      var e;
+      l && h.current && ((e = _.current) == null || e.focus()), h.current = !1;
+    }, [l]);
+    const W = R === "end" ? "inline-start" : "inline-end", { separatorProps: Z, isResizing: X, isResized: Y } = Se({
+      edge: W,
+      targetRef: _,
+      cssProperty: te,
+      minSize: Ke,
+      maxSize: je,
+      defaultSize: Pe,
+      disabled: !k
+    }), G = Z["aria-valuenow"];
+    ae(() => {
+      var e;
+      !k || !Y || !l || (e = _.current) == null || e.style.setProperty(
+        te,
+        `${G}px`
+      );
+    }, [l, k, Y, G]);
+    const J = m(g);
+    J.current = g;
+    const B = T(
+      () => ({
+        getActiveToolId: () => J.current,
+        setActiveTool: (e) => {
+          h.current = !1, v(e);
+        },
+        open: (e) => {
+          const s = a.find((t) => t.id === e);
+          !s || s.disabled || (h.current = !1, v(e));
+        },
+        close: () => {
+          h.current = !1, v(null);
+        }
+      }),
+      [a, v]
+    );
+    Re(de, () => B, [B]), Ne(Ve, B, o);
+    const he = p("aiToolsRail.badgeCountOverflow", {
+      defaultValue: "99+"
+    });
+    return /* @__PURE__ */ D(
+      "div",
+      {
+        ref: M,
+        "data-component": "ai-tools-rail",
+        "data-component-id": o,
+        "data-side": R,
+        className: [Me({ side: R }), le].filter(Boolean).join(" "),
+        children: [
+          H ? /* @__PURE__ */ f("span", { role: "status", "aria-live": "polite", className: "ds:sr-only", children: ve }) : null,
+          l ? /* @__PURE__ */ D(
+            "aside",
+            {
+              ref: _,
+              tabIndex: -1,
+              "aria-label": p("aiToolsRail.panelLabel", {
+                tool: l.label,
+                defaultValue: "{{tool}} panel"
+              }),
+              "data-ai-tools-rail-state": "expanded",
+              "data-active-tool": l.id,
+              "data-resizing": X ? "" : void 0,
+              className: [
+                Ue(),
+                // Subtle shadow — not a line — separating the panel from the
+                // icon strip (the tab row). The panel casts a soft chrome
+                // shadow toward the strip on its strip-facing edge. `z-[1]`
+                // lifts it above the adjacent strip (the panel is already
+                // `relative`) so the shadow paints at the seam instead of being
+                // covered by the strip's opaque background. Only renders while
+                // the panel is open (the aside is unmounted when collapsed), so
+                // it never doubles as a rail↔main seam. In the accessible (AAA)
+                // theme the soft shadow becomes a solid 1px border on that same
+                // strip-facing edge.
+                "ds:z-[1]",
+                R === "end" ? "ds:shadow-[var(--shadow-chrome-end)] ds:[.theme-accessible_&]:border-e ds:[.theme-accessible_&]:border-[var(--border)] ds:[.theme-accessible_&]:shadow-none" : "ds:shadow-[var(--shadow-chrome-start)] ds:[.theme-accessible_&]:border-s ds:[.theme-accessible_&]:border-[var(--border)] ds:[.theme-accessible_&]:shadow-none",
+                "ds:focus-visible:outline-none"
+              ].join(" "),
+              children: [
+                q ? q(l, { isActive: !0 }) : null,
+                l.header ? /* @__PURE__ */ f("div", { className: "ds:shrink-0", children: l.header }) : null,
+                l.fill ? /* @__PURE__ */ f("div", { className: "ds:flex-1 ds:min-h-0", children: l.panel }) : /* @__PURE__ */ f(
+                  ze,
+                  {
+                    orientation: "vertical",
+                    className: "ds:flex-1 ds:min-h-0",
+                    children: l.panel
+                  }
+                ),
+                k ? /* @__PURE__ */ f(
+                  "div",
+                  {
+                    ...Z,
+                    "aria-label": p("aiToolsRail.resizePanel", {
+                      defaultValue: "Resize tool panel"
+                    }),
+                    "data-resizing": X ? "" : void 0,
+                    className: qe({ edge: W })
+                  }
+                ) : null
+              ]
+            }
+          ) : null,
+          /* @__PURE__ */ f(De, { children: /* @__PURE__ */ f(
+            "div",
+            {
+              role: "toolbar",
+              "aria-orientation": "vertical",
+              "aria-label": oe ?? p("aiToolsRail.railLabel", { defaultValue: "AI tools" }),
+              className: Be(),
+              onKeyDown: me,
+              children: a.map((e, s) => {
+                const t = e.id === g, n = typeof e.badgeCount == "number" && e.badgeCount > 0, i = n ? p("aiToolsRail.toolWithCount", {
+                  tool: e.label,
+                  count: e.badgeCount,
+                  defaultValue: "{{tool}}, {{count}} updates"
+                }) : e.label, c = H && !!e.reorderable && !e.disabled, y = c ? `${pe}-${e.id}` : void 0;
+                return /* @__PURE__ */ D(ke, { children: [
+                  fe && s === F ? /* @__PURE__ */ f(
+                    "div",
+                    {
+                      role: "separator",
+                      "aria-orientation": "horizontal",
+                      className: "ds:my-[var(--spacing-2xs)] ds:h-px ds:w-[var(--spacing-lg)] ds:shrink-0 ds:bg-[var(--border)]"
+                    }
+                  ) : null,
+                  /* @__PURE__ */ D(
+                    "div",
+                    {
+                      className: He({
+                        dragging: I === s,
+                        dropTarget: O === s && I !== s,
+                        reorderable: c
+                      }),
+                      "data-dragging": I === s ? "" : void 0,
+                      draggable: c || void 0,
+                      onDragStart: c ? (r) => {
+                        j(s), r.dataTransfer.effectAllowed = "move", r.dataTransfer.setData(
+                          "text/plain",
+                          String(s)
+                        );
+                      } : void 0,
+                      onDragOver: c ? (r) => {
+                        I !== null && (r.preventDefault(), r.dataTransfer.dropEffect = "move", O !== s && z(s));
+                      } : void 0,
+                      onDragLeave: c ? () => z((r) => r === s ? null : r) : void 0,
+                      onDrop: c ? (r) => {
+                        r.preventDefault();
+                        const u = I;
+                        z(null), j(null), !(u === null || u === s) && $(u, s);
+                      } : void 0,
+                      onDragEnd: c ? () => {
+                        j(null), z(null);
+                      } : void 0,
+                      children: [
+                        /* @__PURE__ */ f(
+                          _e,
+                          {
+                            ref: (r) => {
+                              V.current[s] = r;
+                            },
+                            icon: e.icon,
+                            tooltip: e.label,
+                            "aria-label": i,
+                            intent: "ghost",
+                            size: "sm",
+                            disabled: e.disabled,
+                            "aria-pressed": t,
+                            "aria-expanded": t,
+                            "data-active": t ? e.id : void 0,
+                            "data-tool-id": e.id,
+                            "aria-describedby": y,
+                            "aria-keyshortcuts": c ? "Alt+ArrowUp Alt+ArrowDown" : void 0,
+                            tabIndex: s === x ? 0 : -1,
+                            onFocus: () => {
+                              e.disabled || L(s);
+                            },
+                            onClick: () => be(e.id, K.current),
+                            onKeyDown: (r) => {
+                              if (r.key === "Enter" || r.key === " ") {
+                                K.current = !0;
+                                return;
+                              }
+                              if (c && r.altKey && d) {
+                                let u = null;
+                                if (r.key === "ArrowUp" ? u = s - 1 : r.key === "ArrowDown" ? u = s + 1 : r.key === "Home" ? u = d.first : r.key === "End" && (u = d.last), u !== null) {
+                                  r.preventDefault();
+                                  const ye = Math.max(
+                                    d.first,
+                                    Math.min(d.last, u)
+                                  ), we = e.id;
+                                  $(s, ye), requestAnimationFrame(() => {
+                                    var ee, se;
+                                    (se = (ee = M.current) == null ? void 0 : ee.querySelector(
+                                      `[data-tool-id="${CSS.escape(we)}"]`
+                                    )) == null || se.focus();
+                                  });
+                                }
+                              }
+                            },
+                            onKeyUp: (r) => {
+                              (r.key === "Enter" || r.key === " ") && (K.current = !1);
+                            }
+                          }
+                        ),
+                        n ? /* @__PURE__ */ f("span", { "aria-hidden": "true", className: Fe(), children: Oe(
+                          e.badgeCount,
+                          he
+                        ) }) : null,
+                        N == null ? void 0 : N(e, {
+                          index: s,
+                          isActive: t,
+                          isRovingTarget: s === x
+                        }),
+                        y ? /* @__PURE__ */ f("span", { id: y, className: "ds:sr-only", children: p("aiToolsRail.reorderInstructions", {
+                          tool: e.label,
+                          defaultValue: "Reorder {{tool}}. Press Alt + Up or Alt + Down to move."
+                        }) }) : null
+                      ]
+                    }
+                  )
+                ] }, e.id);
+              })
+            }
+          ) })
+        ]
+      }
+    );
+  }
+);
+$e.displayName = "AiToolsRail";
+export {
+  $e as A,
+  Ve as a
+};
+//# sourceMappingURL=ai-tools-rail-B5NEghsp.js.map