@mithrl/design-system 0.2.0 → 0.4.0

package/dist/components/flowchart/Flowchart.d.ts

@@ -0,0 +1,140 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+import { type IconGlyphComponent } from "../icon/Icon";
+
+export type FlowchartCanvasProps = HTMLAttributes<HTMLDivElement> & {
+    /** Flow nodes and connectors, composed top to bottom. */
+    children: ReactNode;
+    /** Hides the dotted grid when the flow sits inside an already-textured surface. */
+    grid?: boolean;
+    /** Horizontal alignment of the node column. @default "center" */
+    align?: "center" | "start";
+};
+/**
+ * A static presentation surface for a vertically-connected workflow.
+ * Flowchart never owns drag, drop, or node editing: it renders an already
+ * decided pipeline so a reader can follow it top to bottom.
+ */
+export declare const FlowchartCanvas: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** Flow nodes and connectors, composed top to bottom. */
+    children: ReactNode;
+    /** Hides the dotted grid when the flow sits inside an already-textured surface. */
+    grid?: boolean;
+    /** Horizontal alignment of the node column. @default "center" */
+    align?: "center" | "start";
+} & import("react").RefAttributes<HTMLDivElement>>;
+export type FlowchartConnectorVariant = "line" | "elbow-left" | "elbow-right";
+export type FlowchartConnectorProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    /** Straight run, or an elbow that steps the flow into a branch column. */
+    variant?: FlowchartConnectorVariant;
+    /** Short branch caption such as `Yes`, `No`, or `On failure`. */
+    label?: string;
+    /** Draws the run dashed to signal a conditional or deferred path. */
+    dashed?: boolean;
+};
+/**
+ * The visual run between two flow nodes. Decorative by default; the label,
+ * when present, is the only readable content and is exposed to assistive tech.
+ */
+export declare const FlowchartConnector: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    /** Straight run, or an elbow that steps the flow into a branch column. */
+    variant?: FlowchartConnectorVariant;
+    /** Short branch caption such as `Yes`, `No`, or `On failure`. */
+    label?: string;
+    /** Draws the run dashed to signal a conditional or deferred path. */
+    dashed?: boolean;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export type FlowchartTriggerProps = Omit<HTMLAttributes<HTMLDivElement>, "title" | "children"> & {
+    /** Approved Lucide glyph naming the event source. */
+    icon?: IconGlyphComponent;
+    /** What starts the flow, phrased as an event. */
+    title: ReactNode;
+    /** One sentence of supporting detail about the event. */
+    description?: ReactNode;
+    /** Overrides the default `Trigger` eyebrow. */
+    eyebrow?: string;
+    /** Optional metadata slot, typically a `Tag`. */
+    trailing?: ReactNode;
+};
+/** The entry node of a flow. Carries an accent left treatment. */
+export declare const FlowchartTrigger: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> & {
+    /** Approved Lucide glyph naming the event source. */
+    icon?: IconGlyphComponent;
+    /** What starts the flow, phrased as an event. */
+    title: ReactNode;
+    /** One sentence of supporting detail about the event. */
+    description?: ReactNode;
+    /** Overrides the default `Trigger` eyebrow. */
+    eyebrow?: string;
+    /** Optional metadata slot, typically a `Tag`. */
+    trailing?: ReactNode;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export type FlowchartActionProps = Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: IconGlyphComponent;
+    /** What the step does. */
+    title: ReactNode;
+    description?: ReactNode;
+    /** Overrides the default `Action` eyebrow, e.g. `Step 2`. */
+    eyebrow?: string;
+    /** Optional metadata slot, typically a `Tag` or a duration. */
+    trailing?: ReactNode;
+    /** Extra detail rendered beneath the header. */
+    children?: ReactNode;
+};
+/** A generic executed step in the flow. */
+export declare const FlowchartAction: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: IconGlyphComponent;
+    /** What the step does. */
+    title: ReactNode;
+    description?: ReactNode;
+    /** Overrides the default `Action` eyebrow, e.g. `Step 2`. */
+    eyebrow?: string;
+    /** Optional metadata slot, typically a `Tag` or a duration. */
+    trailing?: ReactNode;
+    /** Extra detail rendered beneath the header. */
+    children?: ReactNode;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export type FlowchartClauseJoin = "and" | "or";
+export type FlowchartConditionClause = {
+    /** The measured entity, e.g. `run QC score`. */
+    entity: string;
+    /** The comparison, e.g. `is below`. */
+    operator: string;
+    /** The compared value, e.g. `0.8`. */
+    value: string;
+    /**
+     * How this clause joins the previous one. Ignored on the first clause.
+     * @default "and"
+     */
+    join?: FlowchartClauseJoin;
+};
+export type FlowchartConditionProps = Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: IconGlyphComponent;
+    /** Short name for the decision, e.g. `Route low-quality runs`. */
+    title: ReactNode;
+    /** The clauses evaluated together, rendered as entity / operator / value chips. */
+    clauses: readonly FlowchartConditionClause[];
+    /** Overrides the default `If / Else` eyebrow. */
+    eyebrow?: string;
+    /** Caption for the true outcome. */
+    thenLabel?: string;
+    /** Caption for the false outcome. Omit for an if-only condition. */
+    elseLabel?: string;
+    /** Optional metadata slot, typically a `Tag`. */
+    trailing?: ReactNode;
+};
+/** A branching If/Else node whose clauses read as inline chips. */
+export declare const FlowchartCondition: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: IconGlyphComponent;
+    /** Short name for the decision, e.g. `Route low-quality runs`. */
+    title: ReactNode;
+    /** The clauses evaluated together, rendered as entity / operator / value chips. */
+    clauses: readonly FlowchartConditionClause[];
+    /** Overrides the default `If / Else` eyebrow. */
+    eyebrow?: string;
+    /** Caption for the true outcome. */
+    thenLabel?: string;
+    /** Caption for the false outcome. Omit for an if-only condition. */
+    elseLabel?: string;
+    /** Optional metadata slot, typically a `Tag`. */
+    trailing?: ReactNode;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/global-app-bar/GlobalAppBar.d.ts

