@alfadocs/ui-kit-debug 1.3.13 → 1.4.1

package/dist/_chunks/{sparkline-BTY4B5tv.js → sparkline-BmGcEyZO.js}

@@ -1,28 +1,59 @@
-import { jsx as c, jsxs as D } from "react/jsx-runtime";
-import { forwardRef as le, useId as ue, useMemo as A, useRef as P, useState as F, useEffect as U, useImperativeHandle as pe } from "react";
-import { c as E } from "./index-D2ZczOXr.js";
+import { jsx as c, jsxs as V } from "react/jsx-runtime";
+import { forwardRef as pe, useId as ue, useMemo as A, useRef as z, useState as W, useEffect as S, useImperativeHandle as he } from "react";
+import { c as K } from "./index-D2ZczOXr.js";
 import { useTranslation as me } from "react-i18next";
-import he from "react-apexcharts";
-import V from "apexcharts";
-import { g as J, u as fe } from "./apexcharts-theme-B_AxGC_h.js";
-import { m as ge } from "./annotation-marker-CsUJGZjQ.js";
-import { u as ve } from "./registry-DvAUVLHh.js";
-function ye(n) {
-  if (n.length < 2)
+import ge from "react-apexcharts";
+import E from "apexcharts";
+import { g as Q, u as fe } from "./apexcharts-theme-B_AxGC_h.js";
+import { m as ye } from "./annotation-marker-CsUJGZjQ.js";
+import { u as be } from "./registry-DvAUVLHh.js";
+function ve(t) {
+  if (t.length < 2)
     return { slope: 0, direction: "steady" };
-  const r = n.length, h = (r - 1) / 2, l = n.reduce((a, i) => a + i, 0) / r;
-  let s = 0, u = 0;
-  for (let a = 0; a < r; a++) {
-    const i = a - h;
-    s += i * (n[a] - l), u += i * i;
+  const a = t.length, m = (a - 1) / 2, l = t.reduce((r, i) => r + i, 0) / a;
+  let s = 0, p = 0;
+  for (let r = 0; r < a; r++) {
+    const i = r - m;
+    s += i * (t[r] - l), p += i * i;
   }
-  const m = u === 0 ? 0 : s / u, k = 0.01 * (Math.max(...n) - Math.min(...n) || 1), f = Math.abs(m) < k ? "steady" : m > 0 ? "increasing" : "decreasing";
-  return { slope: m, direction: f };
+  const h = p === 0 ? 0 : s / p, k = 0.01 * (Math.max(...t) - Math.min(...t) || 1), g = Math.abs(h) < k ? "steady" : h > 0 ? "increasing" : "decreasing";
+  return { slope: h, direction: g };
 }
-const be = {
+const we = {
   id: "sparkline",
   capabilities: [],
-  state: {},
+  // `select_annotation` enforces two preconditions silently and
+  // `update_series` writes straight into ApexCharts, bypassing React —
+  // so nothing in the React tree reflects what is actually rendered.
+  // These slots are the checkable form of both.
+  //
+  // A9 boundary: an annotation `id` is the host's opaque key, so it is
+  // exposed; `SparklineAnnotation.label` is human-readable and could
+  // name a clinical event, so it is not. The plotted values are
+  // measurements in a clinical sparkline and are never exposed — only
+  // their count. `trend` from `useLinearTrend` is deliberately left out
+  // for the same reason (still derived from the plotted values); adding
+  // it needs a DS-maintainer sign-off.
+  state: {
+    annotationIds: {
+      type: "string[]",
+      descriptionKey: "ui.agent.sparkline.state.annotationIds",
+      description: "Ids of the annotations currently drawn, in declaration order. The only ids `select_annotation` will accept — check against this before calling. Ids only, never annotation labels.",
+      read: (t) => t.getAnnotationIds()
+    },
+    selectable: {
+      type: "boolean",
+      descriptionKey: "ui.agent.sparkline.state.selectable",
+      description: "True when the host wired an annotation-select handler. False means every `select_annotation` call is a no-op, whatever id is passed.",
+      read: (t) => t.isSelectable()
+    },
+    pointCount: {
+      type: "number",
+      descriptionKey: "ui.agent.sparkline.state.pointCount",
+      description: "Number of positions in the currently rendered series, unmeasured gaps included — reflecting whichever applied last, the `data` prop or an `update_series` call. A count only; the plotted values are never exposed.",
+      read: (t) => t.getPointCount()
+    }
+  },
   actions: {
     update_series: {
       // Replacing the rendered series mutates what the chart displays — write,
@@ -42,9 +73,9 @@ const be = {
       },
       idempotent: !0,
       descriptionKey: "ui.agent.sparkline.actions.updateSeries",
-      description: "Replace the sparkline data without remounting.",
-      invoke: (n, r) => {
-        n.updateSeries(r.data);
+      description: "Replace the sparkline data without remounting. Writes straight into ApexCharts, bypassing React — read the `pointCount` slot back rather than expecting the host tree to reflect it.",
+      invoke: (t, a) => {
+        t.updateSeries(a.data);
       }
     },
     export_png: {
@@ -57,7 +88,7 @@ const be = {
       },
       descriptionKey: "ui.agent.sparkline.actions.exportPng",
       description: "Return a PNG data URI of the sparkline.",
-      invoke: (n) => n.dataURI()
+      invoke: (t) => t.dataURI()
     },
     select_annotation: {
       // Routes the host somewhere — the same thing a pointer press on the
@@ -77,9 +108,13 @@ const be = {
       },
       idempotent: !0,
       descriptionKey: "ui.agent.sparkline.actions.selectAnnotation",
-      description: "Select a drawn annotation, as pressing its band would. No-op unless the host wired onAnnotationSelect and the id names an annotation that is currently drawn.",
-      invoke: (n, r) => {
-        n.selectAnnotation(r.annotationId);
+      description: "Select a drawn annotation, as pressing its band would. No-op unless the host wired onAnnotationSelect and the id names an annotation that is currently drawn — check the `selectable` and `annotationIds` slots first, since neither failure produces a signal.",
+      errors: [
+        "Silently ignored when `selectable` is false — the host wired no annotation-select handler.",
+        "Silently ignored when the id is not in `annotationIds` — that annotation is not currently drawn."
+      ],
+      invoke: (t, a) => {
+        t.selectAnnotation(a.annotationId);
       }
     }
   },
@@ -91,7 +126,7 @@ const be = {
       description: "Sourced from the id prop."
     }
   }
-}, Q = E("ds:relative ds:inline-block ds:w-full", {
+}, X = K("ds:relative ds:inline-block ds:w-full", {
   variants: {
     size: {
       xs: "ds:h-6",
@@ -103,7 +138,7 @@ const be = {
     }
   },
   defaultVariants: { size: "md" }
-}), X = E("", {
+}), Y = K("", {
   variants: {
     tone: {
       neutral: "ds:[--annotation-color:var(--muted-foreground)]",
@@ -118,7 +153,7 @@ const be = {
     }
   },
   defaultVariants: { tone: "neutral" }
-}), we = E(
+}), ke = K(
   "ds:pointer-events-none ds:absolute ds:inset-x-[2px]",
   {
     variants: {
@@ -134,162 +169,172 @@ const be = {
     },
     defaultVariants: { size: "md" }
   }
-), ke = {
+), xe = {
   increasing: "↑",
   decreasing: "↓",
   steady: "→"
-}, xe = {
+}, Ie = {
   xs: 24,
   sm: 32,
   md: 40
-}, I = 2, Y = 2.5, ee = 44;
-function Ie(n, r, h = ee) {
-  const l = n.map((s) => ({
+}, N = 2, ee = 2.5, te = 44;
+function Ne(t, a, m = te) {
+  const l = t.map((s) => ({
     annotation: s,
-    centre: te(s.position) * r
-  })).sort((s, u) => s.centre - u.centre);
-  return l.map((s, u) => {
-    const m = l[u - 1], w = l[u + 1], k = m ? (m.centre + s.centre) / 2 : 0, f = w ? (s.centre + w.centre) / 2 : r, a = Math.max(0, k), i = Math.min(r, f), y = Math.min(h, Math.max(0, i - a)), N = Math.min(
-      Math.max(s.centre - y / 2, a),
-      i - y
+    centre: ne(s.position) * a
+  })).sort((s, p) => s.centre - p.centre);
+  return l.map((s, p) => {
+    const h = l[p - 1], w = l[p + 1], k = h ? (h.centre + s.centre) / 2 : 0, g = w ? (s.centre + w.centre) / 2 : a, r = Math.max(0, k), i = Math.min(a, g), b = Math.min(m, Math.max(0, i - r)), T = Math.min(
+      Math.max(s.centre - b / 2, r),
+      i - b
     );
-    return { annotation: s.annotation, x: N, width: y };
+    return { annotation: s.annotation, x: T, width: b };
   });
 }
-function te(n) {
-  return Number.isFinite(n) ? Math.min(1, Math.max(0, n)) : 0;
+function ne(t) {
+  return Number.isFinite(t) ? Math.min(1, Math.max(0, t)) : 0;
 }
-function Ne(n) {
-  return n.filter((r) => r != null);
+function Te(t) {
+  return t.filter((a) => a != null);
 }
 function Me() {
   return typeof window < "u" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 }
-const Te = le(
+const Ce = pe(
   ({
-    id: n,
-    data: r,
-    variant: h = "line",
+    id: t,
+    data: a,
+    variant: m = "line",
     size: l = "md",
     label: s,
-    color: u,
-    showEndpoint: m = !1,
+    color: p,
+    showEndpoint: h = !1,
     showTooltip: w = !1,
     width: k,
-    height: f,
-    annotations: a,
+    height: g,
+    annotations: r,
     onAnnotationSelect: i,
-    className: y,
-    ...N
-  }, ne) => {
-    var Z;
-    const { t: v, i18n: W } = me(), $ = ue(), x = A(
-      () => `sparkline-${$.replace(/[^a-zA-Z0-9-_]/g, "")}`,
-      [$]
-    ), M = P(null), [C, ae] = F(0), [re, se] = F(ee), p = A(() => Ne(r), [r]), { direction: O } = ye(p), j = A(() => {
-      const e = a && a.length > 0 ? v("sparkline.annotations", {
-        list: a.map((b) => b.label).join(", ")
-      }) : "", t = (b) => e ? `${b}. ${e}` : b;
-      if (p.length === 0)
-        return t(v("sparkline.noData", "No data"));
-      const o = (b) => new Intl.NumberFormat(W.language).format(b), g = v(`sparkline.direction.${O}`), d = {
-        min: o(Math.min(...p)),
-        max: o(Math.max(...p)),
-        current: o(p[p.length - 1]),
-        direction: g
+    className: b,
+    ...T
+  }, ae) => {
+    var J;
+    const { t: y, i18n: $ } = me(), j = ue(), x = A(
+      () => `sparkline-${j.replace(/[^a-zA-Z0-9-_]/g, "")}`,
+      [j]
+    ), M = z(null), [_, re] = W(0), [se, ie] = W(te), u = A(() => Te(a), [a]), { direction: O } = ve(u), B = A(() => {
+      const e = r && r.length > 0 ? y("sparkline.annotations", {
+        list: r.map((v) => v.label).join(", ")
+      }) : "", n = (v) => e ? `${v}. ${e}` : v;
+      if (u.length === 0)
+        return n(y("sparkline.noData", "No data"));
+      const o = (v) => new Intl.NumberFormat($.language).format(v), f = y(`sparkline.direction.${O}`), d = {
+        min: o(Math.min(...u)),
+        max: o(Math.max(...u)),
+        current: o(u[u.length - 1]),
+        direction: f
       };
-      return t(s ? v("sparkline.summary", { label: s, ...d }) : v("sparkline.summaryNoLabel", d));
-    }, [p, a, s, O, W.language, v]), [T, ie] = F(
+      return n(s ? y("sparkline.summary", { label: s, ...d }) : y("sparkline.summaryNoLabel", d));
+    }, [u, r, s, O, $.language, y]), [C, oe] = W(
       () => {
         try {
-          return J();
+          return Q();
         } catch {
           return {};
         }
       }
     );
-    U(() => {
+    S(() => {
       let e;
-      const t = new MutationObserver(() => {
+      const n = new MutationObserver(() => {
         clearTimeout(e), e = setTimeout(() => {
           try {
-            ie(J());
+            oe(Q());
           } catch {
           }
         }, 50);
       });
-      return t.observe(document.documentElement, {
+      return n.observe(document.documentElement, {
         attributes: !0,
         attributeFilter: ["class"]
       }), () => {
-        clearTimeout(e), t.disconnect();
+        clearTimeout(e), n.disconnect();
       };
-    }, []), U(() => {
+    }, []), S(() => {
       const e = M.current;
       if (!e) return;
-      const t = () => {
-        const g = getComputedStyle(e).getPropertyValue("--min-target-size"), d = Number.parseFloat(g);
-        Number.isFinite(d) && d > 0 && se(d);
+      const n = () => {
+        const f = getComputedStyle(e).getPropertyValue("--min-target-size"), d = Number.parseFloat(f);
+        Number.isFinite(d) && d > 0 && ie(d);
       };
-      t();
-      const o = new ResizeObserver((g) => {
-        const d = g[0];
-        d && ae(Math.floor(d.contentRect.width)), t();
+      n();
+      const o = new ResizeObserver((f) => {
+        const d = f[0];
+        d && re(Math.floor(d.contentRect.width)), n();
       });
       return o.observe(e), () => o.disconnect();
     }, []), fe(M);
-    const R = P(i);
-    U(() => {
-      R.current = i;
+    const I = z(i);
+    S(() => {
+      I.current = i;
     }, [i]);
-    const B = P(a);
-    B.current = a;
-    const H = A(
+    const H = z(r);
+    H.current = r;
+    const P = z(a.length);
+    S(() => {
+      P.current = a.length;
+    }, [a]);
+    const D = A(
       () => ({
         updateSeries(e) {
-          var t;
-          (t = V.getChartByID(x)) == null || t.updateSeries([{ data: e }]);
+          var n;
+          (n = E.getChartByID(x)) == null || n.updateSeries([{ data: e }]), P.current = e.length;
         },
         updateOptions(e) {
-          var t;
-          (t = V.getChartByID(x)) == null || t.updateOptions(e);
+          var n;
+          (n = E.getChartByID(x)) == null || n.updateOptions(e);
         },
         async dataURI() {
-          const e = V.getChartByID(x);
+          const e = E.getChartByID(x);
           return e ? (await e.dataURI()).imgURI : "";
         },
         selectAnnotation(e) {
-          var o, g;
-          (o = B.current) != null && o.some((d) => d.id === e) && ((g = R.current) == null || g.call(R, e));
-        }
+          var o, f;
+          (o = H.current) != null && o.some((d) => d.id === e) && ((f = I.current) == null || f.call(I, e));
+        },
+        // Read-back for the two preconditions `selectAnnotation` enforces
+        // silently — without these an agent can check neither and gets no
+        // signal from either failure.
+        getAnnotationIds: () => (H.current ?? []).map((e) => e.id),
+        isSelectable: () => I.current != null,
+        getPointCount: () => P.current
       }),
       [x]
     );
-    pe(ne, () => H, [H]), ve(be, H, n);
-    const _ = u ?? ((Z = T.colors) == null ? void 0 : Z[0]) ?? "currentColor";
-    if (p.length === 0)
+    he(ae, () => D, [D]), be(we, D, t);
+    const F = p ?? ((J = C.colors) == null ? void 0 : J[0]) ?? "currentColor";
+    if (u.length === 0)
       return /* @__PURE__ */ c(
         "div",
         {
           ref: M,
           role: "img",
-          "aria-label": j,
+          "aria-label": B,
           dir: "ltr",
-          className: Q({
-            size: f !== void 0 ? "auto" : l,
-            className: y
+          className: X({
+            size: g !== void 0 ? "auto" : l,
+            className: b
           }),
           "data-component": "sparkline",
-          "data-component-id": n,
-          ...N
+          "data-component-id": t,
+          ...T
         }
       );
-    const G = Me(), S = r.length > p.length, L = S ? r.flatMap((e, t) => e == null ? [] : [{ x: t, y: e }]) : p, oe = {
-      ...T,
+    const G = Me(), U = a.length > u.length, L = U ? a.flatMap((e, n) => e == null ? [] : [{ x: n, y: e }]) : u, de = {
+      ...C,
       chart: {
-        ...T.chart,
+        ...C.chart,
         id: x,
-        type: h,
+        type: m,
         sparkline: { enabled: !0 },
         toolbar: { show: !1 },
         animations: {
@@ -300,28 +345,28 @@ const Te = le(
           // the tween emits `d="… NaN …"` for a few frames. The finished
           // render is correct either way; switching the tween off keeps the
           // console clean.
-          dynamicAnimation: { enabled: !G && !S }
+          dynamicAnimation: { enabled: !G && !U }
         },
         zoom: { enabled: !1 },
         parentHeightOffset: 0
       },
-      colors: [_],
+      colors: [F],
       stroke: {
         curve: "smooth",
-        width: h === "bar" ? 0 : 2
+        width: m === "bar" ? 0 : 2
       },
       fill: {
-        opacity: h === "area" ? 0.15 : 1
+        opacity: m === "area" ? 0.15 : 1
       },
       xaxis: {
         crosshairs: { show: !1 },
         // Pin the extent to the slot count so a gap at either end still holds
         // its place — otherwise the plot would rescale to the measurements
         // and the annotation fractions would no longer mean the same thing.
-        ...S ? { type: "numeric", min: 0, max: r.length - 1 } : {}
+        ...U ? { type: "numeric", min: 0, max: a.length - 1 } : {}
       },
       tooltip: { enabled: w },
-      markers: m ? {
+      markers: h ? {
         size: [0],
         discrete: [
           {
@@ -330,52 +375,52 @@ const Te = le(
             // the parameter was not measured at.
             seriesIndex: 0,
             dataPointIndex: L.length - 1,
-            fillColor: _,
-            strokeColor: _,
+            fillColor: F,
+            strokeColor: F,
             size: 4
           }
         ]
       } : { size: 0 },
       grid: {
-        ...T.grid,
+        ...C.grid,
         show: !1,
         // ApexCharts grid.padding uses physical keys (not CSS logical properties).
         // The chart wrapper enforces dir="ltr" so these always resolve correctly.
         padding: {
-          top: I,
-          right: I,
-          bottom: I,
-          left: I
+          top: N,
+          right: N,
+          bottom: N,
+          left: N
         }
       }
-    }, de = k ?? (C > 0 ? C : "100%"), ce = f ?? xe[l ?? "md"], z = a != null && a.length ? a : void 0, K = C - I * 2, q = i && z && K > 0 ? Ie(z, K, re) : void 0;
-    return /* @__PURE__ */ D(
+    }, ce = k ?? (_ > 0 ? _ : "100%"), le = g ?? Ie[l ?? "md"], R = r != null && r.length ? r : void 0, q = _ - N * 2, Z = i && R && q > 0 ? Ne(R, q, se) : void 0;
+    return /* @__PURE__ */ V(
       "div",
       {
         ref: M,
         role: "img",
-        "aria-label": j,
+        "aria-label": B,
         dir: "ltr",
-        className: Q({
-          size: f !== void 0 ? "auto" : l,
-          className: y
+        className: X({
+          size: g !== void 0 ? "auto" : l,
+          className: b
         }),
         "data-component": "sparkline",
-        "data-component-id": n,
-        ...N,
+        "data-component-id": t,
+        ...T,
         children: [
           /* @__PURE__ */ c(
-            he,
+            ge,
             {
-              type: h,
+              type: m,
               series: [{ data: L }],
-              options: oe,
-              width: de,
-              height: ce,
+              options: de,
+              width: ce,
+              height: le,
               "aria-hidden": "true"
             }
           ),
-          z && /* Drawn over the plot rather than through ApexCharts' own xaxis
+          R && /* Drawn over the plot rather than through ApexCharts' own xaxis
           annotations: a fraction of the measured extent is the one
           positioning rule that survives series of different lengths, which
           is what makes a column of sparklines share an x. */
@@ -392,23 +437,23 @@ const Te = le(
               focusable: "false",
               "data-testid": "sparkline-annotations",
               className: "ds:size-full",
-              children: z.map((e) => {
-                const t = te(e.position);
+              children: R.map((e) => {
+                const n = ne(e.position);
                 return (
                   /* A nested viewport placed at a percentage of the plot: the
                    one positioning rule that needs no measurement, so a column
                    of sparklines shares an x whatever their widths. */
-                  /* @__PURE__ */ D(
+                  /* @__PURE__ */ V(
                     "svg",
                     {
-                      x: `${t * 100}%`,
+                      x: `${n * 100}%`,
                       y: "0",
                       width: "1",
                       height: "100%",
                       overflow: "visible",
                       "data-annotation-id": e.id,
-                      "data-annotation-position": t,
-                      className: X({ tone: e.tone }),
+                      "data-annotation-position": n,
+                      className: Y({ tone: e.tone }),
                       children: [
                         /* @__PURE__ */ c(
                           "line",
@@ -423,11 +468,11 @@ const Te = le(
                         /* @__PURE__ */ c(
                           "path",
                           {
-                            d: ge(
+                            d: ye(
                               e.shape ?? "diamond",
                               0,
-                              Y,
-                              Y
+                              ee,
+                              ee
                             ),
                             className: "ds:[fill:var(--annotation-color)]"
                           }
@@ -440,15 +485,15 @@ const Te = le(
               })
             }
           ) }),
-          q && i && /* Sized in px, not percentages: the target size is a measurement,
+          Z && i && /* Sized in px, not percentages: the target size is a measurement,
           not a fraction of a box the reader can resize.
           `pointer-events-none` holds all the way down to the bands, so the
           only live pixels are the token-width each annotation owns. */
           /* @__PURE__ */ c(
             "div",
             {
-              className: we({
-                size: f !== void 0 ? "auto" : l
+              className: ke({
+                size: g !== void 0 ? "auto" : l
               }),
               children: /* @__PURE__ */ c(
                 "svg",
@@ -457,22 +502,22 @@ const Te = le(
                   focusable: "false",
                   "data-testid": "sparkline-annotation-hits",
                   className: "ds:size-full",
-                  children: q.map(({ annotation: e, x: t, width: o }) => /* @__PURE__ */ D(
+                  children: Z.map(({ annotation: e, x: n, width: o }) => /* @__PURE__ */ V(
                     "g",
                     {
                       "data-annotation-hit-id": e.id,
                       onClick: () => i(e.id),
-                      className: `ds:group ds:pointer-events-auto ds:cursor-pointer ${X(
+                      className: `ds:group ds:pointer-events-auto ds:cursor-pointer ${Y(
                         { tone: e.tone }
                       )}`,
                       children: [
-                        /* @__PURE__ */ c("title", { children: v("sparkline.annotationAction", {
+                        /* @__PURE__ */ c("title", { children: y("sparkline.annotationAction", {
                           label: e.label
                         }) }),
                         /* @__PURE__ */ c(
                           "rect",
                           {
-                            x: t,
+                            x: n,
                             y: 0,
                             width: o,
                             height: "100%",
@@ -487,12 +532,12 @@ const Te = le(
               )
             }
           ),
-          m && /* @__PURE__ */ c(
+          h && /* @__PURE__ */ c(
             "span",
             {
               "aria-hidden": "true",
               className: "ds:pointer-events-none ds:absolute ds:end-0 ds:top-0 ds:text-[length:var(--font-size-xs)] ds:leading-none",
-              children: ke[O]
+              children: xe[O]
             }
           )
         ]
@@ -500,10 +545,10 @@ const Te = le(
     );
   }
 );
-Te.displayName = "Sparkline";
+Ce.displayName = "Sparkline";
 export {
-  Te as S,
-  be as s,
-  ye as u
+  Ce as S,
+  we as s,
+  ve as u
 };
-//# sourceMappingURL=sparkline-BTY4B5tv.js.map
+//# sourceMappingURL=sparkline-BmGcEyZO.js.map