@alfadocs/ui-kit-debug 0.46.0 → 0.48.0

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

@@ -0,0 +1,280 @@
+import { jsxs as j, jsx as f } from "react/jsx-runtime";
+import { forwardRef as M, useRef as v, useState as O, useMemo as k, useCallback as D, useEffect as G, useImperativeHandle as J } from "react";
+import { c as b } from "./index-D2ZczOXr.js";
+import { useTranslation as Q } from "react-i18next";
+import { I as X } from "./icon-button-CKEOrN37.js";
+import { S as Y } from "./scroll-area-BWqCkEGz.js";
+import { a as Z } from "./tooltip-DvmfrNvB.js";
+import { u as $ } from "./use-controllable-state-BiY4xTzM.js";
+import { u as ee } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
+import { u as ae } from "./registry-nPAVE19X.js";
+const te = {
+  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: (n) => n.getActiveToolId()
+    }
+  },
+  actions: {
+    open: {
+      safety: "read",
+      argsType: "{ id: string }",
+      descriptionKey: "ui.aiToolsRail.agent.actions.open",
+      description: "Open the given tool's panel.",
+      invoke: (n, a) => {
+        n.open(a.id);
+      }
+    },
+    close: {
+      safety: "read",
+      descriptionKey: "ui.aiToolsRail.agent.actions.close",
+      description: "Collapse the rail to its strip (no active tool).",
+      invoke: (n) => {
+        n.close();
+      }
+    },
+    select_tool: {
+      safety: "read",
+      argsType: "{ id: string | null }",
+      descriptionKey: "ui.aiToolsRail.agent.actions.selectTool",
+      description: "Set the active tool by id (opens its panel), or pass null to collapse.",
+      invoke: (n, a) => {
+        n.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."
+    }
+  }
+}, se = "ds:[inline-size:3rem]", ne = "ds:[inline-size:22rem]", ie = b(
+  ["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.
+        end: "ds:flex-row ds:shadow-[var(--shadow-chrome-start)]",
+        // Strip docks inline-start; the panel mounts inline-end of it.
+        start: "ds:flex-row-reverse ds:shadow-[var(--shadow-chrome-end)]"
+      }
+    },
+    defaultVariants: { side: "end" }
+  }
+), oe = b(
+  [
+    "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)]",
+    se
+  ].join(" ")
+), re = b(
+  [
+    "ds:flex ds:min-h-0 ds:flex-col ds:h-full",
+    "ds:bg-[var(--background)]",
+    ne
+  ].join(" ")
+), le = b(
+  [
+    "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(" ")
+);
+function de(n, a) {
+  return n > 99 ? a : String(n);
+}
+const ce = M(
+  ({
+    id: n,
+    tools: a,
+    activeToolId: S,
+    defaultActiveToolId: L = null,
+    onActiveToolChange: B,
+    side: R = "end",
+    railLabel: H,
+    className: z
+  }, _) => {
+    var E;
+    const { t: m } = Q(), [F, l] = $({
+      value: S,
+      defaultValue: L,
+      onChange: B
+    }), d = F ?? null, h = v([]), I = v(null), [y, x] = O(0), u = v(!1), T = v(!1), c = k(
+      () => a.findIndex((e) => e.id === d),
+      [a, d]
+    ), p = c >= 0 ? a[c] : null, P = k(
+      () => a.findIndex((e) => !e.disabled),
+      [a]
+    ), g = c >= 0 ? c : y >= 0 && !((E = a[y]) != null && E.disabled) ? y : P, U = D(
+      (e, t) => {
+        const s = a.find((r) => r.id === e);
+        !s || s.disabled || (u.current = t, l(d === e ? null : e));
+      },
+      [a, d, l]
+    ), W = D(
+      (e) => {
+        var K, N, V;
+        const t = a.length;
+        if (t === 0) return;
+        let s = null;
+        if (e.key === "ArrowDown" ? s = (g + 1) % t : e.key === "ArrowUp" ? s = (g - 1 + t) % t : e.key === "Home" ? s = 0 : e.key === "End" && (s = t - 1), s === null) return;
+        const r = e.key === "ArrowUp" || e.key === "End";
+        let i = s, o = 0;
+        for (; o < t && ((K = a[i]) != null && K.disabled); )
+          i = r ? (i - 1 + t) % t : (i + 1) % t, o += 1;
+        (N = a[i]) != null && N.disabled || (e.preventDefault(), x(i), (V = h.current[i]) == null || V.focus());
+      },
+      [a, g]
+    ), A = v(null);
+    G(() => {
+      const e = A.current;
+      if (!e) return;
+      const t = (s) => {
+        if (s.key !== "Escape" || c < 0) return;
+        s.preventDefault();
+        const r = c;
+        l(null), x(r), requestAnimationFrame(() => {
+          var i;
+          (i = h.current[r]) == null || i.focus();
+        });
+      };
+      return e.addEventListener("keydown", t), () => e.removeEventListener("keydown", t);
+    }, [c, l]), ee(() => {
+      var e;
+      p && u.current && ((e = I.current) == null || e.focus()), u.current = !1;
+    }, [p]);
+    const C = v(d);
+    C.current = d;
+    const w = k(
+      () => ({
+        getActiveToolId: () => C.current,
+        setActiveTool: (e) => {
+          u.current = !1, l(e);
+        },
+        open: (e) => {
+          const t = a.find((s) => s.id === e);
+          !t || t.disabled || (u.current = !1, l(e));
+        },
+        close: () => {
+          u.current = !1, l(null);
+        }
+      }),
+      [a, l]
+    );
+    J(_, () => w, [w]), ae(te, w, n);
+    const q = m("aiToolsRail.badgeCountOverflow", {
+      defaultValue: "99+"
+    });
+    return /* @__PURE__ */ j(
+      "div",
+      {
+        ref: A,
+        "data-component": "ai-tools-rail",
+        "data-component-id": n,
+        "data-side": R,
+        className: [ie({ side: R }), z].filter(Boolean).join(" "),
+        children: [
+          p ? /* @__PURE__ */ f(
+            "aside",
+            {
+              ref: I,
+              tabIndex: -1,
+              "aria-label": m("aiToolsRail.panelLabel", {
+                tool: p.label,
+                defaultValue: "{{tool}} panel"
+              }),
+              "data-ai-tools-rail-state": "expanded",
+              "data-active-tool": p.id,
+              className: [re(), "ds:focus-visible:outline-none"].join(
+                " "
+              ),
+              children: /* @__PURE__ */ f(Y, { orientation: "vertical", className: "ds:flex-1 ds:min-h-0", children: p.panel })
+            }
+          ) : null,
+          /* @__PURE__ */ f(Z, { children: /* @__PURE__ */ f(
+            "div",
+            {
+              role: "toolbar",
+              "aria-orientation": "vertical",
+              "aria-label": H ?? m("aiToolsRail.railLabel", { defaultValue: "AI tools" }),
+              className: oe(),
+              onKeyDown: W,
+              children: a.map((e, t) => {
+                const s = e.id === d, r = typeof e.badgeCount == "number" && e.badgeCount > 0, i = r ? m("aiToolsRail.toolWithCount", {
+                  tool: e.label,
+                  count: e.badgeCount,
+                  defaultValue: "{{tool}}, {{count}} updates"
+                }) : e.label;
+                return /* @__PURE__ */ j("div", { className: "ds:relative", children: [
+                  /* @__PURE__ */ f(
+                    X,
+                    {
+                      ref: (o) => {
+                        h.current[t] = o;
+                      },
+                      icon: e.icon,
+                      tooltip: e.label,
+                      "aria-label": i,
+                      intent: "ghost",
+                      size: "sm",
+                      disabled: e.disabled,
+                      "aria-pressed": s,
+                      "aria-expanded": s,
+                      "data-active": s ? e.id : void 0,
+                      "data-tool-id": e.id,
+                      tabIndex: t === g ? 0 : -1,
+                      onFocus: () => {
+                        e.disabled || x(t);
+                      },
+                      onClick: () => U(e.id, T.current),
+                      onKeyDown: (o) => {
+                        (o.key === "Enter" || o.key === " ") && (T.current = !0);
+                      },
+                      onKeyUp: (o) => {
+                        (o.key === "Enter" || o.key === " ") && (T.current = !1);
+                      }
+                    }
+                  ),
+                  r ? /* @__PURE__ */ f("span", { "aria-hidden": "true", className: le(), children: de(
+                    e.badgeCount,
+                    q
+                  ) }) : null
+                ] }, e.id);
+              })
+            }
+          ) })
+        ]
+      }
+    );
+  }
+);
+ce.displayName = "AiToolsRail";
+export {
+  ce as A,
+  te as a
+};
+//# sourceMappingURL=ai-tools-rail-CxYG04cw.js.map

package/dist/_chunks/ai-tools-rail-CxYG04cw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools-rail-CxYG04cw.js","sources":["../../src/components/ai-tools-rail/ai-tools-rail.agent.ts","../../src/components/ai-tools-rail/ai-tools-rail.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — AiToolsRail.                                           */\n/*                                                                        */\n/* Rail-level surface: open / close a tool's panel and read which tool    */\n/* is active. State is strictly the active tool id — never any tool's     */\n/* panel CONTENT (which may carry PHI). Tool ids + badge counts are       */\n/* supplied by the host via props, not derived from panel bodies.        */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { AiToolsRailHandle } from './ai-tools-rail';\n\nexport const aiToolsRailAgent: AgentAdapter<AiToolsRailHandle> = {\n  id: 'ai-tools-rail',\n  capabilities: ['open', 'close', 'select_single'],\n  state: {\n    activeToolId: {\n      type: 'string | null',\n      descriptionKey: 'ui.aiToolsRail.agent.state.activeToolId',\n      description:\n        '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.',\n      read: (handle) => handle.getActiveToolId(),\n    },\n  },\n  actions: {\n    open: {\n      safety: 'read',\n      argsType: '{ id: string }',\n      descriptionKey: 'ui.aiToolsRail.agent.actions.open',\n      description: \"Open the given tool's panel.\",\n      invoke: (handle, args: { id: string }) => {\n        handle.open(args.id);\n      },\n    },\n    close: {\n      safety: 'read',\n      descriptionKey: 'ui.aiToolsRail.agent.actions.close',\n      description: 'Collapse the rail to its strip (no active tool).',\n      invoke: (handle) => {\n        handle.close();\n      },\n    },\n    select_tool: {\n      safety: 'read',\n      argsType: '{ id: string | null }',\n      descriptionKey: 'ui.aiToolsRail.agent.actions.selectTool',\n      description:\n        'Set the active tool by id (opens its panel), or pass null to collapse.',\n      invoke: (handle, args: { id: string | null }) => {\n        handle.setActiveTool(args.id);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'ai-tools-rail',\n      description: 'Marks the AiToolsRail wrapper.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description:\n        'Sourced from the id prop. Required to address a specific rail from the agent.',\n    },\n    item: {\n      attr: 'data-tool-id',\n      description:\n        'Stable tool id emitted on each strip IconButton. The active icon also carries data-active set to its id.',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  type KeyboardEvent as ReactKeyboardEvent,\n  type ReactNode,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { IconButton } from '../button/icon-button';\nimport { ScrollArea } from '../scroll-area/scroll-area';\nimport { TooltipProvider } from '../tooltip/tooltip';\nimport { useControllableState } from '../../hooks/use-controllable-state';\nimport { useIsomorphicLayoutEffect } from '../../hooks/use-isomorphic-layout-effect';\nimport { useAgentRegistration } from '../../agent/registry';\nimport { aiToolsRailAgent } from './ai-tools-rail.agent';\n\n/* ------------------------------------------------------------------ */\n/* Tokenised widths                                                    */\n/*                                                                    */\n/* Fixed + tokenised so the rail stays constraint-compliant — no       */\n/* prop-driven inline styles. Bare `[inline-size:…]` is NOT a          */\n/* recognised utility under the `ds:` prefix; it must carry the        */\n/* prefix or Tailwind emits no rule. Consumers needing a different     */\n/* size wrap the rail and override via CSS.                            */\n/* ------------------------------------------------------------------ */\nconst RAIL_WIDTH = 'ds:[inline-size:3rem]';\nconst PANEL_WIDTH = 'ds:[inline-size:22rem]';\n\n/* ------------------------------------------------------------------ */\n/* Public types                                                        */\n/* ------------------------------------------------------------------ */\n\nexport interface AiToolsRailTool {\n  /** Stable tool id — used in `data-active`, the imperative handle, and\n   *  to label the open panel region. */\n  id: string;\n  /** Accessible name for the strip icon + tooltip, and the open panel's\n   *  region label. Never rendered as visible body text. */\n  label: string;\n  /** lucide-react glyph (rendered `aria-hidden` inside the IconButton). */\n  icon: ReactNode;\n  /** Panel body for this tool. Rendered inline-start of the strip when\n   *  `side='end'` (mirrored for `'start'`). The consumer composes it. */\n  panel: ReactNode;\n  /** Optional unseen / notification count shown on the strip icon. */\n  badgeCount?: number;\n  /** When true the icon is non-interactive and skipped by roving focus. */\n  disabled?: boolean;\n}\n\n/**\n * Curated imperative handle for AiToolsRail. Exposed as the forwardRef\n * target so a future agent / MCP UI bridge can drive the rail without\n * touching the DOM. See `ai-tools-rail.agent.ts`.\n *\n * State surfaced here is strictly identifiers + counts — never any\n * tool's panel content (which may carry PHI).\n */\nexport interface AiToolsRailHandle {\n  /** Currently-active tool id, or null when collapsed to strip-only. */\n  getActiveToolId: () => string | null;\n  /** Activate a tool by id (opens its panel), or null to collapse. */\n  setActiveTool: (id: string | null) => void;\n  /** Activate a tool by id (opens its panel). */\n  open: (id: string) => void;\n  /** Collapse to strip-only (no active tool). */\n  close: () => void;\n}\n\n/* ------------------------------------------------------------------ */\n/* CVA — `side` drives the dock edge + which shadow faces main content */\n/* ------------------------------------------------------------------ */\n\nconst railVariants = cva(\n  ['ds:flex ds:shrink-0 ds:h-full', 'ds:bg-[var(--background)]'].join(' '),\n  {\n    variants: {\n      side: {\n        // Strip docks inline-end; the panel mounts inline-start of it\n        // (flex-row, panel rendered first). Shadow faces the main area.\n        end: 'ds:flex-row ds:shadow-[var(--shadow-chrome-start)]',\n        // Strip docks inline-start; the panel mounts inline-end of it.\n        start: 'ds:flex-row-reverse ds:shadow-[var(--shadow-chrome-end)]',\n      },\n    },\n    defaultVariants: { side: 'end' },\n  },\n);\n\nconst stripVariants = cva(\n  [\n    'ds:flex ds:shrink-0 ds:flex-col ds:items-center',\n    'ds:pt-[var(--spacing-md)] ds:pb-[var(--spacing-md)]',\n    'ds:gap-[var(--spacing-xs)]',\n    RAIL_WIDTH,\n  ].join(' '),\n);\n\nconst panelVariants = cva(\n  [\n    'ds:flex ds:min-h-0 ds:flex-col ds:h-full',\n    'ds:bg-[var(--background)]',\n    PANEL_WIDTH,\n  ].join(' '),\n);\n\n// Hand-rolled overlay count chip — mirrors the AliaSidebar / MessageTray\n// badge markup. A <Badge> would re-introduce its own landmark/role; the\n// strip icon already carries the count in its accessible name, so this\n// span is purely decorative (`aria-hidden`).\nconst badgeVariants = cva(\n  [\n    'ds:absolute ds:-top-[var(--spacing-xs)] ds:-end-[var(--spacing-xs)]',\n    'ds:inline-flex ds:items-center ds:justify-center',\n    'ds:min-w-[calc(var(--spacing-md)+var(--spacing-xs))]',\n    'ds:h-[calc(var(--spacing-md)+var(--spacing-xs))]',\n    'ds:ps-[calc(var(--spacing-xs)/1.5)] ds:pe-[calc(var(--spacing-xs)/1.5)]',\n    'ds:rounded-[var(--radius-full)]',\n    'ds:bg-[color:var(--destructive)] ds:text-[color:var(--destructive-foreground)]',\n    'ds:text-[length:var(--font-size-xs)] ds:font-semibold ds:leading-none',\n    'ds:pointer-events-none ds:select-none',\n    'ds:forced-colors:outline ds:forced-colors:outline-1 ds:forced-colors:outline-[CanvasText]',\n  ].join(' '),\n);\n\n/* ------------------------------------------------------------------ */\n/* Props                                                               */\n/* ------------------------------------------------------------------ */\n\nexport interface AiToolsRailProps extends VariantProps<typeof railVariants> {\n  /** Stable instance id, surfaced on the root as `data-component-id`. */\n  id?: string;\n  /** The tools shown as icons on the strip. */\n  tools: AiToolsRailTool[];\n  /** Controlled active tool id (null = collapsed / strip-only). */\n  activeToolId?: string | null;\n  /** Uncontrolled initial active tool id (default null). */\n  defaultActiveToolId?: string | null;\n  /** Fires whenever the active tool changes (incl. → null on collapse). */\n  onActiveToolChange?: (id: string | null) => void;\n  /** Which edge the rail docks to. Default `'end'` (inline-end). */\n  side?: 'start' | 'end';\n  /** Accessible label for the toolbar strip. */\n  railLabel?: string;\n  className?: string;\n}\n\n/* ------------------------------------------------------------------ */\n/* Helpers                                                             */\n/* ------------------------------------------------------------------ */\n\nfunction formatBadgeCount(count: number, overflowLabel: string): string {\n  return count > 99 ? overflowLabel : String(count);\n}\n\n/* ------------------------------------------------------------------ */\n/* Root                                                                */\n/* ------------------------------------------------------------------ */\n\nexport const AiToolsRail = forwardRef<AiToolsRailHandle, AiToolsRailProps>(\n  (\n    {\n      id,\n      tools,\n      activeToolId,\n      defaultActiveToolId = null,\n      onActiveToolChange,\n      side = 'end',\n      railLabel,\n      className,\n    },\n    ref,\n  ) => {\n    const { t } = useTranslation();\n\n    // Controlled / uncontrolled bridge — the same hook MessageTray uses.\n    const [activeRaw, setActiveRaw] = useControllableState<string | null>({\n      value: activeToolId,\n      defaultValue: defaultActiveToolId,\n      onChange: onActiveToolChange,\n    });\n    const activeId = activeRaw ?? null;\n\n    // Roving-tabindex bookkeeping for the vertical toolbar strip.\n    const buttonsRef = useRef<Array<HTMLButtonElement | null>>([]);\n    const panelRef = useRef<HTMLElement | null>(null);\n    const [focusIndex, setFocusIndex] = useState(0);\n    // Distinguishes keyboard activation (auto-focus into the panel) from\n    // pointer activation (focus stays on the icon — less jarring).\n    const activatedByKeyboardRef = useRef(false);\n    // Set on Enter/Space keydown, read by the click handler that follows,\n    // cleared on keyup — so a subsequent mouse click never inherits it.\n    const keyboardActivateRef = useRef(false);\n\n    const activeIndex = useMemo(\n      () => tools.findIndex((tl) => tl.id === activeId),\n      [tools, activeId],\n    );\n    const activeTool = activeIndex >= 0 ? tools[activeIndex] : null;\n\n    // First non-disabled index — the resting roving stop when none active.\n    const firstEnabledIndex = useMemo(\n      () => tools.findIndex((tl) => !tl.disabled),\n      [tools],\n    );\n\n    // The roving tab stop: the active icon when a tool is open, else the\n    // index the user last focused, else the first enabled icon.\n    const rovingIndex =\n      activeIndex >= 0\n        ? activeIndex\n        : focusIndex >= 0 && !tools[focusIndex]?.disabled\n          ? focusIndex\n          : firstEnabledIndex;\n\n    const selectTool = useCallback(\n      (toolId: string, fromKeyboard: boolean) => {\n        const tool = tools.find((tl) => tl.id === toolId);\n        if (!tool || tool.disabled) return;\n        activatedByKeyboardRef.current = fromKeyboard;\n        // Clicking / activating the active tool collapses to strip-only.\n        setActiveRaw(activeId === toolId ? null : toolId);\n      },\n      [tools, activeId, setActiveRaw],\n    );\n\n    /* ---- Roving arrow-key navigation (vertical toolbar) ----------- */\n    const handleStripKeyDown = useCallback(\n      (event: ReactKeyboardEvent<HTMLDivElement>) => {\n        const count = tools.length;\n        if (count === 0) return;\n\n        let next: number | null = null;\n        if (event.key === 'ArrowDown') next = (rovingIndex + 1) % count;\n        else if (event.key === 'ArrowUp')\n          next = (rovingIndex - 1 + count) % count;\n        else if (event.key === 'Home') next = 0;\n        else if (event.key === 'End') next = count - 1;\n        if (next === null) return;\n\n        // Skip disabled icons in the travel direction.\n        const goingBack = event.key === 'ArrowUp' || event.key === 'End';\n        let candidate = next;\n        let attempts = 0;\n        while (attempts < count && tools[candidate]?.disabled) {\n          candidate = goingBack\n            ? (candidate - 1 + count) % count\n            : (candidate + 1) % count;\n          attempts += 1;\n        }\n        if (tools[candidate]?.disabled) return;\n\n        event.preventDefault();\n        setFocusIndex(candidate);\n        buttonsRef.current[candidate]?.focus();\n      },\n      [tools, rovingIndex],\n    );\n\n    /* ---- Esc collapses + returns focus to the active tool's icon -- */\n    // Attached imperatively via the root ref (not a JSX onKeyDown on the\n    // static container) so the Escape shortcut works from anywhere inside the\n    // open panel without an interaction handler on a non-interactive element.\n    const rootRef = useRef<HTMLDivElement>(null);\n    useEffect(() => {\n      const node = rootRef.current;\n      if (!node) return undefined;\n      const onKeyDown = (event: KeyboardEvent) => {\n        if (event.key !== 'Escape') return;\n        if (activeIndex < 0) return;\n        event.preventDefault();\n        const returnIndex = activeIndex;\n        setActiveRaw(null);\n        setFocusIndex(returnIndex);\n        // Defer until after the panel unmounts so focus lands cleanly.\n        requestAnimationFrame(() => {\n          buttonsRef.current[returnIndex]?.focus();\n        });\n      };\n      node.addEventListener('keydown', onKeyDown);\n      return () => node.removeEventListener('keydown', onKeyDown);\n    }, [activeIndex, setActiveRaw]);\n\n    /* ---- Move focus into the panel when opened by keyboard -------- */\n    useIsomorphicLayoutEffect(() => {\n      if (activeTool && activatedByKeyboardRef.current) {\n        panelRef.current?.focus();\n      }\n      activatedByKeyboardRef.current = false;\n    }, [activeTool]);\n\n    /* ---- Curated imperative handle for agent integration ---------- */\n    const activeIdRef = useRef<string | null>(activeId);\n    activeIdRef.current = activeId;\n\n    const handle = useMemo<AiToolsRailHandle>(\n      () => ({\n        getActiveToolId: () => activeIdRef.current,\n        setActiveTool: (toolId) => {\n          activatedByKeyboardRef.current = false;\n          setActiveRaw(toolId);\n        },\n        open: (toolId) => {\n          const tool = tools.find((tl) => tl.id === toolId);\n          if (!tool || tool.disabled) return;\n          activatedByKeyboardRef.current = false;\n          setActiveRaw(toolId);\n        },\n        close: () => {\n          activatedByKeyboardRef.current = false;\n          setActiveRaw(null);\n        },\n      }),\n      [tools, setActiveRaw],\n    );\n\n    useImperativeHandle(ref, () => handle, [handle]);\n    useAgentRegistration(aiToolsRailAgent, handle, id);\n\n    const overflowLabel = t('aiToolsRail.badgeCountOverflow', {\n      defaultValue: '99+',\n    });\n\n    return (\n      <div\n        ref={rootRef}\n        data-component=\"ai-tools-rail\"\n        data-component-id={id}\n        data-side={side}\n        className={[railVariants({ side }), className]\n          .filter(Boolean)\n          .join(' ')}\n      >\n        {/* The OPEN panel is the single complementary landmark, named by\n            the active tool. Rendered only while a tool is active so two\n            unnamed regions never coexist. */}\n        {activeTool ? (\n          <aside\n            ref={panelRef}\n            tabIndex={-1}\n            aria-label={t('aiToolsRail.panelLabel', {\n              tool: activeTool.label,\n              defaultValue: '{{tool}} panel',\n            })}\n            data-ai-tools-rail-state=\"expanded\"\n            data-active-tool={activeTool.id}\n            className={[panelVariants(), 'ds:focus-visible:outline-none'].join(\n              ' ',\n            )}\n          >\n            <ScrollArea orientation=\"vertical\" className=\"ds:flex-1 ds:min-h-0\">\n              {activeTool.panel}\n            </ScrollArea>\n          </aside>\n        ) : null}\n\n        {/* The 3rem icon strip — a vertical toolbar with roving tabindex.\n            Self-contained TooltipProvider so consumers needn't mount one;\n            Radix providers compose, so a host-level provider still works. */}\n        <TooltipProvider>\n          <div\n            role=\"toolbar\"\n            aria-orientation=\"vertical\"\n            aria-label={\n              railLabel ??\n              t('aiToolsRail.railLabel', { defaultValue: 'AI tools' })\n            }\n            className={stripVariants()}\n            onKeyDown={handleStripKeyDown}\n          >\n            {tools.map((tool, index) => {\n              const isActive = tool.id === activeId;\n              const showBadge =\n                typeof tool.badgeCount === 'number' && tool.badgeCount > 0;\n              // Fold the count into the accessible name so SR users hear it\n              // without relying on the decorative chip.\n              const accessibleName = showBadge\n                ? t('aiToolsRail.toolWithCount', {\n                    tool: tool.label,\n                    count: tool.badgeCount,\n                    defaultValue: '{{tool}}, {{count}} updates',\n                  })\n                : tool.label;\n              return (\n                <div key={tool.id} className=\"ds:relative\">\n                  <IconButton\n                    ref={(el) => {\n                      buttonsRef.current[index] = el;\n                    }}\n                    icon={tool.icon}\n                    tooltip={tool.label}\n                    aria-label={accessibleName}\n                    intent=\"ghost\"\n                    size=\"sm\"\n                    disabled={tool.disabled}\n                    aria-pressed={isActive}\n                    aria-expanded={isActive}\n                    data-active={isActive ? tool.id : undefined}\n                    data-tool-id={tool.id}\n                    tabIndex={index === rovingIndex ? 0 : -1}\n                    onFocus={() => {\n                      if (!tool.disabled) setFocusIndex(index);\n                    }}\n                    onClick={() =>\n                      selectTool(tool.id, keyboardActivateRef.current)\n                    }\n                    onKeyDown={(event) => {\n                      // Enter/Space activate via the native button's click,\n                      // which fires AFTER this keydown. Flag the upcoming\n                      // click as keyboard-driven so focus moves into the\n                      // panel; reset on keyup so a later mouse click doesn't\n                      // inherit the flag.\n                      if (event.key === 'Enter' || event.key === ' ') {\n                        keyboardActivateRef.current = true;\n                      }\n                    }}\n                    onKeyUp={(event) => {\n                      if (event.key === 'Enter' || event.key === ' ') {\n                        keyboardActivateRef.current = false;\n                      }\n                    }}\n                  />\n                  {showBadge ? (\n                    <span aria-hidden=\"true\" className={badgeVariants()}>\n                      {formatBadgeCount(\n                        tool.badgeCount as number,\n                        overflowLabel,\n                      )}\n                    </span>\n                  ) : null}\n                </div>\n              );\n            })}\n          </div>\n        </TooltipProvider>\n      </div>\n    );\n  },\n);\n\nAiToolsRail.displayName = 'AiToolsRail';\n"],"names":["aiToolsRailAgent","handle","args","RAIL_WIDTH","PANEL_WIDTH","railVariants","cva","stripVariants","panelVariants","badgeVariants","formatBadgeCount","count","overflowLabel","AiToolsRail","forwardRef","id","tools","activeToolId","defaultActiveToolId","onActiveToolChange","side","railLabel","className","ref","t","useTranslation","activeRaw","setActiveRaw","useControllableState","activeId","buttonsRef","useRef","panelRef","focusIndex","setFocusIndex","useState","activatedByKeyboardRef","keyboardActivateRef","activeIndex","useMemo","tl","activeTool","firstEnabledIndex","rovingIndex","_a","selectTool","useCallback","toolId","fromKeyboard","tool","handleStripKeyDown","event","next","goingBack","candidate","attempts","_b","_c","rootRef","useEffect","node","onKeyDown","returnIndex","useIsomorphicLayoutEffect","activeIdRef","useImperativeHandle","useAgentRegistration","jsxs","jsx","ScrollArea","TooltipProvider","index","isActive","showBadge","accessibleName","IconButton","el"],"mappings":"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"}