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.
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.
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.
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.
BeuiBubbleSlider: A slider with a velocity-reactive value bubble — a one-to-one port of beUI's range-slider-bubble.
BeuiButton: A spring-pressed button — the Flutter port of beUI's base Button.
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).
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.
BeuiColors: The resolved beUI palette for one colorTheme × brightness combination, exposed to the widget tree as a ThemeExtension.
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.
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.
BeuiDayAvailability: One day's availability (source DayAvailability): whether the day is enabled and its list of ranges.
BeuiDock: A dock — the Flutter port of beUI's dock.
BeuiDockItem: One entry in a BeuiDock — an action, or a BeuiDockItem.separator.
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).
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.
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.
BeuiGlass: A frosted-glass surface descriptor — the source glass / glass-strong / glass-thin tiers grouped so overlay components read one cohesive surface.
BeuiHoldActionButton: Hold-to-confirm CTA with a liquid fill — port of HoldActionButton.
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.
BeuiInfiniteMasonry<T>: A columned, infinite-scroll masonry feed — the Flutter port of beUI's infinite-masonry block.
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.
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).
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.
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.
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.
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.
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.
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.
BeuiRulerSlider: A ruler slider — a one-to-one port of beUI's range-slider-ruler.
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.
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).
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.
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, 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>.
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.
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.
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/focus tooltip with a spring spawn and blur enter/exit — the Flutter port of beUI's tooltip, built on BeuiOverlay.
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).
BeuiAgentDensity: Compact versus standard content density for agent surfaces.
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.
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.
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.
BeuiChainTone: Color pairing of a chain badge — the port of the source's Tailwind tone class strings, resolved against BeuiColors.
BeuiCodeBlockStatus: Lifecycle of a BeuiCodeBlock surface (source CodeBlockStatus).
BeuiCodeLanguage: Supported language labels / lightweight highlighters (source AgentCodeLanguage).
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.
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.
BeuiDayKey: A weekday key + its display label (source DayKey + the WEEKDAYS table, collapsed into a single enum). Iteration order is Monday → Sunday.
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).
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.
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.
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.
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.
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).
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).
BeuiTooltipSide: Which side of the trigger the tooltip appears on.

Constants

beuiAiSidebarKey → const ValueKey<String>: Root key for the AI sidebar tree.
beuiAnimatedSidebarActiveKey → const ValueKey<String>: Test handle on the active-item shared-layout indicator.
beuiAnimatedSidebarChromeKey → const ValueKey<String>: Test handle on the desktop panel's chrome — the surface carrying the variant's background, border, corner radius and shadow.
beuiAnimatedSidebarInsetKey → const ValueKey<String>: Test handle on the inset variant's detached content surface (source AnimatedSidebarInset's md:peer-data-[variant=inset] chrome). Absent for the sidebar and floating variants, and on mobile.
beuiAnimatedSidebarMobilePanelKey → const ValueKey<String>: Test handle on the mobile sheet panel.
beuiAnimatedSidebarPanelKey → const ValueKey<String>: Test handle on the desktop sidebar panel.
beuiBounceSidebarIndicatorKey → const ValueKey<String>: Test handle on the bouncing indicator dot.
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).
beuiSpringSwap → const SpringMotion: Content swaps — label/icon slots trading places (source SPRING_SWAP).
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.

Functions

beuiAiSidebarRenameKey(String id) → ValueKey<String>: Inline-rename field key for id.
beuiAiSidebarRowKey(String id) → ValueKey<String>: Row key for id (used by tests and focus).
beuiBlurSigma(double cssBlurPx) → double: Converts a source CSS blur(N px) radius to the Flutter ImageFilter sigma used everywhere in this library: σ = px / 2.
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).
beuiSidebarCanContain(BeuiSidebarResourceKind kind) → bool: Whether kind can contain children.
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.
citationTargetId(String prefix, String citationId) → String: Builds the DOM-style target id (prefix-sanitizedId) used in the source.
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.
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).
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