beui

UX-audit remediation across the chat/agent family — 154 audited findings resolved (docs/UX_AUDIT_AGENT_CHAT_FLOWS.md holds the audit). Almost all API is additive; the deliberate default changes are listed under "Changed defaults" below.

Trust & failure states

• BeuiToolApproval: details open by default whenever parameters exist; a severity tier (normal/elevated/destructive) that re-weights the actions for irreversible commands (warning glyph, tinted border, Deny promoted, Always-allow suppressed); expired/timedOut statuses; grant records once-vs-always and an onRevoke affordance for standing grants; the action row can no longer double-fire during its exit.
• BeuiStreamingResponse: error is now visibly failed (destructive notice
  • retry) instead of pixel-identical to complete; new stopped status with a Continue affordance.
• BeuiAgentActivity: failed/cancelled statuses — a crashed run no longer summarizes as success.
• BeuiImageGeneration: determinate progress hairline and onCancel.

Keyboard & screen readers

• Full keyboard contracts (focus, Enter/Space, Esc, visible focus ring) for: tool-approval actions, the composer's + menu and model picker, BeuiFileUpload (dropzone/remove/retry), the feedback widget's trigger and close, and sidebar rows (visible focus + selected ≠ hover).
• Esc now dismisses BeuiOverlay surfaces even with trapFocus: false.
• The transcript announces streamed text through one debounced live region (sentence-boundary announcements; announceText/onAnnounce hooks) instead of 3–5 nested regions announcing nothing; terminal outcomes (Failed, Denied, Copied, Sent) are announced.
• Focus rings paint outside layout via the new focusRing color role (≥3:1 in all 22 theme×brightness combos) — focusing no longer shifts content.
• 44px minimum hit areas across the family; upload progress announced with units and completion.

Contrast

• Placeholders, tool slugs, metadata, line-number gutters, citation domains, and light-mode status badges move from 1.6–3.7:1 to AA-passing values; outline bubbles get a visible edge; danger bubbles gain a leading glyph and AA text.

Composer & uploads

• BeuiPromptInput: attachment chip rail (attachments, onAttachmentRemoved, onAttachmentRetry, onSubmitFull with BeuiPromptSubmission), one keyboard-driven model picker (BeuiSelectOption.icon), viewport-aware menu placement, Enter-while-streaming feedback (onSubmitBlocked), memoised measurement for large pastes.
• Upload components: real progress on attachment items, cancel-in-flight (onCancel) distinct from remove, maxFileSize + inline rejection notice, seekable audio scrubber (onSeek), honest default dropzone copy.
• BeuiInput: left-aligned error text (was centered — golden-verified), announced errors, label association, shake replay via errorNonce, and the standard TextField pass-throughs (autofill, input action, formatters, maxLength, readOnly…).
• BeuiFeedbackWidget: drafts survive dismissal, submit validates inline instead of disabling, optional sentiment row (showSentiment), announced and screen-reader-stable success state.

Reading long/streamed content

• Jump-to-latest pills with unread counts on the message scroller; streaming code/diff/tool-result viewports stop yanking the reader to the live edge once they scroll away, and capped viewports show a fade + "N more lines".
• BeuiFileDiff: wide lines are horizontally scrollable or wrapped (wrap: adaptive by default) instead of ellipsised; header copy control; hunk-gap markers with optional context expansion (onExpandContext) and change navigation; unified-diff copyText default.
• BeuiMessageScroller.builder — lazy sliver path for long transcripts.
• BeuiPreviewRail works on touch (tap-to-preview, tap-again-to-commit) and marks the active destination by default.
• BeuiChatApp: responsive sidebarBreakpoint, keyboard-inset avoidance, bubble width clamped (no more debug assert below 44px).

Changed defaults (deliberate, audit-driven)

• BeuiMessage/BeuiMessageBubble animateIn now default to true (mount-only; streaming updates never replay).
• BeuiToolApproval.defaultOpen resolves by parameters.isNotEmpty.
• BeuiPreviewRail.highlightActive defaults to true.
• BeuiFileUpload copy: "Browse files" / drag wording is opt-in (dragAndDrop) because OS drop needs a consumer plugin.
• BeuiToolApproval/BeuiToolResult tool/title/description/meta narrowed from Object to typed String? + Widget? pairs (filename/file likewise on code block and diff, with deprecated *Node params still accepted).

Localization

• BeuiAgentStrings now covers the full agent family (approval, results, activity, todos, streaming actions, jump-to-latest); resolution is widget param → theme strings → defaults.

Theming roles

• New BeuiColors.focusRing role — clears WCAG 2.2 SC 1.4.11 (3:1) on all 11 themes in both brightnesses; ring is unchanged and stays for hairline borders. Amber and lime cannot clear 3:1 in light mode at any alpha, so their focus hue is darkened to 60% oklch lightness.
• New BeuiAgentTheme.statusLight/statusDark (BeuiAgentStatusColors, BeuiAgentStatusPalette) — agent status color was previously ~50 hardcoded literals and could not be rethemed; painted defaults are preserved except the AA lift noted under Contrast.

