@actioneer/ads 0.2.4 → 0.3.1

package/components/ai-elements/message.js

@@ -1,11 +1,11 @@
 "use client";
-import { jsx as r, jsxs as f, Fragment as w } from "react/jsx-runtime";
+import { jsx as r, jsxs as h, Fragment as w } from "react/jsx-runtime";
 import * as o from "react";
 import { cva as x } from "class-variance-authority";
-import { cn as l } from "../../lib/cn.js";
-import { Button as h } from "../button.js";
+import { cn as i } from "../../lib/cn.js";
+import { Button as f } from "../button.js";
 import { Avatar as M } from "../avatar.js";
-import { Tooltip as _ } from "../tooltip.js";
+import { Tooltip as b } from "../tooltip.js";
 import { ChevronLeft as B, ChevronRight as R, Paperclip as A, Close as C } from "../../lib/icons.js";
 const z = x("group flex w-full max-w-[95%] flex-col gap-2", {
   variants: {
@@ -16,16 +16,16 @@ const z = x("group flex w-full max-w-[95%] flex-col gap-2", {
   },
   defaultVariants: { align: "start" }
 }), k = o.forwardRef(
-  ({ align: e, className: t, from: s, ...a }, n) => /* @__PURE__ */ r(
+  ({ align: e, className: t, from: a, ...s }, n) => /* @__PURE__ */ r(
     "div",
     {
       ref: n,
-      className: l(
-        z({ align: e ?? (s === "user" ? "end" : "start") }),
-        s === "user" ? "is-user" : "is-assistant",
+      className: i(
+        z({ align: e ?? "start" }),
+        a === "user" ? "is-user" : "is-assistant",
         t
       ),
-      ...a
+      ...s
     }
   )
 );
@@ -43,34 +43,60 @@ const P = x(
         flat: "w-fit group-[.is-user]:rounded-lg group-[.is-user]:bg-surface group-[.is-user]:px-3 group-[.is-user]:py-2 group-[.is-user]:text-foreground group-[.is-assistant]:text-foreground",
         // Plain: no fill, radius, or padding. Pair `align="start"` with a
         // user turn for the clean, left-aligned prompt treatment.
-        plain: "w-full text-foreground group-[.is-user]:text-lg"
+        plain: "w-full text-foreground group-[.is-user]:text-lg",
+        // Request: the user turn is a brief put forward for research, not a
+        // chat utterance — no fill, no rule, full width, set large and light
+        // so it leads the turn on size alone. The answer below is its body.
+        // `text-2xl` (26px) is the TOP of the type scale — the request must
+        // outrank every heading around it, including a `Heading level={1}`
+        // page title, or it stops reading as the thing being asked.
+        // `gap-4` sets the question-to-MessageMeta distance (16px): the
+        // parameters read as part of the request, and the thread's own
+        // turn gap (32px) is the larger break before the answer.
+        request: "w-full text-foreground group-[.is-user]:gap-4 group-[.is-user]:text-2xl group-[.is-user]:leading-snug"
       }
     },
-    defaultVariants: { variant: "contained" }
+    defaultVariants: { variant: "request" }
   }
-), T = o.forwardRef(({ children: e, className: t, variant: s, ...a }, n) => /* @__PURE__ */ r(
+), T = o.forwardRef(({ children: e, className: t, variant: a, ...s }, n) => /* @__PURE__ */ r(
   "div",
   {
     ref: n,
-    className: l(P({ variant: s }), t),
-    ...a,
+    className: i(P({ variant: a }), t),
+    ...s,
     children: e
   }
 ));
 T.displayName = "MessageContent";
-const j = o.forwardRef(({ src: e, name: t, className: s, ...a }, n) => /* @__PURE__ */ r(
+const j = o.forwardRef(
+  ({ className: e, ...t }, a) => /* @__PURE__ */ r(
+    "div",
+    {
+      ref: a,
+      "data-slot": "message-meta",
+      className: i(
+        "flex flex-wrap items-center gap-x-2 gap-y-1.5",
+        "text-xs font-normal leading-normal tracking-normal text-tertiary",
+        e
+      ),
+      ...t
+    }
+  )
+);
+j.displayName = "MessageMeta";
+const V = o.forwardRef(({ src: e, name: t, className: a, ...s }, n) => /* @__PURE__ */ r(
   M,
   {
     ref: n,
     src: e,
     name: t,
     size: "sm",
-    className: l("ring-2 ring-background", s),
-    ...a
+    className: i("ring-2 ring-background", a),
+    ...s
   }
 ));
-j.displayName = "MessageAvatar";
-const V = l(
+V.displayName = "MessageAvatar";
+const S = i(
   "size-full text-base leading-relaxed text-foreground",
   "[&>*:first-child]:mt-0 [&>*:last-child]:mb-0",
   "[&_p]:my-2",
@@ -81,64 +107,70 @@ const V = l(
   "[&_a]:font-medium [&_a]:underline [&_a]:underline-offset-2",
   "[&_code]:rounded-xs [&_code]:bg-muted [&_code]:px-1 [&_code]:py-0.5 [&_code]:text-xs [&_code]:tabular-nums",
   "[&_pre]:my-3 [&_pre]:overflow-x-auto [&_pre]:rounded-lg [&_pre]:bg-surface [&_pre]:p-3 [&_pre]:text-xs [&_pre_code]:bg-transparent [&_pre_code]:p-0",
-  "[&_table]:my-3 [&_table]:w-full [&_table]:text-xs [&_th]:px-2 [&_th]:py-1.5 [&_th]:text-left [&_th]:font-bold [&_td]:px-2 [&_td]:py-1.5 [&_thead]:text-secondary"
-), S = o.memo(
+  // Markdown tables only. Scoped off `[data-slot=table]` so a composed ADS
+  // <Table> nested in a response keeps its own padding and per-column
+  // alignment — unscoped, these descendant rules silently beat it.
+  "[&_table:not([data-slot=table])]:my-3 [&_table:not([data-slot=table])]:w-full [&_table:not([data-slot=table])]:text-xs",
+  "[&_table:not([data-slot=table])_th]:px-2 [&_table:not([data-slot=table])_th]:py-1.5 [&_table:not([data-slot=table])_th]:text-left [&_table:not([data-slot=table])_th]:font-bold",
+  "[&_table:not([data-slot=table])_td]:px-2 [&_table:not([data-slot=table])_td]:py-1.5",
+  "[&_table:not([data-slot=table])_thead]:text-secondary"
+), W = o.memo(
   o.forwardRef(
-    ({ className: e, children: t, ...s }, a) => /* @__PURE__ */ r("div", { ref: a, className: l(V, e), ...s, children: t })
+    ({ className: e, children: t, ...a }, s) => /* @__PURE__ */ r("div", { ref: s, className: i(S, e), ...a, children: t })
   ),
   (e, t) => e.children === t.children
 );
-S.displayName = "MessageResponse";
-const W = o.forwardRef(({ className: e, children: t, ...s }, a) => /* @__PURE__ */ r(
+W.displayName = "MessageResponse";
+const q = o.forwardRef(({ className: e, children: t, ...a }, s) => /* @__PURE__ */ r(
   "div",
   {
-    ref: a,
-    className: l("flex items-center gap-1", e),
-    ...s,
+    ref: s,
+    className: i("flex items-center gap-1", e),
+    ...a,
     children: t
   }
 ));
-W.displayName = "MessageActions";
+q.displayName = "MessageActions";
 const E = o.forwardRef(
-  ({ tooltip: e, children: t, label: s, variant: a = "ghost", size: n = "icon-sm", ...i }, d) => {
-    const c = /* @__PURE__ */ f(h, { ref: d, size: n, type: "button", variant: a, ...i, children: [
+  ({ tooltip: e, children: t, label: a, variant: s = "ghost", size: n = "icon-sm", ...l }, d) => {
+    const c = /* @__PURE__ */ h(f, { ref: d, size: n, type: "button", variant: s, ...l, children: [
       t,
-      /* @__PURE__ */ r("span", { className: "sr-only", children: s || e })
+      /* @__PURE__ */ r("span", { className: "sr-only", children: a || e })
     ] });
-    return e ? /* @__PURE__ */ r(_, { content: e, children: c }) : c;
+    return e ? /* @__PURE__ */ r(b, { content: e, children: c }) : c;
   }
 );
 E.displayName = "MessageAction";
-const b = o.createContext(null), g = () => {
-  const e = o.useContext(b);
+const _ = o.createContext(null), g = () => {
+  const e = o.useContext(_);
   if (!e)
     throw new Error(
       "MessageBranch components must be used within MessageBranch"
     );
   return e;
-}, I = o.forwardRef(({ defaultBranch: e = 0, onBranchChange: t, className: s, ...a }, n) => {
-  const [i, d] = o.useState(e), [c, m] = o.useState([]), p = (u) => {
+}, I = o.forwardRef(({ defaultBranch: e = 0, onBranchChange: t, className: a, ...s }, n) => {
+  const [l, d] = o.useState(e), [c, m] = o.useState([]), p = (u) => {
     d(u), t == null || t(u);
   }, v = () => {
-    const u = i > 0 ? i - 1 : c.length - 1;
+    const u = l > 0 ? l - 1 : c.length - 1;
     p(u);
   }, y = () => {
-    const u = i < c.length - 1 ? i + 1 : 0;
+    const u = l < c.length - 1 ? l + 1 : 0;
     p(u);
   }, N = {
-    currentBranch: i,
+    currentBranch: l,
     totalBranches: c.length,
     goToPrevious: v,
     goToNext: y,
     branches: c,
     setBranches: m
   };
-  return /* @__PURE__ */ r(b.Provider, { value: N, children: /* @__PURE__ */ r(
+  return /* @__PURE__ */ r(_.Provider, { value: N, children: /* @__PURE__ */ r(
     "div",
     {
       ref: n,
-      className: l("grid w-full gap-2 [&>div]:pb-0", s),
-      ...a
+      className: i("grid w-full gap-2 [&>div]:pb-0", a),
+      ...s
     }
   ) });
 });
@@ -147,17 +179,17 @@ const L = ({
   children: e,
   ...t
 }) => {
-  const { currentBranch: s, setBranches: a, branches: n } = g(), i = o.Children.toArray(
+  const { currentBranch: a, setBranches: s, branches: n } = g(), l = o.Children.toArray(
     e
   );
   return o.useEffect(() => {
-    n.length !== i.length && a(i);
-  }, [i, n, a]), /* @__PURE__ */ r(w, { children: i.map((d, c) => /* @__PURE__ */ r(
+    n.length !== l.length && s(l);
+  }, [l, n, s]), /* @__PURE__ */ r(w, { children: l.map((d, c) => /* @__PURE__ */ r(
     "div",
     {
-      className: l(
+      className: i(
         "grid gap-2 overflow-hidden [&>div]:pb-0",
-        c === s ? "block" : "hidden"
+        c === a ? "block" : "hidden"
       ),
       ...t,
       children: d
@@ -166,27 +198,27 @@ const L = ({
   )) });
 };
 L.displayName = "MessageBranchContent";
-const F = o.forwardRef(({ className: e, from: t, ...s }, a) => {
+const F = o.forwardRef(({ className: e, from: t, ...a }, s) => {
   const { totalBranches: n } = g();
   return n <= 1 ? null : /* @__PURE__ */ r(
     "div",
     {
-      ref: a,
-      className: l("inline-flex items-center gap-0.5", e),
-      ...s
+      ref: s,
+      className: i("inline-flex items-center gap-0.5", e),
+      ...a
     }
   );
 });
 F.displayName = "MessageBranchSelector";
-const q = o.forwardRef(({ children: e, ...t }, s) => {
-  const { goToPrevious: a, totalBranches: n } = g();
+const D = o.forwardRef(({ children: e, ...t }, a) => {
+  const { goToPrevious: s, totalBranches: n } = g();
   return /* @__PURE__ */ r(
-    h,
+    f,
     {
-      ref: s,
+      ref: a,
       "aria-label": "Previous branch",
       disabled: n <= 1,
-      onClick: a,
+      onClick: s,
       size: "icon-sm",
       type: "button",
       variant: "ghost",
@@ -195,16 +227,16 @@ const q = o.forwardRef(({ children: e, ...t }, s) => {
     }
   );
 });
-q.displayName = "MessageBranchPrevious";
-const D = o.forwardRef(({ children: e, ...t }, s) => {
-  const { goToNext: a, totalBranches: n } = g();
+D.displayName = "MessageBranchPrevious";
+const G = o.forwardRef(({ children: e, ...t }, a) => {
+  const { goToNext: s, totalBranches: n } = g();
   return /* @__PURE__ */ r(
-    h,
+    f,
     {
-      ref: s,
+      ref: a,
       "aria-label": "Next branch",
       disabled: n <= 1,
-      onClick: a,
+      onClick: s,
       size: "icon-sm",
       type: "button",
       variant: "ghost",
@@ -213,39 +245,39 @@ const D = o.forwardRef(({ children: e, ...t }, s) => {
     }
   );
 });
-D.displayName = "MessageBranchNext";
-const G = o.forwardRef(({ className: e, ...t }, s) => {
-  const { currentBranch: a, totalBranches: n } = g();
-  return /* @__PURE__ */ f(
+G.displayName = "MessageBranchNext";
+const H = o.forwardRef(({ className: e, ...t }, a) => {
+  const { currentBranch: s, totalBranches: n } = g();
+  return /* @__PURE__ */ h(
     "span",
     {
-      ref: s,
-      className: l(
+      ref: a,
+      className: i(
         "px-1.5 text-xs tabular-nums text-tertiary select-none",
         e
       ),
       ...t,
       children: [
-        a + 1,
+        s + 1,
         " of ",
         n
       ]
     }
   );
 });
-G.displayName = "MessageBranchPage";
-const H = o.forwardRef(({ data: e, className: t, onRemove: s, ...a }, n) => {
+H.displayName = "MessageBranchPage";
+const J = o.forwardRef(({ data: e, className: t, onRemove: a, ...s }, n) => {
   var m;
-  const i = e.filename || "", d = !!((m = e.mediaType) != null && m.startsWith("image/") && e.url), c = i || (d ? "Image" : "Attachment");
-  return /* @__PURE__ */ f(
+  const l = e.filename || "", d = !!((m = e.mediaType) != null && m.startsWith("image/") && e.url), c = l || (d ? "Image" : "Attachment");
+  return /* @__PURE__ */ h(
     "div",
     {
       ref: n,
-      className: l(
+      className: i(
         "group/attachment relative size-24 overflow-hidden rounded-lg bg-muted",
         t
       ),
-      ...a,
+      ...s,
       children: [
         d ? /* @__PURE__ */ r(
           "img",
@@ -254,17 +286,17 @@ const H = o.forwardRef(({ data: e, className: t, onRemove: s, ...a }, n) => {
             className: "size-full object-cover",
             src: e.url
           }
-        ) : /* @__PURE__ */ r(_, { content: c, children: /* @__PURE__ */ r("div", { className: "flex size-full items-center justify-center text-muted-foreground", children: /* @__PURE__ */ r(A, { className: "size-4" }) }) }),
-        s && /* @__PURE__ */ r(
-          h,
+        ) : /* @__PURE__ */ r(b, { content: c, children: /* @__PURE__ */ r("div", { className: "flex size-full items-center justify-center text-muted-foreground", children: /* @__PURE__ */ r(A, { className: "size-4" }) }) }),
+        a && /* @__PURE__ */ r(
+          f,
           {
             "aria-label": "Remove attachment",
-            className: l(
+            className: i(
               "absolute top-1.5 right-1.5 size-6 rounded-full p-0 opacity-0 transition-opacity group-hover/attachment:opacity-100",
               d && "bg-elevated/80 backdrop-blur-sm hover:bg-elevated"
             ),
             onClick: (p) => {
-              p.stopPropagation(), s();
+              p.stopPropagation(), a();
             },
             size: "icon-xs",
             type: "button",
@@ -276,47 +308,48 @@ const H = o.forwardRef(({ data: e, className: t, onRemove: s, ...a }, n) => {
     }
   );
 });
-H.displayName = "MessageAttachment";
-const J = o.forwardRef(({ children: e, className: t, ...s }, a) => e ? /* @__PURE__ */ r(
+J.displayName = "MessageAttachment";
+const K = o.forwardRef(({ children: e, className: t, ...a }, s) => e ? /* @__PURE__ */ r(
   "div",
   {
-    ref: a,
-    className: l(
+    ref: s,
+    className: i(
       "flex w-fit flex-wrap items-start gap-2 group-[.is-align-start]:mr-auto group-[.is-align-end]:ml-auto",
       t
     ),
-    ...s,
+    ...a,
     children: e
   }
 ) : null);
-J.displayName = "MessageAttachments";
-const K = o.forwardRef(({ className: e, children: t, ...s }, a) => /* @__PURE__ */ r(
+K.displayName = "MessageAttachments";
+const O = o.forwardRef(({ className: e, children: t, ...a }, s) => /* @__PURE__ */ r(
   "div",
   {
-    ref: a,
-    className: l(
+    ref: s,
+    className: i(
       "mt-3 flex w-full items-center justify-between gap-4",
       e
     ),
-    ...s,
+    ...a,
     children: t
   }
 ));
-K.displayName = "MessageToolbar";
+O.displayName = "MessageToolbar";
 export {
   k as Message,
   E as MessageAction,
-  W as MessageActions,
-  H as MessageAttachment,
-  J as MessageAttachments,
-  j as MessageAvatar,
+  q as MessageActions,
+  J as MessageAttachment,
+  K as MessageAttachments,
+  V as MessageAvatar,
   I as MessageBranch,
   L as MessageBranchContent,
-  D as MessageBranchNext,
-  G as MessageBranchPage,
-  q as MessageBranchPrevious,
+  G as MessageBranchNext,
+  H as MessageBranchPage,
+  D as MessageBranchPrevious,
   F as MessageBranchSelector,
   T as MessageContent,
-  S as MessageResponse,
-  K as MessageToolbar
+  j as MessageMeta,
+  W as MessageResponse,
+  O as MessageToolbar
 };

package/components/ai-elements/research-activity.d.ts

@@ -0,0 +1,62 @@
+import * as React from "react";
+export type ResearchActivityStatus = "active" | "complete";
+export interface ResearchActivityProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    status: ResearchActivityStatus;
+    /** Consumer-formatted elapsed or total time, for example `0:36`. */
+    elapsed: React.ReactNode;
+    sourceCount: number;
+    /** Consumer-formatted time to the first useful result. */
+    firstInsight?: React.ReactNode;
+    /**
+     * What the agent is doing right now, e.g. "Querying NPA movement". When
+     * provided, the active state renders as a single live line that morphs
+     * between steps — the trace stays behind a click instead of stacking above
+     * the answer. Without it, the active trace opens in full (legacy behavior).
+     */
+    activity?: React.ReactNode;
+    /** Keys the live-line morph. Required when `activity` is not a string. */
+    activityKey?: string | number;
+    /** 1-based position of the current step — renders a quiet "3 of 7" before the elapsed time. */
+    stepIndex?: number;
+    /** Total planned steps; the counter renders only when both are provided. */
+    stepCount?: number;
+    /** Replaces the generated completed summary. */
+    summary?: React.ReactNode;
+    /**
+     * Pin the summary/live line to the top of the scroll container while the
+     * trace beneath it scrolls. For long open traces, where the line would
+     * otherwise scroll away exactly when the run is still moving.
+     */
+    sticky?: boolean;
+    /**
+     * Show the disclosure chevron. Turn it off when the consumer controls `open`
+     * and the line is a status readout rather than a toggle — a chevron that
+     * does nothing is a false affordance.
+     */
+    collapsible?: boolean;
+    /**
+     * Where the summary/live line sits when the trace is open. `"bottom"` puts
+     * it directly beneath the steps — while running that is where the next step
+     * appears, and on completion it stays put rather than jumping back over the
+     * trace it just narrated. A CLOSED trace always shows its line at the top:
+     * it is then standing in for the whole trace, so it has to sit where the
+     * trace would be.
+     *
+     * Visual order only — the trigger stays before its content in the DOM.
+     */
+    activityPlacement?: "top" | "bottom";
+    /** Controlled disclosure of the trace. */
+    open?: boolean;
+    /** Initial disclosure state. */
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+}
+/**
+ * Streaming research disclosure. With an `activity`, the run reads as a single
+ * live line — the current step morphing in place while the full trace waits
+ * one click away — and completion settles the same line into a source/timing
+ * summary. A reader's expand/collapse choice sticks across the transition.
+ * Without an `activity`, the active trace stays fully open (legacy behavior).
+ */
+export declare const ResearchActivity: React.ForwardRefExoticComponent<ResearchActivityProps & React.RefAttributes<HTMLDivElement>>;