@alfadocs/ui-kit-debug 1.47.0 → 1.47.1

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

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

package/dist/_chunks/control-room-rail-CdBOXIqX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-room-rail-CdBOXIqX.js","sources":["../../src/components/control-room-rail/control-room-rail.agent.ts","../../src/components/control-room-rail/control-room-context.tsx","../../src/components/control-room-rail/control-room-rail.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — ControlRoomRail.                                       */\n/*                                                                        */\n/* The product surface built on ToolRail: the docked \"Control Room\".      */\n/* It claims its OWN agent identity ('control-room-rail') so an agent and  */\n/* the DOM / cascade boundary can tell the Control Room apart from a bare  */\n/* ToolRail. Generic rail surface only: open / close a tool's panel and    */\n/* read which tool is active. State is strictly the active tool id — never  */\n/* any tool's panel CONTENT (which may carry PHI).                         */\n/*                                                                        */\n/* The descriptionKeys deliberately REUSE the existing                     */\n/* `ui.toolRail.agent.*` translations — no new i18n keys are coined this   */\n/* pass.                                                                   */\n/*                                                                        */\n/* NOTE: pin / unpin / reorder favourites are intentionally NOT yet an     */\n/* agent capability. Exposing them is a deferred follow-up: it needs a     */\n/* closed-vocabulary capability addition (DS-maintainer approval per       */\n/* src/docs/26-agent-readiness.mdx) plus its own 18-locale descriptionKeys */\n/* — neither of which this pass introduces.                                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { ControlRoomRailHandle } from './control-room-rail';\n\nexport const controlRoomRailAgent: AgentAdapter<ControlRoomRailHandle> = {\n  id: 'control-room-rail',\n  capabilities: ['open', 'close', 'select_single'],\n  state: {\n    activeToolId: {\n      type: 'string | null',\n      descriptionKey: 'ui.toolRail.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      // Pure ephemeral panel state (open) — no data loss, no external effect.\n      safety: 'read',\n      argsType: '{ id: string }',\n      argsSchema: {\n        type: 'object',\n        properties: { id: { type: 'string' } },\n        required: ['id'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.toolRail.agent.actions.open',\n      description: \"Open the given tool's panel.\",\n      examples: [{ args: { id: 'inbox' }, note: 'Open the inbox tool panel.' }],\n      invoke: (handle, args: { id: string }) => {\n        handle.open(args.id);\n      },\n    },\n    close: {\n      safety: 'read',\n      idempotent: true,\n      descriptionKey: 'ui.toolRail.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      argsSchema: {\n        type: 'object',\n        properties: { id: { type: ['string', 'null'] } },\n        required: ['id'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.toolRail.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: 'control-room-rail',\n      description: 'Marks the ControlRoomRail 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  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { ToolRailHandle, ToolRailTool } from '../tool-rail';\n\n/* ------------------------------------------------------------------ */\n/* Control Room context — the scope mechanism                          */\n/*                                                                    */\n/* The DS provides the plumbing; the CONSUMER declares scope by which  */\n/* API it reaches for:                                                 */\n/*   - <ControlRoomProvider globalTools={…}>  → `global` tools, set    */\n/*     once at the app shell, persist across navigation.               */\n/*   - useControlRoomTools([…])               → `contextual` tools,    */\n/*     registered per-page, swap with the open entity.                 */\n/* `<ControlRoomRail>` reads the merged set; `global` tools seed the   */\n/* default favourites (pinned on top), `contextual` tools fall below    */\n/* the divider. The rail renders the divider between the two groups.    */\n/* ------------------------------------------------------------------ */\n\ninterface ControlRoomContextValue {\n  globalTools: ToolRailTool[];\n  contextualTools: ToolRailTool[];\n  registerContextualTools: (id: string, tools: ToolRailTool[]) => void;\n  unregisterContextualTools: (id: string) => void;\n  // The rail registers its imperative handle here so pages can drive it\n  // (e.g. open the X-ray panel when a tooth is clicked). Null until mounted.\n  registerRail: (handle: ToolRailHandle | null) => void;\n  openTool: (id: string) => void;\n  closeTool: () => void;\n}\n\nconst ControlRoomContext = createContext<ControlRoomContextValue | null>(null);\n\nexport interface ControlRoomProviderProps {\n  /**\n   * Tools valid in every context (Alia, Inbox). Set once at the app shell —\n   * they pin to the rail's far end and persist across navigation. Memoise\n   * this array so it doesn't re-register every render.\n   */\n  globalTools?: ToolRailTool[];\n  children: ReactNode;\n}\n\n/**\n * Holds the Control Room's global tools and the registry of per-context\n * contextual tools. Mount once at the app shell, inside the frame that also\n * renders `<ControlRoomRail>`.\n */\nexport function ControlRoomProvider({\n  globalTools = [],\n  children,\n}: ControlRoomProviderProps) {\n  // id → that registration's contextual tools. Multiple concurrent\n  // registrations merge in insertion order (rare, but composes cleanly).\n  const [registry, setRegistry] = useState<Map<string, ToolRailTool[]>>(\n    () => new Map(),\n  );\n\n  const registerContextualTools = useCallback(\n    (id: string, tools: ToolRailTool[]) => {\n      setRegistry((prev) => {\n        const next = new Map(prev);\n        next.set(id, tools);\n        return next;\n      });\n    },\n    [],\n  );\n\n  const unregisterContextualTools = useCallback((id: string) => {\n    setRegistry((prev) => {\n      if (!prev.has(id)) return prev;\n      const next = new Map(prev);\n      next.delete(id);\n      return next;\n    });\n  }, []);\n\n  const contextualTools = useMemo(\n    () => Array.from(registry.values()).flat(),\n    [registry],\n  );\n\n  // The rail's imperative handle, registered by <ControlRoomRail> on mount.\n  // openTool/closeTool drive it so a page can open a panel (e.g. the X-ray\n  // viewer when a tooth is clicked) without holding a ref to the rail itself.\n  const railHandleRef = useRef<ToolRailHandle | null>(null);\n  const registerRail = useCallback((handle: ToolRailHandle | null) => {\n    railHandleRef.current = handle;\n  }, []);\n  const openTool = useCallback((id: string) => {\n    railHandleRef.current?.setActiveTool(id);\n  }, []);\n  const closeTool = useCallback(() => {\n    railHandleRef.current?.setActiveTool(null);\n  }, []);\n\n  const value = useMemo<ControlRoomContextValue>(\n    () => ({\n      globalTools,\n      contextualTools,\n      registerContextualTools,\n      unregisterContextualTools,\n      registerRail,\n      openTool,\n      closeTool,\n    }),\n    [\n      globalTools,\n      contextualTools,\n      registerContextualTools,\n      unregisterContextualTools,\n      registerRail,\n      openTool,\n      closeTool,\n    ],\n  );\n\n  return (\n    <ControlRoomContext.Provider value={value}>\n      {children}\n    </ControlRoomContext.Provider>\n  );\n}\n\n/**\n * Register this context's **contextual** tools (Notes, Appointments, the entity\n * summary). They sit below the favourites divider and unregister automatically\n * when the calling component unmounts (i.e. when you leave the context).\n *\n * Pass a **stable / memoised** array — like `useEffect` deps, a fresh array\n * every render re-registers every render. Wrap it in `useMemo`.\n *\n * No-op when rendered outside a `<ControlRoomProvider>`.\n */\nexport function useControlRoomTools(tools: ToolRailTool[]): void {\n  const ctx = useContext(ControlRoomContext);\n  // Depend on the STABLE register/unregister callbacks, never the whole\n  // context value: the value object changes every time the registry updates\n  // (which this very effect triggers), so depending on `ctx` would re-register\n  // on every change — an infinite loop. The callbacks are `useCallback([])`.\n  const register = ctx?.registerContextualTools;\n  const unregister = ctx?.unregisterContextualTools;\n  const id = useId();\n  useEffect(() => {\n    if (!register || !unregister) return undefined;\n    register(id, tools);\n    return () => unregister(id);\n  }, [register, unregister, id, tools]);\n}\n\n/**\n * The merged tool set the rail consumes: contextual tools (auto-tagged\n * `scope: 'contextual'`) then globals (`scope: 'global'`). Scope is assigned\n * here by which API registered the tool — `global` seeds the Control Room's\n * default favourites (pinned on top); `contextual` falls below the divider.\n * `ControlRoomRail` re-groups by favourite membership for the final order.\n * Returns `[]` outside a provider.\n */\nexport function useControlRoomMergedTools(): ToolRailTool[] {\n  const ctx = useContext(ControlRoomContext);\n  return useMemo(() => {\n    if (!ctx) return [];\n    const contextual = ctx.contextualTools.map((tool) => ({\n      ...tool,\n      scope: 'contextual' as const,\n    }));\n    const global = ctx.globalTools.map((tool) => ({\n      ...tool,\n      scope: 'global' as const,\n    }));\n    return [...contextual, ...global];\n  }, [ctx]);\n}\n\n/**\n * Imperative actions to drive the rail from a page: open a tool's panel (e.g.\n * the X-ray viewer when a tooth is clicked) or collapse it. No-ops outside a\n * `<ControlRoomProvider>`. The functions are stable across renders.\n */\nexport function useControlRoomActions(): {\n  openTool: (id: string) => void;\n  closeTool: () => void;\n} {\n  const ctx = useContext(ControlRoomContext);\n  const noop = useCallback(() => {}, []);\n  return {\n    openTool: ctx?.openTool ?? noop,\n    closeTool: ctx?.closeTool ?? noop,\n  };\n}\n\n/**\n * Internal: the rail registers its imperative handle with the provider so\n * `useControlRoomActions().openTool` can drive it. Returns the stable\n * `registerRail` callback (or a no-op outside a provider).\n */\nexport function useControlRoomRailRegister(): (\n  handle: ToolRailHandle | null,\n) => void {\n  const ctx = useContext(ControlRoomContext);\n  const noop = useCallback((_handle: ToolRailHandle | null) => {}, []);\n  return ctx?.registerRail ?? noop;\n}\n","import {\n  forwardRef,\n  useCallback,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { useTranslation } from 'react-i18next';\nimport { Star, X } from 'lucide-react';\nimport { IconButton } from '../button/icon-button';\nimport { PanelHeaderActionsProvider } from '../panel-header/panel-header';\nimport {\n  ToolRail,\n  type ToolRailHandle,\n  type ToolRailProps,\n  type ToolRailTool,\n} from '../tool-rail';\nimport { usePersistentState } from '../../hooks/use-persistent-state';\nimport { controlRoomRailAgent } from './control-room-rail.agent';\nimport {\n  useControlRoomMergedTools,\n  useControlRoomRailRegister,\n} from './control-room-context';\n\n/* ------------------------------------------------------------------ */\n/* ControlRoomRail — the unified, contextual workspace rail.           */\n/*                                                                    */\n/* The docked right-hand \"Control Room\": the single home for the       */\n/* assistant, inbox, notes, appointments and entity summaries          */\n/* alongside the main work surface. One panel open at a time,          */\n/* non-modal.                                                          */\n/*                                                                    */\n/* It layers a FAVOURITES model over the proven ToolRail (its prior */\n/* name): favourited tools form a pinned group at the TOP of the strip */\n/* above a divider, then everything else below. The default favourites */\n/* are the host's `global` tools (Alia, Inbox) — so the rail opens with */\n/* notifications + Alia on top, the Control Room's default arrangement. */\n/*                                                                    */\n/* Favouriting is DRAG-FIRST, no per-icon star: drag a tool up across  */\n/* the divider to pin it (and drop it where you want in the order),    */\n/* drag a favourite back down to unpin. The keyboard equivalent is     */\n/* `Alt`+Arrow (crossing the divider pins / unpins, announced). The    */\n/* non-drag pointer path — and the discoverable entry point — is an    */\n/* add / remove control in each open tool's panel header.              */\n/*                                                                    */\n/* ToolRail stays favourite-agnostic: this layer maps favourite     */\n/* membership onto the rail's generic `scope` grouping + (whole-strip)  */\n/* `reorderable` run, reads cross-divider moves as pin / unpin, and     */\n/* injects the favourite + close controls into the active panel's       */\n/* PanelHeader via <PanelHeaderActionsProvider> (no separate header     */\n/* row — the controls live inline-end of the panel's title row).        */\n/* ------------------------------------------------------------------ */\n\n/** A Control Room tool — the rail tool descriptor, `scope`-aware. */\nexport type ControlRoomTool = ToolRailTool;\n\n/** Imperative handle — open / collapse a tool panel without the DOM. */\nexport type ControlRoomRailHandle = ToolRailHandle;\n\n/** What one favourites write did, for the tool the user acted on. */\nexport interface ControlRoomFavoriteChange {\n  toolId: string;\n  action: 'pin' | 'unpin' | 'reorder';\n}\n\n/* A hard-pinned id re-pins on the next render, so unpinning it changes\n   nothing and reports nothing. */\nfunction favoriteChangeOf(\n  toolId: string,\n  previous: readonly string[],\n  next: readonly string[],\n  hardPinned: readonly string[] | undefined,\n): ControlRoomFavoriteChange | undefined {\n  const was = previous.includes(toolId);\n  const is = next.includes(toolId);\n  if (!was && is) return { toolId, action: 'pin' };\n  if (was && !is)\n    return hardPinned?.includes(toolId)\n      ? undefined\n      : { toolId, action: 'unpin' };\n  /* Compare what the rail shows: hard-pinned ids always lead. */\n  const shown = (list: readonly string[]) =>\n    hardPinned?.length\n      ? [...hardPinned, ...list.filter((id) => !hardPinned.includes(id))]\n      : list;\n  const before = shown(previous);\n  const after = shown(next);\n  const reordered =\n    before.length !== after.length ||\n    before.some((id, index) => after[index] !== id);\n  return reordered ? { toolId, action: 'reorder' } : undefined;\n}\n\nexport interface ControlRoomRailProps extends Omit<\n  ToolRailProps,\n  | 'tools'\n  | 'onReorder'\n  | 'formatReorderAnnouncement'\n  | 'renderToolAffordance'\n  | 'renderPanelHeader'\n> {\n  /**\n   * Explicit tool set. Omit to read the merged global + contextual tools from\n   * the nearest `<ControlRoomProvider>` (+ `useControlRoomTools`).\n   */\n  tools?: ControlRoomTool[];\n  /**\n   * Enable the favourites model: a pinned top group, drag / `Alt`+Arrow\n   * reordering, and the panel-header add / remove control. Default `true`. Set\n   * `false` for the legacy flat strip (tools render in the order / `scope` you\n   * pass, no drag, no panel-header control).\n   */\n  reorderable?: boolean;\n  /**\n   * Controlled favourite tool ids, in pinned order. When set, the rail does not\n   * persist — the host owns the value and is notified via `onFavoriteIdsChange`.\n   */\n  favoriteIds?: string[];\n  /**\n   * HARD-PINNED favourite ids — always rendered at the very START of the\n   * pinned group, ahead of (and deduped from) user favourites, in both\n   * controlled and uncontrolled modes. Immune to unpin: removing one via\n   * the panel-header control or a drag is a no-op (it re-pins on the next\n   * render). For tools the product wants permanently one glance away —\n   * e.g. notifications at the top of the strip.\n   */\n  pinnedFavoriteIds?: string[];\n  /**\n   * Uncontrolled initial favourites. Defaults to the ids of the tools the host\n   * marked `scope: 'global'` (Alia, Inbox) — pinning them on top by default.\n   */\n  defaultFavoriteIds?: string[];\n  /** Fires with the next favourites order whenever the user pins / reorders.\n   *  `change` names the tool acted on and what happened to it; it is\n   *  absent when the write changed nothing. */\n  onFavoriteIdsChange?: (\n    next: string[],\n    change?: ControlRoomFavoriteChange,\n  ) => void;\n  /** localStorage key for the uncontrolled favourites. */\n  persistFavoritesKey?: string;\n  /**\n   * localStorage key for the uncontrolled committed panel width, mirroring\n   * `persistFavoritesKey`: when set and `panelWidth` is absent, the rail\n   * seeds its width from storage on mount and writes each commit back.\n   * Unlike `persistFavoritesKey` this has no default — persistence is\n   * opt-in. Only meaningful with `resizablePanel` — there is nothing to\n   * persist without the resize handle.\n   */\n  persistPanelWidthKey?: string;\n}\n\nexport const ControlRoomRail = forwardRef<\n  ControlRoomRailHandle,\n  ControlRoomRailProps\n>(function ControlRoomRail(\n  {\n    tools,\n    railLabel,\n    reorderable = true,\n    favoriteIds,\n    defaultFavoriteIds,\n    pinnedFavoriteIds,\n    onFavoriteIdsChange,\n    persistFavoritesKey = 'ui.controlRoom.favorites',\n    activeToolId,\n    defaultActiveToolId = null,\n    onActiveToolChange,\n    panelWidth,\n    onPanelWidthChange,\n    persistPanelWidthKey,\n    ...rest\n  },\n  ref,\n) {\n  const { t } = useTranslation();\n\n  // Mirror the active tool id so the rail can build the panel-header controls\n  // (favourite + close) for whichever tool is open. Controlled hosts own the\n  // value via `activeToolId`; otherwise we seed from `defaultActiveToolId` and\n  // track subsequent changes through the intercepted `onActiveToolChange`.\n  const [activeTracked, setActiveTracked] = useState<string | null>(\n    activeToolId ?? defaultActiveToolId ?? null,\n  );\n  const activeId = activeToolId !== undefined ? activeToolId : activeTracked;\n  const handleActiveToolChange = useCallback(\n    (id: string | null) => {\n      if (activeToolId === undefined) setActiveTracked(id);\n      onActiveToolChange?.(id);\n    },\n    [activeToolId, onActiveToolChange],\n  );\n  // Provider-driven tools when none are passed explicitly. Calling the hook\n  // unconditionally is safe — it returns [] outside a provider.\n  const merged = useControlRoomMergedTools();\n  const resolved = tools ?? merged;\n\n  const isControlled = favoriteIds !== undefined;\n  // Uncontrolled favourites persist to localStorage; the lazy initial seeds\n  // from the host's `global` tools on first mount only (later tool changes\n  // don't re-seed — favourites are user-owned once set). When controlled, the\n  // hook is disabled so it never reads or writes storage.\n  const [storedFavorites, setStoredFavorites] = usePersistentState<string[]>(\n    persistFavoritesKey,\n    () =>\n      defaultFavoriteIds ??\n      resolved.filter((tl) => tl.scope === 'global').map((tl) => tl.id),\n    { disabled: isControlled },\n  );\n  const userFavorites = isControlled ? favoriteIds : storedFavorites;\n  /* Hard-pinned ids lead the group every render — user favourites follow,\n     deduped. Because the merge happens HERE (not in storage), an unpin\n     write simply has no effect on a pinned id. */\n  const favorites = useMemo(() => {\n    if (!pinnedFavoriteIds?.length) return userFavorites;\n    return [\n      ...pinnedFavoriteIds,\n      ...userFavorites.filter((id) => !pinnedFavoriteIds.includes(id)),\n    ];\n  }, [pinnedFavoriteIds, userFavorites]);\n\n  // Uncontrolled panel-width persistence mirrors favourites, but is opt-in\n  // (no default key) since not every rail wants its width remembered.\n  // The hook is called unconditionally — `disabled` just keeps it from\n  // touching storage when controlled or when no key was given.\n  const isWidthControlled = panelWidth !== undefined;\n  const [storedPanelWidth, setStoredPanelWidth] = usePersistentState<\n    number | null\n  >(persistPanelWidthKey ?? 'ui.controlRoom.panelWidth.unused', null, {\n    disabled: isWidthControlled || !persistPanelWidthKey,\n  });\n  const resolvedPanelWidth = isWidthControlled\n    ? panelWidth\n    : persistPanelWidthKey\n      ? storedPanelWidth\n      : undefined;\n  const handlePanelWidthChange = useCallback(\n    (next: number | null) => {\n      if (!isWidthControlled && persistPanelWidthKey) {\n        setStoredPanelWidth(next);\n      }\n      onPanelWidthChange?.(next);\n    },\n    [\n      isWidthControlled,\n      persistPanelWidthKey,\n      setStoredPanelWidth,\n      onPanelWidthChange,\n    ],\n  );\n\n  const byId = useMemo(() => {\n    const map = new Map<string, ControlRoomTool>();\n    for (const tl of resolved) map.set(tl.id, tl);\n    return map;\n  }, [resolved]);\n\n  // Favourites filtered to currently-present tools — stale ids are ignored\n  // (and dropped on the next write).\n  const favoriteSet = useMemo(\n    () => new Set(favorites.filter((id) => byId.has(id))),\n    [favorites, byId],\n  );\n\n  const updateFavorites = (\n    toolId: string,\n    updater: (prev: string[]) => string[],\n  ) => {\n    // `updater` must be pure — it is invoked twice (once to compute the\n    // reported `next`, once inside the functional setState below).\n    const previous = favorites.filter((id) => byId.has(id));\n    const next = updater(previous);\n    // Persist via a functional update so rapid pin/reorder events compose\n    // (mirrors the Sidebar's useFavorites); controlled hosts own the value.\n    if (!isControlled)\n      setStoredFavorites((prev) => updater(prev.filter((id) => byId.has(id))));\n    onFavoriteIdsChange?.(\n      next,\n      favoriteChangeOf(toolId, previous, next, pinnedFavoriteIds),\n    );\n  };\n\n  // Re-group into the pinned run (favourites order, tagged so ToolRail draws\n  // the divider) followed by the rest. EVERY tool is `reorderable` so the rail's\n  // reorder run spans the whole strip — that's what lets a drag / Alt+Arrow\n  // cross the divider; `handleReorder` reads the crossing as pin / unpin.\n  const railTools = useMemo<ControlRoomTool[]>(() => {\n    if (!reorderable) return resolved;\n    const favTools = favorites\n      .filter((id) => byId.has(id))\n      .map((id) => ({\n        ...(byId.get(id) as ControlRoomTool),\n        scope: 'global' as const,\n        reorderable: true,\n      }));\n    const rest = resolved\n      .filter((tl) => !favoriteSet.has(tl.id))\n      .map((tl) => ({\n        ...tl,\n        scope: 'contextual' as const,\n        reorderable: true,\n      }));\n    return [...favTools, ...rest];\n  }, [reorderable, resolved, favorites, byId, favoriteSet]);\n\n  // The drag / Alt+Arrow path announces through the rail's own reorder live\n  // region; the panel-header button toggles outside it, so it needs its own\n  // polite announcement. The zero-width-space toggle forces a re-announce of an\n  // identical message (e.g. pin → unpin → pin the same tool).\n  const [pinMessage, setPinMessage] = useState('');\n  const pinAnnounceToggle = useRef(false);\n  const announcePinChange = (label: string, willPin: boolean) => {\n    const text = willPin\n      ? t('controlRoom.pinnedAnnounce', {\n          tool: label,\n          defaultValue: 'Pinned {{tool}} to favourites',\n        })\n      : t('controlRoom.unpinnedAnnounce', {\n          tool: label,\n          defaultValue: 'Removed {{tool}} from favourites',\n        });\n    pinAnnounceToggle.current = !pinAnnounceToggle.current;\n    setPinMessage(pinAnnounceToggle.current ? text : `${text}\\u200B`);\n  };\n\n  const togglePin = (id: string) => {\n    announcePinChange(byId.get(id)?.label ?? id, !favoriteSet.has(id));\n    updateFavorites(id, (prev) =>\n      prev.includes(id) ? prev.filter((p) => p !== id) : [...prev, id],\n    );\n  };\n\n  // The rail fires `onReorder` with indices into `railTools` (favourites first,\n  // then the rest). The divider sits at `favCount`, so the index either side of\n  // it tells us whether a move is a reorder, a pin, an unpin, or a no-op.\n  const handleReorder = (from: number, to: number) => {\n    const movedId = railTools[from]?.id;\n    if (movedId === undefined) return;\n    updateFavorites(movedId, (prev) => {\n      const present = prev.filter((id) => byId.has(id));\n      const favCount = present.length;\n      const wasFav = from < favCount;\n      if (wasFav) {\n        // Dropped below the divider → unpin.\n        if (to >= favCount) return present.filter((id) => id !== movedId);\n        // Reorder within favourites (full-strip index == favourites index).\n        const next = present.slice();\n        next.splice(from, 1);\n        next.splice(to, 0, movedId);\n        return next;\n      }\n      // A contextual tool dropped onto / above the divider → pin at that slot.\n      if (to <= favCount) {\n        const next = present.slice();\n        next.splice(Math.min(to, favCount), 0, movedId);\n        return next;\n      }\n      // Contextual → contextual: that group is host-ordered, so nothing to do.\n      return prev;\n    });\n  };\n\n  // Membership-aware live-region phrasing for the rail's reorder announcer.\n  const formatReorderAnnouncement = ({\n    tool,\n    from,\n    to,\n  }: {\n    tool: ControlRoomTool;\n    from: number;\n    to: number;\n  }): string => {\n    const favCount = favoriteSet.size;\n    const wasFav = from < favCount;\n    if (wasFav && to >= favCount)\n      return t('controlRoom.unpinnedAnnounce', {\n        tool: tool.label,\n        defaultValue: 'Removed {{tool}} from favourites',\n      });\n    if (!wasFav && to <= favCount)\n      return t('controlRoom.pinnedAnnounce', {\n        tool: tool.label,\n        defaultValue: 'Pinned {{tool}} to favourites',\n      });\n    if (wasFav && to < favCount)\n      return t('controlRoom.reorderAnnounce', {\n        tool: tool.label,\n        to: to + 1,\n        total: favCount,\n        defaultValue: '{{tool}} moved to position {{to}} of {{total}}',\n      });\n    // Contextual → contextual is a no-op; stay silent.\n    return '';\n  };\n\n  // Register the rail's imperative handle with the provider (so a page's\n  // useControlRoomActions().openTool can drive it) AND forward it to the\n  // consumer's ref. A callback ref does both; no-op without a provider. We also\n  // stash it locally so the injected close control can collapse the panel.\n  const railHandleRef = useRef<ToolRailHandle | null>(null);\n  const registerRail = useControlRoomRailRegister();\n  const setRefs = useCallback(\n    (handle: ToolRailHandle | null) => {\n      railHandleRef.current = handle;\n      registerRail(handle);\n      if (typeof ref === 'function') ref(handle);\n      else if (ref) ref.current = handle;\n    },\n    [registerRail, ref],\n  );\n\n  // The active tool's panel-header controls, injected into its PanelHeader's\n  // action cluster (inline-end of the title row) via context — no separate\n  // header row. When a tool is open: an icon-only favourite toggle (only when\n  // reorderable; pressed state via aria-pressed + the filled star) followed by\n  // a close control that collapses the panel. Nothing injected when collapsed\n  // or where the panel renders no PanelHeader.\n  const activeTool = activeId != null ? (byId.get(activeId) ?? null) : null;\n  const injectedActions: ReactNode = activeTool ? (\n    <>\n      {reorderable\n        ? (() => {\n            const pinned = favoriteSet.has(activeTool.id);\n            return (\n              <IconButton\n                icon={\n                  <Star\n                    aria-hidden=\"true\"\n                    fill={pinned ? 'currentColor' : 'none'}\n                    className={\n                      pinned ? 'ds:text-[color:var(--accent)]' : undefined\n                    }\n                  />\n                }\n                intent=\"ghost\"\n                size=\"sm\"\n                aria-pressed={pinned}\n                aria-label={t('controlRoom.favorite', {\n                  defaultValue: 'Favourite',\n                })}\n                onClick={() => togglePin(activeTool.id)}\n              />\n            );\n          })()\n        : null}\n      <IconButton\n        icon={<X aria-hidden=\"true\" />}\n        intent=\"ghost\"\n        size=\"sm\"\n        aria-label={t('controlRoom.close', { defaultValue: 'Close' })}\n        onClick={() => railHandleRef.current?.close()}\n      />\n    </>\n  ) : null;\n  return (\n    <PanelHeaderActionsProvider actions={injectedActions}>\n      <ToolRail\n        ref={setRefs}\n        dataComponent=\"control-room-rail\"\n        agentAdapter={controlRoomRailAgent}\n        tools={railTools}\n        activeToolId={activeToolId}\n        defaultActiveToolId={defaultActiveToolId}\n        onActiveToolChange={handleActiveToolChange}\n        panelWidth={resolvedPanelWidth}\n        onPanelWidthChange={handlePanelWidthChange}\n        railLabel={\n          railLabel ??\n          t('controlRoom.railLabel', { defaultValue: 'Control room' })\n        }\n        onReorder={reorderable ? handleReorder : undefined}\n        formatReorderAnnouncement={\n          reorderable ? formatReorderAnnouncement : undefined\n        }\n        {...rest}\n      />\n      {/* Polite announcement for the panel-header pin / unpin button (the\n          drag / Alt+Arrow path announces via the rail's own reorder region). */}\n      {reorderable ? (\n        <span role=\"status\" aria-live=\"polite\" className=\"ds:sr-only\">\n          {pinMessage}\n        </span>\n      ) : null}\n    </PanelHeaderActionsProvider>\n  );\n});\n"],"names":["controlRoomRailAgent","handle","args","ControlRoomContext","createContext","ControlRoomProvider","globalTools","children","registry","setRegistry","useState","registerContextualTools","useCallback","id","tools","prev","next","unregisterContextualTools","contextualTools","useMemo","railHandleRef","useRef","registerRail","openTool","_a","closeTool","value","jsx","useControlRoomTools","ctx","useContext","register","unregister","useId","useEffect","useControlRoomMergedTools","contextual","tool","global","useControlRoomActions","noop","useControlRoomRailRegister","_handle","favoriteChangeOf","toolId","previous","hardPinned","was","is","shown","list","before","after","index","ControlRoomRail","forwardRef","railLabel","reorderable","favoriteIds","defaultFavoriteIds","pinnedFavoriteIds","onFavoriteIdsChange","persistFavoritesKey","activeToolId","defaultActiveToolId","onActiveToolChange","panelWidth","onPanelWidthChange","persistPanelWidthKey","rest","ref","t","useTranslation","activeTracked","setActiveTracked","activeId","handleActiveToolChange","merged","resolved","isControlled","storedFavorites","setStoredFavorites","usePersistentState","tl","userFavorites","favorites","isWidthControlled","storedPanelWidth","setStoredPanelWidth","resolvedPanelWidth","handlePanelWidthChange","byId","map","favoriteSet","updateFavorites","updater","railTools","favTools","pinMessage","setPinMessage","pinAnnounceToggle","announcePinChange","label","willPin","text","togglePin","p","handleReorder","from","to","movedId","present","favCount","formatReorderAnnouncement","wasFav","setRefs","activeTool","injectedActions","jsxs","Fragment","pinned","IconButton","Star","X","PanelHeaderActionsProvider","ToolRail"],"mappings":"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"}

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.47.0",
+  "packageVersion": "1.47.1",
   "components": [
     {
       "kind": "component",

package/dist/components/control-room-rail/control-room-rail.d.ts

@@ -3,6 +3,11 @@ import { type ToolRailHandle, type ToolRailProps, type ToolRailTool } from '../t
 export type ControlRoomTool = ToolRailTool;
 /** Imperative handle — open / collapse a tool panel without the DOM. */
 export type ControlRoomRailHandle = ToolRailHandle;
+/** What one favourites write did, for the tool the user acted on. */
+export interface ControlRoomFavoriteChange {
+    toolId: string;
+    action: 'pin' | 'unpin' | 'reorder';
+}
 export interface ControlRoomRailProps extends Omit<ToolRailProps, 'tools' | 'onReorder' | 'formatReorderAnnouncement' | 'renderToolAffordance' | 'renderPanelHeader'> {
     /**
      * Explicit tool set. Omit to read the merged global + contextual tools from
@@ -35,8 +40,10 @@ export interface ControlRoomRailProps extends Omit<ToolRailProps, 'tools' | 'onR
      * marked `scope: 'global'` (Alia, Inbox) — pinning them on top by default.
      */
     defaultFavoriteIds?: string[];
-    /** Fires with the next favourites order whenever the user pins / reorders. */
-    onFavoriteIdsChange?: (next: string[]) => void;
+    /** Fires with the next favourites order whenever the user pins / reorders.
+     *  `change` names the tool acted on and what happened to it; it is
+     *  absent when the write changed nothing. */
+    onFavoriteIdsChange?: (next: string[], change?: ControlRoomFavoriteChange) => void;
     /** localStorage key for the uncontrolled favourites. */
     persistFavoritesKey?: string;
     /**

package/dist/components/control-room-rail/control-room-rail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-room-rail.d.ts","sourceRoot":"","sources":["../../../src/components/control-room-rail/control-room-rail.tsx"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAqCtB,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAE3C,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEnD,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,aAAa,EACX,OAAO,GACP,WAAW,GACX,2BAA2B,GAC3B,sBAAsB,GACtB,mBAAmB,CACtB;IACC;;;OAGG;IACH,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,iHAsU1B,CAAC"}
+{"version":3,"file":"control-room-rail.d.ts","sourceRoot":"","sources":["../../../src/components/control-room-rail/control-room-rail.tsx"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAqCtB,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAE3C,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEnD,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;CACrC;AA8BD,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,aAAa,EACX,OAAO,GACP,WAAW,GACX,2BAA2B,GAC3B,sBAAsB,GACtB,mBAAmB,CACtB;IACC;;;OAGG;IACH,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B;;iDAE6C;IAC7C,mBAAmB,CAAC,EAAE,CACpB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,yBAAyB,KAC/B,IAAI,CAAC;IACV,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,iHA6U1B,CAAC"}

package/dist/components/control-room-rail/index.d.ts

@@ -1,5 +1,5 @@
 export { ControlRoomRail } from './control-room-rail';
-export type { ControlRoomRailProps, ControlRoomRailHandle, ControlRoomTool, } from './control-room-rail';
+export type { ControlRoomRailProps, ControlRoomRailHandle, ControlRoomFavoriteChange, ControlRoomTool, } from './control-room-rail';
 export { controlRoomRailAgent } from './control-room-rail.agent';
 export { ControlRoomProvider, useControlRoomTools, useControlRoomMergedTools, useControlRoomActions, } from './control-room-context';
 export type { ControlRoomProviderProps } from './control-room-context';

package/dist/components/control-room-rail/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/control-room-rail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/control-room-rail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/control-room-rail/index.js

@@ -1,4 +1,4 @@
-import { C as r, a as l, c as a, u as t, b as e, d as n } from "../../_chunks/control-room-rail-Cv7GpMqX.js";
+import { C as r, a as l, c as a, u as t, b as e, d as n } from "../../_chunks/control-room-rail-CdBOXIqX.js";
 export {
   r as ControlRoomProvider,
   l as ControlRoomRail,

package/dist/index.js

@@ -111,7 +111,7 @@ import { S as en } from "./_chunks/stat-Bs80Z6Yv.js";
 import { T as rn } from "./_chunks/tag-Ci3xJPcH.js";
 import { T as tn, t as nn } from "./_chunks/timeline-61AihzYz.js";
 import { T as mn } from "./_chunks/timestamp-BV2lC-wV.js";
-import { C as dn, a as An, c as cn, u as fn, b as gn, d as Sn } from "./_chunks/control-room-rail-Cv7GpMqX.js";
+import { C as dn, a as An, c as cn, u as fn, b as gn, d as Sn } from "./_chunks/control-room-rail-CdBOXIqX.js";
 import { B as Tn, a as xn, b as un, c as Pn, d as In, e as En, f as Rn } from "./_chunks/breadcrumb-agut0PwN.js";
 import { C as _n, a as Nn, b as Dn, c as hn, d as On, e as Fn, f as Ln, g as Mn, h as yn, i as kn, j as Bn, k as vn, u as Gn } from "./_chunks/command-palette-DQl_SNEv.js";
 import { H as wn, a as Wn, b as Vn, c as Un, d as Kn, e as Yn, f as Xn, g as qn } from "./_chunks/header-3o9o9v_T.js";
@@ -244,7 +244,7 @@ import { W as MC, a as yC, w as kC } from "./_chunks/workflow-status-CuJAOuKL.js
 import { C as vC, W as GC, a as HC, b as wC, c as WC, i as VC, l as UC, m as KC, r as YC, w as XC, d as qC, e as zC, f as jC } from "./_chunks/workflow-map-DhR_h5yw.js";
 import { A as ZC, a as JC, b as $C, c as aT } from "./_chunks/alia-sidebar-CUqaJNPQ.js";
 import { A as sT, a as rT, L as oT, P as tT, S as nT, T as iT, b as pT, c as mT, d as lT, e as dT, f as AT, g as cT, h as fT, i as gT, j as ST, k as CT, l as TT, m as xT, n as uT, o as PT, p as IT, r as ET, q as RT, s as bT, t as _T, u as NT } from "./_chunks/anamnesis-summary-rows-DI-UX5r6.js";
-import { C as hT, a as OT, b as FT, c as LT, D as MT, d as yT, S as kT, V as BT, W as vT, e as GT, i as HT, m as wT, r as WT, u as VT, f as UT, g as KT } from "./_chunks/calendar-workspace-DDnQmiIL.js";
+import { C as hT, a as OT, b as FT, c as LT, D as MT, d as yT, S as kT, V as BT, W as vT, e as GT, i as HT, m as wT, r as WT, u as VT, f as UT, g as KT } from "./_chunks/calendar-workspace-BmscntRR.js";
 import { A as XT, a as qT, b as zT, H as jT, c as QT, u as ZT } from "./_chunks/help-me-write-templates-DHIwa4xR.js";
 import { C as $T, M as ax, P as ex } from "./_chunks/marketplace-app-shell-PB89Dkk_.js";
 import { P as rx } from "./_chunks/payment-automation-upsell-BKmBXU4i.js";

package/dist/patterns/calendar/calendar-workspace.d.ts

@@ -1,3 +1,42 @@
+/**
+ * Calendar pattern — the WORKSPACE ROOT.
+ *
+ * The practice agenda page the platform mounts from the kit: the grid
+ * and its two-strip toolbar (`calendar.surface.tsx`) beside a MINIMAL
+ * Control Room rail docked inline-end — up to six tools, in strip
+ * order: the upcoming Appointments panel (the rail's resting state and
+ * its default), ONE appointment editor / details tool, the waiting list,
+ * patient notes when in context, online bookings and the free-slot finder. Nothing else — no Inbox,
+ * no Alia, no patient tabs, no care plan, no tasks. The panels are the
+ * extracted modules from `calendar.sheets.tsx`; `calendar.host.ts`'s
+ * open / close seam maps onto the rail's dock, with `close()` returning
+ * to the Appointments panel so no path leaves an empty rail.
+ *
+ * Six is the ceiling, not the floor: `availableTools` narrows the set
+ * to what the host can actually back with data, hiding the rail tool AND
+ * the toolbar control that opens it, and routing anything aimed at a
+ * withheld tool to the Appointments panel. A host with no business
+ * hours, holidays or closures must withhold the free-slot finder — it
+ * would otherwise report booked and shut-day times as free.
+ *
+ * The host owns the data and the domain state: it hands in a
+ * `CalendarData` read model (`calendar.data.ts`) and a `CalendarJourney`
+ * (`calendar.journey.ts`) — the demos from their fixtures and the
+ * fixture-backed journey hook, the platform island from
+ * `/internalApi/...`. The workspace owns what sits between the two: the
+ * cog's display settings, the privacy flag, the one polite region, the
+ * editor tool's mode, the placement / create modes, the deep-link
+ * effects and the tasks filter. It renders NO header or sidebar — the
+ * host page has its own — and expects a bounded block-size from its
+ * parent (it fills it; the surface scrolls inside, the rail stays put),
+ * exactly what `AppFrame`'s `<main>` gives a page.
+ *
+ * The confirmations stay kit `Dialog`s — they interrupt rather than
+ * dock: the move confirm, the delete confirm with its recurring scope
+ * and care-plan cleanup and the Create-bill confirm.
+ */
+import type { CalendarView } from '../../components/calendar';
+import { type ControlRoomFavoriteChange } from '../../components/control-room-rail';
 import { type CalendarAppointmentEditorLoader } from './calendar-editor-hydration';
 import { type CalendarAppointmentDetailsLoader } from './calendar-appointment-details';
 import { type CalendarData } from './calendar.data';
@@ -18,6 +57,46 @@ export interface CalendarOnlineBookings {
     createdAtById?: Readonly<Record<string, string>>;
     onRetry?: () => void;
 }
+/** Where a tool panel was opened from. `system` is a dock the workspace
+ *  made on its own (the resting panel, a return after a save, a
+ *  toolbar or journey hand-off), not a pick on the rail. */
+export type CalendarToolOpenSource = 'rail' | 'appointment_panel' | 'selection' | 'system';
+/** Where the appointment behind a details panel was selected. `host` is
+ *  a selection the journey made itself. */
+export type CalendarDetailsOpenSource = 'calendar' | 'appointments_panel' | 'bookings_panel' | 'waiting_list' | 'deep_link' | 'host';
+/**
+ * Usage callbacks for the host's analytics. The kit raises no event of
+ * its own and passes identifiers only, never patient data: the host owns
+ * the calls, the property allow-list and any once-per guard.
+ */
+export interface CalendarWorkspaceAnalytics {
+    /** A tool panel opened. Not raised again while it stays open. */
+    onToolOpen?: (event: {
+        toolId: CalendarWorkspaceToolId;
+        source: CalendarToolOpenSource;
+        view: CalendarView;
+    }) => void;
+    /** An appointment's preview opened. Raised on EVERY opening: the
+     *  once-per-appointment guard is the host's. */
+    onAppointmentPreviewOpen?: (event: {
+        eventId: string;
+        view: CalendarView;
+        privacy: boolean;
+    }) => void;
+    /** An appointment's details docked for a new selection. Not raised when
+     *  details come back after an edit. */
+    onAppointmentDetailsOpen?: (event: {
+        eventId: string;
+        source: CalendarDetailsOpenSource;
+        view: CalendarView;
+    }) => void;
+    /** A rail preference was saved on this device. `resize` is raised only
+     *  with `persistPanelWidthKey`, since without it nothing is saved. */
+    onToolPreferencesChange?: (event: {
+        action: ControlRoomFavoriteChange['action'] | 'resize';
+        toolId: string;
+    }) => void;
+}
 export interface CalendarWorkspaceProps {
     /** Optional canonical read for every existing-appointment editor route.
      * The form waits for this response; failures/refusals expose no editable
@@ -131,6 +210,15 @@ export interface CalendarWorkspaceProps {
      *  it cannot show never marks the cog. */
     backlogFilters?: Readonly<Record<BacklogGap, boolean>>;
     onBacklogFiltersChange?: (filters: Readonly<Record<BacklogGap, boolean>>) => void;
+    /** Device key the rail saves pinned tools and their order under. Omit
+     *  it and the rail keeps its generic default, `ui.controlRoom.favorites`. */
+    persistFavoritesKey?: string;
+    /** Device key the rail saves the panel width under. Omit it and width
+     *  is not saved, as before. On-device only; nothing reaches a server. */
+    persistPanelWidthKey?: string;
+    /** Usage callbacks for the host's analytics. Omit it and nothing is
+     *  reported. */
+    analytics?: CalendarWorkspaceAnalytics;
 }
 /**
  * The cog's settings as the workspace opens with them: the remembered