Release Notes
Track the evolution of @fidus/ui component library. All notable changes are documented here.
v1.8.0
LatestNew ComponentNew Components
Text input with type-ahead suggestions, keyboard navigation (Arrow keys, Enter, Escape), clearable input, custom value support, and full accessibility with ARIA combobox pattern.
Component Features
✅ Full keyboard navigation (↑↓ arrows, Enter to select, Escape to close)
✅ Controlled and uncontrolled modes with value and onChange
✅ Clearable input with X button
✅ Custom value support with allowCustomValue prop
✅ Suggestion filtering and limiting with maxSuggestions
✅ Error and helper text states for form validation
✅ ARIA combobox/listbox pattern for screen readers
✅ Zod schema for runtime prop validation
Migration
✅ Zero breaking changes
This is a minor release that adds the new Autocomplete component. No changes required for existing code. Import with import { Autocomplete } from '@fidus/ui/autocomplete'
v1.7.2
Bug Fixes
✅ Fixed missing Message type imports in design system pages
✅ Removed double semicolons from import statements across design system
✅ Design system now builds successfully with all 97 pages
Migration
✅ Zero breaking changes
This is a patch release that fixes build errors. No changes required for existing code.
v1.7.1
Phase 3 Tree-ShakingTree-Shaking Configuration
✅ 47 subpath exports configured (45 components + index + tailwind)
✅ sideEffects: false for aggressive tree-shaking
✅ Automated export generation script at scripts/generate-exports.ts
✅ Per-component bundles with TypeScript definitions (.d.ts, .d.mts)
Recommended Usage:
// ✅ Optimized (production)
import { Button } from '@fidus/ui/button';
import { Stack } from '@fidus/ui/stack';
import { Alert } from '@fidus/ui/alert';
// ✅ Still works (development)
import { Button } from '@fidus/ui/button';
import { Stack } from '@fidus/ui/stack';
import { Alert } from '@fidus/ui/alert';Documentation & Integration
✅ Comprehensive tree-shaking guide in README with bundle size comparison
✅ React Hook Form integration examples with basic validation
✅ Zod schema validation examples for type-safe forms
✅ Subpath import reference for all 45 components
✅ Form component compatibility documentation
Migration
✅ Zero breaking changes
Existing barrel imports continue to work. Gradually adopt subpath imports for production builds to benefit from tree-shaking. All components remain fully backward compatible.
v1.6.0
Phase 2 SSR EnhancementsExample Projects (3 complete implementations)
Complete example at /examples/nextjs-app-router showcasing 15+ components with Tailwind CSS integration and comprehensive README.
Traditional SSR example at /examples/nextjs-pages-router demonstrating server-side rendering with classic Next.js architecture.
Client-side rendering example at /examples/vite-react showing fast development workflow with Vite build tooling.
Comprehensive SSR Testing
All 40+ components tested with renderToString() compatibility. Verified Portal components (Toast, Modal, Drawer) don't crash during SSR. 100% test pass rate across all component variants and edge cases.
Documentation Improvements
✅ Examples README with quick-start guide and framework-specific notes
✅ Updated @fidus/ui README with comprehensive SSR section
✅ Component API usage patterns verified in real Next.js/Vite apps
✅ SSR test suite documents expected behavior for all components
Key Insights
• Portal components (Radix UI) correctly return empty HTML in SSR (expected behavior)
• Client-side components with 'use client' still render structure safely in SSR
• All 16 SSR-optimized components work seamlessly across frameworks
Migration
✅ No code changes required - this is a documentation and testing release
Use example projects as reference for integrating @fidus/ui in your app. All existing features remain fully backward compatible.
v1.5.0
SSR OptimizationSSR-Optimized Components (16 total)
Phase 1 (12 components): Alert, Banner, Chip, DetailCard, Checkbox, RadioButton, ToggleSwitch, ErrorState, ConfidenceIndicator, Avatar, Breadcrumbs, Pagination
Phase 2 (4 components): TextInput, TextArea, FileUpload, TimePicker
~25-28% reduction in client-side JavaScript bundle. Improved Core Web Vitals (FCP, LCP, TTI) for Next.js 14+ App Router, Remix, and Gatsby.
v1.2.0
Chat UI ComponentsNew Components
Complete chat layout with message streaming support, scrollable message list, auto-scroll behavior, and textarea input with keyboard shortcuts (Enter to send, Shift+Enter for newline).
Chat message component with role-based styling (user right, assistant left), avatars, timestamps, and AI suggestion chips with privacy badges and tooltips.
ML confidence visualization with color-coded badges (green for high confidence, blue for medium, yellow for learning, gray for uncertain). Automatically integrated into MessageBubble suggestions.
Enhanced Components
Now supports privacy badges array for displaying multiple privacy levels and data categories.
Build Improvements
Fixed bundling configuration for react-markdown and remark-gfm dependencies, improving build performance and reducing bundle size.
Technical Details
- All components built with 100% Fidus UI primitives (Stack, Chip, Avatar, Button)
- Design tokens for consistent spacing (p-md, gap-sm, gap-xs)
- Comprehensive TypeScript types with Zod schemas for runtime validation
- 72 new tests added (21 MessageBubble + 21 ChatInterface + 30 ConfidenceIndicator)
- Full accessibility support with ARIA labels and keyboard navigation
- CVA (class-variance-authority) for component variants
Real-World Usage
These components are used in production in the Fidus Memory Prototype to provide conversational AI interactions with preference learning and context awareness.
v1.1.0
Initial Chat ComponentsInitial implementation of chat UI components (MessageBubble, ChatInterface, ConfidenceIndicator) with basic functionality and comprehensive documentation.
v1.0.2
DocumentationImproved README documentation with component table. Reorganized component list into structured tables with descriptions for better readability and discoverability.
v1.0.1
Bug Fixes- Corrected README.md documentation with accurate component list (41 components)
- Removed false information from README.md (non-existent Discord link, CSS imports)
- Fixed GitHub Actions workflow permissions for GitHub Release creation
v1.0.0
Initial ReleaseInitial component library setup with core components:
• Button, Card, Input, Select, Toast, Dialog, Dropdown Menu
• Progress, Tabs, Tooltip, Calendar components
• Responsive design with mobile-first approach
• Zod validation schemas and comprehensive TypeScript types
• npm package publishing infrastructure
View on GitHub
For complete changelog and technical details, see the CHANGELOG.md in the @fidus/ui package repository.