@alfadocs/ui-kit 1.55.0 → 1.56.0

package/dist/_chunks/{stat-51CDL4au.js → stat-DmjGfXND.js}

@@ -1,8 +1,8 @@
-import { jsxs as z, jsx as i } from "react/jsx-runtime";
-import { forwardRef as X, useId as Z, useCallback as O, useRef as tt, useMemo as et } from "react";
+import { jsxs as b, jsx as l } from "react/jsx-runtime";
+import { forwardRef as Z, useId as tt, useCallback as O, useRef as et, useMemo as rt } from "react";
 import { c as V } from "./index-D2ZczOXr.js";
 import { useTranslation as B } from "react-i18next";
-import { u as rt } from "./use-count-up-BLLetaZ8.js";
+import { u as st } from "./use-count-up-BLLetaZ8.js";
 const P = V("ds:flex ds:flex-col ds:h-full", {
   variants: {
     variant: {
@@ -106,180 +106,188 @@ const P = V("ds:flex ds:flex-col ds:h-full", {
     variant: "default",
     intent: "foreground"
   }
-}), st = V(
+}), at = V(
   "ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)] type-label",
   {
     variants: {
-      trend: {
-        up: "ds:text-[var(--success)]",
-        down: "ds:text-[var(--destructive)]",
-        flat: "ds:text-[var(--muted-foreground)]"
+      // Whether the change is good news, not which way it went: with
+      // `trendPolarity="lower-is-better"` a fall is `better`.
+      tone: {
+        better: "ds:text-[var(--success)]",
+        worse: "ds:text-[var(--destructive)]",
+        neutral: "ds:text-[var(--muted-foreground)]"
       }
     },
     defaultVariants: {
-      trend: "flat"
+      tone: "neutral"
     }
   }
-), at = { up: "↑", down: "↓", flat: "→" }, nt = {
+), nt = { up: "↑", down: "↓", flat: "→" }, it = {
   up: "stat.trend.up",
   down: "stat.trend.down",
   flat: "stat.trend.flat"
 };
-function it({
-  trend: d,
+function dt({
+  trend: a,
   delta: t,
-  deltaFormat: c = "decimal",
-  locale: a
+  deltaFormat: u = "decimal",
+  locale: n,
+  polarity: e = "higher-is-better"
 }) {
-  const { t: e, i18n: o } = B("ui"), l = typeof t == "string" ? t : new Intl.NumberFormat(a ?? o.language, {
-    style: c === "percent" ? "percent" : "decimal"
-  }).format(c === "percent" ? t / 100 : t);
-  return /* @__PURE__ */ z("span", { className: st({ trend: d }), children: [
-    /* @__PURE__ */ i("span", { "aria-hidden": "true", children: at[d] }),
-    /* @__PURE__ */ i("span", { className: "ds:sr-only", children: e(nt[d]) }),
-    l
+  const { t: i, i18n: m } = B("ui"), d = typeof t == "string" ? t : new Intl.NumberFormat(n ?? m.language, {
+    style: u === "percent" ? "percent" : "decimal"
+  }).format(u === "percent" ? t / 100 : t), r = a === "flat" ? "neutral" : a === "up" == (e === "higher-is-better") ? "better" : "worse";
+  return /* @__PURE__ */ b("span", { className: at({ tone: r }), "data-trend-tone": r, children: [
+    /* @__PURE__ */ l("span", { "aria-hidden": "true", children: nt[a] }),
+    /* @__PURE__ */ l("span", { className: "ds:sr-only", children: i(it[a]) }),
+    d,
+    r === "neutral" ? null : /* @__PURE__ */ b("span", { className: "ds:sr-only", children: [
+      " ",
+      i(r === "better" ? "stat.trend.better" : "stat.trend.worse")
+    ] })
   ] });
 }
-function dt(d, t) {
-  const c = d.trim();
-  if (c === "") return null;
-  let a = "", e = c;
-  e.startsWith("+") ? (a = "+", e = e.slice(1).trimStart()) : (e.startsWith("-") || e.startsWith("−")) && (a = "-", e = e.slice(1).trimStart());
-  let o = "";
-  const l = e.match(/[KMB]$/i);
-  l && (o = l[0], e = e.slice(0, -1).trimEnd());
-  let u = "", m = ".";
+function ot(a, t) {
+  const u = a.trim();
+  if (u === "") return null;
+  let n = "", e = u;
+  e.startsWith("+") ? (n = "+", e = e.slice(1).trimStart()) : (e.startsWith("-") || e.startsWith("−")) && (n = "-", e = e.slice(1).trimStart());
+  let i = "";
+  const m = e.match(/[KMB]$/i);
+  m && (i = m[0], e = e.slice(0, -1).trimEnd());
+  let d = "", r = ".";
   try {
-    const b = new Intl.NumberFormat(t).formatToParts(12345.6);
-    for (const n of b)
-      n.type === "group" ? u = n.value : n.type === "decimal" && (m = n.value);
+    const h = new Intl.NumberFormat(t).formatToParts(12345.6);
+    for (const c of h)
+      c.type === "group" ? d = c.value : c.type === "decimal" && (r = c.value);
   } catch {
   }
   const g = e.match(/^(\d+)\.(\d+)$/);
-  if (g && !(g[2].length === 3 && u === ".")) {
-    const n = Number.parseFloat(e);
-    if (Number.isFinite(n))
-      return { target: n, sign: a, suffix: o };
+  if (g && !(g[2].length === 3 && d === ".")) {
+    const c = Number.parseFloat(e);
+    if (Number.isFinite(c))
+      return { target: c, sign: n, suffix: i };
   }
-  let r = e;
-  u !== "" && (r = r.split(u).join("")), m !== "." && (r = r.split(m).join(".")), r = r.replace(/[\s\u00A0\u202F]/g, "");
-  const v = Number.parseFloat(r);
-  return Number.isFinite(v) ? { target: v, sign: a, suffix: o } : null;
+  let o = e;
+  d !== "" && (o = o.split(d).join("")), r !== "." && (o = o.split(r).join(".")), o = o.replace(/[\s\u00A0\u202F]/g, "");
+  const f = Number.parseFloat(o);
+  return Number.isFinite(f) ? { target: f, sign: n, suffix: i } : null;
 }
-const ct = X(
+const ct = Z(
   ({
-    label: d,
+    label: a,
     value: t,
-    format: c,
-    currency: a,
+    format: u,
+    currency: n,
     locale: e,
-    trend: o,
-    delta: l,
-    deltaFormat: u = "decimal",
-    icon: m,
-    loading: g = !1,
-    animate: r = !1,
-    animateOnEveryView: v = !1,
-    animateDurationMs: b = 1600,
-    animateLocale: n,
-    animateSeparators: h,
-    variant: x = "default",
-    size: y = "md",
+    trend: i,
+    trendPolarity: m,
+    delta: d,
+    deltaFormat: r = "decimal",
+    icon: g,
+    loading: o = !1,
+    animate: f = !1,
+    animateOnEveryView: h = !1,
+    animateDurationMs: c = 1600,
+    animateLocale: K,
+    animateSeparators: x,
+    variant: y = "default",
+    size: N = "md",
     align: I = "start",
     intent: M = "foreground",
     className: j,
     ...k
   }, R) => {
-    const { i18n: K } = B("ui"), T = Z(), f = e ?? K.language, Y = O(() => {
+    const { i18n: Y } = B("ui"), T = tt(), p = e ?? Y.language, _ = O(() => {
       if (typeof t == "string") return t;
-      switch (c) {
+      switch (u) {
         case "currency":
-          return new Intl.NumberFormat(f, {
+          return new Intl.NumberFormat(p, {
             style: "currency",
-            currency: a ?? "USD"
+            currency: n ?? "USD"
           }).format(t);
         case "percent":
-          return new Intl.NumberFormat(f, { style: "percent" }).format(
+          return new Intl.NumberFormat(p, { style: "percent" }).format(
             t
           );
         case "decimal":
-          return new Intl.NumberFormat(f, { style: "decimal" }).format(
+          return new Intl.NumberFormat(p, { style: "decimal" }).format(
             t
           );
         default:
-          return new Intl.NumberFormat(f).format(t);
+          return new Intl.NumberFormat(p).format(t);
       }
-    }, [t, c, f, a])(), N = n ?? f;
-    tt(!1);
-    const s = et(() => r ? typeof t == "number" ? Number.isFinite(t) ? { target: t, sign: "", suffix: "" } : null : dt(t, N) : null, [r, t, N]), _ = r && s !== null, q = (s == null ? void 0 : s.target) ?? 0, F = (s == null ? void 0 : s.sign) ?? "", $ = (s == null ? void 0 : s.suffix) ?? "", H = O(
-      (w) => {
+    }, [t, u, p, n])(), w = K ?? p;
+    et(!1);
+    const s = rt(() => f ? typeof t == "number" ? Number.isFinite(t) ? { target: t, sign: "", suffix: "" } : null : ot(t, w) : null, [f, t, w]), q = f && s !== null, H = (s == null ? void 0 : s.target) ?? 0, F = (s == null ? void 0 : s.sign) ?? "", $ = (s == null ? void 0 : s.suffix) ?? "", J = O(
+      (z) => {
         const E = (() => {
           try {
-            return new Intl.NumberFormat(N, {
+            return new Intl.NumberFormat(w, {
               useGrouping: !0
             });
           } catch {
             return null;
           }
         })();
-        let p;
+        let v;
         if (E)
-          if (h) {
-            const A = Math.abs(w), D = Math.trunc(A), G = A - D, J = h.thousand ?? "", S = String(D).replace(
+          if (x) {
+            const A = Math.abs(z), D = Math.trunc(A), G = A - D, Q = x.thousand ?? "", S = String(D).replace(
               /\B(?=(\d{3})+(?!\d))/g,
-              J
+              Q
             );
             if (G === 0)
-              p = S;
+              v = S;
             else {
-              const L = G.toFixed(6).replace(/0+$/, "").slice(2), Q = h.decimal ?? ".";
-              p = L ? S + Q + L : S;
+              const L = G.toFixed(6).replace(/0+$/, "").slice(2), X = x.decimal ?? ".";
+              v = L ? S + X + L : S;
             }
           } else
-            p = E.format(Math.abs(w));
+            v = E.format(Math.abs(z));
         else
-          p = String(Math.abs(w));
+          v = String(Math.abs(z));
         let W = F;
-        return F === "" && w < 0 && (W = "-"), `${W}${p}${$}`;
+        return F === "" && z < 0 && (W = "-"), `${W}${v}${$}`;
       },
-      [N, h, F, $]
-    ), C = rt({
-      to: q,
+      [w, x, F, $]
+    ), C = st({
+      to: H,
       from: 0,
-      durationMs: b,
+      durationMs: c,
       startOnVisible: !0,
-      retriggerOnReEntry: v,
+      retriggerOnReEntry: h,
       // `formatter` is the only path we use — it owns both the locale
       // formatting and the sign/suffix re-application.
-      formatter: H
+      formatter: J
     });
-    return g ? /* @__PURE__ */ z(
+    return o ? /* @__PURE__ */ b(
       "div",
       {
         ref: R,
         role: "group",
         "aria-busy": "true",
-        "aria-label": d,
+        "aria-label": a,
         "data-component": "stat",
-        className: P({ variant: x, size: y, align: I, className: j }),
+        className: P({ variant: y, size: N, align: I, className: j }),
         ...k,
         children: [
-          /* @__PURE__ */ i("div", { className: "ds:h-[var(--skeleton-label-h)] ds:w-[var(--skeleton-label-w)] ds:animate-pulse ds:rounded-[var(--radius-sm)] ds:bg-[var(--muted)]" }),
-          /* @__PURE__ */ i("div", { className: "ds:h-[var(--skeleton-value-h)] ds:w-[var(--skeleton-value-w)] ds:animate-pulse ds:rounded-[var(--radius-sm)] ds:bg-[var(--muted)]" })
+          /* @__PURE__ */ l("div", { className: "ds:h-[var(--skeleton-label-h)] ds:w-[var(--skeleton-label-w)] ds:animate-pulse ds:rounded-[var(--radius-sm)] ds:bg-[var(--muted)]" }),
+          /* @__PURE__ */ l("div", { className: "ds:h-[var(--skeleton-value-h)] ds:w-[var(--skeleton-value-w)] ds:animate-pulse ds:rounded-[var(--radius-sm)] ds:bg-[var(--muted)]" })
         ]
       }
-    ) : /* @__PURE__ */ z(
+    ) : /* @__PURE__ */ b(
       "div",
       {
         ref: R,
         role: "group",
         "aria-labelledby": T,
         "data-component": "stat",
-        className: P({ variant: x, size: y, align: I, className: j }),
+        className: P({ variant: y, size: N, align: I, className: j }),
         ...k,
         children: [
-          /* @__PURE__ */ z("span", { className: "ds:inline-flex ds:items-center", children: [
-            m && /* @__PURE__ */ i(
+          /* @__PURE__ */ b("span", { className: "ds:inline-flex ds:items-center", children: [
+            g && /* @__PURE__ */ l(
               "span",
               {
                 "aria-hidden": "true",
@@ -292,41 +300,42 @@ const ct = X(
                   "ds:text-[color:var(--accent)]",
                   "ds:forced-colors:text-[CanvasText]"
                 ].join(" "),
-                children: m
+                children: g
               }
             ),
-            /* @__PURE__ */ i(
+            /* @__PURE__ */ l(
               "span",
               {
                 id: T,
                 className: "type-label ds:text-[var(--muted-foreground)]",
-                children: d
+                children: a
               }
             )
           ] }),
-          _ ? (
+          q ? (
             // The animated number is wrapped in an `aria-live="off"` span
             // so screen readers don't announce every interpolated frame.
             // The `role="group"` ancestor (with `aria-labelledby` pointing
             // at the label) carries the final accessible reading — the
             // animated frames are decorative only.
-            /* @__PURE__ */ i(
+            /* @__PURE__ */ l(
               "span",
               {
                 ref: C.ref,
                 "aria-live": "off",
-                className: U({ size: y, variant: x, intent: M }),
+                className: U({ size: N, variant: y, intent: M }),
                 children: C.value
               }
             )
-          ) : /* @__PURE__ */ i("span", { className: U({ size: y, variant: x, intent: M }), children: Y }),
-          o != null && l != null && /* @__PURE__ */ i(
-            it,
+          ) : /* @__PURE__ */ l("span", { className: U({ size: N, variant: y, intent: M }), children: _ }),
+          i != null && d != null && /* @__PURE__ */ l(
+            dt,
             {
-              trend: o,
-              delta: l,
-              deltaFormat: u,
-              locale: e
+              trend: i,
+              delta: d,
+              deltaFormat: r,
+              locale: e,
+              polarity: m
             }
           )
         ]
@@ -338,4 +347,4 @@ ct.displayName = "Stat";
 export {
   ct as S
 };
-//# sourceMappingURL=stat-51CDL4au.js.map
+//# sourceMappingURL=stat-DmjGfXND.js.map

package/dist/_chunks/{stepper-accordion-D7lnBGh2.js → stepper-accordion-DDTSOUHc.js}

@@ -124,7 +124,11 @@ const K = [
   "ds:group-data-[state=open]/item:rotate-180"
 ].join(" "), sr = [
   "type-meta ds:text-[var(--muted-foreground)]",
-  "ds:ps-[calc(var(--min-target-size)+var(--spacing-md)+var(--spacing-sm))]",
+  // Indented under the step title from 448px of accordion width (px, not
+  // rem: a container query in rem follows the host's root font size); narrower
+  // (a phone) the content takes the full width so a form or a list in it
+  // is not squeezed beside the step number.
+  "ds:ps-[var(--spacing-md)] ds:@[448px]/stepper:ps-[calc(var(--min-target-size)+var(--spacing-md)+var(--spacing-sm))]",
   "ds:pe-[var(--spacing-md)] ds:pb-[var(--spacing-sm)]",
   "ds:group-data-[state=open]/item:hidden"
 ].join(" "), ar = [
@@ -132,11 +136,18 @@ const K = [
   "ds:data-[state=open]:animate-[accordion-down_var(--animation-duration)_var(--ease-out)]",
   "ds:data-[state=closed]:animate-[accordion-up_var(--animation-duration)_var(--ease-in)]"
 ].join(" "), tr = [
-  "ds:ps-[calc(var(--min-target-size)+var(--spacing-md)+var(--spacing-sm))]",
+  // Indented under the step title from 448px of accordion width (px, not
+  // rem: a container query in rem follows the host's root font size); narrower
+  // (a phone) the content takes the full width so a form or a list in it
+  // is not squeezed beside the step number.
+  "ds:ps-[var(--spacing-md)] ds:@[448px]/stepper:ps-[calc(var(--min-target-size)+var(--spacing-md)+var(--spacing-sm))]",
   "ds:pe-[var(--spacing-md)] ds:pt-[var(--spacing-xs)] ds:pb-[var(--spacing-md)]"
-].join(" "), nr = b("ds:flex ds:flex-col ds:gap-[var(--spacing-sm)]", {
-  variants: {}
-}), or = P(
+].join(" "), nr = b(
+  "ds:@container/stepper ds:flex ds:w-full ds:min-w-0 ds:flex-col ds:gap-[var(--spacing-sm)]",
+  {
+    variants: {}
+  }
+), or = P(
   ({
     activeStep: s,
     steps: i,
@@ -248,4 +259,4 @@ or.displayName = "StepperAccordion";
 export {
   or as S
 };
-//# sourceMappingURL=stepper-accordion-D7lnBGh2.js.map
+//# sourceMappingURL=stepper-accordion-DDTSOUHc.js.map

package/dist/_chunks/{task-editor-Ctxsa1BY.js → task-editor-ByyRu29Y.js}

@@ -6,14 +6,14 @@ import { A as M } from "./alert-BhCstf2h.js";
 import { B as Me } from "./button-Bn16lcFM.js";
 import { I as We } from "./icon-button-COX76Jdj.js";
 import { C as Qe } from "./combobox-U5yfO6o0.js";
-import { D as ce } from "./dialog-D52AI4nF.js";
+import { D as ce } from "./dialog-CUzbnKLw.js";
 import { D as Bt } from "./date-picker-wRAcq2lt.js";
 import { F as H } from "./form-field-Ani72sVY.js";
 import { I as Ft } from "./icon-button-group-C5hhI-R5.js";
 import { P as Pt } from "./panel-header-D_mTdhUp.js";
 import { P as Ot } from "./panel-subview-BT-Apwgb.js";
 import { R as Pe } from "./radio-BBbMdbE_.js";
-import { R as jt } from "./radio-group-BT97ty7o.js";
+import { R as jt } from "./radio-group-DicxWJXP.js";
 import { S as Mt } from "./scroll-area-ZtFCv9K7.js";
 import { S as Ke } from "./select-Ce5RMk93.js";
 import { S as He } from "./skeleton-B1KTdJ4N.js";
@@ -1238,4 +1238,4 @@ export {
   vo as T,
   lo as t
 };
-//# sourceMappingURL=task-editor-Ctxsa1BY.js.map
+//# sourceMappingURL=task-editor-ByyRu29Y.js.map

package/dist/_chunks/{use-appointment-details-read-DinTrRIW.js → use-appointment-details-read-JsDM48tf.js}

@@ -16,7 +16,7 @@ import { E as zt } from "./editable-description-DuJlvltc.js";
 import { N as Xe } from "./note-timeline-CsY8YOE7.js";
 import { P as Ot } from "./panel-header-D_mTdhUp.js";
 import { P as Ge } from "./panel-subview-BT-Apwgb.js";
-import { P as _t } from "./patient-summary-card-3dspc2tR.js";
+import { P as _t } from "./patient-summary-card-9nQWTQf6.js";
 import { S as ne } from "./section-card-ChJdOlBU.js";
 import { C as nn, S as ue } from "./skeleton-B1KTdJ4N.js";
 import { T as an } from "./text-area-COMVJ1yE.js";
@@ -2195,4 +2195,4 @@ export {
   Kn as s,
   _s as u
 };
-//# sourceMappingURL=use-appointment-details-read-DinTrRIW.js.map
+//# sourceMappingURL=use-appointment-details-read-JsDM48tf.js.map

package/dist/_chunks/use-select-on-arrow-Cr4iBuW5.js

@@ -0,0 +1,26 @@
+import { useRef as u, useMemo as i } from "react";
+const s = /* @__PURE__ */ new Set(["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight"]);
+function f() {
+  const t = u(null);
+  return i(
+    () => ({
+      onKeyDown: (r) => {
+        if (!s.has(r.key) || !r.defaultPrevented) return;
+        const n = r.currentTarget, c = r.target, o = { selected: !1 };
+        t.current = o, window.setTimeout(() => {
+          t.current === o && (t.current = null);
+          const e = document.activeElement;
+          o.selected || e === c || !(e instanceof HTMLElement) || !n.isConnected || e.getAttribute("role") !== "radio" || e.closest('[role="radiogroup"]') !== n || e.getAttribute("aria-checked") === "true" || e.click();
+        }, 0);
+      },
+      noteSelection: () => {
+        t.current && (t.current.selected = !0);
+      }
+    }),
+    []
+  );
+}
+export {
+  f as u
+};
+//# sourceMappingURL=use-select-on-arrow-Cr4iBuW5.js.map

package/dist/_chunks/{widget-picker-D8RiWrJd.js → widget-picker-DXYBMTfe.js}

@@ -2,7 +2,7 @@ import { jsx as t, jsxs as c } from "react/jsx-runtime";
 import { forwardRef as P, useState as N, useEffect as S, useMemo as f, useCallback as W, useImperativeHandle as T } from "react";
 import { c as _ } from "./index-D2ZczOXr.js";
 import { useTranslation as j } from "react-i18next";
-import { D as l } from "./dialog-D52AI4nF.js";
+import { D as l } from "./dialog-CUzbnKLw.js";
 import { S as z } from "./state-backed-text-input-DECQy5aA.js";
 import { B as C } from "./badge-hnBt8o7n.js";
 import { u as B } from "./registry-DvAUVLHh.js";
@@ -190,4 +190,4 @@ export {
   A as W,
   L as w
 };
-//# sourceMappingURL=widget-picker-D8RiWrJd.js.map
+//# sourceMappingURL=widget-picker-DXYBMTfe.js.map

package/dist/_chunks/{workflow-map-D3mezmGB.js → workflow-map-Demlpy39.js}

@@ -4,7 +4,7 @@ import { c as j } from "./index-D2ZczOXr.js";
 import { useTranslation as z } from "react-i18next";
 import { C } from "./card-DMO2nkt4.js";
 import { B as ye } from "./badge-hnBt8o7n.js";
-import { a as Z } from "./key-value-pair-Ax8IJr1M.js";
+import { a as Z } from "./key-value-pair-BNNITp6S.js";
 import { T as xe } from "./timestamp-DPLDWdxA.js";
 import { I as S } from "./icon-button-COX76Jdj.js";
 import { P as $ } from "./pencil-B1sKKyuT.js";
@@ -1321,4 +1321,4 @@ export {
   ee as r,
   D as w
 };
-//# sourceMappingURL=workflow-map-D3mezmGB.js.map
+//# sourceMappingURL=workflow-map-Demlpy39.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.55.0",
+  "packageVersion": "1.56.0",
   "components": [
     {
       "kind": "component",
@@ -2071,7 +2071,7 @@
             ]
           },
           "idempotent": true,
-          "description": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state) — when the user has switched the view cross-shape the values are converted to the rendered shape. The write targets the live instance only: a later type switch re-reads the original props and discards it.",
+          "description": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state); when the user has switched the view cross-shape the values are converted to the rendered shape. The data and its summary table persist across type switches, resizes and theme changes until the host passes a new series prop.",
           "descriptionKey": "ui.agent.chart.actions.updateSeries"
         },
         {
@@ -2083,7 +2083,7 @@
             "description": "A `data:image/png;base64,…` URI of the rendered chart."
           },
           "idempotent": true,
-          "description": "Return a PNG data URI of the chart for export or screenshotting.",
+          "description": "Return a PNG data URI of the chart for export or screenshotting. Waits until series pushed with update_series are drawn.",
           "descriptionKey": "ui.agent.chart.actions.exportPng"
         }
       ],
@@ -3256,6 +3256,12 @@
           "type": "boolean",
           "description": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle.",
           "descriptionKey": "ui.agent.dashboardGrid.state.editing"
+        },
+        {
+          "name": "stacked",
+          "type": "boolean",
+          "description": "Whether the board is narrower than its stackBelow width and shows its widgets as one read-only column. Move/resize actions are unavailable while it is true, even in edit mode; the saved layout is unchanged.",
+          "descriptionKey": "ui.agent.dashboardGrid.state.stacked"
         }
       ],
       "actions": [
@@ -3290,10 +3296,15 @@
           "returns": "boolean (accepted)",
           "returnsSchema": {
             "type": "boolean",
-            "description": "True when applied; false when edit mode is off or the id is unknown."
+            "description": "True when applied; false when edit mode is off, the board is stacked, or the id is unknown."
           },
           "idempotent": true,
-          "description": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off.",
+          "errors": [
+            "Unavailable while the board is stacked (state stacked is true): returns false and changes nothing.",
+            "Unavailable while edit mode is off: returns false.",
+            "Unknown widget id: returns false."
+          ],
+          "description": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off or the board is stacked.",
           "descriptionKey": "ui.agent.dashboardGrid.actions.moveWidget"
         },
         {
@@ -3327,17 +3338,23 @@
           "returns": "boolean (accepted)",
           "returnsSchema": {
             "type": "boolean",
-            "description": "True when applied; false when edit mode is off or the id is unknown."
+            "description": "True when applied; false when edit mode is off, the board is stacked, or the id is unknown."
           },
           "idempotent": true,
-          "description": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off.",
+          "errors": [
+            "Unavailable while the board is stacked (state stacked is true): returns false and changes nothing.",
+            "Unavailable while edit mode is off: returns false.",
+            "Unknown widget id: returns false."
+          ],
+          "description": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off or the board is stacked.",
           "descriptionKey": "ui.agent.dashboardGrid.actions.resizeWidget"
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "dashboard-grid"
+          "value": "dashboard-grid",
+          "description": "Also carries data-stacked=\"true\" while the board shows one read-only column."
         },
         "instanceId": {
           "attr": "data-component-id",
@@ -19708,7 +19725,7 @@
         {
           "name": "run_template",
           "safety": "phi",
-          "description": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (default first). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
+          "description": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (listed in the practice's order). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
           "descriptionKey": "ui.agent.helpMeWriteTemplates.workflows.runTemplate",
           "uiActions": [
             "dropdown-menu.open",
@@ -19734,7 +19751,7 @@
         {
           "name": "manage_templates",
           "safety": "write",
-          "description": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI, use as default; names are unique) and delete one after a confirmation. Shown only when the host allows managing.",
+          "description": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI; names are unique), reorder them by dragging and delete one after a confirmation. Shown only when the host allows managing.",
           "descriptionKey": "ui.agent.helpMeWriteTemplates.workflows.manageTemplates",
           "uiActions": [
             "dialog.close",

package/dist/agent-i18n/en.json

@@ -248,8 +248,8 @@
       },
       "actions": {
         "changeView": "Switch the rendered chart type via the type switcher. No-op (returns false) when the chart has no switcher or the type is not offered.",
-        "updateSeries": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state) — when the user has switched the view cross-shape the values are converted to the rendered shape. The write targets the live instance only: a later type switch re-reads the original props and discards it.",
-        "exportPng": "Return a PNG data URI of the chart for export or screenshotting."
+        "updateSeries": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state); when the user has switched the view cross-shape the values are converted to the rendered shape. The data and its summary table persist across type switches, resizes and theme changes until the host passes a new series prop.",
+        "exportPng": "Return a PNG data URI of the chart for export or screenshotting. Waits until series pushed with update_series are drawn."
       }
     },
     "chatContainer": {
@@ -399,11 +399,12 @@
       "state": {
         "layout": "Current widget geometry in cell units — ids and rectangles only, no widget content.",
         "cols": "Logical column count of the board.",
-        "editing": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle."
+        "editing": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle.",
+        "stacked": "Whether the board is narrower than its stackBelow width and shows its widgets as one read-only column. Move/resize actions are unavailable while it is true, even in edit mode; the saved layout is unchanged."
       },
       "actions": {
-        "moveWidget": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off.",
-        "resizeWidget": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off."
+        "moveWidget": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off or the board is stacked.",
+        "resizeWidget": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off or the board is stacked."
       }
     },
     "dataTableTabs": {
@@ -1835,9 +1836,9 @@
     },
     "helpMeWriteTemplates": {
       "workflows": {
-        "runTemplate": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (default first). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
+        "runTemplate": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (listed in the practice's order). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
         "freePrompt": "Type (or dictate with the bar mic) what to write and press Write; the draft is inserted at the caret on Insert.",
-        "manageTemplates": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI, use as default; names are unique) and delete one after a confirmation. Shown only when the host allows managing."
+        "manageTemplates": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI; names are unique), reorder them by dragging and delete one after a confirmation. Shown only when the host allows managing."
       }
     },
     "invoices": {