@alfadocs/ui-kit 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/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/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.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

package/dist/patterns/calendar/calendar.journey.d.ts

@@ -179,6 +179,8 @@ export interface CalendarJourney {
     handleEditNote: (patientId: string, noteId: string, content: string) => void | Promise<void>;
     handleDeleteNote: (patientId: string, noteId: string) => void | Promise<void>;
     handleToggleNotePin: (patientId: string, noteId: string) => void | Promise<void>;
+    /** Flag or unflag a note. Omit it and the flag control is not offered. */
+    handleToggleNoteFlag?: (patientId: string, noteId: string) => void | Promise<void>;
     /** Read a patient's notes: the latest few, or every note. */
     handleLoadNotes?: (patientId: string, scope: 'preview' | 'all') => void;
     /**

package/dist/patterns/calendar/calendar.sheets.d.ts

@@ -73,6 +73,8 @@ export interface PatientNotesSeam {
     onEditNote: (noteId: string, content: string) => void | Promise<void>;
     onDeleteNote: (noteId: string) => void | Promise<void>;
     onTogglePin: (noteId: string) => void | Promise<void>;
+    /** Flag or unflag a note. Omitted → no flag control. */
+    onToggleFlag?: (noteId: string) => void | Promise<void>;
     /** The practice's own drafting endpoint. Omitted → no AI affordance. */
     onRequestAiDraft?: NotesPanelProps['onRequestAiDraft'];
     /** The host's live transcription. Omitted → no microphone. */

package/dist/patterns/calendar/calendar.surface.d.ts

@@ -1,8 +1,9 @@
+import { type CalendarView } from '../../components/calendar';
 import { type CalendarPreferenceAdapter } from './calendar.preferences';
 import { type CalendarRow, type RailFocus, type EditorPrefill, type HistoryInput, type AvailabilityContext, type CalendarFreeSlot } from './calendar.model';
 import { type WorkspaceDisplaySettings, type CreateModeRequest, type PlacementRequest, type SaveNotice, type CalendarWorkspaceToolId } from './calendar-workspace.model';
 import type { CalendarOccurrenceMove } from './calendar.journey';
-export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onComposeTask, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, onBookSlotFromFinder, display, setDisplay, onHistory, readOnly, reviewOnlyEventIds, detailsOnEveryClick, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, onMoveOccurrence, }: {
+export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onComposeTask, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, onBookSlotFromFinder, display, setDisplay, onHistory, readOnly, reviewOnlyEventIds, detailsOnEveryClick, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, onMoveOccurrence, onViewChange, onPeekOpen, }: {
     rows: CalendarRow[];
     setRows: React.Dispatch<React.SetStateAction<CalendarRow[]>>;
     onFocus: (focus: RailFocus) => void;
@@ -96,5 +97,9 @@ export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComp
     /** The host's series move (S-C8). With it, a recurring parent's move
      *  always confirms, asks the scope and hides the notify boxes. */
     onMoveOccurrence?: (move: CalendarOccurrenceMove) => Promise<void>;
+    /** The grid's view, on mount and on every change. Usage reporting only. */
+    onViewChange?: (view: CalendarView) => void;
+    /** An appointment's preview opened. Usage reporting only. */
+    onPeekOpen?: (eventId: string) => void;
 }): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=calendar.surface.d.ts.map

package/dist/patterns/calendar/index.d.ts

@@ -1,4 +1,4 @@
-export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, } from './calendar-workspace';
+export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, type CalendarWorkspaceAnalytics, type CalendarToolOpenSource, type CalendarDetailsOpenSource, } from './calendar-workspace';
 export { CalendarDataProvider, useCalendarData, type CalendarData, type DayLoadState, } from './calendar.data';
 export type { CalendarJourney, CalendarOccurrenceMove, PatientNotesLoad, } from './calendar.journey';
 export type { CalendarAppointmentEditorSnapshot, CalendarAppointmentEditorLoader, CalendarEditorSeries, } from './calendar-editor-hydration';

package/dist/patterns/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as s, a as r, b as E, c as P, D as S, d as o, S as C, V as t, W as d, e as A, i, m as n, r as D, u as W, f as _, g as c } from "../../_chunks/calendar-workspace-DDnQmiIL.js";
+import { C as s, a as r, b as E, c as P, D as S, d as o, S as C, V as t, W as d, e as A, i, m as n, r as D, u as W, f as _, g as c } from "../../_chunks/calendar-workspace-BmscntRR.js";
 export {
   s as CALENDAR_PREFERENCE_KEYS,
   r as CalendarDataProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit",
-  "version": "1.47.0",
+  "version": "1.47.1",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe.",
   "license": "BUSL-1.1",