@actioneer/ads 1.0.8 → 1.0.10

package/components/breadcrumbs.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsxs as x, jsx as t, Fragment as k } from "react/jsx-runtime";
+import { jsxs as b, 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({
@@ -15,18 +15,18 @@ function B(a) {
   return null;
 }
 const C = r.forwardRef(
-  ({ className: a, children: n, sticky: e, actions: i, center: c, meta: f, ...p }, o) => {
-    const h = r.Children.toArray(n), b = r.useRef(null), m = r.useCallback(
+  ({ className: a, children: n, sticky: e, actions: i, center: c, meta: f, ...h }, o) => {
+    const p = r.Children.toArray(n), x = r.useRef(null), m = r.useCallback(
       (s) => {
-        b.current = s, typeof o == "function" ? o(s) : o && (o.current = s);
+        x.current = s, typeof o == "function" ? o(s) : o && (o.current = s);
       },
       [o]
     ), [l, g] = r.useState(!1);
     return r.useEffect(() => {
       if (!e) return;
-      const s = B(b.current), u = s ?? window, v = () => g((s ? s.scrollTop : window.scrollY) > 2);
+      const s = B(x.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(
+    }, [e]), /* @__PURE__ */ b(
       "nav",
       {
         ref: m,
@@ -44,10 +44,10 @@ const C = r.forwardRef(
           e && (l ? "border-b border-border" : "border-b border-transparent"),
           a
         ),
-        ...p,
+        ...h,
         children: [
-          /* @__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-base", children: /* @__PURE__ */ t(N.Provider, { value: { count: h.length }, children: h.map((s, u) => /* @__PURE__ */ t(w.Provider, { value: u, children: s }, u)) }) }),
+          /* @__PURE__ */ b("div", { className: "flex min-w-0 shrink items-baseline", children: [
+            /* @__PURE__ */ t("ol", { className: "flex min-w-0 shrink items-center gap-1.5 font-heading text-xl", children: /* @__PURE__ */ t(N.Provider, { value: { count: p.length }, children: p.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 }),
@@ -58,15 +58,15 @@ const C = r.forwardRef(
   }
 );
 C.displayName = "Breadcrumbs";
-const R = r.forwardRef(({ className: a, href: n, isCurrent: e, icon: i, children: c, ...f }, p) => {
-  const { count: o } = r.useContext(N), b = r.useContext(w) === o - 1, m = "inline-flex items-center gap-1.5", l = /* @__PURE__ */ x(k, { children: [
+const R = r.forwardRef(({ className: a, href: n, isCurrent: e, icon: i, children: c, ...f }, h) => {
+  const { count: o } = r.useContext(N), x = r.useContext(w) === o - 1, m = "inline-flex items-center gap-1.5", l = /* @__PURE__ */ b(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(m, "min-w-0 text-base font-medium text-primary"),
+      className: d(m, "min-w-0 text-xl font-medium text-primary"),
       children: l
     }
   ) : n ? /* @__PURE__ */ t(
@@ -81,10 +81,10 @@ const R = r.forwardRef(({ className: a, href: n, isCurrent: e, icon: i, children
       children: l
     }
   ) : /* @__PURE__ */ t("span", { className: d(m, "text-muted-foreground"), children: l });
-  return /* @__PURE__ */ x(
+  return /* @__PURE__ */ b(
     "li",
     {
-      ref: p,
+      ref: h,
       className: d(
         "flex items-center gap-1.5",
         e ? "min-w-0 shrink" : "shrink-0",
@@ -93,7 +93,7 @@ const R = r.forwardRef(({ className: a, href: n, isCurrent: e, icon: i, children
       ...f,
       children: [
         g,
-        !b && /* @__PURE__ */ t("span", { "aria-hidden": !0, className: "shrink-0 select-none text-border-strong", children: "/" })
+        !x && /* @__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

@@ -32,11 +32,14 @@ const x = v(
         danger: "bg-danger text-danger-foreground enabled:hover:bg-danger/90 enabled:active:bg-danger/90 focus-visible:ring-danger/40"
       },
       size: {
-        // Each size has its own height; the 14px Medium label never changes.
-        xs: "h-6 rounded-sm px-2 [&_svg]:size-3.5",
-        sm: "h-7 rounded-sm px-3 [&_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-10 rounded-md px-5 [&_svg]:size-5",
+        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"

package/components/card.js

@@ -3,14 +3,14 @@ import { jsx as t } from "react/jsx-runtime";
 import * as d from "react";
 import { cn as o } from "../lib/cn.js";
 const l = d.forwardRef(
-  ({ className: r, isHoverable: a, isPressable: e, children: s, ...n }, i) => {
+  ({ className: e, isHoverable: a, isPressable: r, children: s, ...n }, i) => {
     const c = o(
-      "bg-card text-card-foreground rounded-xl",
-      (e || a) && "transition-[box-shadow,transform] duration-150 ease-out motion-reduce:transition-none",
+      "rounded-card border border-border bg-card text-card-foreground shadow-card",
+      (r || a) && "transition-[box-shadow,transform] duration-150 ease-out motion-reduce:transition-none",
       a && "hover:-translate-y-0.5",
-      r
+      e
     );
-    return e ? /* @__PURE__ */ t(
+    return r ? /* @__PURE__ */ t(
       "button",
       {
         ref: i,
@@ -29,46 +29,46 @@ const l = d.forwardRef(
   }
 );
 l.displayName = "Card";
-const f = d.forwardRef(({ className: r, ...a }, e) => /* @__PURE__ */ t(
+const f = d.forwardRef(({ className: e, ...a }, r) => /* @__PURE__ */ t(
   "div",
   {
-    ref: e,
-    className: o("flex flex-col gap-1 px-5 pt-5", r),
+    ref: r,
+    className: o("flex flex-col gap-1 px-5 pt-5", e),
     ...a
   }
 ));
 f.displayName = "CardHeader";
-const m = d.forwardRef(({ className: r, ...a }, e) => /* @__PURE__ */ t(
+const m = d.forwardRef(({ className: e, ...a }, r) => /* @__PURE__ */ t(
   "h3",
   {
-    ref: e,
-    className: o("text-base font-medium leading-none", r),
+    ref: r,
+    className: o("text-base font-medium leading-none", e),
     ...a
   }
 ));
 m.displayName = "CardTitle";
-const p = d.forwardRef(({ className: r, ...a }, e) => /* @__PURE__ */ t(
+const p = d.forwardRef(({ className: e, ...a }, r) => /* @__PURE__ */ t(
   "p",
   {
-    ref: e,
-    className: o("text-xs text-muted-foreground", r),
+    ref: r,
+    className: o("text-xs text-muted-foreground", e),
     ...a
   }
 ));
 p.displayName = "CardDescription";
-const u = d.forwardRef(({ className: r, ...a }, e) => /* @__PURE__ */ t("div", { ref: e, className: o("px-5 py-4", r), ...a }));
+const u = d.forwardRef(({ className: e, ...a }, r) => /* @__PURE__ */ t("div", { ref: r, className: o("px-5 py-4", e), ...a }));
 u.displayName = "CardBody";
 const x = d.forwardRef(
-  ({ className: r, withBorder: a, ...e }, s) => /* @__PURE__ */ t(
+  ({ className: e, withBorder: a, ...r }, s) => /* @__PURE__ */ t(
     "div",
     {
       ref: s,
       className: o(
         "flex items-center px-5 pb-5 pt-4",
         a && "border-t border-border",
-        r
+        e
       ),
-      ...e
+      ...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,11 +121,22 @@ 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;
+    /**
+     * A soft wash under each observed line that fades from the series colour
+     * (20%) at the line down to nothing at the baseline — ON by default
+     * (user-mandated 2026-11-12, the Span trend-line look). It reads as the
+     * line's shadow, not as an area measurement: it never stacks, never takes a
+     * label or tooltip, and forecasts (dashed) stay unfilled. Pass `false` for
+     * bare lines.
+     */
+    gradientFill?: boolean;
 }
 export interface AreaChartProps extends BaseChartProps {
     curve?: "linear" | "natural" | "step";
@@ -123,7 +152,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 {