beui library

beUI — a one-to-one Flutter port of beUI v2 motion components.

Single public entrypoint: import 'package:beui/beui.dart';. Components, theme, and motion tokens are re-exported here.

See docs/PORTING_SPEC.md for the catalog and conventions.

Classes

BeuiActionSwapButton: A button that cycles through items, swapping its label and icon with a BeuiActionSwapVariant transition on each tap — the Flutter port of the source's ActionSwapButton.
BeuiActionSwapIcon: Swaps a single icon with a BeuiActionSwapVariant transition — the Flutter port of the source's ActionSwapIcon. Icons are single elements, so BeuiActionSwapVariant.cascade collapses to BeuiActionSwapVariant.roll.
BeuiActionSwapItem: A single swappable action — the Flutter port of the source's ActionSwapItem.
BeuiActionSwapText: Swaps a single line of text with a BeuiActionSwapVariant transition, animating its width over ~220ms so the swap never snaps in size — the Flutter port of the source's ActionSwapText.
BeuiAdaptiveStepper: A bounded quantity control whose value surface expands into unavailable actions while preserving a fixed footprint.
BeuiAdaptiveStepperDecrement: The decrement action, labelled “Decrease value”.
BeuiAdaptiveStepperIncrement: The increment action, labelled “Increase value”.
BeuiAdaptiveStepperValue: The live value surface, which expands to occupy space freed by a bound.
BeuiAgentActivity: One adaptive activity stream for reasoning, searches, tool calls, structured execution traces, or a chronological mix — the Flutter port of beUI's agent-activity.
BeuiAgentActivityItem: One chronological entry in a BeuiAgentActivity stream (source AgentActivityItem).
BeuiAgentActivitySearch: A web-search activity row (source AgentActivitySearch).
BeuiAgentActivityStep: A checklist / reasoning step (source AgentActivityStep).
BeuiAgentActivityText: A freeform text line (source AgentActivityText).
BeuiAgentActivityTool: A tool-call activity row (source AgentActivityTool).
BeuiAgentActivityTrace: A structured execution-trace row (source AgentActivityTrace).
BeuiAgentIcons: Semantic icon slots for the agent family. Defaults are Lucide glyphs; consumers pass any IconData (Material, Cupertino, custom) — the package never requires a consumer icon font.
BeuiAgentLayout: Spacing, padding, and width behaviour for agent conversations.
BeuiAgentProgress: Compact activity glyph + verb + live timer — the Flutter port of beUI's AgentProgress.
BeuiAgentSearchResult: One result under a BeuiAgentActivitySearch (source AgentSearchResult).
BeuiAgentShapes: Corner radii for agent surfaces.
BeuiAgentStatusColors: A complete set of BeuiAgentStatusPalettes — one per BeuiAgentStatus — for a single Brightness.
BeuiAgentStatusPalette: The colors one BeuiAgentStatus paints with, in one Brightness.
BeuiAgentStrings: The copy every agent widget reads.
BeuiAgentStructure: Hairline borders, density-independent emphasis, and glass treatment.
BeuiAgentTheme: The resolved agent visual contract, installed as a ThemeExtension.
BeuiAgentTypography: Type roles used by agent widgets. Colors are applied by the widget from BeuiColors; these styles carry size, weight, height, and (for mono) family. Sans styles leave TextStyle.fontFamily unset so ThemeData.fontFamily inherits through.
BeuiAiSidebar: A collapsible AI workspace resource tree — the Flutter port of beUI's ai-sidebar.
BeuiAlert: An animated, composable inline feedback surface.
BeuiAlertAction: Layout container for optional alert actions.
BeuiAlertClose: Dismisses the enclosing alert; the default button is labelled for assistive technology and returns focus to BeuiAlert.returnFocus when supplied.
BeuiAlertContent: Flexible column for an alert's title, description, and actions.
BeuiAlertDescription: Supporting alert copy.
BeuiAlertIcon: The variant icon, cross-faded whenever the alert tone changes.
BeuiAlertTitle: Prominent alert heading.
BeuiAnimatedBadge: A status badge whose icon and color animate on status change, with an optional pulse — the Flutter port of beUI's AnimatedBadge.
BeuiAnimatedNumber: An in-view count-up number — the Flutter port of beUI's animated-number.
BeuiAnimatedSidebar: A composable application sidebar with morphing nested navigation that folds into an animated icon rail on desktop and becomes a focus-managed sheet on mobile — the Flutter port of beUI's animated-sidebar.
BeuiAnimatedSidebarGroup: A labeled section of items (source AnimatedSidebarGroup + AnimatedSidebarGroupLabel + AnimatedSidebarGroupContent).
BeuiAnimatedSidebarItem: One nav destination — leaf or parent with nested children.
BeuiAnimatedSidebarScope: Ambient expand / mobile-open state for BeuiAnimatedSidebarTrigger and nested chrome. Analog of the source AnimatedSidebarProvider context.
BeuiAnimatedSidebarTrigger: Icon button that toggles the nearest BeuiAnimatedSidebar (desktop expand or mobile sheet). Place it in the inset header.
BeuiAnimatedToastStack: A stacked toast list with status morphs, swipe dismissal and layout-aware motion — the Flutter port of beUI's AnimatedToastStack.
BeuiApprovalCard: A human-in-the-loop decision surface for approvals, single or multiple-choice questions, custom responses, and multi-step review flows — the Flutter port of beUI's approval-card.
BeuiApprovalCardAnswer: Answer payload for one BeuiApprovalCardQuestion — the Flutter port of the source's ApprovalCardAnswer.
BeuiApprovalCardOption: One selectable choice on a BeuiApprovalCardQuestion — the Flutter port of the source's ApprovalCardOption.
BeuiApprovalCardQuestion: One step in a multi-question BeuiApprovalCard — the Flutter port of the source's ApprovalCardQuestion.
BeuiArcPicker: A radial single-choice picker with drag momentum and keyboard controls.
BeuiArcPickerOption: One choice in a BeuiArcPicker.
BeuiAspectRatio: A responsive frame whose width-to-height ratio can morph with a spring.
BeuiAspectRatioImage: An image that fills and cover-crops its enclosing BeuiAspectRatio.
BeuiAttachmentUpload: A mixed attachment workspace — files, links, images and audio in one list — with a dropzone, staggered row arrival, per-row upload wash, retry, pending removal, an audio waveform with a play/pause toggle, and a shared-layout image preview. The Flutter port of beUI's AttachmentUpload block (the second of the two patterns on blocks/file-upload; the first is BeuiFileUpload).
BeuiAttachmentUploadController: Imperative handle for feeding picked attachments into a BeuiAttachmentUpload.
BeuiAttachmentUploadItem: One attachment row (source AttachmentUploadItem).
BeuiAvailabilityScheduler: A weekly availability scheduler — the Flutter port of beUI's availability-scheduler block.
BeuiBloomMenu: A "Create" pill that blooms open into a grid menu — the Flutter port of beUI's bloom-menu block.
BeuiBloomMenuItem: One entry in a BeuiBloomMenu grid (source MenuItem).
BeuiBottomSheet: A draggable bottom sheet with snap points — the Flutter port of beUI's bottom-sheet, built on BeuiOverlay.
BeuiBounceSidebar: A vertical sidebar whose active dot jumps between destinations on a curved, spring-loaded path — the Flutter port of beUI's bounce-sidebar.
BeuiBounceSidebarItem: One destination in a BeuiBounceSidebar.
BeuiBouncyAccordion: A single-open accordion whose panels spring open by morphing height with a soft, weighted bounce, while the chevron rotates — the Flutter port of beUI's bouncy-accordion.
BeuiBouncyAccordionItem: One row of a BeuiBouncyAccordion.
BeuiBracketRound: One ordered round of the bracket — the Flutter port of the source Round.
BeuiBreadcrumb: A labelled navigation landmark for a path of BeuiBreadcrumbItems.
BeuiBreadcrumbEllipsis: A hoverable and keyboard-operable disclosure for hidden ancestor segments.
BeuiBreadcrumbItem: One path segment. Use stable keys when replacing route segments.
BeuiBreadcrumbLink: An ancestor path segment. onPressed may update the current path.
BeuiBreadcrumbList: A wrapping path. Set maxItems to collapse middle items into an ellipsis.
BeuiBreadcrumbPage: The current path segment, announced as the current page.
BeuiBreadcrumbSeparator: A decorative path divider, hidden from semantics.
BeuiBubbleSlider: A slider with a velocity-reactive value bubble — a one-to-one port of beUI's range-slider-bubble.
BeuiBumpChart: Ranking chart with a curved plot, interactive dots and legend.
BeuiBumpLegend: Toggleable series legend.
BeuiBumpPlot: Curved rank paths and a dot for each observed rank.
BeuiBumpSeries: A series of ranks, one per period. Null values leave gaps in its path.
BeuiButton: A spring-pressed button — the Flutter port of beUI's base Button.
BeuiCandle: One OHLC observation. time is the display label used by the crosshair.
BeuiCandlestickChart: Composable candlestick chart root.
BeuiCandlestickLegend: Displays the active candle OHLC and volume values.
BeuiCandlestickPlot: Interactive candlestick plot with volume bars and a keyboard crosshair.
BeuiCard: A composable card surface. It is not focusable or independently actionable; place the owning button, link, checkbox, or radio inside it. selected changes only its visual ring.
BeuiCardAction: Trailing action placement for a card header.
BeuiCardContent: Main content area, inset to align with the card header and footer.
BeuiCardDescription: Supporting copy for a card heading.
BeuiCardFolder: A payment card tucked into an animated purse pocket.
BeuiCardFooter: Footer row, inset to align with the card's other parts.
BeuiCardHeader: Header row area. Its horizontal inset follows the enclosing card's size.
BeuiCardTarget: Use as the last child of a Stack that fills a card to stretch a control's hit area over that stack. Keep any other card actions above it in z-order. For a simpler layout, make the control itself fill the card with an InkWell (or another full-size gesture widget).
BeuiCardTitle: A card title, optionally rendered as a semantic heading.
BeuiCenterMorphModal: A modal whose full-size surface unfolds outward from its exact center toward every edge, then folds back the same way with an inset close control — the Flutter port of beUI's center-morph-modal, built on BeuiOverlay.
BeuiChain: A chain in a BeuiMultiChainSwap (source Chain).
BeuiChartFade: Opacity-only fade (kept under reduced motion).
BeuiChartFrame: Column of chart parts with an accessible name. Default space-y-3/4.
BeuiChartLegend: Horizontal wrap of legend items. Each child is typically a button.
BeuiChartLegendItem: A single legend entry: swatch + label (+ optional trailing value).
BeuiChartSpring: Springs value on beuiSpringLayout. Reduced motion snaps to the target.
BeuiChartSpringRect: Springs a Rect on beuiSpringLayout. Reduced motion snaps to the target.
BeuiChartSwatch: A compact color swatch used by chart legends.
BeuiChartTicker: Chart tooltip / readout number — source NumberTicker with startOnView={false}, duration={0.2}, stagger={0}.
BeuiChartTooltip: Tooltip surface used by charts that need a custom body. Built on BeuiTooltip so it shares the overlay, spring, and reduced-motion path.
BeuiChartTooltipCard: Standard tooltip card: title + muted lines.
BeuiChatApp: A complete agent conversation workspace shell — the Flutter port of beUI's chat-app.
BeuiCheckbox: A checkbox with an animated check/indeterminate draw — the Flutter port of beUI's checkbox.
BeuiCheckboxStyle: Optional style overrides for BeuiCheckbox. Null fields resolve from the ambient BeuiColors theme extension (or sensible defaults).
BeuiChromaticTextReveal: A fixed prefix followed by cycling words, each painted in by a moving chromatic edge — the Flutter port of beUI's chromatic-text-reveal.
BeuiCitation: Inline citation marker that jumps to the matching reference in a BeuiCitationList / BeuiCitations (source Citation).
BeuiCitationFavicon: Leading favicon for a citation row / stack, falling back to a globe glyph when the URL is missing or the image fails (source CitationFavicon).
BeuiCitationItem: One citation / source reference — the Flutter port of the source's CitationItem.
BeuiCitationList: Progressively rendered citation rows with enter opacity + y spring (source CitationList). New items animate in as the list grows.
BeuiCitations: Collapsible, progressively rendered reference collection for grounded agent responses — the Flutter port of beUI's citations.
BeuiCitationStack: Overlapping favicon stack used as a compact source summary (source CitationStack). Defaults to the first 3 items.
BeuiCodeBlock: A syntax-highlighted code surface with stable streaming updates, line numbers, focused lines, smooth following, and copy feedback — the Flutter port of beUI's agent CodeBlock.
BeuiCollapsible: A composable disclosure with measured, spring-driven content height.
BeuiCollapsibleContent: Measured content for a BeuiCollapsible, hidden from focus and semantics while closed.
BeuiCollapsibleIndicator: A chevron that rotates with its enclosing BeuiCollapsible.
BeuiCollapsibleTrigger: An accessible button that toggles its enclosing BeuiCollapsible.
BeuiColorPicker: Composable color picker with optional anchored trigger and floating panel.
BeuiColorPickerAlpha: Alpha slider, hidden when alpha is disabled on the root.
BeuiColorPickerArea: Saturation/value 2D control with arrow-key operation.
BeuiColorPickerChannels: RGB or HSL channel editors.
BeuiColorPickerContent: Container marker for composing the picker body. In Flutter, provide its child as BeuiColorPicker.child.
BeuiColorPickerEyeDropper: Eye-dropper action. Flutter platforms do not expose a screen sampling API; this control intentionally does nothing and remains available to compose.
BeuiColorPickerHex: Editable CSS hex text field; commits valid colors on Enter or focus loss.
BeuiColorPickerHue: Hue slider.
BeuiColorPickerPreset: Applies one preset color.
BeuiColorPickerPresetItem: One named color swatch for BeuiColorPickerPresets.
BeuiColorPickerPresets: Preset swatch row.
BeuiColorPickerSwatch: Live color swatch displaying the current selection.
BeuiColorPickerTrigger: Default trigger swatch that toggles the anchored dialog.
BeuiColors: The resolved beUI palette for one colorTheme × brightness combination, exposed to the widget tree as a ThemeExtension.
BeuiColorSelector: A composable color radio group with a shared, spring-gliding selection ring.
BeuiColorSelectorItem: An accessible radio choice displaying a color swatch.
BeuiColorSelectorLabel: Group label, rendered with Flutter's fieldset-equivalent Semantics label.
BeuiColorSelectorList: Horizontal, wrapping list of color choices.
BeuiCombobox: Searchable, grouped picker with a morphing anchored panel.
BeuiComboboxContent: Portal content wrapper. side, align, sideOffset, and collision avoidance are source-compatible placement controls.
BeuiComboboxEmpty: Empty-results announcement.
BeuiComboboxGroup: Group wrapper for related options.
BeuiComboboxInput: Search input; focus stays here while Arrow keys move the active option.
BeuiComboboxItem: One selectable option.
BeuiComboboxLabel: Group heading.
BeuiComboboxList: Scrollable listbox for BeuiComboboxItems.
BeuiComboboxSeparator: Visual separator between groups.
BeuiComboboxTrigger: Trigger layout for a combobox. Tapping it opens and focuses the input.
BeuiComboboxValue: Displays the selected label or placeholder.
BeuiCommandItem: One command in a BeuiCommandPalette (source CommandItem).
BeuiCommandPalette: A ⌘K command palette: fuzzy filter, grouped results, spring-gliding active row — the Flutter port of beUI's CommandPalette, built on BeuiOverlay.
BeuiCompositionChart: Interactive 100% stacked chart, or a scope for its chart parts.
BeuiCompositionColumn: A period and its valid normalized column.
BeuiCompositionLegend: Interactive series legend with a pinned state exposed to semantics.
BeuiCompositionPlot: Stacked bars or areas with a keyboard-adjustable period range.
BeuiCompositionSegment: One period's series shares and stack offsets.
BeuiCompositionSeries: A series aligned with the chart's period list.
BeuiContextMenu: A pointer-origin context menu — the Flutter port of beUI's context-menu.
BeuiContextMenuItem: One row in a BeuiContextMenu — action, checkbox, radio, label, or separator.
BeuiCylinderCarousel: A 3D cylinder carousel — the Flutter port of beUI's cylinder-carousel.
BeuiDateRange: A calendar date range. Dates are ISO-8601 calendar strings (YYYY-MM-DD) so selecting a day never depends on the device's time zone.
BeuiDateRangePicker: Composable date-range calendar, either inline or anchored to a popover.
BeuiDateRangePickerCalendar: Calendar surface. By default it includes the summary, header, grid, and footer.
BeuiDateRangePickerClear: Clears the currently selected range.
BeuiDateRangePickerContent: Floating panel part for a trigger-based date-range picker.
BeuiDateRangePickerDropdown: Convenience trigger + popover composition.
BeuiDateRangePickerFooter: Footer containing selection status, clear control, and configured presets.
BeuiDateRangePickerGrid: Six-week date grid with roving focus and full calendar key navigation.
BeuiDateRangePickerHeader: Month/year navigation header with direct month and year choices.
BeuiDateRangePickerPreset: Selects one configured date-range preset.
BeuiDateRangePickerPresets: Configured quick-select ranges for a custom calendar composition.
BeuiDateRangePickerSelection: Selection status text for the footer or a custom calendar composition.
BeuiDateRangePickerSummary: Accessible range summary shown above the calendar grid.
BeuiDateRangePickerTrigger: Button that opens the date-range popover.
BeuiDateRangePreset: A named quick-select range for BeuiDateRangePicker.
BeuiDayAvailability: One day's availability (source DayAvailability): whether the day is enabled and its list of ranges.
BeuiDigitSwap: Fixed-slot digits and mask glyphs that roll on change — the Flutter port of beUI's digit-swap.
BeuiDock: A dock — the Flutter port of beUI's dock.
BeuiDockItem: One entry in a BeuiDock — an action, or a BeuiDockItem.separator.
BeuiDonutCenter: Center live region showing the total or active segment.
BeuiDonutChart: Composable donut chart root.
BeuiDonutLegend: Interactive legend buttons with arrow-key navigation.
BeuiDonutPlot: Ring plot with an optional center overlay.
BeuiDonutSegment: A labeled donut slice.
BeuiDrawer: An edge drawer — the Flutter port of beUI's drawer, built on BeuiOverlay.
BeuiDynamicIsland: iOS-style Dynamic Island: a pill that springs open into live-activity views — the Flutter port of beUI's DynamicIsland.
BeuiDynamicIslandView: One expandable view of a BeuiDynamicIsland (source DynamicIslandView).
BeuiExpandableActionBar: A pill rail of icon actions that unfurl labels on hover/focus, with a highlight that glides between items — the Flutter port of beUI's ExpandableActionBar.
BeuiExpandableActionBarItem: One action in a BeuiExpandableActionBar (source ExpandableActionBarItem).
BeuiExpandableButton: Click-to-expand icon button that reveals label.
BeuiExpandableChip: Label button that reveals a trailing action button when expanded.
BeuiExpandableTabs: An icon tab bar whose active tab expands into a labeled pill while the shell springs open around the tab's panel — the Flutter port of beUI's ExpandableTabs.
BeuiExpandableTabsItem: One tab of a BeuiExpandableTabs bar (source ExpandableTabsItem).
BeuiExpandingArrowButton: An accent tile that expands into a dotted-arrow trail on hover or focus — the Flutter port of beUI's ExpandingArrowButton.
BeuiFeedbackData: The payload handed to BeuiFeedbackWidget.onSubmit — the port of the source FeedbackData interface.
BeuiFeedbackWidget: A corner-anchored feedback capsule that morphs from a circular trigger into a form panel, then celebrates on success — the Flutter port of beUI's feedback-widget.
BeuiFeedbackWidgetStyle: Optional visual overrides for BeuiFeedbackWidget. Null fields resolve from the ambient BeuiColors theme extension (or sensible defaults).
BeuiFileDiff: A syntax-highlighted file change disclosure with progressive rows, dual line numbers, live change counts, smooth following while streaming, and optional collapse on complete — the Flutter port of beUI's agent file-diff.
BeuiFileDiffHunkGap: A gap between two rendered rows — unchanged lines the consumer did not send.
BeuiFileDiffLine: One row of a BeuiFileDiff — the Flutter port of the source's FileDiffLine.
BeuiFileTree: A nested, keyboard-navigable file explorer with animated folder branches.
BeuiFileTreeFile: A declarative file in a BeuiFileTree. It is rendered by its parent tree.
BeuiFileTreeFolder: A declarative folder in a BeuiFileTree. It is rendered by its parent tree.
BeuiFileUpload: An upload queue with a dropzone, progress rows, retry/remove — the Flutter port of beUI's FileUpload block.
BeuiFileUploadItem: One queued file (source FileUploadItem).
BeuiFluidSlider: A thumbless slider — a one-to-one port of beUI's range-slider-fluid.
BeuiFunnelChart: Curved conversion funnel, with stage inspection and summary.
BeuiFunnelPlot: Curved funnel stages rendered as accessible buttons.
BeuiFunnelStage: One funnel stage.
BeuiFunnelSummary: Overall conversion summary for the funnel.
BeuiGlass: A frosted-glass surface descriptor — the source glass / glass-strong / glass-thin tiers grouped so overlay components read one cohesive surface.
BeuiHeatCalendar: Composable daily activity grid. Intensities are clamped to 0–1.
BeuiHeatCalendarCell: A zero-based week/day coordinate (Monday is day zero).
BeuiHeatCalendarGrid: Month headings and the Monday-first heat cells.
BeuiHeatCalendarLegend: Legend levels, which also filter cells on activation.
BeuiHeatCalendarSelection: A selected heat-calendar span. An omitted end is an anchored preview.
BeuiHeatCalendarTooltip: Tooltip composition slot; cell tooltips are anchored to selected cells.
BeuiHoldActionButton: Hold-to-confirm CTA with a liquid fill — port of HoldActionButton.
BeuiHsva: HSVA color value: hue in 0–360, saturation/value in 0–100, alpha in 0–1.
BeuiImageGeneration: A stable generated-image surface that moves from queued work through progressive refinement to a completed result without layout shift — the Flutter port of beUI's image-generation.
BeuiImageViewer: Composable photo gallery and modal image viewer.
BeuiImageViewerCaption: Caption for the selected image; defaults to its caption and then alt text.
BeuiImageViewerClose: Dismisses the lightbox.
BeuiImageViewerContent: Modal image surface, rendered through BeuiOverlay.
BeuiImageViewerCounter: Counter showing the selected image index and total.
BeuiImageViewerGallery: Gallery layout for BeuiImageViewerThumbnail children.
BeuiImageViewerImage: A gallery image and the content rendered for it in both gallery and viewer.
BeuiImageViewerNext: Selects the next image.
BeuiImageViewerPrevious: Selects the previous image.
BeuiImageViewerThumbnail: A button that opens the corresponding image in the lightbox.
BeuiInfiniteMasonry<T>: A columned, infinite-scroll masonry feed — the Flutter port of beUI's infinite-masonry block.
BeuiInlineSlider: An inset-fill slider with an inline label and value — the Flutter port of beUI's range-slider-inline.
BeuiInput: A pill text field with animated focus, error and success states — the Flutter port of beUI's input.
BeuiInputStyle: Optional style overrides for BeuiInput. Null fields resolve from the ambient BeuiColors theme extension (or sensible defaults). Mirrors the source's classNames slot map (root / label / field / input / icons / message) with typed fields rather than class strings.
BeuiKnockoutBracket: A tournament knockout bracket that pages between rounds — the Flutter port of beUI's knockout-bracket.
BeuiKnockoutWheel: A tournament drawn radially — the Flutter port of beUI's knockout-wheel, the second fixture style on the source's knockout-bracket page.
BeuiLiquidityHeatmap: Animated liquidity bands across price and time.
BeuiLiquidityLegend: Color scale for resting liquidity.
BeuiLiquidityLevel: Liquidity at one discrete price band.
BeuiLiquidityPlot: Accessible grid of price bands with an optional market-price trace.
BeuiLiquiditySnapshot: One time-ordered order-book observation.
BeuiLoader: A continuously looping loading indicator — the Flutter port of beUI's loader, with all 17 source variants selectable via BeuiLoaderVariant.
BeuiMagnetic: Wraps child so it is magnetically pulled toward the cursor — the Flutter port of beUI's Magnetic.
BeuiMagneticButton: A BeuiButton wrapped in BeuiMagnetic — the Flutter port of beUI's MagneticButton. The button is pulled toward the cursor on hover-capable pointers; on touch / reduced motion it is a plain button.
BeuiMarquee: An infinitely scrolling marquee — the Flutter port of beUI's marquee.
BeuiMatch: A single fixture — the Flutter port of the source Match.
BeuiMatchSide: One side of a BeuiMatch — the Flutter port of the source MatchSide.
BeuiMessage: A single conversation row — the Flutter port of beUI's Message.
BeuiMessageAvatar: Circular 28px avatar slot for a BeuiMessage row (source MessageAvatar).
BeuiMessageBubble: A conversational surface with visual tones, independent alignment, grouped messages, expandable content, and interactive link/button support — the Flutter port of beUI's MessageBubble.
BeuiMessageBubbleCollapsible: Expandable long content inside a bubble (source MessageBubbleCollapsible).
BeuiMessageBubbleContent: Styled bubble body with the animated surface layer (source MessageBubbleContent).
BeuiMessageBubbleGroup: Vertical stack of bubbles inside one message (source MessageBubbleGroup).
BeuiMessageContent: Main content column of a BeuiMessage (source MessageContent).
BeuiMessageFooter: Metadata row below the bubble (source MessageFooter) — "Sent", actions.
BeuiMessageGroup: A vertical stack of BeuiMessage rows (source MessageGroup).
BeuiMessageHeader: Metadata row above the bubble (source MessageHeader) — name, timestamp.
BeuiMessageMarker: Centered system/live marker chip between rows (source MessageMarker) — "Today", "New messages", etc.
BeuiMessageScope: Ambient author of the surrounding BeuiMessage row.
BeuiMessageScroller: A reader-aware conversation viewport that follows streamed output at the live edge and releases control when the reader scrolls away — the Flutter port of beUI's MessageScroller.
BeuiMessageScrollerAnchor: Marks a descendant of BeuiMessageScroller as a navigable message for the optional rail and for scroll-to.
BeuiMessageScrollerRailItem: One navigable entry for the optional message rail (source rail items derived from [data-slot="message"] rows).
BeuiMessageScrollerState: Public state so tests and hosts can call scrollToEnd / scrollToId and read isFollowing.
BeuiMessageSideScope: Ambient message side — "start" / "end" — consumed by BeuiMessageBubble when its own align is omitted.
BeuiMessageTyping: Three bouncing dots indicating an in-progress response (source MessageTyping).
BeuiMetallicButton: A neutral button framed by a chrome rim with a traveling reflection — the Flutter port of beUI's MetallicButton.
BeuiMorphingModal: A modal whose panel morphs height between inner views, with a per-view blur cross-fade — the Flutter port of beUI's morphing-modal, built on BeuiOverlay.
BeuiMorphingSearch: A search field or compact icon that opens a keyboard-navigable result panel.
BeuiMorphingSearchChips: A docked search field with removable filters and recent/suggested terms.
BeuiMorphingSearchItem: A searchable entry shown by BeuiMorphingSearch.
BeuiMorphingTabs: Reorderable tabs whose selected item joins the panel below it.
BeuiMorphingTabsItem: An item displayed by BeuiMorphingTabs.
BeuiMorphPopover: A popover whose panel morphs open from the trigger corner — the Flutter port of beUI's popover-morph (the morph variant of popover).
BeuiMorphSelect: A select whose trigger morphs into the panel — instead of a detached dropdown, the trigger box itself grows down into the menu and shrinks back, one continuous surface. The Flutter port of beUI's select-morph.
BeuiMultiChainSwap: A cross-chain swap widget: chain/token selectors, live quoting shimmer, flip, destination address, and an in-card token-picker sheet — the Flutter port of beUI's MultiChainSwap block.
BeuiMultiSelect: Searchable multi-select with removable tokens and an anchored option panel.
BeuiMultiSelectContent: Anchored options panel. This widget is provided by the root overlay.
BeuiMultiSelectInput: Search input with combobox semantics and keyboard interaction.
BeuiMultiSelectItem: Selectable row used by BeuiMultiSelectList.
BeuiMultiSelectList: Scrollable, multi-select option list.
BeuiMultiSelectOption: One option displayed by BeuiMultiSelect.
BeuiMultiSelectTrigger: Trigger surface for a BeuiMultiSelect.
BeuiMultiSelectValue: Selected values rendered as removable chips inside BeuiMultiSelectTrigger.
BeuiNotFoundGlitch: 404 with a character scramble on mount and chromatic ghost layers on hover — the Flutter port of the source NotFoundGlitch.
BeuiNotFoundMagnetic: 404 whose glyphs are cursor-attracted BeuiMagnetic wrappers — the Flutter port of the source NotFoundMagnetic.
BeuiNotFoundSpotlight: 404 revealed by a cursor spotlight over a dark panel — the Flutter port of the source NotFoundSpotlight.
BeuiNotFoundStacked: 404 card that fans out of a deck on hover — the Flutter port of the source NotFoundStacked (SPRING_PANEL throughout).
BeuiNotFoundTerminal: 404 typed out in a terminal window — the Flutter port of the source NotFoundTerminal, composed from BeuiTextReveal.
BeuiNotificationStack: A single collapsible stacked-notification "inbox" card — the Flutter port of beUI's NotificationStack.
BeuiNotificationStackItem: One notification in a BeuiNotificationStack — the Flutter port of the source's NotificationStackItem.
BeuiNumberTicker: A slot-machine number — the Flutter port of beUI's number-ticker.
BeuiOrderBook: Aggregated bids and asks with spread, depth, and balance summaries.
BeuiOrderBookActiveLevel: Currently inspected side and price.
BeuiOrderBookBalance: Proportion of visible depth on each side.
BeuiOrderBookDepthLevel: Aggregated depth row with cumulative size.
BeuiOrderBookDepthSummary: Polite readout for the inspected range of depth.
BeuiOrderBookDepthSummaryData: Aggregated totals for an inspected depth range.
BeuiOrderBookHeader: Column labels for price, size, and cumulative total.
BeuiOrderBookLevel: An order-book price level.
BeuiOrderBookSide: Accessible rows for one side of the book.
BeuiOrderBookSpread: Reference price and best-level spread.
BeuiOtpInput: One-time-passcode input with a gliding caret, roll-in digits, error shake and success check draw — the Flutter port of beUI's OTPInput.
BeuiOverflowActionItem: One action in a BeuiOverflowActions rail (source OverflowActionItem).
BeuiOverflowActions: A connected pill rail that springs open to reveal extra controls — the Flutter port of beUI's OverflowActions.
BeuiOverlay: The shared overlay foundation for beUI — the single seam every floating surface (tooltip, drawer, bottom-sheet, modal, command-palette, create-menu) is built on. The Flutter port of the source's createPortal / fixed-overlay pattern.
BeuiParallax: Drifts its child against the scroll as it crosses the viewport — the Flutter port of beUI's Parallax.
BeuiPopover: A popover whose panel oozes out of the trigger like liquid — the Flutter port of beUI's popover (gooey variant).
BeuiPredictionMarket: A prediction-market trade ticket: buy/sell modes, outcome prices, a rolling amount entry, quote footer with a ticking payout, and a stateful trade button — the Flutter port of beUI's PredictionMarket block, composed from BeuiStatefulButton and BeuiNumberTicker.
BeuiPredictionMarketCard: Compact market listing with outcomes, trade odds, volume and bookmarking.
BeuiPredictionMarketCardOutcome: One possible outcome in a BeuiPredictionMarketCard.
BeuiPredictionMarketCardSelection: The outcome and side chosen from a market card.
BeuiPredictionMarketOrder: The ticket's order state (source PredictionMarketOrderValue).
BeuiPredictionMarketOutcome: One tradable outcome (source PredictionMarketOutcome).
BeuiPredictionMarketQuote: Derived pricing for the current order (source PredictionMarketQuote).
BeuiPreviewRail: An equalizer-style navigation rail whose tick nearest the pointer magnifies and whose preview card glides to track it — the Flutter port of beUI's preview-rail.
BeuiPreviewRailItem: One entry in a BeuiPreviewRail.
BeuiPreviewRailStyle: Optional visual overrides for BeuiPreviewRail. Null fields resolve from the ambient BeuiColors theme extension (or sensible defaults). Mirrors the source's railClassName / previewClassName slots with typed fields.
BeuiPriceHistoryPoint: One dated historical price point.
BeuiPriceTarget: One analyst price target.
BeuiPriceTargetAxes: Axis and gridline layer.
BeuiPriceTargetCursor: Active history cursor and highlight.
BeuiPriceTargetDates: Optional labels for the start, midpoint and projection horizon.
BeuiPriceTargetFan: Data and interaction owner for a composable price-target fan.
BeuiPriceTargetFanActive: Active point in the history series or a selected analyst target.
BeuiPriceTargetHeader: Active projection price, signed change, and target caption.
BeuiPriceTargetHistory: Historical line layer.
BeuiPriceTargetHistoryPoints: Hoverable and keyboard-focusable history point hit targets.
BeuiPriceTargetNow: Current-price guide.
BeuiPriceTargetPlot: Fixed 520×236 plot host.
BeuiPriceTargetSvg: Layered price-target plot surface.
BeuiPriceTargetTargets: Forecast fan and keyboardable target choices.
BeuiPriceTargetTooltip: Floating readout anchored to the active history or target coordinate.
BeuiProjectFolder: A folder card that fans out previews and opens them in a modal grid.
BeuiProjectFolderPreview: One preview shown in a BeuiProjectFolder.
BeuiPromptAction: One entry in the BeuiPromptInput actions popover (attach image, skill…).
BeuiPromptAttachment: One attachment riding along with the prompt, shown as a chip above the field.
BeuiPromptInput: An auto-growing agent composer with prompt actions, model selection, keyboard submission, and animated send/stop states — the Flutter port of beUI's prompt-input.
BeuiPromptModel: One model option in a BeuiPromptInput picker.
BeuiPromptSubmission: Everything a submit carries: the trimmed prompt, the selected model, and any attachments.
BeuiPullToRefresh: Native-feeling pull-to-refresh container with drag resistance, threshold feedback and async refresh handling — the Flutter port of beUI's pull-to-refresh.
BeuiRadioGroup<T>: A radio group with a single selection dot that glides between items — the Flutter port of beUI's radio.
BeuiRadioItem<T>: A single radio option. Renders its ring + press feedback; the selection dot is supplied by the enclosing BeuiRadioGroup.
BeuiRangeSlider: A single-thumb slider — a one-to-one port of beUI's range-slider.
BeuiReasoningText: Cycling reasoning phrases with shimmer — the Flutter port of beUI's ReasoningText.
BeuiReturnsCalendar: Calendar of monthly investment returns, with compounded year totals.
BeuiReturnsCalendarCell: Row and month coordinate. Month 12 denotes the annual total.
BeuiReturnsCalendarGrid: Month cells and compounded year totals.
BeuiReturnsCalendarSelection: A selected row-major span of monthly or annual cells.
BeuiReturnsCalendarTooltip: Tooltip composition slot. Tooltips are hosted by individual month cells.
BeuiRulerSlider: A ruler slider — a one-to-one port of beUI's range-slider-ruler.
BeuiSankeyActive: A highlighted node or flow. Only one of node and link is populated.
BeuiSankeyActiveLink: A flow inspection.
BeuiSankeyActiveNode: A node inspection.
BeuiSankeyChart: Weighted flows laid out in columns from sources to outcomes.
BeuiSankeyChartModel: Chart context for custom composed parts. Read it during build.
BeuiSankeyChartPlot: A measured, horizontally scrollable Sankey plot with native focus targets.
BeuiSankeyChartTooltip: Cursor-following readout for the highlighted node or flow.
BeuiSankeyData: Cleaned, acyclic graph, independent of plot measurement.
BeuiSankeyLayout: Measured Sankey layout in keyboard reading order.
BeuiSankeyLink: Weighted directed flow between node ids.
BeuiSankeyNode: A named Sankey node. Repeated ids keep the first node.
BeuiSankeyPlacedLink: Flow geometry. Stroke path at width, with a source-to-target gradient.
BeuiSankeyPlacedNode: Node after value scaling, column assignment and six relaxation passes.
BeuiScrollProgress: A scroll progress indicator — bar or circular ring — the Flutter port of beUI's ScrollProgress.
BeuiScrollReveal: Reveals its child when scrolled into view: fade + rise + blur settling on EASE_OUT — the Flutter port of beUI's ScrollReveal.
BeuiScrollTo: A tappable wrapper that glides the page to a target — the Flutter port of beUI's ScrollTo button.
BeuiSelect: A dropdown select whose panel unfolds out of the trigger — the Flutter port of beUI's select (the gooey/accordion variant), built on BeuiOverlay and anchored to the trigger with a LayerLink + CompositedTransformFollower, the same overlay pattern as BeuiTooltip.
BeuiSelectOption: One selectable option in a BeuiSelect / BeuiMorphSelect.
BeuiShaderBackground: A full-bleed animated GPU shader background — the Flutter port of beUI's shader-background, backed by fragment shaders ported from @paper-design/shaders.
BeuiSharedLayoutBg: A vertical list whose hover highlight is a single pill that glides between rows — the Flutter port of beUI's shared-layout-bg.
BeuiSidebarResource: One node in a BeuiAiSidebar resource tree — the Flutter port of SidebarResource.
BeuiSidebarResourceMenuControls: Menu callbacks handed to BeuiAiSidebar.menuBuilder — source SidebarResourceMenuControls.
BeuiSidebarResourceMove: A request to relocate itemId relative to targetId — source SidebarResourceMove.
BeuiSignUpErrors
BeuiSignUpForm
BeuiSignUpValues
BeuiSlideActionButton: Drag-the-thumb-to-confirm control — port of SlideActionButton.
BeuiSmoothScroll: Provider that tracks the nearest descendant scrollable and exposes the shared scroll state — the Flutter port of the source SmoothScroll (Lenis provider).
BeuiSmoothScrollApi: The smooth-scroll state shared by the scroll-animation group — the Flutter port of the source's SmoothScrollApi (Lenis provider + hook).
BeuiSortableList<T extends Object>: A sortable, accessible list with controlled or internal ordering and undo.
BeuiSortableListGroup: Ordered group. Keep headings and undo controls outside children.
BeuiSortableListHandle: Keyboard- and pointer-accessible reorder grip.
BeuiSortableListItem: One row. Its id must refer to an item in the root list.
BeuiSortableListItemContent: Flexible row-content slot.
BeuiSortableListUndo: Restores the last valid order. It is disabled until a move has occurred.
BeuiSortState: The active sort — a column key and its direction (source SortState).
BeuiStatefulButton: A BeuiButton that morphs between idle / loading / success / error — the Flutter port of beUI's StatefulButton.
BeuiStatusBar: Complete animated status history, or a scope for custom chart parts.
BeuiStatusBarDatum: A period in a status history.
BeuiStatusBarLegend: Legend for statuses present in the configured status set.
BeuiStatusBarPlot: Rounded, staggered status segments with a range-based inspector.
BeuiStatusBarStatus: A status key, label, and color.
BeuiStatusBarTooltip: Tooltip slot; period detail is also available from each period's semantics.
BeuiStreamingResponse: A stable response surface with completion actions, rendered content, and an expandable source summary — the Flutter port of beUI's streaming-response.
BeuiSwipeableList: Rows that swipe left/right to reveal contextual actions — the Flutter port of beUI's SwipeableList.
BeuiSwipeableListItem: One row of a BeuiSwipeableList (source SwipeableListItem).
BeuiSwipeableListValue: The open row + side of a BeuiSwipeableList (source SwipeableListValue).
BeuiSwipeAction: One contextual action behind a row (source SwipeAction).
BeuiSwitch: A spring-driven toggle — the Flutter port of beUI's switch.
BeuiSwitchStyle: Optional style overrides for BeuiSwitch. Any field left null resolves from the ambient BeuiColors theme extension (or sensible defaults), so the common case needs no style at all. Mirrors the source's className-via-tokens approach within the port's "no arbitrary overrides" rule (see docs/PORTING_SPEC.md §6).
BeuiTab<T>: A single tab: a value, its label, optional icon, and optional content panel.
BeuiTable<T>: A virtualized, interactive data table — the Flutter port of beUI's table.
BeuiTableColumn<T>: A column definition — the Flutter port of the source TableColumn<T>.
BeuiTableIntrinsicSample: A passive copy of a sampled cell, or an explicit outer-width contract. Never pass a live editor or reuse a GlobalKey from the visible cell.
BeuiTabs<T>: Animated tabs with a gliding active indicator — the Flutter port of beUI's tabs (pill / segment / underline).
BeuiTeam: A competing team — the Flutter port of the source Team.
BeuiTextCascade: A per-letter slot roll for standalone text — the Flutter port of beUI's text-cascade.
BeuiTextReveal: A staggered slide-up + blur reveal for text — the Flutter port of beUI's text-reveal.
BeuiTextScramble: A controlled character scramble that resolves to text — the Flutter port of beUI's text-scramble.
BeuiTextShimmer: A continuous gradient shimmer swept across text — the Flutter port of beUI's text-shimmer.
BeuiTextTheme: Names the sans and mono font families a beUI app should use, with a platform monospace fallback for when the mono family is not provided.
BeuiThemeSwitcher: Wraps a subtree and switches its Brightness with a full-surface clip-path reveal — the Flutter port of beUI's theme-toggle (the View-Transition flourish), reimplemented with a snapshot + animated ClipPath so it runs everywhere, not just on the web.
BeuiThemeSwitcherController: Handle a BeuiThemeToggle uses to read the current brightness and request a switch. Obtain it with BeuiThemeSwitcher.of(context).
BeuiThemeToggle: A theme-toggle button — a Sun/Moon icon (swapped with the action-swap blur transition) that flips the nearest BeuiThemeSwitcher's brightness, playing the variant reveal from start. Bare by design (style it with a parent border/padding, as the source does via className).
BeuiThinkingShimmer: A quiet shimmer on status copy — the Flutter port of beUI's ThinkingShimmer.
BeuiTiltCard: A card that tilts in 3D toward the cursor with a following glare — the Flutter port of beUI's tilt-card.
BeuiTimeline: A draggable horizontal event timeline with keyboard navigation.
BeuiTimelineEvent: A dated entry displayed by BeuiTimeline.
BeuiTimeRange: A single availability window within a day (source TimeRange).
BeuiToast: One toast's data (source AnimatedToast). Immutable — update a toast by replacing it in the list (or via BeuiToastController.update).
BeuiToastAction: An action button rendered under a toast's text (source AnimatedToastAction).
BeuiToastController: Owns a toast list with auto-dismiss timers — the port of the source's useAnimatedToastStack hook. Listen (e.g. ListenableBuilder) and feed toasts to a BeuiAnimatedToastStack.
BeuiTodoItem: One row of a BeuiTodoList — the Flutter port of the source's TodoItem.
BeuiTodoList: A collapsible agent task plan with morphing status marks, a completion count, compact metadata, and smooth list updates — the Flutter port of beUI's todo-list.
BeuiToken: A token in a BeuiMultiChainSwap (source Token).
BeuiToolApproval: A human-in-the-loop permission card for reviewing tool details, allowing once, remembering access, or denying execution — the Flutter port of beUI's tool-approval.
BeuiToolApprovalCode: Syntax-tinted mono snippet for a BeuiToolApproval parameter value — the Flutter port of the source's ToolApprovalCode (backed by AgentCode / BeuiToolResultOutput).
BeuiToolApprovalParameter: One parameter row inside the "View details" disclosure (source ToolApprovalParameter).
BeuiToolResult: A lightweight execution disclosure for terminal output / request responses that collapses into a compact completed state — the Flutter port of beUI's tool-result.
BeuiToolResultOutput: Syntax-tinted terminal / request body text for use inside BeuiToolResult — the Flutter port of beUI's ToolResultOutput (backed by AgentCode).
BeuiTooltip: A hover, keyboard-focus, and touch tooltip built on BeuiOverlay.
BeuiTooltipContent: Content and placement for BeuiTooltip.composed.
BeuiTooltipProvider: Timing and warm-window scope shared by descendant tooltips.
BeuiTooltipTrigger: The trigger slot of BeuiTooltip.composed. Child handlers remain intact.
BeuiTreemap: Proportional tiles that morph with the data, with value and share tooltips.
BeuiTreemapLegend: Color legend of top-level groups.
BeuiTreemapNode: A treemap node: a leaf with a value, or a group of children.
BeuiTreemapPlot: Plot of morphing tiles. Default height is 20rem (320).
BeuiTreemapTile: A laid-out leaf tile.
BeuiTreemapTooltip: Tooltip host. Content is shown from the active tile; this part is a no-op slot matching the source composition API.
BeuiVoiceAnalyser: Caller-owned time-domain sampler. The orb never opens a microphone.
BeuiVoiceOrb: A breathing liquid voice visualization — the Flutter port of beUI's VoiceOrb.
BeuiVolumeProfile: Composable volume profile chart.
BeuiVolumeProfileBin: One pre-aggregated price bin.
BeuiVolumeProfilePlot: Interactive horizontal volume bars with a vertical keyboard inspector.
BeuiVolumeProfileSummary: Summary of the active bin and control levels.
BeuiVolumeProfileTooltip: Tooltip content for the active price bin.
BeuiWalletAccount: A single wallet account shown in the BeuiWalletCard account switcher — the Flutter port of the source's WalletAccount type (types.ts).
BeuiWalletCard: A composed wallet overview card — the Flutter port of beUI's wallet-card block.
BeuiWaveSlider: An equalizer slider — a one-to-one port of beUI's range-slider-wave.
BeuiWheelPicker: An iOS-style wheel picker — the Flutter port of beUI's wheel-picker.
BeuiWheelPickerOption: One selectable row of a BeuiWheelPicker.
BeuiWheelPickerStyle: Optional style overrides for BeuiWheelPicker. Null fields resolve from the ambient BeuiColors theme extension (or sensible defaults).
LucideIcons: Lucide is a free, open-source icon set with 1450+ icons. It's a fork of the popular Feather icon set. Lucide is licensed under the ISC license.

