gpui-bridge 0.0.0-stage → 0.3.0

package/dist/protocol.d.ts

@@ -0,0 +1,1586 @@
+export declare const PROTOCOL_VERSION = 1;
+export type NodeId = number;
+/** Client-assigned window id; `window` without `id` is window 1. */
+export type WindowId = number;
+export type NodeType = "div" | "text" | "Button" | "Input" | "Checkbox" | "Icon" | "Image" | "MenuBar" | "Switch" | "RadioGroup" | "Select" | "Slider" | "Textarea" | "Dialog" | "VirtualList" | "Table" | "Tabs" | "Tab" | "Alert" | "Badge" | "Tag" | "Kbd" | "Progress" | "Spinner" | "Skeleton" | "Rating" | "Pagination" | "Collapsible" | "Accordion" | "Avatar" | "Stepper" | "NumberInput" | "OtpInput" | "Form" | "Field" | "GroupBox" | "DescriptionList" | "StatusBar" | "Toolbar" | "Resizable" | "Calendar" | "Tree" | "Diff" | "Carousel" | "Sidebar" | "Chart" | "Canvas" | "Command" | "Settings" | "Toggle" | "DropdownButton" | "Label" | "Empty" | "Shimmer" | "InputGroup" | "Clipboard" | "AlertDialog" | "Sheet" | "Popover" | "HoverCard" | "DatePicker" | "TimeField" | "ColorPicker" | "Combobox" | "Bubble" | "Message" | "MessageHeader" | "MessageFooter" | "Marker" | "Attachment" | "MessageScroller" | "Questionnaire" | "List" | "ListItem" | "Dock" | "DockPanel" | "AccordionItem" | "DialogFooter" | "StatusBarLeft" | "StatusBarRight";
+export type WindowTheme = "light" | "dark";
+/** Events a window can report (PROTOCOL.md section 3); `window.events` opts in. */
+export type WindowEventName = "focus" | "blur" | "resize" | "move" | "visibility";
+/**
+ * A gpui-component theme file (PROTOCOL.md section 3). Field names are the file's own
+ * (snake_case, dotted color keys such as `"primary.background"`).
+ */
+export interface ThemeSet {
+    name?: string;
+    themes: ThemeConfig[];
+}
+export interface ThemeConfig {
+    name?: string;
+    mode?: WindowTheme;
+    font_size?: number;
+    font_family?: string;
+    radius?: number;
+    colors?: Record<string, string>;
+    [field: string]: unknown;
+}
+/** Node props on the wire. In `setProps`, a `null` value removes the prop. */
+export type Props = Record<string, unknown>;
+/** Messages from the client (host stdin). */
+export type ClientMessage = {
+    op: "hello";
+    protocol: number;
+} | {
+    op: "window";
+    id?: WindowId;
+    title?: string;
+    width?: number;
+    height?: number;
+    /** Initial position; read when the window opens. */
+    x?: number;
+    y?: number;
+    /** Minimum size the user can resize to; read when the window opens. */
+    minWidth?: number;
+    minHeight?: number;
+    root?: NodeId;
+    theme?: WindowTheme;
+    themeSet?: ThemeSet;
+    frameless?: boolean;
+    /** Minimizes (`true`) or restores (`false`) on commit; an action, not a remembered state. */
+    minimized?: boolean;
+    /** Window events the client wants; replaces the previous list. */
+    events?: WindowEventName[];
+} | {
+    op: "create";
+    id: NodeId;
+    type: NodeType;
+    props?: Props;
+    events?: string[];
+} | {
+    op: "append";
+    parent: NodeId;
+    child: NodeId;
+} | {
+    op: "insertBefore";
+    parent: NodeId;
+    child: NodeId;
+    before: NodeId;
+} | {
+    op: "setProps";
+    id: NodeId;
+    props: Props;
+} | {
+    op: "setEvents";
+    id: NodeId;
+    events: string[];
+} | {
+    op: "remove";
+    id: NodeId;
+} | {
+    op: "closeWindow";
+    id: WindowId;
+} | {
+    op: "tray";
+    icon?: string;
+    tooltip?: string;
+    menu?: MenuItem[];
+} | {
+    op: "removeTray";
+} | {
+    op: "shortcuts";
+    keys: string[];
+} | {
+    op: "focus";
+    id: NodeId;
+} | {
+    op: "openDialog";
+    request: number;
+    files?: boolean;
+    directories?: boolean;
+    multiple?: boolean;
+    prompt?: string;
+} | {
+    op: "saveDialog";
+    request: number;
+    directory?: string;
+    name?: string;
+} | {
+    op: "readClipboard";
+    request: number;
+} | {
+    op: "writeClipboard";
+    text: string;
+} | {
+    op: "openUrl";
+    url: string;
+} | {
+    op: "openPath";
+    path: string;
+} | {
+    op: "notify";
+    window?: WindowId;
+    id?: string;
+    type?: "info" | "success" | "warning" | "error";
+    title?: string;
+    message: string;
+    autohide?: boolean;
+    system?: boolean;
+} | {
+    op: "commit";
+};
+export type ErrorCode = "invalid_json" | "unknown_op" | "unknown_node" | "unknown_type" | "invalid_props" | "invalid_operation" | "protocol_mismatch";
+/** Messages from the host (host stdout). */
+export type HostMessage = {
+    type: "ready";
+    protocol: number;
+} | {
+    type: "event";
+    id: NodeId;
+    event: string;
+    value?: string | number | null | string[] | TableSort | DiffSelection | CanvasPoint | SettingsChange | QuestionnaireAnswer | QuestionnaireAnswer[];
+    checked?: boolean;
+    paths?: string[];
+} | {
+    type: "windowClosed";
+    id: WindowId;
+}
+/** A window event the client opted into with `window.events`; `move`/`resize` carry bounds. */
+ | {
+    type: "windowEvent";
+    id: WindowId;
+    event: WindowEventName;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    visible?: boolean;
+} | {
+    type: "tray";
+    event: "click" | "menu";
+    value?: string;
+} | {
+    type: "shortcut";
+    keys: string;
+    window: WindowId;
+} | {
+    type: "notification";
+    id: string;
+    window: WindowId;
+} | {
+    type: "result";
+    request: number;
+    paths?: string[] | null;
+    path?: string | null;
+    text?: string | null;
+} | {
+    type: "error";
+    code: ErrorCode;
+    message: string;
+    op?: string;
+    request?: number;
+};
+/** A window title bar part, handled by the system (PROTOCOL.md section 5). */
+export type WindowControl = "drag" | "minimize" | "maximize" | "close";
+/**
+ * A menu entry (PROTOCOL.md section 10): an item with an `id`, a submenu with `items`, or a separator.
+ * Choosing an item sends the node's `menu` event with its `id`.
+ */
+export type MenuItem = {
+    id: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    checked?: boolean;
+    /** A key such as `ctrl-s`: shown next to the label; in a `MenuBar` it also chooses the item. */
+    shortcut?: string;
+} | {
+    label: string;
+    items: MenuItem[];
+    icon?: string;
+    disabled?: boolean;
+} | {
+    separator: true;
+};
+/** A top-level menu of a `MenuBar`. */
+export interface Menu {
+    label: string;
+    items: MenuItem[];
+}
+/** The roles a node may name (PROTOCOL.md section 16), in ARIA's names. */
+export type A11yRole = "alert" | "alertdialog" | "article" | "banner" | "button" | "cell" | "checkbox" | "columnheader" | "combobox" | "complementary" | "contentinfo" | "definition" | "dialog" | "document" | "form" | "grid" | "gridcell" | "group" | "heading" | "img" | "label" | "link" | "list" | "listbox" | "listitem" | "log" | "main" | "menu" | "menubar" | "menuitem" | "navigation" | "note" | "paragraph" | "progressbar" | "radio" | "radiogroup" | "region" | "row" | "rowheader" | "scrollbar" | "searchbox" | "separator" | "slider" | "spinbutton" | "status" | "switch" | "tab" | "table" | "tablist" | "tabpanel" | "textbox" | "time" | "toolbar" | "tooltip" | "tree" | "treeitem" | "window";
+/**
+ * Accessibility for a node (PROTOCOL.md section 16). GPUI reports to assistive technology only
+ * the elements that have both an id and a role, so a `div` that acts as a button needs this.
+ */
+export interface A11y {
+    /** A stable identifier, visible to assistive technology (UIA `AutomationId` on Windows). */
+    id?: string;
+    role?: A11yRole;
+    label?: string;
+    /** Supplementary text, read after the label. */
+    description?: string;
+    /** The keys that activate the element (`ctrl-s`). */
+    keyshortcuts?: string;
+    checked?: boolean | "mixed";
+    selected?: boolean;
+    expanded?: boolean;
+    disabled?: boolean;
+    /** Also reported as a number when `min`, `max` or `step` is given. */
+    value?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** A heading's level, from 1. */
+    level?: number;
+    orientation?: "horizontal" | "vertical";
+}
+/** Props every node accepts (PROTOCOL.md section 16). */
+export interface SharedProps {
+    /** Nothing about the node is reported to assistive technology without it. */
+    a11y?: A11y;
+}
+export interface DivProps {
+    class?: string;
+    windowControl?: WindowControl;
+    /** Opens on right-click. */
+    contextMenu?: MenuItem[];
+    /** Shown when the pointer rests on the div. */
+    tooltip?: string;
+}
+export interface TextProps {
+    content?: string;
+    class?: string;
+}
+export interface ButtonProps {
+    label?: string;
+    variant?: "primary" | "secondary" | "ghost" | "danger";
+    disabled?: boolean;
+    tooltip?: string;
+    class?: string;
+}
+export interface InputProps {
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** The host only reports edits; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface CheckboxProps {
+    checked?: boolean;
+    label?: string;
+    disabled?: boolean;
+    /** The host only reports clicks; the client confirms them with `checked`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface IconProps {
+    /** A bundled icon, by its Lucide name (`folder`, `file-text`…; PROTOCOL.md section 5). */
+    name?: string;
+    class?: string;
+}
+export interface ImageProps {
+    /** A local image file (PNG, JPG, GIF, WebP, SVG…); a relative path is resolved against the host's working directory. */
+    src?: string;
+    /**
+     * The image bytes as standard base64, without a `data:` prefix: for images the client downloads
+     * itself (the host does no HTTP). While non-empty it wins over `src`; `null` goes back to `src`.
+     * Re-sending it makes the host read the bytes again.
+     */
+    data?: string;
+    /** How the image fills the node's box. Default `contain`. */
+    fit?: "contain" | "cover" | "fill" | "scale-down" | "none";
+    class?: string;
+}
+export interface SwitchProps {
+    checked?: boolean;
+    label?: string;
+    disabled?: boolean;
+    /** The host only reports clicks; the client confirms them with `checked`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** A choice of a `RadioGroup` or `Select`. */
+export interface Option {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface RadioGroupProps {
+    options?: Option[];
+    /** The selected option's `value`; one that is not an option selects nothing. */
+    value?: string;
+    direction?: "vertical" | "horizontal";
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface SelectProps {
+    options?: Option[];
+    /** The selected option's `value`; one that is not an option shows the placeholder. */
+    value?: string;
+    placeholder?: string;
+    /** A search box at the top of the list. */
+    searchable?: boolean;
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface SliderProps {
+    value?: number;
+    /** Default 0. */
+    min?: number;
+    /** Default 100. */
+    max?: number;
+    /** Above 0; default 1. */
+    step?: number;
+    disabled?: boolean;
+    /** The host only reports drags; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface TextareaProps {
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    class?: string;
+}
+/** A modal dialog; its children are its body (PROTOCOL.md section 14). */
+export interface DialogProps {
+    /** Shown while true; the host sets it to false when the user answers. */
+    open?: boolean;
+    title?: string;
+    /** Default "OK". */
+    okText?: string;
+    /** Adds a cancel button. A `DialogFooter` child replaces both buttons. */
+    cancelText?: string;
+    /** In pixels. */
+    width?: number;
+    /** Classes of the body that holds the children. */
+    class?: string;
+}
+/** A list that builds only the rows in view; each child is one row (PROTOCOL.md section 15). */
+export interface VirtualListProps {
+    /** Every row's height in pixels; default 32. */
+    rowHeight?: number;
+    /** Give the list a height (`flex-1`, `h-64`...): it fills its container. */
+    class?: string;
+}
+/** A `Table` column; `key` names the cell in each row. */
+export interface TableColumn {
+    key: string;
+    name: string;
+    /** In pixels; default 100. */
+    width?: number;
+    align?: "left" | "center" | "right";
+    /** Shows a sort button; the app sorts `rows` on `sort`. */
+    sortable?: boolean;
+}
+export type TableCell = string | number | boolean | null;
+export interface TableProps {
+    columns?: TableColumn[];
+    /** One object per row, with a cell per column `key`. */
+    rows?: Record<string, TableCell>[];
+    /** Index of the selected row in `rows`. */
+    selected?: number;
+    stripe?: boolean;
+    /** Default true. */
+    bordered?: boolean;
+    /** The host only reports selections; the client confirms them with `selected`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** A `sort` event: the column clicked and the direction to sort `rows` in. */
+export interface TableSort {
+    column: string;
+    direction: "asc" | "desc" | "none";
+}
+/** A tab bar; the app shows the chosen tab's content itself. */
+export interface TabsProps {
+    tabs?: Option[];
+    /** The selected tab's `value`. */
+    value?: string;
+    /** Default "tab". */
+    variant?: "tab" | "outline" | "pill" | "segmented" | "underline";
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+/**
+ * One tab of a `Tabs`: append children to build its chip (an `Icon`, a `text`, a `Tag`…; a
+ * last `Button`, `Checkbox` or `Switch` is drawn after them, at its own size).
+ * A `Tabs` with `Tab` children uses them and ignores its `tabs`, and the `Tab` reports nothing:
+ * its `Tabs` sends the `change`.
+ */
+export interface TabProps {
+    /** What `change` reports for this tab. Required: the host rejects a `Tab` without it. */
+    value?: string;
+    /** The tab's text, drawn before its children. A chip of nodes names itself with `a11y.label`. */
+    label?: string;
+    disabled?: boolean;
+    /** Styles the chip itself: `flex-1` makes the tabs share the bar's width. */
+    class?: string;
+}
+export interface MenuBarProps {
+    menus?: Menu[];
+    class?: string;
+}
+export interface AlertProps {
+    /** The text of the message. */
+    message?: string;
+    title?: string;
+    /** Default "default". */
+    variant?: "default" | "info" | "success" | "warning" | "error";
+    /** A full-width band instead of a rounded box. */
+    banner?: boolean;
+    /** Shows a close button; a click sends `close`. */
+    closable?: boolean;
+    class?: string;
+}
+export interface BadgeProps {
+    /** Default 0; a count of 0 hides the badge. */
+    count?: number;
+    /** Default 99: a bigger count shows `max+`. */
+    max?: number;
+    /** A dot instead of a count. */
+    dot?: boolean;
+    /** A bundled icon instead of a count. */
+    icon?: string;
+    class?: string;
+}
+export interface TagProps {
+    label?: string;
+    /** Default "secondary". */
+    variant?: "primary" | "secondary" | "danger" | "success" | "warning" | "info";
+    outline?: boolean;
+    icon?: string;
+    class?: string;
+}
+export interface KbdProps {
+    /** A key such as `ctrl-s`. */
+    keys?: string;
+    outline?: boolean;
+    class?: string;
+}
+export interface ProgressProps {
+    /** From 0 to 100. */
+    value?: number;
+    loading?: boolean;
+    class?: string;
+}
+export type SpinnerProps = {
+    class?: string;
+};
+export interface SkeletonProps {
+    secondary?: boolean;
+    class?: string;
+}
+export interface RatingProps {
+    /** Default 0. */
+    value?: number;
+    /** Default 5. */
+    max?: number;
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface PaginationProps {
+    /** 1-based; default 1. */
+    page?: number;
+    /** Default 1. */
+    total?: number;
+    compact?: boolean;
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `page`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** An `items` entry of an `Accordion`; its content is text. */
+export interface AccordionItem {
+    id: string;
+    title: string;
+    content?: string;
+    open?: boolean;
+    disabled?: boolean;
+}
+export interface AccordionProps {
+    /** Ignored when the Accordion has `AccordionItem` children. */
+    items?: AccordionItem[];
+    /** Several sections open at once; default false. */
+    multiple?: boolean;
+    /** Default true. */
+    bordered?: boolean;
+    disabled?: boolean;
+    /** The host only reports toggles; the client confirms them with `items`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface CollapsibleProps {
+    open?: boolean;
+    class?: string;
+}
+export interface AvatarProps {
+    /** Shown as its initial when there is no `src`. */
+    name?: string;
+    /** An image file. */
+    src?: string;
+    class?: string;
+}
+export interface StepperProps {
+    /** The steps, as `{value, label}`; `disabled` skips one. */
+    items?: Option[];
+    /** The current step's `value`. */
+    value?: string;
+    vertical?: boolean;
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface NumberInputProps {
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** The host only reports edits; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface OtpInputProps {
+    /** The number of cells; default 6. */
+    length?: number;
+    value?: string;
+    masked?: boolean;
+    disabled?: boolean;
+    /** The host only reports edits; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface FormProps {
+    /** Default "vertical". */
+    direction?: "vertical" | "horizontal";
+    class?: string;
+}
+export interface FieldProps {
+    label?: string;
+    description?: string;
+    required?: boolean;
+    class?: string;
+}
+export interface GroupBoxProps {
+    title?: string;
+    /** Default "normal". */
+    variant?: "normal" | "fill" | "outline";
+    class?: string;
+}
+/** One row of a `DescriptionList`. */
+export interface DescriptionItem {
+    label: string;
+    value: string;
+    /** How many columns the row spans; default 1. */
+    span?: number;
+}
+export interface DescriptionListProps {
+    items?: DescriptionItem[];
+    /** Default 1. */
+    columns?: number;
+    bordered?: boolean;
+    /** Label and value side by side; default stacked. */
+    horizontal?: boolean;
+    class?: string;
+}
+export interface StatusBarProps {
+    /** Replaced by a `StatusBarLeft` child. */
+    left?: string;
+    /** Replaced by a `StatusBarRight` child. */
+    right?: string;
+    class?: string;
+}
+export type ToolbarProps = {
+    class?: string;
+};
+/** Panels side by side (default) or stacked; one child per panel. */
+export interface ResizableProps {
+    axis?: "horizontal" | "vertical";
+    /** The initial size in pixels of each panel, in order; the others share what is left. */
+    sizes?: number[];
+    class?: string;
+}
+export interface CalendarProps {
+    /** The chosen day, `YYYY-MM-DD`. */
+    value?: string;
+    /** How many months to show, 1 to 3; default 1. */
+    months?: number;
+    /** Default "sunday". */
+    weekStartsOn?: "sunday" | "monday";
+    disabled?: boolean;
+    /** The host only reports choices; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** One item of a `Tree`; `children` nests them. */
+export interface TreeNode {
+    /** Unique within the whole `items` list. */
+    id: string;
+    label: string;
+    children?: TreeNode[];
+    /** Open when the tree first shows it; the user can expand or collapse it. */
+    expanded?: boolean;
+    disabled?: boolean;
+}
+export interface TreeProps {
+    items?: TreeNode[];
+    /** The selected item's `id`; one that is not in `items` selects nothing. */
+    value?: string;
+    /** The host only reports clicks; the client confirms them with `value`. */
+    controlled?: boolean;
+    /** Give the tree a bounded height (`h-64`, `flex-1`): it scrolls itself. */
+    class?: string;
+}
+/** The selected source lines of a `Diff`, reported with `change`. */
+export interface DiffSelection {
+    path: string;
+    side: "original" | "modified";
+    start: number;
+    end: number;
+    endSide: "original" | "modified";
+}
+export interface DiffProps {
+    /** A unified or Git diff; a malformed patch is `invalid_props`. */
+    patch?: string;
+    /** Default "unified". */
+    mode?: "unified" | "split";
+    /** Default true. */
+    lineNumbers?: boolean;
+    /** Default false: long lines scroll horizontally. */
+    softWrap?: boolean;
+    /** Shows a header above each file; default true. */
+    header?: boolean;
+    /** Give it a bounded height (`h-96`, `flex-1`): it scrolls itself. */
+    class?: string;
+}
+/** A carousel; each child is one slide. */
+export interface CarouselProps {
+    /** The selected slide index; one past the last slide selects the last one. */
+    value?: number;
+    /** Default "horizontal". */
+    axis?: "horizontal" | "vertical";
+    /** Wrap from the last slide to the first; default false. */
+    looping?: boolean;
+    /** Previous and next buttons; default true. */
+    controls?: boolean;
+    /** One dot per slide; default false. */
+    pagination?: boolean;
+    /** The host only reports slides; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** One entry of a `Sidebar`; `children` is its submenu. */
+export interface SidebarEntry {
+    /** Unique across the whole sidebar: it is the `value` and what `change` reports. */
+    id: string;
+    label: string;
+    /** A bundled icon name; collapsed, it is all the entry shows. */
+    icon?: string;
+    disabled?: boolean;
+    /** The submenu starts open; default false. */
+    open?: boolean;
+    children?: SidebarEntry[];
+}
+/** A group of entries with a heading (`label`); without one the entries have no heading. */
+export interface SidebarSection {
+    label?: string;
+    items: SidebarEntry[];
+}
+export interface SidebarProps {
+    /** The sections: the sidebar takes no children. */
+    items?: SidebarSection[];
+    /** The active entry's `id`; one that is not in `items` leaves none active. */
+    value?: string;
+    /** Icon width (48px) instead of the full width. */
+    collapsed?: boolean;
+    /** What collapsing does: `icon` (default), `offcanvas` or `none`. */
+    collapsible?: "icon" | "offcanvas" | "none";
+    /** Default `left`. */
+    side?: "left" | "right";
+    /** The host only reports clicks; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+/** A theme color of a chart series (PROTOCOL.md section 19). */
+export type ChartColor = "chart-1" | "chart-2" | "chart-3" | "chart-4" | "chart-5" | "primary" | "secondary" | "muted" | "accent" | "danger" | "success" | "warning" | "info";
+/** One point of a `Chart`: the category of a line or a bar, or the name of a slice. */
+export interface ChartDatum {
+    label: string;
+    value: number;
+}
+export interface ChartProps {
+    /** The plot: `line` (default), `bar` or `pie`. */
+    chart?: "line" | "bar" | "pie";
+    /** The points, in order. */
+    data?: ChartDatum[];
+    /** A line's or the bars' color; default `chart-1`. A pie cycles `chart-1` to `chart-5`. */
+    color?: ChartColor;
+    /** The series name the hover tooltip shows. */
+    name?: string;
+    /** A line's curve between points; default `linear`. */
+    curve?: "linear" | "natural" | "step";
+    /** A line: a dot on each point; default false. */
+    dot?: boolean;
+    /** Bars grow from the left instead of the bottom; default false. */
+    horizontal?: boolean;
+    /** The category axis (of a line or the bars); default true. */
+    xAxis?: boolean;
+    /** How many category labels, spread evenly; default 12, 0 none. */
+    xTicks?: number;
+    /** The value axis; default false. */
+    yAxis?: boolean;
+    /** Ticks on the value axis, both ends included; default 5, below 2 counts as 2. */
+    yTicks?: number;
+    /** The grid lines; default true. */
+    grid?: boolean;
+    /** A line: pin the value axis; both are needed, in order. */
+    yMin?: number;
+    yMax?: number;
+    /** A pie: the hole in the middle, in pixels; default 0. */
+    innerRadius?: number;
+    /** A pie: the gap between slices, in radians (0.03 is a thin gap); default 0. */
+    padAngle?: number;
+    /** The hover crosshair, the dots and the tooltip; default true. */
+    interactive?: boolean;
+    /** Give it a bounded box (`h-64`, `flex-1 w-full`): the plot fills it. */
+    class?: string;
+}
+/** One drawing command of a `Canvas` (PROTOCOL.md section 20), in logical pixels from its top-left corner. */
+export type CanvasCommand = {
+    op: "rect";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    color?: ChartColor;
+    corner_radius?: number;
+} | {
+    op: "line";
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    color?: ChartColor;
+    width?: number;
+}
+/** `d` takes absolute `M x y`, `L x y` and `Z` only. */
+ | {
+    op: "path";
+    d: string;
+    color?: ChartColor;
+    width?: number;
+};
+/** A point local to a `Canvas`, in the same coordinates as its commands. */
+export interface CanvasPoint {
+    x: number;
+    y: number;
+}
+export interface CanvasProps {
+    /** Painted in order; `setProps` replaces the whole list. */
+    commands?: CanvasCommand[];
+    /** Give it a bounded box (`h-64 w-full`). */
+    class?: string;
+}
+/** One entry of a `Command` palette. */
+export interface CommandEntry {
+    /** Unique across the whole palette: it is what `confirm` reports. */
+    id: string;
+    label: string;
+    /** A bundled icon name. */
+    icon?: string;
+    /** Extra terms the search matches, besides `label`. */
+    keywords?: string[];
+    /** Draws a check at the end of the row. */
+    checked?: boolean;
+    disabled?: boolean;
+}
+/** A group of entries with a heading (`label`); without one the entries have no heading. */
+export interface CommandSection {
+    label?: string;
+    items: CommandEntry[];
+}
+export interface CommandProps {
+    /** The sections: the palette takes no children and filters them by the query itself. */
+    items?: CommandSection[];
+    /** The search field's placeholder. */
+    placeholder?: string;
+    class?: string;
+}
+/** One field of a `Settings` page; `value` fits `type` (a dropdown's is one of its `options`). */
+export type SettingsItem = {
+    /** Unique across all pages: it is what `change` reports. */
+    key: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+} & ({
+    type: "switch" | "checkbox";
+    value: boolean;
+} | {
+    type: "input";
+    value: string;
+} | {
+    type: "dropdown";
+    value: string;
+    options: {
+        value: string;
+        label: string;
+    }[];
+} | {
+    type: "number";
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+});
+/** A group of fields, with an optional heading. */
+export interface SettingsGroup {
+    title?: string;
+    items: SettingsItem[];
+}
+/** A sidebar entry and the groups shown when it is selected. */
+export interface SettingsPage {
+    title: string;
+    /** A bundled icon name. */
+    icon?: string;
+    groups: SettingsGroup[];
+}
+/** What `change` reports: the field the user set and its new value. */
+export interface SettingsChange {
+    key: string;
+    value: boolean | string | number;
+}
+export interface SettingsProps {
+    /** The pages: the host keeps each value the user sets (no `controlled` mode). */
+    pages?: SettingsPage[];
+    /** Give it a size (`size-full`, `h-96`): the sidebar and the page split the box. */
+    class?: string;
+}
+export interface ToggleProps {
+    checked?: boolean;
+    label?: string;
+    /** A bundled icon name, drawn before the label. */
+    icon?: string;
+    /** Default "ghost". */
+    variant?: "ghost" | "outline";
+    /** A hint; it is also the name a screen reader reads. */
+    tooltip?: string;
+    disabled?: boolean;
+    /** The host only reports clicks; the client confirms them with `checked`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface DropdownButtonProps {
+    label?: string;
+    /** A bundled icon name, drawn before the label. */
+    icon?: string;
+    /** Default: gpui-component's own look. */
+    variant?: "primary" | "secondary" | "ghost" | "danger";
+    outline?: boolean;
+    disabled?: boolean;
+    /** The menu, in the format of `contextMenu` (`PROTOCOL.md` section 10). */
+    items?: MenuItem[];
+    /** The name a screen reader reads for the caret; default: a translated "More options". */
+    menuLabel?: string;
+    /** A hint on the left half. */
+    tooltip?: string;
+    class?: string;
+}
+export interface LabelProps {
+    content?: string;
+    /** A muted text after the content. */
+    secondary?: string;
+    /** Dots instead of the characters. */
+    masked?: boolean;
+    /** Marks every occurrence of this substring, ignoring case. */
+    highlight?: string;
+    class?: string;
+}
+export interface EmptyProps {
+    /** A bundled icon name, in a muted box above the title. */
+    icon?: string;
+    title?: string;
+    description?: string;
+    /** It fills its box (`flex-1`), so size the parent. */
+    class?: string;
+}
+export interface ShimmerProps {
+    content?: string;
+    /** One sweep, in seconds; default 2. */
+    duration?: number;
+    /** The highlight half-width; default 0.3, kept within 0.05–1. */
+    spread?: number;
+    reverse?: boolean;
+    /** One sweep instead of a loop. */
+    once?: boolean;
+    class?: string;
+}
+export interface InputGroupProps {
+    value?: string;
+    placeholder?: string;
+    /** Text on the left of the field. */
+    prefix?: string;
+    /** Text on the right. */
+    suffix?: string;
+    /** A bundled icon name on the left. */
+    prefixIcon?: string;
+    /** A bundled icon name on the right. */
+    suffixIcon?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    /** The caller's validation result; it does not reject edits. */
+    invalid?: boolean;
+    /** The host only reports edits; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface ClipboardProps {
+    /** The text copied on click. */
+    value?: string;
+    /** A hint; `a11y.label` is the button's name. */
+    tooltip?: string;
+    class?: string;
+}
+/** The eight corners a `Popover` or a `HoverCard` can open from. */
+export type OverlayAnchor = "top-left" | "top-center" | "top-right" | "left-center" | "right-center" | "bottom-left" | "bottom-center" | "bottom-right";
+export interface AlertDialogProps {
+    /** Shown while true; the host sets it to false when the user answers. */
+    open?: boolean;
+    title?: string;
+    description?: string;
+    /** A bundled icon name, before the title. */
+    icon?: string;
+    /** Default "OK". */
+    okText?: string;
+    /** Adds the Cancel button. A `DialogFooter` child replaces both buttons. */
+    cancelText?: string;
+    /** Classes of the body that holds the children. */
+    class?: string;
+}
+export interface SheetProps {
+    /** Shown while true; the host sets it to false when the panel closes. */
+    open?: boolean;
+    /** The edge it slides in from. Default "right". */
+    side?: "left" | "right" | "top" | "bottom";
+    title?: string;
+    /** Pixels: the width on the sides, the height above and below. Default 350. */
+    size?: number;
+    /** Classes of the body that holds the children. */
+    class?: string;
+}
+export interface PopoverProps {
+    /**
+     * The panel's state, kept in the host as a synced `Checkbox`'s `checked`: the user opening or
+     * closing it reports `change` and updates it, and a `setProps` with another `open` wins.
+     */
+    open?: boolean;
+    /** Where the panel goes. Default "top-left" (below the trigger, left-aligned). */
+    anchor?: OverlayAnchor;
+    /** A triangle pointing at the trigger. */
+    arrow?: boolean;
+    /** Classes of the trigger's slot (the first child), not of the panel. */
+    class?: string;
+}
+export interface HoverCardProps {
+    /** Milliseconds before it opens. Default 600. */
+    openDelay?: number;
+    /** Milliseconds before it closes. Default 300. */
+    closeDelay?: number;
+    /** Where the card goes. Default "top-center". */
+    anchor?: OverlayAnchor;
+    /** Classes of the trigger's slot (the first child), not of the card. */
+    class?: string;
+}
+export interface DatePickerProps {
+    /** The chosen day, `YYYY-MM-DD`; with `range: true`, an ISO interval `YYYY-MM-DD/YYYY-MM-DD`. `null` clears it. */
+    value?: string | null;
+    /** A start-to-end range; the form of `value` is fixed by this (the picker rebuilds when it changes). */
+    range?: boolean;
+    /** Shown while the field is empty. */
+    placeholder?: string;
+    disabled?: boolean;
+    /** The host only reports picks; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface TimeFieldProps {
+    /** The time shown, `HH:MM`; with `seconds: true`, `HH:MM:SS`. It has no empty state: without `value` the field shows `00:00`. */
+    value?: string;
+    /** Include seconds; the form of `value` is fixed by this (the field rebuilds when it changes). */
+    seconds?: boolean;
+    disabled?: boolean;
+    /** The host only reports edits; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface ColorPickerProps {
+    /** `#RRGGBB` or `#RRGGBBAA`; the `#` is required. `null` clears it. It has no `disabled`: gpui-component cannot disable its color pickers. */
+    value?: string | null;
+    /** Colors shown first, in the same form. */
+    palette?: string[];
+    /** The host only reports picks; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface ComboboxProps {
+    /** The choices, as in a `Select`. */
+    options?: Option[];
+    /** The chosen options' values; always a list. */
+    value?: string[];
+    /** Shown while nothing is chosen. */
+    placeholder?: string;
+    /** A search box at the top of the list. */
+    searchable?: boolean;
+    disabled?: boolean;
+    /** The host only reports toggles; the client confirms them with `value`. */
+    controlled?: boolean;
+    class?: string;
+}
+export interface BubbleProps {
+    /** The surface; default `filled`. `ghost` has no surface or padding and takes the whole width. */
+    variant?: "filled" | "secondary" | "muted" | "tinted" | "outline" | "ghost" | "destructive";
+    /** Unset, it follows the `Message` that holds it. */
+    alignment?: "start" | "end";
+    class?: string;
+}
+export interface MessageProps {
+    /** Default `start`; `end` moves the avatar to that side too. */
+    alignment?: "start" | "end";
+    /** An `Avatar`'s `name` and `src`; without either there is no avatar. */
+    avatarName?: string;
+    avatarSrc?: string;
+    class?: string;
+}
+/** A `MessageHeader`/`MessageFooter` lays out its children in a row; outside a `Message` it draws nothing. */
+export interface MessagePartProps {
+    class?: string;
+}
+export interface MarkerProps {
+    content?: string;
+    /** A bundled icon before the text; it replaces the loading spinner. */
+    icon?: string;
+    /** Default `plain`. */
+    variant?: "plain" | "separator" | "border";
+    alignment?: "start" | "center" | "end";
+    loading?: boolean;
+    /** Default `spinner`; `shimmer` moves a highlight over `content`. */
+    loadingStyle?: "spinner" | "shimmer";
+    class?: string;
+}
+export interface AttachmentProps {
+    /** Default `complete`. */
+    status?: "pending" | "uploading" | "processing" | "failed" | "complete";
+    /** 0–100, shown only while `uploading`. */
+    progress?: number;
+    title?: string;
+    description?: string;
+    /** Shown while the card is hovered. */
+    tooltip?: string;
+    /** The picture, as in an `Image`; `data` (standard base64) wins over `src`. */
+    src?: string;
+    data?: string;
+    /** Default `horizontal`; `vertical` puts the picture on top. */
+    axis?: "horizontal" | "vertical";
+    class?: string;
+}
+export interface MessageScrollerProps {
+    /** Default true. */
+    scrollbar?: boolean;
+    /** The round button that goes back to the end; default true. */
+    jumpButton?: boolean;
+    /** That button's tooltip and name; the crate's default is "Jump to latest". */
+    jumpLabel?: string;
+    class?: string;
+}
+export interface QuestionnaireChoice {
+    /** Unique within its question. */
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    /** An answer from the start; at most one without `multiple`. */
+    selected?: boolean;
+}
+export interface QuestionnaireItem {
+    /** Unique; it names the answer. */
+    name: string;
+    label: string;
+    description?: string;
+    /** It cannot be skipped. */
+    required?: boolean;
+    /** Checkboxes instead of radio buttons. */
+    multiple?: boolean;
+    disabled?: boolean;
+    /** A free-text field. */
+    input?: boolean;
+    choices?: QuestionnaireChoice[];
+}
+/** One answer, as `change` and `submit` report it. */
+export interface QuestionnaireAnswer {
+    name: string;
+    /** `unanswered` when it was cleared. */
+    status: "answered" | "skipped" | "unanswered";
+    choices: string[];
+    text: string | null;
+}
+export interface QuestionnaireProps {
+    /** Setting different `items` starts over; the same ones again keep the answers. */
+    items?: QuestionnaireItem[];
+    class?: string;
+}
+export interface ListProps {
+    /** The selected row's `value`; one that is not among the rows selects nothing. */
+    value?: string;
+    /** The host only reports selections; the client confirms them with `value`. */
+    controlled?: boolean;
+    /** A search field above the rows: each edit sends `query`, and the client sends the matching rows. */
+    searchable?: boolean;
+    placeholder?: string;
+    /** Near the end, the list sends `loadMore` (once per row count). */
+    hasMore?: boolean;
+    /** How many rows before the end `loadMore` is sent; default 20. */
+    loadMoreThreshold?: number;
+    /** Shows a skeleton instead of the rows. */
+    loading?: boolean;
+    class?: string;
+}
+/** A screen reader reads a row by its `a11y.label` (PROTOCOL.md section 27). */
+export interface ListItemProps {
+    /** What the List's events report. Required: the host rejects a `ListItem` without it. */
+    value?: string;
+    /** Neither selected nor confirmed; the arrow keys pass over it. */
+    disabled?: boolean;
+}
+export interface DockProps {
+    class?: string;
+}
+export interface DockPanelProps {
+    /** The tab's text. */
+    title?: string;
+    /** Where the panel starts; read only when it is added (the layout is the user's after that). */
+    placement?: "center" | "left" | "right" | "bottom";
+    /** The tab offers to close it: `close` is sent, and the app removes the node. */
+    closable?: boolean;
+}
+/** A section of an `Accordion`; its children are the content. */
+export interface AccordionItemProps {
+    /** What the Accordion's `change` reports. Required: the host rejects an `AccordionItem` without it. */
+    id?: string;
+    title?: string;
+    /** The host keeps it in synced mode. */
+    open?: boolean;
+    disabled?: boolean;
+    class?: string;
+}
+/** A `Dialog`'s or `AlertDialog`'s footer instead of OK/Cancel; outside one it draws nothing. */
+export interface SlotProps {
+    class?: string;
+}
+export interface NodeProps {
+    div: DivProps & SharedProps;
+    text: TextProps & SharedProps;
+    Button: ButtonProps & SharedProps;
+    Input: InputProps & SharedProps;
+    Checkbox: CheckboxProps & SharedProps;
+    Icon: IconProps & SharedProps;
+    Image: ImageProps & SharedProps;
+    MenuBar: MenuBarProps & SharedProps;
+    Switch: SwitchProps & SharedProps;
+    RadioGroup: RadioGroupProps & SharedProps;
+    Select: SelectProps & SharedProps;
+    Slider: SliderProps & SharedProps;
+    Textarea: TextareaProps & SharedProps;
+    Dialog: DialogProps & SharedProps;
+    VirtualList: VirtualListProps & SharedProps;
+    Table: TableProps & SharedProps;
+    Tabs: TabsProps & SharedProps;
+    Tab: TabProps & SharedProps;
+    Alert: AlertProps & SharedProps;
+    Badge: BadgeProps & SharedProps;
+    Tag: TagProps & SharedProps;
+    Kbd: KbdProps & SharedProps;
+    Progress: ProgressProps & SharedProps;
+    Spinner: SpinnerProps & SharedProps;
+    Skeleton: SkeletonProps & SharedProps;
+    Rating: RatingProps & SharedProps;
+    Pagination: PaginationProps & SharedProps;
+    Collapsible: CollapsibleProps & SharedProps;
+    Accordion: AccordionProps & SharedProps;
+    Avatar: AvatarProps & SharedProps;
+    Stepper: StepperProps & SharedProps;
+    NumberInput: NumberInputProps & SharedProps;
+    OtpInput: OtpInputProps & SharedProps;
+    Form: FormProps & SharedProps;
+    Field: FieldProps & SharedProps;
+    GroupBox: GroupBoxProps & SharedProps;
+    DescriptionList: DescriptionListProps & SharedProps;
+    StatusBar: StatusBarProps & SharedProps;
+    Toolbar: ToolbarProps & SharedProps;
+    Resizable: ResizableProps & SharedProps;
+    Calendar: CalendarProps & SharedProps;
+    Tree: TreeProps & SharedProps;
+    Diff: DiffProps & SharedProps;
+    Carousel: CarouselProps & SharedProps;
+    Sidebar: SidebarProps & SharedProps;
+    Chart: ChartProps & SharedProps;
+    Canvas: CanvasProps & SharedProps;
+    Command: CommandProps & SharedProps;
+    Settings: SettingsProps & SharedProps;
+    Toggle: ToggleProps & SharedProps;
+    DropdownButton: DropdownButtonProps & SharedProps;
+    Label: LabelProps & SharedProps;
+    Empty: EmptyProps & SharedProps;
+    Shimmer: ShimmerProps & SharedProps;
+    InputGroup: InputGroupProps & SharedProps;
+    Clipboard: ClipboardProps & SharedProps;
+    AlertDialog: AlertDialogProps & SharedProps;
+    Sheet: SheetProps & SharedProps;
+    Popover: PopoverProps & SharedProps;
+    HoverCard: HoverCardProps & SharedProps;
+    DatePicker: DatePickerProps & SharedProps;
+    TimeField: TimeFieldProps & SharedProps;
+    ColorPicker: ColorPickerProps & SharedProps;
+    Combobox: ComboboxProps & SharedProps;
+    Bubble: BubbleProps & SharedProps;
+    Message: MessageProps & SharedProps;
+    MessageHeader: MessagePartProps & SharedProps;
+    MessageFooter: MessagePartProps & SharedProps;
+    Marker: MarkerProps & SharedProps;
+    Attachment: AttachmentProps & SharedProps;
+    MessageScroller: MessageScrollerProps & SharedProps;
+    Questionnaire: QuestionnaireProps & SharedProps;
+    List: ListProps & SharedProps;
+    ListItem: ListItemProps & SharedProps;
+    Dock: DockProps & SharedProps;
+    DockPanel: DockPanelProps & SharedProps;
+    AccordionItem: AccordionItemProps & SharedProps;
+    DialogFooter: SlotProps & SharedProps;
+    StatusBarLeft: SlotProps & SharedProps;
+    StatusBarRight: SlotProps & SharedProps;
+}
+export interface NodeEvents {
+    div: {
+        click: {};
+        doubleClick: {};
+        menu: {
+            item: string;
+        };
+        keyDown: {
+            key: string;
+        };
+        drop: {
+            paths: string[];
+        };
+    };
+    text: {};
+    Button: {
+        click: {};
+    };
+    Input: {
+        change: {
+            value: string;
+        };
+        submit: {
+            value: string;
+        };
+        keyDown: {
+            key: string;
+        };
+    };
+    Checkbox: {
+        change: {
+            checked: boolean;
+        };
+    };
+    Icon: {};
+    Image: {};
+    MenuBar: {
+        menu: {
+            item: string;
+        };
+    };
+    Switch: {
+        change: {
+            checked: boolean;
+        };
+    };
+    RadioGroup: {
+        change: {
+            value: string;
+        };
+    };
+    Select: {
+        change: {
+            value: string;
+        };
+    };
+    Slider: {
+        change: {
+            value: number;
+        };
+    };
+    Textarea: {
+        change: {
+            value: string;
+        };
+    };
+    Dialog: {
+        ok: {};
+        cancel: {};
+    };
+    VirtualList: {};
+    /** `value` is a row index; `null` when Escape clears the selection. */
+    Table: {
+        change: {
+            value: number | null;
+        };
+        doubleClick: {
+            value: number;
+        };
+        sort: TableSort;
+    };
+    Tabs: {
+        change: {
+            value: string;
+        };
+    };
+    /** A `Tab` reports nothing: its `Tabs` sends the `change`. */
+    Tab: {};
+    Alert: {
+        close: {};
+    };
+    Badge: {};
+    Tag: {};
+    Kbd: {};
+    Progress: {};
+    Spinner: {};
+    Skeleton: {};
+    Rating: {
+        change: {
+            value: number;
+        };
+    };
+    Pagination: {
+        change: {
+            value: number;
+        };
+    };
+    Collapsible: {};
+    /** `value` is the `id` of the section opened or closed. */
+    Accordion: {
+        change: {
+            value: string;
+        };
+    };
+    Avatar: {};
+    /** `value` is the chosen step's `value`. */
+    Stepper: {
+        change: {
+            value: string;
+        };
+    };
+    NumberInput: {
+        change: {
+            value: string;
+        };
+        submit: {
+            value: string;
+        };
+        keyDown: {
+            key: string;
+        };
+    };
+    OtpInput: {
+        change: {
+            value: string;
+        };
+    };
+    Form: {};
+    Field: {};
+    GroupBox: {};
+    DescriptionList: {};
+    StatusBar: {};
+    Toolbar: {};
+    Resizable: {};
+    /** `value` is the chosen day, `YYYY-MM-DD`. */
+    Calendar: {
+        change: {
+            value: string;
+        };
+    };
+    /** `value` is the selected item's `id`; `expand`/`collapse` report a folder's `id`. */
+    Tree: {
+        change: {
+            value: string;
+        };
+        expand: {
+            value: string;
+        };
+        collapse: {
+            value: string;
+        };
+    };
+    /** `value` is the selected range, `null` when the selection is cleared. */
+    Diff: {
+        change: {
+            value: DiffSelection | null;
+        };
+    };
+    /** `value` is the selected slide index. */
+    Carousel: {
+        change: {
+            value: number;
+        };
+    };
+    /** `value` is the `id` of the entry clicked. */
+    Sidebar: {
+        change: {
+            value: string;
+        };
+    };
+    /** A chart has no events: the hover tooltip is the component's own. */
+    Chart: {};
+    /** `value` is the point pressed, local to the canvas. */
+    Canvas: {
+        pointerDown: {
+            value: CanvasPoint;
+        };
+    };
+    /** `value` is the `id` of the entry confirmed (Enter or a click). */
+    Command: {
+        confirm: {
+            value: string;
+        };
+    };
+    /** `value` is the field set by the user and its new value. */
+    Settings: {
+        change: {
+            value: SettingsChange;
+        };
+    };
+    Toggle: {
+        change: {
+            checked: boolean;
+        };
+    };
+    /** `value` is the chosen item's `id`. */
+    DropdownButton: {
+        click: {};
+        menu: {
+            item: string;
+        };
+    };
+    Label: {};
+    Empty: {};
+    Shimmer: {};
+    InputGroup: {
+        change: {
+            value: string;
+        };
+        submit: {
+            value: string;
+        };
+    };
+    /** `value` is the text that was copied. */
+    Clipboard: {
+        copied: {
+            value: string;
+        };
+    };
+    /** OK and Cancel close it, as in a `Dialog`; it shows over an open one. */
+    AlertDialog: {
+        ok: {};
+        cancel: {};
+    };
+    /** The user closed the panel with its X, Escape or a click on the overlay. */
+    Sheet: {
+        close: {};
+    };
+    /** `checked` is true when it opened, false when it closed. */
+    Popover: {
+        change: {
+            checked: boolean;
+        };
+    };
+    /** The mouse is the only way in: no `open` and no `simulate`. */
+    HoverCard: {
+        change: {
+            checked: boolean;
+        };
+    };
+    /** `value` is the chosen day, `null` when cleared. */
+    DatePicker: {
+        change: {
+            value: string | null;
+        };
+    };
+    /** `value` is the time, `HH:MM[:SS]`; it has no empty state. */
+    TimeField: {
+        change: {
+            value: string;
+        };
+    };
+    /** `value` is the color, `null` when cleared. */
+    ColorPicker: {
+        change: {
+            value: string | null;
+        };
+    };
+    /** `value` is the whole selection: toggling one sends the full list. */
+    Combobox: {
+        change: {
+            value: string[];
+        };
+    };
+    Bubble: {};
+    Message: {};
+    MessageHeader: {};
+    MessageFooter: {};
+    Marker: {};
+    /** The card's controls exist only while their event is subscribed; `retry` only while `failed`. */
+    Attachment: {
+        click: {};
+        remove: {};
+        retry: {};
+    };
+    MessageScroller: {};
+    /** `change` sends one answer; `submit` all of them, in question order. */
+    Questionnaire: {
+        change: {
+            value: QuestionnaireAnswer;
+        };
+        submit: {
+            value: QuestionnaireAnswer[];
+        };
+    };
+    /** `change` sends the selected row's `value` (`null`: Escape); `query` the search text; `loadMore` nothing. */
+    List: {
+        change: {
+            value: string | null;
+        };
+        confirm: {
+            value: string;
+        };
+        query: {
+            value: string;
+        };
+        loadMore: {};
+    };
+    ListItem: {};
+    Dock: {};
+    /** `close`: the user closed the panel; it has left the layout. */
+    DockPanel: {
+        close: {};
+    };
+    AccordionItem: {};
+    DialogFooter: {};
+    StatusBarLeft: {};
+    StatusBarRight: {};
+}