v2.11.2

What's Changed

• chore(release): v2.11.2 [skip ci] (1e2c766)
• docs: add CSS import documentation section (eebb3ba)
• fix(css): use [data-theme='glass'] selector for proper CSS bundling (c8cc458)
• docs: add AnimatedBackgroundGlass to component catalog (815764c)

Full Changelog: v2.11.1...v2.11.2

v2.11.1

What's Changed

• chore(release): v2.11.1 [skip ci] (5011e8e)
• fix: update version comment to reflect JSDoc documentation improvements (946d1d8)
• fix: enhance JSDoc documentation for 30 components with comprehensive API reference (cb183a2)
• chore: auto-update registry files [skip ci] (0379fe6)
• docs: enhance JSDoc for CircularMetricGlass, ContributionMetricsGlass, MetricsGridGlass, UserInfoGlass, and UserStatsLineGlass (Batch 9) (5c6850d)
• docs: enhance JSDoc for MetricCardGlass, AICardGlass, and TrustScoreDisplayGlass (Batch 8) (1f7b60b)
• docs: enhance JSDoc for SortDropdownGlass, StatItemGlass, ExpandableHeaderGlass, and InsightCardGlass (Batch 7) (4b246f7)
• docs: enhance JSDoc for IconButtonGlass, ThemeToggleGlass, and SearchBoxGlass (Batch 6) (bc4ddbd)
• chore: auto-update registry files [skip ci] (6e462b4)
• docs: enhance JSDoc for PopoverGlass, StepperGlass, SidebarGlass, and DropdownGlass (Batch 3) (d53821a)
• docs: enhance JSDoc for ScrollAreaGlass (Batch 5) (db99bdd)
• docs: enhance JSDoc for CircularProgressGlass, SheetGlass, and HoverCardGlass (Batch 4) (2c2465b)
• docs: enhance JSDoc for SelectGlass, SwitchGlass, and ComboBoxGlass (Batch 2) (2ab5781)
• docs: add comprehensive documentation for GlassCard, DropdownMenuGlass, NotificationGlass (22ba327)
• chore: auto-update registry files [skip ci] (7e26d71)
• docs: add comprehensive JSDoc documentation for AnimatedBackgroundGlass (29c4006)

Full Changelog: v2.11.0...v2.11.1

v2.11.0 - Compound Component API for ProfileHeaderGlass

What's Changed

