shadcn-glass-ui 2.0.11 → 2.1.0

package/dist/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/docs/migration/modal-glass-compound-api.md

@@ -1,458 +0,0 @@
-# ModalGlass Compound API Migration Guide
-
-**Version:** v1.0.0
-**Status:** ⚠️ Legacy API removed - Compound API only
-
----
-
-## Why Migrate?
-
-The new **Compound Component API** provides:
-
-✅ **Better composition** - Build complex modals with fine-grained control
-✅ **Radix UI patterns** - Follows industry-standard component architecture
-✅ **More control** - Customize each part independently
-✅ **Easier styling** - Target specific sections without prop drilling
-✅ **Type safety** - Better TypeScript inference for each sub-component
-✅ **Accessibility** - Enhanced ARIA attributes and keyboard navigation
-
----
-
-## API Comparison
-
-### Legacy API (Removed in v1.0.0)
-
-```tsx
-<ModalGlass
-  isOpen={open}
-  onClose={() => setOpen(false)}
-  title="Confirm Action"
-  description="Are you sure you want to proceed?"
-  size="md"
->
-  <p>Modal body content goes here</p>
-  <div className="flex gap-2">
-    <ButtonGlass variant="outline" onClick={() => setOpen(false)}>
-      Cancel
-    </ButtonGlass>
-    <ButtonGlass onClick={handleConfirm}>
-      Confirm
-    </ButtonGlass>
-  </div>
-</ModalGlass>
-```
-
-### Compound API (Recommended)
-
-```tsx
-<ModalGlass.Root open={open} onOpenChange={setOpen}>
-  <ModalGlass.Overlay />
-  <ModalGlass.Content size="md">
-    <ModalGlass.Header>
-      <ModalGlass.Title>Confirm Action</ModalGlass.Title>
-      <ModalGlass.Description>
-        Are you sure you want to proceed?
-      </ModalGlass.Description>
-      <ModalGlass.Close />
-    </ModalGlass.Header>
-
-    <ModalGlass.Body>
-      <p>Modal body content goes here</p>
-    </ModalGlass.Body>
-
-    <ModalGlass.Footer>
-      <ButtonGlass variant="outline" onClick={() => setOpen(false)}>
-        Cancel
-      </ButtonGlass>
-      <ButtonGlass onClick={handleConfirm}>
-        Confirm
-      </ButtonGlass>
-    </ModalGlass.Footer>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-## Migration Examples
-
-### Example 1: Basic Modal
-
-**Before (Legacy):**
-```tsx
-import { ModalGlass } from '@/components/glass/ui/modal-glass';
-
-function MyComponent() {
-  const [open, setOpen] = useState(false);
-
-  return (
-    <ModalGlass
-      isOpen={open}
-      onClose={() => setOpen(false)}
-      title="Welcome"
-    >
-      <p>Welcome to our application!</p>
-    </ModalGlass>
-  );
-}
-```
-
-**After (Compound):**
-```tsx
-import { ModalGlass } from '@/components/glass/ui/modal-glass';
-
-function MyComponent() {
-  const [open, setOpen] = useState(false);
-
-  return (
-    <ModalGlass.Root open={open} onOpenChange={setOpen}>
-      <ModalGlass.Overlay />
-      <ModalGlass.Content>
-        <ModalGlass.Header>
-          <ModalGlass.Title>Welcome</ModalGlass.Title>
-          <ModalGlass.Close />
-        </ModalGlass.Header>
-        <ModalGlass.Body>
-          <p>Welcome to our application!</p>
-        </ModalGlass.Body>
-      </ModalGlass.Content>
-    </ModalGlass.Root>
-  );
-}
-```
-
----
-
-### Example 2: Modal with Footer Actions
-
-**Before (Legacy):**
-```tsx
-<ModalGlass
-  isOpen={isDeleteOpen}
-  onClose={() => setIsDeleteOpen(false)}
-  title="Delete Item"
-  description="This action cannot be undone."
->
-  <div className="space-y-4">
-    <p>Are you sure you want to delete this item?</p>
-    <div className="flex justify-end gap-2">
-      <ButtonGlass
-        variant="outline"
-        onClick={() => setIsDeleteOpen(false)}
-      >
-        Cancel
-      </ButtonGlass>
-      <ButtonGlass
-        variant="destructive"
-        onClick={handleDelete}
-      >
-        Delete
-      </ButtonGlass>
-    </div>
-  </div>
-</ModalGlass>
-```
-
-**After (Compound):**
-```tsx
-<ModalGlass.Root open={isDeleteOpen} onOpenChange={setIsDeleteOpen}>
-  <ModalGlass.Overlay />
-  <ModalGlass.Content>
-    <ModalGlass.Header>
-      <ModalGlass.Title>Delete Item</ModalGlass.Title>
-      <ModalGlass.Description>
-        This action cannot be undone.
-      </ModalGlass.Description>
-      <ModalGlass.Close />
-    </ModalGlass.Header>
-
-    <ModalGlass.Body>
-      <p>Are you sure you want to delete this item?</p>
-    </ModalGlass.Body>
-
-    <ModalGlass.Footer className="justify-end">
-      <ButtonGlass
-        variant="outline"
-        onClick={() => setIsDeleteOpen(false)}
-      >
-        Cancel
-      </ButtonGlass>
-      <ButtonGlass
-        variant="destructive"
-        onClick={handleDelete}
-      >
-        Delete
-      </ButtonGlass>
-    </ModalGlass.Footer>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-### Example 3: Modal with Custom Styling
-
-**Before (Legacy):**
-```tsx
-<ModalGlass
-  isOpen={open}
-  onClose={() => setOpen(false)}
-  title="Settings"
-  className="max-w-2xl"
->
-  <div className="p-6">
-    <SettingsForm />
-  </div>
-</ModalGlass>
-```
-
-**After (Compound - More Control):**
-```tsx
-<ModalGlass.Root open={open} onOpenChange={setOpen}>
-  <ModalGlass.Overlay className="bg-black/60" />
-  <ModalGlass.Content size="lg" className="max-w-2xl">
-    <ModalGlass.Header className="border-b border-white/10">
-      <ModalGlass.Title className="text-2xl">Settings</ModalGlass.Title>
-      <ModalGlass.Close />
-    </ModalGlass.Header>
-
-    <ModalGlass.Body className="p-6">
-      <SettingsForm />
-    </ModalGlass.Body>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-### Example 4: Modal Without Header/Footer
-
-**Before (Legacy):**
-```tsx
-<ModalGlass
-  isOpen={open}
-  onClose={() => setOpen(false)}
->
-  <ImageGallery images={images} />
-</ModalGlass>
-```
-
-**After (Compound - Flexible):**
-```tsx
-<ModalGlass.Root open={open} onOpenChange={setOpen}>
-  <ModalGlass.Overlay />
-  <ModalGlass.Content size="xl">
-    {/* No header - just body */}
-    <ModalGlass.Body className="p-0">
-      <ImageGallery images={images} />
-      {/* Optional: Add close button in top-right corner */}
-      <button
-        onClick={() => setOpen(false)}
-        className="absolute top-4 right-4 p-2 rounded-lg bg-black/50"
-      >
-        <X className="w-4 h-4" />
-      </button>
-    </ModalGlass.Body>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-## Component API Reference
-
-### ModalGlass.Root
-
-**Props:**
-- `open: boolean` - Controlled open state
-- `onOpenChange: (open: boolean) => void` - Called when modal should open/close
-- `children: ReactNode` - Must contain `ModalGlass.Content`
-
-### ModalGlass.Overlay
-
-**Props:**
-- `className?: string` - Custom classes for overlay
-- Standard HTML div attributes
-
-**Default behavior:**
-- Click to close
-- Backdrop blur effect
-
-### ModalGlass.Content
-
-**Props:**
-- `size?: 'sm' | 'md' | 'lg' | 'xl' | 'full'` - Modal size
-- `className?: string` - Custom classes
-- `children: ReactNode` - Modal content
-- Standard HTML div attributes
-
-### ModalGlass.Header
-
-**Props:**
-- `className?: string` - Custom classes
-- `children: ReactNode` - Header content
-- Standard HTML div attributes
-
-**Typical children:** `Title`, `Description`, `Close`
-
-### ModalGlass.Title
-
-**Props:**
-- `className?: string` - Custom classes
-- `children: ReactNode` - Title text
-- Standard HTML heading attributes
-
-### ModalGlass.Description
-
-**Props:**
-- `className?: string` - Custom classes
-- `children: ReactNode` - Description text
-- Standard HTML paragraph attributes
-
-### ModalGlass.Body
-
-**Props:**
-- `className?: string` - Custom classes
-- `children: ReactNode` - Body content
-- Standard HTML div attributes
-
-### ModalGlass.Footer
-
-**Props:**
-- `className?: string` - Custom classes
-- `children: ReactNode` - Footer content (typically buttons)
-- Standard HTML div attributes
-
-### ModalGlass.Close
-
-**Props:**
-- `className?: string` - Custom classes
-- Standard HTML button attributes
-
-**Default:** Renders X icon button
-
----
-
-## Benefits by Use Case
-
-### 1. **Complex Forms**
-Compound API makes it easier to add custom headers, sections, and footers:
-```tsx
-<ModalGlass.Root>
-  <ModalGlass.Content>
-    <ModalGlass.Header>
-      <ModalGlass.Title>Multi-Step Form</ModalGlass.Title>
-      <div className="flex gap-2">
-        <Badge>Step {step}/3</Badge>
-      </div>
-    </ModalGlass.Header>
-    {/* ... */}
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
-### 2. **Custom Layouts**
-Skip header/footer when you don't need them:
-```tsx
-<ModalGlass.Root>
-  <ModalGlass.Content>
-    <ModalGlass.Body className="p-0">
-      <VideoPlayer />
-    </ModalGlass.Body>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
-### 3. **Advanced Styling**
-Target specific parts independently:
-```tsx
-<ModalGlass.Root>
-  <ModalGlass.Overlay className="bg-gradient-to-br from-purple-900/50" />
-  <ModalGlass.Content className="shadow-2xl">
-    <ModalGlass.Header className="bg-gradient-to-r from-purple-500">
-      {/* ... */}
-    </ModalGlass.Header>
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-## Migration Timeline
-
-| Version | Status | Notes |
-|---------|--------|-------|
-| **v0.x** | ✅ Both APIs supported | Legacy API fully functional |
-| **v1.0.0** | 🔥 Legacy removed | Only Compound API available |
-
-**Note:** Legacy API was removed in v1.0.0. Use the Compound API as shown above.
-
----
-
-## Performance Notes
-
-- ✅ **No performance difference** - Both APIs render the same DOM structure
-- ✅ **Bundle size** - Compound API adds ~200 bytes (negligible)
-- ✅ **Tree shaking** - Unused sub-components are removed in production builds
-
----
-
-## Accessibility
-
-The Compound API enhances accessibility:
-
-- ✅ `ModalGlass.Title` automatically sets `aria-labelledby`
-- ✅ `ModalGlass.Description` automatically sets `aria-describedby`
-- ✅ `ModalGlass.Close` has proper `aria-label="Close modal"`
-- ✅ Keyboard navigation (Escape, Tab) works identically
-
----
-
-## Common Pitfalls
-
-### ❌ Forgetting ModalGlass.Root
-```tsx
-// Wrong - will not work
-<ModalGlass.Content>
-  {/* ... */}
-</ModalGlass.Content>
-```
-
-```tsx
-// Correct
-<ModalGlass.Root open={open} onOpenChange={setOpen}>
-  <ModalGlass.Content>
-    {/* ... */}
-  </ModalGlass.Content>
-</ModalGlass.Root>
-```
-
-### ❌ Missing Overlay
-```tsx
-// Works but no backdrop
-<ModalGlass.Root>
-  <ModalGlass.Content>{/* ... */}</ModalGlass.Content>
-</ModalGlass.Root>
-```
-
-```tsx
-// Add overlay for backdrop
-<ModalGlass.Root>
-  <ModalGlass.Overlay />
-  <ModalGlass.Content>{/* ... */}</ModalGlass.Content>
-</ModalGlass.Root>
-```
-
----
-
-## Need Help?
-
-- 📖 See [Storybook examples](http://localhost:6006/?path=/story/components-modalglass--compound-api)
-- 💬 Ask in [GitHub Discussions](https://github.com/your-org/shadcn-glass-ui-library/discussions)
-- 🐛 Report issues in [GitHub Issues](https://github.com/your-org/shadcn-glass-ui-library/issues)
-
----
-
-**Last updated:** 2025-12-05
-**Status:** ✅ Ready for migration
-**Backward compatibility:** Maintained until v5.0