Fixes

• The package did not compile: LucideIcons.history was removed in flutter_lucide 1.31.0. Replaced with rotate_ccw_clock.
• BeuiPullToRefresh: the indicator did not track the finger during the pull (frozen at rest until release) — for all users, not only reduced motion.
• Reduced-motion "arrival" fixes: the agent-activity feed, collapsible bubbles, todo progress arcs and strikethroughs, disclosure chevrons, and the command-palette/context-menu selection highlight now reach their target state under disableAnimations instead of freezing mid-transition.

Internal

• One shared syntax highlighter replaces three diverged copies (JSON keys now highlight as properties, bash tokenizes positionally, diffs handle @@); one shared disclosure primitive replaces eight, with a reduced-motion branch that keeps an opacity fade instead of hard-cutting.

Semantic theming for the AI-agent family, plus compact-to-expanded approval cards. Default visuals and motion are unchanged: omit BeuiAgentTheme and every agent widget still resolves to the 1.0.0 source-fidelity look.

Agent theming

• New BeuiAgentTheme ThemeExtension — typography roles, bubble/card radii, conversation spacing, density, borders, optional glass cards, and semantic icon slots. Install it next to BeuiColors; ThemeData.fontFamily still owns the typeface.
• AI-agent widgets read those tokens instead of hard-coded source sizes, padding, and Lucide defaults. Constructor overrides remain.
• Gallery route Agent Theme shows a custom warm-green palette, inherited font, radii, density, icons, and an expandable approval card using the real widgets.

Approval card

• Additive compact-to-expanded API: expanded / defaultExpanded / onExpandedChanged, compactChild / expandedChild, headerAction. Existing call sites are unchanged. Height uses beuiSpringLayout and is interruptible; reduced motion snaps.

Compatibility

• Minor release. No required migrations. BeuiChatApp.borderRadius and BeuiMessageBubbleContent.maxWidthFactor are now nullable so the theme can supply the default; omitted arguments still resolve to 16 and 0.82.

Package: https://pub.dev/packages/beui/versions/1.1.0

Semantic theming for the AI-agent family, plus compact-to-expanded approval cards. Default visuals and motion are unchanged: omit BeuiAgentTheme and every agent widget still resolves to the 1.0.0 source-fidelity look.

Agent theming

• New BeuiAgentTheme ThemeExtension — typography roles, bubble/card radii, conversation spacing, density, borders, optional glass cards, and semantic icon slots. Install it next to BeuiColors; ThemeData.fontFamily still owns the typeface.
• AI-agent widgets read those tokens instead of hard-coded source sizes, padding, and Lucide defaults. Constructor overrides remain.
• Gallery route Agent Theme shows a custom warm-green palette, inherited font, radii, density, icons, and an expandable approval card using the real widgets.

Approval card

• Additive compact-to-expanded API: expanded / defaultExpanded / onExpandedChanged, compactChild / expandedChild, headerAction. Existing call sites are unchanged. Height uses beuiSpringLayout and is interruptible; reduced motion snaps.

Compatibility

• Minor release. No required migrations. BeuiChatApp.borderRadius and BeuiMessageBubbleContent.maxWidthFactor are now nullable so the theme can supply the default; omitted arguments still resolve to 16 and 0.82.

Initial release — a one-to-one Flutter port of beUI v2, built on the
motor motion engine so the source's exact spring physics
carry over. All 72 beui.dev catalog entries across three groups.

📦 pub.dev/packages/beui · 🎨 Live gallery

dependencies:
  beui: ^1.0.0

A beui.dev page is not always one component: several pages ship multiple
independently-installable widgets, and all of them are covered here.

Components (motion primitives)

Tilt Card, Button (+ Stateful + Magnetic), Animated CTA Buttons (expanding /
hold / slide), Marquee, Tabs, Switch, Input, Select (+ Morph), Checkbox,
Radio Group, Bottom Sheet, Pull to Refresh, Shared Layout Background,
Bounce Sidebar, Animated Sidebar (sidebar / floating / inset), Preview Rail,
Dock (+ separator-grouped actions), Tooltip, Context Menu, Popover (+ Morph),
Morphing Modal, Center Morph Modal, Text Animation (reveal / shimmer /
cascade / chromatic), Number Animation (count-up + ticker), Animated Badge,
Action Swap (blur / roll / cascade), Animated Toast Stack, Theme Toggle
(rectangle / circle / circle-blur / blinds), Bouncy Accordion, Drawer,
Scroll Animation (smooth scroll / progress / reveal / scroll-to / parallax),
Range Slider (ticked / fluid / wave / bubble / ruler), Wheel Picker, Table,
Shader Background (21 GPU variants), Cylinder Carousel, Loader (17 variants).

Blocks (composed patterns)

