@actioneer/ads 0.2.4 → 0.3.1

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

@@ -1,28 +1,53 @@
 import { Badge } from '../badge';
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../collapsible';
 import { ComponentProps, ReactNode } from 'react';
+/**
+ * How steps connect to one another.
+ * - `rail`  — a short vertical segment between icons (the default).
+ * - `tree`  — the Tree connector: a continuous rail with an elbow reaching
+ *             EVERY step, so a nested trace reads as branches of its parent.
+ * - `none`  — no connector; an outer structure carries the hierarchy.
+ */
+export type ChainOfThoughtConnector = "rail" | "tree" | "none";
 /**
  * A step-first reasoning trace. The root is intentionally only a list: each
  * step owns its own disclosure so the trace does not need a redundant global
  * "Chain of Thought" trigger above it.
  */
-export type ChainOfThoughtProps = ComponentProps<"div">;
-export declare const ChainOfThought: import('react').MemoExoticComponent<({ className, role, ...props }: ChainOfThoughtProps) => import("react").JSX.Element>;
-export type ChainOfThoughtStatus = "complete" | "active" | "pending";
+export type ChainOfThoughtProps = ComponentProps<"div"> & {
+    connector?: ChainOfThoughtConnector;
+};
+export declare const ChainOfThought: import('react').MemoExoticComponent<({ className, role, connector, children, ...props }: ChainOfThoughtProps) => import("react").JSX.Element>;
+/**
+ * Step lifecycle mirrors the production work-trace statuses: steps stream in
+ * as `active`, settle to `complete`, and surface failures as `error` — an
+ * error is an execution fact shown in place, not a hidden retry.
+ */
+export type ChainOfThoughtStatus = "complete" | "active" | "pending" | "error";
 export type ChainOfThoughtStepProps = ComponentProps<typeof Collapsible> & {
     status?: ChainOfThoughtStatus;
 };
-export declare const ChainOfThoughtStep: import('react').MemoExoticComponent<({ className, defaultOpen, status, role, ...props }: ChainOfThoughtStepProps) => import("react").JSX.Element>;
+export declare const ChainOfThoughtStep: import('react').MemoExoticComponent<({ className, defaultOpen, open: controlledOpen, onOpenChange, status, role, "aria-busy": ariaBusy, children, ...props }: ChainOfThoughtStepProps) => import("react").JSX.Element>;
 export type ChainOfThoughtTriggerProps = Omit<ComponentProps<typeof CollapsibleTrigger>, "asChild" | "children"> & {
     children: ReactNode;
     /** Semantic icon rendered on the reasoning rail. */
     leftIcon?: ReactNode;
     /** Optional trailing metadata such as elapsed time. */
     endContent?: ReactNode;
-    /** Swap the semantic icon for a disclosure affordance on hover. */
+    /**
+     * Show the disclosure caret at the row's trailing edge, next to
+     * `endContent` — the same anatomy as `TaskTrigger`, so a nested trace reads
+     * consistently at both levels. With the caret on, the leading icon keeps its
+     * meaning instead of being swapped for an affordance.
+     */
+    caret?: boolean;
+    /**
+     * Swap the semantic icon for a disclosure affordance on hover. Ignored when
+     * `caret` is set — one affordance per row.
+     */
     swapIconOnHover?: boolean;
 };
-export declare const ChainOfThoughtTrigger: import('react').MemoExoticComponent<({ className, children, leftIcon, endContent, swapIconOnHover, ...props }: ChainOfThoughtTriggerProps) => import("react").JSX.Element>;
+export declare const ChainOfThoughtTrigger: import('react').MemoExoticComponent<({ className, children, leftIcon, endContent, caret, swapIconOnHover, ...props }: ChainOfThoughtTriggerProps) => import("react").JSX.Element>;
 export type ChainOfThoughtContentProps = ComponentProps<typeof CollapsibleContent>;
 export declare const ChainOfThoughtContent: import('react').MemoExoticComponent<({ className, children, ...props }: ChainOfThoughtContentProps) => import("react").JSX.Element>;
 export type ChainOfThoughtItemProps = ComponentProps<"div">;
