shadcn-glass-ui 1.0.7 → 1.0.9

package/CHANGELOG.md

@@ -5,6 +5,62 @@ 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).
 
+## [1.0.9] - 2025-12-06
+
+### 🐛 Bug Fixes
+
+**CSS Import Order:**
+- Fixed PostCSS warnings by moving all `@import` directives before CSS rules
+- All imports now precede style declarations (per CSS spec requirement)
+- Build process now runs completely clean without warnings
+
+**Result:** Zero PostCSS warnings in production build
+
+## [1.0.8] - 2025-12-06
+
+### 📚 Documentation
+
+**Major CLAUDE.md Restructure - AI-Friendly Documentation:**
+- Added **Quick Commands Cheatsheet** at the top for instant reference
+- Added **Common Tasks for AI** section with step-by-step workflows:
+  - Adding new Glass components
+  - Fixing visual regression tests
+  - Migrating to compound API
+  - Adding new themes
+- Added **File Organization Map** with visual directory structure
+- Added **Component Anatomy Pattern** with code examples
+- Added **Theme System Quick Reference** with usage examples
+- Added **Testing Strategy** section with comprehensive table and workflow
+- Added **Architecture Decisions** explaining technology choices:
+  - Why Vite 7 (rolldown-vite)
+  - Why Compound Components
+  - Why Visual Regression on Linux only
+  - Why CVA for variants
+  - Why asChild pattern
+- Added **AI Assistant Guidelines** with DO/DO NOT lists
+- Added comprehensive **Troubleshooting** section:
+  - Visual tests fail on macOS
+  - Stale visual test baselines after merge
+  - TypeScript errors after npm install
+  - Storybook fails to start
+  - Component not appearing in Storybook
+  - Module not found errors
+  - Component variants not applying
+  - Performance regressions
+  - Linting errors
+- Reorganized **Glass Components Structure** for better readability
+- Enhanced commands with `npm run lint:fix` and `npm run typecheck`
+
+**Goal:** AI assistants can now understand any typical task in 10 seconds.
+
+### 🎯 Benefits
+
+- **Faster onboarding** for AI tools (Claude Code, GitHub Copilot, etc.)
+- **Clear decision context** - understand WHY technologies were chosen
+- **Quick troubleshooting** - common issues solved in seconds
+- **Better task planning** - step-by-step workflows for all common tasks
+- **Reduced confusion** - explicit DO/DO NOT guidelines
+
 ## [1.0.7] - 2025-12-06
 
 ### 🔄 Changed

package/README.md

@@ -8,13 +8,17 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-19.2-blue)](https://reactjs.org/)
 [![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.1-blue)](https://tailwindcss.com/)
+[![AI-Friendly](https://img.shields.io/badge/AI-Friendly-blueviolet?logo=openai)](docs/AI_USAGE.md)
+[![Claude Code](https://img.shields.io/badge/Claude-Code-5865F2?logo=anthropic)](docs/AI_USAGE.md)
+[![GitHub Copilot](https://img.shields.io/badge/GitHub-Copilot-181717?logo=github)](docs/AI_USAGE.md)
 
-Modern glassmorphism UI component library for React with full shadcn/ui compatibility.
+Glassmorphism UI library for React - AI-friendly with 55+ components, strict TypeScript, and comprehensive docs.
 
 ## ✨ Highlights
 
 - 🎨 **55 Components** - Core UI (18) + Atomic (6) + Composite (13) + Sections (7) + Specialized (8) + Primitives (3)
 - 🌈 **3 Themes** - Glass (dark glassmorphism), Light (clean minimal), Aurora (gradient glow)
+- 🤖 **AI-Friendly** - Optimized for Claude Code, Copilot, GPT with comprehensive docs
 - 🔮 **Advanced Patterns** - asChild polymorphic rendering, Compound components (Modal, Tabs)
 - ♿ **WCAG 2.1 AA** - Full accessibility compliance with automated testing
 - 📱 **Touch Optimized** - 44×44px minimum touch targets (Apple HIG)
@@ -35,6 +39,20 @@ Modern glassmorphism UI component library for React with full shadcn/ui compatib
 
 See [DEPENDENCIES.md](DEPENDENCIES.md) for detailed dependency documentation.
 
+## 🤖 AI Assistant Support
+
+This library is **optimized for AI coding assistants** including Claude Code, GitHub Copilot, and ChatGPT:
+
+- 📖 **Dedicated AI Guide** - [AI_USAGE.md](docs/AI_USAGE.md) with decision trees and workflows
+- 🎯 **TypeScript Strict Mode** - Full type inference for autocomplete
+- 📝 **Rich JSDoc** - Every component documented with @example, @accessibility
+- 🗂️ **Component Catalog** - [COMPONENTS_CATALOG.md](docs/COMPONENTS_CATALOG.md) with searchable index
+- 🔍 **Exports Map** - Machine-readable [EXPORTS_MAP.json](docs/EXPORTS_MAP.json)
+- 🧪 **Real-World Examples** - Use-case based Storybook stories
+- 📦 **shadcn CLI Compatible** - Install components via `npx shadcn add @shadcn-glass-ui/button-glass`
+
+[**→ Read AI Usage Guide**](docs/AI_USAGE.md) | [**→ Component Catalog**](docs/COMPONENTS_CATALOG.md)
+
 ## 📚 Documentation
 
 - **[Live Storybook](https://yhooi2.github.io/shadcn-glass-ui-library/)** - Interactive component demos

package/dist/components.cjs

@@ -1,7 +1,7 @@
-const require_trust_score_card_glass = require("./trust-score-card-glass-CZeCRkHL.cjs");
-require("./utils-Ba5INf7M.cjs");
-require("./use-focus-CUkhhBRX.cjs");
-require("./theme-context-e3yxC7A6.cjs");
+const require_trust_score_card_glass = require("./trust-score-card-glass-Dq28n8en.cjs");
+require("./utils-3cDWhVvH.cjs");
+require("./use-focus-CH8KNgcY.cjs");
+require("./theme-context-BcTQdqsj.cjs");
 exports.AICardGlass = require_trust_score_card_glass.AICardGlass;
 exports.AlertGlass = require_trust_score_card_glass.AlertGlass;
 exports.AvatarGlass = require_trust_score_card_glass.AvatarGlass;