@alfadocs/ui-kit 1.42.0 → 1.44.0

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

@@ -0,0 +1,354 @@
+import { jsx as T, jsxs as U, Fragment as go } from "react/jsx-runtime";
+import { useState as E, useCallback as p, useMemo as b, useRef as X, useContext as N, useId as vo, useEffect as ho, createContext as To, forwardRef as bo } from "react";
+import { useTranslation as Co } from "react-i18next";
+import { I as Y } from "./icon-button-CehAeZoP.js";
+import { a as xo } from "./panel-header-D_mTdhUp.js";
+import { T as yo } from "./tool-rail-CCFqDfAn.js";
+import { u as Z } from "./use-persistent-state-nZwZAnE9.js";
+import { S as Ao } from "./star-Bf9L2Uot.js";
+import { X as So } from "./x-B5YnXwCz.js";
+const wo = {
+  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."
+    }
+  }
+}, M = To(null);
+function Oo({
+  globalTools: t = [],
+  children: n
+}) {
+  const [c, s] = E(
+    () => /* @__PURE__ */ new Map()
+  ), f = p(
+    (l, i) => {
+      s((u) => {
+        const j = new Map(u);
+        return j.set(l, i), j;
+      });
+    },
+    []
+  ), V = p((l) => {
+    s((i) => {
+      if (!i.has(l)) return i;
+      const u = new Map(i);
+      return u.delete(l), u;
+    });
+  }, []), m = b(
+    () => Array.from(c.values()).flat(),
+    [c]
+  ), h = X(null), P = p((l) => {
+    h.current = l;
+  }, []), R = p((l) => {
+    var i;
+    (i = h.current) == null || i.setActiveTool(l);
+  }, []), A = p(() => {
+    var l;
+    (l = h.current) == null || l.setActiveTool(null);
+  }, []), C = b(
+    () => ({
+      globalTools: t,
+      contextualTools: m,
+      registerContextualTools: f,
+      unregisterContextualTools: V,
+      registerRail: P,
+      openTool: R,
+      closeTool: A
+    }),
+    [
+      t,
+      m,
+      f,
+      V,
+      P,
+      R,
+      A
+    ]
+  );
+  return /* @__PURE__ */ T(M.Provider, { value: C, children: n });
+}
+function Eo(t) {
+  const n = N(M), c = n == null ? void 0 : n.registerContextualTools, s = n == null ? void 0 : n.unregisterContextualTools, f = vo();
+  ho(() => {
+    if (!(!c || !s))
+      return c(f, t), () => s(f);
+  }, [c, s, f, t]);
+}
+function ko() {
+  const t = N(M);
+  return b(() => {
+    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 Xo() {
+  const t = N(M), n = p(() => {
+  }, []);
+  return {
+    openTool: (t == null ? void 0 : t.openTool) ?? n,
+    closeTool: (t == null ? void 0 : t.closeTool) ?? n
+  };
+}
+function Mo() {
+  const t = N(M), n = p((c) => {
+  }, []);
+  return (t == null ? void 0 : t.registerRail) ?? n;
+}
+const $o = bo(function({
+  tools: n,
+  railLabel: c,
+  reorderable: s = !0,
+  favoriteIds: f,
+  defaultFavoriteIds: V,
+  pinnedFavoriteIds: m,
+  onFavoriteIdsChange: h,
+  persistFavoritesKey: P = "ui.controlRoom.favorites",
+  activeToolId: R,
+  defaultActiveToolId: A = null,
+  onActiveToolChange: C,
+  panelWidth: l,
+  onPanelWidthChange: i,
+  persistPanelWidthKey: u,
+  ...j
+}, S) {
+  const { t: g } = Co(), [F, W] = E(
+    R ?? A ?? null
+  ), $ = R !== void 0 ? R : F, I = p(
+    (o) => {
+      R === void 0 && W(o), C == null || C(o);
+    },
+    [R, C]
+  ), oo = ko(), x = n ?? oo, _ = f !== void 0, [to, eo] = Z(
+    P,
+    () => V ?? x.filter((o) => o.scope === "global").map((o) => o.id),
+    { disabled: _ }
+  ), B = _ ? f : to, w = b(() => m != null && m.length ? [
+    ...m,
+    ...B.filter((o) => !m.includes(o))
+  ] : B, [m, B]), H = l !== void 0, [no, D] = Z(u ?? "ui.controlRoom.panelWidth.unused", null, {
+    disabled: H || !u
+  }), ro = H ? l : u ? no : void 0, so = p(
+    (o) => {
+      !H && u && D(o), i == null || i(o);
+    },
+    [
+      H,
+      u,
+      D,
+      i
+    ]
+  ), d = b(() => {
+    const o = /* @__PURE__ */ new Map();
+    for (const r of x) o.set(r.id, r);
+    return o;
+  }, [x]), k = b(
+    () => new Set(w.filter((o) => d.has(o))),
+    [w, d]
+  ), G = (o) => {
+    const r = o(w.filter((e) => d.has(e)));
+    _ || eo((e) => o(e.filter((a) => d.has(a)))), h == null || h(r);
+  }, J = b(() => {
+    if (!s) return x;
+    const o = w.filter((e) => d.has(e)).map((e) => ({
+      ...d.get(e),
+      scope: "global",
+      reorderable: !0
+    })), r = x.filter((e) => !k.has(e.id)).map((e) => ({
+      ...e,
+      scope: "contextual",
+      reorderable: !0
+    }));
+    return [...o, ...r];
+  }, [s, x, w, d, k]), [lo, io] = E(""), L = X(!1), ao = (o, r) => {
+    const e = r ? g("controlRoom.pinnedAnnounce", {
+      tool: o,
+      defaultValue: "Pinned {{tool}} to favourites"
+    }) : g("controlRoom.unpinnedAnnounce", {
+      tool: o,
+      defaultValue: "Removed {{tool}} from favourites"
+    });
+    L.current = !L.current, io(L.current ? e : `${e}​`);
+  }, co = (o) => {
+    var r;
+    ao(((r = d.get(o)) == null ? void 0 : r.label) ?? o, !k.has(o)), G(
+      (e) => e.includes(o) ? e.filter((a) => a !== o) : [...e, o]
+    );
+  }, uo = (o, r) => {
+    var a;
+    const e = (a = J[o]) == null ? void 0 : a.id;
+    e !== void 0 && G((y) => {
+      const q = y.filter((v) => d.has(v)), z = q.length;
+      if (o < z) {
+        if (r >= z) return q.filter((Ro) => Ro !== e);
+        const v = q.slice();
+        return v.splice(o, 1), v.splice(r, 0, e), v;
+      }
+      if (r <= z) {
+        const v = q.slice();
+        return v.splice(Math.min(r, z), 0, e), v;
+      }
+      return y;
+    });
+  }, po = ({
+    tool: o,
+    from: r,
+    to: e
+  }) => {
+    const a = k.size, y = r < a;
+    return y && e >= a ? g("controlRoom.unpinnedAnnounce", {
+      tool: o.label,
+      defaultValue: "Removed {{tool}} from favourites"
+    }) : !y && e <= a ? g("controlRoom.pinnedAnnounce", {
+      tool: o.label,
+      defaultValue: "Pinned {{tool}} to favourites"
+    }) : y && e < a ? g("controlRoom.reorderAnnounce", {
+      tool: o.label,
+      to: e + 1,
+      total: a,
+      defaultValue: "{{tool}} moved to position {{to}} of {{total}}"
+    }) : "";
+  }, K = X(null), Q = Mo(), fo = p(
+    (o) => {
+      K.current = o, Q(o), typeof S == "function" ? S(o) : S && (S.current = o);
+    },
+    [Q, S]
+  ), O = $ != null ? d.get($) ?? null : null, mo = O ? /* @__PURE__ */ U(go, { children: [
+    s ? (() => {
+      const o = k.has(O.id);
+      return /* @__PURE__ */ T(
+        Y,
+        {
+          icon: /* @__PURE__ */ T(
+            Ao,
+            {
+              "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": g("controlRoom.favorite", {
+            defaultValue: "Favourite"
+          }),
+          onClick: () => co(O.id)
+        }
+      );
+    })() : null,
+    /* @__PURE__ */ T(
+      Y,
+      {
+        icon: /* @__PURE__ */ T(So, { "aria-hidden": "true" }),
+        intent: "ghost",
+        size: "sm",
+        "aria-label": g("controlRoom.close", { defaultValue: "Close" }),
+        onClick: () => {
+          var o;
+          return (o = K.current) == null ? void 0 : o.close();
+        }
+      }
+    )
+  ] }) : null;
+  return /* @__PURE__ */ U(xo, { actions: mo, children: [
+    /* @__PURE__ */ T(
+      yo,
+      {
+        ref: fo,
+        dataComponent: "control-room-rail",
+        agentAdapter: wo,
+        tools: J,
+        activeToolId: R,
+        defaultActiveToolId: A,
+        onActiveToolChange: I,
+        panelWidth: ro,
+        onPanelWidthChange: so,
+        railLabel: c ?? g("controlRoom.railLabel", { defaultValue: "Control room" }),
+        onReorder: s ? uo : void 0,
+        formatReorderAnnouncement: s ? po : void 0,
+        ...j
+      }
+    ),
+    s ? /* @__PURE__ */ T("span", { role: "status", "aria-live": "polite", className: "ds:sr-only", children: lo }) : null
+  ] });
+});
+export {
+  Oo as C,
+  $o as a,
+  ko as b,
+  wo as c,
+  Eo as d,
+  Xo as u
+};
+//# sourceMappingURL=control-room-rail-Cv7GpMqX.js.map