@@ -31,6 +56,63 @@ export type ChainOfThoughtSearchResultsProps = ComponentProps<"div">;
 export declare const ChainOfThoughtSearchResults: import('react').MemoExoticComponent<({ className, ...props }: ChainOfThoughtSearchResultsProps) => import("react").JSX.Element>;
 export type ChainOfThoughtSearchResultProps = ComponentProps<typeof Badge>;
 export declare const ChainOfThoughtSearchResult: import('react').MemoExoticComponent<({ className, children, ...props }: ChainOfThoughtSearchResultProps) => import("react").JSX.Element>;
+export type ChainOfThoughtEvidenceProps = Omit<ComponentProps<typeof Collapsible>, "title"> & {
+    /** Short artifact name, e.g. "NPA movement — last 4 quarters". */
+    title: ReactNode;
+    /** Stable result tag badge, e.g. "E1". */
+    tag?: ReactNode;
+    /** Trailing scale hint on the closed chip, e.g. "128 rows" or "chart". */
+    meta?: ReactNode;
+    /** Provenance footer under the preview, e.g. "core_banking.npa_movement". */
+    source?: ReactNode;
+    /** Execution failure shown in place of (or alongside) the preview. */
+    error?: ReactNode;
+    /** Swap the leading Database glyph. Errors default to a warning glyph. */
+    icon?: ReactNode;
+};
+/**
+ * A bounded evidence preview riding inside a step: collapsed to a one-line
+ * chip by default, expanding to a capped artifact preview (table, chart) with
+ * its provenance. Evidence stays visually secondary to the step's finding —
+ * supporting detail on demand, never competing with the answer. Errors render
+ * in place as facts.
+ */
+export declare const ChainOfThoughtEvidence: import('react').MemoExoticComponent<({ className, title, tag, meta, source, error, icon, defaultOpen, children, ...props }: ChainOfThoughtEvidenceProps) => import("react").JSX.Element>;
+export interface ChainOfThoughtEvidenceColumn {
+    key: string;
+    label: ReactNode;
+    align?: "start" | "end";
+}
+export type ChainOfThoughtEvidenceTableProps = Omit<ComponentProps<"div">, "children"> & {
+    columns: ChainOfThoughtEvidenceColumn[];
+    /** Bounded preview rows — the deterministic capped preview, never the full artifact. */
+    rows: Record<string, ReactNode>[];
+    /** True row count in the committed artifact; a truncation footer appears when larger. */
+    totalRows?: number;
+    /** Flags the matching row for emphasis, e.g. the risk outlier. */
+    flag?: {
+        key: string;
+        value: string | number;
+        color?: "default" | "danger" | "warning";
+    };
+};
+/**
+ * The capped tabular preview inside {@link ChainOfThoughtEvidence}: sticky
+ * header, quiet surface fill, optional flagged-row emphasis, and an explicit
+ * "N of M rows" footer whenever the preview is truncated.
+ */
+export declare const ChainOfThoughtEvidenceTable: import('react').MemoExoticComponent<({ className, columns, rows, totalRows, flag, ...props }: ChainOfThoughtEvidenceTableProps) => import("react").JSX.Element>;
+export type ChainOfThoughtMetricsProps = ComponentProps<"div">;
+/** A quiet inline stat row — no fills, separated by spacing alone. */
+export declare const ChainOfThoughtMetrics: import('react').MemoExoticComponent<({ className, role, ...props }: ChainOfThoughtMetricsProps) => import("react").JSX.Element>;
+export type ChainOfThoughtMetricProps = Omit<ComponentProps<"div">, "children" | "color"> & {
+    label: ReactNode;
+    value: ReactNode;
+    /** Qualifier under the value, e.g. "of ₹8,400 Cr book". */
+    sub?: ReactNode;
+    color?: "default" | "danger" | "warning" | "success" | "info";
+};
+export declare const ChainOfThoughtMetric: import('react').MemoExoticComponent<({ className, label, value, sub, color, role, ...props }: ChainOfThoughtMetricProps) => import("react").JSX.Element>;
 export type ChainOfThoughtImageProps = ComponentProps<"div"> & {
     caption?: string;
 };