\n \n );\n}\n```\n\n\n## API Reference\n\n### Dialog\n\nRoot component that manages dialog state.\n\n**Props:**\n- `open?: boolean` - Controlled open state\n- `defaultOpen?: boolean` - Default open state (uncontrolled)\n- `onOpenChange?: (open: boolean) => void` - Callback when open state changes\n\n### Dialog.Trigger\n\nButton that opens the dialog.\n\n**Props:**\n- `asChild?: boolean` - Merge props with child element instead of rendering a button\n\n### Dialog.Portal\n\nRenders children in a portal outside the DOM hierarchy.\n\n**Props:**\n- `container?: HTMLElement` - Portal container (defaults to `document.body`)\n\n### Dialog.Overlay\n\nSemi-transparent backdrop. Clicking it closes the dialog.\n\n### Dialog.Content\n\nMain dialog content container with focus management and ARIA attributes.\n\n**Props:**\n- `onEscapeKeyDown?: (event: KeyboardEvent) => void` - Callback when Escape is pressed\n- `onOverlayClick?: (event: MouseEvent) => void` - Callback when overlay is clicked\n\n### Dialog.Title\n\nDialog title, automatically linked via `aria-labelledby`.\n\n### Dialog.Description\n\nDialog description, automatically linked via `aria-describedby`.\n\n### Dialog.Close\n\nButton that closes the dialog.\n\n**Props:**\n- `asChild?: boolean` - Merge props with child element instead of rendering a button\n\n## Accessibility\n\nAll components follow WAI-ARIA best practices:\n\n- â Focus trap - Focus stays inside dialog when open\n- â Focus return - Focus returns to trigger on close\n- â Keyboard navigation - Escape to close, Tab to cycle\n- â ARIA attributes - Proper roles and labels\n- â Screen reader support - Fully accessible to assistive technologies\n\n## Styling\n\nThis library is headless, meaning it provides zero styles. You can style components using:\n\n- **Tailwind CSS** - Add utility classes directly\n- **CSS Modules** - Import and apply CSS modules\n- **Styled Components** - Wrap components with styled-components\n- **Emotion** - Use the css prop or styled API\n- **Plain CSS** - Add className and style with regular CSS\n\n## TypeScript\n\nFull TypeScript support with exported types:\n\n```tsx\nimport type { DialogProps, DialogContentProps } from '@alankrit2/ui';\n```\n\n## License\n\nMIT ÂĐ alankrit\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## Links\n\n- [GitHub Repository]()\n- [Documentation]()\n- [Report Issues]()\n","readmeFilename":"README.md"}