cortena-ui 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -1,37 +1,38 @@
 "use client";
 import { ClassValue } from "clsx";
+import { z } from "zod";
 import * as React$1 from "react";
 import { ReactNode } from "react";
-import { Area, AreaChart, Bar, BarChart, CartesianGrid, Cell, ComposedChart, Funnel, FunnelChart, LabelList, Legend as RechartsLegend, LegendPayload, LegendProps, Line, LineChart, Pie, PieChart, PolarAngleAxis, PolarGrid, PolarRadiusAxis, Radar, RadarChart, ReferenceLine, ResponsiveContainer, Scatter, ScatterChart, Tooltip as RechartsTooltip, TooltipContentProps as TooltipContentProps$1, TooltipProps, XAxis, YAxis } from "recharts";
-import { Button as Button$1 } from "@base-ui/react/button";
 import { VariantProps } from "class-variance-authority";
+import { Button as Button$1 } from "@base-ui/react/button";
+import { Area, AreaChart, Bar, BarChart, CartesianGrid, Cell, ComposedChart, Funnel, FunnelChart, LabelList, Legend as RechartsLegend, LegendPayload, LegendProps, Line, LineChart, Pie, PieChart, PolarAngleAxis, PolarGrid, PolarRadiusAxis, Radar, RadarChart, ReferenceLine, ResponsiveContainer, Scatter, ScatterChart, Tooltip as RechartsTooltip, TooltipContentProps as TooltipContentProps$1, TooltipProps, XAxis, YAxis } from "recharts";
+import { Checkbox as Checkbox$1 } from "@base-ui/react/checkbox";
 import { Menu } from "@base-ui/react/menu";
 import { Select as Select$1 } from "@base-ui/react/select";
 import { Cell as Cell$2, Column, ColumnDef, ColumnHelper, ReactTable, Row, RowData, TableState } from "@tanstack/react-table";
-import { Checkbox as Checkbox$1 } from "@base-ui/react/checkbox";
-import { Accordion as Accordion$1 } from "@base-ui/react/accordion";
-import { Avatar as Avatar$1 } from "@base-ui/react/avatar";
 import { DateRange, DayButtonProps, DayPickerProps } from "react-day-picker";
-import { Combobox as Combobox$1 } from "@base-ui/react/combobox";
-import { Command as Command$1 } from "cmdk";
-import { Dialog as Dialog$1 } from "@base-ui/react/dialog";
 import { Popover as Popover$1 } from "@base-ui/react/popover";
-import { Accept, DropzoneState, FileRejection } from "react-dropzone";
 import { Field as Field$1 } from "@base-ui/react/field";
 import { Fieldset as Fieldset$1 } from "@base-ui/react/fieldset";