@@ -1,4 +1,4 @@
-import { type AnchorHTMLAttributes, type ButtonHTMLAttributes, type HTMLAttributes, type MouseEventHandler, type ReactElement } from "react";
+import { type AnchorHTMLAttributes, type ButtonHTMLAttributes, type HTMLAttributes, type MouseEventHandler, type ReactElement, type ReactNode } from "react";
 import { type AccountMenuProps } from "../account-menu/AccountMenu";
 import { type DropdownMenuProps } from "../dropdown-menu/DropdownMenu";
 import { type ThemeMode } from "../switch/Switch";
@@ -59,6 +59,11 @@ export type GlobalAppBarProps = Omit<HTMLAttributes<HTMLElement>, "children"> &
     onAccountMenuOpenChange?: DropdownMenuProps["onOpenChange"];
     /** Additional native attributes for the account-menu button. */
     accountButtonProps?: AccountButtonProps;
+    /**
+     * Product-wide utility controls rendered before Theme Switch. Use for
+     * persistent utilities such as Notifications, never page-specific actions.
+     */
+    utilityActions?: ReactNode;
     /**
      * Workspace-only App Shell controls. Each control keeps its own semantics;
      * Global App Bar owns only their approved order and alignment.
@@ -70,9 +75,9 @@ export type GlobalAppBarProps = Omit<HTMLAttributes<HTMLElement>, "children"> &
     };
 };
 /**
- * Persistent application anchor. Home keeps the minimal brand, theme, and
- * account contract; Workspace adds structural panel controls and project
- * context without introducing a second App Bar component.
+ * Persistent application anchor. Home keeps brand, optional product-wide
+ * utilities, theme, and account; Workspace adds structural panel controls and
+ * project context without introducing a second App Bar component.
  */
 export declare const GlobalAppBar: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & {
     /** Home destination used by the official Mithrl brand action. */
@@ -105,6 +110,11 @@ export declare const GlobalAppBar: import("react").ForwardRefExoticComponent<Omi
     onAccountMenuOpenChange?: DropdownMenuProps["onOpenChange"];
     /** Additional native attributes for the account-menu button. */
     accountButtonProps?: AccountButtonProps;
+    /**
+     * Product-wide utility controls rendered before Theme Switch. Use for
+     * persistent utilities such as Notifications, never page-specific actions.
+     */
+    utilityActions?: ReactNode;
     /**
      * Workspace-only App Shell controls. Each control keeps its own semantics;
      * Global App Bar owns only their approved order and alignment.

package/dist/components/icon-swap/IconSwap.d.ts

@@ -0,0 +1,30 @@
+import { type HTMLAttributes } from "react";
+import { type IconGlyphComponent, type IconSize } from "../icon/Icon";
+
+export type IconSwapProps = Omit<HTMLAttributes<HTMLSpanElement>, "aria-label" | "aria-hidden" | "children" | "role"> & {
+    /**
+     * Approved glyph to display. Changing the component identity swaps the
+     * glyph in place; the caller never manages two children.
+     */
+    icon: IconGlyphComponent;
+    /** Icon Foundation size token. Matches the `Icon` contract exactly. */
+    size?: IconSize;
+};
+/**
+ * Cross-fades two glyphs through one slot.
+ *
+ * IconSwap is a single-slot component: pass one `icon`, and whenever that
+ * component identity changes the outgoing glyph fades out while the incoming
+ * glyph fades in over it. Both share one grid cell so the slot never reflows.
+ *
+ * Motion — `--motion-duration-standard` on `--motion-easing-standard`, with
+ * the incoming glyph rising from `--motion-scale-enter` and
+ * `--motion-blur-soft` to rest. Under `prefers-reduced-motion: reduce` the
+ * scale and blur are dropped and the two glyphs cross-fade on opacity alone at
+ * `--motion-duration-fast`.
+ *
+ * Boundary — the swap is decorative. IconSwap announces nothing: the root and
+ * every glyph are hidden from assistive technology, exactly as a bare `Icon`
+ * without a `label` is. The accessible name belongs to the owning control.
+ */
+export declare function IconSwap({ icon, size, className, ...props }: IconSwapProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/insight-cards/InsightCards.d.ts

@@ -0,0 +1,97 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+
+/** Direction of a change, mapped to semantic color. */
+export type InsightTone = "neutral" | "success" | "danger";
+/**
+ * One run of an insight sentence. `text` reads as prose, `entity` names a
+ * cohort, gene, batch, or assay, and `metric` carries a figure or delta.
+ */
+export type InsightSegment = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "entity";
+    text: string;
+} | {
+    kind: "metric";
+    text: string;
+    tone?: InsightTone;
+};
+/** A compact before/after row rendered beneath the sentence. */
+export type InsightComparison = {
+    /** What is being compared, e.g. `Median TPM, responders`. */
+    label: string;
+    /** Signed relative change, already formatted, e.g. `+18.4%`. */
+    delta: string;
+    /** Absolute value, already formatted, e.g. `412.6 TPM`. */
+    value: string;
+    /** Semantic direction. @default "neutral" */
+    tone?: InsightTone;
+};
+/** A single plotted observation for the embedded mini chart. */
+export type InsightChartPoint = {
+    /** Axis label for the scrub readout, e.g. `Day 14`. */
+    label: string;
+    /** Plotted magnitude in the series' own units. */
+    value: number;
+};
+export type InsightChart = {
+    points: readonly InsightChartPoint[];
+    /** Unit suffix shown in the scrub readout, e.g. `TPM`. */
+    unit?: string;
+    /** Accessible summary of the series. Required — the SVG carries no text. */
+    ariaLabel: string;
+};
+export type InsightFollowUp = {
+    /** The suggested next question, phrased as the agent would ask it. */
+    label: string;
+    /** Stable identifier handed back to `onFollowUpSelect`. */
+    id?: string;
+};
+export type Insight = {
+    /** Stable identity for the page. */
+    id: string;
+    /** Short headline for the insight. */
+    title: string;
+    /** The insight itself, composed of prose, entity, and metric runs. */
+    sentence: readonly InsightSegment[];
+    /** Optional comparison rows. */
+    comparisons?: readonly InsightComparison[];
+    /** Optional embedded trend chart. */
+    chart?: InsightChart;
+    /** Optional suggested follow-up rendered in the footer. */
+    followUp?: InsightFollowUp;
+};
+export type InsightCardsProps = Omit<HTMLAttributes<HTMLElement>, "children" | "onSelect"> & {
+    /** The pages, in reading order. At least one is required. */
+    insights: readonly Insight[];
+    /** Header title. @default "Insights" */
+    heading?: ReactNode;
+    /** Controlled page index. */
+    page?: number;
+    /** Initial page index for uncontrolled use. @default 0 */
+    defaultPage?: number;
+    /** Called with the next index whenever the page changes. */
+    onPageChange?: (page: number) => void;
+    /** Called when the footer follow-up chip is activated. */
+    onFollowUpSelect?: (followUp: InsightFollowUp, insight: Insight) => void;
+};
+/**
+ * A paged carousel of agent-authored insights. Each page states one finding
+ * in a sentence built from entity and metric chips, supports it with
+ * comparison rows and a mini trend chart, and offers one follow-up question.
+ */
+export declare const InsightCards: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children" | "onSelect"> & {
+    /** The pages, in reading order. At least one is required. */
+    insights: readonly Insight[];
+    /** Header title. @default "Insights" */
+    heading?: ReactNode;
+    /** Controlled page index. */
+    page?: number;
+    /** Initial page index for uncontrolled use. @default 0 */
+    defaultPage?: number;
+    /** Called with the next index whenever the page changes. */
+    onPageChange?: (page: number) => void;
+    /** Called when the footer follow-up chip is activated. */
+    onFollowUpSelect?: (followUp: InsightFollowUp, insight: Insight) => void;
+} & import("react").RefAttributes<HTMLElement>>;

