primitives
Components
wraps tux native
TuxAbstract
Structured academic abstract block.
wraps tux native
TuxAccordion
FAQ + publication disclosure — native details/summary, zero-JS, single-mode + slot composition.
wraps tux native
TuxAcknowledgments
Funding + acknowledgments + ethics block.
wraps tux native
TuxActivityTimeline
Editorial vertical timeline — maroon spine, mono timestamps, gold-ringed current node. Milestones, ingest feeds, session history.
wraps UAlert
TuxAlert
Docusaurus-style admonitions — 8 variants including compliance and tip.
wraps tux native
TuxAlphaNav
A–Z jump bar — anchor mode for in-page jumps, emit mode for filter-in-place.
wraps tux native
TuxAnnouncementBanner
Top-of-page dismissable strip for site-wide notices. localStorage-backed dismissal memory.
wraps tux native
TuxAppFrame
Custom Tauri titlebar — traffic lights (Mac) / min-max-close (Win/Linux), brand + toolbar slots, drag regions. Replaces native window decoration.
wraps UPopover
TuxAppSwitcher
Waffle-button popover for hopping between TTI portals — registry-fed via useTuxApps(), registry order everywhere, current tile carries aria-current.
wraps tux native
TuxArtifact
AI output container — header + actions + body slot. Wraps generated code, docs, exported datasets.
wraps tux native
TuxAuthorByline
Multi-author byline with affiliations + ORCID.
wraps tux native
TuxAvatar
Identity mark primitive — photo with initials fallback + optional status dot. Extracted from TuxUserMenu.
wraps UBadge
TuxBadge
Classification tiers, lifecycle statuses, monospace tags, and facet counts.
wraps tux native
TuxBetaRibbon
Environment label — corner ribbon, top stripe, or inline pill. preview/beta/dev tones.
wraps tux native
TuxBigStat
Single oversized metric — three sizes, three tones, three style variants.
wraps tux native
TuxBlockquote
Standalone pull quote — centered or magazine-style drop-cap. Variant-aware rule + face.
wraps tux native
TuxBranchNav
‹ N of M › navigator for response alternatives. Lives in TuxChatMessage's #header-trailing slot.
wraps tux native
TuxBreadcrumbs
Page-depth nav — home icon, italic intermediates, pipe rules collapsing to chevron on narrow.
wraps UButton
TuxButton
Semantic intent prop — primary, secondary, ghost, destructive (fills on hover).
wraps tux native
TuxCTA
Big promotional block — three tones, three style variants, action slot.
wraps tux native
TuxCallout
Pulled-aside editorial accent — fact / stat / quote with style-variant left rule.
wraps tux native
TuxCaptionedMedia
Single image + caption + credit. 16:9 / 1:1 / 4:3 / 3:4 aspect, full / wide / right alignment.
wraps tux native
TuxCard
Static or linked — linked mode has corner-drop hover + appearing arrow.
wraps UCarousel (embla) wrap
TuxCardCarousel
Horizontal scroll of cards — eyebrow + display title + arrows + dots. Wraps UCarousel.
wraps tux native
TuxCardSlab
Full-bleed band of media-forward cards — \"browse our programs\" pattern, 2/3/4-up.
wraps tux native
TuxCenterBadge
TTI center / division marker.
wraps tux native SVG
TuxChartArea
Native SVG area chart — overlay or stacked variants, end-of-area labels, paired with TuxBigStat for the KPI-strip composition.
wraps tux native SVG
TuxChartBar
Native SVG bar chart — single / grouped / stacked variants, vertical or horizontal, optional comparison overlay (projection vs actual).
wraps tux native SVG
TuxChartDonut
Share-of-total donut — center stat slot, slice-label colored to wedge, minSlice% auto-folds tiny slices into Other.
wraps tux native (editorial wrapper)
TuxChartFrame
Editorial wrapper that ties native chart components into the TUX type system.
wraps tux native SVG
TuxChartGauge
270° arc gauge for single-target metrics — needle + tone bands, or radial-progress variant. Use sparingly.
wraps tux native (5-kind Texas map)
TuxChartGeographic
Texas-flavored geographic charts.
wraps tux native SVG
TuxChartHeatmap
Matrix heatmap on the sequential map ramps — crashes by day × hour, corridor demand by month. 2-D keyboard cursor, honest null cells.
wraps tux native SVG
TuxChartHistogram
Distribution over raw samples — nice 1/2/5 bin edges, dashed gold p50/p95 percentile rules, normalize-to-share mode. The reliability chart.
wraps tux native SVG
TuxChartLine
Native SVG line chart — end-of-line value labels, optional previous-period overlay + confidence band, auto SR summary.
wraps tux native SVG
TuxChartScatter
Correlation plot — x vs y dots, optional linear-regression trendline + R², bubble-chart mode via per-point size.
wraps tux native (two-ring radial)
TuxChartSunburst
Radial counterpart to `TuxTreemap`.
wraps tux native
TuxChatMessage
One conversation turn — user or assistant role, citations slot, tool row. Powers tti-ai-chat.
wraps UDropdownMenu
TuxCitationExport
Academic citation export menu.
wraps tux native
TuxCitations
Numbered source list under an assistant message — title + path + score in a 3-col grid.
wraps Shiki
TuxCodeBlock
Standalone Shiki code block — filename, line numbers, copy. Lazy-loads grammar on mount.
wraps tux native
TuxCodeMaroon
Mandatory emergency alert banner — Rellis Code Maroon. Three severities, non-themed colors.
wraps tux native
TuxCommandPalette
Global ⌘K jump — search + grouped commands + keyboard nav, native <dialog>.
wraps tux native
TuxCommentThread
Peer-review / editorial threads — root + replies, @mentions, resolve/reopen, edit/delete own.
wraps tux native
TuxComposer
Chat input with optional compliance scope banner — model picker, corpus attach, ⌘↵ send.
wraps TuxModal preset
TuxConfirmDialog
TuxModal preset for destructive-action confirmation.
wraps tux native
TuxContactCard
Directory card — portrait + name + role + typed contact rows. Vertical or horizontal.
wraps UPopover
TuxContextMeter
Token-utilization meter — pill + conic ring + popover with input/output/cost. Tone-codes success/warning/error.
wraps tux native
TuxContextPanel
Right-rail surface for chat grounding context (corpus, retrieval, usage). Slot-driven chrome.
wraps tux native
TuxConversationList
Sidebar history of past conversations grouped by temporal bucket (TODAY / YESTERDAY / …).
wraps tux native
TuxCookieConsent
Privacy notice — bottom-right or full-width strip. localStorage-backed decision memory; categories slot.
wraps tux native SVG
TuxCorridorStrip
Linear corridor visualization.
wraps tux native
TuxDataTable
Research-deliverable table — numbered caption, uncertainty cells (value ± CI), footnote anchors, totals row, source citation. Static (printable).
wraps tux native
TuxDescriptionList
Term/definition pairs — native dl/dt/dd. Inline or stacked, editorial or data emphasis.
wraps Mermaid
TuxDiagram
Mermaid diagrams-as-code — flowcharts, sequences, ERDs. Lazy-loaded ~3MB; brand-themed.
wraps tux native
TuxDocsSidebar
Hierarchical doc-site sidebar — collapsible sections, search filter, persisted collapse state.
wraps tux native
TuxDropdown
Single-column dropdown from a top-bar nav item. Composes inside TuxSiteNav.
wraps TuxCard composite
TuxEmptyState
No-data placeholder — tinted icon circle, title, description, CTA slot.
wraps tux native
TuxErrorPage
Full-page 404/500/403/503 template — display-type code, recovery actions, support slot.
wraps tux native
TuxFAB
Floating Action Button. Material-pattern primary action; icon-only circle or extended pill. Honors safe-area-inset.
wraps tux native
TuxFactoid
Institutional \"by the numbers\" — 3/4/5-up oversized stats, variant-aware numerals.
wraps tux native
TuxFigureCaption
Auto-numbered caption for figures, tables, exhibits, equations.
wraps tux native
TuxFileDropzone
Drag-and-drop file upload.
wraps tux native
TuxFilterPanel
Left-rail facet panel — collapsible groups, checkbox lists with counts, applied-filter chips.
wraps Teleport + native
TuxFocusView
Full-viewport overlay for inspecting one piece of content — back + title + actions chrome, content slot. \"Open chart in focus mode.\"
wraps tux native
TuxFooter
Unified institutional footer \u2014 maroon marketing top (logo + address + social + columns) over the mandatory TAMUS legal strip.
wraps UPopover
TuxFootnote
Inline footnote reference + hover preview.
wraps tux native
TuxFormField
Label + help + input + error stack.
wraps tux native
TuxFundingSource
Funder identity strip / chip.
wraps tux native
TuxIconFeature
Icon + headline + body grid — classic \"our services\" block, three tones, grid or list.
wraps tux native
TuxIdentity
Header lockup — logo + wordmark. Lockup or text-only, horizontal or stacked, three levels.
wraps tux native
TuxInfiniteScroll
IntersectionObserver sentinel that auto-fetches the next page. Honors prefers-reduced-motion + keyboard fallback.
wraps UPopover
TuxInfoLabel
Form-field label with (i) help — hover or click popover with the explanation. For ITAR rubrics, retention classes, classifier metrics.
wraps UPopover
TuxInlineCitation
Academic-style inline [N] citation pill — hover reveals title + URL + excerpt + score. Composes with TuxCitations footer list.
wraps tux native
TuxKbd
Token-styled <kbd> for shortcut hints. Mac/PC modifier normalization, three sizes, combo + sequence forms.
wraps tux native
TuxLab
TTI lab / center identity card.
wraps tux native
TuxLinkList
Categorized resource list — grouped headings, optional descriptions, featured-item left bar.
wraps tux native
TuxLinkSlab
Full-width band of prominent links — footer-of-section navigation, three tones.
wraps tux native
TuxLoadMore
Explicit \"Load more\" button + remaining count + terminal divider when all loaded. SEO-friendly middle ground.
wraps iframe / slot
TuxMapEmbed
Library-agnostic map embed wrapper.
wraps tux native
TuxMapLegend
Standalone legend for embedded maps.
wraps tux native SVG
TuxMapMarker
Research-typed map marker.
wraps tux native (no deps)
TuxMarkdownEditor
Textarea with markdown shortcuts.
wraps tux native
TuxMcpEmbed
Frame for interactive third-party MCP app output — app icon + name + window controls + skeleton. Sister to TuxArtifact.
wraps tux native
TuxMediaSlab
Full-bleed hero band — overlay (drama) or split (editorial), three heights, three tones.
wraps tux native
TuxMegaMenu
Full-width multi-column panel from a top-bar item, optional featured tile. Composes inside TuxSiteNav.
wraps UDropdownMenu
TuxMenuBar
In-window File / Edit / View / Help menu strip for Windows / Linux Tauri shells. Skipped on Mac (system menu wins).
wraps tux native (neighborhood grid)
TuxMetroInset
Neighborhood-grid inset for a single metro, intended for 4-up side-by-side layouts (Houston · DFW · Austin · San Antonio).
wraps tux native (CSS)
TuxMobileFrame
Stylized device chrome for screenshots — iOS (iPhone) or Android (Pixel) via platform prop. Doc-only marketing helper.
wraps UModal
TuxModal
UModal with editorial rhythm — optional eyebrow, gold-bar underlined title.
wraps tux native
TuxNewsCollection
News article list — date + thumbnail + headline + dek + read-more, stacked or grid.
wraps tux native
TuxPageContainer
Content-width primitive — default/wide/prose measures backed by --layout-* tokens; pairs with --tux-nav-height.
wraps tux native
TuxPageHeader
Eyebrow + gold-bar heading + subtitle — plain default, neutral or maroon panel, hero rhythm.
wraps tux native
TuxPagination
Page-number controls — squarified active page, ellipsis truncation, optional status line.
wraps tux native
TuxPaperMeta
Academic paper metadata block.
wraps tux native
TuxPhotoGrid
Uniform image grid — photo (full color, captioned) or logo wall (grayscale-on-hover).
wraps UPopover
TuxPopover
Richer-than-tooltip floating panel — title + body + actions. Maroon hairline rule under title. Click default; hover for read-only.
wraps tux native
TuxProgram
Research-program identity card.
wraps tux native
TuxProse
Typographic shell for long-form markdown — H1/H2/H3/p/list/code/table/blockquote rhythm in one wrapper.
wraps tux native
TuxQACollection
Long-form Q&A — always expanded, designed to be read top-to-bottom (companion to TuxAccordion).
wraps tux (no U-primitive)
TuxRailNav
Collapsible sidebar/rail navigation — native <details> disclosure groups (accessible without roleless aria-expanded), icon-only collapsed mode. tux-owned replacement for UNavigationMenu in app shells.
wraps tux native
TuxReactionBar
Light-touch helpful/question/disagree row. Lower friction than a feedback form; counts display-only.
wraps tux native
TuxRemovableChip
Interactive dismissible chip — leading icon, three sizes, removable × or click-to-remove whole pill. Distinct from TuxBadge (decorative).
wraps tux native
TuxReportFrame
Page-sized canvas (letter / a4) for PDF + print. Stats, charts, prose go inside.
wraps useHead injection
TuxReportPrintSheet
Drop-in print stylesheet; hides chrome, paginates with data-print-break attrs.
wraps tux native
TuxReportWebFrame
Long-form web-hosted narrative — cover, byline, lede, sticky TOC, body, footer.
wraps tux native
TuxResearcher
Researcher profile card.
wraps tux native
TuxResultCount
\"Showing 1–24 of 412 corridors · 24 per page\". Pairs with TuxPagination / TuxLoadMore / TuxInfiniteScroll.
wraps tux native
TuxRichDataGrid
Interactive data grid — sticky header, row selection, expandable detail, sort + filter chips, bulk-action bar. Landscape-class operational surfaces.
wraps Tiptap + lowlight
TuxRichTextEditor
Canonical WYSIWYG — Tiptap-based, 7 toolbar groups, tables, task lists, source-mode toggle, full-screen, syntax highlighting.
wraps tux native
TuxRuleBuilder
Relational query UI — field + operator + value rows, AND/OR groupers, nestable. Sister to faceted TuxFilterPanel.
wraps tux native
TuxSearch
Branded search bar — bordered input + uppercase action button. Regular / slim / focus state.
wraps tux native
TuxSectionHeader
Editorial section heading — ALL-CAPS, tracked-out, maroon underline.
wraps tux native (<dialog>)
TuxShortcutsHelp
Modal overlay listing every wired keyboard shortcut — combos vs sequences, opens on ?. Sibling to TuxCommandPalette.
wraps tux native
TuxSidebarBlock
Sidebar widget wrapper — eyebrow + maroon underline + content. Default/bordered/filled.
wraps tux native
TuxSignupFeature
Newsletter signup — email input + uppercase action + consent. Three tones, three style variants.
wraps tux native
TuxSiteNav
Top-bar with TuxIdentity + utility nav + primary nav. Hosts TuxDropdown / TuxMegaMenu items.
wraps tux native
TuxSkeleton
Loading-state placeholder — primitive shapes + 6 composed presets. Honors prefers-reduced-motion.
wraps tux native
TuxSlideover
Edge-anchored drawer — row detail, filter panel, mobile nav, action sheet. Right/left/bottom anchors, native <dialog>.
wraps tux native (inline SVG)
TuxSparkline
Inline mini trend line — no axes, optional area fill, last-point dot, delta arrow. Native SVG.
wraps tux native
TuxSplashScreen
Branded app-launch overlay — brand mark + maroon hairline + status. Bridges Tauri window-show → Vue hydrate gap. Fades when loaded.
wraps tux native
TuxSplitPane
In-page master-detail layout — resizable list + detail + optional bottom pane. Width persists via localStorage. URL-bound selection.
wraps tux native
TuxStatComparison
Before/after stat block with delta + tone. Direct or inverted polarity (down-is-good metrics). Row / stack / inline layouts.
wraps tux native (useTuxToast bus)
TuxStatusToast
Transient-notification host + useTuxToast() bus — polite live region, sticky errors, reduced-motion aware, Tauri OS-notification escalation.
wraps tux native
TuxStepper
Numbered-circle multi-step indicator — funding application, IRB submission, study onboarding.
wraps tux native
TuxSuggestionChips
Horizontal row of clickable prompt-suggestion chips. Empty-state composer or post-response follow-ups.
wraps tux native
TuxTOC
Article table-of-contents — sticky right rail with IntersectionObserver-driven active state.
wraps tux native
TuxTabBar
Bottom-anchored 3-5 mobile tabs — icon + label, maroon top-edge active rule, safe-area-inset-bottom honored. Tauri Mobile target.
wraps UTable
TuxTable
UTable with tux chrome, automatic status-cell rendering via TuxBadge.
wraps composes TuxFigureCaption
TuxTableCaption
Auto-numbered caption for tables.
wraps UTabs
TuxTabs
Editorial tabs with maroon active underline. Horizontal + vertical orientations; `bold` intent for eyebrow-rhythm labels.
wraps tux native
TuxTeachingPopover
Onboarding/guided-tour tooltip — image, body, Next/Skip, step counter. On-brand variant for high emphasis.
wraps tux native
TuxTestimonial
Attributed quotes with portrait + name + role — grid or row layout, three style variants.
wraps UTooltip
TuxTooltip
Keyboard-accessible hover-help with optional title + hairline rule. Tuned max-width (~22ch).
wraps tux native
TuxTree
Hierarchical list — sitemap, corpus + filesystem browser, BI dataset explorer. Mono leaf labels, sand guide lines, persistence.
wraps tux native
TuxTreemap
Squarified hierarchical-size viz — Landscape's headline chart, drill-in, no external library.
wraps UDropdownMenu
TuxUserMenu
The suite's one identity affordance — cluster chip or rail-footer mount, state-complete (loading / signed-out / signed-in / local-only / error), law-fixed menu order.
wraps tux (composes TuxAppSwitcher + TuxUserMenu)
TuxUtilityCluster
The trailing app-control cluster — search · notifications · theme · waffle · identity in law-fixed DOM order. Registry-fed waffle + role=status theme announcements.
wraps tux native
TuxValidationSummary
Error list at the top of a long form.
wraps sandboxed <iframe> + poster fallback
TuxVizEmbed
Tableau / Power BI / Apache Superset / Grafana iframe wrapper with poster fallback.
wraps tux native (CSS Grid layout shell)
TuxVizGrid
Small-multiples layout primitive — 2/3/4-up panes with shared editorial header. Container-queried.
wraps <img> / <object> / <iframe>
TuxVizRPlot
R artifact wrapper — image / svg / htmlwidget — with source-line caption gutter.
wraps composable
useTuxPlatform
Host-OS + Tauri detection for platform-adaptive chrome.
wraps composable
useTuxRipple
Composable: Material-style tap-feedback ripple on a target element. Opt-in only; honors prefers-reduced-motion.
wraps composable
useTuxSwipe
Composable: pointer/touch swipe detection with directional callbacks. Requires a11y-pair button per platform-awareness doctrine.