@alfadocs/ui-kit-debug 1.30.0 → 1.31.0

package/dist/_chunks/{timeline-r-8IUoBS.js → timeline-u-2t9t_M.js}

@@ -130,10 +130,10 @@ const K = {
     layout: t = "rail-start",
     order: r = "newest-first",
     className: s,
-    children: i,
+    children: a,
     ...n
-  }, a) => {
-    const d = p(() => ({ layout: t, order: r }), [t, r]), o = w(null), [l, z] = V(null), h = w(null);
+  }, d) => {
+    const i = p(() => ({ layout: t, order: r }), [t, r]), o = w(null), [l, z] = V(null), h = w(null);
     h.current = l;
     const x = I((y) => {
       var T;
@@ -149,7 +149,7 @@ const K = {
       }),
       [x]
     );
-    return O(a, () => o.current, []), B(K, R, n.id), /* @__PURE__ */ e(v.Provider, { value: d, children: /* @__PURE__ */ e(
+    return O(d, () => o.current, []), B(K, R, n.id), /* @__PURE__ */ e(v.Provider, { value: i, children: /* @__PURE__ */ e(
       "ol",
       {
         ref: o,
@@ -158,37 +158,37 @@ const K = {
         "data-selected-event": l ?? void 0,
         className: U({ layout: t, order: r, className: s }),
         ...n,
-        children: i
+        children: a
       }
     ) });
   }
 );
 E.displayName = "Timeline";
 const S = m(
-  ({ type: t = "neutral", eventId: r, className: s, children: i, ...n }, a) => {
-    const { layout: d } = u(v), { t: o } = A(), l = p(() => ({ type: t }), [t]);
-    return d === "alternating" ? /* @__PURE__ */ e(g.Provider, { value: l, children: /* @__PURE__ */ c(
+  ({ type: t = "neutral", eventId: r, className: s, children: a, ...n }, d) => {
+    const { layout: i } = u(v), { t: o } = A(), l = p(() => ({ type: t }), [t]);
+    return i === "alternating" ? /* @__PURE__ */ e(g.Provider, { value: l, children: /* @__PURE__ */ c(
       "li",
       {
-        ref: a,
+        ref: d,
         "data-event-id": r,
         className: ["ds:contents", s].filter(Boolean).join(" "),
         ...n,
         children: [
           /* @__PURE__ */ e("span", { className: "ds:sr-only", children: o(`timeline.type.${t}`) }),
-          i
+          a
         ]
       }
     ) }) : /* @__PURE__ */ e(g.Provider, { value: l, children: /* @__PURE__ */ c(
       "li",
       {
-        ref: a,
+        ref: d,
         "data-event-id": r,
-        className: W({ layout: d, className: s }),
+        className: W({ layout: i, className: s }),
         ...n,
         children: [
           /* @__PURE__ */ e("span", { className: "ds:sr-only", children: o(`timeline.type.${t}`) }),
-          i
+          a
         ]
       }
     ) });
@@ -196,38 +196,38 @@ const S = m(
 );
 S.displayName = "Timeline.Event";
 const _ = m(
-  ({ icon: t, className: r, ...s }, i) => {
-    const { type: n } = u(g), { layout: a } = u(v), d = /* @__PURE__ */ e(
+  ({ icon: t, className: r, ...s }, a) => {
+    const { type: n } = u(g), { layout: d } = u(v), i = /* @__PURE__ */ e(
       "div",
       {
-        ref: i,
+        ref: a,
         "aria-hidden": "true",
         className: Y({ type: n, className: r }),
         ...s,
         children: t ?? X[n]
       }
     );
-    return a === "alternating" ? /* @__PURE__ */ c(
+    return d === "alternating" ? /* @__PURE__ */ c(
       "div",
       {
         "aria-hidden": "true",
         className: "ds:col-start-2 ds:flex ds:flex-col ds:items-center",
         children: [
           /* @__PURE__ */ e("div", { className: "ds:w-[var(--border-width-md)] ds:flex-1 ds:bg-[var(--border)] ds:first:hidden" }),
-          d,
+          i,
           /* @__PURE__ */ e("div", { className: "ds:w-[var(--border-width-md)] ds:flex-1 ds:bg-[var(--border)]" })
         ]
       }
-    ) : d;
+    ) : i;
   }
 );
 _.displayName = "Timeline.Dot";
 const j = m(
-  ({ title: t, description: r, actor: s, children: i, className: n, ...a }, d) => {
+  ({ title: t, description: r, actor: s, children: a, className: n, ...d }, i) => {
     const { layout: o } = u(v), l = /* @__PURE__ */ e(
       "div",
       {
-        ref: d,
+        ref: i,
         className: [
           "ds:flex-1 ds:min-w-0 ds:pb-[var(--spacing-md)]",
           // Wrap policy: `break-word` (not `anywhere`) preserves word-
@@ -240,7 +240,7 @@ const j = m(
           "ds:[&_*]:break-normal ds:[&_*]:[overflow-wrap:break-word]",
           n
         ].filter(Boolean).join(" "),
-        ...a,
+        ...d,
         children: /* @__PURE__ */ e(N, { variant: "outlined", children: /* @__PURE__ */ c(N.Body, { children: [
           /* @__PURE__ */ e("p", { className: "type-label ds:text-[var(--foreground)]", children: t }),
           r && /* @__PURE__ */ e("p", { className: "ds:mt-[var(--spacing-xs)] type-body-sm ds:text-[var(--muted-foreground)]", children: r }),
@@ -248,7 +248,7 @@ const j = m(
             /* @__PURE__ */ e(P, { size: "xs", name: s.name, src: s.src }),
             /* @__PURE__ */ e("span", { className: "type-meta ds:text-[var(--muted-foreground)]", children: s.name })
           ] }),
-          i
+          a
         ] }) })
       }
     );
@@ -259,24 +259,26 @@ j.displayName = "Timeline.Content";
 const G = 1440 * 60 * 1e3, k = m(
   ({
     date: t,
-    relative: r = !0,
-    format: s = { dateStyle: "medium", timeStyle: "short" },
-    className: i,
-    ...n
-  }, a) => /* @__PURE__ */ e(
+    locale: r,
+    relative: s = !0,
+    format: a = { dateStyle: "medium", timeStyle: "short" },
+    className: n,
+    ...d
+  }, i) => /* @__PURE__ */ e(
     q,
     {
-      ref: a,
+      ref: i,
       value: t,
-      format: r ? "relative" : "absolute",
-      relativeWindow: r ? G : void 0,
-      absoluteFormat: s,
+      locale: r,
+      format: s ? "relative" : "absolute",
+      relativeWindow: s ? G : void 0,
+      absoluteFormat: a,
       className: [
         "ds:text-[var(--muted-foreground)]",
         "ds:[font-variant-numeric:var(--font-feature-tabular)]",
-        i
+        n
       ].filter(Boolean).join(" "),
-      ...n
+      ...d
     }
   )
 );
@@ -291,4 +293,4 @@ export {
   le as T,
   K as t
 };
-//# sourceMappingURL=timeline-r-8IUoBS.js.map
+//# sourceMappingURL=timeline-u-2t9t_M.js.map

package/dist/_chunks/timeline-u-2t9t_M.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-u-2t9t_M.js","sources":["../../src/components/timeline/timeline.agent.ts","../../src/components/timeline/timeline.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — Timeline.                                              */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { TimelineHandle } from './timeline';\n\nexport const timelineAgent: AgentAdapter<TimelineHandle> = {\n  id: 'timeline',\n  // `select_event` persists `selectedEvent` state, so this is single-selection\n  // (`select_single`), not a transient `pick`. See PRS §26 §4.\n  capabilities: ['select_single'],\n  state: {\n    selectedEvent: {\n      type: 'string | null',\n      descriptionKey: 'ui.agent.timeline.state.selectedEvent',\n      description: 'Opaque event id of the currently-active event, or null.',\n      read: (handle) => handle.getSelectedEvent(),\n    },\n  },\n  actions: {\n    select_event: {\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.agent.timeline.actions.selectEvent',\n      description: 'Scroll the given event into view and mark it as selected.',\n      invoke: (handle, args: { id: string }) => {\n        handle.selectEvent(args.id);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'timeline',\n      description: 'Marks the Timeline root.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n    item: {\n      attr: 'data-event-id',\n      description:\n        'Opaque event id emitted on each Timeline.Event when the `eventId` prop is provided.',\n    },\n  },\n};\n","import {\n  createContext,\n  forwardRef,\n  useCallback,\n  useContext,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  type HTMLAttributes,\n  type LiHTMLAttributes,\n  type OlHTMLAttributes,\n  type ReactNode,\n  type TimeHTMLAttributes,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { TriangleAlert, Check, Circle, Info, X } from 'lucide-react';\nimport { Avatar } from '../avatar';\nimport { Card } from '../card';\nimport { Timestamp } from '../timestamp';\nimport { useAgentRegistration } from '../../agent/registry';\nimport { timelineAgent } from './timeline.agent';\n\n// TODO: optional @tanstack/react-virtual integration for 500+ events\n\n/* ------------------------------------------------------------------ */\n/* Context                                                             */\n/* ------------------------------------------------------------------ */\n\ntype EventType = 'info' | 'success' | 'warning' | 'error' | 'neutral';\ntype Layout = 'rail-start' | 'rail-end' | 'alternating';\n\ninterface TimelineContextValue {\n  layout: Layout;\n  order: 'newest-first' | 'oldest-first';\n}\n\nconst TimelineContext = createContext<TimelineContextValue>({\n  layout: 'rail-start',\n  order: 'newest-first',\n});\n\ninterface TimelineEventContextValue {\n  type: EventType;\n}\n\nconst TimelineEventContext = createContext<TimelineEventContextValue>({\n  type: 'neutral',\n});\n\n/* ------------------------------------------------------------------ */\n/* CVA — root                                                          */\n/* ------------------------------------------------------------------ */\n\nconst timelineVariants = cva('ds:flex ds:flex-col', {\n  variants: {\n    layout: {\n      'rail-start': 'ds:ps-4',\n      'rail-end': 'ds:pe-4',\n      alternating:\n        'ds:grid ds:grid-cols-[1fr_2rem_1fr] ds:gap-x-[var(--spacing-md)]',\n    },\n    order: {\n      'newest-first': 'ds:flex-col',\n      'oldest-first': 'ds:flex-col-reverse',\n    },\n  },\n  defaultVariants: { layout: 'rail-start', order: 'newest-first' },\n});\n\n/* ------------------------------------------------------------------ */\n/* CVA — event item                                                    */\n/* ------------------------------------------------------------------ */\n\nconst eventVariants = cva(\n  'ds:relative ds:flex ds:gap-[var(--spacing-md)] ds:pb-[var(--spacing-md)]',\n  {\n    variants: {\n      layout: {\n        'rail-start': [\n          'ds:flex-row',\n          // Rail: continuous border on the inline-start of the event list\n          'ds:before:absolute ds:before:top-8 ds:before:bottom-0',\n          'ds:before:border-inline-start-[2px] ds:before:border-[color:var(--border)]',\n          'ds:before:inset-inline-start-[-1rem]',\n          'ds:last:before:hidden',\n        ].join(' '),\n        'rail-end': [\n          'ds:flex-row-reverse',\n          'ds:before:absolute ds:before:top-8 ds:before:bottom-0',\n          'ds:before:border-inline-end-[2px] ds:before:border-[color:var(--border)]',\n          'ds:before:inset-inline-end-[-1rem]',\n          'ds:last:before:hidden',\n        ].join(' '),\n        alternating: 'ds:contents',\n      },\n    },\n    defaultVariants: { layout: 'rail-start' },\n  },\n);\n\n/* ------------------------------------------------------------------ */\n/* CVA — dot                                                           */\n/* ------------------------------------------------------------------ */\n\nconst dotVariants = cva(\n  [\n    'ds:relative ds:z-10 ds:flex ds:items-center ds:justify-center',\n    'ds:rounded-[var(--radius-full)] ds:shrink-0',\n    'ds:size-8',\n    'ds:ring-2 ds:ring-[var(--background)]',\n  ].join(' '),\n  {\n    variants: {\n      type: {\n        info: 'ds:bg-[var(--info)] ds:text-[var(--info-solid-foreground)]',\n        success:\n          'ds:bg-[var(--success)] ds:text-[var(--success-solid-foreground)]',\n        warning:\n          'ds:bg-[var(--warning)] ds:text-[var(--warning-solid-foreground)]',\n        error:\n          'ds:bg-[var(--destructive)] ds:text-[var(--destructive-foreground)]',\n        neutral: 'ds:bg-[var(--muted)] ds:text-[var(--muted-foreground)]',\n      },\n    },\n    defaultVariants: { type: 'neutral' },\n  },\n);\n\n/* ------------------------------------------------------------------ */\n/* Types                                                               */\n/* ------------------------------------------------------------------ */\n\nexport interface TimelineProps\n  extends\n    Omit<OlHTMLAttributes<HTMLOListElement>, 'color'>,\n    VariantProps<typeof timelineVariants> {\n  layout?: Layout;\n  order?: 'newest-first' | 'oldest-first';\n  children: ReactNode;\n  className?: string;\n}\n\nexport interface TimelineEventProps extends LiHTMLAttributes<HTMLLIElement> {\n  type?: EventType;\n  /** Opaque event id — when set, the component emits `data-event-id` for agent addressing. */\n  eventId?: string;\n  children: ReactNode;\n  className?: string;\n}\n\n/** Curated imperative handle for agent / external automation. */\nexport interface TimelineHandle {\n  getSelectedEvent: () => string | null;\n  selectEvent: (id: string) => void;\n}\n\nexport interface TimelineDotProps extends HTMLAttributes<HTMLDivElement> {\n  icon?: ReactNode;\n  className?: string;\n}\n\nexport interface TimelineContentProps extends HTMLAttributes<HTMLDivElement> {\n  title: string;\n  description?: string;\n  actor?: { name: string; src?: string };\n  children?: ReactNode;\n  className?: string;\n}\n\nexport interface TimelineTimestampProps extends TimeHTMLAttributes<HTMLTimeElement> {\n  date: Date | string;\n  /** Overrides the active language for date and time formatting. */\n  locale?: string;\n  relative?: boolean;\n  format?: Intl.DateTimeFormatOptions;\n  className?: string;\n}\n\n/* ------------------------------------------------------------------ */\n/* Default icons per type                                              */\n/* ------------------------------------------------------------------ */\n\nconst TYPE_ICONS: Record<EventType, ReactNode> = {\n  info: <Info size={16} aria-hidden=\"true\" />,\n  success: <Check size={16} aria-hidden=\"true\" />,\n  warning: <TriangleAlert size={16} aria-hidden=\"true\" />,\n  error: <X size={16} aria-hidden=\"true\" />,\n  neutral: <Circle size={16} aria-hidden=\"true\" />,\n};\n\n/* ------------------------------------------------------------------ */\n/* Timeline root                                                       */\n/* ------------------------------------------------------------------ */\n\nconst TimelineRoot = forwardRef<HTMLOListElement, TimelineProps>(\n  (\n    {\n      layout = 'rail-start',\n      order = 'newest-first',\n      className,\n      children,\n      ...props\n    },\n    ref,\n  ) => {\n    const ctx = useMemo(() => ({ layout, order }), [layout, order]);\n    const olRef = useRef<HTMLOListElement | null>(null);\n    const [selectedEvent, setSelectedEvent] = useState<string | null>(null);\n    const latestRef = useRef<string | null>(null);\n    latestRef.current = selectedEvent;\n\n    const selectEvent = useCallback((id: string) => {\n      setSelectedEvent(id);\n      const target = olRef.current?.querySelector(\n        `[data-event-id=\"${id}\"]`,\n      ) as HTMLElement | null;\n      target?.scrollIntoView({ block: 'center', behavior: 'auto' });\n    }, []);\n\n    const agentHandle = useMemo<TimelineHandle>(\n      () => ({\n        getSelectedEvent: () => latestRef.current,\n        selectEvent,\n      }),\n      [selectEvent],\n    );\n    useImperativeHandle(ref, () => olRef.current as HTMLOListElement, []);\n    useAgentRegistration(timelineAgent, agentHandle, props.id);\n\n    return (\n      <TimelineContext.Provider value={ctx}>\n        <ol\n          ref={olRef}\n          data-component=\"timeline\"\n          data-component-id={props.id}\n          data-selected-event={selectedEvent ?? undefined}\n          className={timelineVariants({ layout, order, className })}\n          {...props}\n        >\n          {children}\n        </ol>\n      </TimelineContext.Provider>\n    );\n  },\n);\nTimelineRoot.displayName = 'Timeline';\n\n/* ------------------------------------------------------------------ */\n/* Timeline.Event                                                      */\n/* ------------------------------------------------------------------ */\n\nconst TimelineEvent = forwardRef<HTMLLIElement, TimelineEventProps>(\n  ({ type = 'neutral', eventId, className, children, ...props }, ref) => {\n    const { layout } = useContext(TimelineContext);\n    const { t } = useTranslation();\n\n    const evtCtx = useMemo(() => ({ type }), [type]);\n\n    if (layout === 'alternating') {\n      // In alternating layout the <li> uses `contents` so its children\n      // participate directly in the parent grid.\n      return (\n        <TimelineEventContext.Provider value={evtCtx}>\n          <li\n            ref={ref}\n            data-event-id={eventId}\n            className={['ds:contents', className].filter(Boolean).join(' ')}\n            {...props}\n          >\n            {/* Visually-hidden type prefix for screen readers */}\n            <span className=\"ds:sr-only\">{t(`timeline.type.${type}`)}</span>\n            {children}\n          </li>\n        </TimelineEventContext.Provider>\n      );\n    }\n\n    return (\n      <TimelineEventContext.Provider value={evtCtx}>\n        <li\n          ref={ref}\n          data-event-id={eventId}\n          className={eventVariants({ layout, className })}\n          {...props}\n        >\n          {/* Visually-hidden type prefix for screen readers */}\n          <span className=\"ds:sr-only\">{t(`timeline.type.${type}`)}</span>\n          {children}\n        </li>\n      </TimelineEventContext.Provider>\n    );\n  },\n);\nTimelineEvent.displayName = 'Timeline.Event';\n\n/* ------------------------------------------------------------------ */\n/* Timeline.Dot                                                        */\n/* ------------------------------------------------------------------ */\n\nconst TimelineDot = forwardRef<HTMLDivElement, TimelineDotProps>(\n  ({ icon, className, ...props }, ref) => {\n    const { type } = useContext(TimelineEventContext);\n    const { layout } = useContext(TimelineContext);\n\n    const dot = (\n      <div\n        ref={ref}\n        aria-hidden=\"true\"\n        className={dotVariants({ type, className })}\n        {...props}\n      >\n        {icon ?? TYPE_ICONS[type]}\n      </div>\n    );\n\n    if (layout === 'alternating') {\n      // In alternating grid: col 2 (centre) for the dot with the rail line\n      return (\n        <div\n          aria-hidden=\"true\"\n          className=\"ds:col-start-2 ds:flex ds:flex-col ds:items-center\"\n        >\n          {/* Rail segment above the dot */}\n          <div className=\"ds:w-[var(--border-width-md)] ds:flex-1 ds:bg-[var(--border)] ds:first:hidden\" />\n          {dot}\n          {/* Rail segment below the dot */}\n          <div className=\"ds:w-[var(--border-width-md)] ds:flex-1 ds:bg-[var(--border)]\" />\n        </div>\n      );\n    }\n\n    return dot;\n  },\n);\nTimelineDot.displayName = 'Timeline.Dot';\n\n/* ------------------------------------------------------------------ */\n/* Timeline.Content                                                    */\n/* ------------------------------------------------------------------ */\n\nconst TimelineContent = forwardRef<HTMLDivElement, TimelineContentProps>(\n  ({ title, description, actor, children, className, ...props }, ref) => {\n    const { layout } = useContext(TimelineContext);\n\n    const inner = (\n      <div\n        ref={ref}\n        className={[\n          'ds:flex-1 ds:min-w-0 ds:pb-[var(--spacing-md)]',\n          // Wrap policy: `break-word` (not `anywhere`) preserves word-\n          // boundary wrapping for natural-language titles / descriptions;\n          // only genuinely unbreakable strings (URLs, hashes) break mid-\n          // word when they would otherwise overflow. `anywhere` introduces\n          // a soft-wrap opportunity at every character boundary, which\n          // chopped Italian / German labels mid-word when an event card\n          // sat in a narrow context.\n          'ds:[&_*]:break-normal ds:[&_*]:[overflow-wrap:break-word]',\n          className,\n        ]\n          .filter(Boolean)\n          .join(' ')}\n        {...props}\n      >\n        <Card variant=\"outlined\">\n          <Card.Body>\n            <p className=\"type-label ds:text-[var(--foreground)]\">{title}</p>\n            {description && (\n              <p className=\"ds:mt-[var(--spacing-xs)] type-body-sm ds:text-[var(--muted-foreground)]\">\n                {description}\n              </p>\n            )}\n            {actor && (\n              <div className=\"ds:mt-[var(--spacing-sm)] ds:flex ds:items-center ds:gap-[var(--spacing-xs)]\">\n                <Avatar size=\"xs\" name={actor.name} src={actor.src} />\n                <span className=\"type-meta ds:text-[var(--muted-foreground)]\">\n                  {actor.name}\n                </span>\n              </div>\n            )}\n            {children}\n          </Card.Body>\n        </Card>\n      </div>\n    );\n\n    if (layout === 'alternating') {\n      // Alternating: odd events in col 1 (start), even events in col 3 (end).\n      // We use CSS nth-child targeting via a wrapper that sets col placement.\n      return (\n        <div className=\"ds:col-span-1 ds:[li:nth-child(even)_&]:col-start-3 ds:[li:nth-child(odd)_&]:col-start-1\">\n          {inner}\n        </div>\n      );\n    }\n\n    return inner;\n  },\n);\nTimelineContent.displayName = 'Timeline.Content';\n\n/* ------------------------------------------------------------------ */\n/* Timeline.Timestamp — thin wrapper over the shared Timestamp         */\n/* component. Keeps the existing API (`date`, `relative`, `format`)    */\n/* for backward compatibility; adds tabular-nums because timeline      */\n/* timestamps sit in a rail gutter and benefit from column-aligned     */\n/* digits.                                                              */\n/* ------------------------------------------------------------------ */\n\nconst TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;\n\nconst TimelineTimestamp = forwardRef<HTMLTimeElement, TimelineTimestampProps>(\n  (\n    {\n      date,\n      locale,\n      relative = true,\n      format = { dateStyle: 'medium', timeStyle: 'short' },\n      className,\n      ...props\n    },\n    ref,\n  ) => (\n    <Timestamp\n      ref={ref}\n      value={date}\n      locale={locale}\n      format={relative ? 'relative' : 'absolute'}\n      relativeWindow={relative ? TWENTY_FOUR_HOURS_MS : undefined}\n      absoluteFormat={format}\n      className={[\n        'ds:text-[var(--muted-foreground)]',\n        'ds:[font-variant-numeric:var(--font-feature-tabular)]',\n        className,\n      ]\n        .filter(Boolean)\n        .join(' ')}\n      {...props}\n    />\n  ),\n);\nTimelineTimestamp.displayName = 'Timeline.Timestamp';\n\n/* ------------------------------------------------------------------ */\n/* Compound export                                                     */\n/* ------------------------------------------------------------------ */\n\nexport const Timeline = Object.assign(TimelineRoot, {\n  Event: TimelineEvent,\n  Dot: TimelineDot,\n  Content: TimelineContent,\n  Timestamp: TimelineTimestamp,\n});\n"],"names":["timelineAgent","handle","args","TimelineContext","createContext","TimelineEventContext","timelineVariants","cva","eventVariants","dotVariants","TYPE_ICONS","jsx","Info","Check","TriangleAlert","X","Circle","TimelineRoot","forwardRef","layout","order","className","children","props","ref","ctx","useMemo","olRef","useRef","selectedEvent","setSelectedEvent","useState","latestRef","selectEvent","useCallback","id","target","_a","agentHandle","useImperativeHandle","useAgentRegistration","TimelineEvent","type","eventId","useContext","t","useTranslation","evtCtx","jsxs","TimelineDot","icon","dot","TimelineContent","title","description","actor","inner","Card","Avatar","TWENTY_FOUR_HOURS_MS","TimelineTimestamp","date","locale","relative","format","Timestamp","Timeline"],"mappings":"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"}

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.30.0",
+  "packageVersion": "1.31.0",
   "components": [
     {
       "kind": "component",
@@ -1592,7 +1592,7 @@
         },
         "item": {
           "attr": "data-event-id",
-          "description": "Emitted on every rendered FullCalendar event by the kit event renderer. Used by focusEvent. Cards also carry data-kind=\"task\"|\"draft\"|\"appointment\" and data-status for classification."
+          "description": "Emitted on every rendered FullCalendar event by the kit event renderer. Used by focusEvent. Cards also carry data-kind=\"task\"|\"draft\"|\"pending-details\"|\"appointment\" and data-status for classification."
         }
       }
     },
@@ -7673,7 +7673,7 @@
             ]
           },
           "idempotent": false,
-          "description": "Toggle the pinned state of the note with the given id.",
+          "description": "Toggle the pinned state of the note with the given id. Refused for a deleted note or one whose actions.pin is false.",
           "descriptionKey": "ui.agent.notesPanel.actions.togglePin"
         },
         {
@@ -16876,6 +16876,14 @@
           "component": "radio-group",
           "as": "deleteScope"
         },
+        {
+          "component": "radio-group",
+          "as": "seriesScope"
+        },
+        {
+          "component": "button",
+          "as": "seriesScopeChange"
+        },
         {
           "component": "dropdown-menu",
           "as": "signatureMenu"
@@ -17026,7 +17034,7 @@
         {
           "name": "dock_tool",
           "safety": "read",
-          "description": "Open one of the rail's tools — Appointments, the appointment editor / details panel, the waiting list, the online bookings or the free-slot finder — or read which one is docked. A host declares which of the five it can back with real data, so read the strip rather than assuming all five: a tool the host withheld is absent, and anything routed at it docks Appointments instead. Closing returns to the Appointments panel rather than collapsing the rail, so no path leaves an empty dock. Docking moves no focus; a polite live region announces the panel that arrived.",
+          "description": "Open a workspace rail tool: Appointments, appointment editor / details, waiting list, patient notes, online bookings or free-slot finder. Read the actual strip: hosts may withhold tools, and patient-notes is registered only with patient context. Notes uses the host's note permissions, independently of appointment-edit rights. Clearing its patient context returns to the previous available tool and focuses its rail button. Opening notes from a panel may address a note id and moves focus into Notes. Closing other tools returns to Appointments.",
           "descriptionKey": "ui.agent.calendar.workflows.dockTool",
           "uiActions": [
             "control-room-rail.open",
@@ -17057,6 +17065,21 @@
             "appointment.list"
           ]
         },
+        {
+          "name": "read_appointment_details",
+          "safety": "phi",
+          "description": "Read one appointment in the docked details panel. With the host's details read, any card click, including a patient-less block and a chip whose names are still loading, focuses the appointment and docks a read-only panel: appointment, booking, money, contact, treatments, signing and series sections, the patient's latest three notes and a History sub-view. See more or a note opens the separate Notes rail tool when the host offers it. While the read is loading, failed or refused the panel shows that status instead. Edit, withheld from a read-only viewer, opens the editor. Without the host's read a pending chip stays inert and the editor form is the details. Reads patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.readAppointmentDetails",
+          "uiActions": [
+            "calendar.focus_event"
+          ],
+          "stateReads": [
+            "control-room-rail.activeToolId"
+          ],
+          "apiActions": [
+            "appointment.read"
+          ]
+        },
         {
           "name": "create_appointment",
           "safety": "phi",
@@ -17086,13 +17109,14 @@
             "control-room-rail.activeToolId"
           ],
           "apiActions": [
+            "patient.search",
             "appointment.create"
           ]
         },
         {
           "name": "edit_appointment",
           "safety": "phi",
-          "description": "Amend an existing appointment. Clicking its card docks the SAME panel in details mode — the identity strip, the prefilled form, the read-only extras and the History sub-view — so there is one editing paradigm and no separate Edit jump. Change any field and save; for a member of a repeating series the save asks how far it reaches. On save the rail returns to the Appointments panel and a toast names the day, carrying a \"Go to\" action when that day is off screen, on a hidden weekend or filtered out. Writes patient-identifiable data.",
+          "description": "Amend an existing appointment in the docked editor. With the host's details read the editor opens from Edit on the details panel and Cancel or Save returns there; without it the details panel is the form. A remote host first loads canonical data; loading, failure and whole-appointment refusal expose no editable form. When that data carries a series, the editor first asks the scope: this occurrence, this and following, or the whole series. Honour the returned patient, care, description and recurrence capabilities. A refused recurring scope cannot be treated as an ordinary edit. Save waits for host acceptance before closing or announcing success; rejection preserves the entered draft for correction or retry. Writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.editAppointment",
           "uiActions": [
             "calendar.focus_event",
@@ -17114,6 +17138,8 @@
             "calendar.currentDate"
           ],
           "apiActions": [
+            "appointment.read",
+            "patient.search",
             "appointment.update",
             "appointmentSeries.applyScope"
           ]
@@ -17137,7 +17163,7 @@
         {
           "name": "move_appointment",
           "safety": "phi",
-          "description": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels (kept even when the appointment recurs, where the platform drops them) and, for a series member, the recurring scope. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
+          "description": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels and, for a series member, the recurring scope. A host recurring parent always confirms, asks the scope and hides the notify channels, as the platform does. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.moveAppointment",
           "uiActions": [
             "calendar.focus_event",
@@ -17219,7 +17245,7 @@
         {
           "name": "manage_patient_notes",
           "safety": "phi",
-          "description": "Read and write the patient's notes from the Notes sub-view beside History: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author — the kit attributes nothing to a clinical note. With no host seam, or without the edit permission, the sub-view is a read-only timeline. The rows carry ids and pin / flag / clinical markers only; the body and the author are never exposed as state. Writes patient-identifiable clinical data.",
+          "description": "Read and write the patient's notes from the conditional Notes rail tool: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author. The kit attributes nothing to a clinical note. An HTML note edits in a rich text editor and saves as HTML; a clinical or deleted note offers no edit. With no host seam, or when the host's seam is not writable, the tool is a read-only timeline. Explicit note permissions take precedence over appointment-edit permission. Details and the editor have no Notes sub-view. The rows carry ids and pin / flag / clinical markers only; the body and author are never exposed as state. Writes patient-identifiable clinical data.",
           "descriptionKey": "ui.agent.calendar.workflows.managePatientNotes",
           "uiActions": [
             "notes-panel.add_note",
@@ -17227,7 +17253,8 @@
             "dialog.open",
             "dialog.close",
             "dialog.dismiss",
-            "text-area.set_value"
+            "text-area.set_value",
+            "rich-text-editor.set_content"
           ],
           "stateReads": [
             "notes-panel.notes",
@@ -17273,6 +17300,20 @@
             "signature.request"
           ]
         },
+        {
+          "name": "create_document",
+          "safety": "phi",
+          "description": "Open the appointment details create menu through data-action=\"open-create-document\" and select an offered data-action=\"create-document-<kind>\" item: bill, folder, template, empty, identification or webcam. The host supplies permitted kinds and owns navigation, confirmation and persistence. Appointment read-only mode does not withhold document rights. A selection starts the host workflow; it does not prove that a document or bill was created. May write patient-identifiable data.",
+          "descriptionKey": "ui.agent.calendar.workflows.createDocument",
+          "uiActions": [
+            "dropdown-menu.open",
+            "dropdown-menu.close"
+          ],
+          "stateReads": [
+            "dropdown-menu.isOpen"
+          ],
+          "apiActions": []
+        },
         {
           "name": "message_patient_whatsapp",
           "safety": "phi",
@@ -17348,7 +17389,7 @@
         {
           "name": "find_free_slot",
           "safety": "read",
-          "description": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Read-only until a slot is booked.",
+          "description": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; when the viewer may write appointments, a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care; read-only viewers see the list and projection only, under a lock note, with no Book. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Projected bands open a modal list of original options by click, Enter or Space; only an explicit Book action uses the finder booking path. Read-only viewers can scroll those options without Book. Dismissal restores focus to the band.",
           "descriptionKey": "ui.agent.calendar.workflows.findFreeSlot",
           "uiActions": [
             "collapsible.toggle",
@@ -17376,7 +17417,7 @@
         {
           "name": "triage_online_booking",
           "safety": "phi",
-          "description": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
+          "description": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. Completing writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.triageOnlineBooking",
           "uiActions": [
             "calendar.focus_event",

package/dist/agent-i18n/en.json

@@ -170,24 +170,26 @@
         "filterColumns": "Narrow the grid to particular chairs or operators from the two filter popovers, with the platform's semantics: nothing ticked shows everyone and ticking narrows. Operators list under their groups with a tri-state row per group; \"Only available operators\" is on by default in the operator views, and a session-local \"Show disabled operators\" switch reveals the operators the practice has disabled. A count badge rides each filter button while it narrows, and the \"Reset filters\" chip beside them clears both selections and restores both switches without ever changing the view. Selection only — no appointment is touched.",
         "maskPatientNames": "Turn privacy mode on or off from the toolbar. While on, patient names are masked on the cards, in the hover peek, in the Appointments panel and on the printed call sheet, so the page can stay open beside a waiting patient. It is a display mask, not a permission: it is not persisted and it changes no record.",
         "configureDisplay": "Set the per-user display knobs in the cog popover — layout, zebra rows, show times, slot precision, the day window, the care-description mode, what the cards are coloured by, the default duration of a new appointment (5–240 minutes), whether operators read as an initials disc or a dot plus full name, whether chairs read as a full name or a short code, and whether the details panel offers the map link. The choices are remembered per user through the host's preferences adapter under `calendarWorkspace.*` keys, so they persist beyond the page load; they change presentation only and touch no patient record.",
-        "dockTool": "Open one of the rail's tools — Appointments, the appointment editor / details panel, the waiting list, the online bookings or the free-slot finder — or read which one is docked. A host declares which of the five it can back with real data, so read the strip rather than assuming all five: a tool the host withheld is absent, and anything routed at it docks Appointments instead. Closing returns to the Appointments panel rather than collapsing the rail, so no path leaves an empty dock. Docking moves no focus; a polite live region announces the panel that arrived.",
+        "dockTool": "Open a workspace rail tool: Appointments, appointment editor / details, waiting list, patient notes, online bookings or free-slot finder. Read the actual strip: hosts may withhold tools, and patient-notes is registered only with patient context. Notes uses the host's note permissions, independently of appointment-edit rights. Clearing its patient context returns to the previous available tool and focuses its rail button. Opening notes from a panel may address a note id and moves focus into Notes. Closing other tools returns to Appointments.",
         "reviewUpcoming": "Read the rail's resting panel: the practice's upcoming appointments — now to the end of the seventh day, cancelled excluded, earliest first — each row led by the patient. The preset row, the jump-to-date picker and the edge loaders widen the derived window up to ±180 days. Activating a row selects that appointment on the grid, which docks its details. Read-only; the rows carry ids and lifecycle state, never patient identity.",
+        "readAppointmentDetails": "Read one appointment in the docked details panel. With the host's details read, any card click, including a patient-less block and a chip whose names are still loading, focuses the appointment and docks a read-only panel: appointment, booking, money, contact, treatments, signing and series sections, the patient's latest three notes and a History sub-view. See more or a note opens the separate Notes rail tool when the host offers it. While the read is loading, failed or refused the panel shows that status instead. Edit, withheld from a read-only viewer, opens the editor. Without the host's read a pending chip stays inert and the editor form is the details. Reads patient-identifiable data.",
         "createAppointment": "Book a new appointment in the editor panel, docked from the New appointment button, from a click on an empty slot (prefilled with the slot, the clicked column and the cog's default duration) or from an online booking being processed. Set the patient, the linked care or care-plan lines, the date, start time and duration, the operator, chair, branch and colour, the description (255 characters at most — a longer one blocks the save), and, once a patient is chosen, the SMS and e-mail reminders, the first-visit question and — where the patient has unsigned required documents — how they are asked to sign. Busy chair, busy operator and operator-away warnings are advisory and do not hold the save; only a practice closure does. Enter submits from any text field. Writes patient-identifiable data.",
-        "editAppointment": "Amend an existing appointment. Clicking its card docks the SAME panel in details mode — the identity strip, the prefilled form, the read-only extras and the History sub-view — so there is one editing paradigm and no separate Edit jump. Change any field and save; for a member of a repeating series the save asks how far it reaches. On save the rail returns to the Appointments panel and a toast names the day, carrying a \"Go to\" action when that day is off screen, on a hidden weekend or filtered out. Writes patient-identifiable data.",
+        "editAppointment": "Amend an existing appointment in the docked editor. With the host's details read the editor opens from Edit on the details panel and Cancel or Save returns there; without it the details panel is the form. A remote host first loads canonical data; loading, failure and whole-appointment refusal expose no editable form. When that data carries a series, the editor first asks the scope: this occurrence, this and following, or the whole series. Honour the returned patient, care, description and recurrence capabilities. A refused recurring scope cannot be treated as an ordinary edit. Save waits for host acceptance before closing or announcing success; rejection preserves the entered draft for correction or retry. Writes patient-identifiable data.",
         "changeAppointmentStatus": "Set an appointment's attendance status from the Status select in the details panel. The status is patient-identifiable attendance data.",
-        "moveAppointment": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels (kept even when the appointment recurs, where the platform drops them) and, for a series member, the recurring scope. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
+        "moveAppointment": "Reschedule an appointment either by dragging its card to a new slot or by arming \"Move…\" in the details panel and then clicking the target slot — the panel stays docked and a banner tinted with the appointment's own colour names what is being placed. Either route ends in the confirmation dialog, which offers the SMS and e-mail notify channels and, for a series member, the recurring scope. A host recurring parent always confirms, asks the scope and hides the notify channels, as the platform does. Cancelling reverts the card and commits nothing. Writes patient-identifiable data.",
         "resizeAppointment": "Change an appointment's duration by dragging its card edge. Unlike a move this SAVES AT ONCE with no confirmation, exactly as the platform does; the toast that follows carries an Undo that restores the previous duration and logs both changes on the appointment's history. Writes patient-identifiable data.",
         "copyAppointment": "Duplicate an appointment onto another slot: arm \"Copy…\" in the details panel, then click the target. The copy lands immediately with no confirmation, and its toast carries an Undo. A plan-linked appointment first asks whether to copy the appointment only or the appointment and its treatments. Writes patient-identifiable data.",
         "deleteAppointment": "Remove an appointment from the details panel behind an alert dialog. The dialog asks for the recurring scope when the appointment belongs to a series, and for the care-plan cleanup when it is the parent of a price-list recurrence — so confirming can drop far more than the one card. Irreversible from this surface.",
-        "managePatientNotes": "Read and write the patient's notes from the Notes sub-view beside History: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author — the kit attributes nothing to a clinical note. With no host seam, or without the edit permission, the sub-view is a read-only timeline. The rows carry ids and pin / flag / clinical markers only; the body and the author are never exposed as state. Writes patient-identifiable clinical data.",
+        "managePatientNotes": "Read and write the patient's notes from the conditional Notes rail tool: add a note through the composer, pin one, edit one in a dialog or delete one behind an alert dialog. Every write goes to the host, which stamps the note's id, time and author. The kit attributes nothing to a clinical note. An HTML note edits in a rich text editor and saves as HTML; a clinical or deleted note offers no edit. With no host seam, or when the host's seam is not writable, the tool is a read-only timeline. Explicit note permissions take precedence over appointment-edit permission. Details and the editor have no Notes sub-view. The rows carry ids and pin / flag / clinical markers only; the body and author are never exposed as state. Writes patient-identifiable clinical data.",
         "readModificationHistory": "Open the History sub-view of the details panel and read the appointment's modification ledger, newest first — what changed, from what to what, and when. No mutation.",
         "requestSignature": "Ask the patient to sign the appointment's documents from the details panel, by SMS or e-mail through the kit menu. The chip beside it reports the channel a request has already gone out on. There is no \"On this device…\" item: on-device signing is the host's own e-signature surface and no seam here mounts it, so the menu offers only the two channels it can honour. Sends a patient-identifiable request.",
+        "createDocument": "Open the appointment details create menu through data-action=\"open-create-document\" and select an offered data-action=\"create-document-<kind>\" item: bill, folder, template, empty, identification or webcam. The host supplies permitted kinds and owns navigation, confirmation and persistence. Appointment read-only mode does not withhold document rights. A selection starts the host workflow; it does not prove that a document or bill was created. May write patient-identifiable data.",
         "messagePatientWhatsapp": "Reach the patient over WhatsApp from a waiting-list row. The affordance is a `wa.me` deep link the row opens in a new tab — it is disabled, and names its reason in its accessible name, when the entry carries no WhatsApp-capable number. There is no equivalent in the details panel: the send-reminder group is handed an empty channel list, because the host's legacy Snippets island is the only composing surface and no seam here mounts it. Hands a patient's contact detail to an outbound channel.",
         "filterWaitingList": "Narrow the waiting queue: the four quick views (all, patients without an appointment, appointment scheduled over 30 days ago, on the list over 30 days) and, behind \"Show advanced filters\", the platform's nine optional client-side inputs — patient, patient assigned, operator, appointment scheduled, appointment scheduled from / to, on the waiting list from / to and description — applied only when \"Filter list\" is pressed. The toggle carries a count badge while any input is set, and changing the quick view drops the form. Selection only.",
         "manageWaitingListEntry": "Add, amend or remove a waiting-list entry. The four-field form opens as a rail SUB-VIEW — from the toolbar split button's plus segment, from Add entry, or from a row's pencil — with a back arrow to the queue. Editing is refused on a row already linked to an appointment, because those fields belong to the appointment; the pencil stays focusable and names that reason. Remove deletes at once with no confirmation, platform parity, and its toast carries an Undo that puts the entry back. Writes patient-identifiable data.",
         "scheduleWaitingPatient": "Give a waiting patient a slot. \"Schedule\" on an unlinked row hands off to the free-slot finder seeded from the entry — operator, chair, duration, patient, care and colour already filled in — and booking a slot opens the editor carrying the entry, so saving books the appointment and takes the entry off the list. A row already linked to an appointment reads \"Reschedule\" and seeds the same finder, but booking there MOVES the existing appointment rather than creating a second one. Writes patient-identifiable data.",
-        "findFreeSlot": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Read-only until a slot is booked.",
-        "triageOnlineBooking": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
+        "findFreeSlot": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; when the viewer may write appointments, a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care; read-only viewers see the list and projection only, under a lock note, with no Book. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Projected bands open a modal list of original options by click, Enter or Space; only an explicit Book action uses the finder booking path. Read-only viewers can scroll those options without Book. Dismissal restores focus to the band.",
+        "triageOnlineBooking": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. Completing writes patient-identifiable data.",
         "printDaySheet": "Print the front-desk call sheet. The toolbar's printer icon opens a dialog asking which day — one day, never the visible range — and Print renders that day's appointments through the browser, scoped by the filters in force and masked when privacy mode is on. Nothing is sent to a server, but the sheet itself is a patient-identifiable document."
       }
     },
@@ -800,7 +802,7 @@
       },
       "actions": {
         "addNote": "Compose and commit a new note. A clinical note requires the clinical-note permission (read canAddClinical first).",
-        "togglePin": "Toggle the pinned state of the note with the given id.",
+        "togglePin": "Toggle the pinned state of the note with the given id. Refused for a deleted note or one whose actions.pin is false.",
         "toggleFlag": "Toggle the flagged state of the note with the given id."
       }
     },

package/dist/components/_shared/get-error-message.d.ts

@@ -0,0 +1,3 @@
+/** Read host error messages without relying on the host's JavaScript realm. */
+export declare function getErrorMessage(error: unknown, fallback: string): string;
+//# sourceMappingURL=get-error-message.d.ts.map

package/dist/components/_shared/get-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-message.d.ts","sourceRoot":"","sources":["../../../src/components/_shared/get-error-message.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWxE"}

package/dist/components/address-fields/index.js

@@ -1,4 +1,4 @@
-import { A as e, a } from "../../_chunks/address-fields-CZ0pEdEI.js";
+import { A as e, a } from "../../_chunks/address-fields-jFfjxOQR.js";
 export {
   e as AddressFields,
   a as addressFieldsAgent

package/dist/components/appointment-card/appointment-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment-card.d.ts","sourceRoot":"","sources":["../../../src/components/appointment-card/appointment-card.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"appointment-card.d.ts","sourceRoot":"","sources":["../../../src/components/appointment-card/appointment-card.tsx"],"names":[],"mappings":"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"}

package/dist/components/appointment-card/index.js

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-Dzr3GeVz.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-4FUu_5NX.js";
+import { A as p } from "../../_chunks/appointment-card-CvUFFEdS.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-Z2GaOIYQ.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   p as AppointmentCard,

package/dist/components/appointment-timeline/index.js

@@ -1,4 +1,4 @@
-import { A as i, a as t } from "../../_chunks/appointment-timeline-DhHwmHo1.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-DsMZY7U9.js";
 export {
   i as AppointmentTimeline,
   t as appointmentTimelineAgent

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-AabCk7CI.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-jGzRUETo.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/calendar/calendar.d.ts

@@ -60,7 +60,7 @@ export interface CalendarEvent {
      * own: use `isRecurring` for the grid indicator.
      */
     isRecurrenceParent?: boolean;
-    /** Rendered as a background event; not clickable. */
+    /** Background event; interactive only with onBackgroundEventClick. */
     isInternal?: boolean;
     /**
      * Renders the card as a TASK rather than an appointment — calendar-scheduled
@@ -79,13 +79,24 @@ export interface CalendarEvent {
      * filling.
      */
     isDraft?: boolean;
+    /**
+     * A REAL booked appointment whose details the host is still fetching —
+     * an occupancy-first host draws the block from the slot it occupies
+     * (colour, time, chair) and fills the name in afterwards. Renders the
+     * card's details-pending treatment (`data-kind="pending-details"`). A
+     * click is delivered and the host decides what it opens; the hover
+     * callback and drag stay refused, so a block nobody can name yet is never
+     * previewed or moved. Distinct from the pattern's `isPendingBooking` (an
+     * online booking still missing a patient or an operator).
+     */
+    detailsPending?: boolean;
     /**
      * Per-event master switch for drag AND resize. Overrides the
      * calendar-level `editable` for this event only (true enables even when
      * the calendar is not editable; false disables both gestures).
      * Leave undefined to inherit the calendar-level setting.
      * Precedence: per-event `startEditable` > per-event `editable` >
-     * calendar-level `editable`. Background events (`isInternal: true`)
+     * calendar-level `editable`. Background and details-pending events
      * are never draggable regardless.
      */
     editable?: boolean;
@@ -297,6 +308,9 @@ export interface CalendarProps {
      * caveat. Existing one-argument handlers keep working unchanged.
      */
     onEventClick?: (event: CalendarEvent, meta?: CalendarEventClickMeta) => void;
+    /** Opt in to keyboard-accessible titled background buttons. The anchor
+     * follows CalendarEventClickMeta's lifetime rules; no booking is implied. */
+    onBackgroundEventClick?: (event: CalendarEvent, meta: CalendarEventClickMeta) => void;
     /**
      * Fires when the pointer enters an event's rendered surface — the anchor
      * seam for hover "peek" cards. Skipped for background events
@@ -409,6 +423,16 @@ export interface CalendarProps {
      * Omitted / empty array shows all seven days.
      */
     hiddenDays?: number[];
+    /**
+     * Local ISO `YYYY-MM-DD` dates whose rows the host has NOT finished
+     * loading: every cell of such a day wears the loading wash and carries
+     * `aria-busy`, and its date header gains a visually-hidden "still
+     * loading" word, so a half-drawn day is never read as an empty one. A
+     * date left out of the list is one the host says is fully loaded; an
+     * omitted prop says every rendered day is. The workspace pattern
+     * derives it from `CalendarData.dayLoadState`.
+     */
+    loadingDates?: readonly string[];
     /** Lower bound of the time axis (e.g. '07:00'). */
     slotMinTime?: string;
     /** Upper bound of the time axis (e.g. '23:00'). */