use crate::catalog::{ArgKind, ArgSpec, Children, ClientJs, CompSpec, PropKind, PropSpec};
#[rustfmt::skip]
pub static CATALOG: &[CompSpec] = &[
CompSpec {
name: "accordion",
component: "accordion",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "type", kind: PropKind::Enum(&["single", "multiple"]), default: Some("single"), summary: "Whether one or multiple sections can be open at once ('single' | 'multiple')" },
],
children: Children::Nodes,
client_js: ClientJs::Enhancement,
css: &["accordion"],
summary: "Vertically stacked, collapsible content sections",
},
CompSpec {
name: "alert",
component: "alert",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["default", "info", "success", "warning", "destructive"]), default: Some("default"), summary: "Severity tone: default (neutral), info, success, warning or destructive" },
PropSpec { name: "icon", kind: PropKind::Str, default: None, summary: "Icon element rendered in the component" },
PropSpec { name: "dismissible", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows a control to dismiss the component" },
],
children: Children::Text,
client_js: ClientJs::Enhancement,
css: &["alert"],
summary: "Highlights a short, important message inline",
},
CompSpec {
name: "area",
component: "area-chart",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Nums, required: true },
],
props: &[
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Title text for the component" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "stacked", kind: PropKind::Bool, default: None, summary: "Stack series areas" },
PropSpec { name: "curve", kind: PropKind::Enum(&["linear", "monotone", "step", "stepBefore", "stepAfter", "natural", "basis", "cardinal", "catmullRom"]), default: Some("monotone"), summary: "Line/area interpolation curve" },
PropSpec { name: "fill", kind: PropKind::Enum(&["solid", "gradient", "pattern"]), default: Some("gradient for one non-stacked series, solid otherwise"), summary: "Area fill style — solid, a top→bottom gradient, or a pattern" },
PropSpec { name: "patternKind", kind: PropKind::Enum(&["dots", "lines", "cross"]), default: None, summary: "Pattern motif when fill=\"pattern\"" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("300"), summary: "SVG height in px" },
PropSpec { name: "xTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the x-axis" },
PropSpec { name: "yTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the y-axis" },
PropSpec { name: "legend", kind: PropKind::Bool, default: None, summary: "Whether to show the legend" },
PropSpec { name: "tooltip", kind: PropKind::Bool, default: None, summary: "Enable hover/keyboard tooltip" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no axes, grid lines, or legend" },
PropSpec { name: "labels", kind: PropKind::Bool, default: None, summary: "Print each value as a label on the mark (collision-aware, decorative/aria-hidde…" },
PropSpec { name: "brush", kind: PropKind::Bool, default: Some("false"), summary: "Show a keyboard-operable Brush below the plot to subset the series to a window" },
PropSpec { name: "dataZoom", kind: PropKind::Bool, default: Some("false"), summary: "Show a DataZoom slider below the plot — a Brush whose body also pans the window" },
PropSpec { name: "zoom", kind: PropKind::Bool, default: Some("false"), summary: "Enable in-plot wheel/drag/keyboard zoom-pan (+/-/0) over the series index windo…" },
PropSpec { name: "syncId", kind: PropKind::Str, default: None, summary: "Connect this chart to others sharing the same id — they mirror the zoom window…" },
PropSpec { name: "tooltipMode", kind: PropKind::Enum(&["item", "axis"]), default: Some("item"), summary: "Tooltip trigger — item (nearest point) or axis (a crosshair + a shared tooltip…" },
PropSpec { name: "decimate", kind: PropKind::Bool, default: None, summary: "Downsample dense non-stacked series before drawing (LTTB or min-max)" },
PropSpec { name: "toolbox", kind: PropKind::Bool, default: None, summary: "Render a keyboard-reachable toolbox — PNG/SVG export, a data-view table toggle,…" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["chart-legend"],
summary: "Area chart with optional stacking, multi-series support, and hover tooltip",
},
CompSpec {
name: "auto-grid",
component: "auto-grid",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "min", kind: PropKind::Str, default: Some("16rem"), summary: "Minimum track width before items wrap to fewer columns" },
PropSpec { name: "gap", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("4"), summary: "Spacing token step" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["auto-grid"],
summary: "Media-query-free responsive grid — columns auto-fill based on available space",
},
CompSpec {
name: "avatar",
component: "avatar",
aliases: &[],
args: &[
ArgSpec { name: "name", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "src", kind: PropKind::Str, default: None, summary: "Image source URL" },
PropSpec { name: "alt", kind: PropKind::Str, default: Some(""), summary: "Alternative text describing the image" },
PropSpec { name: "fallback", kind: PropKind::Str, default: None, summary: "Explicit fallback text (initials/glyph); overrides initials derived from name" },
PropSpec { name: "size", kind: PropKind::Enum(&["xs", "sm", "md", "lg", "xl"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "status", kind: PropKind::Enum(&["online", "offline", "busy"]), default: None, summary: "Status state" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["avatar"],
summary: "Displays a user image with initials fallback",
},
CompSpec {
name: "avatar-group",
component: "avatar-group",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "max", kind: PropKind::Num, default: None, summary: "Cap the number of visible avatars" },
PropSpec { name: "total", kind: PropKind::Num, default: None, summary: "Override the total count used for the +N chip" },
PropSpec { name: "spacing", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Spacing between items" },
PropSpec { name: "isGrid", kind: PropKind::Bool, default: Some("false"), summary: "When true, lays the avatars out in a grid instead of an overlapping stack" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["avatar-group", "avatar"],
summary: "Overlapping stack of avatars with a max cap and an i18n-labelled +N overflow ch…",
},
CompSpec {
name: "badge",
component: "badge",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["default", "secondary", "success", "warning", "destructive", "outline"]), default: Some("default"), summary: "Severity tone" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["badge"],
summary: "Small status label or category indicator",
},
CompSpec {
name: "bar",
component: "bar-chart",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Pairs, required: true },
],
props: &[
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Title text for the component" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "orientation", kind: PropKind::Enum(&["vertical", "horizontal"]), default: Some("vertical"), summary: "Direction the bars grow. vertical puts the categories on the x-axis and grows b…" },
PropSpec { name: "mode", kind: PropKind::Enum(&["grouped", "stacked", "percent"]), default: Some("grouped"), summary: "'percent' stacks each category and normalizes it to 100%" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("300"), summary: "SVG height in px" },
PropSpec { name: "valueAxisTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the VALUE axis, on both orientations" },
PropSpec { name: "categoryAxisTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the CATEGORY axis, on both orientations" },
PropSpec { name: "categoryLabelEvery", kind: PropKind::Num, default: None, summary: "Show every Nth category label (always the last) to thin a crowded axis" },
PropSpec { name: "xLabelEvery", kind: PropKind::Num, default: None, summary: "Show every Nth category label (always the last) to thin a crowded axis" },
PropSpec { name: "legend", kind: PropKind::Bool, default: None, summary: "Whether to show the legend" },
PropSpec { name: "tooltip", kind: PropKind::Bool, default: None, summary: "Whether to show tooltips on hover" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no axes, grid lines, or legend" },
PropSpec { name: "labels", kind: PropKind::Bool, default: None, summary: "Print each value as a label on the mark (collision-aware, decorative/aria-hidde…" },
PropSpec { name: "fill", kind: PropKind::Enum(&["solid", "gradient", "pattern"]), default: Some("solid"), summary: "Bar fill style — solid, a gradient, or a pattern" },
PropSpec { name: "patternKind", kind: PropKind::Enum(&["dots", "lines", "cross"]), default: None, summary: "Pattern motif when fill=\"pattern\"" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["chart-legend"],
summary: "Bar chart with vertical/horizontal orientation, grouped or stacked modes, and m…",
},
CompSpec {
name: "blockquote",
component: "blockquote",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "cite", kind: PropKind::Str, default: Some("undefined"), summary: "URL of the quote’s source (sets the HTML cite attribute)" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["blockquote"],
summary: "Quoted passage with optional attribution footer",
},
CompSpec {
name: "breadcrumb",
component: "breadcrumb",
aliases: &[],
args: &[
ArgSpec { name: "items", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "maxVisible", kind: PropKind::Num, default: None, summary: "When items exceed this count, collapse to the first item, an ellipsis, and the…" },
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Alias of ariaLabel — the same invisible accessible name under the other spelling" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: Some("Breadcrumb"), summary: "Accessible label for the component" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["breadcrumb"],
summary: "Shows the current page location within a navigation hierarchy",
},
CompSpec {
name: "button",
component: "button",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["primary", "secondary", "ghost", "destructive"]), default: Some("primary"), summary: "primary for the main action, secondary for a supporting one, ghost for a border…" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "loading", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows a loading state" },
PropSpec { name: "disabled", kind: PropKind::Bool, default: Some("false"), summary: "When true, disables the control and removes it from the tab order" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["button"],
summary: "Triggers an action or event",
},
CompSpec {
name: "card",
component: "card",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "actions", kind: PropKind::Str, default: None, summary: "CardHeader only — trailing content pinned to the inline-end (overflow menu, bad…" },
PropSpec { name: "variant", kind: PropKind::Enum(&["default", "outlined", "elevated"]), default: Some("default"), summary: "default draws a 1px border, outlined a heavier one, elevated drops the border f…" },
PropSpec { name: "padding", kind: PropKind::Enum(&["none", "sm", "md", "lg"]), default: Some("md"), summary: "Inner padding of the CARD BOX. ⚠ padding=\"none\" deliberately does NOT strip the…" },
PropSpec { name: "ai", kind: PropKind::Bool, default: Some("false"), summary: "AI presence: true gives the surface an AI-tinted edge and a soft aura, marking…" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["card"],
summary: "Container for grouping related content",
},
CompSpec {
name: "center",
component: "center",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "maxWidth", kind: PropKind::Str, default: Some("48rem"), summary: "CSS max-width value" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["center"],
summary: "Horizontally centered container with a configurable max-width",
},
CompSpec {
name: "code",
component: "code",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["code"],
summary: "Inline code span for identifiers, commands, and short snippets",
},
CompSpec {
name: "collapsible",
component: "collapsible",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: true },
],
props: &[
PropSpec { name: "open", kind: PropKind::Bool, default: None, summary: "Controlled open state" },
PropSpec { name: "defaultOpen", kind: PropKind::Bool, default: Some("false"), summary: "Initial open state for uncontrolled use" },
PropSpec { name: "trigger", kind: PropKind::Str, default: None, summary: "Content rendered inside the built-in trigger button" },
PropSpec { name: "disabled", kind: PropKind::Bool, default: Some("false"), summary: "Disables the trigger" },
],
children: Children::Nodes,
client_js: ClientJs::Enhancement,
css: &["collapsible"],
summary: "A single disclosure region toggled open and closed by its trigger",
},
CompSpec {
name: "columns",
component: "columns",
aliases: &["cols"],
args: &[
ArgSpec { name: "count", kind: ArgKind::Num, required: false },
],
props: &[
PropSpec { name: "gap", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("4"), summary: "Spacing token step" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["columns"],
summary: "Equal-width multi-column layout that collapses to single column on narrow viewp…",
},
CompSpec {
name: "dashboard-layout",
component: "dashboard-layout",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "stats", kind: PropKind::Str, default: None, summary: "Stats/KPI row (auto-fit grid)" },
PropSpec { name: "main", kind: PropKind::Str, default: None, summary: "Main content area" },
PropSpec { name: "aside", kind: PropKind::Str, default: None, summary: "Optional aside panel (20rem)" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["dashboard-layout"],
summary: "Dashboard page layout with stats strip, main content area, and optional aside",
},
CompSpec {
name: "data-list",
component: "data-list",
aliases: &[],
args: &[
ArgSpec { name: "rows", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "orientation", kind: PropKind::Enum(&["horizontal", "vertical"]), default: Some("horizontal"), summary: "Where each value sits relative to its own label: 'horizontal' beside it, 'verti…" },
PropSpec { name: "dividers", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows dividers between items" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["data-list"],
summary: "Key-value pairs rendered as a description list",
},
CompSpec {
name: "empty-state",
component: "empty-state",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: true },
ArgSpec { name: "description", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "icon", kind: PropKind::Str, default: None, summary: "Icon element rendered in the component" },
PropSpec { name: "action", kind: PropKind::Str, default: None, summary: "Primary action shown in the component" },
PropSpec { name: "size", kind: PropKind::Enum(&["md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["empty-state"],
summary: "Placeholder for views that have no data to display",
},
CompSpec {
name: "flex",
component: "flex",
aliases: &["row", "col"],
args: &[],
props: &[
PropSpec { name: "direction", kind: PropKind::Enum(&["vertical", "horizontal"]), default: Some("vertical"), summary: "Flex direction. ⚠ Defaults to vertical, unlike CSS flex-direction (and unlike C…" },
PropSpec { name: "gap", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("4"), summary: "Spacing token step" },
PropSpec { name: "align", kind: PropKind::Enum(&["start", "center", "end", "stretch"]), default: None, summary: "align-items" },
PropSpec { name: "justify", kind: PropKind::Enum(&["start", "center", "end", "between"]), default: None, summary: "justify-content" },
PropSpec { name: "wrap", kind: PropKind::Bool, default: Some("false"), summary: "Allow wrapping" },
PropSpec { name: "size", kind: PropKind::Enum(&["auto", "fixed", "grow", "shrink"]), default: Some("auto"), summary: "FlexItem: main-axis sizing. 'fixed' (flex: 0 0 auto) is what a fixed-width chil…" },
PropSpec { name: "basis", kind: PropKind::Str, default: None, summary: "FlexItem: flex-basis — the child's size before free space is distributed" },
PropSpec { name: "truncate", kind: PropKind::Bool, default: Some("false"), summary: "FlexItem: allow the child to shrink below its content width (releases the flex…" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["flex"],
summary: "Flex layout primitive for vertical or horizontal stacking with gap control. ⚠ U…",
},
CompSpec {
name: "gauge",
component: "gauge",
aliases: &[],
args: &[
ArgSpec { name: "value", kind: ArgKind::Num, required: true },
],
props: &[
PropSpec { name: "min", kind: PropKind::Num, default: Some("0"), summary: "Minimum allowed value" },
PropSpec { name: "max", kind: PropKind::Num, default: Some("100"), summary: "Maximum allowed value" },
PropSpec { name: "unit", kind: PropKind::Str, default: Some(""), summary: "Suffix after the centre value" },
PropSpec { name: "sweep", kind: PropKind::Num, default: Some("270"), summary: "Total sweep angle in degrees (270 = a speedometer arc)" },
PropSpec { name: "ticks", kind: PropKind::Num, default: Some("5"), summary: "Major tick count" },
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Chart title (also aria-label)" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("240"), summary: "SVG height in px" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no ticks/labels" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &[],
summary: "A speedometer gauge — a value arc over a min–max sweep with threshold zones, ti…",
},
CompSpec {
name: "grid",
component: "grid",
aliases: &[],
args: &[
ArgSpec { name: "columns", kind: ArgKind::Num, required: false },
],
props: &[
PropSpec { name: "gap", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("4"), summary: "Spacing token step" },
PropSpec { name: "align", kind: PropKind::Enum(&["start", "center", "end", "stretch"]), default: None, summary: "Block-axis alignment of items within their cells (align-items); default stretch" },
PropSpec { name: "justify", kind: PropKind::Enum(&["start", "center", "end", "stretch"]), default: None, summary: "Inline-axis alignment of items within their cells (justify-items); default stre…" },
PropSpec { name: "alignRows", kind: PropKind::Bool, default: Some("false"), summary: "Align the internal bands of adjacent children via CSS subgrid — every CardHeade…" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["grid"],
summary: "CSS grid layout primitive with responsive column collapsing",
},
CompSpec {
name: "heading",
component: "heading",
aliases: &["h1", "h2", "h3"],
args: &[],
props: &[
PropSpec { name: "level", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6"]), default: Some("2"), summary: "Heading level (1–6) mapping to h1–h6" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg", "xl", "2xl"]), default: Some("derived from level (1→2xl, 2→xl, 3→lg, 4→md, 5→sm, 6→sm)"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["heading"],
summary: "Section heading with semantic level decoupled from visual size",
},
CompSpec {
name: "image",
component: "image",
aliases: &[],
args: &[
ArgSpec { name: "src", kind: ArgKind::Str, required: true },
ArgSpec { name: "alt", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "fallbackSrc", kind: PropKind::Str, default: None, summary: "Image shown if src fails to load" },
PropSpec { name: "width", kind: PropKind::Str, default: None, summary: "Intrinsic width in px, forwarded to the <img>" },
PropSpec { name: "height", kind: PropKind::Str, default: None, summary: "Intrinsic height in px, forwarded to the <img>" },
PropSpec { name: "radius", kind: PropKind::Enum(&["none", "sm", "md", "lg", "full"]), default: Some("md"), summary: "Corner radius of the image ('none' | 'sm' | 'md' | 'lg' | 'full')" },
PropSpec { name: "zoom", kind: PropKind::Bool, default: Some("false"), summary: "When true, zooms the image on hover" },
PropSpec { name: "removeWrapper", kind: PropKind::Bool, default: Some("false"), summary: "Render a bare <img> with no wrapper, placeholder, or zoom" },
PropSpec { name: "isBlurred", kind: PropKind::Bool, default: Some("false"), summary: "When true, renders a blurred backdrop behind the image" },
PropSpec { name: "w", kind: PropKind::Str, default: None, summary: "Width: px number or CSS length" },
PropSpec { name: "h", kind: PropKind::Str, default: None, summary: "Height: px number or CSS length" },
PropSpec { name: "fit", kind: PropKind::Enum(&["contain", "cover"]), default: None, summary: "How the picture fills w/h" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["image"],
summary: "Image with load state, blur-up placeholder, graceful fallback, and optional zoom",
},
CompSpec {
name: "kbd",
component: "kbd",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["kbd"],
summary: "Displays a keyboard key or shortcut",
},
CompSpec {
name: "kpi",
component: "kpi",
aliases: &[],
args: &[
ArgSpec { name: "label", kind: ArgKind::Str, required: true },
ArgSpec { name: "value", kind: ArgKind::Str, required: true },
ArgSpec { name: "delta", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "goodDirection", kind: PropKind::Enum(&["up", "down", "neutral"]), default: Some("up"), summary: "Which direction is good for this metric — the colour, independent of the arrow…" },
PropSpec { name: "deltaLabel", kind: PropKind::Str, default: None, summary: "Delta context label (e.g \"vs last week\")" },
PropSpec { name: "icon", kind: PropKind::Str, default: None, summary: "Icon element rendered in the component" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["kpi"],
summary: "KPI card showing a primary metric with optional delta indicator, icon, and spar…",
},
CompSpec {
name: "line",
component: "line-chart",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Nums, required: true },
],
props: &[
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Chart title (also used as aria-label)" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Subtitle shown below title" },
PropSpec { name: "curve", kind: PropKind::Enum(&["linear", "monotone", "step", "stepBefore", "stepAfter", "natural", "basis", "cardinal", "catmullRom"]), default: Some("monotone"), summary: "Line interpolation curve" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width (defaults to container width)" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("300"), summary: "SVG height in px" },
PropSpec { name: "xTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of X-axis ticks" },
PropSpec { name: "yTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of Y-axis ticks" },
PropSpec { name: "legend", kind: PropKind::Bool, default: None, summary: "Show series legend" },
PropSpec { name: "tooltip", kind: PropKind::Bool, default: None, summary: "Enable hover tooltip" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no axes, grid lines, or legend" },
PropSpec { name: "labels", kind: PropKind::Bool, default: None, summary: "Print each value as a label on the mark (collision-aware, decorative/aria-hidde…" },
PropSpec { name: "connectNulls", kind: PropKind::Bool, default: Some("false"), summary: "Bridge non-finite y gaps instead of breaking the line at them" },
PropSpec { name: "brush", kind: PropKind::Bool, default: Some("false"), summary: "Show a keyboard-operable Brush below the plot to subset (zoom) the series to a…" },
PropSpec { name: "dataZoom", kind: PropKind::Bool, default: Some("false"), summary: "Show a DataZoom slider below the plot — a Brush whose body also pans the window" },
PropSpec { name: "zoom", kind: PropKind::Bool, default: Some("false"), summary: "Enable in-plot wheel/drag/keyboard zoom-pan (+/-/0) over the series index windo…" },
PropSpec { name: "syncId", kind: PropKind::Str, default: None, summary: "Connect this chart to others sharing the same id — they mirror the zoom window…" },
PropSpec { name: "tooltipMode", kind: PropKind::Enum(&["item", "axis"]), default: Some("item"), summary: "Tooltip trigger — item (nearest point) or axis (a crosshair + a shared tooltip…" },
PropSpec { name: "decimate", kind: PropKind::Bool, default: None, summary: "Downsample dense series before drawing (LTTB or min-max)" },
PropSpec { name: "toolbox", kind: PropKind::Bool, default: None, summary: "Render a keyboard-reachable toolbox — PNG/SVG export, a data-view table toggle,…" },
PropSpec { name: "transition", kind: PropKind::Bool, default: None, summary: "Tune the reduced-motion-gated enter/update transitions (false disables)" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["chart-legend"],
summary: "Time-series or numeric line chart with multi-series support, hover tooltip, and…",
},
CompSpec {
name: "link",
component: "link",
aliases: &[],
args: &[
ArgSpec { name: "href", kind: ArgKind::Str, required: true },
],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["standalone", "inline"]), default: Some("standalone"), summary: "standalone uses the system's own type and underlines on hover — for a link that…" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "external", kind: PropKind::Bool, default: Some("false"), summary: "When true, treats the link as external (opens in a new tab with rel safety)" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["link"],
summary: "Styled anchor for navigation, standalone or inline within prose",
},
CompSpec {
name: "list",
component: "list",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "as", kind: PropKind::Enum(&["ul", "ol"]), default: Some("ul"), summary: "ul for an unordered list, ol for a numbered one" },
PropSpec { name: "marker", kind: PropKind::Enum(&["disc", "decimal", "none"]), default: Some("derived from as (ul→disc, ol→decimal)"), summary: "List marker style ('disc' | 'decimal' | 'none')" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["list"],
summary: "Styled unordered or ordered list with ListItem",
},
CompSpec {
name: "meter",
component: "meter",
aliases: &[],
args: &[
ArgSpec { name: "value", kind: ArgKind::Num, required: true },
],
props: &[
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Text label for the control" },
PropSpec { name: "min", kind: PropKind::Num, default: Some("0"), summary: "Minimum allowed value" },
PropSpec { name: "max", kind: PropKind::Num, default: Some("100"), summary: "Maximum allowed value" },
PropSpec { name: "variant", kind: PropKind::Enum(&["bar", "gauge"]), default: Some("bar"), summary: "bar draws a straight horizontal track; gauge draws a half-donut dial" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: None, summary: "SVG height in px" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["meter"],
summary: "Progress meter in bar or gauge variant with threshold coloring",
},
CompSpec {
name: "notification",
component: "notification",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "variant", kind: PropKind::Enum(&["info", "success", "warning", "error"]), default: Some("info"), summary: "Severity tone" },
PropSpec { name: "dismissible", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows a control to dismiss the component" },
PropSpec { name: "actions", kind: PropKind::Str, default: None, summary: "Action elements shown in the notification" },
PropSpec { name: "icon", kind: PropKind::Str, default: None, summary: "Icon element rendered in the component" },
],
children: Children::Text,
client_js: ClientJs::Enhancement,
css: &["notification"],
summary: "Inline, actionable notification banner that surfaces a titled message with an o…",
},
CompSpec {
name: "page-header",
component: "page-header",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: true },
ArgSpec { name: "description", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "breadcrumb", kind: PropKind::Str, default: None, summary: "Breadcrumb slot" },
PropSpec { name: "actions", kind: PropKind::Str, default: None, summary: "Action buttons slot" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["page-header"],
summary: "Page-level header with title, description, breadcrumb, and actions slots",
},
CompSpec {
name: "pie",
component: "pie-chart",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Pairs, required: true },
],
props: &[
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Title text for the component" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "donut", kind: PropKind::Bool, default: Some("false"), summary: "Render as donut chart" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("300"), summary: "SVG height in px" },
PropSpec { name: "size", kind: PropKind::Num, default: None, summary: "Square shorthand: sets width === height" },
PropSpec { name: "thickness", kind: PropKind::Num, default: None, summary: "Ring width in px (donut only); defaults to 0.4 × radius" },
PropSpec { name: "innerRadius", kind: PropKind::Num, default: None, summary: "Inner radius in px (donut only); takes precedence over thickness; clamped to [0…" },
PropSpec { name: "centerValue", kind: PropKind::Str, default: None, summary: "Center value text rendered in the donut hole (donut only)" },
PropSpec { name: "centerLabel", kind: PropKind::Str, default: None, summary: "Center label text rendered below the value (donut only)" },
PropSpec { name: "centerSlot", kind: PropKind::Str, default: None, summary: "Arbitrary content for the donut hole; takes precedence over centerValue/centerL…" },
PropSpec { name: "emptyLabel", kind: PropKind::Str, default: None, summary: "Visible placeholder text when data is empty" },
PropSpec { name: "legend", kind: PropKind::Bool, default: None, summary: "Whether to show the legend" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no axes, grid lines, or legend" },
PropSpec { name: "labels", kind: PropKind::Bool, default: None, summary: "Print each value as a label on the mark (collision-aware, decorative/aria-hidde…" },
PropSpec { name: "tooltip", kind: PropKind::Bool, default: Some("true"), summary: "Show tooltips" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["chart-legend"],
summary: "Pie or donut chart with hover segments and optional legend",
},
CompSpec {
name: "progress-bar",
component: "progress-bar",
aliases: &[],
args: &[
ArgSpec { name: "value", kind: ArgKind::Num, required: true },
],
props: &[
PropSpec { name: "max", kind: PropKind::Num, default: Some("100"), summary: "Maximum allowed value" },
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Visible label above the track, wired via aria-labelledby" },
PropSpec { name: "helperText", kind: PropKind::Str, default: None, summary: "Supplementary text shown with the progress bar" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "status", kind: PropKind::Enum(&["active", "success", "error"]), default: Some("active"), summary: "success/error tint the fill and show a glyph next to the label" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["progress-bar"],
summary: "Shows determinate or indeterminate progress of a task",
},
CompSpec {
name: "progress-circle",
component: "progress-circle",
aliases: &[],
args: &[
ArgSpec { name: "value", kind: ArgKind::Num, required: true },
],
props: &[
PropSpec { name: "max", kind: PropKind::Num, default: Some("100"), summary: "Maximum allowed value" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "showValue", kind: PropKind::Bool, default: Some("false"), summary: "Renders the rounded percentage in the center — pairs best with md and lg" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Alias of label — the same invisible accessible name under the catalog spelling" },
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Accessible name announced by screen readers" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["progress-circle"],
summary: "Circular determinate progress indicator rendered as an SVG arc",
},
CompSpec {
name: "prose",
component: "prose",
aliases: &[],
args: &[],
props: &[],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["prose"],
summary: "Wrapper that styles raw descendant HTML — headings, lists, code, quotes, tables",
},
CompSpec {
name: "scatter",
component: "scatter-chart",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Pairs, required: true },
],
props: &[
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Title text for the component" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "width", kind: PropKind::Num, default: None, summary: "Fixed SVG width in px. ⚠ Omit for a responsive chart — the chart fills and trac…" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("300"), summary: "SVG height in px" },
PropSpec { name: "xTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the x-axis" },
PropSpec { name: "yTicks", kind: PropKind::Num, default: Some("5"), summary: "Approximate number of ticks on the y-axis" },
PropSpec { name: "legend", kind: PropKind::Bool, default: None, summary: "Whether to show the legend" },
PropSpec { name: "tooltip", kind: PropKind::Bool, default: None, summary: "Enable hover/keyboard tooltip" },
PropSpec { name: "plain", kind: PropKind::Bool, default: Some("false"), summary: "Marks only — no axes, grid lines, or legend" },
PropSpec { name: "renderer", kind: PropKind::Enum(&["svg", "canvas", "auto"]), default: Some("svg"), summary: "Renderer — svg (default), canvas (force), or auto (canvas past ~2000 points)" },
PropSpec { name: "toolbox", kind: PropKind::Bool, default: None, summary: "Render a keyboard-reachable toolbox — PNG/SVG export, a data-view table toggle,…" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["chart-legend"],
summary: "Scatter plot with variable point radius, multi-series, and hover tooltip",
},
CompSpec {
name: "section",
component: "section",
aliases: &[],
args: &[
ArgSpec { name: "title", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "gap", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("8"), summary: "Stack gap between children (spacing token step)" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["section"],
summary: "Page-section shell with block padding, centered inner width, and stack gap",
},
CompSpec {
name: "separator",
component: "separator",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "orientation", kind: PropKind::Enum(&["horizontal", "vertical"]), default: Some("horizontal"), summary: "Direction the rule runs: horizontal draws a full-width line, vertical a full-he…" },
PropSpec { name: "decorative", kind: PropKind::Bool, default: Some("false"), summary: "When true, the separator is purely visual and hidden from assistive tech" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["separator"],
summary: "Visual or semantic divider between content",
},
CompSpec {
name: "skeleton",
component: "skeleton",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["text", "circle", "rect"]), default: Some("text"), summary: "Shape of the placeholder: text (stacked lines), circle (an avatar), rect (a blo…" },
PropSpec { name: "width", kind: PropKind::Str, default: None, summary: "CSS length applied as an inline custom property" },
PropSpec { name: "height", kind: PropKind::Str, default: None, summary: "CSS length applied as an inline custom property" },
PropSpec { name: "lines", kind: PropKind::Num, default: Some("1"), summary: "Number of bars for the text variant; the last bar renders shorter" },
PropSpec { name: "ai", kind: PropKind::Bool, default: Some("false"), summary: "Tints the placeholder and its sheen with the AI hue, marking content that an AI…" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["skeleton"],
summary: "Animated loading placeholder that mirrors the shape of pending content",
},
CompSpec {
name: "spacer",
component: "spacer",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "size", kind: PropKind::Enum(&["1", "2", "3", "4", "5", "6", "8", "10", "12"]), default: Some("4"), summary: "Spacing token step" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["spacer"],
summary: "Fixed-height spacing block using design token steps",
},
CompSpec {
name: "spark",
component: "sparkline",
aliases: &[],
args: &[
ArgSpec { name: "data", kind: ArgKind::Nums, required: true },
],
props: &[
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Accessible name for the chart (invisible — rendered as the SVG <title>)" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Alias for label (the catalog convention for an invisible accessible name)" },
PropSpec { name: "width", kind: PropKind::Num, default: Some("120"), summary: "SVG width in px" },
PropSpec { name: "height", kind: PropKind::Num, default: Some("32"), summary: "SVG height in px" },
PropSpec { name: "color", kind: PropKind::Str, default: Some("var(--cascivo-chart-1)"), summary: "Stroke color (CSS value)" },
PropSpec { name: "endDot", kind: PropKind::Bool, default: Some("true"), summary: "Show dot at last data point" },
],
children: Children::None,
client_js: ClientJs::None,
css: &[],
summary: "Compact inline sparkline for embedding trend data in dashboards or KPI cards",
},
CompSpec {
name: "spinner",
component: "spinner",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Alias of label — the same invisible accessible name under the catalog spelling" },
PropSpec { name: "label", kind: PropKind::Str, default: Some("Loading"), summary: "Accessible label announced by screen readers" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["spinner"],
summary: "Indeterminate loading indicator",
},
CompSpec {
name: "stat",
component: "stat",
aliases: &[],
args: &[
ArgSpec { name: "label", kind: ArgKind::Str, required: true },
ArgSpec { name: "value", kind: ArgKind::Str, required: true },
ArgSpec { name: "delta", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "card", kind: PropKind::Bool, default: Some("false"), summary: "Wrap the tile in the same card chrome @cascivo/charts' Kpi ships (surface, bord…" },
PropSpec { name: "trend", kind: PropKind::Enum(&["up", "down", "flat"]), default: Some("flat"), summary: "Direction of the trend indicator ('up' | 'down' | 'flat')" },
PropSpec { name: "goodDirection", kind: PropKind::Enum(&["up", "down", "neutral"]), default: Some("up"), summary: "Which direction is good for this metric — the colour, independent of the arrow.…" },
PropSpec { name: "helpText", kind: PropKind::Str, default: None, summary: "Fine print below the value (methodology, time range)" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["stat"],
summary: "Displays a key metric with optional delta, trend direction and help text",
},
CompSpec {
name: "steps",
component: "steps",
aliases: &[],
args: &[
ArgSpec { name: "items", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Alias of ariaLabel — the same invisible accessible name under the other spelling" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Accessible label for the steps navigation; defaults to the built-in i18n string" },
PropSpec { name: "activeStep", kind: PropKind::Num, default: Some("0"), summary: "Index of the currently active step (0-based)" },
PropSpec { name: "orientation", kind: PropKind::Enum(&["horizontal", "vertical"]), default: Some("horizontal"), summary: "Axis the steps flow along: horizontal runs them across with connectors between,…" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["steps"],
summary: "Visual progress indicator for multi-step flows with horizontal and vertical ori…",
},
CompSpec {
name: "structured-list",
component: "structured-list",
aliases: &[],
args: &[
ArgSpec { name: "rows", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "label", kind: PropKind::Str, default: None, summary: "Alias of ariaLabel — the same invisible accessible name under the other spelling" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Invisible accessible name" },
PropSpec { name: "aria-label", kind: PropKind::Str, default: None, summary: "Accessible label for the list table" },
PropSpec { name: "selectable", kind: PropKind::Bool, default: Some("false"), summary: "When true, rows can be selected" },
PropSpec { name: "value", kind: PropKind::Str, default: None, summary: "The controlled value" },
PropSpec { name: "defaultValue", kind: PropKind::Str, default: None, summary: "The initial value when uncontrolled" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["structured-list"],
summary: "Tabular row list for scannable data, optionally single-selectable",
},
CompSpec {
name: "svg",
component: "svg",
aliases: &[],
args: &[
ArgSpec { name: "src", kind: ArgKind::Str, required: true },
ArgSpec { name: "alt", kind: ArgKind::Str, required: false },
],
props: &[
PropSpec { name: "w", kind: PropKind::Str, default: None, summary: "Width: px number or CSS length" },
PropSpec { name: "h", kind: PropKind::Str, default: None, summary: "Height: px number or CSS length" },
PropSpec { name: "fit", kind: PropKind::Enum(&["contain", "cover"]), default: None, summary: "How the picture fills w/h" },
],
children: Children::None,
client_js: ClientJs::None,
css: &[],
summary: "Inline SVG from a file, URL or markup, sanitized; currentColor follows the theme",
},
CompSpec {
name: "table",
component: "data-table",
aliases: &[],
args: &[
ArgSpec { name: "rows", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "virtualized", kind: PropKind::Bool, default: Some("false"), summary: "Render only the visible row window for large datasets" },
PropSpec { name: "rowHeight", kind: PropKind::Num, default: None, summary: "Row height in px for the virtualized window" },
PropSpec { name: "windowSize", kind: PropKind::Num, default: None, summary: "Rows rendered per window" },
PropSpec { name: "overscan", kind: PropKind::Num, default: Some("3"), summary: "Extra rows rendered above/below the window to smooth scrolling" },
PropSpec { name: "sortMode", kind: PropKind::Enum(&["client", "server"]), default: Some("client"), summary: "Whether sorting is handled client-side or by the server ('client' | 'server')" },
PropSpec { name: "searchable", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows a search/filter input" },
PropSpec { name: "noResultsState", kind: PropKind::Str, default: None, summary: "Shown instead of emptyState when there are rows but the search or filters match…" },
PropSpec { name: "toolbar", kind: PropKind::Str, default: None, summary: "Extra controls rendered in the toolbar next to the search box — exports, primar…" },
PropSpec { name: "multiSort", kind: PropKind::Bool, default: Some("false"), summary: "Allow sorting by more than one column: Shift-click a header adds it as a tie-br…" },
PropSpec { name: "stateKey", kind: PropKind::Str, default: None, summary: "Remember the user's column layout and sort across reloads, in local storage und…" },
PropSpec { name: "keyboardNavigation", kind: PropKind::Enum(&["row", "grid"]), default: Some("row"), summary: "How the keyboard moves through the table. 'row' keeps every control in the Tab…" },
PropSpec { name: "totals", kind: PropKind::Bool, default: Some("false"), summary: "Show a totals row under the body with each aggregate column's reduction over ev…" },
PropSpec { name: "exportable", kind: PropKind::Bool, default: Some("false"), summary: "An \"Export CSV\" button in the toolbar: every row passing the search and filters…" },
PropSpec { name: "density", kind: PropKind::Enum(&["compact", "normal", "relaxed"]), default: Some("normal"), summary: "Row density — 'compact', 'normal', or 'relaxed'. ⚠ It sets a row height floor,…" },
PropSpec { name: "zebra", kind: PropKind::Bool, default: Some("false"), summary: "When true, applies alternating row striping" },
PropSpec { name: "stickyHeader", kind: PropKind::Bool, default: Some("false"), summary: "When true, the header stays fixed while the body scrolls" },
PropSpec { name: "loading", kind: PropKind::Bool, default: Some("false"), summary: "When true, shows a loading state" },
PropSpec { name: "emptyState", kind: PropKind::Str, default: None, summary: "Content shown when there are no rows" },
PropSpec { name: "ariaLabel", kind: PropKind::Str, default: None, summary: "Invisible accessible name for the table, used when there is no visible title" },
PropSpec { name: "title", kind: PropKind::Str, default: None, summary: "Visible caption above the table; it also becomes the table's accessible name" },
PropSpec { name: "description", kind: PropKind::Str, default: None, summary: "Supporting description text" },
PropSpec { name: "sort", kind: PropKind::Bool, default: None, summary: "Click a header to sort (inlines a tiny script)" },
],
children: Children::None,
client_js: ClientJs::Enhancement,
css: &["data-table"],
summary: "Signal-driven data table with client/server sort, filter, pagination, multi-sel…",
},
CompSpec {
name: "tabs",
component: "tabs",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "defaultValue", kind: PropKind::Str, default: None, summary: "The initial value when uncontrolled" },
PropSpec { name: "value", kind: PropKind::Str, default: None, summary: "The controlled value" },
],
children: Children::Nodes,
client_js: ClientJs::None,
css: &["tabs"],
summary: "Switch between related panels of content",
},
CompSpec {
name: "tag",
component: "tag",
aliases: &[],
args: &[],
props: &[
PropSpec { name: "variant", kind: PropKind::Enum(&["default", "info", "success", "warning", "error"]), default: Some("default"), summary: "Severity tone" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "dismissLabel", kind: PropKind::Str, default: Some("Remove"), summary: "Accessible label for the dismiss button" },
],
children: Children::Text,
client_js: ClientJs::Enhancement,
css: &["tag"],
summary: "Compact chip for labeling, categorizing, or filtering content",
},
CompSpec {
name: "text",
component: "text",
aliases: &["p"],
args: &[],
props: &[
PropSpec { name: "as", kind: PropKind::Enum(&["p", "span", "div"]), default: Some("p"), summary: "p for a paragraph, span for inline text, div for a block that imposes no semant…" },
PropSpec { name: "size", kind: PropKind::Enum(&["sm", "md", "lg"]), default: Some("md"), summary: "Visual size of the component (e.g 'sm', 'md', 'lg')" },
PropSpec { name: "weight", kind: PropKind::Enum(&["normal", "medium", "semibold"]), default: Some("normal"), summary: "Font weight ('normal' | 'medium' | 'semibold')" },
PropSpec { name: "muted", kind: PropKind::Bool, default: Some("false"), summary: "When true, renders in a muted/subtle color" },
],
children: Children::Text,
client_js: ClientJs::None,
css: &["text"],
summary: "Body text with size, weight, and muted variants",
},
CompSpec {
name: "timeline",
component: "timeline",
aliases: &[],
args: &[
ArgSpec { name: "rows", kind: ArgKind::Rows, required: true },
],
props: &[
PropSpec { name: "orientation", kind: PropKind::Enum(&["vertical", "horizontal"]), default: Some("vertical"), summary: "Axis the entries flow along: vertical stacks them down the page (the usual read…" },
],
children: Children::None,
client_js: ClientJs::None,
css: &["timeline"],
summary: "Ordered sequence of events with status markers and a connector line",
},
];