@neynar/ui 0.1.1 → 0.1.3

package/dist/components/ui/accordion.d.ts

@@ -48,16 +48,6 @@ import * as AccordionPrimitive from "@radix-ui/react-accordion";
  * </Accordion>
  * ```
  *
- * @param type - "single" allows one item open, "multiple" allows multiple items open
- * @param collapsible - When type="single", allows closing the open item (optional)
- * @param defaultValue - Initial value(s) for open items
- * @param value - Controlled value(s) for open items
- * @param onValueChange - Callback when accordion state changes
- * @param className - Additional CSS classes for styling
- * @param orientation - "horizontal" or "vertical" (default: "vertical")
- * @param dir - Text direction "ltr" or "rtl" for internationalization
- * @param disabled - Disables all accordion interactions
- *
  * @accessibility
  * - Full keyboard navigation support (Arrow keys, Space, Enter, Home, End)
  * - ARIA expanded/collapsed states automatically managed
@@ -73,7 +63,7 @@ import * as AccordionPrimitive from "@radix-ui/react-accordion";
  * @see {@link AccordionContent} Collapsible content area with smooth animations
  * @since 1.0.0
  */
-declare function Accordion({ ...props }: React.ComponentProps<typeof AccordionPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function Accordion(props: React.ComponentProps<typeof AccordionPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 /**
  * AccordionItem - Individual collapsible panel within an accordion
  *
@@ -100,11 +90,6 @@ declare function Accordion({ ...props }: React.ComponentProps<typeof AccordionPr
  * </AccordionItem>
  * ```
  *
- * @param value - Unique identifier for this accordion item (required)
- * @param className - Additional CSS classes for custom styling
- * @param disabled - Disables this specific accordion item
- * @param children - Should contain AccordionTrigger and AccordionContent
- *
  * @accessibility
  * - Manages expanded/collapsed state via ARIA attributes
  * - Associates trigger with content using aria-controls and aria-labelledby
