···5151});
52525353export interface AlertDialogProps extends DialogTriggerProps {
5454+ /**
5555+ * The trigger element to open the dialog.
5656+ */
5457 trigger: React.ReactNode;
5858+ /**
5959+ * The content of the dialog.
6060+ */
5561 children: React.ReactNode;
5662}
5763
+5
apps/docs/src/components/avatar/index.tsx
···7575 React.ComponentProps<"div">,
7676 "style" | "className" | "children"
7777 > {
7878+ /** The stylex styles of the avatar. */
7879 style?: stylex.StyleXStyles | stylex.StyleXStyles[];
8080+ /** The source of the image. */
7981 src?: string;
8282+ /** The alt text of the image. */
8083 alt?: string;
8484+ /** The fallback content of the avatar. */
8185 fallback: React.ReactNode;
8686+ /** The size of the avatar. */
8287 size?: Size | "xl";
8388}
8489
···11+---
22+title: Alert Dialog
33+description: A modal dialog component specifically designed for critical actions and confirmations.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/alert-dialog/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the alert dialog component to your project.
1515+1616+```bash
1717+pnpm hip install alert-dialog
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Dialog](https://react-spectrum.adobe.com/react-aria/Dialog.html) with the `alertdialog` role.
2323+2424+<PropDocs components={["AlertDialog", "AlertDialogHeader", "AlertDialogDescription", "AlertDialogFooter", "AlertDialogCancelButton", "AlertDialogActionButton"]} />
2525+2626+## Related Components
2727+2828+- [Dialog](/components/dialog) - For general modal dialogs
2929+- [Button](/components/button) - For dialog action buttons
3030+- [Popover](/components/popover) - For non-modal overlays
3131+- [Tooltip](/components/tooltip) - For contextual help
+27-3
apps/docs/src/docs/components/aspect-ratio.mdx
···33description: A component that allows you to set the aspect ratio of a div, with support for images.
44---
5566+import { PropDocs } from '../../lib/PropDocs'
67import { Example } from '../../lib/Example'
78import { Basic } from '../../examples/aspect-ratio/basic'
89import { NoImage } from '../../examples/aspect-ratio/no-image'
9101010-<Example src={Basic} />
1111+<Example src={Basic} />
1212+1313+## Installation
1414+1515+Run the following command to add the aspect ratio component to your project.
1616+1717+```bash
1818+pnpm hip install aspect-ratio
1919+```
2020+2121+## Props
11221212-## No Image
2323+This is a custom component built for setting aspect ratios.
2424+2525+<PropDocs components={["AspectRatio", "AspectRatioImage"]} />
2626+2727+## Features
2828+2929+### No Image
13301431The aspect ratio can be set without an image.
15321616-<Example src={NoImage} />3333+<Example src={NoImage} />
3434+3535+## Related Components
3636+3737+- [Card](/components/card) - For cards with aspect ratio images
3838+- [Grid](/components/grid) - For grid layouts with aspect ratio items
3939+- [Flex](/components/flex) - For flex layouts with aspect ratio items
4040+- [Avatar](/components/avatar) - For user avatars with consistent aspect ratios
+41-3
apps/docs/src/docs/components/avatar.mdx
···33description: An image element with a fallback for representing the user.
44---
5566+import { PropDocs } from '../../lib/PropDocs'
67import { Example } from '../../lib/Example'
78import { Basic } from '../../examples/avatar/basic'
89import { AvatarSizes } from '../../examples/avatar/sizes'
1010+import { AvatarGroup } from '../../examples/avatar/group'
1111+import { AvatarFallbacks } from '../../examples/avatar/fallbacks'
9121010-<Example src={Basic} />
1313+<Example src={Basic} />
1414+1515+## Installation
11161212-## Sizes
1717+Run the following command to add the avatar component to your project.
1818+1919+```bash
2020+pnpm hip install avatar
2121+```
2222+2323+## Props
2424+2525+This is a custom component built for user representation.
2626+2727+<PropDocs components={["Avatar"]} />
2828+2929+## Features
3030+3131+### Sizes
13321433The avatar comes in the standard sizes along with a custom `xl` size.
15341616-<Example src={AvatarSizes} />3535+<Example src={AvatarSizes} />
3636+3737+### Group
3838+3939+Avatars can be displayed in groups to show multiple users.
4040+4141+<Example src={AvatarGroup} />
4242+4343+### Fallbacks
4444+4545+Avatars display fallback content when images fail to load or are not provided.
4646+4747+<Example src={AvatarFallbacks} />
4848+4949+## Related Components
5050+5151+- [Badge](/components/badge) - For status indicators on avatars
5252+- [Card](/components/card) - For cards with user avatars
5353+- [AspectRatio](/components/aspect-ratio) - For maintaining avatar aspect ratios
5454+- [Typography](/components/typography) - For text alongside avatars
+61
apps/docs/src/docs/components/badge.mdx
···11+---
22+title: Badge
33+description: A small status indicator component for highlighting information.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/badge/basic'
99+import { BadgeVariants } from '../../examples/badge/variants'
1010+import { BadgeSizes } from '../../examples/badge/sizes'
1111+import { BadgeWithIcons } from '../../examples/badge/with-icons'
1212+import { BadgeDismissible } from '../../examples/badge/dismissible'
1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the badge component to your project.
1919+2020+```bash
2121+pnpm hip install badge
2222+```
2323+2424+## Props
2525+2626+This is a custom component built for status indicators.
2727+2828+<PropDocs components={["Badge"]} />
2929+3030+## Features
3131+3232+### Variants
3333+3434+The badge comes in five different variants to convey different types of information.
3535+3636+<Example src={BadgeVariants} />
3737+3838+### Sizes
3939+4040+The badge supports two different sizes.
4141+4242+<Example src={BadgeSizes} />
4343+4444+### With Icons
4545+4646+Badges can include icons to enhance their visual meaning.
4747+4848+<Example src={BadgeWithIcons} />
4949+5050+### Dismissible
5151+5252+Badges can be made dismissible for user interaction.
5353+5454+<Example src={BadgeDismissible} />
5555+5656+## Related Components
5757+5858+- [Avatar](/components/avatar) - For user avatars with status badges
5959+- [Card](/components/card) - For cards with status badges
6060+- [Table](/components/table) - For table cells with status badges
6161+- [Button](/components/button) - For buttons with notification badges
+31
apps/docs/src/docs/components/button-group.mdx
···11+---
22+title: Button Group
33+description: A group of buttons that work together as a single control.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/button-group/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the button group component to your project.
1515+1616+```bash
1717+pnpm hip install button-group
1818+```
1919+2020+## Props
2121+2222+This is a custom component built for grouping buttons together. It is built using the [React Aria Group](https://react-spectrum.adobe.com/react-aria/Group.html).
2323+2424+<PropDocs components={["ButtonGroup"]} />
2525+2626+## Related Components
2727+2828+- [Button](/components/button) - Individual buttons within the group
2929+- [IconButton](/components/icon-button) - Icon-only buttons for the group
3030+- [ToggleButton](/components/toggle-button) - Toggleable buttons for the group
3131+- [ToggleButtonGroup](/components/toggle-button-group) - For grouping toggle buttons specifically
+68
apps/docs/src/docs/components/button.mdx
···11+---
22+title: Button
33+description: A clickable button component with multiple variants and sizes.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/button/basic'
99+import { ButtonVariants } from '../../examples/button/variants'
1010+import { ButtonSizes } from '../../examples/button/sizes'
1111+import { ButtonWithIcons } from '../../examples/button/with-icons'
1212+import { ButtonStates } from '../../examples/button/states'
1313+import { ButtonLoading } from '../../examples/button/loading'
1414+1515+<Example src={Basic} />
1616+1717+## Installation
1818+1919+Run the following command to add the button component to your project.
2020+2121+```bash
2222+pnpm hip install button
2323+```
2424+2525+## Props
2626+2727+This component is built using the [React Aria Button](https://react-spectrum.adobe.com/react-aria/Button.html).
2828+2929+<PropDocs components={["Button"]} />
3030+3131+## Features
3232+3333+### Variants
3434+3535+The button comes in four different variants to suit different use cases.
3636+3737+<Example src={ButtonVariants} />
3838+3939+### Sizes
4040+4141+The button supports three different sizes.
4242+4343+<Example src={ButtonSizes} />
4444+4545+### With Icons
4646+4747+Buttons can include icons alongside text for better visual communication.
4848+4949+<Example src={ButtonWithIcons} />
5050+5151+### States
5252+5353+Buttons support different interactive states.
5454+5555+<Example src={ButtonStates} />
5656+5757+### Loading State
5858+5959+Buttons can show a loading state during async operations.
6060+6161+<Example src={ButtonLoading} />
6262+6363+## Related Components
6464+6565+- [IconButton](/components/icon-button) - For icon-only buttons
6666+- [ToggleButton](/components/toggle-button) - For toggleable buttons
6767+- [ButtonGroup](/components/button-group) - For grouping buttons together
6868+- [Link](/components/link) - For navigation links that look like buttons
+61
apps/docs/src/docs/components/card.mdx
···11+---
22+title: Card
33+description: A flexible container component for grouping related content.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/card/basic'
99+import { CardWithImage } from '../../examples/card/with-image'
1010+import { CardSizes } from '../../examples/card/sizes'
1111+import { CardWithActions } from '../../examples/card/with-actions'
1212+import { CardWithBadges } from '../../examples/card/with-badges'
1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the card component to your project.
1919+2020+```bash
2121+pnpm hip install card
2222+```
2323+2424+## Props
2525+2626+This is a custom component built for grouping related content.
2727+2828+<PropDocs components={["Card", "CardHeader", "CardTitle", "CardDescription", "CardHeaderAction", "CardBody", "CardFooter", "CardImage"]} />
2929+3030+## Features
3131+3232+### With Image
3333+3434+Cards can include images with customizable aspect ratios.
3535+3636+<Example src={CardWithImage} />
3737+3838+### With Actions
3939+4040+Cards can include header actions for interactive elements.
4141+4242+<Example src={CardWithActions} />
4343+4444+### With Badges
4545+4646+Cards can include badges for status indicators and tags.
4747+4848+<Example src={CardWithBadges} />
4949+5050+### Sizes
5151+5252+The card supports three different sizes that affect padding and spacing.
5353+5454+<Example src={CardSizes} />
5555+5656+## Related Components
5757+5858+- [Table](/components/table) - For structured data display
5959+- [Badge](/components/badge) - For status indicators in cards
6060+- [Button](/components/button) - For card actions
6161+- [AspectRatio](/components/aspect-ratio) - For card images
+47
apps/docs/src/docs/components/checkbox.mdx
···11+---
22+title: Checkbox
33+description: A checkbox component for selecting one or more options from a set.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/checkbox/basic'
99+import { CheckboxStates } from '../../examples/checkbox/states'
1010+import { CheckboxWithDescription } from '../../examples/checkbox/with-description'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the checkbox component to your project.
1717+1818+```bash
1919+pnpm hip install checkbox
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Checkbox](https://react-spectrum.adobe.com/react-aria/Checkbox.html).
2525+2626+<PropDocs components={["Checkbox", "CheckboxGroup"]} />
2727+2828+## Features
2929+3030+### States
3131+3232+Checkboxes support different states including checked, unchecked, indeterminate, and disabled.
3333+3434+<Example src={CheckboxStates} />
3535+3636+### With Description
3737+3838+Checkboxes can include descriptive text to provide additional context.
3939+4040+<Example src={CheckboxWithDescription} />
4141+4242+## Related Components
4343+4444+- [Radio](/components/radio) - For single selection from multiple options
4545+- [Switch](/components/switch) - For binary toggle choices
4646+- [Select](/components/select) - For dropdown selection
4747+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/color-field.mdx
···11+---
22+title: Color Field
33+description: A color input component for selecting colors with a color picker.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/color-field/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the color field component to your project.
1515+1616+```bash
1717+pnpm hip install color-field
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria ColorField](https://react-spectrum.adobe.com/react-aria/ColorField.html).
2323+2424+<PropDocs components={["ColorField"]} />
2525+2626+## Related Components
2727+2828+- [ColorSwatch](/components/color-swatch) - For displaying color values
2929+- [TextField](/components/text-field) - For general text input
3030+- [NumberField](/components/number-field) - For numeric input
3131+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/color-swatch.mdx
···11+---
22+title: Color Swatch
33+description: A color swatch component for displaying color values.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/color-swatch/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the color swatch component to your project.
1515+1616+```bash
1717+pnpm hip install color-swatch
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria ColorSwatch](https://react-spectrum.adobe.com/react-aria/ColorSwatch.html).
2323+2424+<PropDocs components={["ColorSwatch"]} />
2525+2626+## Related Components
2727+2828+- [ColorField](/components/color-field) - For color input with color swatches
2929+- [Card](/components/card) - For displaying color swatches in cards
3030+- [Grid](/components/grid) - For organizing color swatches in grids
3131+- [Button](/components/button) - For interactive color swatches
+31
apps/docs/src/docs/components/combobox.mdx
···11+---
22+title: Combo Box
33+description: A combo box component that combines a text input with a dropdown list of options.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/combobox/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the combo box component to your project.
1515+1616+```bash
1717+pnpm hip install combobox
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria ComboBox](https://react-spectrum.adobe.com/react-aria/ComboBox.html).
2323+2424+<PropDocs components={["ComboBox", "ComboBoxItem", "ComboBoxSection", "ComboBoxSectionHeader", "ComboBoxSeparator"]} />
2525+2626+## Related Components
2727+2828+- [Select](/components/select) - For dropdown selection without search
2929+- [SearchField](/components/search-field) - For search input with clear button
3030+- [TextField](/components/text-field) - For general text input
3131+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/command-menu.mdx
···11+---
22+title: Command Menu
33+description: A command menu component for displaying a searchable list of commands or actions.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/command-menu/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the command menu component to your project.
1515+1616+```bash
1717+pnpm hip install command-menu
1818+```
1919+2020+## Props
2121+2222+The command menu is a custom component built using a SearchField, Dialog, and Menu.
2323+2424+<PropDocs components={["CommandMenu", "CommandMenuItem", "CommandMenuSection", "CommandMenuSectionHeader", "CommandMenuSeparator"]} />
2525+2626+## Related Components
2727+2828+- [SearchField](/components/search-field) - For the search input in command menus
2929+- [Menu](/components/menu) - The underlying menu component
3030+- [Dialog](/components/dialog) - For the modal container
3131+- [ListBox](/components/listbox) - For displaying command results
+31
apps/docs/src/docs/components/context-menu.mdx
···11+---
22+title: Context Menu
33+description: A context menu component that appears on right-click or long press.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/context-menu/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the context menu component to your project.
1515+1616+```bash
1717+pnpm hip install context-menu
1818+```
1919+2020+## Props
2121+2222+This is a custom component built using a Menu and a custom logic to position a Popover.
2323+2424+<PropDocs components={["ContextMenu", "ContextMenuTrigger"]} />
2525+2626+## Related Components
2727+2828+- [Menu](/components/menu) - The underlying menu component
2929+- [Popover](/components/popover) - For positioning the context menu
3030+- [CommandMenu](/components/command-menu) - For command palette menus
3131+- [Button](/components/button) - For context menu triggers
+31
apps/docs/src/docs/components/date-field.mdx
···11+---
22+title: Date Field
33+description: A date input component for selecting dates with proper formatting.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/date-field/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the date field component to your project.
1515+1616+```bash
1717+pnpm hip install date-field
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria DateField](https://react-spectrum.adobe.com/react-aria/DateField.html).
2323+2424+<PropDocs components={["DateField"]} />
2525+2626+## Related Components
2727+2828+- [TimeField](/components/time-field) - For time input
2929+- [TextField](/components/text-field) - For general text input
3030+- [NumberField](/components/number-field) - For numeric input
3131+- [Label](/components/label) - For form labels and descriptions
+47
apps/docs/src/docs/components/dialog.mdx
···11+---
22+title: Dialog
33+description: A modal dialog component for displaying content in an overlay.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/dialog/basic'
99+import { DialogForm } from '../../examples/dialog/form'
1010+import { DialogSizes } from '../../examples/dialog/sizes'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the dialog component to your project.
1717+1818+```bash
1919+pnpm hip install dialog
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Dialog](https://react-spectrum.adobe.com/react-aria/Dialog.html).
2525+2626+<PropDocs components={["Dialog", "DialogHeader", "DialogDescription", "DialogFooter"]} />
2727+2828+## Features
2929+3030+### Form Dialog
3131+3232+Dialogs can contain forms for data collection and user input.
3333+3434+<Example src={DialogForm} />
3535+3636+### Sizes
3737+3838+Dialogs support different sizes to accommodate various content types.
3939+4040+<Example src={DialogSizes} />
4141+4242+## Related Components
4343+4444+- [AlertDialog](/components/alert-dialog) - For critical actions and confirmations
4545+- [Popover](/components/popover) - For non-modal overlays
4646+- [Button](/components/button) - For dialog action buttons
4747+- [Form](/components/form) - For forms within dialogs
+31
apps/docs/src/docs/components/file-drop-zone.mdx
···11+---
22+title: File Drop Zone
33+description: A file drop zone component for drag and drop file uploads.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/file-drop-zone/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the file drop zone component to your project.
1515+1616+```bash
1717+pnpm hip install file-drop-zone
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria DropZone](https://react-spectrum.adobe.com/react-aria/DropZone.html) and [React Aria FileTrigger](https://react-spectrum.adobe.com/react-spectrum/FileTrigger.html#filetrigger).
2323+2424+<PropDocs components={["FileDropZone"]} />
2525+2626+## Related Components
2727+2828+- [Button](/components/button) - For file upload triggers
2929+- [Card](/components/card) - For containing file drop zones
3030+- [Badge](/components/badge) - For file upload status indicators
3131+- [Typography](/components/typography) - For file upload instructions
+61
apps/docs/src/docs/components/flex.mdx
···11+---
22+title: Flex
33+description: A flexible container component for creating flexible layouts.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/flex/basic'
99+import { FlexDirections } from '../../examples/flex/directions'
1010+import { FlexAlignment } from '../../examples/flex/alignment'
1111+import { FlexWrap } from '../../examples/flex/wrap'
1212+import { FlexGap } from '../../examples/flex/gap'
1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the flex component to your project.
1919+2020+```bash
2121+pnpm hip install flex
2222+```
2323+2424+## Props
2525+2626+This is a custom component built for flexible layouts.
2727+2828+<PropDocs components={["Flex"]} />
2929+3030+## Features
3131+3232+### Directions
3333+3434+Flex containers can be arranged in different directions.
3535+3636+<Example src={FlexDirections} />
3737+3838+### Alignment
3939+4040+Flex items can be aligned using various justify and align properties.
4141+4242+<Example src={FlexAlignment} />
4343+4444+### Wrap
4545+4646+Flex containers can wrap their children to new lines when needed.
4747+4848+<Example src={FlexWrap} />
4949+5050+### Gap
5151+5252+Flex containers support different gap sizes between items.
5353+5454+<Example src={FlexGap} />
5555+5656+## Related Components
5757+5858+- [Grid](/components/grid) - For two-dimensional layouts
5959+- [Card](/components/card) - For grouping content in flex layouts
6060+- [ButtonGroup](/components/button-group) - For grouping buttons in flex layouts
6161+- [Separator](/components/separator) - For visual separation in flex layouts
+40
apps/docs/src/docs/components/grid.mdx
···11+---
22+title: Grid
33+description: A grid container component for creating two-dimensional layouts.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/grid/basic'
99+import { GridSpans } from '../../examples/grid/spans'
1010+1111+<Example src={Basic} />
1212+1313+## Installation
1414+1515+Run the following command to add the grid component to your project.
1616+1717+```bash
1818+pnpm hip install grid
1919+```
2020+2121+## Props
2222+2323+This is a custom component built for grid layouts.
2424+2525+<PropDocs components={["Grid", "GridItem"]} />
2626+2727+## Features
2828+2929+### Grid Spans
3030+3131+Grid items can span multiple columns and rows.
3232+3333+<Example src={GridSpans} />
3434+3535+## Related Components
3636+3737+- [Flex](/components/flex) - For one-dimensional flexible layouts
3838+- [Card](/components/card) - For grouping content in grid layouts
3939+- [AspectRatio](/components/aspect-ratio) - For maintaining aspect ratios in grid items
4040+- [Table](/components/table) - For structured data in grid layouts
+47
apps/docs/src/docs/components/icon-button.mdx
···11+---
22+title: Icon Button
33+description: A button component specifically designed for icons with built-in tooltip support.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/icon-button/basic'
99+import { IconButtonVariants } from '../../examples/icon-button/variants'
1010+import { IconButtonSizes } from '../../examples/icon-button/sizes'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the icon button component to your project.
1717+1818+```bash
1919+pnpm hip install icon-button
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Button](https://react-spectrum.adobe.com/react-aria/Button.html).
2525+2626+<PropDocs components={["IconButton"]} />
2727+2828+## Features
2929+3030+### Variants
3131+3232+Icon buttons support the same variants as regular buttons.
3333+3434+<Example src={IconButtonVariants} />
3535+3636+### Sizes
3737+3838+Icon buttons support three different sizes.
3939+4040+<Example src={IconButtonSizes} />
4141+4242+## Related Components
4343+4444+- [Button](/components/button) - For buttons with text and icons
4545+- [ToggleButton](/components/toggle-button) - For toggleable icon buttons
4646+- [Tooltip](/components/tooltip) - For providing context on icon-only buttons
4747+- [ButtonGroup](/components/button-group) - For grouping icon buttons together
+40
apps/docs/src/docs/components/label.mdx
···11+---
22+title: Label
33+description: A label component for form elements with optional descriptions.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/label/basic'
99+import { LabelSizes } from '../../examples/label/sizes'
1010+1111+<Example src={Basic} />
1212+1313+## Installation
1414+1515+Run the following command to add the label component to your project.
1616+1717+```bash
1818+pnpm hip install label
1919+```
2020+2121+## Props
2222+2323+This component is built using the [React Aria Label](https://react-spectrum.adobe.com/react-aria/Label.html).
2424+2525+<PropDocs components={["Label", "Description"]} />
2626+2727+## Features
2828+2929+### Sizes
3030+3131+Labels support three different sizes.
3232+3333+<Example src={LabelSizes} />
3434+3535+## Related Components
3636+3737+- [TextField](/components/text-field) - Form inputs that use labels
3838+- [Checkbox](/components/checkbox) - Form controls that use labels
3939+- [Radio](/components/radio) - Form controls that use labels
4040+- [Switch](/components/switch) - Form controls that use labels
+31
apps/docs/src/docs/components/link.mdx
···11+---
22+title: Link
33+description: A link component for navigation and external references.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/link/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the link component to your project.
1515+1616+```bash
1717+pnpm hip install link
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Link](https://react-spectrum.adobe.com/react-aria/Link.html).
2323+2424+<PropDocs components={["Link"]} />
2525+2626+## Related Components
2727+2828+- [Button](/components/button) - For action buttons that look like links
2929+- [IconButton](/components/icon-button) - For icon-only navigation buttons
3030+- [Typography](/components/typography) - For text styling and hierarchy
3131+- [Badge](/components/badge) - For status indicators on links
+31
apps/docs/src/docs/components/listbox.mdx
···11+---
22+title: List Box
33+description: A list box component for displaying a list of selectable items.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/listbox/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the list box component to your project.
1515+1616+```bash
1717+pnpm hip install listbox
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria ListBox](https://react-spectrum.adobe.com/react-aria/ListBox.html).
2323+2424+<PropDocs components={["ListBox", "ListBoxItem", "ListBoxSection", "ListBoxSeparator", "ListBoxSectionHeader"]} />
2525+2626+## Related Components
2727+2828+- [Select](/components/select) - For dropdown selection using ListBox
2929+- [ComboBox](/components/combobox) - For searchable selection using ListBox
3030+- [Tree](/components/tree) - For hierarchical data display
3131+- [Table](/components/table) - For structured data display
+31
apps/docs/src/docs/components/menu.mdx
···11+---
22+title: Menu
33+description: A menu component for displaying a list of actions or options.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/menu/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the menu component to your project.
1515+1616+```bash
1717+pnpm hip install menu
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Menu](https://react-spectrum.adobe.com/react-aria/Menu.html).
2323+2424+<PropDocs components={["Menu", "MenuItem", "MenuSection", "SubMenu"]} />
2525+2626+## Related Components
2727+2828+- [ContextMenu](/components/context-menu) - For right-click context menus
2929+- [CommandMenu](/components/command-menu) - For command palette menus
3030+- [Popover](/components/popover) - For menu containers
3131+- [Button](/components/button) - For menu triggers
+31
apps/docs/src/docs/components/number-field.mdx
···11+---
22+title: Number Field
33+description: A number input component with increment/decrement buttons and validation.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/number-field/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the number field component to your project.
1515+1616+```bash
1717+pnpm hip install number-field
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria NumberField](https://react-spectrum.adobe.com/react-aria/NumberField.html).
2323+2424+<PropDocs components={["NumberField"]} />
2525+2626+## Related Components
2727+2828+- [TextField](/components/text-field) - For general text input
2929+- [TextArea](/components/text-area) - For multi-line text input
3030+- [SearchField](/components/search-field) - For search input with clear button
3131+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/popover.mdx
···11+---
22+title: Popover
33+description: A popover component for displaying content in an overlay.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/popover/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the popover component to your project.
1515+1616+```bash
1717+pnpm hip install popover
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Popover](https://react-spectrum.adobe.com/react-aria/Popover.html).
2323+2424+<PropDocs components={["Popover"]} />
2525+2626+## Related Components
2727+2828+- [Dialog](/components/dialog) - For modal overlays
2929+- [Tooltip](/components/tooltip) - For contextual help overlays
3030+- [Menu](/components/menu) - For dropdown menus
3131+- [ContextMenu](/components/context-menu) - For right-click context menus
+47
apps/docs/src/docs/components/radio.mdx
···11+---
22+title: Radio
33+description: A radio button component for selecting a single option from a group.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/radio/basic'
99+import { RadioWithDescription } from '../../examples/radio/with-description'
1010+import { RadioHorizontal } from '../../examples/radio/horizontal'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the radio component to your project.
1717+1818+```bash
1919+pnpm hip install radio
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Radio](https://react-spectrum.adobe.com/react-aria/Radio.html).
2525+2626+<PropDocs components={["Radio", "RadioGroup"]} />
2727+2828+## Features
2929+3030+### With Description
3131+3232+Radio buttons can include descriptive text to provide additional context.
3333+3434+<Example src={RadioWithDescription} />
3535+3636+### Horizontal Layout
3737+3838+Radio groups can be displayed horizontally for compact layouts.
3939+4040+<Example src={RadioHorizontal} />
4141+4242+## Related Components
4343+4444+- [Checkbox](/components/checkbox) - For multiple selection options
4545+- [Switch](/components/switch) - For binary toggle choices
4646+- [Select](/components/select) - For dropdown selection
4747+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/search-field.mdx
···11+---
22+title: Search Field
33+description: A search input component with built-in search icon and clear functionality.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/search-field/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the search field component to your project.
1515+1616+```bash
1717+pnpm hip install search-field
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria SearchField](https://react-spectrum.adobe.com/react-aria/SearchField.html).
2323+2424+<PropDocs components={["SearchField"]} />
2525+2626+## Related Components
2727+2828+- [TextField](/components/text-field) - For general text input
2929+- [ComboBox](/components/combobox) - For searchable dropdown selection
3030+- [CommandMenu](/components/command-menu) - For command palette with search
3131+- [Label](/components/label) - For form labels and descriptions
+47
apps/docs/src/docs/components/select.mdx
···11+---
22+title: Select
33+description: A select component for choosing from a list of options.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/select/basic'
99+import { SelectWithDescription } from '../../examples/select/with-description'
1010+import { SelectSizes } from '../../examples/select/sizes'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the select component to your project.
1717+1818+```bash
1919+pnpm hip install select
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Select](https://react-spectrum.adobe.com/react-aria/Select.html).
2525+2626+<PropDocs components={["Select", "SelectItem", "SelectSection", "SelectSectionHeader", "SelectSeparator"]} />
2727+2828+## Features
2929+3030+### With Description
3131+3232+Select components can include descriptive text to provide additional context.
3333+3434+<Example src={SelectWithDescription} />
3535+3636+### Sizes
3737+3838+Select components support different sizes for various use cases.
3939+4040+<Example src={SelectSizes} />
4141+4242+## Related Components
4343+4444+- [ComboBox](/components/combobox) - For searchable dropdown selection
4545+- [Radio](/components/radio) - For single selection from multiple options
4646+- [Checkbox](/components/checkbox) - For multiple selection options
4747+- [Label](/components/label) - For form labels and descriptions
+40
apps/docs/src/docs/components/separator.mdx
···11+---
22+title: Separator
33+description: A visual divider component for separating content sections.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/separator/basic'
99+import { SeparatorOrientation } from '../../examples/separator/orientation'
1010+1111+<Example src={Basic} />
1212+1313+## Installation
1414+1515+Run the following command to add the separator component to your project.
1616+1717+```bash
1818+pnpm hip install separator
1919+```
2020+2121+## Props
2222+2323+This component is built using the [React Aria Separator](https://react-spectrum.adobe.com/react-aria/useSeparator.html#useseparator).
2424+2525+<PropDocs components={["Separator"]} />
2626+2727+## Features
2828+2929+### Orientation
3030+3131+Separators can be oriented horizontally or vertically.
3232+3333+<Example src={SeparatorOrientation} />
3434+3535+## Related Components
3636+3737+- [Flex](/components/flex) - For layouts that use separators
3838+- [Card](/components/card) - For cards that use separators
3939+- [Menu](/components/menu) - For menu items with separators
4040+- [Typography](/components/typography) - For text sections with separators
+47
apps/docs/src/docs/components/switch.mdx
···11+---
22+title: Switch
33+description: A toggle switch component for binary choices.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/switch/basic'
99+import { SwitchStates } from '../../examples/switch/states'
1010+import { SwitchWithDescription } from '../../examples/switch/with-description'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the switch component to your project.
1717+1818+```bash
1919+pnpm hip install switch
2020+```
2121+2222+## Props
2323+2424+This component is built using the [React Aria Switch](https://react-spectrum.adobe.com/react-aria/Switch.html).
2525+2626+<PropDocs components={["Switch"]} />
2727+2828+## Features
2929+3030+### States
3131+3232+Switches support different states including checked, unchecked, and disabled.
3333+3434+<Example src={SwitchStates} />
3535+3636+### With Description
3737+3838+Switches can include descriptive text to provide additional context.
3939+4040+<Example src={SwitchWithDescription} />
4141+4242+## Related Components
4343+4444+- [Checkbox](/components/checkbox) - For multiple selection options
4545+- [Radio](/components/radio) - For single selection from multiple options
4646+- [ToggleButton](/components/toggle-button) - For toggleable button states
4747+- [Label](/components/label) - For form labels and descriptions
+31
apps/docs/src/docs/components/table.mdx
···11+---
22+title: Table
33+description: A table component for displaying structured data in rows and columns.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/table/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the table component to your project.
1515+1616+```bash
1717+pnpm hip install table
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Table](https://react-spectrum.adobe.com/react-aria/Table.html).
2323+2424+<PropDocs components={["Table", "TableHeader", "TableBody", "TableColumn", "TableRow", "TableCell"]} />
2525+2626+## Related Components
2727+2828+- [ListBox](/components/listbox) - For selectable list data
2929+- [Tree](/components/tree) - For hierarchical data display
3030+- [Card](/components/card) - For displaying table data in cards
3131+- [Badge](/components/badge) - For status indicators in table cells
+31
apps/docs/src/docs/components/text-area.mdx
···11+---
22+title: Text Area
33+description: A multi-line text input component for longer text content.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/text-area/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the text area component to your project.
1515+1616+```bash
1717+pnpm hip install text-area
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria TextArea](https://react-spectrum.adobe.com/react-aria/TextArea.html).
2323+2424+<PropDocs components={["TextArea"]} />
2525+2626+## Related Components
2727+2828+- [TextField](/components/text-field) - For single-line text input
2929+- [NumberField](/components/number-field) - For numeric input
3030+- [SearchField](/components/search-field) - For search input with clear button
3131+- [Label](/components/label) - For form labels and descriptions
+61
apps/docs/src/docs/components/text-field.mdx
···11+---
22+title: Text Field
33+description: A text input component with support for labels, descriptions, and validation.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/text-field/basic'
99+import { TextFieldVariants } from '../../examples/text-field/variants'
1010+import { TextFieldSizes } from '../../examples/text-field/sizes'
1111+import { PasswordField } from '../../examples/text-field/password'
1212+import { PrefixAndSuffix } from '../../examples/text-field/prefix-and-suffix'
1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the text field component to your project.
1919+2020+```bash
2121+pnpm hip install text-field
2222+```
2323+2424+## Props
2525+2626+This component is built using the [React Aria TextField](https://react-spectrum.adobe.com/react-aria/TextField.html).
2727+2828+<PropDocs components={["TextField"]} />
2929+3030+## Features
3131+3232+### Prefix and Suffix
3333+3434+The text field supports a prefix and suffix.
3535+3636+<Example src={PrefixAndSuffix} />
3737+3838+### Variants
3939+4040+The text field supports different visual variants.
4141+4242+<Example src={TextFieldVariants} />
4343+4444+### Sizes
4545+4646+The text field supports three different sizes.
4747+4848+<Example src={TextFieldSizes} />
4949+5050+### Password Field
5151+5252+Text fields automatically include password visibility toggle when type is set to "password".
5353+5454+<Example src={PasswordField} />
5555+5656+## Related Components
5757+5858+- [TextArea](/components/text-area) - For multi-line text input
5959+- [NumberField](/components/number-field) - For numeric input
6060+- [SearchField](/components/search-field) - For search input with clear button
6161+- [Label](/components/label) - For form labels and descriptions
+61
apps/docs/src/docs/components/time-field.mdx
···11+---
22+title: Time Field
33+description: A time input component for selecting times with proper formatting.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/time-field/basic'
99+import { Sizes } from '../../examples/time-field/sizes'
1010+import { Variants } from '../../examples/time-field/variants'
1111+import { Description } from '../../examples/time-field/description'
1212+import { PrefixAndSuffix } from '../../examples/time-field/prefix-and-suffix'
1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the time field component to your project.
1919+2020+```bash
2121+pnpm hip install time-field
2222+```
2323+2424+## Features
2525+2626+### Prefix and Suffix
2727+2828+The time field component supports a prefix and suffix.
2929+3030+<Example src={PrefixAndSuffix} />
3131+3232+### Sizes
3333+3434+The time field component comes in three sizes: small, medium, and large.
3535+3636+<Example src={Sizes} />
3737+3838+### Variants
3939+4040+The time field component comes in three variants: primary, secondary, and tertiary.
4141+4242+<Example src={Variants} />
4343+4444+### Description
4545+4646+The time field component supports a description.
4747+4848+<Example src={Description} />
4949+5050+## Props
5151+5252+This component is built using the [React Aria TimeField](https://react-spectrum.adobe.com/react-aria/TimeField.html).
5353+5454+<PropDocs components={["TimeField"]} />
5555+5656+## Related Components
5757+5858+- [DateField](/components/date-field) - For date input
5959+- [TextField](/components/text-field) - For general text input
6060+- [NumberField](/components/number-field) - For numeric input
6161+- [Label](/components/label) - For form labels and descriptions
···11+---
22+title: Toggle Button Group
33+description: A group of toggle buttons that work together as a single control.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+99+import { Basic } from '../../examples/toggle-button-group/basic'
1010+import { Orientation } from '../../examples/toggle-button-group/orientation'
1111+import { Variants } from '../../examples/toggle-button-group/variants'
1212+1313+1414+<Example src={Basic} />
1515+1616+## Installation
1717+1818+Run the following command to add the toggle button group component to your project.
1919+2020+```bash
2121+pnpm hip install toggle-button-group
2222+```
2323+2424+## Features
2525+2626+### Orientation
2727+2828+The toggle button group component can be oriented horizontally or vertically.
2929+3030+<Example src={Orientation} />
3131+3232+### Variants
3333+3434+The toggle button group component can be grouped or separate.
3535+3636+<Example src={Variants} />
3737+3838+## Props
3939+4040+<PropDocs components={["ToggleButtonGroup"]} />
4141+4242+## Related Components
4343+4444+- [ToggleButton](/components/toggle-button) - Individual toggle buttons within the group
4545+- [ButtonGroup](/components/button-group) - For grouping regular buttons together
4646+- [Radio](/components/radio) - For single-selection from multiple options
4747+- [Checkbox](/components/checkbox) - For multiple-selection options
+47
apps/docs/src/docs/components/toggle-button.mdx
···11+---
22+title: Toggle Button
33+description: A toggle button component that can be pressed to toggle between states.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/toggle-button/basic'
99+import { Sizes } from '../../examples/toggle-button/sizes'
1010+import { Variants } from '../../examples/toggle-button/variants'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the toggle button component to your project.
1717+1818+```bash
1919+pnpm hip install toggle-button
2020+```
2121+2222+## Features
2323+2424+### Sizes
2525+2626+The toggle button component comes in three sizes: small, medium, and large.
2727+2828+<Example src={Sizes} />
2929+3030+### Variants
3131+3232+The toggle button component comes in four variants: primary, secondary, tertiary, and outline.
3333+3434+<Example src={Variants} />
3535+3636+## Props
3737+3838+This component is built using the [React Aria Toggle Button](https://react-spectrum.adobe.com/react-aria/ToggleButton.html).
3939+4040+<PropDocs components={["ToggleButton"]} />
4141+4242+## Related Components
4343+4444+- [Button](/components/button) - For regular clickable buttons
4545+- [IconButton](/components/icon-button) - For icon-only toggle buttons
4646+- [ToggleButtonGroup](/components/toggle-button-group) - For grouping toggle buttons together
4747+- [Switch](/components/switch) - For toggle switches with labels
+60
apps/docs/src/docs/components/tooltip.mdx
···11+---
22+title: Tooltip
33+description: A tooltip component that displays helpful information on hover.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/tooltip/basic'
99+import { TooltipPlacements } from '../../examples/tooltip/placements'
1010+1111+<Example src={Basic} />
1212+1313+## Installation
1414+1515+Run the following command to add the tooltip component to your project.
1616+1717+```bash
1818+pnpm hip install tooltip
1919+```
2020+2121+## Features
2222+2323+### Placements
2424+2525+Tooltips can be positioned in different directions around the trigger element.
2626+2727+<Example src={TooltipPlacements} />
2828+2929+## Usage Guidelines
3030+3131+When using tooltips, follow these best practices:
3232+3333+### Do
3434+3535+- Use tooltips to provide additional context for UI elements that may be unclear
3636+- Keep tooltip content brief and focused
3737+- Use tooltips for icon-only buttons or truncated text that needs clarification
3838+- Use tooltips for supplementary information that's not critical for basic task completion
3939+4040+### Don't
4141+4242+- Put essential information only in tooltips - critical content should be visible by default
4343+- Use tooltips for complex interactive content (use a popover or modal instead)
4444+- Place tooltips on disabled elements (users can't hover/focus them)
4545+- Nest tooltips within other tooltips
4646+- Use tooltips for content that needs to be persistent or copied
4747+- Make tooltips too long - keep them concise and scannable
4848+4949+## Props
5050+5151+This component is built using the [React Aria Tooltip](https://react-spectrum.adobe.com/react-aria/Tooltip.html).
5252+5353+<PropDocs components={["Tooltip"]} />
5454+5555+## Related Components
5656+5757+- [Popover](/components/popover) - For more complex overlay content
5858+- [IconButton](/components/icon-button) - Often used with tooltips for context
5959+- [Button](/components/button) - Can be enhanced with tooltips
6060+- [Badge](/components/badge) - Can be enhanced with tooltips for additional info
+31
apps/docs/src/docs/components/tree.mdx
···11+---
22+title: Tree
33+description: A tree component for displaying hierarchical data with expandable nodes.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/tree/basic'
99+1010+<Example src={Basic} />
1111+1212+## Installation
1313+1414+Run the following command to add the tree component to your project.
1515+1616+```bash
1717+pnpm hip install tree
1818+```
1919+2020+## Props
2121+2222+This component is built using the [React Aria Tree](https://react-spectrum.adobe.com/react-aria/Tree.html).
2323+2424+<PropDocs components={["Tree", "TreeItem"]} />
2525+2626+## Related Components
2727+2828+- [ListBox](/components/listbox) - For flat list data
2929+- [Table](/components/table) - For structured data display
3030+- [Card](/components/card) - For displaying tree data in cards
3131+- [Menu](/components/menu) - For hierarchical menu structures
+54
apps/docs/src/docs/components/typography.mdx
···11+---
22+title: Typography
33+description: A collection of text components for consistent typography throughout your application.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Headings } from '../../examples/typography/headings'
99+import { Text } from '../../examples/typography/text'
1010+import { TextVariants } from '../../examples/typography/variants'
1111+import { Lists } from '../../examples/typography/lists'
1212+1313+<Example src={Headings} />
1414+1515+## Installation
1616+1717+Run the following command to add the typography component to your project.
1818+1919+```bash
2020+pnpm hip install typography
2121+```
2222+2323+## Props
2424+2525+This is a custom component collection built for typography.
2626+2727+<PropDocs components={["Heading1", "Heading2", "Heading3", "Heading4", "Heading5", "Body", "SmallBody", "LabelText", "SubLabel", "Blockquote", "UnorderedList", "OrderedList", "ListItem", "InlineCode"]} />
2828+2929+## Features
3030+3131+### Text Components
3232+3333+Typography includes various text components for different use cases.
3434+3535+<Example src={Text} />
3636+3737+### Text Variants
3838+3939+Text components support different variants for styling.
4040+4141+<Example src={TextVariants} />
4242+4343+### Lists and Other Elements
4444+4545+Typography also includes list components and other text elements.
4646+4747+<Example src={Lists} />
4848+4949+## Related Components
5050+5151+- [Link](/components/link) - For text links within typography
5252+- [Badge](/components/badge) - For status indicators in text
5353+- [Card](/components/card) - For containing typography content
5454+- [Label](/components/label) - For form labels and descriptions
+22
apps/docs/src/examples/alert-dialog/basic.tsx
···11+import {
22+ AlertDialog,
33+ AlertDialogHeader,
44+ AlertDialogFooter,
55+ AlertDialogDescription,
66+} from "@/components/alert-dialog";
77+import { Button } from "@/components/button";
88+99+export function Basic() {
1010+ return (
1111+ <AlertDialog trigger={<Button variant="critical">Delete Item</Button>}>
1212+ <AlertDialogHeader>Are you sure?</AlertDialogHeader>
1313+ <AlertDialogDescription>
1414+ This action cannot be undone. This will permanently delete the item.
1515+ </AlertDialogDescription>
1616+ <AlertDialogFooter>
1717+ <Button variant="secondary">Cancel</Button>
1818+ <Button variant="critical">Delete</Button>
1919+ </AlertDialogFooter>
2020+ </AlertDialog>
2121+ );
2222+}
···11+import { Dialog, DialogHeader } from "@/components/dialog";
22+import { Button } from "@/components/button";
33+import { Flex } from "@/components/flex";
44+55+export function DialogSizes() {
66+ return (
77+ <Flex gap="4" wrap>
88+ <Dialog trigger={<Button>Small Dialog</Button>}>
99+ <DialogHeader>Small Dialog</DialogHeader>
1010+ <p>This is a small dialog with minimal content.</p>
1111+ </Dialog>
1212+1313+ <Dialog trigger={<Button>Large Dialog</Button>}>
1414+ <DialogHeader>Large Dialog</DialogHeader>
1515+ <p>This is a large dialog with more space for content.</p>
1616+ <p>Perfect for forms, detailed information, or complex layouts.</p>
1717+ </Dialog>
1818+ </Flex>
1919+ );
2020+}
+18
apps/docs/src/examples/file-drop-zone/basic.tsx
···11+import { FileDropZone } from "@/components/file-drop-zone";
22+33+export function Basic() {
44+ return (
55+ <FileDropZone onDrop={(files) => console.log("Files dropped:", files)}>
66+ <div
77+ style={{
88+ padding: "2rem",
99+ border: "2px dashed #ccc",
1010+ borderRadius: "8px",
1111+ textAlign: "center",
1212+ }}
1313+ >
1414+ Drop files here or click to upload
1515+ </div>
1616+ </FileDropZone>
1717+ );
1818+}
···11+import { Link } from "@/components/link";
22+33+export function Basic() {
44+ return (
55+ <div>
66+ <p>
77+ This is a paragraph with a <Link href="https://example.com">link</Link>{" "}
88+ in it.
99+ </p>
1010+ <Link href="https://example.com">Standalone link</Link>
1111+ </div>
1212+ );
1313+}
···11+import { Body, SmallBody, LabelText, SubLabel } from "@/components/typography";
22+33+export function Text() {
44+ return (
55+ <div>
66+ <Body>This is a body text paragraph.</Body>
77+ <SmallBody>This is small body text.</SmallBody>
88+ <LabelText>This is label text</LabelText>
99+ <SubLabel>This is sub label text</SubLabel>
1010+ </div>
1111+ );
1212+}
+14
apps/docs/src/examples/typography/variants.tsx
···11+import { Body, SmallBody, SubLabel } from "@/components/typography";
22+33+export function TextVariants() {
44+ return (
55+ <div>
66+ <Body variant="default">Default body text</Body>
77+ <Body variant="secondary">Secondary body text</Body>
88+ <SmallBody variant="default">Default small body text</SmallBody>
99+ <SmallBody variant="secondary">Secondary small body text</SmallBody>
1010+ <SubLabel variant="default">Default sub label</SubLabel>
1111+ <SubLabel variant="secondary">Secondary sub label</SubLabel>
1212+ </div>
1313+ );
1414+}
···5151});
52525353export interface AlertDialogProps extends DialogTriggerProps {
5454+ /**
5555+ * The trigger element to open the dialog.
5656+ */
5457 trigger: React.ReactNode;
5858+ /**
5959+ * The content of the dialog.
6060+ */
5561 children: React.ReactNode;
5662}
5763
+5
packages/hip-ui/src/components/avatar/index.tsx
···7575 React.ComponentProps<"div">,
7676 "style" | "className" | "children"
7777 > {
7878+ /** The stylex styles of the avatar. */
7879 style?: stylex.StyleXStyles | stylex.StyleXStyles[];
8080+ /** The source of the image. */
7981 src?: string;
8282+ /** The alt text of the image. */
8083 alt?: string;
8484+ /** The fallback content of the avatar. */
8185 fallback: React.ReactNode;
8686+ /** The size of the avatar. */
8287 size?: Size | "xl";
8388}
8489