@alfadocs/ui-kit 1.35.0 → 1.36.0

package/dist/_chunks/workflow-status-xeaJTzD3.js

@@ -0,0 +1,476 @@
+import { jsxs as i, jsx as s, Fragment as se } from "react/jsx-runtime";
+import { forwardRef as I, useId as re, useRef as ae, useCallback as te, useMemo as oe, useImperativeHandle as ne } from "react";
+import { c as f } from "./index-D2ZczOXr.js";
+import { useTranslation as L } from "react-i18next";
+import { u as de } from "./registry-DvAUVLHh.js";
+import { u as ie } from "./use-controllable-state-BiY4xTzM.js";
+import { a as N } from "./input-surface-xyERuLU_.js";
+import { D as p } from "./dropdown-menu-DU-Hrf33.js";
+import { C as T } from "./circle-alert-rGDZ73Wh.js";
+import { L as le } from "./loader-circle-BECIU_8N.js";
+import { C as ce } from "./chevron-down-DWE7GSq9.js";
+const ue = {
+  id: "workflow-status",
+  capabilities: ["select_single", "set_value", "open", "close"],
+  state: {
+    value: {
+      type: "string",
+      descriptionKey: "ui.agent.workflowStatus.state.value",
+      description: "The current non-sensitive workflow status key.",
+      read: (r) => r.getValue()
+    },
+    isOpen: {
+      type: "boolean",
+      descriptionKey: "ui.agent.workflowStatus.state.isOpen",
+      description: "Whether the permitted workflow status list is open.",
+      read: (r) => r.getIsOpen()
+    },
+    isSaving: {
+      type: "boolean",
+      descriptionKey: "ui.agent.workflowStatus.state.isSaving",
+      description: "Whether the host is saving a workflow status change.",
+      read: (r) => r.getIsSaving()
+    }
+  },
+  actions: {
+    set_value: {
+      safety: "write",
+      argsType: "{ value: string }",
+      argsSchema: {
+        type: "object",
+        properties: {
+          value: {
+            type: "string",
+            description: "Permitted workflow status key to select."
+          }
+        },
+        required: ["value"]
+      },
+      idempotent: !0,
+      openWorld: !1,
+      errors: [
+        "The status is not in the host-provided transition list.",
+        "The status is disabled.",
+        "A status change is already being saved."
+      ],
+      examples: [{ args: { value: "review" } }],
+      descriptionKey: "ui.agent.workflowStatus.actions.setValue",
+      description: "Request a permitted workflow status through the host-owned change callback.",
+      invoke: (r, a) => r.setValue(a.value)
+    },
+    open: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.agent.workflowStatus.actions.open",
+      description: "Open the permitted workflow status list.",
+      invoke: (r) => r.open()
+    },
+    close: {
+      safety: "read",
+      idempotent: !0,
+      descriptionKey: "ui.agent.workflowStatus.actions.close",
+      description: "Close the workflow status list.",
+      invoke: (r) => r.close()
+    }
+  },
+  domHooks: {
+    root: {
+      attr: "data-component",
+      value: "workflow-status",
+      description: "Marks the WorkflowStatus boundary."
+    },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop."
+    },
+    item: {
+      attr: "data-option-id",
+      description: "Non-sensitive workflow status key for a permitted option."
+    }
+  }
+}, O = f(
+  "ds:inline-flex ds:max-w-full ds:flex-col ds:items-start ds:gap-[var(--spacing-2xs)]",
+  {
+    variants: {
+      size: {
+        sm: "",
+        md: "",
+        lg: ""
+      }
+    },
+    defaultVariants: { size: "md" }
+  }
+), R = f(
+  [
+    "ds:group/workflow-status ds:inline-grid ds:max-w-full ds:w-fit ds:items-center",
+    "ds:overflow-hidden ds:text-start",
+    "ds:rounded-[var(--radius-md)] ds:border ds:border-border",
+    "ds:bg-transparent ds:text-foreground",
+    "ds:transition-colors ds:duration-[var(--animation-duration)]",
+    "ds:motion-reduce:transition-none",
+    "ds:forced-colors:border-[ButtonBorder]"
+  ].join(" "),
+  {
+    variants: {
+      size: {
+        sm: `${N.sm} ds:gap-[var(--spacing-xs)] ds:ps-[var(--spacing-2xs)] ds:pe-[var(--spacing-sm)]`,
+        md: `${N.md} ds:gap-[var(--spacing-sm)] ds:ps-[var(--spacing-2xs)] ds:pe-[var(--spacing-sm)]`,
+        lg: `${N.lg} ds:gap-[var(--spacing-sm)] ds:ps-[var(--spacing-xs)] ds:pe-[var(--spacing-md)]`
+      },
+      interactive: {
+        true: [
+          "ds:grid-cols-[auto_minmax(0,1fr)_auto] ds:appearance-none ds:cursor-pointer",
+          "ds:hover:enabled:bg-muted/10 ds:active:enabled:bg-muted/20",
+          "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid",
+          "ds:focus-visible:outline-[color:var(--ring)] ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+          "ds:forced-colors:focus-visible:outline-[CanvasText]",
+          "ds:data-[open]:bg-muted/20 ds:data-[open]:border-[color:var(--primary)]",
+          "ds:forced-colors:data-[open]:border-[Highlight]"
+        ].join(" "),
+        false: "ds:grid-cols-[auto_minmax(0,1fr)] ds:cursor-default"
+      },
+      operation: {
+        idle: "",
+        disabled: "ds:cursor-not-allowed ds:opacity-50",
+        saving: "ds:cursor-wait ds:border-[color:var(--info-foreground)]",
+        error: "ds:border-[color:var(--error-foreground)]"
+      }
+    },
+    defaultVariants: {
+      size: "md",
+      interactive: !1,
+      operation: "idle"
+    }
+  }
+), B = f(
+  [
+    "ds:inline-flex ds:shrink-0 ds:items-center ds:justify-center",
+    "ds:rounded-[var(--radius-full)] ds:border ds:[&>svg]:block",
+    "ds:forced-colors:bg-transparent ds:forced-colors:border-[CanvasText]"
+  ].join(" "),
+  {
+    variants: {
+      tone: {
+        neutral: "ds:bg-muted ds:text-muted-foreground ds:border-[color:var(--border)]",
+        info: "ds:bg-info/15 ds:text-[color:var(--info-foreground)] ds:border-[color:var(--info-foreground)]",
+        success: "ds:bg-success/15 ds:text-[color:var(--success-foreground)] ds:border-[color:var(--success-foreground)]",
+        warning: "ds:bg-warning/15 ds:text-[color:var(--warning-foreground)] ds:border-[color:var(--warning-foreground)]",
+        error: "ds:bg-destructive/15 ds:text-[color:var(--error-foreground)] ds:border-[color:var(--error-foreground)]",
+        accent: "ds:bg-[color:color-mix(in_srgb,var(--accent)_15%,transparent)] ds:text-[color:color-mix(in_srgb,var(--accent)_40%,var(--foreground))] ds:border-[color:color-mix(in_srgb,var(--accent)_40%,var(--foreground))]"
+      },
+      /* The ball is a SETTING for the glyph, not a container it fills: at
+         the old 24px/16px the icon took two thirds of the circle and the two
+         read as one crowded blob. Each step is smaller overall and gives the
+         glyph roughly half its diameter, so the ring stays legible as a ring
+         and the status colour has room to register. */
+      size: {
+        sm: "ds:size-5 ds:[&>svg]:size-3",
+        md: "ds:size-[var(--spacing-lg)] ds:[&>svg]:size-3.5",
+        lg: "ds:size-7 ds:[&>svg]:size-[var(--icon-size-sm)]",
+        menu: "ds:size-5 ds:[&>svg]:size-3"
+      }
+    },
+    defaultVariants: { tone: "neutral", size: "md" }
+  }
+), fe = f(
+  "ds:flex ds:min-w-0 ds:flex-col ds:justify-center ds:text-start",
+  {
+    variants: {
+      size: {
+        sm: "ds:gap-0",
+        md: "ds:gap-0",
+        lg: "ds:gap-0"
+      }
+    },
+    defaultVariants: { size: "md" }
+  }
+), pe = f(
+  "ds:block ds:min-w-0 ds:truncate ds:font-[var(--font-weight-semibold)] ds:text-[color:var(--foreground)]",
+  {
+    variants: {
+      size: {
+        sm: "type-body-sm",
+        md: "type-label",
+        lg: "type-body"
+      }
+    },
+    defaultVariants: { size: "md" }
+  }
+), me = f(
+  [
+    "ds:inline-flex ds:self-stretch ds:items-center ds:justify-center",
+    "ds:gap-[var(--spacing-2xs)] ds:border-s ds:border-border",
+    "ds:text-[color:var(--muted-foreground)]",
+    "ds:forced-colors:border-[ButtonBorder]"
+  ].join(" "),
+  {
+    variants: {
+      size: {
+        sm: "ds:ps-[var(--spacing-xs)]",
+        md: "ds:ps-[var(--spacing-sm)]",
+        lg: "ds:ps-[var(--spacing-md)]"
+      }
+    },
+    defaultVariants: { size: "md" }
+  }
+), ge = f(
+  [
+    "ds:flex ds:max-w-full ds:items-start ds:gap-[var(--spacing-xs)]",
+    "type-meta ds:text-[color:var(--error-foreground)]",
+    "ds:[&>svg]:mt-[var(--spacing-2xs)] ds:[&>svg]:size-[var(--spacing-md)] ds:[&>svg]:shrink-0",
+    "ds:forced-colors:text-[CanvasText]"
+  ].join(" ")
+);
+function A({
+  option: r,
+  workflowLabel: a,
+  size: t = "md",
+  interactive: n,
+  operation: l = "idle",
+  error: c
+}) {
+  return /* @__PURE__ */ i(se, { children: [
+    /* @__PURE__ */ s(
+      "span",
+      {
+        "aria-hidden": "true",
+        "data-workflow-status-icon": "",
+        "data-tone": r.tone,
+        className: B({ tone: r.tone, size: t }),
+        children: r.icon
+      }
+    ),
+    /* @__PURE__ */ i("span", { className: fe({ size: t }), children: [
+      t !== "sm" ? /* @__PURE__ */ s("span", { className: "type-meta ds:font-[var(--font-weight-medium)] ds:text-[color:var(--muted-foreground)]", children: a }) : null,
+      /* @__PURE__ */ s(
+        "span",
+        {
+          "data-workflow-status-value": "",
+          title: r.label,
+          className: pe({ size: t }),
+          children: r.label
+        }
+      )
+    ] }),
+    n ? /* @__PURE__ */ i("span", { className: me({ size: t }), "aria-hidden": "true", children: [
+      c ? /* @__PURE__ */ s(
+        T,
+        {
+          "data-testid": "workflow-status-error-icon",
+          className: "ds:size-[var(--spacing-md)] ds:shrink-0"
+        }
+      ) : null,
+      l === "saving" ? /* @__PURE__ */ s(le, { className: "ds:size-[var(--spacing-md)] ds:shrink-0 ds:animate-spin ds:motion-reduce:animate-none" }) : /* @__PURE__ */ s(
+        ce,
+        {
+          "data-testid": "workflow-status-chevron",
+          className: "ds:size-[var(--spacing-md)] ds:shrink-0 ds:transition-transform ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none ds:group-data-[open]/workflow-status:rotate-180"
+        }
+      )
+    ] }) : null
+  ] });
+}
+const ve = I(function({ value: a, option: t, size: n = "md", workflowLabel: l, id: c, className: o, dir: h }, v) {
+  const { t: k } = L(), x = l ?? k("workflowStatus.label", "Workflow");
+  return /* @__PURE__ */ s(
+    "div",
+    {
+      ref: v,
+      id: c,
+      dir: h,
+      "data-component": "workflow-status",
+      "data-component-id": c,
+      "data-state": a,
+      "data-variant": "display",
+      className: O({ size: n, className: o }),
+      children: /* @__PURE__ */ s("div", { className: R({ size: n, interactive: !1 }), children: /* @__PURE__ */ s(
+        A,
+        {
+          option: t,
+          workflowLabel: x,
+          size: n,
+          interactive: !1,
+          error: !1
+        }
+      ) })
+    }
+  );
+});
+ve.displayName = "WorkflowStatusDisplay";
+const we = I(function({
+  value: a,
+  options: t,
+  onValueChange: n,
+  size: l = "md",
+  disabled: c = !1,
+  saving: o = !1,
+  error: h = !1,
+  errorMessage: v,
+  workflowLabel: k,
+  menuLabel: x,
+  savingLabel: D,
+  open: E,
+  defaultOpen: K = !1,
+  onOpenChange: $,
+  id: u,
+  className: H,
+  dir: V,
+  "aria-label": M,
+  "aria-describedby": q
+}, F) {
+  const { t: m } = L(), G = re(), z = ae(null), y = t.find((e) => e.value === a);
+  if (!y)
+    throw new Error(
+      `WorkflowStatusControl requires an option matching value "${a}".`
+    );
+  const P = k ?? m("workflowStatus.label", "Workflow"), U = x ?? m("workflowStatus.menuLabel", "Workflow statuses"), J = D ?? m("workflowStatus.saving", "Saving workflow status"), Q = v ?? m(
+    "workflowStatus.saveFailed",
+    "Could not change workflow status. The previous status is still shown."
+  ), X = M ?? m("workflowStatus.changeLabel", "Change workflow status: {{status}}", {
+    status: y.label
+  }), g = h || !!v, d = c || o, W = u ? `${u}-error` : G, Y = [q, g ? W : void 0].filter(Boolean).join(" ") || void 0, _ = o ? "saving" : c ? "disabled" : g ? "error" : "idle", [Z, w] = ie({
+    value: E,
+    defaultValue: K,
+    onChange: $
+  }), b = !!Z && !d, S = te(
+    (e) => {
+      if (d || e === a) return;
+      const j = t.find((ee) => ee.value === e);
+      if (!(!j || j.disabled))
+        return n(e);
+    },
+    [d, n, t, a]
+  ), C = oe(
+    () => ({
+      getValue: () => a,
+      getIsOpen: () => b,
+      getIsSaving: () => o,
+      setValue: S,
+      open: () => {
+        d || w(!0);
+      },
+      close: () => w(!1),
+      focus: () => {
+        var e;
+        return (e = z.current) == null ? void 0 : e.focus();
+      }
+    }),
+    [S, d, b, o, w, a]
+  );
+  return ne(F, () => C, [C]), de(ue, C, u), /* @__PURE__ */ i(
+    "div",
+    {
+      id: u,
+      dir: V,
+      "data-component": "workflow-status",
+      "data-component-id": u,
+      "data-state": a,
+      "data-variant": "control",
+      "data-saving": o ? "" : void 0,
+      "data-error": g ? "" : void 0,
+      className: O({ size: l, className: H }),
+      children: [
+        /* @__PURE__ */ i(
+          p.Root,
+          {
+            dir: V,
+            open: b,
+            onOpenChange: (e) => {
+              e && d || w(e);
+            },
+            children: [
+              /* @__PURE__ */ s(p.Trigger, { asChild: !0, children: /* @__PURE__ */ s(
+                "button",
+                {
+                  ref: z,
+                  id: u ? `${u}-trigger` : void 0,
+                  type: "button",
+                  disabled: d,
+                  "aria-label": X,
+                  "aria-describedby": Y,
+                  "aria-busy": o,
+                  "data-open": b ? "" : void 0,
+                  className: R({
+                    size: l,
+                    interactive: !0,
+                    operation: _
+                  }),
+                  children: /* @__PURE__ */ s(
+                    A,
+                    {
+                      option: y,
+                      workflowLabel: P,
+                      size: l,
+                      interactive: !0,
+                      operation: _,
+                      error: g
+                    }
+                  )
+                }
+              ) }),
+              /* @__PURE__ */ i(p.Content, { align: "start", children: [
+                /* @__PURE__ */ s(p.Label, { children: U }),
+                /* @__PURE__ */ s(
+                  p.RadioGroup,
+                  {
+                    value: a,
+                    onValueChange: (e) => {
+                      S(e);
+                    },
+                    children: t.map((e) => /* @__PURE__ */ s(
+                      p.RadioItem,
+                      {
+                        value: e.value,
+                        disabled: d || e.disabled,
+                        "data-option-id": e.value,
+                        children: /* @__PURE__ */ i("span", { className: "ds:flex ds:min-w-0 ds:items-center ds:gap-[var(--spacing-sm)]", children: [
+                          /* @__PURE__ */ s(
+                            "span",
+                            {
+                              "aria-hidden": "true",
+                              "data-workflow-status-icon": "",
+                              "data-tone": e.tone,
+                              className: B({
+                                tone: e.tone,
+                                size: "menu"
+                              }),
+                              children: e.icon
+                            }
+                          ),
+                          /* @__PURE__ */ s("span", { className: "ds:min-w-0 ds:truncate", title: e.label, children: e.label })
+                        ] })
+                      },
+                      e.value
+                    ))
+                  }
+                )
+              ] })
+            ]
+          }
+        ),
+        /* @__PURE__ */ s(
+          "span",
+          {
+            role: "status",
+            "aria-live": "polite",
+            "aria-atomic": "true",
+            className: "ds:sr-only",
+            children: o ? J : ""
+          }
+        ),
+        g ? /* @__PURE__ */ i("div", { id: W, role: "alert", className: ge(), children: [
+          /* @__PURE__ */ s(T, { "aria-hidden": "true" }),
+          /* @__PURE__ */ s("span", { children: Q })
+        ] }) : null
+      ]
+    }
+  );
+});
+we.displayName = "WorkflowStatusControl";
+export {
+  we as W,
+  ve as a,
+  ue as w
+};
+//# sourceMappingURL=workflow-status-xeaJTzD3.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.35.0",
+  "packageVersion": "1.36.0",
   "components": [
     {
       "kind": "component",
@@ -6228,6 +6228,49 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "hover-card",
+      "capabilities": [
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the hover card is currently open.",
+          "descriptionKey": "ui.agent.hoverCard.state.isOpen"
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Open the hover card without moving focus into it.",
+          "descriptionKey": "ui.agent.hoverCard.actions.open"
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Close the hover card.",
+          "descriptionKey": "ui.agent.hoverCard.actions.close"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "hover-card"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on HoverCard.Root."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "iban-input",
@@ -7610,6 +7653,38 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "note-timeline",
+      "capabilities": [],
+      "state": [
+        {
+          "name": "notes",
+          "type": "Array<{ id?: string; pinned: boolean; flagged: boolean; clinical: boolean }>",
+          "description": "Structural snapshot of the rendered rows: ids and flags only, never note content or author.",
+          "descriptionKey": "ui.agent.noteTimeline.state.notes"
+        },
+        {
+          "name": "visibleCount",
+          "type": "number",
+          "description": "How many notes are rendered, after the maxItems cap is applied.",
+          "descriptionKey": "ui.agent.noteTimeline.state.visibleCount"
+        }
+      ],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "note-timeline",
+          "description": "Marks the NoteTimeline root. Emits data-empty when there is nothing to show."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop — addresses a specific timeline."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "notes-panel",
@@ -11892,6 +11967,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "section-card",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "section-card",
+          "description": "Marks the element as a kit SectionCard."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "select",
@@ -15450,6 +15539,101 @@
           "description": "Stable opaque workflow node id emitted on each step."
         }
       }
+    },
+    {
+      "kind": "component",
+      "id": "workflow-status",
+      "capabilities": [
+        "select_single",
+        "set_value",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "The current non-sensitive workflow status key.",
+          "descriptionKey": "ui.agent.workflowStatus.state.value"
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the permitted workflow status list is open.",
+          "descriptionKey": "ui.agent.workflowStatus.state.isOpen"
+        },
+        {
+          "name": "isSaving",
+          "type": "boolean",
+          "description": "Whether the host is saving a workflow status change.",
+          "descriptionKey": "ui.agent.workflowStatus.state.isSaving"
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string",
+                "description": "Permitted workflow status key to select."
+              }
+            },
+            "required": [
+              "value"
+            ]
+          },
+          "idempotent": true,
+          "openWorld": false,
+          "errors": [
+            "The status is not in the host-provided transition list.",
+            "The status is disabled.",
+            "A status change is already being saved."
+          ],
+          "examples": [
+            {
+              "args": {
+                "value": "review"
+              }
+            }
+          ],
+          "description": "Request a permitted workflow status through the host-owned change callback.",
+          "descriptionKey": "ui.agent.workflowStatus.actions.setValue"
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Open the permitted workflow status list.",
+          "descriptionKey": "ui.agent.workflowStatus.actions.open"
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Close the workflow status list.",
+          "descriptionKey": "ui.agent.workflowStatus.actions.close"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "workflow-status",
+          "description": "Marks the WorkflowStatus boundary."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Non-sensitive workflow status key for a permitted option."
+        }
+      }
     }
   ],
   "patterns": [