@alfadocs/ui-kit 0.69.0 → 0.71.0

package/dist/_chunks/control-room-rail-FAQZrGVL.js

@@ -0,0 +1,333 @@
+import { jsx as g, jsxs as I, Fragment as ro } from "react/jsx-runtime";
+import { useState as z, useCallback as f, useMemo as C, useRef as N, useContext as j, useId as so, useEffect as lo, createContext as io, forwardRef as ao } from "react";
+import { useTranslation as co } from "react-i18next";
+import { I as X } from "./icon-button-LqoiKcUN.js";
+import { a as uo } from "./panel-header-D313n_9-.js";
+import { T as po } from "./tool-rail-BZx0-yIr.js";
+import { u as fo } from "./use-persistent-state-nZwZAnE9.js";
+import { S as mo } from "./star-vav0SJ9e.js";
+import { X as Ro } from "./x-CCcI3eJp.js";
+const go = {
+  id: "control-room-rail",
+  capabilities: ["open", "close", "select_single"],
+  state: {
+    activeToolId: {
+      type: "string | null",
+      descriptionKey: "ui.toolRail.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: (t) => t.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: "ui.toolRail.agent.actions.open",
+      description: "Open the given tool's panel.",
+      examples: [{ args: { id: "inbox" }, note: "Open the inbox tool panel." }],
+      invoke: (t, n) => {
+        t.open(n.id);
+      }
+    },
+    close: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.toolRail.agent.actions.close",
+      description: "Collapse the rail to its strip (no active tool).",
+      invoke: (t) => {
+        t.close();
+      }
+    },
+    select_tool: {
+      safety: "read",
+      argsType: "{ id: string | null }",
+      argsSchema: {
+        type: "object",
+        properties: { id: { type: ["string", "null"] } },
+        required: ["id"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.toolRail.agent.actions.selectTool",
+      description: "Set the active tool by id (opens its panel), or pass null to collapse.",
+      invoke: (t, n) => {
+        t.setActiveTool(n.id);
+      }
+    }
+  },
+  domHooks: {
+    root: {
+      attr: "data-component",
+      value: "control-room-rail",
+      description: "Marks the ControlRoomRail 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."
+    }
+  }
+}, S = io(null);
+function Mo({
+  globalTools: t = [],
+  children: n
+}) {
+  const [c, s] = z(
+    () => /* @__PURE__ */ new Map()
+  ), d = f(
+    (l, i) => {
+      s((h) => {
+        const k = new Map(h);
+        return k.set(l, i), k;
+      });
+    },
+    []
+  ), P = f((l) => {
+    s((i) => {
+      if (!i.has(l)) return i;
+      const h = new Map(i);
+      return h.delete(l), h;
+    });
+  }, []), v = C(
+    () => Array.from(c.values()).flat(),
+    [c]
+  ), x = N(null), p = f((l) => {
+    x.current = l;
+  }, []), b = f((l) => {
+    var i;
+    (i = x.current) == null || i.setActiveTool(l);
+  }, []), R = f(() => {
+    var l;
+    (l = x.current) == null || l.setActiveTool(null);
+  }, []), F = C(
+    () => ({
+      globalTools: t,
+      contextualTools: v,
+      registerContextualTools: d,
+      unregisterContextualTools: P,
+      registerRail: p,
+      openTool: b,
+      closeTool: R
+    }),
+    [
+      t,
+      v,
+      d,
+      P,
+      p,
+      b,
+      R
+    ]
+  );
+  return /* @__PURE__ */ g(S.Provider, { value: F, children: n });
+}
+function Vo(t) {
+  const n = j(S), c = n == null ? void 0 : n.registerContextualTools, s = n == null ? void 0 : n.unregisterContextualTools, d = so();
+  lo(() => {
+    if (!(!c || !s))
+      return c(d, t), () => s(d);
+  }, [c, s, d, t]);
+}
+function vo() {
+  const t = j(S);
+  return C(() => {
+    if (!t) return [];
+    const n = t.contextualTools.map((s) => ({
+      ...s,
+      scope: "contextual"
+    })), c = t.globalTools.map((s) => ({
+      ...s,
+      scope: "global"
+    }));
+    return [...n, ...c];
+  }, [t]);
+}
+function jo() {
+  const t = j(S), n = f(() => {
+  }, []);
+  return {
+    openTool: (t == null ? void 0 : t.openTool) ?? n,
+    closeTool: (t == null ? void 0 : t.closeTool) ?? n
+  };
+}
+function ho() {
+  const t = j(S), n = f((c) => {
+  }, []);
+  return (t == null ? void 0 : t.registerRail) ?? n;
+}
+const Fo = ao(function({
+  tools: n,
+  railLabel: c,
+  reorderable: s = !0,
+  favoriteIds: d,
+  defaultFavoriteIds: P,
+  onFavoriteIdsChange: v,
+  persistFavoritesKey: x = "ui.controlRoom.favorites",
+  activeToolId: p,
+  defaultActiveToolId: b = null,
+  onActiveToolChange: R,
+  ...F
+}, l) {
+  const { t: i } = co(), [h, k] = z(
+    p ?? b ?? null
+  ), _ = p !== void 0 ? p : h, $ = f(
+    (o) => {
+      p === void 0 && k(o), R == null || R(o);
+    },
+    [p, R]
+  ), D = vo(), T = n ?? D, H = d !== void 0, [G, J] = fo(
+    x,
+    () => P ?? T.filter((o) => o.scope === "global").map((o) => o.id),
+    { disabled: H }
+  ), A = H ? d : G, u = C(() => {
+    const o = /* @__PURE__ */ new Map();
+    for (const r of T) o.set(r.id, r);
+    return o;
+  }, [T]), w = C(
+    () => new Set(A.filter((o) => u.has(o))),
+    [A, u]
+  ), B = (o) => {
+    const r = o(A.filter((e) => u.has(e)));
+    H || J((e) => o(e.filter((a) => u.has(a)))), v == null || v(r);
+  }, L = C(() => {
+    if (!s) return T;
+    const o = A.filter((e) => u.has(e)).map((e) => ({
+      ...u.get(e),
+      scope: "global",
+      reorderable: !0
+    })), r = T.filter((e) => !w.has(e.id)).map((e) => ({
+      ...e,
+      scope: "contextual",
+      reorderable: !0
+    }));
+    return [...o, ...r];
+  }, [s, T, A, u, w]), [Q, U] = z(""), K = N(!1), W = (o, r) => {
+    const e = r ? i("controlRoom.pinnedAnnounce", {
+      tool: o,
+      defaultValue: "Pinned {{tool}} to favourites"
+    }) : i("controlRoom.unpinnedAnnounce", {
+      tool: o,
+      defaultValue: "Removed {{tool}} from favourites"
+    });
+    K.current = !K.current, U(K.current ? e : `${e}​`);
+  }, Y = (o) => {
+    var r;
+    W(((r = u.get(o)) == null ? void 0 : r.label) ?? o, !w.has(o)), B(
+      (e) => e.includes(o) ? e.filter((a) => a !== o) : [...e, o]
+    );
+  }, Z = (o, r) => {
+    var a;
+    const e = (a = L[o]) == null ? void 0 : a.id;
+    e !== void 0 && B((y) => {
+      const M = y.filter((m) => u.has(m)), V = M.length;
+      if (o < V) {
+        if (r >= V) return M.filter((no) => no !== e);
+        const m = M.slice();
+        return m.splice(o, 1), m.splice(r, 0, e), m;
+      }
+      if (r <= V) {
+        const m = M.slice();
+        return m.splice(Math.min(r, V), 0, e), m;
+      }
+      return y;
+    });
+  }, oo = ({
+    tool: o,
+    from: r,
+    to: e
+  }) => {
+    const a = w.size, y = r < a;
+    return y && e >= a ? i("controlRoom.unpinnedAnnounce", {
+      tool: o.label,
+      defaultValue: "Removed {{tool}} from favourites"
+    }) : !y && e <= a ? i("controlRoom.pinnedAnnounce", {
+      tool: o.label,
+      defaultValue: "Pinned {{tool}} to favourites"
+    }) : y && e < a ? i("controlRoom.reorderAnnounce", {
+      tool: o.label,
+      to: e + 1,
+      total: a,
+      defaultValue: "{{tool}} moved to position {{to}} of {{total}}"
+    }) : "";
+  }, O = N(null), E = ho(), to = f(
+    (o) => {
+      O.current = o, E(o), typeof l == "function" ? l(o) : l && (l.current = o);
+    },
+    [E, l]
+  ), q = _ != null ? u.get(_) ?? null : null, eo = q ? /* @__PURE__ */ I(ro, { children: [
+    s ? (() => {
+      const o = w.has(q.id);
+      return /* @__PURE__ */ g(
+        X,
+        {
+          icon: /* @__PURE__ */ g(
+            mo,
+            {
+              "aria-hidden": "true",
+              fill: o ? "currentColor" : "none",
+              className: o ? "ds:text-[color:var(--accent)]" : void 0
+            }
+          ),
+          intent: "ghost",
+          size: "sm",
+          "aria-pressed": o,
+          "aria-label": i("controlRoom.favorite", {
+            defaultValue: "Favourite"
+          }),
+          onClick: () => Y(q.id)
+        }
+      );
+    })() : null,
+    /* @__PURE__ */ g(
+      X,
+      {
+        icon: /* @__PURE__ */ g(Ro, { "aria-hidden": "true" }),
+        intent: "ghost",
+        size: "sm",
+        "aria-label": i("controlRoom.close", { defaultValue: "Close" }),
+        onClick: () => {
+          var o;
+          return (o = O.current) == null ? void 0 : o.close();
+        }
+      }
+    )
+  ] }) : null;
+  return /* @__PURE__ */ I(uo, { actions: eo, children: [
+    /* @__PURE__ */ g(
+      po,
+      {
+        ref: to,
+        dataComponent: "control-room-rail",
+        agentAdapter: go,
+        tools: L,
+        activeToolId: p,
+        defaultActiveToolId: b,
+        onActiveToolChange: $,
+        railLabel: c ?? i("controlRoom.railLabel", { defaultValue: "Control room" }),
+        onReorder: s ? Z : void 0,
+        formatReorderAnnouncement: s ? oo : void 0,
+        ...F
+      }
+    ),
+    s ? /* @__PURE__ */ g("span", { role: "status", "aria-live": "polite", className: "ds:sr-only", children: Q }) : null
+  ] });
+});
+export {
+  Mo as C,
+  Fo as a,
+  vo as b,
+  go as c,
+  Vo as d,
+  jo as u
+};
+//# sourceMappingURL=control-room-rail-FAQZrGVL.js.map