@actioneer/ads 0.5.5 → 0.5.7

package/components/ai-elements/chain-of-thought.d.ts

@@ -116,7 +116,7 @@ export declare const ChainOfThoughtEvidenceTable: import('react').MemoExoticComp
 export type ChainOfThoughtMetricsProps = ComponentProps<"div">;
 /** The stat readout on one recessed fill — the warm greige muted surface
  *  groups the metrics into a single contained block (principle 1: delineate
- *  with fill, never a stroke; a sage-50 tint was tried and reverted — the
+ *  with fill, never a stroke; a tinted fill was tried and reverted — the
  *  neutral fill keeps the semantic value colors as the only color). One
  *  metric per ROW, receipt-style: label leading, value trailing, so the
  *  figures align on the right edge and scan vertically. */

package/components/answer-sources.d.ts

@@ -0,0 +1,42 @@
+import { DrawerProps } from './drawer';
+import * as React from "react";
+export interface AnswerSourcesProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Total referenced nodes represented by the source chips. */
+    count: number;
+    /** Label before the count. Defaults to “Sources”. */
+    label?: string;
+}
+/** Compact source strip placed immediately before an answer's follow-ups. */
+export declare const AnswerSources: React.ForwardRefExoticComponent<AnswerSourcesProps & React.RefAttributes<HTMLDivElement>>;
+export interface AnswerSourceChipProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
+    /** Connector/source mark shown before the label. */
+    icon?: React.ReactNode;
+    /** Number of references represented by this chip. Hidden when one. */
+    count?: number;
+    children: React.ReactNode;
+}
+/** Blue connector chip that opens its referenced nodes in the inspector. */
+export declare const AnswerSourceChip: React.ForwardRefExoticComponent<AnswerSourceChipProps & React.RefAttributes<HTMLButtonElement>>;
+export interface AnswerSourceInspectorProps extends Omit<DrawerProps, "children"> {
+    /** Supporting count/context line beneath the title. */
+    description?: React.ReactNode;
+    /** Panel title. Defaults to “Answer sources”. */
+    title?: React.ReactNode;
+    children: React.ReactNode;
+}
+/** Shell-level white source panel rendered beside the answer, never over it. */
+export declare function AnswerSourceInspector({ title, description, className, children, ...props }: AnswerSourceInspectorProps): React.JSX.Element;
+export interface AnswerSourceItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children" | "name"> {
+    /** Referenced node/table name. */
+    name: React.ReactNode;
+    /** Connector, warehouse, or parent source. */
+    source?: React.ReactNode;
+    /** Why this node was referenced or its current read state. */
+    description?: React.ReactNode;
+    /** Optional semantic status badge. */
+    status?: React.ReactNode;
+    /** Leading node glyph. Defaults to a table icon. */
+    icon?: React.ReactNode;
+}
+/** Outlined referenced-node row used inside AnswerSourceInspector. */
+export declare const AnswerSourceItem: React.ForwardRefExoticComponent<AnswerSourceItemProps & React.RefAttributes<HTMLButtonElement>>;

package/components/answer-sources.js

