@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/components/ui/dialog.d.cts

@@ -1,32 +1,205 @@
 import { Dialog as DialogPrimitive } from '@base-ui/react/dialog';
 import * as React from 'react';
 /**
- * ダイアログ（モーダル）のルートコンポーネント。
+ * Coordinates open state and interaction context for the popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered Dialog composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function Dialog({ ...props }: DialogPrimitive.Root.Props): React.JSX.Element;
 /**
- * ダイアログを開くためのトリガーボタン。
+ * Renders the control that requests opening its popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogTrigger({ children, ...props }: DialogPrimitive.Trigger.Props): React.JSX.Element;
 /**
- * ダイアログ要素をポータル経由でDOMの別の場所に描画するためのコンポーネント。
+ * Mounts popup descendants in a separate DOM container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogPortal({ ...props }: DialogPrimitive.Portal.Props): React.JSX.Element;
 /**
- * ダイアログを閉じるためのトリガーボタン。
+ * Renders a control that requests closing its popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogClose composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogClose({ ...props }: DialogPrimitive.Close.Props): React.JSX.Element;
-declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').AlertDialogBackdropProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Renders the popup backdrop with open/closed animation classes.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogOverlay composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogOverlay({ ref, className, ...props }: React.PropsWithoutRef<DialogPrimitive.Backdrop.Props> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogOverlay {
+    var displayName: string | undefined;
+}
+/**
+ * Base UI popup props plus the built-in close button and stable test selector.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see DialogContent
+ */
 export interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof DialogPrimitive.Popup> {
-    /** AI/E2E Test用の安定ID / Stable test identifier */
+    /**
+     * data-testid on the popup; the built-in close uses `${testId}-close` when present.
+     */
     testId?: string;
+    /**
+     * Whether to insert the built-in close button.
+     * @defaultValue true
+     */
     showCloseButton?: boolean;
 }
-declare const DialogContent: React.ForwardRefExoticComponent<DialogContentProps & React.RefAttributes<HTMLDivElement>>;
-declare const DialogHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DialogFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+/**
+ * Portals the popup and its positioning/backdrop composition.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showCloseButton=true.
+ * @returns The rendered DialogContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type. testId maps to the popup data-testid and, when present, `${testId}-close` on its built-in close control. showCloseButton defaults to true.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogContent({ ref, className, children, testId, showCloseButton, ...props }: React.PropsWithoutRef<DialogContentProps> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogContent {
+    var displayName: string | undefined;
+}
+/**
+ * Groups popup heading and explanatory content.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogHeader composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogHeader({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<'div'>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogHeader {
+    var displayName: string;
+}
+/**
+ * Lays out popup actions below its content.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showCloseButton=false.
+ * @returns The rendered DialogFooter composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type. showCloseButton defaults to false and adds an outline close action when true.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogFooter({ ref, className, showCloseButton, children, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<'div'> & {
+    /**
+     * Controls whether the wrapper inserts its own close button; see the component for its default.
+     */
+    /**
+     * Controls whether the wrapper inserts its own close button; see the component for its default.
+     */
     showCloseButton?: boolean;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DialogTitle: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-declare const DialogDescription: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogFooter {
+    var displayName: string;
+}
+/**
+ * Provides the accessible title of the associated popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogTitle composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogTitle({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>> & React.RefAttributes<React.ComponentRef<typeof DialogPrimitive.Title>>): React.JSX.Element;
+declare namespace DialogTitle {
+    var displayName: string | undefined;
+}
+/**
+ * Provides the accessible explanatory text of the associated popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogDescription composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogDescription({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>> & React.RefAttributes<React.ComponentRef<typeof DialogPrimitive.Description>>): React.JSX.Element;
+declare namespace DialogDescription {
+    var displayName: string | undefined;
+}
 export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

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

@@ -1,32 +1,205 @@
 import { Dialog as DialogPrimitive } from '@base-ui/react/dialog';
 import * as React from 'react';
 /**
- * ダイアログ（モーダル）のルートコンポーネント。
+ * Coordinates open state and interaction context for the popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered Dialog composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function Dialog({ ...props }: DialogPrimitive.Root.Props): React.JSX.Element;
 /**
- * ダイアログを開くためのトリガーボタン。
+ * Renders the control that requests opening its popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogTrigger({ children, ...props }: DialogPrimitive.Trigger.Props): React.JSX.Element;
 /**
- * ダイアログ要素をポータル経由でDOMの別の場所に描画するためのコンポーネント。
+ * Mounts popup descendants in a separate DOM container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogPortal({ ...props }: DialogPrimitive.Portal.Props): React.JSX.Element;
 /**
- * ダイアログを閉じるためのトリガーボタン。
+ * Renders a control that requests closing its popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogClose composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
  */
 declare function DialogClose({ ...props }: DialogPrimitive.Close.Props): React.JSX.Element;
-declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').AlertDialogBackdropProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Renders the popup backdrop with open/closed animation classes.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogOverlay composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogOverlay({ ref, className, ...props }: React.PropsWithoutRef<DialogPrimitive.Backdrop.Props> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogOverlay {
+    var displayName: string | undefined;
+}
+/**
+ * Base UI popup props plus the built-in close button and stable test selector.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see DialogContent
+ */
 export interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof DialogPrimitive.Popup> {
-    /** AI/E2E Test用の安定ID / Stable test identifier */
+    /**
+     * data-testid on the popup; the built-in close uses `${testId}-close` when present.
+     */
     testId?: string;
+    /**
+     * Whether to insert the built-in close button.
+     * @defaultValue true
+     */
     showCloseButton?: boolean;
 }
-declare const DialogContent: React.ForwardRefExoticComponent<DialogContentProps & React.RefAttributes<HTMLDivElement>>;
-declare const DialogHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DialogFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+/**
+ * Portals the popup and its positioning/backdrop composition.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showCloseButton=true.
+ * @returns The rendered DialogContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type. testId maps to the popup data-testid and, when present, `${testId}-close` on its built-in close control. showCloseButton defaults to true.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogContent({ ref, className, children, testId, showCloseButton, ...props }: React.PropsWithoutRef<DialogContentProps> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogContent {
+    var displayName: string | undefined;
+}
+/**
+ * Groups popup heading and explanatory content.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogHeader composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogHeader({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<'div'>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogHeader {
+    var displayName: string;
+}
+/**
+ * Lays out popup actions below its content.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showCloseButton=false.
+ * @returns The rendered DialogFooter composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type. showCloseButton defaults to false and adds an outline close action when true.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogFooter({ ref, className, showCloseButton, children, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<'div'> & {
+    /**
+     * Controls whether the wrapper inserts its own close button; see the component for its default.
+     */
+    /**
+     * Controls whether the wrapper inserts its own close button; see the component for its default.
+     */
     showCloseButton?: boolean;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DialogTitle: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-declare const DialogDescription: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DialogFooter {
+    var displayName: string;
+}
+/**
+ * Provides the accessible title of the associated popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogTitle composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogTitle({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>> & React.RefAttributes<React.ComponentRef<typeof DialogPrimitive.Title>>): React.JSX.Element;
+declare namespace DialogTitle {
+    var displayName: string | undefined;
+}
+/**
+ * Provides the accessible explanatory text of the associated popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DialogDescription composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose trigger, content, title and description inside Dialog; the underlying primitive owns open state and focus. Content supplies its own portal and backdrop. Separate lower-level exports support custom compositions, without requiring an application-level popup provider. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Dialog><DialogTrigger>Open details</DialogTrigger><DialogContent><DialogTitle>Details</DialogTitle><DialogDescription>Project information</DialogDescription></DialogContent></Dialog>);
+ * }
+ * ```
+ */
+declare function DialogDescription({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>> & React.RefAttributes<React.ComponentRef<typeof DialogPrimitive.Description>>): React.JSX.Element;
+declare namespace DialogDescription {
+    var displayName: string | undefined;
+}
 export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

package/dist/ui/components/ui/dialog.js

@@ -3,96 +3,108 @@
 import { cn as e } from "../../lib/utils.js";
 import { Button as t } from "./button-components.js";
 import { jsx as n, jsxs as r } from "react/jsx-runtime";
-import * as i from "react";
-import { XIcon as a } from "lucide-react";
-import { Dialog as o } from "@base-ui/react/dialog";
+import "react";
+import { XIcon as i } from "lucide-react";
+import { Dialog as a } from "@base-ui/react/dialog";
 //#region src/ui/components/ui/dialog.tsx
-function s({ ...e }) {
-	return /* @__PURE__ */ n(o.Root, {
+function o({ ...e }) {
+	return /* @__PURE__ */ n(a.Root, {
 		"data-slot": "dialog",
 		...e
 	});
 }
-function c({ children: e, ...t }) {
-	return /* @__PURE__ */ n(o.Trigger, {
+function s({ children: e, ...t }) {
+	return /* @__PURE__ */ n(a.Trigger, {
 		"data-slot": "dialog-trigger",
 		...t,
 		children: e
 	});
 }
-function l({ ...e }) {
-	return /* @__PURE__ */ n(o.Portal, {
+function c({ ...e }) {
+	return /* @__PURE__ */ n(a.Portal, {
 		"data-slot": "dialog-portal",
 		...e
 	});
 }
-function u({ ...e }) {
-	return /* @__PURE__ */ n(o.Close, {
+function l({ ...e }) {
+	return /* @__PURE__ */ n(a.Close, {
 		"data-slot": "dialog-close",
 		...e
 	});
 }
-var d = i.forwardRef(({ className: t, ...r }, i) => /* @__PURE__ */ n(o.Backdrop, {
-	ref: i,
-	"data-slot": "dialog-overlay",
-	className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs fixed inset-0 isolate z-50", t),
-	...r
-}));
-d.displayName = o.Backdrop.displayName;
-var f = i.forwardRef(({ className: i, children: s, testId: c, showCloseButton: u = !0, ...f }, p) => /* @__PURE__ */ r(l, { children: [/* @__PURE__ */ n(d, {}), /* @__PURE__ */ r(o.Popup, {
-	ref: p,
-	"data-testid": c,
-	"data-slot": "dialog-content",
-	className: e("bg-background text-foreground data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 ring-foreground/10 grid max-w-[calc(100%-2rem)] gap-4 rounded-xl p-4 text-sm ring-1 duration-100 sm:max-w-sm fixed top-1/2 left-1/2 z-50 w-full -translate-x-1/2 -translate-y-1/2 outline-none", i),
-	...f,
-	children: [s, u && /* @__PURE__ */ r(o.Close, {
-		"data-slot": "dialog-close",
-		"data-testid": c ? `${c}-close` : void 0,
-		render: /* @__PURE__ */ n(t, {
-			variant: "ghost",
-			className: "absolute top-2 right-2",
-			size: "icon-sm"
-		}),
-		children: [/* @__PURE__ */ n(a, {}), /* @__PURE__ */ n("span", {
-			className: "sr-only",
+function u({ ref: t, className: r, ...i }) {
+	return /* @__PURE__ */ n(a.Backdrop, {
+		ref: t,
+		"data-slot": "dialog-overlay",
+		className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs fixed inset-0 isolate z-50", r),
+		...i
+	});
+}
+u.displayName = a.Backdrop.displayName;
+function d({ ref: o, className: s, children: l, testId: d, showCloseButton: f = !0, ...p }) {
+	return /* @__PURE__ */ r(c, { children: [/* @__PURE__ */ n(u, {}), /* @__PURE__ */ r(a.Popup, {
+		ref: o,
+		"data-testid": d,
+		"data-slot": "dialog-content",
+		className: e("bg-background text-foreground data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 ring-foreground/10 grid max-w-[calc(100%-2rem)] gap-4 rounded-xl p-4 text-sm ring-1 duration-100 sm:max-w-sm fixed top-1/2 left-1/2 z-50 w-full -translate-x-1/2 -translate-y-1/2 outline-none", s),
+		...p,
+		children: [l, f && /* @__PURE__ */ r(a.Close, {
+			"data-slot": "dialog-close",
+			"data-testid": d ? `${d}-close` : void 0,
+			render: /* @__PURE__ */ n(t, {
+				variant: "ghost",
+				className: "absolute top-2 right-2",
+				size: "icon-sm"
+			}),
+			children: [/* @__PURE__ */ n(i, {}), /* @__PURE__ */ n("span", {
+				className: "sr-only",
+				children: "Close"
+			})]
+		})]
+	})] });
+}
+d.displayName = a.Popup.displayName;
+function f({ ref: t, className: r, ...i }) {
+	return /* @__PURE__ */ n("div", {
+		ref: t,
+		"data-slot": "dialog-header",
+		className: e("gap-2 flex flex-col", r),
+		...i
+	});
+}
+f.displayName = "DialogHeader";
+function p({ ref: i, className: o, showCloseButton: s = !1, children: c, ...l }) {
+	return /* @__PURE__ */ r("div", {
+		ref: i,
+		"data-slot": "dialog-footer",
+		className: e("bg-muted/50 -mx-4 -mb-4 rounded-b-xl border-t p-4 flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", o),
+		...l,
+		children: [c, s && /* @__PURE__ */ n(a.Close, {
+			render: /* @__PURE__ */ n(t, { variant: "outline" }),
 			children: "Close"
 		})]
-	})]
-})] }));
-f.displayName = o.Popup.displayName;
-var p = i.forwardRef(({ className: t, ...r }, i) => /* @__PURE__ */ n("div", {
-	ref: i,
-	"data-slot": "dialog-header",
-	className: e("gap-2 flex flex-col", t),
-	...r
-}));
-p.displayName = "DialogHeader";
-var m = i.forwardRef(({ className: i, showCloseButton: a = !1, children: s, ...c }, l) => /* @__PURE__ */ r("div", {
-	ref: l,
-	"data-slot": "dialog-footer",
-	className: e("bg-muted/50 -mx-4 -mb-4 rounded-b-xl border-t p-4 flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", i),
-	...c,
-	children: [s, a && /* @__PURE__ */ n(o.Close, {
-		render: /* @__PURE__ */ n(t, { variant: "outline" }),
-		children: "Close"
-	})]
-}));
-m.displayName = "DialogFooter";
-var h = i.forwardRef(({ className: t, ...r }, i) => /* @__PURE__ */ n(o.Title, {
-	ref: i,
-	"data-slot": "dialog-title",
-	className: e("text-sm leading-none font-medium", t),
-	...r
-}));
-h.displayName = o.Title.displayName;
-var g = i.forwardRef(({ className: t, ...r }, i) => /* @__PURE__ */ n(o.Description, {
-	ref: i,
-	"data-slot": "dialog-description",
-	className: e("text-muted-foreground *:[a]:hover:text-foreground text-sm *:[a]:underline *:[a]:underline-offset-3", t),
-	...r
-}));
-g.displayName = o.Description.displayName;
+	});
+}
+p.displayName = "DialogFooter";
+function m({ ref: t, className: r, ...i }) {
+	return /* @__PURE__ */ n(a.Title, {
+		ref: t,
+		"data-slot": "dialog-title",
+		className: e("text-sm leading-none font-medium", r),
+		...i
+	});
+}
+m.displayName = a.Title.displayName;
+function h({ ref: t, className: r, ...i }) {
+	return /* @__PURE__ */ n(a.Description, {
+		ref: t,
+		"data-slot": "dialog-description",
+		className: e("text-muted-foreground *:[a]:hover:text-foreground text-sm *:[a]:underline *:[a]:underline-offset-3", r),
+		...i
+	});
+}
+h.displayName = a.Description.displayName;
 //#endregion
-export { s as Dialog, u as DialogClose, f as DialogContent, g as DialogDescription, m as DialogFooter, p as DialogHeader, d as DialogOverlay, l as DialogPortal, h as DialogTitle, c as DialogTrigger };
+export { o as Dialog, l as DialogClose, d as DialogContent, h as DialogDescription, p as DialogFooter, f as DialogHeader, u as DialogOverlay, c as DialogPortal, m as DialogTitle, s as DialogTrigger };
 
 //# sourceMappingURL=dialog.js.map