package/dist/components/navigation-item/NavigationItem.d.ts

@@ -18,6 +18,8 @@ type NavigationItemCommonProps = (LeadingIcon | LeadingQuestion) & {
     label: string;
     /** Controlled current/selected state supplied by the owning navigation. */
     selected?: boolean;
+    /** Controlled active-panel state. It may coexist across multiple Questions. */
+    active?: boolean;
     /** Shows the approved text shimmer and trailing Progress Indicator. */
     loading?: boolean;
     /** Adds the question-row overflow action as a sibling interactive control. */

package/dist/components/number-flow/NumberFlow.d.ts

@@ -0,0 +1,93 @@
+import { type CSSProperties } from "react";
+
+/**
+ * Milliseconds one digit spends rolling. Mirrors `--motion-duration-moderate`;
+ * the CSS reads the token directly and only falls back to this number when the
+ * caller overrides `rollDuration`.
+ */
+export declare const NUMBER_FLOW_DEFAULT_DURATION_MS = 220;
+/** Milliseconds each successive cell waits before it starts rolling. */
+export declare const NUMBER_FLOW_DEFAULT_STAGGER_MS = 18;
+export type NumberFlowElement = "span" | "div" | "p" | "strong" | "em";
+export type NumberFlowSize = "small" | "medium" | "large";
+export interface NumberFlowProps {
+    /** The number to display. Changing it rolls the digits that differ. */
+    value: number;
+    /** `Intl.NumberFormat` options. Changing them reformats and animates. */
+    format?: Intl.NumberFormatOptions;
+    /** BCP 47 locale(s) for formatting. Defaults to the runtime locale. */
+    locale?: string | string[];
+    /**
+     * Height of the clipped roll window, as a multiple of the inherited line box.
+     * This is the only size NumberFlow owns — it never sets a font property.
+     * @default "medium"
+     */
+    size?: NumberFlowSize;
+    /** Host element. @default "span" */
+    as?: NumberFlowElement;
+    /** Per-digit delay, in milliseconds. @default 18 */
+    stagger?: number;
+    /** Roll duration, in milliseconds. @default `--motion-duration-moderate` */
+    rollDuration?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+export type NumberFlowDirection = "up" | "down";
+export type NumberFlowCell = {
+    /** Glyph shown once the cell settles. */
+    char: string;
+    /** Glyph leaving the window, or `null` when the cell is new or unchanged. */
+    previous: string | null;
+    /** Digit-to-digit change: a clipped vertical roll. */
+    roll: boolean;
+    /** Any other change (separator, sign, or a brand new place): a crossfade. */
+    fade: boolean;
+    /** Roll direction, taken from the sign of the value delta. */
+    direction: NumberFlowDirection;
+};
+/**
+ * Cells are aligned from the RIGHT, not the left: in a number the units column
+ * is the fixed point, so 99 -> 100 must roll the two nines against the new
+ * tens and units rather than sliding every place one column over.
+ *
+ * Only cells whose glyph actually changed move — the same rule FlapText
+ * applies to characters. A digit replacing a digit rolls; anything else
+ * (a separator appearing, a sign flipping, a brand new leading place) is a
+ * quiet crossfade, because rolling a comma into a digit reads as noise.
+ */
+export declare function numberFlowCells(previous: string, next: string, direction?: NumberFlowDirection): NumberFlowCell[];
+/**
+ * A number that resolves instead of blinking.
+ *
+ * Each character of the formatted value is its own cell. When `value` changes,
+ * only the cells whose glyph differs move: a digit rolls vertically through a
+ * clipped window — the outgoing glyph leaves through one edge as the incoming
+ * one arrives from the other, softened by `--motion-blur-soft` — while
+ * separators and new leading places simply crossfade. Cells are staggered left
+ * to right so the least significant digit is the last to settle.
+ *
+ * This is a short roll, not a slot machine. The spinning-counter recipe's
+ * multi-revolution 0-9 strip, its directional SVG blur filter and its masked
+ * window edges are all deliberately absent: a scientific workspace wants a
+ * number that has clearly *changed*, not one that celebrates.
+ *
+ * Sharpness: settled cells carry `transform: none` exactly — never an identity
+ * matrix — `will-change` is present only while a cell is in flight, no scale is
+ * ever applied, and the component sets no font property, so text metrics are
+ * the caller's. `font-variant-numeric: tabular-nums` keeps the box from
+ * wobbling as digits change width.
+ *
+ * Accessibility: cells are `aria-hidden`, the host carries the formatted value
+ * as `aria-label`, and a visually hidden polite live region announces one clean
+ * string.
+ *
+ * Reduced motion: no roll and no blur — the value swaps instantly behind a
+ * `--motion-duration-fast` opacity crossfade.
+ */
+export declare function NumberFlow({ value, format, locale, size, as, stagger, rollDuration, className, style, }: NumberFlowProps): import("react").DetailedReactHTMLElement<{
+    className: string;
+    style: CSSProperties | undefined;
+    "aria-label": string;
+    "data-size": NumberFlowSize;
+    "data-animating": string;
+}, HTMLElement>;

package/dist/components/panel-tabs/PanelTabs.d.ts

@@ -16,6 +16,8 @@ export type PanelTabItem = {
     panelId?: string;
     /** Optional explicit tab ID used by the associated panel. */
     id?: string;
+    /** Uses the Design System Tooltip when the visible presentation is icon-only. */
+    tooltip?: boolean;
 };
 export type PanelTabsProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
     items: readonly PanelTabItem[];

package/dist/components/progress-indicator/ProgressIndicator.d.ts

@@ -7,8 +7,16 @@ export declare const progressIndicatorVariants: (props?: ({
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type ProgressIndicatorSize = NonNullable<VariantProps<typeof progressIndicatorVariants>["size"]>;
 export type ProgressIndicatorTone = NonNullable<VariantProps<typeof progressIndicatorVariants>["tone"]>;
+/**
+ * Loading is the default so every existing usage keeps its current behavior.
+ * Done resolves the same indicator into a drawn completion check.
+ */
+export type ProgressIndicatorState = "loading" | "done";
 type RestrictedProgressIndicatorAttribute = "aria-atomic" | "aria-busy" | "aria-hidden" | "aria-label" | "aria-live" | "children" | "onClick" | "onDoubleClick" | "onKeyDown" | "onKeyUp" | "role" | "tabIndex";
-type ProgressIndicatorBaseProps = Omit<HTMLAttributes<HTMLSpanElement>, RestrictedProgressIndicatorAttribute> & VariantProps<typeof progressIndicatorVariants>;
+type ProgressIndicatorBaseProps = Omit<HTMLAttributes<HTMLSpanElement>, RestrictedProgressIndicatorAttribute> & VariantProps<typeof progressIndicatorVariants> & {
+    /** Completion state. Defaults to `"loading"`. */
+    state?: ProgressIndicatorState;
+};
 type InformativeProgressIndicatorProps = {
     /** Concise accessible name announced through the status live region. */
     label: string;

package/dist/components/prompt-bar/PromptBar.d.ts

@@ -0,0 +1,103 @@
+import { type IconGlyphComponent } from "../icon/Icon";
+
+
+export type PromptBarShape = "rounded" | "pill";
+/** Trigger characters that open the anchored suggestion popover. */
+export type PromptBarTrigger = "@" | "/";
+export type PromptBarSource = {
+    /** Stable identity used for selection and de-duplication. */
+    id: string;
+    /** Visible row label and entity chip label. */
+    label: string;
+    /** Short qualifier rendered beside the label, e.g. "dataset". */
+    kind?: string;
+    /** Optional approved Lucide glyph for the row and the chip. */
+    icon?: IconGlyphComponent;
+};
+export type PromptBarCommand = {
+    /** Stable identity, also inserted as `/{id}` unless `insert` is provided. */
+    id: string;
+    /** Visible row label. */
+    label: string;
+    /** Short qualifier rendered beside the label, e.g. "analysis". */
+    kind?: string;
+    /** Optional approved Lucide glyph for the row. */
+    icon?: IconGlyphComponent;
+    /** Text inserted in place of the `/` token. Defaults to `/{id}`. */
+    insert?: string;
+};
+export type PromptBarModel = {
+    /** Stable identity used for selection. */
+    id: string;
+    /** Visible label in the trigger and in the option list. */
+    label: string;
+    /** Optional short qualifier shown under the label in the option list. */
+    description?: string;
+};
+export type PromptBarLabels = {
+    input: string;
+    submit: string;
+    dictate: string;
+    model: string;
+    attachments: string;
+    removeSource: string;
+    sourceSuggestions: string;
+    commandSuggestions: string;
+    emptySuggestions: string;
+};
+export type PromptBarProps = {
+    /** Controlled prompt text. */
+    value: string;
+    /** Called on every keystroke and on suggestion insertion. */
+    onValueChange: (value: string) => void;
+    /** Called with the trimmed prompt and the sources attached to it. */
+    onSubmit?: (value: string, sources: readonly PromptBarSource[]) => void;
+    /** Rows offered by the `@` popover. */
+    sources?: readonly PromptBarSource[];
+    /** Rows offered by the `/` popover. */
+    commands?: readonly PromptBarCommand[];
+    /** Controlled attachment chips. Omit to let PromptBar own them. */
+    selectedSources?: readonly PromptBarSource[];
+    /** Initial attachment chips for uncontrolled use. */
+    defaultSelectedSources?: readonly PromptBarSource[];
+    /** Called whenever the attachment row changes. */
+    onSelectedSourcesChange?: (sources: readonly PromptBarSource[]) => void;
+    /** Models offered by the footer model picker. */
+    models?: readonly PromptBarModel[];
+    /** Controlled model id. */
+    selectedModel?: string;
+    /** Called with the newly chosen model id. */
+    onModelChange?: (modelId: string) => void;
+    /** Renders the dictation microphone slot. Presentation only. */
+    onDictate?: () => void;
+    /** Geometry of the bar. */
+    shape?: PromptBarShape;
+    placeholder?: string;
+    disabled?: boolean;
+    autoFocus?: boolean;
+    name?: string;
+    labels?: Partial<PromptBarLabels>;
+    className?: string;
+    /** Storybook-only hook that forces the popover open for review. */
+    "data-preview-trigger"?: PromptBarTrigger;
+};
+type TriggerMatch = {
+    trigger: PromptBarTrigger;
+    query: string;
+    start: number;
+    end: number;
+};
+/**
+ * Reads the token immediately before the caret. A token qualifies when it
+ * starts at the beginning of the value or after whitespace, is introduced by
+ * `@` or `/`, and contains no whitespace of its own.
+ */
+export declare function readTriggerAtCaret(value: string, caret: number): TriggerMatch | null;
+/**
+ * Command-style prompt entry with `@` source mentions, `/` commands, an
+ * attachment chip row, and a model rail. PromptBar is a sibling of Composer,
+ * not a replacement: Composer owns conversational entry, PromptBar owns
+ * command-shaped prompting where sources and commands are addressable.
+ */
+export declare const PromptBar: import("react").ForwardRefExoticComponent<PromptBarProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export {};

package/dist/components/recommendation-card/RecommendationCard.d.ts

@@ -0,0 +1,77 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+import type { MetadataTone } from "../badge/Badge";
+
+/** How sure the agent is about the action it is proposing. */
+export type RecommendationConfidence = "low" | "medium" | "high";
+/** A path the agent considered but did not lead with. */
+export interface RecommendationAlternative {
+    id: string;
+    label: string;
+    /** One sentence on what this path would do differently. */
+    description?: string;
+    /** Short status Tag, e.g. "Needs review" or "No signal". */
+    statusLabel?: string;
+    statusTone?: MetadataTone;
+    disabled?: boolean;
+}
+export interface RecommendationEntityChipProps {
+    children: ReactNode;
+    /** Optional kind shown to assistive tech, e.g. "dataset" or "gene". */
+    kind?: string;
+    className?: string;
+}
+/**
+ * Inline reference to a real object — a dataset, a run, a gene — set inside
+ * the recommendation body so the sentence stays readable.
+ */
+export declare function RecommendationEntityChip({ children, kind, className, }: RecommendationEntityChipProps): import("react/jsx-runtime").JSX.Element;
+type RestrictedRecommendationCardAttribute = "children" | "role" | "title";
+export type RecommendationCardProps = Omit<HTMLAttributes<HTMLElement>, RestrictedRecommendationCardAttribute> & {
+    /** The suggestion, phrased as a question the scientist can answer. */
+    headline: ReactNode;
+    /** What the agent would actually do. Inline entity chips belong here. */
+    body?: ReactNode;
+    confidence: RecommendationConfidence;
+    /** Overrides the default "High confidence" style label. */
+    confidenceLabel?: string;
+    /** Why the agent is this confident. Shown next to the meter. */
+    confidenceReason?: ReactNode;
+    alternatives?: RecommendationAlternative[];
+    alternativesLabel?: string;
+    /** Controlled disclosure state for the alternatives list. */
+    alternativesOpen?: boolean;
+    defaultAlternativesOpen?: boolean;
+    onAlternativesOpenChange?: (open: boolean) => void;
+    onAlternativeSelect?: (alternative: RecommendationAlternative) => void;
+    onAccept?: () => void;
+    acceptLabel?: string;
+    /** Disables the primary action while the proposal is still resolving. */
+    acceptDisabled?: boolean;
+};
+/**
+ * An agent suggestion with its confidence shown plainly, the alternatives it
+ * weighed kept one click away, and a single primary action to accept.
+ */
+export declare const RecommendationCard: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, RestrictedRecommendationCardAttribute> & {
+    /** The suggestion, phrased as a question the scientist can answer. */
+    headline: ReactNode;
+    /** What the agent would actually do. Inline entity chips belong here. */
+    body?: ReactNode;
+    confidence: RecommendationConfidence;
+    /** Overrides the default "High confidence" style label. */
+    confidenceLabel?: string;
+    /** Why the agent is this confident. Shown next to the meter. */
+    confidenceReason?: ReactNode;
+    alternatives?: RecommendationAlternative[];
+    alternativesLabel?: string;
+    /** Controlled disclosure state for the alternatives list. */
+    alternativesOpen?: boolean;
+    defaultAlternativesOpen?: boolean;
+    onAlternativesOpenChange?: (open: boolean) => void;
+    onAlternativeSelect?: (alternative: RecommendationAlternative) => void;
+    onAccept?: () => void;
+    acceptLabel?: string;
+    /** Disables the primary action while the proposal is still resolving. */
+    acceptDisabled?: boolean;
+} & import("react").RefAttributes<HTMLElement>>;
+export {};