-import { ControllerProps, FieldError as FieldError$1, FieldPath, FieldValues, SubmitHandler, UseFormReturn, useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
 import { Components, Options } from "react-markdown";
 import { Options as Options$1 } from "rehype-sanitize";
 import { Progress as Progress$1 } from "@base-ui/react/progress";
 import { Radio } from "@base-ui/react/radio";
 import { RadioGroup as RadioGroup$1 } from "@base-ui/react/radio-group";
-import { ScrollArea as ScrollArea$1 } from "@base-ui/react/scroll-area";
 import { Separator as Separator$1 } from "@base-ui/react/separator";
-import { DraggableAttributes, UniqueIdentifier } from "@dnd-kit/core";
-import { arrayMove } from "@dnd-kit/sortable";
 import { Switch as Switch$1 } from "@base-ui/react/switch";
 import { Tabs as Tabs$1 } from "@base-ui/react/tabs";
+import { Accordion as Accordion$1 } from "@base-ui/react/accordion";
+import { Avatar as Avatar$1 } from "@base-ui/react/avatar";
+import { Combobox as Combobox$1 } from "@base-ui/react/combobox";
+import { Command as Command$1 } from "cmdk";
+import { Dialog as Dialog$1 } from "@base-ui/react/dialog";
+import { Accept, DropzoneState, FileRejection } from "react-dropzone";
+import { ControllerProps, FieldError as FieldError$1, FieldPath, FieldValues, SubmitHandler, UseFormReturn, useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { ScrollArea as ScrollArea$1 } from "@base-ui/react/scroll-area";
+import { DraggableAttributes, UniqueIdentifier } from "@dnd-kit/core";
+import { arrayMove } from "@dnd-kit/sortable";
 import { Toast as Toast$1 } from "@base-ui/react/toast";
 import { Tooltip as Tooltip$2 } from "@base-ui/react/tooltip";
 //#region src/lib/cn.d.ts
@@ -41,6 +42,236 @@ import { Tooltip as Tooltip$2 } from "@base-ui/react/tooltip";
  */
 export declare function cn(...inputs: ClassValue[]): string;
 //#endregion
+//#region src/a2ui/message.d.ts
+/**
+ * A2UI message layer.
+ *
+ * The wire format cortena-ui accepts, and the fold from a stream of messages
+ * onto a set of surfaces. Deliberately free of React so it can be reused by a
+ * canvas host, a test fixture, or the catalogue doc generator.
+ *
+ * ## Two dialects, one fold
+ *
+ * **v0.9** is the current A2UI protocol (`createSurface`, `updateComponents`,
+ * `updateDataModel`, `deleteSurface`) and is what an agent should emit.
+ *
+ * **v0.8** is what Cortena already speaks: core bundles Google's A2UI Lit
+ * renderer at `src/canvas-host/a2ui/` and its `A2uiMessageProcessor` handles
+ * `beginRendering`, `surfaceUpdate`, `dataModelUpdate` and `deleteSurface`.
+ * The `canvas` agent tool pushes exactly those, as JSON lines, through
+ * `canvas.a2ui.pushJSONL`. Accepting both means one renderer serves the chat,
+ * the web canvas panel and every payload already written against the native
+ * nodes.
+ *
+ * ## Transport
+ *
+ * Per `05-agent-ui.md`, an A2UI block travels as an AG-UI `CUSTOM` event. The
+ * event value is a message, an array of messages, or the JSONL text the canvas
+ * tool sends; {@link parseA2UIMessages} takes all three.
+ */
+/** Surface id used when a message omits one, matching core's Lit processor. */
+export declare const A2UI_DEFAULT_SURFACE_ID = "@default";
+/** Protocol version this package speaks. */
+export declare const A2UI_VERSION = "v0.9";
+/** A reference to a value in the surface's data model, as a JSON pointer. */
+interface A2UIDataBinding {
+  path: string;
+}
+/**
+ * A property value as an agent writes it: a literal, a data binding, or one of
+ * the v0.8 literal wrappers the Lit renderer accepts.
+ */
+type A2UIPropertyValue = string | number | boolean | null | A2UIDataBinding | {
+  literal: unknown;
+} | {
+  literalString: string;
+} | readonly A2UIPropertyValue[] | {
+  readonly [key: string]: unknown;
+};
+/**
+ * A component's children. v0.9 uses a plain id array or a `{ componentId, path }`
+ * template; v0.8 wraps the same two in `explicitList` / `template`.
+ */
+type A2UIChildList = readonly string[] | {
+  componentId: string;
+  path: string;
+} | {
+  explicitList: readonly string[];
+} | {
+  template: {
+    componentId: string;
+    dataBinding: string;
+  };
+};
+/** An action an agent attaches to an interactive property. */
+type A2UIActionSpec = string | {
+  event: {
+    name: string;
+    context?: Record<string, unknown>;
+  };
+} | {
+  name: string;
+  context?: Record<string, unknown>;
+};
+/**
+ * One component in a surface.
+ *
+ * v0.9 is flat — `{ id, component: "Text", text: "hi" }` — and v0.8 wraps the
+ * properties under the type name — `{ id, component: { Text: { text: "hi" } } }`.
+ */
+interface A2UIComponentSpec {
+  id: string;
+  component: string | Record<string, Record<string, unknown>>;
+  children?: A2UIChildList;
+  /** v0.8 flex weight; carried through but not used for layout here. */
+  weight?: number | string;
+  [property: string]: unknown;
+}
+interface A2UICreateSurface {
+  surfaceId?: string;
+  catalogId?: string;
+  /** Not in the v0.9 schema; accepted so a single message can seed a surface. */
+  root?: string;
+  sendDataModel?: boolean;
+}
+interface A2UIUpdateComponents {
+  surfaceId?: string;
+  components: A2UIComponentSpec[];
+  root?: string;
+}
+interface A2UIUpdateDataModel {
+  surfaceId?: string;
+  path?: string;
+  value?: unknown;
+  /** v0.8 spelling of `value`. */
+  contents?: unknown;
+}
+interface A2UIBeginRendering {
+  surfaceId?: string;
+  root?: string;
+  styles?: Record<string, unknown>;
+}
+interface A2UIDeleteSurface {
+  surfaceId?: string;
+}
+/** One message on the wire. Exactly one operation key is read per message. */
+interface A2UIMessage {
+  version?: string;
+  createSurface?: A2UICreateSurface;
+  updateComponents?: A2UIUpdateComponents;
+  updateDataModel?: A2UIUpdateDataModel;
+  deleteSurface?: A2UIDeleteSurface;
+  /** v0.8 */
+  beginRendering?: A2UIBeginRendering;
+  /** v0.8 */
+  surfaceUpdate?: A2UIUpdateComponents;
+  /** v0.8 */
+  dataModelUpdate?: A2UIUpdateDataModel;
+}
+/**
+ * Everything the renderer's `message` prop takes: one message, a list of them
+ * (the AG-UI `CUSTOM` payload), or JSONL / a JSON array as text (the canvas
+ * tool's `a2ui_push`).
+ */
+type A2UIMessageInput = A2UIMessage | readonly A2UIMessage[] | string | null | undefined;
+/** A folded surface: what the renderer draws. */
+interface A2UISurface {
+  id: string;
+  /** Id of the root component; `undefined` until a message names one. */
+  root: string | undefined;
+  components: ReadonlyMap<string, A2UIComponentSpec>;
+  dataModel: Record<string, unknown>;
+  styles: Record<string, unknown>;
+}
+interface A2UIFoldResult {
+  surfaces: A2UISurface[];
+  /** One line per malformed message; the renderer shows these in an error card. */
+  errors: string[];
+}
+/** True when a value is a `{ path }` data binding rather than a literal object. */
+export declare function isDataBinding(value: unknown): value is A2UIDataBinding;
+/**
+ * Parse whatever arrived into a message list.
+ *
+ * A string is tried as JSON first (an array or a single message) and then as
+ * JSONL, which is the form `canvas.a2ui.pushJSONL` sends. A line that does not
+ * parse is reported rather than dropped: silently rendering three of four
+ * pushed messages is the failure mode this returns errors for.
+ */
+export declare function parseA2UIMessages(input: A2UIMessageInput): {
+  messages: A2UIMessage[];
+  errors: string[];
+};
+/**
+ * Fold a message stream onto surfaces.
+ *
+ * Updates accumulate: a later `updateComponents` replaces the components it
+ * names and leaves the rest, and a later `updateDataModel` writes at its path
+ * only. That is what makes the JSONL push form work — the agent sends the
+ * shell, then the rows, then a correction, and each one folds onto the same
+ * surface.
+ */
+export declare function foldMessages(input: A2UIMessageInput): A2UIFoldResult;
+/** Split a JSON pointer into its unescaped segments. */
+export declare function pointerSegments(pointer: string): string[];
+/** Resolve a possibly relative pointer against a data context. */
+export declare function resolvePointer(path: string, contextPath: string): string;
+/** Read a JSON pointer out of the data model. */
+export declare function getAtPointer(model: unknown, pointer: string): unknown;
+/**
+ * Write a JSON pointer into the data model, returning a new model.
+ *
+ * Immutable because the renderer keeps the model in React state: a mutation in
+ * place would not re-render, which is the kind of silent nothing-happens bug
+ * that is hard to see in a browser test.
+ */
+export declare function setAtPointer(model: Record<string, unknown>, pointer: string, value: unknown): Record<string, unknown>;
+/** Normalise the children of a component spec into a single description. */
+type A2UIChildren = {
+  kind: "list";
+  ids: readonly string[];
+} | {
+  kind: "template";
+  componentId: string;
+  path: string;
+} | {
+  kind: "none";
+};
+export declare function readChildren(spec: A2UIComponentSpec, properties: Record<string, unknown>): A2UIChildren;
+/**
+ * Split a component spec into its type name and its raw (unresolved) properties,
+ * across both dialects. Returns `undefined` when the spec names no type.
+ */
+export declare function readComponent(spec: A2UIComponentSpec): {
+  name: string;
+  properties: Record<string, unknown>;
+} | undefined;
+/**
+ * Resolve one property value against the data model.
+ *
+ * `{ path }` reads the model, `{ literal }` / `{ literalString }` unwrap, and
+ * everything else is returned as written, recursing through arrays and objects
+ * so a binding nested inside a prop object still resolves.
+ */
+export declare function resolveValue(value: unknown, model: Record<string, unknown>, contextPath: string): unknown;
+/** A user action leaving the renderer, shaped like A2UI's client-to-server action. */
+interface A2UIAction {
+  surfaceId: string;
+  componentId: string;
+  name: string;
+  payload: Record<string, unknown>;
+}
+/**
+ * Normalise an action property into `{ name, context }`.
+ *
+ * Accepts v0.9's `{ event: { name, context } }`, the bare `{ name, context }`
+ * shape, and a plain string, which is what an agent writes most often.
+ */
+export declare function readAction(value: unknown): {
+  name: string;
+  context: Record<string, unknown>;
+} | undefined;
+//#endregion
 //#region src/components/chart/types.d.ts
 /**
  * Chart types and the data shape each one expects.
@@ -63,7 +294,10 @@ export declare function cn(...inputs: ClassValue[]): string;
  *   (the Nivo line shape the webchat emits). `ChartRow[]` is also accepted.
  * - **pie**, **donut**, **funnel**: `ChartSlice[]` — `[{ id, label?, value }]`.
  * - **scatter** (alias `scatterplot`): `ChartSeries[]` — one series per group.
- * - **heatmap**: `ChartSeries[]` — Nivo heatmap shape, `[{ id: row, data: [{ x: column, y: value }] }]`.
+ * - **heatmap**: `ChartSeries[]` — Nivo heatmap shape, `[{ id: row, data: [{ x: column, y: value }] }]` —
+ *   or `ChartMatrix`, the categorical form a correlation / confusion matrix
+ *   already has: `{ rows, columns, values }` with `values[r][c]` at
+ *   `rows[r] × columns[c]`.
  * - **calendar**: `ChartDay[]` — `[{ day: "2026-01-31", value }]`; `from`/`to`
  *   default to the data's range.
  * - **treemap**, **sunburst**: `ChartTree` — Nivo tree, `{ id, children?: [...], value? }`
@@ -91,6 +325,17 @@ interface ChartSlice {
   label?: string;
   value: number;
 }
+/**
+ * A categorical matrix: `values[r][c]` is the cell at `rows[r]` × `columns[c]`.
+ * The shape a correlation matrix, a confusion matrix or a day × hour grid is
+ * already in, so it needs no pivot at the call site. Short rows are padded
+ * with `null` (drawn as the empty colour) rather than treated as zero.
+ */
+interface ChartMatrix {
+  rows: string[];
+  columns: string[];
+  values: Array<Array<number | null | undefined>>;
+}
 /** One day of a calendar heatmap. */
 interface ChartDay {
   day: string;
@@ -105,7 +350,7 @@ interface ChartTree {
   [key: string]: unknown;
 }
 /** The data type accepted for each chart type. */
-type ChartDataFor<T extends ChartType> = T extends "bar" | "radar" ? ChartRow[] | ChartSeries[] : T extends "line" | "area" ? ChartSeries[] | ChartRow[] : T extends "pie" | "donut" | "funnel" ? ChartSlice[] : T extends "scatter" | "scatterplot" | "heatmap" ? ChartSeries[] : T extends "calendar" ? ChartDay[] : T extends "treemap" | "sunburst" ? ChartTree : never;
+type ChartDataFor<T extends ChartType> = T extends "bar" | "radar" ? ChartRow[] | ChartSeries[] : T extends "line" | "area" ? ChartSeries[] | ChartRow[] : T extends "pie" | "donut" | "funnel" ? ChartSlice[] : T extends "heatmap" ? ChartSeries[] | ChartMatrix : T extends "scatter" | "scatterplot" ? ChartSeries[] : T extends "calendar" ? ChartDay[] : T extends "treemap" | "sunburst" ? ChartTree : never;
 /**
  * Per-series presentation, keyed by series id (the `keys` of a row chart, the
  * `id` of a series or slice). Colours default to `var(--ds-viz-1..n)` in key
@@ -151,6 +396,19 @@ interface ChartContainerProps extends Omit<React$1.ComponentProps<"div">, "child
    * `responsive={false}`.
    */
   responsive?: boolean;
+  /**
+   * Give the drawing area a floor of 600×300 so it draws where the layout
+   * gives it none.
+   *
+   * Both engines size themselves from the parent box. Under jsdom nothing has
+   * layout — every element measures 0×0 — so a page test that renders a screen
+   * containing a Chart gets an empty `<div>` and can assert nothing about it.
+   * `testMode` sets `min-width` / `min-height` on the container and hands the
+   * same floor to Recharts' ResponsiveContainer, so the chart draws at
+   * 600×300. It is a floor, not a fixed size: a parent that *does* give the
+   * chart 900px still gets 900px, so a screenshot test is unaffected.
+   */
+  testMode?: boolean;
   children: React$1.ReactNode;
 }
 /**
@@ -161,7 +419,7 @@ interface ChartContainerProps extends Omit<React$1.ComponentProps<"div">, "child
  * cursor classes from tokens with a caption-sm floor for text, so a custom
  * chart composed inside it needs no local colours or fonts.
  */
-declare function ChartContainer({ config, height, responsive, className, style, children, ...props }: ChartContainerProps): React$1.JSX.Element;
+declare function ChartContainer({ config, height, responsive, testMode, className, style, children, ...props }: ChartContainerProps): React$1.JSX.Element;
 /** "No data" placeholder; rendered by Chart when the data is empty. */
 declare function ChartEmpty({ children, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 /** Error placeholder; rendered by Chart for an `error` prop or a failed Nivo chunk. */
@@ -243,6 +501,14 @@ interface ChartProps<T extends ChartType = ChartType> extends Omit<ChartContaine
  * Colours, fonts, axes, grid, tooltip, legend and the empty, loading and
  * error states all come from cortena-design tokens; a consumer passes data
  * and, optionally, a `config` of labels.
+ *
+ * `heatmap` takes either the Nivo series shape or a categorical
+ * {@link ChartMatrix} — `{ rows, columns, values }` — for the correlation and
+ * confusion matrices that are already in that form.
+ *
+ * `testMode` gives the drawing area a 600×300 floor so a chart still draws
+ * where the layout gives it no size; see {@link ChartContainerProps.testMode}
+ * and README.md, "Charts in tests".
  */
 declare function Chart<T extends ChartType>({ type, data, config, renderer, indexBy, keys, stacked, scale, legend, grid, tooltip, valueFormatter, from, to, loading, error, emptyMessage, className, height, ...props }: ChartProps<T>): React$1.JSX.Element;
 //#endregion
@@ -728,12 +994,22 @@ interface DataTableViewProps<Row extends RowData> {
   /** Error to show above the table, in addition to the server source's. */
   error?: string | Error | null;
   onRowClick?: (row: Row, event: React$1.MouseEvent<HTMLTableRowElement>) => void;
+  /**
+   * The row a detail pane is currently showing, matched against the row id
+   * (`getRowId`, the row index when that is not set). It gets `data-active`
+   * and the `--ds-primary-soft` tint, independent of checkbox selection — a
+   * master/detail list highlights one row without selecting it, and a table
+   * with both can show a selected set and one open row at once.
+   */
+  activeRowId?: string | null;
+  /** Extra classes per row, e.g. to dim rows the app considers stale. */
+  rowClassName?: (row: Row) => string | undefined;
 }
 type DataTableProps<Row extends RowData> = DataTableViewProps<Row> & ({
   instance: DataTableInstance<Row>;
 } | UseDataTableOptions<Row>);
 declare function DataTable<Row extends RowData>(props: DataTableProps<Row>): React$1.JSX.Element;
-declare function DataTableView<Row extends RowData>({ instance, className, maxHeight, virtualize, rowHeight, stickyHeader, density, renderSubComponent, toolbar, bulkActions, toolbarActions, searchPlaceholder, emptyState, emptyMessage, pageSizeOptions, enableExport, exportFileName, loading, error, onRowClick }: DataTableViewProps<Row> & {
+declare function DataTableView<Row extends RowData>({ instance, className, maxHeight, virtualize, rowHeight, stickyHeader, density, renderSubComponent, toolbar, bulkActions, toolbarActions, searchPlaceholder, emptyState, emptyMessage, pageSizeOptions, enableExport, exportFileName, loading, error, onRowClick, activeRowId, rowClassName }: DataTableViewProps<Row> & {
   instance: DataTableInstance<Row>;
 }): React$1.JSX.Element;
 //#endregion
@@ -841,6 +1117,196 @@ export declare function downloadCsv<Row extends RowData>(table: DataTableTable<R
  */
 export declare function downloadExcel<Row extends RowData>(table: DataTableTable<Row>, fileName?: string, rows?: DataTableRow<Row>[]): Promise<void>;
 //#endregion
+//#region src/a2ui/views.d.ts
+/** A row in an agent-drawn table. Every value is opaque until a column reads it. */
+type A2UIRow = Record<string, unknown>;
+/** Where a node sits, carried into every action the view emits. */
+interface A2UINodeInfo {
+  surfaceId: string;
+  componentId: string;
+  /** JSON pointer this node's relative bindings resolve against. */
+  dataContextPath: string;
+}
+/** A normalised action attached to an interactive property. */
+interface A2UIResolvedAction {
+  name: string;
+  context?: Record<string, unknown>;
+}
+/** What every view receives. */
+interface A2UIViewProps<P> {
+  props: P;
+  node: A2UINodeInfo;
+  /** Already-rendered child nodes, in the order the component listed them. */
+  children: React$1.ReactNode[];
+  /** The surface data model, for actions that report the whole form. */
+  dataModel: Record<string, unknown>;
+  /**
+   * Send an action. `action` is what the agent attached to the property; when
+   * it is absent the event still fires under `fallbackName` so a host can
+   * observe interactions the agent did not ask for.
+   */
+  emit: (action: A2UIResolvedAction | undefined, fallbackName: string, payload?: Record<string, unknown>) => void;
+  /** Write a value back to the data model where this prop was bound. No-op for a literal. */
+  writeBack: (property: string, value: unknown) => void;
+  /** Resolve a `{ kind: "server", sourceId }` handle into a real data source. */
+  resolveDataSource: (sourceId: string) => DataSource<A2UIRow> | undefined;
+  /** Debounce applied to continuous inputs before they become actions. */
+  debounceMs: number;
+}
+type A2UIView<P> = React$1.FC<A2UIViewProps<P>>;
+interface A2UIColumn {
+  id: string;
+  label?: string;
+  align?: "start" | "center" | "end";
+  filter?: "faceted" | "text";
+  width?: number;
+}
+/**
+ * Where a table's rows come from.
+ *
+ * `client` carries the rows inline, which suits a short result an agent
+ * already has. `server` carries a handle instead: the agent obtains a
+ * `sourceId` from a tool and the host resolves it through
+ * `resolveDataSource`, so search, sort and paging run on the backend and the
+ * agent never has to put ten thousand rows in a message.
+ */
+type A2UITableSource = {
+  kind: "client";
+  rows: A2UIRow[];
+} | {
+  kind: "server";
+  sourceId: string;
+};
+/**
+ * What the renderer draws instead of a component it cannot draw.
+ *
+ * Never raw markup and never the offending payload as HTML: the detail is set
+ * as text, so a malformed message cannot inject anything. This is the
+ * "fallback: an error card on malformed payloads" of `05-agent-ui.md`.
+ */
+export declare function A2UIErrorCard({ title, detail, componentId }: {
+  title: string;
+  detail?: string;
+  componentId?: string;
+}): React$1.JSX.Element;
+//#endregion
+//#region src/a2ui/catalogue.d.ts
+/** The five families the doc and the prompt group components by. */
+type A2UIGroup = "layout" | "text" | "input" | "feedback" | "data";
+/** A ready-to-render example: the components, plus any data model they bind to. */
+interface A2UIExample {
+  /** Components for this entry. The first is the one being demonstrated. */
+  components: A2UIComponentSpec[];
+  /** Seed data for `{ path }` bindings used by the example. */
+  data?: Record<string, unknown>;
+}
+interface A2UICatalogueEntry<P = unknown> {
+  /** The name an agent writes in `component`. */
+  name: string;
+  group: A2UIGroup;
+  /** One sentence, used verbatim in the generated prompt section. */
+  summary: string;
+  /** Schema of the resolved properties. */
+  props: z.ZodType<P>;
+  /** Event names this component can raise through `onAction`. */
+  events: readonly string[];
+  /** `many` takes a `children` list; `none` ignores one. */
+  children: "none" | "many";
+  example: A2UIExample;
+  view: A2UIView<P>;
+}
+type A2UICatalogue = Readonly<Record<string, A2UICatalogueEntry<never>>>;
+/**
+ * The catalogue an agent draws from, and the renderer's default.
+ *
+ * A host may narrow it (hand the renderer a subset) but should not widen it
+ * with components the prompt does not describe: an agent can only usefully
+ * emit what `catalogue-doc.ts` told it about.
+ */
+export declare const defaultCatalogue: A2UICatalogue;
+/** Catalogue id an agent may echo in `createSurface.catalogId`. */
+export declare const A2UI_CATALOGUE_ID = "https://cortena.ai/a2ui/catalogues/cortena-ui/v1.json";
+/** Every component name in the catalogue, sorted. */
+export declare function catalogueNames(catalogue?: A2UICatalogue): string[];
+//#endregion
+//#region src/a2ui/catalogue-doc.d.ts
+/** A JSON Schema object, as far as this module cares. */
+type JsonSchema = Record<string, unknown>;
+interface A2UIComponentDoc {
+  name: string;
+  group: A2UIGroup;
+  summary: string;
+  /** Whether the component takes a `children` list. */
+  children: "none" | "many";
+  /** Event names the component raises through `onAction`. */
+  events: string[];
+  /** JSON Schema of the resolved properties, derived from the zod schema. */
+  props: JsonSchema;
+  /** Property names that must be present. */
+  required: string[];
+  /** A complete, renderable example: the components and any data they bind to. */
+  example: {
+    components: A2UIComponentSpec[];
+    data?: Record<string, unknown>;
+  };
+}
+interface A2UICatalogueDoc {
+  catalogueId: string;
+  protocol: string;
+  generator: string;
+  components: A2UIComponentDoc[];
+}
+/** Build the machine-readable catalogue document. */
+export declare function buildCatalogueDoc(catalogue?: A2UICatalogue): A2UICatalogueDoc;
+/**
+ * Render the catalogue document as markdown.
+ *
+ * The output is written to be pasted into a system prompt: one table per
+ * component listing every property with its type, whether it is required and
+ * what it means, then a fenced example an agent can copy.
+ */
+export declare function catalogueMarkdown(doc?: A2UICatalogueDoc): string;
+/** Turn an entry's example into the messages an agent would actually send. */
+export declare function exampleMessages(component: A2UIComponentDoc): unknown[];
+//#endregion
+//#region src/a2ui/renderer.d.ts
+interface A2UIRendererProps {
+  /**
+   * The payload. One message, the list an AG-UI `CUSTOM` event carries, or the
+   * JSONL text `canvas.a2ui.pushJSONL` sends. Later messages fold onto earlier
+   * ones, so a push stream can be accumulated by the host and handed here whole.
+   */
+  message: A2UIMessageInput;
+  /** The component vocabulary. Defaults to the whole cortena-ui catalogue. */
+  catalogue?: A2UICatalogue;
+  /** Receives every user event, shaped like A2UI's client-to-server action. */
+  onAction?: (action: A2UIAction) => void;
+  /**
+   * Resolves a `{ kind: "server", sourceId }` table handle into a real data
+   * source. Without it, a server table renders an error card rather than an
+   * empty one, because a silently empty table reads as "no results".
+   */
+  resolveDataSource?: (sourceId: string) => DataSource<A2UIRow> | undefined;
+  /** Render only this surface. Default: every surface, in arrival order. */
+  surfaceId?: string;
+  /** Debounce before a continuous input becomes an action. @default 300 */
+  debounceMs?: number;
+  className?: string;
+}
+/**
+ * A2UIRenderer — draws A2UI messages through cortena-ui.
+ *
+ * ```tsx
+ * <A2UIRenderer
+ *   message={customEvent.value}
+ *   catalogue={defaultCatalogue}
+ *   onAction={(action) => agent.send(action)}
+ *   resolveDataSource={(id) => sources[id]}
+ * />
+ * ```
+ */
+export declare function A2UIRenderer({ message, catalogue, onAction, resolveDataSource, surfaceId, debounceMs, className }: A2UIRendererProps): React$1.JSX.Element;
+//#endregion
 //#region src/components/accordion.d.ts
 /**
  * Accordion.
@@ -860,13 +1326,8 @@ declare function AccordionTrigger({ className, children, ...props }: Accordion$1
 declare function AccordionContent({ className, children, ...props }: Accordion$1.Panel.Props): import("react").JSX.Element;
 //#endregion
 //#region src/components/alert.d.ts
-/**
- * Alert — an inline callout. Tinted variants use the `-soft` fill for the
- * background and the tone colour for the border and icon; the body text stays
- * on the foreground token so it reads in both themes.
- */
 declare const alertVariants: (props?: ({
-  variant?: "default" | "success" | "warn" | "danger" | "info" | null | undefined;
+  variant?: "default" | "success" | "warn" | "destructive" | "danger" | "info" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface AlertProps extends React$1.ComponentProps<"div">, VariantProps<typeof alertVariants> {}
 declare function Alert({ className, variant, ...props }: AlertProps): React$1.JSX.Element;
@@ -889,17 +1350,98 @@ declare function AvatarImage({ className, ...props }: Avatar$1.Image.Props): imp
 declare function AvatarFallback({ className, ...props }: Avatar$1.Fallback.Props): import("react").JSX.Element;
 //#endregion
 //#region src/components/badge.d.ts
-/**
- * Badge — the mono, uppercase status label. Each tone pairs a `-soft` fill
- * with its foreground token; `warn`, `danger` and `secondary` are aliases kept
- * for cortenaweb call sites.
- */
 declare const badgeVariants: (props?: ({
-  variant?: "default" | "success" | "warning" | "warn" | "danger" | "destructive" | "info" | "neutral" | "secondary" | "outline" | null | undefined;
+  variant?: "default" | "success" | "warn" | "destructive" | "danger" | "info" | "warning" | "neutral" | "secondary" | "outline" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface BadgeProps extends React$1.ComponentProps<"span">, VariantProps<typeof badgeVariants> {}
 declare function Badge({ className, variant, ...props }: BadgeProps): React$1.JSX.Element;
 //#endregion
+//#region src/lib/render.d.ts
+/**
+ * The `render` prop for the components that are plain markup rather than Base
+ * UI primitives (Card, SectionCard, ButtonLink, BreadcrumbLink).
+ *
+ * Base UI parts take their own `render` and need nothing from here. The rest
+ * are a `<div>` or an `<a>` this package writes itself, and a consumer
+ * sometimes needs a different element under the same styling: a Card that is
+ * the page's `<aside>` landmark, or a link that is the router's `<Link>`.
+ * Passing an element rather than a component keeps the call site readable and
+ * lets the caller set props on it (`render={<Link to="/x" />}`).
+ *
+ * `props` wins over the passed element's own props, so the `className` and
+ * handlers a component computed are not silently dropped, while the element's
+ * own props (`href`, `to`, `aria-labelledby`) come through untouched. What a
+ * component lets a *caller* override is decided by the order it builds `props`
+ * in, not here. Children are `children`, falling back to the element's.
+ */
+type RenderProp = React$1.ReactElement<Record<string, unknown>>;
+//#endregion
+//#region src/components/breadcrumb.d.ts
+/**
+ * Breadcrumb — the trail above a page title.
+ *
+ * A `<nav aria-label="Breadcrumb">` around an ordered list, which is what
+ * assistive technology expects: the list order is the hierarchy, so a screen
+ * reader announces "list, 4 items" and reads the path in order. Separators are
+ * decorative list items, not text inside the links, so a link's accessible
+ * name is the crumb and nothing else.
+ *
+ * The last crumb is `BreadcrumbPage`, not a link: it is the page you are on,
+ * so it carries `aria-current="page"` and is not focusable. Everything before
+ * it is a `BreadcrumbLink`.
+ *
+ * ```tsx
+ * <Breadcrumb>
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbEllipsis />
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbPage>Invoice 4021</BreadcrumbPage>
+ *     </BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumb>
+ * ```
+ *
+ * **Router links.** `BreadcrumbLink` renders an `<a>` by default. Pass
+ * `render` with the router's link component and the class name, `href` and
+ * handlers are merged onto it, the same contract as `ButtonLink`:
+ * `render={<NextLink href="/projects" />}` or
+ * `render={<Link to="/projects" />}`. This is deliberately not Base UI's
+ * `render` — a breadcrumb is markup, not a Base UI primitive — but it takes
+ * the same shape so there is one thing to remember.
+ */
+declare function Breadcrumb({ className, ...props }: React$1.ComponentProps<"nav">): React$1.JSX.Element;
+declare function BreadcrumbList({ className, ...props }: React$1.ComponentProps<"ol">): React$1.JSX.Element;
+declare function BreadcrumbItem({ className, ...props }: React$1.ComponentProps<"li">): React$1.JSX.Element;
+interface BreadcrumbLinkProps extends React$1.ComponentProps<"a"> {
+  /** Replace the rendered `<a>` with a router link; props are merged onto it. */
+  render?: RenderProp;
+}
+declare function BreadcrumbLink({ className, render, children, ...props }: BreadcrumbLinkProps): React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>>;
+/**
+ * The current page: the last crumb, which is not a link.
+ *
+ * A plain `<span aria-current="page">`, deliberately not `role="link"` with
+ * `aria-disabled` — a disabled link that cannot be focused is a fiction, and
+ * it makes `getByRole("link")` return a crumb that navigates nowhere. With a
+ * span, the roles in the trail are exactly the crumbs you can travel to.
+ */
+declare function BreadcrumbPage({ className, ...props }: React$1.ComponentProps<"span">): React$1.JSX.Element;
+/** Decorative divider between two crumbs; a chevron unless children replace it. */
+declare function BreadcrumbSeparator({ className, children, ...props }: React$1.ComponentProps<"li">): React$1.JSX.Element;
+/**
+ * Stands in for the crumbs a long trail collapses; put it inside a
+ * BreadcrumbItem. The glyph is hidden and the label is not: an ellipsis that
+ * announces nothing leaves a screen-reader user with a gap in the path.
+ */
+declare function BreadcrumbEllipsis({ className, children, ...props }: React$1.ComponentProps<"span">): React$1.JSX.Element;
+//#endregion
 //#region src/components/button.d.ts
 /**
  * Button.
@@ -912,7 +1454,7 @@ declare function Badge({ className, variant, ...props }: BadgeProps): React$1.JS
  * rendered element, which is Base UI's equivalent.
  */
 declare const buttonVariants: (props?: ({
-  variant?: "destructive" | "secondary" | "outline" | "primary" | "ghost" | "soft" | "link" | null | undefined;
+  variant?: "link" | "destructive" | "secondary" | "outline" | "primary" | "ghost" | "soft" | null | undefined;
   size?: "sm" | "md" | "lg" | "icon" | "icon-sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface ButtonProps extends React$1.ComponentProps<typeof Button$1>, VariantProps<typeof buttonVariants> {}
@@ -935,10 +1477,10 @@ declare function Button({ className, variant, size, ...props }: ButtonProps): Re
 interface ButtonLinkProps extends Omit<React$1.ComponentProps<"a">, "children">, Pick<ButtonProps, "variant" | "size"> {
   children?: React$1.ReactNode;
   /** Replace the rendered `<a>` with a router link; props are merged onto it. */
-  render?: React$1.ReactElement<Record<string, unknown>>;
+  render?: RenderProp;
   disabled?: boolean;
 }
-declare function ButtonLink({ className, variant, size, render, disabled, children, ...props }: ButtonLinkProps): React$1.JSX.Element;
+declare function ButtonLink({ className, variant, size, render, disabled, children, ...props }: ButtonLinkProps): React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>>;
 //#endregion
 //#region src/components/calendar.d.ts
 /**
@@ -969,8 +1511,21 @@ interface CardProps extends React$1.ComponentProps<"div"> {
   hover?: boolean;
   /** Draw the border in the ring colour, for a selected or highlighted card. */
   accent?: boolean;
+  /**
+   * Replace the rendered `<div>` with another element, so a card can *be* the
+   * landmark rather than sit inside a wrapper that is one:
+   * `render={<aside />}` for a sidebar panel, `render={<section />}` (with an
+   * `aria-labelledby` pointing at its title) for a labelled region,
+   * `render={<article />}` for a self-contained item in a feed. Props set on
+   * the passed element come through; the card's own styling wins.
+   */
+  render?: RenderProp;
 }
-declare function Card({ className, hover, accent, ...props }: CardProps): React$1.JSX.Element;
+/**
+ * Card — the bordered surface everything else sits on. `render` changes the
+ * element without changing the look, which is how a card becomes a landmark.
+ */
+declare function Card({ className, hover, accent, render, children, ...props }: CardProps): React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>>;
 declare function CardHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 declare function CardTitle({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 declare function CardDescription({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
@@ -1301,6 +1856,10 @@ interface DropzoneProps extends Omit<React$1.ComponentProps<"div">, "children" |
   /** Most files accepted per drop; `0` means unlimited. */
   maxFiles?: number;
   disabled?: boolean;
+  /** Do not open the file dialog on click; for a zone that wraps clickable content. @default false */
+  noClick?: boolean;
+  /** Do not open the file dialog on Enter or Space; pair with `noClick`. @default false */
+  noKeyboard?: boolean;
   /** Primary line of the default body. */
   label?: React$1.ReactNode;
   /** Muted second line of the default body; derived from `accept` and `maxSize` when omitted. */
@@ -1308,7 +1867,7 @@ interface DropzoneProps extends Omit<React$1.ComponentProps<"div">, "children" |
   /** Replace the default body. A function receives react-dropzone's state. */
   children?: React$1.ReactNode | ((state: DropzoneState) => React$1.ReactNode);
 }
-declare function Dropzone({ onFiles, onReject, accept, multiple, maxSize, maxFiles, disabled, label, hint, children, className, ref, ...props }: DropzoneProps): React$1.JSX.Element;
+declare function Dropzone({ onFiles, onReject, accept, multiple, maxSize, maxFiles, disabled, noClick, noKeyboard, label, hint, children, className, ref, ...props }: DropzoneProps): React$1.JSX.Element;
 interface FileListProps extends Omit<React$1.ComponentProps<"ul">, "children"> {
   files: readonly File[];
   /** Called with the file and its index when its remove button is pressed; the button is hidden when omitted. */
@@ -1375,7 +1934,7 @@ declare function ErrorBanner({ message, onDismiss, onRetry, className, ...props
  * list) it renders whenever the list has a message.
  */
 declare const fieldVariants: (props?: ({
-  orientation?: "vertical" | "horizontal" | null | undefined;
+  orientation?: "horizontal" | "vertical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface FieldProps extends React$1.ComponentProps<typeof Field$1.Root>, VariantProps<typeof fieldVariants> {}
 declare function Field({ className, orientation, invalid, ...props }: FieldProps): React$1.JSX.Element;
@@ -1642,6 +2201,10 @@ interface SectionCardProps extends Omit<CardProps, "title"> {
  * SectionCard — a Card with a header row (title, description, actions), a
  * body and an optional footer. It composes the Card parts rather than
  * restyling them, so a SectionCard and a hand-built Card look identical.
+ *
+ * `render` is Card's and reaches the outer element, so a section card can be
+ * the landmark it is named after: `render={<section aria-labelledby={id} />}`
+ * with the same `id` on the title, or `render={<aside />}` for a side panel.
  */
 declare function SectionCard({ title, description, actions, footer, flush, bodyClassName, children, ...props }: SectionCardProps): React$1.JSX.Element;
 //#endregion
@@ -1683,8 +2246,33 @@ declare function Segmented<T extends string = string>({ className, value, onValu
  * - `onValueChange` receives `(value, eventDetails)`.
  * - `SelectContent` defaults to the dropdown layout; pass
  *   `alignItemWithTrigger` for Base UI's native-like overlay of the selected item.
+ *
+ * ## Typing the value
+ *
+ * `null` is the cleared / placeholder state, so `onValueChange` always hands
+ * back `Value | null`, never bare `Value`. Name the value type on the element
+ * to keep that union at `string | null` instead of letting inference widen it:
+ *
+ * ```tsx
+ * const [status, setStatus] = useState("");
+ *
+ * <Select<string>
+ *   // "" is not a value any item carries; `|| null` is the placeholder state,
+ *   // which is what makes SelectValue fall back to its `placeholder`.
+ *   value={status || null}
+ *   onValueChange={(next) => setStatus(next ?? "")} // next: string | null
+ * >
+ * ```
+ *
+ * Without the explicit `<string>` the type argument is inferred from `value`,
+ * so a `string | null` value widens `Value` and the handler's parameter turns
+ * into `string | null | null`. Multi-select narrows too:
+ * `<Select<string, true> multiple>` hands back `string[]`, never `null`.
+ *
+ * `SelectProps` is the same props type, for a wrapper that forwards them.
  */
-declare function Select<Value, Multiple extends boolean | undefined = false>(props: Select$1.Root.Props<Value, Multiple>): import("react").JSX.Element;
+type SelectProps<Value = string, Multiple extends boolean | undefined = false> = Select$1.Root.Props<Value, Multiple>;
+declare function Select<Value, Multiple extends boolean | undefined = false>(props: SelectProps<Value, Multiple>): import("react").JSX.Element;
 declare function SelectGroup({ className, ...props }: Select$1.Group.Props): import("react").JSX.Element;
 declare function SelectValue({ className, ...props }: Select$1.Value.Props): import("react").JSX.Element;
 interface SelectTriggerProps extends Select$1.Trigger.Props {
@@ -1716,15 +2304,15 @@ interface SeparatorProps extends React$1.ComponentProps<typeof Separator$1> {
 declare function Separator({ className, orientation, decorative, ...props }: SeparatorProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/sheet.d.ts
-/**
- * Sheet: a Dialog whose Popup is anchored to one edge of the viewport.
- *
- * Same Base UI parts as Dialog (Root, Trigger, Portal, Backdrop, Popup, Title,
- * Description, Close); only the Popup's placement differs, chosen by `side`.
- * `SheetContent` composes Portal + Backdrop + Popup so consumers keep writing
- * `<SheetContent side="right">…</SheetContent>`.
- */
-declare function Sheet(props: Dialog$1.Root.Props): React$1.JSX.Element;
+interface SheetProps extends Dialog$1.Root.Props {
+  /**
+   * `true` (default) traps focus, locks page scroll and draws a backdrop.
+   * `false` draws no backdrop and traps nothing, for a panel read alongside
+   * the app. `"trap-focus"` keeps focus in but leaves the page scrollable.
+   */
+  modal?: boolean | "trap-focus";
+}
+declare function Sheet({ modal, ...props }: SheetProps): React$1.JSX.Element;
 declare function SheetTrigger(props: Dialog$1.Trigger.Props): React$1.JSX.Element;
 declare function SheetClose(props: Dialog$1.Close.Props): React$1.JSX.Element;
 declare function SheetPortal(props: Dialog$1.Portal.Props): React$1.JSX.Element;
@@ -1753,20 +2341,6 @@ declare function SheetDescription({ className, ...props }: Dialog$1.Description.
 declare function Skeleton({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 //#endregion
 //#region src/components/sortable-list.d.ts
-/**
- * SortableList.
- *
- * A reorderable list over dnd-kit: `DndContext` + `SortableContext` around one
- * `useSortable` item per entry. The list owns nothing — it calls `onReorder`
- * with the next array and the consumer stores it. Pointer and keyboard sensors
- * are wired (Space picks up, arrows move, Space drops, Escape cancels) and a
- * `DragOverlay` paints the lifted copy with `--ds-shadow-lg` while the item
- * left behind dims and takes the ring colour.
- *
- * By default the whole row is the drag activator. Pass `handle` to restrict
- * dragging to a `<SortableHandle>` (or any element given `handleProps`) so
- * buttons and inputs inside a row stay clickable.
- */
 /** Spread onto the element that should start a drag. */
 interface SortableHandleProps extends Partial<DraggableAttributes> {
   ref: (element: HTMLElement | null) => void;
@@ -1781,17 +2355,39 @@ interface SortableRenderState {
   /** True for the item being dragged (and for the overlay copy). */
   isDragging: boolean;
 }
+/** What moved where, passed to `onReorder` alongside the reordered array. */
+interface SortableReorderDetails {
+  /** Index the item came from, in the array as it was passed in. */
+  from: number;
+  /** Index it landed on. */
+  to: number;
+  /** Id of the item that moved (`getId` of the dragged item). */
+  activeId: UniqueIdentifier;
+  /** Id of the item it was dropped onto. */
+  overId: UniqueIdentifier;
+}
 interface SortableListProps<T> extends Omit<React$1.ComponentProps<"ul">, "children"> {
   items: readonly T[];
   /** Stable id per item; must be unique within the list. */
   getId: (item: T) => UniqueIdentifier;
-  /** Called with the reordered array after a successful drop. */
-  onReorder: (next: T[]) => void;
+  /**
+   * Called with the reordered array after a successful drop, and with the move
+   * itself — `{ from, to, activeId, overId }` — for a server that persists a
+   * position rather than the whole list.
+   */
+  onReorder: (next: T[], details: SortableReorderDetails) => void;
   renderItem: (item: T, state: SortableRenderState) => React$1.ReactNode;
   /** Layout axis; also selects the sorting strategy. */
   orientation?: "vertical" | "horizontal";
   /** Only a `<SortableHandle>` (or an element given `handleProps`) starts a drag. */
   handle?: boolean;
+  /**
+   * Let a finger scroll the page over the rows. Defaults to `handle`: `true`
+   * in handle mode, `false` in whole-row mode, which is what each already did.
+   * `true` on a whole-row list drops `touch-none` and uses a TouchSensor with
+   * delay activation, so a swipe scrolls and a held press drags.
+   */
+  touchScroll?: boolean;
   /** Disables every sensor and hides the handles. */
   disabled?: boolean;
   /** Class name for each item wrapper. */
@@ -1803,21 +2399,41 @@ interface SortableListProps<T> extends Omit<React$1.ComponentProps<"ul">, "child
  * `renderItem`. Hidden (kept in layout) when the list is disabled.
  */
 declare function SortableHandle({ className, children, ...props }: React$1.ComponentProps<"button">): React$1.JSX.Element;
-declare function SortableList<T>({ items, getId, onReorder, renderItem, orientation, handle, disabled, itemClassName: itemClass, className, ...props }: SortableListProps<T>): React$1.JSX.Element;
+declare function SortableList<T>({ items, getId, onReorder, renderItem, orientation, handle, disabled, touchScroll, itemClassName: itemClass, className, ...props }: SortableListProps<T>): React$1.JSX.Element;
 //#endregion
 //#region src/components/spinner.d.ts
 interface SpinnerProps extends React$1.ComponentProps<"span"> {
   /** Diameter in px. Defaults to 16. */
   size?: number;
+  /**
+   * `inverse` for a spinner on a filled surface — inside a primary or
+   * destructive Button, on a toast, on any `-foreground` pairing. The default
+   * ring is `--ds-border` with a `--ds-primary` leading edge, which all but
+   * disappears on a primary fill; `inverse` draws both from
+   * `--ds-primary-foreground` instead.
+   */
+  tone?: "default" | "inverse";
 }
 /**
- * Spinner — a ring with a primary-coloured leading edge. Announces itself as
+ * Spinner — a ring with a coloured leading edge. Announces itself as
  * `role="status"` with a "Loading" label; pass `aria-label` to override.
+ *
+ * ```tsx
+ * <Button disabled>
+ *   <Spinner tone="inverse" /> Saving…
+ * </Button>
+ * ```
  */
-declare function Spinner({ className, size, style, ...props }: SpinnerProps): React$1.JSX.Element;
+declare function Spinner({ className, size, tone, style, ...props }: SpinnerProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/status-dot.d.ts
-type StatusDotTone = "accent" | "success" | "warning" | "danger" | "info" | "neutral";
+/**
+ * The error tone is `destructive`, the same spelling Button, Alert and Badge
+ * use. `danger` is a deprecated alias of it and paints the same.
+ */
+type StatusDotTone = "accent" | "success" | "warning" | "destructive" |
+/** @deprecated Use `destructive`; this alias paints the same. */
+"danger" | "info" | "neutral";
 interface StatusDotProps extends Omit<React$1.ComponentProps<"span">, "children"> {
   tone?: StatusDotTone;
   /** Adds a pinging halo behind the dot for "currently active" states. */
@@ -1902,7 +2518,7 @@ declare function Textarea({ className, autoGrow, onChange, ref, ...props }: Text
  * `toastManager` to `Toaster` when you need to fire toasts outside React.
  */
 declare const toastVariants: (props?: ({
-  variant?: "default" | "success" | "warning" | "destructive" | null | undefined;
+  variant?: "default" | "success" | "destructive" | "warning" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 /** The Base UI toast manager: `{ toasts, add, close, update, promise }`. */
 declare const useToast: typeof Toast$1.useToastManager;
@@ -2059,5 +2675,5 @@ export declare function themeFromBackground(background: unknown): ResolvedCorten
 export declare function themeFromMessage(data: unknown): CortenaTheme | null;
 export declare function useCortenaTheme(options?: UseCortenaThemeOptions): UseCortenaThemeResult;
 //#endregion
-export { type Accept, Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertIcon, type AlertProps, AlertTitle, Area, AreaChart, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Bar, BarChart, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Calendar, CalendarDayButton, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, CartesianGrid, Cell, Chart, type ChartConfig, ChartContainer, type ChartContainerProps, type ChartDataFor, type ChartDay, ChartEmpty, type ChartEngine, ChartError, ChartLegend, ChartLegendContent, type ChartLegendContentProps, ChartLoading, type ChartPoint, type ChartProps, type ChartRenderer, type ChartRow, type ChartScale, type ChartScales, type ChartSeries, type ChartSlice, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps, type ChartTree, type ChartType, Checkbox, type CheckboxProps, Chip, type ChipProps, type ClientSource, type CodeRendererProps, Combobox, ComboboxChip, type ComboboxChipProps, ComboboxChips, type ComboboxChipsProps, ComboboxClear, ComboboxCollection, ComboboxContent, type ComboboxContentProps, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, type ComboboxInputProps, ComboboxItem, ComboboxSeparator, ComboboxStatus, ComboboxTrigger, ComboboxValue, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposedChart, type CortenaTheme, type CortenaThemeMessage, type DataSource, DataTable, type DataTableCell, type DataTableColumn, type DataTableColumnDef, DataTableColumnHeader, type DataTableColumnHeaderProps, type DataTableColumnMeta, type DataTableEditable, type DataTableEditingCell, DataTableExportMenu, type DataTableExportMenuProps, DataTableFacetedFilter, type DataTableFacetedFilterOption, type DataTableFacetedFilterProps, type DataTableFeatures, type DataTableInstance, DataTablePagination, type DataTablePaginationMode, type DataTablePaginationProps, type DataTableProps, type DataTableRow, type DataTableState, type DataTableTable, DataTableToolbar, type DataTableToolbarProps, DataTableView, DataTableViewOptions, type DataTableViewOptionsProps, type DataTableViewProps, DateField, type DateFieldProps, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, Dialog, DialogBody, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, Dropzone, type DropzoneProps, type DropzoneState, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ExportCell, type ExportSheet, Field, FieldContent, FieldControl, type FieldControlProps, FieldDescription, type FieldDescriptionProps, FieldError, type FieldErrorItem, type FieldErrorProps, FieldGroup, FieldLabel, type FieldLabelProps, type FieldProps, Fieldset, FieldsetLegend, type FieldsetLegendProps, type FieldsetProps, FileList, type FileListProps, type FileRejection, Form, FormControl, type FormControlProps, FormDescription, type FormDescriptionProps, FormField, FormItem, type FormItemProps, FormLabel, type FormLabelProps, FormMessage, type FormMessageProps, Funnel, FunnelChart, Input, type InputProps, Kbd, Label, LabelList, type LabelProps, Line, LineChart, LoadingSkeleton, type LoadingSkeletonPreset, type LoadingSkeletonProps, Markdown, type Components as MarkdownComponents, type MarkdownProps, type NivoTheme, PageHeader, type PageHeaderProps, Pie, PieChart, PolarAngleAxis, PolarGrid, PolarRadiusAxis, Popover, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverTitle, PopoverTrigger, Progress, ProgressIndicator, ProgressLabel, type ProgressProps, ProgressTrack, ProgressValue, Radar, RadarChart, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RechartsLegend, RechartsTooltip, ReferenceLine, type ResolvedCortenaTheme, ResponsiveContainer, Scatter, ScatterChart, ScrollArea, type ScrollAreaProps, ScrollBar, SectionCard, type SectionCardProps, Segmented, type SegmentedOption, type SegmentedProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, type SeparatorProps, type ServerSource, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, SortableHandle, type SortableHandleProps, SortableList, type SortableListProps, type SortableRenderState, Spinner, type SpinnerProps, StatusDot, type StatusDotProps, type StatusDotTone, type SubmitHandler, Switch, type SwitchProps, type TableQuery, type TableResult, Tabs, TabsContent, TabsIndicator, TabsList, TabsTrigger, Textarea, type TextareaProps, Toast, type ToastProps, Toaster, type ToasterProps, Toolbar, ToolbarEnd, type ToolbarProps, ToolbarSeparator, ToolbarStart, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseCortenaThemeOptions, type UseCortenaThemeResult, type UseDataTableOptions, type UseFormFieldReturn, type UseFormReturn, XAxis, YAxis, alertVariants, arrayMove, badgeVariants, buttonVariants, chipVariants, fieldVariants, formatDateDefault, formatDateISO, formatDateLong, formatDateShort, formatFileSize, formatRelative, inputClassName, labelVariants, markdownSanitizeSchema, parseDateDefault, parseDateISO, sheetVariants, textareaClassName, toastVariants, useComboboxFilter, useForm, useFormField, useToast, zodResolver };
+export { type A2UIAction, type A2UIActionSpec, type A2UIBeginRendering, type A2UICatalogue, type A2UICatalogueDoc, type A2UICatalogueEntry, type A2UIChildList, type A2UIChildren, type A2UIColumn, type A2UIComponentDoc, type A2UIComponentSpec, type A2UICreateSurface, type A2UIDataBinding, type A2UIDeleteSurface, type A2UIExample, type A2UIFoldResult, type A2UIGroup, type A2UIMessage, type A2UIMessageInput, type A2UINodeInfo, type A2UIPropertyValue, type A2UIRendererProps, type A2UIResolvedAction, type A2UIRow, type A2UISurface, type A2UITableSource, type A2UIUpdateComponents, type A2UIUpdateDataModel, type A2UIView, type A2UIViewProps, type Accept, Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertIcon, type AlertProps, AlertTitle, Area, AreaChart, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Bar, BarChart, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Calendar, CalendarDayButton, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, CartesianGrid, Cell, Chart, type ChartConfig, ChartContainer, type ChartContainerProps, type ChartDataFor, type ChartDay, ChartEmpty, type ChartEngine, ChartError, ChartLegend, ChartLegendContent, type ChartLegendContentProps, ChartLoading, type ChartMatrix, type ChartPoint, type ChartProps, type ChartRenderer, type ChartRow, type ChartScale, type ChartScales, type ChartSeries, type ChartSlice, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps, type ChartTree, type ChartType, Checkbox, type CheckboxProps, Chip, type ChipProps, type ClientSource, type CodeRendererProps, Combobox, ComboboxChip, type ComboboxChipProps, ComboboxChips, type ComboboxChipsProps, ComboboxClear, ComboboxCollection, ComboboxContent, type ComboboxContentProps, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, type ComboboxInputProps, ComboboxItem, ComboboxSeparator, ComboboxStatus, ComboboxTrigger, ComboboxValue, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposedChart, type CortenaTheme, type CortenaThemeMessage, type DataSource, DataTable, type DataTableCell, type DataTableColumn, type DataTableColumnDef, DataTableColumnHeader, type DataTableColumnHeaderProps, type DataTableColumnMeta, type DataTableEditable, type DataTableEditingCell, DataTableExportMenu, type DataTableExportMenuProps, DataTableFacetedFilter, type DataTableFacetedFilterOption, type DataTableFacetedFilterProps, type DataTableFeatures, type DataTableInstance, DataTablePagination, type DataTablePaginationMode, type DataTablePaginationProps, type DataTableProps, type DataTableRow, type DataTableState, type DataTableTable, DataTableToolbar, type DataTableToolbarProps, DataTableView, DataTableViewOptions, type DataTableViewOptionsProps, type DataTableViewProps, DateField, type DateFieldProps, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, Dialog, DialogBody, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, Dropzone, type DropzoneProps, type DropzoneState, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ExportCell, type ExportSheet, Field, FieldContent, FieldControl, type FieldControlProps, FieldDescription, type FieldDescriptionProps, FieldError, type FieldErrorItem, type FieldErrorProps, FieldGroup, FieldLabel, type FieldLabelProps, type FieldProps, Fieldset, FieldsetLegend, type FieldsetLegendProps, type FieldsetProps, FileList, type FileListProps, type FileRejection, Form, FormControl, type FormControlProps, FormDescription, type FormDescriptionProps, FormField, FormItem, type FormItemProps, FormLabel, type FormLabelProps, FormMessage, type FormMessageProps, Funnel, FunnelChart, Input, type InputProps, type JsonSchema, Kbd, Label, LabelList, type LabelProps, Line, LineChart, LoadingSkeleton, type LoadingSkeletonPreset, type LoadingSkeletonProps, Markdown, type Components as MarkdownComponents, type MarkdownProps, type NivoTheme, PageHeader, type PageHeaderProps, Pie, PieChart, PolarAngleAxis, PolarGrid, PolarRadiusAxis, Popover, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverTitle, PopoverTrigger, Progress, ProgressIndicator, ProgressLabel, type ProgressProps, ProgressTrack, ProgressValue, Radar, RadarChart, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RechartsLegend, RechartsTooltip, ReferenceLine, type ResolvedCortenaTheme, ResponsiveContainer, Scatter, ScatterChart, ScrollArea, type ScrollAreaProps, ScrollBar, SectionCard, type SectionCardProps, Segmented, type SegmentedOption, type SegmentedProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, type SelectProps, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, type SeparatorProps, type ServerSource, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, type SheetProps, SheetTitle, SheetTrigger, Skeleton, SortableHandle, type SortableHandleProps, SortableList, type SortableListProps, type SortableRenderState, type SortableReorderDetails, Spinner, type SpinnerProps, StatusDot, type StatusDotProps, type StatusDotTone, type SubmitHandler, Switch, type SwitchProps, type TableQuery, type TableResult, Tabs, TabsContent, TabsIndicator, TabsList, TabsTrigger, Textarea, type TextareaProps, Toast, type ToastProps, Toaster, type ToasterProps, Toolbar, ToolbarEnd, type ToolbarProps, ToolbarSeparator, ToolbarStart, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseCortenaThemeOptions, type UseCortenaThemeResult, type UseDataTableOptions, type UseFormFieldReturn, type UseFormReturn, XAxis, YAxis, alertVariants, arrayMove, badgeVariants, buttonVariants, chipVariants, fieldVariants, formatDateDefault, formatDateISO, formatDateLong, formatDateShort, formatFileSize, formatRelative, inputClassName, labelVariants, markdownSanitizeSchema, parseDateDefault, parseDateISO, sheetVariants, textareaClassName, toastVariants, useComboboxFilter, useForm, useFormField, useToast, zodResolver };
 //# sourceMappingURL=index.d.ts.map