New Feature: Compound Component API (Issue #31)

ProfileHeaderGlass now supports a compound component pattern for maximum flexibility:

<ProfileHeaderGlass.Root layout="horizontal">
  <ProfileHeaderGlass.Profile user={user} showStatus status="online" />
  <ProfileHeaderGlass.AI
    onGenerate={handleGenerate}
    features={['Code review', 'Security audit', 'Performance tips']}
    estimatedTime="~1 minute"
    className="p-6"
  />
</ProfileHeaderGlass.Root>

Sub-Components

• ProfileHeaderGlass.Root - Container with layout context (horizontal | stacked)
• ProfileHeaderGlass.Profile - User information (wraps ProfileHeaderExtendedGlass)
• ProfileHeaderGlass.AI - AI card with full props access (features, estimatedTime, className)

Benefits

• ✅ Custom AICardGlass props (features, estimatedTime, className)
• ✅ Replace AICardGlass entirely with custom component
• ✅ Layout variants: 'horizontal' (50/50 split) | 'stacked' (vertical)
• ✅ Context-based layout propagation to sub-components
• ✅ Error handling for components used outside Root

Backward Compatible

Legacy props-based API is fully preserved:

<ProfileHeaderGlass
  name="John Doe"
  username="johndoe"
  onAIGenerate={() => console.log('Generate')}
/>

Testing & Documentation

• 20 new unit tests (47 total for ProfileHeaderGlass)
• 3 new Storybook stories demonstrating compound usage
• JSDoc with TypeScript examples
• Re-exported types for consumers

Full Changelog: v2.10.0...v2.11.0

v2.10.0 - Layout Variants for ProfileHeaderGlass

What's Changed

New Features

• ProfileHeaderGlass layout variants
  • layout="horizontal" - 50/50 split on desktop (default behavior)
  • layout="stacked" - Vertical stack on all breakpoints
  • Improved component flexibility for different design requirements

Documentation

• Added comprehensive JSDoc with TypeScript examples
• New Storybook stories:
  • StackedLayout - Demonstrates vertical layout
  • WithCustomLayout - Shows custom styling options
• Updated COMPONENTS_CATALOG.md with detailed layout documentation

Testing

• Added 8 new unit tests for layout variants
• Tests cover responsive behavior and variant rendering
• All 94 component tests passing

Improvements

• Better customization options
• Clearer component API
• Enhanced developer experience with better documentation

Full Changelog: v2.9.2...v2.10.0

v2.9.2 - Layout Improvements

What's Changed

Bug Fixes

• Improved ProfileHeaderGlass desktop layout
  • Changed responsive breakpoint from md to lg for better desktop experience
  • ProfileHeaderExtendedGlass now takes exactly 50% width on large screens
  • AICardGlass centered in remaining 50% of space
  • Better visual balance and alignment between profile info and AI card

Improvements

• Enhanced story examples
• Removed deprecated transparent prop from stories

Full Changelog: v2.9.1...v2.9.2

v2.9.1 - ProfileHeaderGlass Refactoring

What's Changed

Refactoring

• ProfileHeaderGlass simplified as composite component
  • Now delegates to ProfileHeaderExtendedGlass (transparent mode) + AICardGlass
  • Removed ~90 lines of duplicate code
  • Improved maintainability - single source of truth for profile display logic
  • ProfileHeaderExtendedGlass handles all user information rendering
  • AICardGlass positioned alongside as separate glass card

Breaking Changes

• Removed transparent prop from ProfileHeaderGlass (no longer needed)
  • ProfileHeaderExtendedGlass is now always rendered in transparent mode within ProfileHeaderGlass
  • If you need transparent mode, use ProfileHeaderExtendedGlass directly

Improvements

• Better code organization and reusability
• Reduced bundle size
• Easier to maintain and extend
• Updated tests to reflect composite architecture

Full Changelog: v2.9.0...v2.9.1

v2.9.0 - AnimatedBackgroundGlass Component

What's Changed

New Features

• AnimatedBackgroundGlass Component: Extracted animated gradient background into reusable component

  • Customizable animation speed and colors
  • Smooth gradient transitions
  • Theme-aware design
  • Full TypeScript support

• Transparent Mode for ProfileHeaderExtendedGlass: Added transparent prop to render without glass background

  • Useful for embedding in custom layouts
  • Maintains all existing functionality
  • Backward compatible

Improvements

• Updated all use-case stories to use new AnimatedBackgroundGlass component
• Enhanced component reusability across demos
• Improved code organization

Files Changed

• src/components/glass/specialized/animated-background-glass.tsx (NEW)
• src/components/glass/sections/profile-header-extended-glass.tsx
• All src/stories/use-cases/*.stories.tsx files updated

Full Changelog: v2.8.1...v2.9.0

v2.8.1

v2.8.1 (2025-12-25)

🐛 Bug Fixes

SegmentedControlGlass

• Improve layout and alignment
• Add w-fit to container for proper sizing
• Add flex-1 and text-center to buttons for equal distribution

YearCardGlass

• Fix component styling issues

📸 Visual Tests

• Updated screenshots for affected components

---

Full Changelog: v2.8.0...v2.8.1

v2.8.0

v2.8.0 (2025-12-24)

✨ New Features

ProfileHeaderExtendedGlass (#29)

Extended user profile header section component with GitHub-compatible fields.

Features:

• GitHub API compatible user interface (name, login, avatar, bio, location, createdAt)
• Extended stats display (repos, followers, following, gists)
• LanguageBarGlass integration for programming language distribution
• Compound component API with 15+ sub-components
• Glass UI styling with theme support (glass, light, aurora)
• Responsive layout (mobile/desktop)
• Accessible with proper ARIA labels

Sub-components:

• ProfileHeaderExtendedGlass.Root - Container with glass styling
• ProfileHeaderExtendedGlass.Avatar - Profile avatar with glow
• ProfileHeaderExtendedGlass.Info - User info container
• ProfileHeaderExtendedGlass.Name - Display name
• ProfileHeaderExtendedGlass.Username - Login/handle with link
• ProfileHeaderExtendedGlass.Bio - User biography
• ProfileHeaderExtendedGlass.Location - Location with icon
• ProfileHeaderExtendedGlass.JoinDate - Join date with calendar icon
• ProfileHeaderExtendedGlass.Stats - Stats container (repos, followers, following, gists)
• ProfileHeaderExtendedGlass.Languages - Language distribution bar

Usage:

import { ProfileHeaderExtendedGlass } from 'shadcn-glass-ui';

<ProfileHeaderExtendedGlass
  user={{
    name: "The Octocat",
    login: "octocat",
    avatar: "https://avatars.githubusercontent.com/u/583231",
    url: "https://github.com/octocat",
    createdAt: "2011-01-25",
    bio: "GitHub mascot",
    location: "San Francisco",
    stats: { repos: 8, followers: 9847, following: 9 }
  }}
  languages={[
    { name: "TypeScript", percentage: 65, color: "#3178c6" },
    { name: "JavaScript", percentage: 25, color: "#f7df1e" },
    { name: "CSS", percentage: 10, color: "#563d7c" }
  ]}
/>

📦 Files Added

• src/components/glass/sections/profile-header-extended-glass.tsx
• src/components/glass/sections/__tests__/profile-header-extended-glass.test.tsx
• src/components/glass/sections/profile-header-extended-glass.stories.tsx
• src/components/__visual__/profile-header-extended.visual.test.tsx
• public/r/profile-header-extended-glass.json

✅ Test Coverage

• 25 unit tests for ProfileHeaderExtendedGlass (100% pass rate)
• Visual regression tests added

---

Full Changelog: v2.7.0...v2.8.0

v2.7.0

✨ New Features

• SeparatorGlass - Visual separator with horizontal/vertical orientation and optional glow effect (#27)
• ScrollAreaGlass - Customizable scrollable area with styled scrollbars (#26)
• HoverCardGlass - Hover-triggered floating content container with rich previews (#24 #25)
• RepositoryCardGlass Enhancement (#28) - Added 8 new sub-components:
  • ContributionBadge - Color-coded contribution percentage badges
  • ForkBadge - Fork indicator with hover preview
  • Language - Language badges with GitHub colors
  • ActivityStatus - Active/recent/stale/inactive status
  • RoleBadge - 5 contributor role types
  • TeamAvatars - Team member avatars with hover cards
  • HealthStatus - Repository health indicators
  • ContributionProgress - Commits/PRs/reviews metrics

🔧 Improvements

• Added 27 utility functions in repository-card-utils.ts
• Added 59 new unit tests (100% pass rate)
• Added 15 new visual regression tests
• Updated registry with 3 new components (74 total)

📦 Dependencies

• @radix-ui/react-hover-card ^1.1.15
• @radix-ui/react-scroll-area ^1.2.10
• @radix-ui/react-separator ^1.1.8

🐛 Bug Fixes

• Fixed arrow default behavior in HoverCardGlass (shown by default)

📊 Statistics

• Total Components: 74
• Test Coverage: 115 unit tests, 582 visual tests
• Pass Rate: 99.5% in CI

---

🚀 Generated with Claude Code