shadcn-glass-ui 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -5,6 +5,133 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.1] - 2025-12-14
+
+### 🐛 Bug Fixes
+
+#### CI/CD Improvements
+
+- **GitHub Packages Publishing** - Fixed publication to GitHub Packages registry
+  - Added `--ignore-scripts` flag to skip `prepublishOnly` hook during GitHub Packages publish
+  - Reuses build artifacts from npm publish step instead of rebuilding
+  - Prevents API Extractor scope validation error with `@Yhooi2` (uppercase scope)
+  - Added graceful handling for `package.json.bak` restore step
+
+### 📦 Published Packages
+
+- **npm Registry**: [shadcn-glass-ui@2.1.1](https://www.npmjs.com/package/shadcn-glass-ui/v/2.1.1)
+- **GitHub Packages**:
+  [@Yhooi2/shadcn-glass-ui@2.1.1](https://github.com/Yhooi2/shadcn-glass-ui-library/packages)
+
+## [2.1.0] - 2025-12-14
+
+### 🎉 Complete v2.0.0 Migration Applied
+
+This release applies all v2.0.0 API changes across the entire codebase, ensuring consistency and
+completing the migration roadmap.
+
+### ✨ Features
+
+#### Component Implementations Updated
+
+- **ButtonGlass** - All instances migrated to v2.0.0 API (`variant="default"`, `variant="link"`,
+  `size="default"`)
+- **ToggleGlass** - All instances migrated to v2.0.0 API (`pressed`, `onPressedChange`)
+- **SliderGlass** - All instances migrated to v2.0.0 API (`value: number[]`, `onValueChange`)
+- **ComboBoxGlass** - All instances migrated to v2.0.0 API (`onValueChange`)
+
+#### Demo Screenshots Added
+
+- 📸 **GitHub Pages screenshots** - Added demo-screenshot.png and demo-screenshot-aurora.png to
+  public directory
+- 🎨 **Visual documentation** - Both Glass and Aurora theme screenshots in README
+
+### 📚 Documentation
+
+#### Comprehensive Documentation Audit
+
+- **Removed v1.x legacy content** (-875 lines total):
+  - Deleted 3 outdated migration guides (select-to-combobox.md, modal-glass-compound-api.md,
+    tabs-glass-compound-api.md)
+  - Streamlined AI_USAGE.md: 1,463 → 855 lines (-42%)
+  - Streamlined BREAKING_CHANGES.md: 585 → 238 lines (-59%)
+  - Updated CLAUDE.md: removed v1.0.0 legacy examples
+- **Fixed all code examples** to use v2.0.0+ API patterns
+- **Fixed broken documentation links** across 16 files
+- **Updated component catalog** with correct API references
+- **Enhanced README** with v2.0.0 API compatibility badge
+
+#### Files Updated (Documentation)
+
+- README.md - Updated Quick Start examples with v2.0.0 API
+- CHANGELOG.md - Added complete v2.0.0 breaking changes
+- CONTRIBUTING.md - Fixed email placeholder
+- docs/AI_USAGE.md - Removed legacy content, focused on v2.0.0+
+- docs/BREAKING_CHANGES.md - Streamlined to v2.0.0 only
+- docs/COMPONENTS_CATALOG.md - Updated component references
+- docs/GETTING_STARTED.md - Fixed CLI command naming
+- docs/BEST_PRACTICES.md - Updated Tailwind version requirement (4.1+)
+- docs/api/README.md - Updated API documentation paths
+- docs/api/interfaces/ - Updated BadgeGlassProps, ButtonGlassProps
+
+### 🔧 Fixes
+
+- **Bundle size badge** - Replaced bundlephobia badge with static size badge (fixes dynamic loading
+  issues)
+
+### 📦 Internal Changes
+
+#### Test Coverage Maintained
+
+- **138/138 tests passing** ✅
+- All Storybook stories updated (.stories.tsx)
+- All unit tests updated (**tests**/)
+- All visual regression tests updated (**visual**/)
+- Compliance tests updated (accessibility, tokens, glassmorphism)
+
+#### Registry Updates
+
+Auto-updated component registry files:
+
+- button-glass.json, toggle-glass.json, slider-glass.json
+- combobox-glass.json, ai-card-glass.json, repository-card-glass.json
+- avatar-glass.json, badge-glass.json, year-card-glass.json
+
+#### Theme Files Updated
+
+Added component-specific CSS variables to all themes:
+
+- glass.css - Updated with semantic token mappings
+- light.css - Updated with semantic token mappings
+- aurora.css - Updated with semantic token mappings
+
+#### Files Changed
+
+- **90 files changed**: 2,556 insertions(+), 3,051 deletions(-)
+- Component implementations: 22 files
+- Storybook stories: 25+ files
+- Tests: 20+ files
+- Documentation: 16 files
+- Registry: 10 files
+- Demos: 6 files
+
+### 🎯 Impact
+
+- **100% codebase consistency** - All code now uses v2.0.0 API
+- **Cleaner documentation** - Removed 875 lines of outdated content
+- **Better DX** - All examples and documentation aligned with current API
+- **Zero tech debt** - No legacy API references remaining
+
+### 📖 Migration Guide
+
+All v2.0.0 migrations are now complete. For reference, see:
+
+- [BREAKING_CHANGES.md](docs/BREAKING_CHANGES.md) - Complete v2.0.0 migration guide
+- [API_PATTERNS_COMPARISON.md](docs/API_PATTERNS_COMPARISON.md) - Component API consistency
+  reference
+
+---
+
 ## [2.0.0] - 2025-12-14
 
 ### 🎉 MAJOR MILESTONE: 100% shadcn/ui API Compatibility

package/README.md

@@ -3,84 +3,42 @@
 [![npm version](https://img.shields.io/npm/v/shadcn-glass-ui.svg)](https://www.npmjs.com/package/shadcn-glass-ui)
 [![npm downloads](https://img.shields.io/npm/dm/shadcn-glass-ui.svg)](https://www.npmjs.com/package/shadcn-glass-ui)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/shadcn-glass-ui?cacheSeconds=86400)](https://bundlephobia.com/package/shadcn-glass-ui)
 [![AI-Friendly](https://img.shields.io/badge/AI-Optimized-blueviolet)](docs/AI_USAGE.md)
-[![Bundle Size](https://img.shields.io/badge/gzip-372KB-success)](https://bundlephobia.com/package/shadcn-glass-ui)
 
-**Glassmorphism UI components for React** — beautiful frosted glass effects, 57 production-ready
-components, 3 themes, drop-in compatible with shadcn/ui.
-
-**[Live Demo](https://yhooi2.github.io/shadcn-glass-ui-library/)** |
-**[Interactive Storybook](https://yhooi2.github.io/shadcn-glass-ui-library/)** |
-**[npm Package](https://www.npmjs.com/package/shadcn-glass-ui)**
+**Glassmorphism components for React** — drop-in compatible with shadcn/ui. 57 components, 3 themes,
+zero migration.
 
 <div align="center">
-  <img src="https://yhooi2.github.io/shadcn-glass-ui-library/demo-screenshot.png" alt="shadcn-glass-ui Demo - Glass Theme" width="100%" />
-  <p><em>Glass theme showcase with glassmorphism effects</em></p>
+  <img src="https://yhooi2.github.io/shadcn-glass-ui-library/demo-screenshot.png" alt="shadcn-glass-ui Demo" width="100%" />
+  <br />
+  <a href="https://yhooi2.github.io/shadcn-glass-ui-library/"><strong>Live Demo</strong></a> ·
+  <a href="https://www.npmjs.com/package/shadcn-glass-ui"><strong>npm</strong></a> ·
+  <a href="docs/GETTING_STARTED.md"><strong>Docs</strong></a>
 </div>
 
 ---
 
-## Why shadcn-glass-ui?
-
-| Feature              | shadcn-glass-ui                      | Standard shadcn/ui  |
-| -------------------- | ------------------------------------ | ------------------- |
-| **Themes**           | 3 built-in (Glass/Light/Aurora)      | 1 base theme        |
-| **Glass Effects**    | Native blur, glow, transparency      | Manual CSS required |
-| **AI Documentation** | Optimized for Claude, Copilot, GPT   | Basic docs          |
-| **Components**       | 57 specialized glassmorphism         | ~40 base components |
-| **Token System**     | 225 OKLCH primitives, zero hardcoded | CSS variables       |
-| **Accessibility**    | WCAG 2.1 AA + 44px touch targets     | Basic a11y          |
-
-**Key advantages:**
-
-- Works alongside existing shadcn/ui components — same patterns, same CLI
-- AI-first documentation with decision trees and Context7 integration
-- 1,500+ tests (visual regression, compliance, unit)
-- 3-layer token system with zero hardcoded values
-
----
-
 ## Quick Start
 
-**Requirements:** React 18+, Tailwind CSS 4.1+
-
-### Install
-
 ```bash
 npm install shadcn-glass-ui
 ```
 
-### Use
-
 ```tsx
-import { ButtonGlass, InputGlass, ThemeProvider } from 'shadcn-glass-ui';
+import { ButtonGlass, ThemeProvider } from 'shadcn-glass-ui';
 import 'shadcn-glass-ui/dist/styles.css';
 
-function App() {
+export default function App() {
   return (
     <ThemeProvider defaultTheme="glass">
-      <div className="p-8 space-y-4">
-        <ButtonGlass variant="default" size="lg">
-          Click me
-        </ButtonGlass>
-        <InputGlass placeholder="Enter text..." />
-      </div>
+      <ButtonGlass variant="default">Click me</ButtonGlass>
     </ThemeProvider>
   );
 }
 ```
 
-**[Full Getting Started Guide →](docs/GETTING_STARTED.md)**
-
----
-
-## Installation Methods
-
-### Option 1: shadcn CLI (Recommended)
-
-Listed on [registry.directory](https://registry.directory)!
-
-Add to `components.json`:
+**Or via shadcn CLI** — add to `components.json`:
 
 ```json
 {
@@ -92,332 +50,129 @@ Add to `components.json`:
 }
 ```
 
-Install components:
-
-```bash
-npx shadcn@latest add @shadcn-glass-ui/button-glass @shadcn-glass-ui/input-glass
-```
-
-**[Registry Documentation →](docs/REGISTRY_USAGE.md)**
-
-### Option 2: npm Package
-
 ```bash
-npm install shadcn-glass-ui
+npx shadcn@latest add @shadcn-glass-ui/button-glass
 ```
 
-**[npm Installation Guide →](docs/GETTING_STARTED.md)**
-
 ---
 
-## Components
-
-| Category        | Count | Examples                                                      |
-| --------------- | ----- | ------------------------------------------------------------- |
-| **Core UI**     | 18    | ButtonGlass, InputGlass, ModalGlass, TabsGlass, CheckboxGlass |
-| **Atomic**      | 7     | SearchBoxGlass, ThemeToggleGlass, IconButtonGlass             |
-| **Composite**   | 13    | MetricCardGlass, AICardGlass, YearCardGlass                   |
-| **Sections**    | 7     | HeaderNavGlass, ProfileHeaderGlass, CareerStatsGlass          |
-| **Specialized** | 10    | SparklineGlass, StepperGlass, RainbowProgressGlass            |
-| **Primitives**  | 3     | TouchTarget, FormFieldWrapper, InteractiveCard                |
+## Choose Your Path
 
-<details>
-<summary><strong>Core UI (18)</strong> — Essential building blocks</summary>
-
-ButtonGlass, InputGlass, CheckboxGlass, ToggleGlass, SliderGlass, ModalGlass, TabsGlass,
-DropdownGlass, TooltipGlass, AlertGlass, NotificationGlass, BadgeGlass, AvatarGlass, GlassCard,
-ProgressGlass, CircularProgressGlass, SkeletonGlass, ComboBoxGlass
-
-</details>
-
-<details>
-<summary><strong>Atomic (7)</strong> — Single-purpose components</summary>
-
-IconButtonGlass, ThemeToggleGlass, SearchBoxGlass, SortDropdownGlass, StatItemGlass,
-ExpandableHeaderGlass, InsightCardGlass
-
-</details>
-
-<details>
-<summary><strong>Composite (13)</strong> — Pre-built complex widgets</summary>
-
-MetricCardGlass, YearCardGlass, AICardGlass, RepositoryCardGlass, TrustScoreDisplayGlass,
-CircularMetricGlass, UserStatsLineGlass, UserInfoGlass, CareerStatsHeaderGlass,
-ContributionMetricsGlass, MetricsGridGlass, RepositoryHeaderGlass, RepositoryMetadataGlass
-
-</details>
-
-<details>
-<summary><strong>Sections (7)</strong> — Full page sections</summary>
-
-HeaderNavGlass, ProfileHeaderGlass, CareerStatsGlass, FlagsSectionGlass, TrustScoreCardGlass,
-ProjectsListGlass, HeaderBrandingGlass
-
-</details>
-
-<details>
-<summary><strong>Specialized (10)</strong> — Advanced components</summary>
-
-StatusIndicatorGlass, SegmentedControlGlass, RainbowProgressGlass, LanguageBarGlass,
-ProfileAvatarGlass, FlagAlertGlass, BaseProgressGlass, SparklineGlass, StepperGlass (compound API
-with 3 variants)
-
-</details>
-
-**[Full Component Catalog →](docs/COMPONENTS_CATALOG.md)** |
-**[Try in Storybook →](https://yhooi2.github.io/shadcn-glass-ui-library/)**
+| Goal                    | Resource                                                       |
+| ----------------------- | -------------------------------------------------------------- |
+| **Get started**         | [Getting Started Guide](docs/GETTING_STARTED.md)               |
+| **Browse components**   | [Storybook](https://yhooi2.github.io/shadcn-glass-ui-library/) |
+| **Use with AI**         | [AI Usage Guide](docs/AI_USAGE.md)                             |
+| **Create custom theme** | [Theme Guide](docs/THEME_CREATION_GUIDE.md)                    |
+| **Migrate from v1.x**   | [Breaking Changes](docs/BREAKING_CHANGES.md)                   |
 
 ---
 
-## Themes
+## Why shadcn-glass-ui?
 
-Three built-in themes with seamless switching:
+|                   | shadcn-glass-ui                 | shadcn/ui    |
+| ----------------- | ------------------------------- | ------------ |
+| **Themes**        | 3 built-in (Glass/Light/Aurora) | 1 base       |
+| **Glass effects** | Native blur, glow, transparency | Manual CSS   |
+| **Components**    | 57 specialized                  | ~40 base     |
+| **Custom theme**  | 15 lines CSS                    | Full rewrite |
+| **AI docs**       | Context7, Claude Code, Copilot  | Basic        |
 
-- **Glass (Dark)** — Frosted glass effects with purple accents, blur + glow
-- **Light** — Clean minimal design with subtle glass effects
-- **Aurora** — Gradient glow with aurora borealis-inspired colors
+**Works alongside shadcn/ui** — same API, same CLI, no migration:
 
 ```tsx
-import { ThemeProvider, useTheme } from 'shadcn-glass-ui';
+import { Button } from '@/components/ui/button';           // shadcn/ui
+import { ButtonGlass } from '@/components/glass/ui/button-glass';  // Glass variant
 
-function ThemeSwitcher() {
-  const { theme, cycleTheme } = useTheme();
-  return <button onClick={cycleTheme}>Theme: {theme}</button>;
-}
+<Button variant="outline">Standard</Button>
+<ButtonGlass variant="default">Glassmorphism</ButtonGlass>
 ```
 
-**[Theme Creation Guide →](docs/THEME_CREATION_GUIDE.md)**
-
 ---
 
-## 3-Layer Token System
-
-Centralized color management with **zero hardcoded values**.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Component Tokens   --btn-primary-bg, --modal-surface       │
-│         ↓                                                   │
-│  Semantic Tokens    --semantic-primary, --semantic-surface  │
-│         ↓                                                   │
-│  Primitive Tokens   --oklch-purple-500 (225 OKLCH colors)   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-| Metric                  | Before (v1.x)  | After (v2.0)         |
-| ----------------------- | -------------- | -------------------- |
-| Hardcoded OKLCH values  | ~280 per theme | **0**                |
-| CSS variables per theme | ~85            | **296+ (inherited)** |
+## Components
 
-**How it works:**
+| Category        | Count | Examples                                           |
+| --------------- | ----- | -------------------------------------------------- |
+| **Core UI**     | 18    | ButtonGlass, InputGlass, ModalGlass, TabsGlass     |
+| **Composite**   | 13    | MetricCardGlass, AICardGlass, RepositoryCardGlass  |
+| **Specialized** | 10    | StepperGlass, SparklineGlass, RainbowProgressGlass |
+| **Sections**    | 7     | HeaderNavGlass, ProfileHeaderGlass                 |
+| **Atomic**      | 7     | SearchBoxGlass, ThemeToggleGlass                   |
+| **Primitives**  | 3     | TouchTarget, FormFieldWrapper                      |
 
-1. Define ~15 semantic tokens for your theme
-2. 280+ component tokens are inherited automatically
-3. All 57 components update instantly
-
-```css
-/* Create a "neon" theme */
-[data-theme='neon'] {
-  --semantic-primary: var(--oklch-cyan-400);
-  --semantic-surface: var(--oklch-slate-950);
-  --semantic-text: var(--oklch-white-95);
-  /* ... ~12 more tokens */
-}
-```
-
-**[Token Architecture Guide →](docs/TOKEN_ARCHITECTURE.md)** |
-**[Theme Creation Guide →](docs/THEME_CREATION_GUIDE.md)**
+[**Browse all 57 components →**](https://yhooi2.github.io/shadcn-glass-ui-library/)
 
 ---
 
-## Full shadcn/ui Compatibility
-
-### 🎉 v2.0.0: 100% API Compatible
-
-**Install on top of existing shadcn/ui projects** — no migration required!
-
-All components now follow **exact shadcn/ui API conventions**:
-
-| Component         | shadcn/ui API                      | shadcn-glass-ui v2.0+ | Status |
-| ----------------- | ---------------------------------- | --------------------- | ------ |
-| **ButtonGlass**   | `variant="default"`                | ✅ Same               | 100%   |
-| **ToggleGlass**   | `pressed`, `onPressedChange`       | ✅ Same               | 100%   |
-| **SliderGlass**   | `value: number[]`, `onValueChange` | ✅ Same               | 100%   |
-| **ComboBoxGlass** | `value`, `onValueChange`           | ✅ Same               | 100%   |
-
-**Key improvements in v2.0:**
-
-- `onChange` → `onValueChange` (Select, ComboBox, Slider)
-- `checked` → `pressed` (Toggle components)
-- `variant="default"` → `variant="default"` (Button)
-- Array-based values for Slider (`number[]` instead of `number`)
+## Themes
 
-| Feature           | shadcn-glass-ui                                 | Standard shadcn/ui      |
-| ----------------- | ----------------------------------------------- | ----------------------- |
-| CLI installation  | `npx shadcn add @shadcn-glass-ui/button-glass`  | `npx shadcn add button` |
-| Core props        | `variant`, `size`, `className`                  | Same                    |
-| Callback names    | `onValueChange`, `onPressedChange`              | Same                    |
-| asChild pattern   | Full support                                    | Full support            |
-| TypeScript        | Strict mode                                     | Same                    |
-| Extended features | `loading`, `icon`, compound APIs, glassmorphism | —                       |
+Three built-in themes with instant switching:
 
-**Mix and match freely:**
+- **Glass** — Dark glassmorphism with purple accents
+- **Light** — Clean minimal with subtle glass
+- **Aurora** — Gradient glow effects
 
 ```tsx
-import { Button } from '@/components/ui/button'; // Standard shadcn/ui
-import { ButtonGlass } from '@/components/glass/ui/button-glass'; // Glass variant
-
-function App() {
-  return (
-    <>
-      <Button variant="outline">Standard</Button>
-      <ButtonGlass variant="default">Glassmorphism</ButtonGlass>
-    </>
-  );
-}
+const { theme, cycleTheme } = useTheme();
+<button onClick={cycleTheme}>Theme: {theme}</button>;
 ```
 
-**Add to existing project:**
-
-```bash
-# No migration needed - just add to components.json
-npx shadcn@latest add @shadcn-glass-ui/button-glass
-```
-
-**[Registry Documentation →](docs/REGISTRY_USAGE.md)**
+**Create custom themes in ~15 lines** — [Theme Guide](docs/THEME_CREATION_GUIDE.md)
 
 ---
 
-## AI-First Documentation
+## AI-Optimized
 
-Built for AI coding assistants — Claude, Copilot, GPT understand this library perfectly.
+Built for AI coding assistants:
 
-| AI Tool            | Integration                                                    | What it provides                           |
-| ------------------ | -------------------------------------------------------------- | ------------------------------------------ |
-| **Claude Code**    | [CLAUDE.md](CLAUDE.md)                                         | 365-line project context, all patterns     |
-| **Context7 MCP**   | [Indexed](https://context7.com/yhooi2/shadcn-glass-ui-library) | 41 rules, auto-fetched docs, version-aware |
-| **GitHub Copilot** | TypeScript strict + JSDoc                                      | Accurate completions, type inference       |
-| **ChatGPT/GPT-4**  | [EXPORTS_MAP.json](docs/EXPORTS_MAP.json)                      | Machine-readable component registry        |
+| Tool             | Integration                                                                    |
+| ---------------- | ------------------------------------------------------------------------------ |
+| **Context7 MCP** | [Auto-indexed](https://context7.com/yhooi2/shadcn-glass-ui-library) — 41 rules |
+| **Claude Code**  | [CLAUDE.md](CLAUDE.md) — 365 lines of context                                  |
+| **Copilot**      | TypeScript strict + JSDoc                                                      |
 
-**Context7 MCP enables:**
-
-```
-AI: "Add a stepper component to my checkout flow"
-
-→ Context7 fetches StepperGlass docs automatically
-→ AI reads: "compound API, linear mode for wizards"
-→ AI generates correct code with all props
-```
-
-**[AI Usage Guide →](docs/AI_USAGE.md)** — Decision trees, migration scripts, component
-recommendations
+[**AI Usage Guide →**](docs/AI_USAGE.md)
 
 ---
 
-## CLI
+## Documentation
 
-```bash
-npx shadcn-glass-ui info button     # Component info (fuzzy search)
-npx shadcn-glass-ui list            # List all components
-npx shadcn-glass-ui list --category=core  # Filter by category
-```
+| Resource                                                           | Description           |
+| ------------------------------------------------------------------ | --------------------- |
+| [**Storybook**](https://yhooi2.github.io/shadcn-glass-ui-library/) | Interactive demos     |
+| [**Getting Started**](docs/GETTING_STARTED.md)                     | Installation & setup  |
+| [**Component Catalog**](docs/COMPONENTS_CATALOG.md)                | All 57 components     |
+| [**Theme Guide**](docs/THEME_CREATION_GUIDE.md)                    | Custom themes         |
+| [**Token Architecture**](docs/TOKEN_ARCHITECTURE.md)               | 3-layer CSS system    |
+| [**AI Usage**](docs/AI_USAGE.md)                                   | Claude, Copilot, GPT  |
+| [**Breaking Changes**](docs/BREAKING_CHANGES.md)                   | v1.x → v2.0 migration |
 
 ---
 
-## FAQ
-
-<details>
-<summary><strong>How do I migrate from v1.x to v2.0?</strong></summary>
+## Requirements
 
-v2.0 renames CSS variables to semantic names. Run automated migration:
-
-```bash
-find src/ -type f \( -name "*.tsx" -o -name "*.css" \) -exec sed -i '' \
-  -e 's/--metric-emerald-/--metric-success-/g' \
-  -e 's/--metric-amber-/--metric-warning-/g' \
-  -e 's/--metric-blue-/--metric-default-/g' \
-  -e 's/--metric-red-/--metric-destructive-/g' {} +
-```
-
-**[Full Migration Guide →](docs/BREAKING_CHANGES.md)**
-
-</details>
-
-<details>
-<summary><strong>What are the requirements?</strong></summary>
-
-- React 18.0+ or 19.0+
-- React-DOM 18.0+ or 19.0+
+- React 18+ or 19+
 - Tailwind CSS 4.1+
 - Node.js 20.16+
 
-</details>
-
-<details>
-<summary><strong>Where are breaking changes documented?</strong></summary>
-
-- **[BREAKING_CHANGES.md](docs/BREAKING_CHANGES.md)** — v1.0 and v2.0 changes
-- **[CHANGELOG.md](CHANGELOG.md)** — Complete version history
-- **[Migration Guides](docs/migration/)** — Step-by-step migration
-
-</details>
-
-<details>
-<summary><strong>How do I use Compound Components (Modal, Tabs, Stepper)?</strong></summary>
-
-```tsx
-<ModalGlass.Root open={open} onOpenChange={setOpen}>
-  <ModalGlass.Overlay />
-  <ModalGlass.Content>
-    <ModalGlass.Header>
-      <ModalGlass.Title>Title</ModalGlass.Title>
-      <ModalGlass.Close />
-    </ModalGlass.Header>
-    <ModalGlass.Body>Content</ModalGlass.Body>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
-**[Advanced Patterns →](docs/ADVANCED_PATTERNS.md)**
-
-</details>
-
----
-
-## Documentation
-
-| Resource                                                           | Description                 |
-| ------------------------------------------------------------------ | --------------------------- |
-| **[Storybook](https://yhooi2.github.io/shadcn-glass-ui-library/)** | Interactive component demos |
-| **[Getting Started](docs/GETTING_STARTED.md)**                     | Setup tutorial              |
-| **[Component Catalog](docs/COMPONENTS_CATALOG.md)**                | All 57 components           |
-| **[AI Usage Guide](docs/AI_USAGE.md)**                             | For Claude, Copilot, GPT    |
-| **[Theme Guide](docs/THEME_CREATION_GUIDE.md)**                    | Create custom themes        |
-| **[Token Architecture](docs/TOKEN_ARCHITECTURE.md)**               | 3-layer CSS token system    |
-| **[Advanced Patterns](docs/ADVANCED_PATTERNS.md)**                 | asChild, Compound APIs      |
-| **[Breaking Changes](docs/BREAKING_CHANGES.md)**                   | Migration guides            |
-
 ---
 
 ## Contributing
 
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md).
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 
-MIT — See [LICENSE](LICENSE)
-
-## Credits
-
-Built with [shadcn/ui](https://ui.shadcn.com/), [Radix UI](https://www.radix-ui.com/),
-[Tailwind CSS](https://tailwindcss.com/), [Vite](https://vitejs.dev/)
+MIT — [LICENSE](LICENSE)
 
 ---
 
 <div align="center">
-
-**[Star on GitHub](https://github.com/Yhooi2/shadcn-glass-ui-library)** if you find this useful!
-
-[![Star History Chart](https://api.star-history.com/svg?repos=Yhooi2/shadcn-glass-ui-library&type=Date)](https://star-history.com/#Yhooi2/shadcn-glass-ui-library)
-
+  <strong>Built with</strong>
+  <a href="https://ui.shadcn.com/">shadcn/ui</a> ·
+  <a href="https://www.radix-ui.com/">Radix UI</a> ·
+  <a href="https://tailwindcss.com/">Tailwind CSS</a>
+  <br /><br />
+  <a href="https://github.com/Yhooi2/shadcn-glass-ui-library">Star on GitHub</a> if you find this useful!
 </div>

package/docs/BREAKING_CHANGES.md

@@ -1,8 +1,11 @@
 # Breaking Changes
 
-This document lists breaking changes in shadcn-glass-ui v2.0.0.
+This document lists breaking changes in shadcn-glass-ui v2.0.0 and later.
 
-**Current Version:** 2.0.0 (2025-12-14)
+**Current Version:** 2.1.0 (2025-12-14)
+
+> **Note:** As of v2.1.0, all v2.0.0 migrations are complete across the entire codebase. All
+> components, examples, and documentation now use the new API.
 
 ---
 

package/docs/GETTING_STARTED.md

@@ -364,7 +364,7 @@ export function ThemeSwitcher() {
   return (
     <div className="flex gap-2">
       <ButtonGlass
-        variant={theme === 'glass' ? 'primary' : 'ghost'}
+        variant={theme === 'glass' ? 'default' : 'ghost'}
         size="sm"
         onClick={() => setTheme('glass')}
       >
@@ -372,7 +372,7 @@ export function ThemeSwitcher() {
       </ButtonGlass>
 
       <ButtonGlass
-        variant={theme === 'light' ? 'primary' : 'ghost'}
+        variant={theme === 'light' ? 'default' : 'ghost'}
         size="sm"
         onClick={() => setTheme('light')}
       >
@@ -380,7 +380,7 @@ export function ThemeSwitcher() {
       </ButtonGlass>
 
       <ButtonGlass
-        variant={theme === 'aurora' ? 'primary' : 'ghost'}
+        variant={theme === 'aurora' ? 'default' : 'ghost'}
         size="sm"
         onClick={() => setTheme('aurora')}
       >

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "shadcn-glass-ui",
   "private": false,
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Glassmorphism UI library for React - AI-friendly with 57 components, strict TypeScript, and comprehensive docs",
   "author": "Yhooi2",
   "license": "MIT",