Enums

BeuiActionSwapVariant: The transition used when an BeuiActionSwapText / BeuiActionSwapIcon / BeuiActionSwapButton swaps its content — the Flutter port of the source's ActionSwapAnimation (blur / roll / cascade).
BeuiAgentActivityContentType: Kind of activity content, plus mixed when the stream is heterogeneous (source AgentActivityContentType).
BeuiAgentActivityStatus: Run phase for BeuiAgentActivity (source AgentActivityStatus, extended with the two failure phases the source has no representation for).
BeuiAgentStatus: The semantic status tiers agent surfaces paint.
BeuiAgentStepStatus: Status mark on a BeuiAgentActivityStep (source AgentStepStatus).
BeuiAgentTraceKind: Trace-row glyph kind (source AgentTraceKind). Unknown strings fall through to a wrench glyph.
BeuiAlertVariant: Visual tone of a BeuiAlert.
BeuiAnimatedBadgeSize: Size of a BeuiAnimatedBadge (source AnimatedBadgeSize).
BeuiAnimatedBadgeStatus: Status of a BeuiAnimatedBadge — a fixed, exhaustive set, mirroring the source AnimatedBadgeStatus union.
BeuiAnimatedSidebarCollapsible: Collapse behaviour when desktop BeuiAnimatedSidebar.expanded is false (source SidebarCollapsible).
BeuiAnimatedSidebarSide: Which edge the sidebar anchors to (source SidebarSide).
BeuiAnimatedSidebarVariant: Panel chrome on desktop (source SidebarVariant). Ignored on mobile, where the sheet always renders as a flush, bordered, shadowed drawer — exactly as the source, whose AnimatedSidebar short-circuits to MobileSidebar before the variant is read.
BeuiApprovalCardStatus: Lifecycle of a BeuiApprovalCard — the Flutter port of the source's ApprovalCardStatus.
BeuiArcPickerSide: The direction in which a BeuiArcPicker's curve bows.
BeuiAttachmentKind: What an attachment is (source AttachmentUploadKind).
BeuiAttachmentRejectReason: Why a candidate attachment was turned away (source AttachmentRejectReason).
BeuiAttachmentStatus: Per-row upload state (source AttachmentUploadStatus).
BeuiButtonSize: Size of a BeuiButton.
BeuiButtonState: Lifecycle state of a BeuiStatefulButton.
BeuiButtonVariant: Visual style of a BeuiButton.
BeuiCardSize: Shared spacing for BeuiCard and its parts.
BeuiCardVariant: Surface treatment for BeuiCard.
BeuiChainTone: Color pairing of a chain badge — the port of the source's Tailwind tone class strings, resolved against BeuiColors.
BeuiChartTooltipSide: Tooltip placement, matching the source side union.
BeuiCodeBlockStatus: Lifecycle of a BeuiCodeBlock surface (source CodeBlockStatus).
BeuiCodeLanguage: Supported language labels / lightweight highlighters (source AgentCodeLanguage).
BeuiColorFormat: Selects between RGB and HSL channel display.
BeuiColorTheme: The selectable color themes — the neutral defaultMono base plus the ten brand themes. Combined with a Brightness, each resolves to a complete BeuiColors palette via BeuiColors.of.
BeuiComboboxAlign: Horizontal alignment of the panel.
BeuiComboboxSide: Preferred side of the combobox panel.
BeuiCompositionView: How composition data is visualized.
BeuiContextMenuItemKind: Kind of a BeuiContextMenuItem row.
BeuiContextMenuModality: How the menu was opened — gates the clip-morph entrance (keyboard opens instantly, matching the source).
BeuiContextMenuTone: Visual tone for a selectable context-menu row.
BeuiCylinderCurve: The two faces of the cylinder wall.
BeuiDateRangePickerAlignment: Horizontal alignment of the date panel relative to its trigger.
BeuiDateRangePickerSide: Side of the trigger on which the date panel is placed.
BeuiDayKey: A weekday key + its display label (source DayKey + the WEEKDAYS table, collapsed into a single enum). Iteration order is Monday → Sunday.
BeuiDigitSwapDirection: Direction the next glyph enters from in a BeuiDigitSwap.
BeuiDrawerSide: Which edge the drawer slides from.
BeuiExpandableActionBarSize: Size of a BeuiExpandableActionBar (source ExpandableActionBarSize).
BeuiFeedbackPosition: Which bottom corner the widget anchors to (source position).
BeuiFeedbackSentiment: An optional one-tap rating alongside the written message.
BeuiFileDiffLineType: Kind of change for a BeuiFileDiffLine (source FileDiffLineType).
BeuiFileDiffStatus: Lifecycle of a BeuiFileDiff surface (source FileDiffStatus).
BeuiFileDiffWrap: How a BeuiFileDiff handles lines wider than its viewport.
BeuiFileUploadStatus: Upload state of one row (source FileUploadStatus).
BeuiFileUploadVariant: Dropzone layout (source FileUploadVariant).
BeuiFunnelDirection: Funnel orientation.
BeuiHoldActionDirection: Fill direction for BeuiHoldActionButton.
BeuiImageGenerationSize: Width behavior for the image frame (source size).
BeuiImageGenerationStatus: Lifecycle of a BeuiImageGeneration surface (source ImageGenerationStatus).
BeuiLoaderVariant: Which looping animation BeuiLoader renders. One value per source LoaderVariant (loader.tsx), names matching the source slugs.
BeuiMarqueeDirection: Scroll direction for a BeuiMarquee.
BeuiMatchStatus: Whether a match has been played.
BeuiMatchWinner: Which side won a decided match — drives the winner marker and which side dims.
BeuiMessageBubbleSide: Alignment side shared with message-bubble (source MessageSide).
BeuiMessageBubbleSpacing: Vertical spacing inside a BeuiMessageBubbleGroup (source MessageBubbleGroup spacing).
BeuiMessageBubbleVariant: Visual tone of a BeuiMessageBubble (source MessageBubbleVariant).
BeuiMessageFrom: Who authored a BeuiMessage row (source MessageFrom).
BeuiMessageScrollerNavigation: Optional message-navigation mode for BeuiMessageScroller (source navigation).
BeuiMessageSpacing: Vertical spacing between items in a BeuiMessageGroup (source MessageGroup spacing).
BeuiModalPlacement: Where the modal sits in the viewport.
BeuiMorphingSearchChipsSide: Direction in which the suggestions surface opens.
BeuiMorphPopoverAlign: Alignment of the panel along the trigger's edge — picks which corner the morph originates from.
BeuiMorphPopoverSide: Which side of the trigger the panel morphs out of.
BeuiOrderBookSideKind: Side of an order-book level.
BeuiOtpStatus: External validation state of a BeuiOtpInput (source OTPStatus).
BeuiOverflowActionsSize: Size of a BeuiOverflowActions rail (source OverflowActionsSize).
BeuiParallaxAxis: Axis the parallax drift moves along.
BeuiPopoverAlign: Alignment of the panel along the trigger's edge.
BeuiPopoverSide: Which side of the trigger the panel oozes out of.
BeuiPopoverTrigger: How the popover is summoned.
BeuiPredictionMarketCardSide: The side selected from an outcome row.
BeuiPredictionMarketMode: Trade direction (source PredictionMarketMode).
BeuiPreviewRailOrientation: Layout axis of a BeuiPreviewRail.
BeuiPreviewRailPreviewSide: Which side of the rail the floating preview pops out on (source previewSide).
BeuiPromptAttachmentStatus: Delivery state of one composer attachment.
BeuiPromptBlockedReason: Why a submit attempt did not go through.
BeuiPullToRefreshStatus: Pull-gesture lifecycle for BeuiPullToRefresh (source PullToRefreshStatus).
BeuiReasoningTextVariant: Animation used when the active phrase changes (source ReasoningTextVariant).
BeuiShaderVariant: The 21 shader effects ported from @paper-design/shaders, mirroring the source shader-background variant set. Each maps to a compiled fragment shader under shaders/ and a ShaderSpec in beuiShaderRegistry.
BeuiSidebarResourceDropPosition: Where a moved item lands relative to a drop target — source SidebarResourceDropPosition.
BeuiSidebarResourceKind: Kind of a BeuiSidebarResource node — mirrors source SidebarResourceKind.
BeuiSignUpStatus
BeuiSmoothScrollOrientation: Axis a BeuiSmoothScroll provider drives (source orientation).
BeuiSortDirection: Sort direction for a column (source SortDirection).
BeuiStreamingResponseFeedback: Thumb-vote state for a completed response (source StreamingResponseFeedback: "up" | "down" | null).
BeuiStreamingResponseStatus: Lifecycle of a BeuiStreamingResponse surface (source StreamingResponseStatus).
BeuiSwipeActionTone: Color tone of a swipe action (source SwipeActionTone).
BeuiSwipeSide: Which action rail a row is revealing (source SwipeSide).
BeuiTableAlign: Cell / header horizontal alignment (source column align).
BeuiTableInsertPosition: Where an inserted row / column lands relative to the target (source InsertPosition).
BeuiTableSizing: Column allocation policy. Intrinsic sizing requires passive cell samples.
BeuiTabsIcons: When a trigger's BeuiTab.icon is shown.
BeuiTabsVariant: The three tab looks from the source.
BeuiTextRevealSplit: How BeuiTextReveal splits its text into independently-animated units.
BeuiThemeRevealStart: Origin the reveal grows from (source RectStart).
BeuiThemeRevealVariant: How a BeuiThemeSwitcher reveals the new theme — the Flutter port of beUI's ThemeVariant. The source drives these with the web-only View Transition API; this port reimplements them as a uniform ClipPath animation that runs on every platform (a snapshot of the old theme is clipped away as the new theme is revealed underneath).
BeuiToastPosition: Where the stack sits and how it grows (source ToastPosition).
BeuiToastStatus: Status of a toast — a fixed, exhaustive set mirroring the source ToastStatus union. Each status carries a default glyph (source STATUS_ICON), overridable per toast via BeuiToast.icon or per stack via BeuiAnimatedToastStack.icons.
BeuiTodoItemStatus: Task lifecycle for a BeuiTodoItem — the Flutter port of the source's TodoItemStatus.
BeuiTokenSide: Which side of the swap a picker targets (source TokenSide).
BeuiToolApprovalGrant: Which grant a BeuiToolApproval was approved under.
BeuiToolApprovalSeverity: How consequential the requested capability is — the risk tier that drives BeuiToolApproval's glyph, border, badge, and action emphasis.
BeuiToolApprovalStatus: Lifecycle of a BeuiToolApproval surface (source ToolApprovalStatus).
BeuiToolResultKind: Visual kind of a BeuiToolResult — picks the default leading icon (source ToolResultKind).
BeuiToolResultStatus: Lifecycle of a BeuiToolResult surface (source ToolResultStatus).
BeuiTooltipAlign: Alignment of the tooltip along the cross axis of BeuiTooltipSide.
BeuiTooltipSide: Which side of the trigger the tooltip appears on.

