@alfadocs/ui-kit 1.29.0 → 1.30.0

package/dist/_chunks/use-zoom-drilldown-qCX34w9I.js

@@ -0,0 +1,210 @@
+import { useRef as I, useEffect as M, useState as F, useMemo as E, useCallback as s } from "react";
+import { flushSync as R } from "react-dom";
+function x(e) {
+  return e != null && e.current ? e.current : typeof document > "u" ? null : document;
+}
+function O(e, l) {
+  const c = typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(e) : (
+    // SSR / jsdom fallback — drop every character that's
+    // significant in a CSS attribute selector. Conservative but
+    // robust enough for the test environment.
+    e.replace(/["'\\[\]]/g, "")
+  ), d = `[data-error-anchor="${c}"], [name="${c}"], [name$="[${c}]"]`, u = Array.from(l.querySelectorAll(d));
+  return u.length === 0 ? null : u.find((p) => p.offsetParent !== null) ?? u[0];
+}
+function $(e, l, c = {}) {
+  const {
+    scope: d,
+    scrollOptions: u = { behavior: "smooth", block: "center" },
+    focus: a = !0,
+    skipInitialMount: p = !0
+  } = c, o = I(!1), f = I(null), i = l.find((h) => !!e[h]) ?? null;
+  M(() => {
+    if (p && !o.current) {
+      o.current = !0, f.current = i;
+      return;
+    }
+    if (!i) {
+      f.current = null;
+      return;
+    }
+    if (i === f.current || typeof window > "u") return;
+    const h = window.requestAnimationFrame(() => {
+      const g = x(d);
+      if (!g) return;
+      const t = O(i, g);
+      t && (t.scrollIntoView(u), a && t.focus({ preventScroll: !0 }), f.current = i);
+    });
+    return () => window.cancelAnimationFrame(h);
+  }, [i]);
+}
+function k(e, l = !1) {
+  const c = {};
+  for (const d of e)
+    c[d.id] = { signed: l ? !1 : !!d.signed };
+  return c;
+}
+function D(e) {
+  const [l, c] = F(
+    () => k(e)
+  ), [d, u] = F(null), [a, p] = F(
+    () => {
+      var n;
+      return ((n = e[0]) == null ? void 0 : n.id) ?? null;
+    }
+  ), o = E(
+    () => e.map((n) => {
+      const r = l[n.id];
+      return {
+        ...n,
+        signed: r ? r.signed : !!n.signed,
+        payload: r == null ? void 0 : r.payload
+      };
+    }),
+    [e, l]
+  ), f = E(
+    () => o.reduce((n, r) => r.signed ? n + 1 : n, 0),
+    [o]
+  ), i = o.length, h = i > 0 && f === i, g = s((n) => {
+    u(n);
+  }, []), t = s(() => {
+    u(null);
+  }, []), w = s((n, r) => {
+    c((m) => ({ ...m, [n]: { signed: !0, payload: r } })), u((m) => m === n ? null : m);
+  }, []), T = s(
+    (n) => {
+      var r;
+      return !!((r = l[n]) != null && r.signed);
+    },
+    [l]
+  ), S = s(() => {
+    var n;
+    c(k(e, !0)), u(null), p(((n = e[0]) == null ? void 0 : n.id) ?? null);
+  }, [e]), C = s(() => {
+    p((n) => {
+      const r = o.length;
+      if (r === 0) return null;
+      const m = n ? o.findIndex((y) => y.id === n) : -1;
+      return o[(m + 1 + r) % r].id;
+    });
+  }, [o]), v = s(() => {
+    p((n) => {
+      const r = o.length;
+      if (r === 0) return null;
+      const m = n ? o.findIndex((y) => y.id === n) : 0;
+      return o[(m - 1 + r) % r].id;
+    });
+  }, [o]), A = s(() => {
+    p((n) => {
+      const r = o.length;
+      if (r === 0) return n;
+      const m = n ? o.findIndex((y) => y.id === n) : -1;
+      for (let y = 1; y <= r; y += 1) {
+        const b = o[(m + y) % r];
+        if (!b.signed) return b.id;
+      }
+      return n;
+    });
+  }, [o]);
+  return E(
+    () => ({
+      fields: o,
+      signedCount: f,
+      total: i,
+      isComplete: h,
+      activeFieldId: d,
+      openField: g,
+      closeField: t,
+      markSigned: w,
+      isFieldSigned: T,
+      reset: S,
+      cursorFieldId: a,
+      goToNextField: C,
+      goToPreviousField: v,
+      goToNextUnsigned: A
+    }),
+    [
+      o,
+      f,
+      i,
+      h,
+      d,
+      g,
+      t,
+      w,
+      T,
+      S,
+      a,
+      C,
+      v,
+      A
+    ]
+  );
+}
+const q = "ds-zoom-drilldown", L = () => {
+  if (typeof document > "u") return null;
+  const e = document.querySelector("main");
+  return e ? e.querySelector("[data-radix-scroll-area-viewport]") ?? e.closest("[data-radix-scroll-area-viewport]") ?? e : null;
+}, N = (e) => typeof e.startViewTransition == "function" && typeof CSS < "u" && typeof CSS.supports == "function" && CSS.supports("view-transition-class", q);
+function P(e = {}) {
+  const [l, c] = F(null), d = I(
+    null
+  ), u = I(e.getScrollContainer);
+  u.current = e.getScrollContainer;
+  const a = s(
+    () => (u.current ?? L)(),
+    []
+  ), p = s(() => {
+    const t = a();
+    return {
+      window: typeof window < "u" ? window.scrollY : 0,
+      container: t ? t.scrollTop : 0
+    };
+  }, [a]), o = s(() => {
+    const t = d.current;
+    if (!t) return;
+    d.current = null;
+    let w = 0;
+    const T = () => {
+      const S = a();
+      typeof window < "u" && window.scrollTo({ top: t.window }), S && (S.scrollTop = t.container), !((typeof window > "u" || Math.abs(window.scrollY - t.window) < 2) && (!S || Math.abs(S.scrollTop - t.container) < 2)) && w < 20 && (w += 1, requestAnimationFrame(T));
+    };
+    T();
+  }, [a]), f = s(() => {
+    const t = a();
+    typeof window < "u" && window.scrollTo({ top: 0 }), t && (t.scrollTop = 0);
+  }, [a]), i = s(
+    (t) => {
+      var v;
+      const w = document, T = typeof window < "u" && typeof window.matchMedia == "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches, S = t === null;
+      if (T || !N(w) || !w.startViewTransition) {
+        R(() => c(t)), S ? o() : f();
+        return;
+      }
+      const C = w.startViewTransition(() => {
+        R(() => c(t)), S || f();
+      });
+      S && ((v = C == null ? void 0 : C.finished) == null || v.then(o, o));
+    },
+    [o, f]
+  ), h = s(
+    (t) => {
+      d.current = p(), i(t);
+    },
+    [p, i]
+  ), g = s(() => i(null), [i]);
+  return M(() => {
+    if (l === null) return;
+    const t = (w) => {
+      w.key === "Escape" && !w.defaultPrevented && g();
+    };
+    return window.addEventListener("keydown", t), () => window.removeEventListener("keydown", t);
+  }, [l, g]), { selected: l, open: h, close: g };
+}
+export {
+  q as Z,
+  D as a,
+  P as b,
+  $ as u
+};
+//# sourceMappingURL=use-zoom-drilldown-qCX34w9I.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.29.0",
+  "packageVersion": "1.30.0",
   "components": [
     {
       "kind": "component",
@@ -12858,7 +12858,10 @@
             ]
           },
           "idempotent": true,
-          "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.",
+          "errors": [
+            "Per-point tooltip titles are hidden after this call — the host point labels describe the previous series, not the one written."
+          ],
+          "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. Host-supplied point labels are not updated, so the tooltip title is hidden after this call.",
           "descriptionKey": "ui.agent.sparkline.actions.updateSeries"
         },
         {

package/dist/agent-i18n/en.json

@@ -1322,7 +1322,7 @@
         "pointCount": "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."
       },
       "actions": {
-        "updateSeries": "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.",
+        "updateSeries": "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. Host-supplied point labels are not updated, so the tooltip title is hidden after this call.",
         "exportPng": "Return a PNG data URI of the sparkline.",
         "selectAnnotation": "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."
       }

package/dist/components/index.d.ts

@@ -1,5 +1,5 @@
-export { usePrefersReducedMotion, useMediaQuery, useScrollToFirstError, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, useSigningSession, } from '../hooks';
-export type { LocaleDir, UseLocaleReturn, UseScrollToFirstErrorOptions, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, SigningField, SigningFieldBase, UseSigningSessionReturn, } from '../hooks';
+export { usePrefersReducedMotion, useMediaQuery, useScrollToFirstError, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, useSigningSession, useZoomDrilldown, ZOOM_DRILLDOWN_TRANSITION_CLASS, } from '../hooks';
+export type { LocaleDir, UseLocaleReturn, UseScrollToFirstErrorOptions, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, SigningField, SigningFieldBase, UseSigningSessionReturn, UseZoomDrilldownOptions, UseZoomDrilldownReturn, } from '../hooks';
 export * from './button';
 export * from './button-group';
 export * from './floating-action-button';

package/dist/components/sparkline/index.js

@@ -1,4 +1,4 @@
-import { S as r, s, u as n } from "../../_chunks/sparkline-BmGcEyZO.js";
+import { S as r, s, u as n } from "../../_chunks/sparkline-Dx_sxK3J.js";
 export {
   r as Sparkline,
   s as sparklineAgent,

package/dist/components/sparkline/sparkline.d.ts

@@ -73,6 +73,12 @@ export interface SparklineProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ro
      * dashboard widgets) and the user benefits from per-point readout.
      */
     showTooltip?: boolean;
+    /** Series name shown in the tooltip, already localised. Defaults to
+     * `label`, so the tooltip never falls back to Apex's "series-1". */
+    seriesName?: string;
+    /** Tooltip title per point, same order and length as `data` (gaps
+     * included). Omitted = no tooltip title. Never drawn on an axis. */
+    pointLabels?: readonly string[];
     /** Width override — defaults to 100% of container */
     width?: string | number;
     /** Height override — defaults to the size variant height */

package/dist/hooks/index.d.ts

@@ -22,5 +22,6 @@ export { useWebOtp, type UseWebOtpOptions } from './use-web-otp';
 export { useVisualViewportPin, type VisualViewportPinOptions, } from './use-visual-viewport-pin';
 export { useEdgeResize, type UseEdgeResizeOptions, type UseEdgeResizeReturn, type EdgeResizeSeparatorProps, } from './use-edge-resize';
 export { useSigningSession, type SigningField, type SigningFieldBase, type UseSigningSessionReturn, } from './use-signing-session';
+export { useZoomDrilldown, ZOOM_DRILLDOWN_TRANSITION_CLASS, type UseZoomDrilldownOptions, type UseZoomDrilldownReturn, } from './use-zoom-drilldown';
 export { useCountdown, type UseCountdownOptions, type UseCountdownReturn, } from './use-countdown';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.js

@@ -1,33 +1,33 @@
 import { u as A } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
 import { u as D } from "../_chunks/use-media-query-CcAx5SMM.js";
-import { u as F, a as g } from "../_chunks/use-signing-session-CyOZWinp.js";
-import { u as _ } from "../_chunks/use-count-up-BLLetaZ8.js";
-import { u as P } from "../_chunks/use-locale-BkCIHujH.js";
-import { A as k, T as K, a as V, r as H, t as M, u as Y } from "../_chunks/use-theme-CAuo6EYT.js";
+import { Z as w, u as _, a as F, b as I } from "../_chunks/use-zoom-drilldown-qCX34w9I.js";
+import { u as R } from "../_chunks/use-count-up-BLLetaZ8.js";
+import { u as k } from "../_chunks/use-locale-BkCIHujH.js";
+import { A as M, T as V, a as H, r as N, t as Y, u as Z } from "../_chunks/use-theme-CAuo6EYT.js";
 import { u as B } from "../_chunks/use-controllable-state-BiY4xTzM.js";
 import { u as U } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
-import { u as z } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
+import { u as j } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
 import { useState as E, useRef as b, useEffect as x } from "react";
-import { u as W, a as J } from "../_chunks/use-direction-Dp8h70PP.js";
-import { u as X } from "../_chunks/use-persistent-state-nZwZAnE9.js";
-import { u as $ } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
-import { u as te } from "../_chunks/use-overflow-collapse-BIOzKbni.js";
-import { c as oe, u as ue } from "../_chunks/use-priority-overflow-c9SjxZkZ.js";
-import { u as se } from "../_chunks/use-web-otp-D_utzp6S.js";
-import { u as ie } from "../_chunks/use-visual-viewport-pin-ChurOsHM.js";
-import { u as fe } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
-import { u as me } from "../_chunks/use-countdown-Yd6ts0_a.js";
-function y(e, o) {
+import { u as Q, a as J } from "../_chunks/use-direction-Dp8h70PP.js";
+import { u as $ } from "../_chunks/use-persistent-state-nZwZAnE9.js";
+import { u as te } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
+import { u as oe } from "../_chunks/use-overflow-collapse-BIOzKbni.js";
+import { c as se, u as ne } from "../_chunks/use-priority-overflow-c9SjxZkZ.js";
+import { u as ie } from "../_chunks/use-web-otp-D_utzp6S.js";
+import { u as le } from "../_chunks/use-visual-viewport-pin-ChurOsHM.js";
+import { u as me } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
+import { u as pe } from "../_chunks/use-countdown-Yd6ts0_a.js";
+function C(e, o) {
   const [t, i] = E(e), u = b(null);
   return x(() => {
     if (o <= 0) {
       u.current !== null && (clearTimeout(u.current), u.current = null), i(e);
       return;
     }
-    const s = setTimeout(() => {
+    const n = setTimeout(() => {
       i(e), u.current = null;
     }, o);
-    return u.current = s, () => clearTimeout(s);
+    return u.current = n, () => clearTimeout(n);
   }, [e, o]), t;
 }
 const T = [
@@ -54,31 +54,31 @@ function p(e) {
     return !0;
   });
 }
-function C(e, o = {}) {
-  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, s = b(null);
+function y(e, o = {}) {
+  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, n = b(null);
   x(() => {
     if (!t) return;
     const a = e.current;
     if (!a) return;
-    if (s.current = typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null, i) {
-      const n = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
-      n == null || n.focus();
+    if (n.current = typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null, i) {
+      const s = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
+      s == null || s.focus();
     }
-    function l(r) {
+    function f(r) {
       if (r.key !== "Tab") return;
-      const n = e.current;
-      if (!n) return;
-      const c = p(n);
+      const s = e.current;
+      if (!s) return;
+      const c = p(s);
       if (c.length === 0) {
         r.preventDefault();
         return;
       }
-      const m = c[0], d = c[c.length - 1], f = document.activeElement;
-      r.shiftKey ? (f === m || !n.contains(f)) && (r.preventDefault(), d.focus()) : (f === d || !n.contains(f)) && (r.preventDefault(), m.focus());
+      const m = c[0], d = c[c.length - 1], l = document.activeElement;
+      r.shiftKey ? (l === m || !s.contains(l)) && (r.preventDefault(), d.focus()) : (l === d || !s.contains(l)) && (r.preventDefault(), m.focus());
     }
-    return a.addEventListener("keydown", l), () => {
-      if (a.removeEventListener("keydown", l), u && s.current) {
-        const r = s.current;
+    return a.addEventListener("keydown", f), () => {
+      if (a.removeEventListener("keydown", f), u && n.current) {
+        const r = n.current;
         requestAnimationFrame(() => {
           r.isConnected && r.focus();
         });
@@ -87,33 +87,35 @@ function C(e, o = {}) {
   }, [t, i, u, e]);
 }
 export {
-  k as ACCESSIBILITY_STORAGE_KEY,
-  K as THEME_CLASS,
-  V as THEME_STORAGE_KEY,
-  oe as computePriorityLayout,
-  H as resolveTheme,
-  M as themeClassList,
+  M as ACCESSIBILITY_STORAGE_KEY,
+  V as THEME_CLASS,
+  H as THEME_STORAGE_KEY,
+  w as ZOOM_DRILLDOWN_TRANSITION_CLASS,
+  se as computePriorityLayout,
+  N as resolveTheme,
+  Y as themeClassList,
   B as useControllableState,
   U as useCopyToClipboard,
-  _ as useCountUp,
-  me as useCountdown,
-  z as useDebouncedCallback,
-  y as useDebouncedValue,
-  W as useDirection,
+  R as useCountUp,
+  pe as useCountdown,
+  j as useDebouncedCallback,
+  C as useDebouncedValue,
+  Q as useDirection,
   J as useDocumentDirection,
-  fe as useEdgeResize,
-  C as useFocusTrap,
-  $ as useIsomorphicLayoutEffect,
-  P as useLocale,
+  me as useEdgeResize,
+  y as useFocusTrap,
+  te as useIsomorphicLayoutEffect,
+  k as useLocale,
   D as useMediaQuery,
-  te as useOverflowCollapse,
-  X as usePersistentState,
+  oe as useOverflowCollapse,
+  $ as usePersistentState,
   A as usePrefersReducedMotion,
-  ue as usePriorityOverflow,
-  F as useScrollToFirstError,
-  g as useSigningSession,
-  Y as useTheme,
-  ie as useVisualViewportPin,
-  se as useWebOtp
+  ne as usePriorityOverflow,
+  _ as useScrollToFirstError,
+  F as useSigningSession,
+  Z as useTheme,
+  le as useVisualViewportPin,
+  ie as useWebOtp,
+  I as useZoomDrilldown
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/use-zoom-drilldown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The `view-transition-class` the shipped CSS targets. Add it as a class name
+ * to the source element and the detail, next to their shared
+ * `view-transition-name`. The kit sheet maps the class to the property.
+ */
+export declare const ZOOM_DRILLDOWN_TRANSITION_CLASS: "ds-zoom-drilldown";
+export interface UseZoomDrilldownOptions {
+    /** Resolver for the scroll container whose scrollTop should be preserved
+     *  across the transition. Defaults to the nearest `<main>` element in
+     *  the document (or the Radix ScrollArea viewport around it). The window
+     *  scroll position is always tracked alongside. */
+    getScrollContainer?: () => HTMLElement | null;
+}
+export interface UseZoomDrilldownReturn<Id extends string> {
+    /** The open drill-down target, or `null` while the source view shows. */
+    readonly selected: Id | null;
+    /** Zoom into `id`: saves the scroll position and enters at the top. */
+    readonly open: (id: Id) => void;
+    /** Zoom back out and restore the saved scroll position. */
+    readonly close: () => void;
+}
+export declare function useZoomDrilldown<Id extends string>(options?: UseZoomDrilldownOptions): UseZoomDrilldownReturn<Id>;
+//# sourceMappingURL=use-zoom-drilldown.d.ts.map

package/dist/host-compat.css

@@ -202,7 +202,7 @@
 
 /* ───────────────────────────────────────────────────────────────────────
    SECTION B — non-token declarations.  ORIGINAL LAYER PRESERVED.
-   129 declarations across 125 rules.
+   130 declarations across 126 rules.
 
    Kit-authored arbitrary-value utilities (`ds:w-[20rem]`) and the
    vendored AG Grid rules. These set real properties on real elements,
@@ -469,6 +469,9 @@
   .ds\:auto-rows-\[19rem\] {
     grid-auto-rows:304px;
   }
+  .ds\:auto-rows-\[22rem\] {
+    grid-auto-rows:352px;
+  }
   .ds\:auto-rows-\[minmax\(12rem\,auto\)\] {
     grid-auto-rows:minmax(192px,auto);
   }