Vapora/crates/vapora-leptos-ui/limitations.md

Known Limitations

This document lists known limitations, missing features, and design decisions in vapora-leptos-ui v1.2.0.

Missing Components

Form Controls

• Select - Dropdown select component not implemented
• Textarea - Multi-line text input not implemented
• Checkbox - Checkbox input not implemented
• Radio - Radio button group not implemented
• Toggle/Switch - Toggle switch not implemented

Layout Components

• Dialog - Generic dialog component (Modal exists but Dialog is more flexible)
• ConfirmDialog - Confirmation dialog with Yes/No buttons
• Drawer - Side panel/drawer component
• Tabs - Tabbed interface component
• Accordion - Collapsible sections component

Data Display

• DataGrid - Advanced table with virtual scrolling, server-side sorting
• Tree - Tree view component
• Timeline - Timeline display component

Feedback

• Alert - Alert/banner component
• Progress - Progress bar component
• Skeleton - Loading skeleton component

Component Limitations

Input

• Uncontrolled: No value prop, only on_input callback
• No validation: Parent must handle validation
• Type limitation: Only input_type prop (string), no type safety for HTML5 input types
• No icon support: No built-in prefix/suffix icon slots

Table

• Client-side sorting only: No server-side sorting support
• No column resizing: Columns have fixed widths
• No row selection: No checkboxes or multi-select
• No filtering: No built-in column filters
• No virtual scrolling: Poor performance with 1000+ rows
• No sticky headers: Headers scroll with content

Pagination

• Fixed styling: Limited customization of appearance
• No page size selector: Items per page is fixed by parent
• No "show all" option: Always paginates if total_pages > 1

Modal

• Single modal limitation: Nested modals not tested, may have z-index issues
• No animation customization: Fade-in animation is fixed
• No position control: Always centered
• No size variants: Width/height controlled by content only

FormField

• Parent-controlled validation: No internal validation logic
• Static error messages: Errors don't animate in/out independently
• No async validation: Parent must handle async validation

Toast

• Fixed duration: Auto-dismiss at 3 seconds (not configurable)
• Fixed position: Always top-right corner
• No stacking limit: Unlimited toasts can stack (could overflow)
• No action buttons: Only dismiss on timeout or click

Badge

• No variant system: Uses custom classes only (no Variant enum)
• No size variants: Fixed size
• No icon support: Text only

Spinner

• CSS animation only: Uses keyframes, not requestAnimationFrame
• No progress indication: Indeterminate spinner only
• Fixed colors: Cyan/purple gradient (no variant customization)

Card

• No collapsible: Always expanded
• No header/footer slots: Free-form content only
• Limited glow colors: Only 5 glow options (None, Cyan, Purple, Pink, Blue)

Button

• No icon support: No built-in icon slots (left/right)
• Loading state visual only: Shows loading prop but parent handles disabled state
• No tooltip: No built-in tooltip on hover

SpaLink

• Basic external detection: Only checks http/https/mailto prefixes
• No active state: No automatic "active" class for current route
• No prefetch: No link prefetching on hover

Design Limitations

Accessibility

• Incomplete ARIA: Only Modal has full ARIA attributes (role, aria-label, aria-modal)
• No screen reader announcements: Toast notifications not announced
• Keyboard navigation: Only Modal has Tab trap, other components lack full keyboard support
• No reduced motion: Animations don't respect prefers-reduced-motion

Internationalization

• No i18n support: All strings are hardcoded
• No RTL support: Layout assumes LTR (left-to-right)
• No locale-aware formatting: Numbers, dates not formatted per locale

Theming

• Hardcoded colors: Glassmorphism colors not customizable via CSS variables
• No dark/light mode: Theme assumes dark background
• UnoCSS dependency: Components rely on UnoCSS classes (not portable to pure CSS)

Performance

• Table re-renders: Entire table re-renders on sort (no virtual DOM optimization)
• Pagination slicing: Creates new array on every page change
• Portal leaks: Portal cleanup uses UUID lookup (potential memory if many modals)

Browser Support

• Modern browsers only: Uses ES2020+ features via wasm-bindgen
• No IE11 support: Relies on CSS Grid, Flexbox, backdrop-filter
• Safari blur limitation: backdrop-blur may have performance issues on older Safari

Testing Gaps

• No unit tests: Components lack unit tests
• No integration tests: No tests for component interactions
• No visual regression tests: No screenshot comparison tests
• Manual testing only: All testing is manual in VAPORA frontend

Documentation Gaps

• No Storybook/demo site: No interactive component showcase
• Limited cookbook: cookbook.md exists but examples are minimal
• No API docs: No generated rustdoc published online
• No migration guide: No guide for upgrading between versions

Future Improvements

High Priority

1. Select component - Most requested missing component
2. Textarea component - Common form control
3. Table virtual scrolling - Performance for large datasets
4. Toast configurability - Allow custom duration, position
5. Accessibility audit - Complete ARIA, keyboard navigation

Medium Priority

1. Checkbox/Radio components - Complete form controls
2. Dialog/ConfirmDialog - More flexible than Modal
3. Input controlled mode - Add value prop for controlled components
4. Table server-side sorting - Support for large datasets
5. Theme customization - CSS variables for colors

Low Priority

1. Tabs component - Nice-to-have layout component
2. Drawer component - Alternative to Modal
3. Progress component - Visual feedback for long operations
4. i18n support - Internationalization framework

Known Bugs

Confirmed Issues

• Modal focus trap edge case: If modal content has no focusable elements, Tab does nothing (should focus close button)
• Pagination boundary: If total_pages changes while on last page that no longer exists, UI shows invalid page number
• Toast overlap: With many rapid toasts, they can overlap vertically (no spacing)
• Table sort stability: Sorting equal values doesn't preserve original order

Unconfirmed Issues

• Safari backdrop-blur: Reported performance issues on Safari 14, not verified
• Portal cleanup timing: UUID-based cleanup may not run if component unmounts during animation

Contributing

If you encounter a limitation not listed here, please:

1. Check if it's a bug or a missing feature
2. Open an issue on GitHub (if repository exists)
3. Consider contributing a fix/implementation

See README.md for contribution guidelines.

---

Last Updated: 2026-02-08 (v1.2.0)