Infinite Masonry, Notification Stack, Fixtures (knockout bracket with
third-place playoff + knockout wheel), Availability Scheduler,
Multi-chain Swap, Dynamic Island, Command Palette, Expandable Action Bar,
Overflow Actions, Expandable Tabs, Swipeable List, File Upload (upload queue

• attachment workspace), Prediction Market, Wallet Card, OTP Input,
  Bloom Menu, Feedback Widget, 404 / Not Found (5 variants).

AI Agents (conversational interfaces)

Message Bubble, Message, Message Scroller, Prompt Input, Todo List,
Code Block, Approval Card, File Diff, Tool Result, Streaming Response,
Image Generation, Tool Approval, Citations, Agent Activity, Agent Loading
States (thinking shimmer / agent progress / reasoning text), AI Sidebar,
Chat App.

Foundation

• Spring and easing motion tokens mirroring the source ease.ts, resolved
  through a single motor-backed facade.
• BeuiColors ThemeExtension with light/dark and 11 color themes.
• Shared BeuiOverlay foundation for every floating surface (tooltip, drawer,
  sheet, modal, command palette).
• Reduced-motion resolver (motionFor) that drops movement while preserving
  opacity/color feedback.
• Default flutter_lucide icon set re-exported through the barrel.

Deliberate departures from the source

• No dual-thumb range slider — beui.dev ships five single-value sliders and no
  range variant.
• File pickers are the consumer's: BeuiFileUpload and BeuiAttachmentUpload
  carry file metadata and expose onBrowse, so the package takes no
  file-picker dependency.
• Compound React components (Tabs/TabsList/TabsTrigger, Select/
  SelectTrigger/…, the AnimatedSidebar* family) collapse into single
  widgets taking item models, per the Flutter conventions in
  docs/PORTING_SPEC.md §6.

Initial release — a one-to-one Flutter port of beUI v2, built on the motor motion engine so the source's exact spring physics carry over. All 72 beui.dev catalog entries across three groups.

A beui.dev page is not always one component: several pages ship multiple independently-installable widgets, and all of them are covered here.

Components (motion primitives)

Tilt Card, Button (+ Stateful + Magnetic), Animated CTA Buttons (expanding / hold / slide), Marquee, Tabs, Switch, Input, Select (+ Morph), Checkbox, Radio Group, Bottom Sheet, Pull to Refresh, Shared Layout Background, Bounce Sidebar, Animated Sidebar (sidebar / floating / inset), Preview Rail, Dock (+ separator-grouped actions), Tooltip, Context Menu, Popover (+ Morph), Morphing Modal, Center Morph Modal, Text Animation (reveal / shimmer / cascade / chromatic), Number Animation (count-up + ticker), Animated Badge, Action Swap (blur / roll / cascade), Animated Toast Stack, Theme Toggle (rectangle / circle / circle-blur / blinds), Bouncy Accordion, Drawer, Scroll Animation (smooth scroll / progress / reveal / scroll-to / parallax), Range Slider (ticked / fluid / wave / bubble / ruler), Wheel Picker, Table, Shader Background (21 GPU variants), Cylinder Carousel, Loader (17 variants).

Blocks (composed patterns)

Infinite Masonry, Notification Stack, Fixtures (knockout bracket with third-place playoff + knockout wheel), Availability Scheduler, Multi-chain Swap, Dynamic Island, Command Palette, Expandable Action Bar, Overflow Actions, Expandable Tabs, Swipeable List, File Upload (upload queue

• attachment workspace), Prediction Market, Wallet Card, OTP Input, Bloom Menu, Feedback Widget, 404 / Not Found (5 variants).

AI Agents (conversational interfaces)

Message Bubble, Message, Message Scroller, Prompt Input, Todo List, Code Block, Approval Card, File Diff, Tool Result, Streaming Response, Image Generation, Tool Approval, Citations, Agent Activity, Agent Loading States (thinking shimmer / agent progress / reasoning text), AI Sidebar, Chat App.

Foundation

• Spring and easing motion tokens mirroring the source ease.ts, resolved through a single motor-backed facade.
• BeuiColors ThemeExtension with light/dark and 11 color themes.
• Shared BeuiOverlay foundation for every floating surface (tooltip, drawer, sheet, modal, command palette).
• Reduced-motion resolver (motionFor) that drops movement while preserving opacity/color feedback.
• Default flutter_lucide icon set re-exported through the barrel.

Deliberate departures from the source

• No dual-thumb range slider — beui.dev ships five single-value sliders and no range variant.
• File pickers are the consumer's: BeuiFileUpload and BeuiAttachmentUpload carry file metadata and expose onBrowse, so the package takes no file-picker dependency.
• Compound React components (Tabs/TabsList/TabsTrigger, Select/ SelectTrigger/…, the AnimatedSidebar* family) collapse into single widgets taking item models, per the Flutter conventions in docs/PORTING_SPEC.md §6.