Built-in component baseline¶
Browse all built-in component demos
This page is an index into dedicated component pages. Each component page is the constructor/parameter reference (generated from live signatures when the docs manifest is stubbed). Prefer those pages over treating this file as a full API manual.
Stability
Classifications for this surface are recorded in STABILITY.md. Package
maturity (Beta/Alpha) is separate from API level (beta / experimental / internal /
deferred).
Status: Accepted · current train 0.20
How to use this index¶
- Pick a component from the groups below (or search the component catalog).
- Open its page for signature, parameters, accessibility, and testing notes.
- For HTMX interaction patterns, see HTMX interactions.
- For inference presentation widgets, also see Inference API.
Document and composition¶
Page · Fragment ·
Head · Title
Landmarks and layout¶
Header · Main ·
Nav · Aside ·
Footer · Section ·
Container · Stack ·
Inline · Grid ·
Divider · Spacer
Content and media¶
Heading · Text ·
Link · Image ·
Audio · Video ·
IFrame · PdfViewer ·
CodeBlock · List ·
DescriptionList · Table ·
Markdown · Math ·
Map · Gallery
Surfaces, controls, forms¶
Card · Badge ·
Alert · Skeleton ·
Button · ConfirmButton ·
Form · TextInput ·
NumberInput · DateInput ·
MultiSelect · ToggleSwitch ·
CameraCapture ·
MicrophoneCapture ·
DirectoryUpload · …
full forms group
Interaction (FastAPI / HTMX)¶
AutoForm · RefreshButton ·
Lazy · Poll ·
InfiniteScroll ·
Pagination · Loading ·
ErrorState · ChatInput ·
ChatMessage · Dialog
Helpers: action_attrs, oob_swap — see Interaction.
Data, charts, utilities¶
Auto · DataTable ·
DataEditor · charts via hedron[charts] —
Charts API · Metric ·
FileUpload ·
DownloadButton ·
Progress · Toast ·
ColorModeToggle
Inference presentation (0.18)¶
PredictionLabel ·
ParameterViewer ·
Dialogue
Non-UI contracts (ModelDemo, ExampleSet, PredictionFeedback, InferenceWorkflow)
are documented on INFERENCE.md, not as components.
Native HTML escape hatch¶
html.<tag>(*children, **attributes) — see any early component page or
SECURITY_TYPES for SafeUrl / TrustedHtml rules.
Naming rule¶
Hedron component names use PascalCase. Native elements use lowercase hedron.html
attributes and tags. Python keyword collisions use a trailing underscore such as
class_; rendered HTML always uses the canonical attribute name.
Historical phase notes¶
Phase 0.1–0.10 acceptance narratives remain in release notes / what’s-new pages. This index tracks the living 0.18 catalog — do not treat older phase lists as the complete API.