Constants

beuiBumpPalette → const List<Color>: Bump-chart series palette (source BUMP_COLORS).
beuiChartPalette → const List<Color>: Default tile / series palette (source TREEMAP_COLORS / chart defaults).
beuiDefaultBloomMenuItems → const List<BeuiBloomMenuItem>: The source's default six-item bloom menu (ITEMS, overridable per menu).
beuiDefaultSwapChains → const List<BeuiChain>: The source's demo CHAINS.
beuiDefaultSwapTokens → const List<BeuiToken>: The source's demo TOKENS.
beuiEaseDrawer → const Cubic: Drawer easing, cubic-bezier(0.32, 0.72, 0, 1) (source EASE_DRAWER).
beuiEaseInOut → const Cubic: Symmetric ease-in-out, cubic-bezier(0.77, 0, 0.175, 1) (source EASE_IN_OUT).
beuiEaseOut → const Cubic: Default ease-out, cubic-bezier(0.16, 1, 0.3, 1) (source EASE_OUT).
beuiEaseScroll → const Curve: Lenis' own expo-out curve — the canonical smooth-scroll easing (source EASE_SCROLL, 1.001 - 2^(-10t)). Component-local, like the source keeps it out of lib/ease.ts: the shared tokens are UI-motion beziers, this is a scroll-glide function.
beuiSpringLayout → const SpringMotion: Shared-layout glides — pills and indicators morphing between positions (source SPRING_LAYOUT).
beuiSpringMouse → const SpringMotion: Cursor-follow physics — magnetic pull, tilt (source SPRING_MOUSE).
beuiSpringPanel → const SpringMotion: Overlay panel entrances — modals, sheets (source SPRING_PANEL).
beuiSpringPress → const SpringMotion: Press feedback on buttons and tappable surfaces (source SPRING_PRESS).
beuiSpringScroll → const SpringMotion: Scroll-linked follow spring shared by scroll-progress.tsx and parallax.tsx: mass 0.6 · stiffness 120 · damping 30.
beuiSpringSnap → const SpringMotion: Near-instant settle used when a movement spring is replaced under reduced motion but the surface still needs to reach its end state through the same builder: mass 1 · stiffness 700 · damping 60.
beuiSpringSwap → const SpringMotion: Content swaps — label/icon slots trading places (source SPRING_SWAP).
beuiStatusBarStatuses → const List<BeuiStatusBarStatus>: Dart-idiomatic alias for STATUS_BAR_STATUSES.
beuiTextScrambleGlyphs → const String: Default glyph set sampled while unresolved positions scramble.
beuiVersion → const String: The beUI package version. Kept in sync with pubspec.yaml.
kBeuiAnimatedSidebarIconWidth → const double: Icon-rail width when collapsed — source --sidebar-width-icon: 4.25rem.
kBeuiAnimatedSidebarMobileBreakpoint → const double: Mobile breakpoint — source MOBILE_QUERY = (max-width: 767px).
kBeuiAnimatedSidebarMobileWidth → const double: Mobile sheet width — source --sidebar-width-mobile: 18rem.
kBeuiAnimatedSidebarWidth → const double: Desktop expanded width — source --sidebar-width: 16rem.
kBeuiVoiceOrbColors → const (Color, Color, Color): Default pigments: base, highlight, shadow (source #e8754d, #ffe0ac, #346b52).
kBeuiVoiceOrbSize → const double: Source w-64 / aspect-square. The live preview wraps this at sm:w-72 (288); pass BeuiVoiceOrb.size to match that frame.
STATUS_BAR_STATUSES → const List<BeuiStatusBarStatus>: Default status palette.

Functions

beuiBlurSigma(double cssBlurPx) → double: Converts a source CSS blur(N px) radius to the Flutter ImageFilter sigma used everywhere in this library: σ = px / 2.
beuiChartColor(String? css, BeuiColors colors, {Color? fallback}) → Color: Parses a source CSS color: hex (#rgb / #rrggbb / #rrggbbaa) or a handful of var(--token) aliases the chart family actually uses.
beuiChartFormatNumber(num value, {int maximumFractionDigits = 0, bool compact = false}) → String: Locale-free integer/decimal grouping matching toLocaleString('en-US').
beuiChartPercent(num share, {int digits = 1}) → String: Share of a total as 12.4%.
beuiChartSignedPercent(num value, {int digits = 1}) → String: Signed percent with a true minus (−) matching source signed().
beuiChartToTooltipSide(BeuiChartTooltipSide side) → BeuiTooltipSide: Maps BeuiChartTooltipSide onto BeuiTooltipSide.
beuiCleanSankey(List<BeuiSankeyNode> nodes, List<BeuiSankeyLink> links) → BeuiSankeyData: Cleans the graph with the pinned source's iterative depth-first cycle rule.
beuiColorFromHex(String input) → Color?: Parses short or long CSS hex colors (with optional alpha).
beuiColorToHex(Color color, {bool includeAlpha = true}) → String: Formats color as lowercase #rrggbb or #rrggbbaa.
beuiComboboxSubsequenceFilter(String value, String query, List<String> keywords) → bool: Default source-compatible filter: a trimmed query must be a subsequence of the option value, label, or keywords (case-insensitive).
beuiDefaultWeek() → BeuiWeekAvailability: The default week: Mon–Fri available 9:00–17:00, weekend off (source defaultWeek). Off days keep a hidden 9–5 range so toggling them on restores those hours.
beuiFaviconUrl(String value) → String?: Resolve a website URL to its conventional root favicon location (/favicon.ico on the same origin). Returns null when value is not a valid absolute URL.
beuiFormatAgentActivityDuration(num durationSeconds) → String: Formats elapsed run time for the completed summary (source formatDuration — whole seconds, 5s / 2m / 2m 5s).
beuiFormatAgentElapsed(double totalSeconds) → String: Formats elapsed seconds as 12.3s or 2m 3.4s (source formatElapsed).
beuiFormatBytes(int bytes) → String: Human-readable byte size (source formatBytes).
beuiLayoutSankey(BeuiSankeyData data, {required Size size, double nodeWidth = 12, double nodePadding = 16, List<Color> colors = const [Color(0xff1d4ed8), Color(0xff7c3aed), Color(0xff0f766e), Color(0xffb45309), Color(0xffbe123c), Color(0xff475569)]}) → BeuiSankeyLayout: Source layout algorithm, including fixed node order, sink alignment and link stacking.
beuiPasswordStrength(String password) → int
beuiSidebarContains(BeuiSidebarResource item, String id) → bool: Whether item (or any descendant) has id.
beuiSidebarFind(List<BeuiSidebarResource> items, String id) → BeuiSidebarResource?: Depth-first find by id.
beuiSidebarInsert(List<BeuiSidebarResource> items, BeuiSidebarResource resource, String? targetId, BeuiSidebarResourceDropPosition position) → List<BeuiSidebarResource>: Insert resource relative to targetId / position.
beuiSidebarMove(List<BeuiSidebarResource> items, BeuiSidebarResourceMove move) → List<BeuiSidebarResource>?: Apply a move, returning null when illegal.
beuiSidebarRemove(List<BeuiSidebarResource> items, String id) → ({List<BeuiSidebarResource> items, BeuiSidebarResource? removed}): Remove id from the tree. Returns the new list and the removed node.
beuiSidebarRename(List<BeuiSidebarResource> items, String id, String label) → List<BeuiSidebarResource>: Rename id to label throughout the tree.
motionFor(BuildContext context, Motion motion, {required bool isMovement, Motion? reducedFallback}) → Motion: Resolves motion against the platform's reduced-motion setting.

Typedefs

BeuiApprovalCardAnswers = Map<String, BeuiApprovalCardAnswer>: Map of question id → answer — the Flutter port of ApprovalCardAnswers.
BeuiComboboxFilter = bool Function(String value, String query, List<String> keywords): Search matcher used by BeuiCombobox.
BeuiInfiniteMasonryKey = Object: The identity of a masonry item — a String or int returned by BeuiInfiniteMasonry.getItemKey.
BeuiMasonryItemBuilder<T> = Widget Function(T item, int index): Builds the widget for item at index.
BeuiMasonryKeyBuilder<T> = BeuiInfiniteMasonryKey Function(T item, int index): Returns the stable BeuiInfiniteMasonryKey for item at index.
BeuiMasonrySizeEstimator<T> = double Function(T item, int index): Estimates the pixel height of item at index before layout, used only for shortest-column lane assignment and the prefetch trigger distance. The actual rendered height is measured by Flutter — see BeuiInfiniteMasonry.
BeuiMessageBubbleAlign = BeuiMessageBubbleSide: Bubble alignment (source MessageBubbleAlign / MessageSide).
BeuiOverlayBuilder = Widget Function(BuildContext context, Animation<double> animation, LayerLink link): Builds the overlay content. animation runs 0→1 on enter and 1→0 on exit; link is the anchor's LayerLink, for positioning relative to the trigger (e.g. a tooltip via CompositedTransformFollower). Modal content can ignore link and position itself full-screen (e.g. Align/Positioned).
BeuiSortableListContent = BeuiSortableListItemContent: Short alias for BeuiSortableListItemContent.
BeuiSwipeActionCallback = void Function(BeuiSwipeableListItem item, BeuiSwipeAction action, BeuiSwipeSide side): Fires when a revealed action is chosen.
BeuiWeekAvailability = Map<BeuiDayKey, BeuiDayAvailability>: A full week's availability, keyed by BeuiDayKey (source WeekAvailability = Record<DayKey, DayAvailability>).

beui library

Classes

Enums

Constants

Functions

Typedefs

beui package

beui library