@@ -150,11 +135,6 @@ declare function AccordionItem({ className, ...props }: React.ComponentProps<typ
  * </AccordionTrigger>
  * ```
  *
- * @param className - Additional CSS classes for custom styling
- * @param children - Content to display in the trigger (text, icons, or components)
- * @param disabled - Disables the trigger interaction
- * @param asChild - Renders the trigger as its child element when true
- *
  * @accessibility
  * - Keyboard activated with Space, Enter, or Arrow keys
  * - aria-expanded automatically indicates current expanded/collapsed state
@@ -205,10 +185,6 @@ declare function AccordionTrigger({ className, children, ...props }: React.Compo
  * </AccordionContent>
  * ```
  *
- * @param className - Additional CSS classes for custom styling (applied to inner div)
- * @param children - Any React content to display when expanded
- * @param forceMount - Forces content to remain mounted when collapsed (for animations)
- *
  * @accessibility
  * - Hidden content is not focusable or accessible when collapsed
  * - Smooth height animations enhance user experience without motion issues

package/dist/components/ui/accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../../src/components/ui/accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAKhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,iBAAS,SAAS,CAAC,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAEtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAQtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAgBzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAUzD;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../../src/components/ui/accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAkHhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,iBAAS,SAAS,CAChB,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAG5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,2CAQtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAgBzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,2CAUzD;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/ui/alert-dialog.d.ts

@@ -77,24 +77,54 @@ import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
  * Root component of the alert dialog
  *
  * Provides the context and state management for the entire alert dialog.
- * Controls the open/closed state and manages focus behavior.
+ * Controls the open/closed state and manages focus behavior. Alert dialogs
+ * are specifically designed for critical actions that require user attention
+ * and cannot be dismissed by clicking outside.
  *
- * @param props - All props are forwarded to the underlying Radix AlertDialog.Root
+ * @param defaultOpen - Whether the dialog is open initially (uncontrolled)
+ * @param open - Whether the dialog is open (controlled)
+ * @param onOpenChange - Callback when open state changes
+ * @param props - All other props forwarded to Radix AlertDialog.Root
+ *
+ * @example
+ * ```tsx
+ * // Uncontrolled
+ * <AlertDialog defaultOpen={false}>
+ *   // dialog content
+ * </AlertDialog>
+ *
+ * // Controlled
+ * <AlertDialog open={isOpen} onOpenChange={setIsOpen}>
+ *   // dialog content
+ * </AlertDialog>
+ * ```
  */
 declare function AlertDialog({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 /**
  * Trigger element that opens the alert dialog
  *
  * The element that opens the alert dialog when activated. Usually a button,
- * but can be any interactive element. Use the `asChild` prop to compose
- * with other components.
+ * but can be any interactive element through composition. When opened, the dialog
+ * will trap focus and require user interaction before continuing.
  *
- * @param props - All props are forwarded to the underlying Radix AlertDialog.Trigger
+ * @param asChild - Render as child element, merging props and behavior
+ * @param props - All other props forwarded to Radix AlertDialog.Trigger
  *
  * @example
  * ```tsx
+ * // Direct usage
+ * <AlertDialogTrigger>
+ *   Delete Account
+ * </AlertDialogTrigger>
+ *
+ * // Composition with Button component
+ * <AlertDialogTrigger asChild>
+ *   <Button variant="destructive">Delete Account</Button>
+ * </AlertDialogTrigger>
+ *
+ * // Composition with custom element
  * <AlertDialogTrigger asChild>
- *   <Button variant="destructive">Delete</Button>
+ *   <button className="custom-trigger">Custom Trigger</button>
  * </AlertDialogTrigger>
  * ```
  */
@@ -106,7 +136,20 @@ declare function AlertDialogTrigger({ ...props }: React.ComponentProps<typeof Al
  * This ensures the dialog appears above other content and is properly accessible.
  * Usually not used directly - AlertDialogContent includes this automatically.
  *
- * @param props - All props are forwarded to the underlying Radix AlertDialog.Portal
+ * @param forceMount - Force mount the component even when dialog is closed
+ * @param container - Container element to portal into (defaults to document.body)
+ * @param props - All other props forwarded to Radix AlertDialog.Portal
+ *
+ * @example
+ * ```tsx
+ * // Custom portal container
+ * <AlertDialogPortal container={customContainer}>
+ *   <AlertDialogOverlay />
+ *   <AlertDialogPrimitive.Content>
+ *     // content
+ *   </AlertDialogPrimitive.Content>
+ * </AlertDialogPortal>
+ * ```
  */
 declare function AlertDialogPortal({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Portal>): import("react/jsx-runtime").JSX.Element;
 /**
@@ -114,24 +157,44 @@ declare function AlertDialogPortal({ ...props }: React.ComponentProps<typeof Ale
  *
  * A semi-transparent backdrop that covers the entire viewport when the dialog is open.
  * Provides visual separation and prevents interaction with background content.
- * Includes fade in/out animations using data-state attributes.
+ * Includes smooth fade in/out animations and proper z-index stacking.
+ *
+ * @param asChild - Render as child element, merging props and behavior
+ * @param forceMount - Force mount the component even when dialog is closed
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to Radix AlertDialog.Overlay
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Overlay
+ * @example
+ * ```tsx
+ * // Custom overlay styling
+ * <AlertDialogOverlay className="bg-black/80" />
+ *
+ * // Force mounted overlay
+ * <AlertDialogOverlay forceMount className="custom-backdrop" />
+ * ```
  */
-declare function AlertDialogOverlay({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Overlay>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogOverlay({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Overlay> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Main content container for the alert dialog
  *
  * The primary container that holds all alert dialog content. Automatically includes
  * the portal and overlay, and provides default styling with responsive design.
- * Centered on screen with fade and zoom animations.
+ * Centered on screen with smooth fade and zoom animations. Manages focus trapping
+ * and keyboard navigation automatically.
  *
- * @param className - Additional CSS classes to apply to the content container
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Content
+ * @param asChild - Render as child element, merging props and behavior
+ * @param forceMount - Force mount the component even when dialog is closed
+ * @param onOpenAutoFocus - Callback when dialog opens and focus moves to content
+ * @param onCloseAutoFocus - Callback when dialog closes and focus returns to trigger
+ * @param onEscapeKeyDown - Callback when Escape key is pressed (can preventDefault)
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to Radix AlertDialog.Content
  *
  * @example
  * ```tsx
+ * // Basic usage
  * <AlertDialogContent>
  *   <AlertDialogHeader>
  *     <AlertDialogTitle>Confirm Action</AlertDialogTitle>
@@ -142,106 +205,237 @@ declare function AlertDialogOverlay({ className, ...props }: React.ComponentProp
  *     <AlertDialogAction>Continue</AlertDialogAction>
  *   </AlertDialogFooter>
  * </AlertDialogContent>
+ *
+ * // Custom focus handling
+ * <AlertDialogContent
+ *   onOpenAutoFocus={(e) => {
+ *     e.preventDefault();
+ *     customFocusTarget.focus();
+ *   }}
+ *   onEscapeKeyDown={(e) => {
+ *     if (hasUnsavedChanges) {
+ *       e.preventDefault();
+ *       showUnsavedWarning();
+ *     }
+ *   }}
+ * >
+ *   // content
+ * </AlertDialogContent>
+ *
+ * // Custom styling
+ * <AlertDialogContent className="max-w-md">
+ *   // smaller dialog
+ * </AlertDialogContent>
  * ```
  */
-declare function AlertDialogContent({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogContent({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Content> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Header section of the alert dialog
  *
  * Contains the title and description of the alert dialog. Provides consistent
  * spacing and alignment, with responsive text alignment (centered on mobile,
- * left-aligned on larger screens).
+ * left-aligned on larger screens). Should contain AlertDialogTitle and
+ * optionally AlertDialogDescription for proper accessibility.
+ *
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to the underlying div element
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying div element
+ * @example
+ * ```tsx
+ * <AlertDialogHeader>
+ *   <AlertDialogTitle>Delete Account</AlertDialogTitle>
+ *   <AlertDialogDescription>
+ *     This will permanently delete your account and all associated data.
+ *     This action cannot be undone.
+ *   </AlertDialogDescription>
+ * </AlertDialogHeader>
+ *
+ * // Custom styling
+ * <AlertDialogHeader className="text-left">
+ *   <AlertDialogTitle>Custom Header</AlertDialogTitle>
+ * </AlertDialogHeader>
+ * ```
  */
-declare function AlertDialogHeader({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogHeader({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 /**
  * Footer section of the alert dialog
  *
  * Contains the action buttons (cancel and confirm). Uses responsive layout
  * with stacked buttons on mobile (cancel on top) and horizontal layout
- * on larger screens (cancel on left, action on right).
+ * on larger screens (cancel on left, action on right). Should contain
+ * AlertDialogCancel and AlertDialogAction for proper UX.
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying div element
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to the underlying div element
+ *
+ * @example
+ * ```tsx
+ * <AlertDialogFooter>
+ *   <AlertDialogCancel>Cancel</AlertDialogCancel>
+ *   <AlertDialogAction>Delete Account</AlertDialogAction>
+ * </AlertDialogFooter>
+ *
+ * // Custom button order
+ * <AlertDialogFooter className="flex-row">
+ *   <AlertDialogAction>Continue</AlertDialogAction>
+ *   <AlertDialogCancel>Go Back</AlertDialogCancel>
+ * </AlertDialogFooter>
+ *
+ * // Single action footer
+ * <AlertDialogFooter>
+ *   <AlertDialogAction>I Understand</AlertDialogAction>
+ * </AlertDialogFooter>
+ * ```
  */
-declare function AlertDialogFooter({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogFooter({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 /**
  * Title heading of the alert dialog
  *
  * The main heading that describes the alert or action being confirmed.
- * Automatically provides proper ARIA labeling for screen readers.
- * Should be concise and clearly state what the dialog is asking.
+ * Automatically provides proper ARIA labeling for screen readers via
+ * aria-labelledby. Should be concise and clearly state what the dialog is asking.
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Title
+ * @param asChild - Render as child element, merging props and behavior
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to Radix AlertDialog.Title
  *
  * @example
  * ```tsx
+ * // Standard titles
  * <AlertDialogTitle>Are you absolutely sure?</AlertDialogTitle>
  * <AlertDialogTitle>Delete Account</AlertDialogTitle>
+ * <AlertDialogTitle>Confirm Sign Out</AlertDialogTitle>
+ *
+ * // Custom styling
+ * <AlertDialogTitle className="text-red-600 text-xl">
+ *   Destructive Action
+ * </AlertDialogTitle>
+ *
+ * // Composition with custom element
+ * <AlertDialogTitle asChild>
+ *   <h1 className="custom-title">Custom Title Element</h1>
+ * </AlertDialogTitle>
  * ```
  */
-declare function AlertDialogTitle({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Title>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogTitle({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Title> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Description text of the alert dialog
  *
  * Provides additional context and explanation for the alert or action.
  * Should clearly explain the consequences of the action being confirmed.
- * Automatically provides proper ARIA description for screen readers.
+ * Automatically provides proper ARIA description via aria-describedby for
+ * screen readers. Can be omitted if aria-describedby is provided to Content.
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Description
+ * @param asChild - Render as child element, merging props and behavior
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to Radix AlertDialog.Description
  *
  * @example
  * ```tsx
+ * // Standard descriptions
  * <AlertDialogDescription>
  *   This action cannot be undone. This will permanently delete your
  *   account and remove your data from our servers.
  * </AlertDialogDescription>
+ *
+ * <AlertDialogDescription>
+ *   You will be signed out of all devices and will need to sign in again
+ *   to access your account.
+ * </AlertDialogDescription>
+ *
+ * // Custom styling
+ * <AlertDialogDescription className="text-center text-lg">
+ *   Are you sure you want to continue?
+ * </AlertDialogDescription>
+ *
+ * // Composition with custom element
+ * <AlertDialogDescription asChild>
+ *   <p className="custom-description">
+ *     Custom description element
+ *   </p>
+ * </AlertDialogDescription>
  * ```
  */
-declare function AlertDialogDescription({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Description>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogDescription({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Description> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Primary action button of the alert dialog
  *
  * The button that confirms or executes the action being alerted about.
- * Automatically receives focus when the dialog opens. Styled as a primary
- * button by default, but can be customized for destructive actions.
- * Closes the dialog when clicked.
+ * Automatically receives focus when the dialog opens (unless overridden).
+ * Styled using buttonVariants() by default, but can be customized for
+ * destructive actions. Closes the dialog when clicked.
  *
- * @param className - Additional CSS classes to apply (useful for destructive styling)
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Action
+ * @param asChild - Render as child element, merging props and behavior
+ * @param className - Additional CSS classes (useful for destructive styling)
+ * @param props - All other props forwarded to Radix AlertDialog.Action
  *
  * @example
  * ```tsx
- * // Default action
+ * // Default action (primary button style)
  * <AlertDialogAction>Continue</AlertDialogAction>
+ * <AlertDialogAction>Save Changes</AlertDialogAction>
  *
- * // Destructive action
- * <AlertDialogAction className="bg-red-600 hover:bg-red-700">
+ * // Destructive action with red styling
+ * <AlertDialogAction className={buttonVariants({ variant: "destructive" })}>
  *   Delete Account
  * </AlertDialogAction>
+ *
+ * // Custom styled action
+ * <AlertDialogAction className="bg-green-600 hover:bg-green-700">
+ *   Confirm Action
+ * </AlertDialogAction>
+ *
+ * // Composition with custom button
+ * <AlertDialogAction asChild>
+ *   <Button variant="destructive" size="lg">
+ *     Delete Forever
+ *   </Button>
+ * </AlertDialogAction>
  * ```
  */
-declare function AlertDialogAction({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Action>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogAction({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Action> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Cancel button of the alert dialog
  *
  * The button that dismisses the dialog without performing the action.
- * Styled as an outline button by default to de-emphasize compared to
- * the primary action. Closes the dialog when clicked.
+ * Styled using outline variant by default to de-emphasize compared to
+ * the primary action. Closes the dialog when clicked without triggering
+ * the main action.
  *
- * @param className - Additional CSS classes to apply
- * @param props - All other props are forwarded to the underlying Radix AlertDialog.Cancel
+ * @param asChild - Render as child element, merging props and behavior
+ * @param className - Additional CSS classes for custom styling
+ * @param props - All other props forwarded to Radix AlertDialog.Cancel
  *
  * @example
  * ```tsx
+ * // Standard cancel buttons
  * <AlertDialogCancel>Cancel</AlertDialogCancel>
  * <AlertDialogCancel>No, keep it</AlertDialogCancel>
+ * <AlertDialogCancel>Go Back</AlertDialogCancel>
+ *
+ * // Custom styled cancel
+ * <AlertDialogCancel className="text-red-600">
+ *   Don't Delete
+ * </AlertDialogCancel>
+ *
+ * // Composition with custom button
+ * <AlertDialogCancel asChild>
+ *   <Button variant="ghost" size="sm">
+ *     Maybe Later
+ *   </Button>
+ * </AlertDialogCancel>
  * ```
  */
-declare function AlertDialogCancel({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Cancel>): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogCancel({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Cancel> & {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
 export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };
 //# sourceMappingURL=alert-dialog.d.ts.map

package/dist/components/ui/alert-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/ui/alert-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,oBAAoB,MAAM,8BAA8B,CAAC;AAKrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH;;;;;;;GAOG;AACH,iBAAS,WAAW,CAAC,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,2CAExD;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,2CAI3D;AAED;;;;;;;;GAQG;AACH,iBAAS,iBAAiB,CAAC,EACzB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,2CAI1D;AAED;;;;;;;;;GASG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,2CAW3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,2CAc3D;AAED;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ7B;AAED;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAW7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAK,CAAC,2CAQzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,WAAW,CAAC,2CAQ/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,2CAO1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,2CAO1D;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,CAAC"}
+{"version":3,"file":"alert-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/ui/alert-dialog.tsx"],"names":[],"mappings":"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"}

package/dist/components/ui/alert.d.ts

@@ -1,5 +1,11 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * Alert variant styles configuration with semantic color schemes
+ *
+ * @variant default - Standard informational alert with neutral colors
+ * @variant destructive - Error or warning alert with red color scheme for critical messages
+ */
 declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
@@ -111,7 +117,7 @@ declare const alertVariants: (props?: ({
  * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/alert/} - ARIA alert pattern
  * @since 1.0.0
  */
-declare function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>): import("react/jsx-runtime").JSX.Element;
+declare function Alert({ className, variant, ...props }: React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof alertVariants>): import("react/jsx-runtime").JSX.Element;
 /**
  * AlertTitle - The title/heading component for alerts
  *
@@ -158,30 +164,86 @@ declare function Alert({ className, variant, ...props }: React.ComponentProps<"d
  * @see {@link AlertDescription} - Companion description component
  * @since 1.0.0
  */
-declare function AlertTitle({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function AlertTitle({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 /**
- * AlertDescription - Detailed description text for an alert
+ * AlertDescription - Detailed description text content for alerts
  *
- * Provides additional context or instructions related to the alert.
- * Supports multiple paragraphs and rich text content.
+ * The body content area of an alert that provides detailed information, context,
+ * or instructions related to the alert message. Automatically styled with muted
+ * text color and proper grid positioning. Supports rich content including
+ * paragraphs, links, and inline formatting.
+ *
+ * ## Features
+ * - Muted foreground color for visual hierarchy
+ * - Proper grid positioning (col-start-2) for icon layout compatibility
+ * - Support for multiple paragraphs with relaxed line height
+ * - Grid layout with start justification for text alignment
+ * - Semantic HTML structure with data-slot attribute
+ * - Small text size (text-sm) for readability
+ * - Responsive gap spacing between content elements
  *
- * @component
  * @example
  * ```tsx
+ * // Basic description with simple text
  * <Alert>
- *   <AlertTitle>Note</AlertTitle>
+ *   <AlertTitle>Success</AlertTitle>
  *   <AlertDescription>
- *     Your changes have been saved. You can continue editing or publish when ready.
+ *     Your account has been created successfully.
+ *   </AlertDescription>
+ * </Alert>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Description with multiple paragraphs
+ * <Alert variant="destructive">
+ *   <AlertCircle className="size-4" />
+ *   <AlertTitle>Connection Error</AlertTitle>
+ *   <AlertDescription>
+ *     <p>Unable to connect to the server. This could be due to:</p>
+ *     <p>• Network connectivity issues</p>
+ *     <p>• Server maintenance</p>
+ *     <p>Please try again in a few minutes.</p>
+ *   </AlertDescription>
+ * </Alert>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Description with links and rich content
+ * <Alert>
+ *   <Info className="size-4" />
+ *   <AlertTitle>Update Available</AlertTitle>
+ *   <AlertDescription>
+ *     A new version is available. <a href="/changelog" className="underline">View changelog</a> or
+ *     <button className="ml-1 underline">update now</button>.
+ *   </AlertDescription>
+ * </Alert>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom styled description
+ * <Alert>
+ *   <AlertTitle>Custom Alert</AlertTitle>
+ *   <AlertDescription className="text-sm font-medium text-foreground">
+ *     This description uses custom styling to override the default muted appearance.
  *   </AlertDescription>
  * </Alert>
  * ```
  *
  * @accessibility
- * - Uses appropriate text color for readability
- * - Supports paragraph spacing for long content
+ * - Properly associated with the alert container via DOM structure
+ * - Uses muted text color while maintaining sufficient contrast ratios
+ * - Supports paragraph spacing and line height for readability
+ * - Screen readers announce description content as part of the alert
+ * - Rich content like links and buttons remain keyboard accessible
+ * - Works with dark mode via CSS custom properties
  *
+ * @see {@link Alert} - Parent alert container component
+ * @see {@link AlertTitle} - Companion title component for headers
  * @since 1.0.0
  */
-declare function AlertDescription({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function AlertDescription({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 export { Alert, AlertTitle, AlertDescription };
 //# sourceMappingURL=alert.d.ts.map

package/dist/components/ui/alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/components/ui/alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;8EAclB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2GG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAO,EACP,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,2CASlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAWvE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAW7B;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/components/ui/alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;;;GAKG;AACH,QAAA,MAAM,aAAa;;8EAgBlB,CAAC;AAsCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2GG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAO,EACP,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,2CAS3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,2CAWtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,2CAWtC;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}