@@ -0,0 +1,111 @@
+"use client";
+import { jsxs as s, jsx as r } from "react/jsx-runtime";
+import * as c from "react";
+import { ExternalLink as p, Table as f } from "../lib/icons.js";
+import { cn as o } from "../lib/cn.js";
+import { Button as u } from "./button.js";
+import { Drawer as x, DrawerHeader as h, DrawerTitle as g, DrawerBody as N } from "./drawer.js";
+const w = c.forwardRef(({ count: n, label: e = "Sources", className: a, children: t, ...i }, l) => /* @__PURE__ */ s(
+  "div",
+  {
+    ref: l,
+    className: o("flex flex-wrap items-center gap-2", a),
+    ...i,
+    children: [
+      /* @__PURE__ */ s("span", { className: "text-xs font-normal uppercase tracking-wide text-tertiary", children: [
+        e,
+        " · ",
+        n
+      ] }),
+      t
+    ]
+  }
+));
+w.displayName = "AnswerSources";
+const b = c.forwardRef(({ icon: n, count: e, className: a, children: t, ...i }, l) => /* @__PURE__ */ s(
+  u,
+  {
+    ref: l,
+    type: "button",
+    size: "xs",
+    variant: "ghost",
+    className: o(
+      "h-auto gap-1.5 rounded-full bg-info-50 px-2 py-0.5 text-xs text-info-700 hover:bg-info-100 focus-visible:ring-info/40",
+      a
+    ),
+    ...i,
+    children: [
+      n,
+      t,
+      e != null && e > 1 && /* @__PURE__ */ s("span", { className: "tabular-nums opacity-70", children: [
+        "· ",
+        e
+      ] })
+    ]
+  }
+));
+b.displayName = "AnswerSourceChip";
+function D({
+  title: n = "Answer sources",
+  description: e,
+  className: a,
+  children: t,
+  ...i
+}) {
+  return /* @__PURE__ */ s(x, { className: o("h-full", a), ...i, children: [
+    /* @__PURE__ */ s(h, { className: "gap-1", children: [
+      /* @__PURE__ */ r(g, { children: n }),
+      e && /* @__PURE__ */ r("p", { className: "text-xs text-tertiary", children: e })
+    ] }),
+    /* @__PURE__ */ r(N, { className: "space-y-2", children: t })
+  ] });
+}
+const y = c.forwardRef(
+  ({
+    name: n,
+    source: e,
+    description: a,
+    status: t,
+    icon: i = /* @__PURE__ */ r(f, { "aria-hidden": !0, className: "size-4" }),
+    className: l,
+    ...m
+  }, d) => /* @__PURE__ */ s(
+    "button",
+    {
+      ref: d,
+      type: "button",
+      className: o(
+        "flex w-full items-start gap-3 rounded-lg border border-border bg-fill p-3 text-left",
+        "transition-colors hover:bg-muted",
+        "outline-none focus-visible:ring-3 focus-visible:ring-ring",
+        l
+      ),
+      ...m,
+      children: [
+        /* @__PURE__ */ r("span", { className: "mt-0.5 grid size-8 shrink-0 place-items-center rounded-md bg-muted text-foreground", children: i }),
+        /* @__PURE__ */ s("span", { className: "min-w-0 flex-1", children: [
+          /* @__PURE__ */ s("span", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ r("span", { className: "min-w-0 flex-1 truncate font-normal tabular-nums text-foreground", children: n }),
+            t && /* @__PURE__ */ r("span", { className: "shrink-0", children: t })
+          ] }),
+          e && /* @__PURE__ */ r("span", { className: "mt-0.5 flex items-center gap-1.5 text-xs text-secondary", children: e }),
+          a && /* @__PURE__ */ r("span", { className: "mt-1.5 block text-xs text-secondary", children: a })
+        ] }),
+        /* @__PURE__ */ r(
+          p,
+          {
+            "aria-hidden": !0,
+            className: "mt-2 size-4 shrink-0 text-tertiary"
+          }
+        )
+      ]
+    }
+  )
+);
+y.displayName = "AnswerSourceItem";
+export {
+  b as AnswerSourceChip,
+  D as AnswerSourceInspector,
+  y as AnswerSourceItem,
+  w as AnswerSources
+};

package/components/answer.d.ts

@@ -3233,6 +3233,7 @@ export declare const answerTool: {
 type AnswerInteractions = {
     onFollowUp?: (followUp: AnswerFollowUp) => void;
     onOptionSelect?: (option: AnswerOption) => void;
+    /** Opens the referenced source in the host shell's node inspector. */
     onSourceSelect?: (source: AnswerSource) => void;
     /**
      * Called when a query citation is clicked. Wire it to the shell's detail