@actioneer/ads 1.0.7 → 1.0.9

package/components/breadcrumbs.js

@@ -1,12 +1,12 @@
 "use client";
-import { jsxs as v, jsx as t, Fragment as k } from "react/jsx-runtime";
+import { jsxs as x, jsx as t, Fragment as k } from "react/jsx-runtime";
 import * as r from "react";
 import { cn as d } from "../lib/cn.js";
 const N = r.createContext({
   count: 0
 }), w = r.createContext(0);
-function B(o) {
-  let n = (o == null ? void 0 : o.parentElement) ?? null;
+function B(a) {
+  let n = (a == null ? void 0 : a.parentElement) ?? null;
   for (; n; ) {
     const e = getComputedStyle(n).overflowY;
     if (e === "auto" || e === "scroll") return n;
@@ -15,31 +15,23 @@ function B(o) {
   return null;
 }
 const C = r.forwardRef(
-  ({
-    className: o,
-    children: n,
-    sticky: e,
-    actions: c,
-    center: i,
-    meta: f,
-    ...x
-  }, a) => {
-    const p = r.Children.toArray(n), b = r.useRef(null), u = r.useCallback(
+  ({ className: a, children: n, sticky: e, actions: i, center: c, meta: f, ...p }, l) => {
+    const h = r.Children.toArray(n), b = r.useRef(null), m = r.useCallback(
       (s) => {
-        b.current = s, typeof a == "function" ? a(s) : a && (a.current = s);
+        b.current = s, typeof l == "function" ? l(s) : l && (l.current = s);
       },
-      [a]
-    ), [l, h] = r.useState(!1);
+      [l]
+    ), [o, g] = r.useState(!1);
     return r.useEffect(() => {
       if (!e) return;
-      const s = B(b.current), m = s ?? window, g = () => h((s ? s.scrollTop : window.scrollY) > 2);
-      return g(), m.addEventListener("scroll", g, { passive: !0 }), () => m.removeEventListener("scroll", g);
-    }, [e]), /* @__PURE__ */ v(
+      const s = B(b.current), u = s ?? window, v = () => g((s ? s.scrollTop : window.scrollY) > 2);
+      return v(), u.addEventListener("scroll", v, { passive: !0 }), () => u.removeEventListener("scroll", v);
+    }, [e]), /* @__PURE__ */ x(
       "nav",
       {
-        ref: u,
+        ref: m,
         "aria-label": "Breadcrumb",
-        "data-stuck": e ? l ? "true" : "false" : void 0,
+        "data-stuck": e ? o ? "true" : "false" : void 0,
         className: d(
           "relative flex w-full items-center",
           e && "sticky top-0 z-40 bg-card transition-[border-color] duration-150 ease-out motion-reduce:transition-none",
@@ -49,56 +41,58 @@ const C = r.forwardRef(
           // background over that gap (a no-op at rest, where the strip is the
           // panel's empty padding).
           e && "before:absolute before:inset-x-0 before:-top-8 before:h-8 before:bg-inherit before:content-['']",
-          e && (l ? "border-b border-border" : "border-b border-transparent"),
-          o
+          e && (o ? "border-b border-border" : "border-b border-transparent"),
+          a
         ),
-        ...x,
+        ...p,
         children: [
-          /* @__PURE__ */ t("ol", { className: "flex min-w-0 shrink items-center gap-1.5 text-base", children: /* @__PURE__ */ t(N.Provider, { value: { count: p.length }, children: p.map((s, m) => /* @__PURE__ */ t(w.Provider, { value: m, children: s }, m)) }) }),
-          f && /* @__PURE__ */ t("div", { className: "ml-4 flex shrink-0 items-center gap-3 text-xs text-muted-foreground", children: f }),
-          i && /* @__PURE__ */ t("div", { className: "absolute left-1/2 top-1/2 z-50 flex -translate-x-1/2 -translate-y-1/2 items-center", children: i }),
-          c && /* @__PURE__ */ t("div", { className: "ml-auto flex shrink-0 items-center gap-2 pl-4", children: c })
+          /* @__PURE__ */ x("div", { className: "flex min-w-0 shrink items-baseline", children: [
+            /* @__PURE__ */ t("ol", { className: "flex min-w-0 shrink items-center gap-1.5 text-l", children: /* @__PURE__ */ t(N.Provider, { value: { count: h.length }, children: h.map((s, u) => /* @__PURE__ */ t(w.Provider, { value: u, children: s }, u)) }) }),
+            f && /* @__PURE__ */ t("div", { className: "ml-3 flex shrink-0 items-baseline gap-3 text-s text-tertiary", children: f })
+          ] }),
+          c && /* @__PURE__ */ t("div", { className: "absolute left-1/2 top-1/2 z-50 flex -translate-x-1/2 -translate-y-1/2 items-center", children: c }),
+          i && /* @__PURE__ */ t("div", { className: "ml-auto flex shrink-0 items-center gap-2 pl-4", children: i })
         ]
       }
     );
   }
 );
 C.displayName = "Breadcrumbs";
-const R = r.forwardRef(({ className: o, href: n, isCurrent: e, icon: c, children: i, ...f }, x) => {
-  const { count: a } = r.useContext(N), b = r.useContext(w) === a - 1, u = "inline-flex items-center gap-1.5", l = /* @__PURE__ */ v(k, { children: [
-    c && /* @__PURE__ */ t("span", { "aria-hidden": !0, className: "flex shrink-0 items-center [&_svg]:size-4", children: c }),
-    e ? /* @__PURE__ */ t("span", { className: "min-w-0 truncate", children: i }) : i
-  ] }), h = e ? /* @__PURE__ */ t(
+const R = r.forwardRef(({ className: a, href: n, isCurrent: e, icon: i, children: c, ...f }, p) => {
+  const { count: l } = r.useContext(N), b = r.useContext(w) === l - 1, m = "inline-flex items-center gap-1.5", o = /* @__PURE__ */ x(k, { children: [
+    i && /* @__PURE__ */ t("span", { "aria-hidden": !0, className: "flex shrink-0 items-center [&_svg]:size-4", children: i }),
+    e ? /* @__PURE__ */ t("span", { className: "min-w-0 truncate", children: c }) : c
+  ] }), g = e ? /* @__PURE__ */ t(
     "span",
     {
       "aria-current": "page",
-      className: d(u, "min-w-0 text-base font-medium text-primary"),
-      children: l
+      className: d(m, "min-w-0 text-l font-medium text-primary"),
+      children: o
     }
   ) : n ? /* @__PURE__ */ t(
     "a",
     {
       href: n,
       className: d(
-        u,
+        m,
         "font-normal text-muted-foreground transition-colors hover:text-foreground",
         "outline-none focus-visible:ring-3 focus-visible:ring-ring rounded-sm"
       ),
-      children: l
+      children: o
     }
-  ) : /* @__PURE__ */ t("span", { className: d(u, "text-muted-foreground"), children: l });
-  return /* @__PURE__ */ v(
+  ) : /* @__PURE__ */ t("span", { className: d(m, "text-muted-foreground"), children: o });
+  return /* @__PURE__ */ x(
     "li",
     {
-      ref: x,
+      ref: p,
       className: d(
         "flex items-center gap-1.5",
         e ? "min-w-0 shrink" : "shrink-0",
-        o
+        a
       ),
       ...f,
       children: [
-        h,
+        g,
         !b && /* @__PURE__ */ t("span", { "aria-hidden": !0, className: "shrink-0 select-none text-border-strong", children: "/" })
       ]
     }

package/components/button.d.ts

@@ -4,7 +4,22 @@ export declare const buttonVariants: (props?: ({
     variant?: "link" | "danger" | "outline" | "solid" | "secondary" | "ghost" | null | undefined;
     size?: "xs" | "sm" | "md" | "lg" | "icon" | "icon-sm" | "icon-xs" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
-export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+/** Every accepted `size` value, including the deprecated aliases. */
+export type ButtonSize = "md" | "lg" | "icon" | "icon-sm" | "icon-xs"
+/** @deprecated Renders identically to `md` (32px). Use `md`. */
+ | "xs"
+/** @deprecated Renders identically to `md` (32px). Use `md`. */
+ | "sm";
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, Omit<VariantProps<typeof buttonVariants>, "size"> {
+    /**
+     * Button height. ADS has exactly two text-button heights: `md` (32px, the
+     * default) and `lg` (48px, 20px inline padding, radius-l). Icon-only sizes
+     * (`icon`, `icon-sm`, `icon-xs`) stay 32px tall.
+     *
+     * `xs` and `sm` are deprecated aliases kept for backward compatibility —
+     * they render identically to `md`.
+     */
+    size?: ButtonSize | null;
     isLoading?: boolean;
     startContent?: React.ReactNode;
     endContent?: React.ReactNode;

package/components/button.js

@@ -1,12 +1,13 @@
 "use client";
-import { jsxs as t, jsx as m } from "react/jsx-runtime";
-import * as p from "react";
-import { cva as u } from "class-variance-authority";
-import { cn as n } from "../lib/cn.js";
-import { Spinner as v } from "./spinner.js";
-const f = u(
+import { jsx as o, jsxs as d } from "react/jsx-runtime";
+import * as u from "react";
+import { cva as v } from "class-variance-authority";
+import { cn as i } from "../lib/cn.js";
+import { IconHoverFillContext as f } from "../lib/icons.js";
+import { Spinner as h } from "./spinner.js";
+const x = v(
   [
-    "relative inline-flex h-8 items-center justify-center gap-2 whitespace-nowrap",
+    "relative inline-flex items-center justify-center gap-2 whitespace-nowrap",
     "cursor-pointer text-m font-medium select-none",
     "rounded-md border border-transparent",
     "transition-[background,border,color,box-shadow,transform] duration-150 ease-out motion-reduce:transition-none",
@@ -21,88 +22,100 @@ const f = u(
   {
     variants: {
       variant: {
-        solid: "bg-action-primary text-action-primary-foreground shadow-[var(--inner-glow-cta)] enabled:hover:bg-action-primary-hover enabled:active:bg-action-primary-hover",
+        solid: "bg-action-primary text-action-primary-foreground enabled:hover:bg-action-primary-hover enabled:active:bg-action-primary-hover",
         secondary: "border-action-primary bg-transparent text-action-primary-text shadow-none enabled:hover:bg-action-primary-soft enabled:active:bg-action-primary-soft",
         outline: "border-border bg-transparent text-foreground enabled:hover:border-action-primary enabled:hover:bg-action-primary-soft enabled:hover:text-action-primary-text enabled:active:border-action-primary enabled:active:bg-action-primary-soft enabled:active:text-action-primary-text",
-        ghost: "bg-transparent text-foreground enabled:hover:bg-action-primary-soft enabled:hover:text-action-primary-text enabled:active:bg-action-primary-soft enabled:active:text-action-primary-text",
-        link: "bg-transparent text-foreground underline-offset-4 enabled:hover:bg-action-primary-soft enabled:hover:text-action-primary-text enabled:hover:underline enabled:active:bg-action-primary-soft enabled:active:text-action-primary-text active:scale-none",
-        danger: "bg-danger text-danger-foreground shadow-[var(--inner-glow-cta)] enabled:hover:bg-danger/90 enabled:active:bg-danger/90 focus-visible:ring-danger/40"
+        // Ghost answers hover with a WG12 outline and no fill; the label stays neutral.
+        ghost: "bg-transparent text-foreground enabled:hover:border-foreground enabled:active:border-foreground",
+        // Link only recolours its label on hover — no fill, no underline.
+        link: "bg-transparent text-foreground enabled:hover:text-action-primary-text enabled:active:text-action-primary-text active:scale-none",
+        danger: "bg-danger text-danger-foreground enabled:hover:bg-danger/90 enabled:active:bg-danger/90 focus-visible:ring-danger/40"
       },
       size: {
-        xs: "rounded-sm px-2.5 [&_svg]:size-3.5",
-        sm: "rounded-sm px-3 [&_svg]:size-4",
-        md: "rounded-md px-3.5 [&_svg]:size-4",
-        lg: "rounded-md px-4 [&_svg]:size-5",
-        icon: "w-9 rounded-md [&_svg]:size-4",
-        "icon-sm": "w-8 rounded-sm [&_svg]:size-4",
-        "icon-xs": "w-7 rounded-sm [&_svg]:size-4"
+        // ADS has exactly two button heights: md (32px, default) and lg
+        // (48px). The 14px Medium label never changes between them.
+        // xs/sm are deprecated aliases kept for backward compatibility —
+        // they render identically to md.
+        xs: "h-8 rounded-md px-3.5 [&_svg]:size-4",
+        sm: "h-8 rounded-md px-3.5 [&_svg]:size-4",
+        md: "h-8 rounded-md px-3.5 [&_svg]:size-4",
+        lg: "h-12 rounded-lg px-5 [&_svg]:size-5",
+        icon: "h-8 w-9 rounded-md [&_svg]:size-4",
+        "icon-sm": "h-8 w-8 rounded-sm [&_svg]:size-4",
+        "icon-xs": "h-8 w-7 rounded-sm [&_svg]:size-4"
       }
     },
     defaultVariants: { variant: "solid", size: "md" }
   }
-), x = {
+), y = {
   solid: "disabled:border-transparent disabled:bg-action-primary disabled:text-action-primary-foreground disabled:shadow-none",
   secondary: "disabled:border-action-primary disabled:bg-transparent disabled:text-action-primary-text disabled:shadow-none",
   outline: "disabled:border-border disabled:bg-transparent disabled:text-foreground disabled:shadow-none",
   ghost: "disabled:border-transparent disabled:bg-transparent disabled:text-foreground disabled:shadow-none",
   link: "disabled:border-transparent disabled:bg-transparent disabled:text-foreground disabled:shadow-none",
   danger: "disabled:border-transparent disabled:bg-danger disabled:text-danger-foreground disabled:shadow-none"
-}, y = p.forwardRef(
+}, w = u.forwardRef(
   ({
-    className: o,
-    variant: r,
-    size: i,
-    isLoading: e = !1,
-    startContent: d,
-    endContent: s,
-    fullWidth: b,
-    disabled: a,
-    children: l,
-    ...c
-  }, g) => /* @__PURE__ */ t(
-    "button",
-    {
-      ref: g,
-      disabled: a || e,
-      "aria-busy": e || void 0,
-      "data-loading": e || void 0,
-      className: n(
-        f({ variant: r, size: i }),
-        b && "w-full",
-        e ? x[r ?? "solid"] : a && "opacity-30",
-        o
-      ),
-      ...c,
-      children: [
-        e && /* @__PURE__ */ m(
-          v,
-          {
-            variant: "action",
-            size: "sm",
-            className: "absolute",
-            "aria-hidden": !0
-          }
+    className: s,
+    variant: e,
+    size: t,
+    isLoading: r = !1,
+    startContent: b,
+    endContent: l,
+    fullWidth: c,
+    disabled: n,
+    children: g,
+    ...p
+  }, m) => {
+    const a = typeof t == "string" && t.startsWith("icon") && (e === "ghost" || e === "outline" || e === "link");
+    return /* @__PURE__ */ o(f.Provider, { value: a, children: /* @__PURE__ */ d(
+      "button",
+      {
+        ref: m,
+        disabled: n || r,
+        "aria-busy": r || void 0,
+        "data-loading": r || void 0,
+        "data-icon-hover-fill": a || void 0,
+        className: i(
+          x({ variant: e, size: t }),
+          a && "enabled:hover:bg-transparent enabled:active:bg-transparent enabled:hover:text-action-primary enabled:active:text-action-primary",
+          a && e === "ghost" && "enabled:hover:border-transparent enabled:active:border-transparent",
+          c && "w-full",
+          r ? y[e ?? "solid"] : n && "opacity-30",
+          s
         ),
-        /* @__PURE__ */ t(
-          "span",
-          {
-            className: n(
-              "inline-flex items-center gap-1.5",
-              e && "opacity-0"
-            ),
-            children: [
-              d,
-              l,
-              s
-            ]
-          }
-        )
-      ]
-    }
-  )
+        ...p,
+        children: [
+          r && /* @__PURE__ */ o(
+            h,
+            {
+              variant: "action",
+              size: "sm",
+              className: "absolute",
+              "aria-hidden": !0
+            }
+          ),
+          /* @__PURE__ */ d(
+            "span",
+            {
+              className: i(
+                "inline-flex items-center gap-1.5",
+                r && "opacity-0"
+              ),
+              children: [
+                b,
+                g,
+                l
+              ]
+            }
+          )
+        ]
+      }
+    ) });
+  }
 );
-y.displayName = "Button";
+w.displayName = "Button";
 export {
-  y as Button,
-  f as buttonVariants
+  w as Button,
+  x as buttonVariants
 };

package/components/card.js

@@ -6,7 +6,7 @@ const l = d.forwardRef(
   ({ className: r, isHoverable: a, isPressable: e, children: s, ...n }, i) => {
     const c = o(
       "bg-card text-card-foreground rounded-xl",
-      (e || a) && "shadow-elevation transition-[box-shadow,transform] duration-150 ease-out motion-reduce:transition-none",
+      (e || a) && "transition-[box-shadow,transform] duration-150 ease-out motion-reduce:transition-none",
       a && "hover:-translate-y-0.5",
       r
     );

package/components/chart.d.ts

@@ -2,6 +2,8 @@ import * as React from "react";
 /** One row of chart data. Gaps (null/undefined) render as breaks in the series. */
 export type ChartDatum = Record<string, string | number | null | undefined>;
 export type ChartColor = "primary" | "success" | "warning" | "danger" | "info";
+/** Where a cartesian chart's series legend sits — see `BaseChartProps.legendPlacement`. */
+export type ChartLegendPlacement = "header" | "top";
 /** Bounded Recharts domain surface — enough for fixed and data-driven axes. */
 export type ChartAxisDomain = [string | number, string | number];
 export type ChartTickFormatter = (value: string | number) => string | number;
@@ -82,6 +84,22 @@ interface BaseChartProps {
     grid?: boolean;
     /** Defaults to on when there is more than one series. */
     legend?: boolean;
+    /**
+     * Chart title, rendered in the chart's own header row (16px Medium). Spend
+     * the words on what the plot measures; scope goes in `subtitle`.
+     */
+    title?: React.ReactNode;
+    /** Scope line under the title — count, range, share (e.g. "442 calls · past 7 days"). */
+    subtitle?: React.ReactNode;
+    /**
+     * Where the series legend sits.
+     *   • `"header"` — right-aligned at the end of the header row, opposite the
+     *     title block, with 36px between the header and the plot. The default
+     *     whenever a `title` or `subtitle` is set.
+     *   • `"top"` — its own right-aligned row directly above the plot (12px
+     *     gap). The default for an untitled chart (unchanged behavior).
+     */
+    legendPlacement?: ChartLegendPlacement;
     showYAxis?: boolean;
     formatValue?: (value: number) => string;
     /** Numeric/time x-axis scale. Time data must use numeric timestamps. */
@@ -103,9 +121,11 @@ export interface LineChartProps extends BaseChartProps {
     /** When set, only these series keys animate on mount/update. */
     animatedSeriesKeys?: string[];
     /**
-     * Print each observation's value above its dot. On by default for a SINGLE
-     * series (the reader shouldn't have to hover to read a number that fits);
-     * off once there are several, where the labels would collide.
+     * Print each observation's value above its dot — ON by default for every
+     * series, so the numbers read without hovering (tooltips still work). The
+     * label takes its series color; light series (amber chart-2, grey chart-6,
+     * the context grey) use the secondary text color for contrast. Resting
+     * labels step aside while the plot is hovered. Pass `false` to opt out.
      */
     showValues?: boolean;
 }
@@ -123,7 +143,14 @@ export interface BarChartProps extends BaseChartProps {
     stacked?: boolean;
     /** Visual bar direction: vertical columns (default) or horizontal bars. */
     layout?: "vertical" | "horizontal";
-    /** Print each bar's value past its end. On by default for a single series. */
+    /**
+     * Print values without hovering — ON by default (pass `false` to opt out).
+     * Single-series and grouped bars print their value past the bar's end in
+     * secondary text. Stacked bars print each segment's value centred inside it
+     * when the segment is at least 20px along the value axis (white ink on dark
+     * series, primary ink on light amber/grey), plus the stack total past the
+     * stack in Medium primary text. Tooltips still work on hover.
+     */
     showValues?: boolean;
 }
 export interface ComboChartProps extends BaseChartProps {