@leitware/composables 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (209) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +387 -0
  3. package/dist/presets/brutalist.css +298 -0
  4. package/dist/presets/default.css +298 -0
  5. package/dist/presets/signal-pop.css +369 -0
  6. package/dist/styles.css +2 -0
  7. package/package.json +216 -0
  8. package/rules/composables.md +244 -0
  9. package/src/_internal/accordion.tsx +93 -0
  10. package/src/_internal/ai-elements/attachments.tsx +385 -0
  11. package/src/_internal/ai-elements/chain-of-thought.tsx +197 -0
  12. package/src/_internal/ai-elements/code-block.tsx +516 -0
  13. package/src/_internal/ai-elements/confirmation.tsx +150 -0
  14. package/src/_internal/ai-elements/conversation.tsx +148 -0
  15. package/src/_internal/ai-elements/inline-citation.tsx +248 -0
  16. package/src/_internal/ai-elements/message.tsx +292 -0
  17. package/src/_internal/ai-elements/plan.tsx +126 -0
  18. package/src/_internal/ai-elements/prompt-input.tsx +1285 -0
  19. package/src/_internal/ai-elements/reasoning.tsx +208 -0
  20. package/src/_internal/ai-elements/shimmer.tsx +72 -0
  21. package/src/_internal/ai-elements/sources.tsx +53 -0
  22. package/src/_internal/ai-elements/suggestion.tsx +48 -0
  23. package/src/_internal/ai-elements/task.tsx +64 -0
  24. package/src/_internal/ai-elements/tool.tsx +156 -0
  25. package/src/_internal/alert-dialog.tsx +159 -0
  26. package/src/_internal/alert.tsx +88 -0
  27. package/src/_internal/aspect-ratio.tsx +23 -0
  28. package/src/_internal/avatar.tsx +58 -0
  29. package/src/_internal/badge.tsx +60 -0
  30. package/src/_internal/breadcrumb.tsx +104 -0
  31. package/src/_internal/bubble.tsx +125 -0
  32. package/src/_internal/button-group.tsx +78 -0
  33. package/src/_internal/button.tsx +62 -0
  34. package/src/_internal/calendar.tsx +179 -0
  35. package/src/_internal/card.tsx +83 -0
  36. package/src/_internal/carousel.tsx +215 -0
  37. package/src/_internal/checkbox.tsx +26 -0
  38. package/src/_internal/code-block.tsx +53 -0
  39. package/src/_internal/collapsible.tsx +15 -0
  40. package/src/_internal/combobox.tsx +264 -0
  41. package/src/_internal/command.tsx +155 -0
  42. package/src/_internal/container.tsx +35 -0
  43. package/src/_internal/dialog.tsx +132 -0
  44. package/src/_internal/direction.tsx +12 -0
  45. package/src/_internal/divider.tsx +162 -0
  46. package/src/_internal/dropdown-menu.tsx +247 -0
  47. package/src/_internal/dropzone.tsx +481 -0
  48. package/src/_internal/empty.tsx +94 -0
  49. package/src/_internal/field.tsx +221 -0
  50. package/src/_internal/grid-overlay.tsx +48 -0
  51. package/src/_internal/grid.tsx +109 -0
  52. package/src/_internal/hover-card.tsx +47 -0
  53. package/src/_internal/icon.tsx +45 -0
  54. package/src/_internal/input-group.tsx +146 -0
  55. package/src/_internal/input.tsx +24 -0
  56. package/src/_internal/item.tsx +187 -0
  57. package/src/_internal/kbd.tsx +28 -0
  58. package/src/_internal/label.tsx +18 -0
  59. package/src/_internal/layout-bento.tsx +386 -0
  60. package/src/_internal/layout.tsx +174 -0
  61. package/src/_internal/marker.tsx +66 -0
  62. package/src/_internal/message.tsx +85 -0
  63. package/src/_internal/native-select.tsx +50 -0
  64. package/src/_internal/pagination.tsx +108 -0
  65. package/src/_internal/popover.tsx +83 -0
  66. package/src/_internal/progress.tsx +59 -0
  67. package/src/_internal/radio-group.tsx +36 -0
  68. package/src/_internal/resizable.tsx +44 -0
  69. package/src/_internal/scroll-area.tsx +48 -0
  70. package/src/_internal/select.tsx +187 -0
  71. package/src/_internal/separator.tsx +19 -0
  72. package/src/_internal/sheet.tsx +122 -0
  73. package/src/_internal/sidebar.tsx +687 -0
  74. package/src/_internal/skeleton.tsx +13 -0
  75. package/src/_internal/slider.tsx +60 -0
  76. package/src/_internal/sonner.tsx +51 -0
  77. package/src/_internal/spacer.tsx +42 -0
  78. package/src/_internal/spinner.tsx +16 -0
  79. package/src/_internal/stack.tsx +78 -0
  80. package/src/_internal/switch.tsx +31 -0
  81. package/src/_internal/table.tsx +84 -0
  82. package/src/_internal/tabs.tsx +74 -0
  83. package/src/_internal/textarea.tsx +19 -0
  84. package/src/_internal/toggle-group.tsx +99 -0
  85. package/src/_internal/toggle.tsx +42 -0
  86. package/src/_internal/tooltip.tsx +55 -0
  87. package/src/_internal/typography.tsx +129 -0
  88. package/src/hooks/use-mobile.ts +19 -0
  89. package/src/hooks/use-numeric-input.ts +119 -0
  90. package/src/index.ts +443 -0
  91. package/src/lib/numeric-input.ts +88 -0
  92. package/src/lib/utils.ts +39 -0
  93. package/src/opinionated/accordion.tsx +92 -0
  94. package/src/opinionated/ai/attachments.tsx +27 -0
  95. package/src/opinionated/ai/chain-of-thought.tsx +16 -0
  96. package/src/opinionated/ai/code-block.tsx +22 -0
  97. package/src/opinionated/ai/confirmation.tsx +16 -0
  98. package/src/opinionated/ai/conversation.tsx +13 -0
  99. package/src/opinionated/ai/index.ts +15 -0
  100. package/src/opinionated/ai/inline-citation.tsx +30 -0
  101. package/src/opinionated/ai/message.tsx +26 -0
  102. package/src/opinionated/ai/plan.tsx +18 -0
  103. package/src/opinionated/ai/prompt-input.tsx +29 -0
  104. package/src/opinionated/ai/reasoning.tsx +9 -0
  105. package/src/opinionated/ai/shimmer.tsx +4 -0
  106. package/src/opinionated/ai/sources.tsx +10 -0
  107. package/src/opinionated/ai/suggestion.tsx +6 -0
  108. package/src/opinionated/ai/task.tsx +12 -0
  109. package/src/opinionated/ai/tool.tsx +14 -0
  110. package/src/opinionated/alert-dialog.tsx +143 -0
  111. package/src/opinionated/alert.tsx +99 -0
  112. package/src/opinionated/aspect-ratio.tsx +12 -0
  113. package/src/opinionated/avatar.tsx +59 -0
  114. package/src/opinionated/badge.tsx +33 -0
  115. package/src/opinionated/breadcrumb.tsx +99 -0
  116. package/src/opinionated/bubble.tsx +9 -0
  117. package/src/opinionated/button.tsx +59 -0
  118. package/src/opinionated/calendar.tsx +20 -0
  119. package/src/opinionated/card.tsx +83 -0
  120. package/src/opinionated/carousel.tsx +99 -0
  121. package/src/opinionated/checkbox.tsx +11 -0
  122. package/src/opinionated/code-block.tsx +12 -0
  123. package/src/opinionated/collapsible.tsx +123 -0
  124. package/src/opinionated/combobox.tsx +123 -0
  125. package/src/opinionated/container.tsx +12 -0
  126. package/src/opinionated/dialog.tsx +124 -0
  127. package/src/opinionated/direction.tsx +6 -0
  128. package/src/opinionated/divider.tsx +13 -0
  129. package/src/opinionated/dropdown-menu.tsx +131 -0
  130. package/src/opinionated/dropzone.tsx +39 -0
  131. package/src/opinionated/empty.tsx +191 -0
  132. package/src/opinionated/field.tsx +26 -0
  133. package/src/opinionated/form-calendar-popover.tsx +138 -0
  134. package/src/opinionated/form-checkbox.tsx +107 -0
  135. package/src/opinionated/form-combobox.tsx +181 -0
  136. package/src/opinionated/form-date-of-birth.tsx +193 -0
  137. package/src/opinionated/form-dropzone.tsx +126 -0
  138. package/src/opinionated/form-input-group.tsx +184 -0
  139. package/src/opinionated/form-input.tsx +118 -0
  140. package/src/opinionated/form-multi-combobox.tsx +213 -0
  141. package/src/opinionated/form-multi-dropzone.tsx +141 -0
  142. package/src/opinionated/form-radiogroup.tsx +116 -0
  143. package/src/opinionated/form-select.tsx +176 -0
  144. package/src/opinionated/form-slider.tsx +100 -0
  145. package/src/opinionated/form-switch.tsx +117 -0
  146. package/src/opinionated/form-textarea.tsx +79 -0
  147. package/src/opinionated/grid-overlay.tsx +11 -0
  148. package/src/opinionated/grid.tsx +14 -0
  149. package/src/opinionated/hover-card.tsx +59 -0
  150. package/src/opinionated/icon.tsx +14 -0
  151. package/src/opinionated/input-group.tsx +20 -0
  152. package/src/opinionated/input.tsx +11 -0
  153. package/src/opinionated/item.tsx +182 -0
  154. package/src/opinionated/kbd.tsx +16 -0
  155. package/src/opinionated/label.tsx +11 -0
  156. package/src/opinionated/layout-bento.tsx +29 -0
  157. package/src/opinionated/layout.tsx +26 -0
  158. package/src/opinionated/list.tsx +94 -0
  159. package/src/opinionated/marker.tsx +7 -0
  160. package/src/opinionated/message.tsx +8 -0
  161. package/src/opinionated/native-select.tsx +51 -0
  162. package/src/opinionated/pagination.tsx +204 -0
  163. package/src/opinionated/popover.tsx +68 -0
  164. package/src/opinionated/progress.tsx +48 -0
  165. package/src/opinionated/radio-group.tsx +13 -0
  166. package/src/opinionated/resizable.tsx +2 -0
  167. package/src/opinionated/scroll-area.tsx +82 -0
  168. package/src/opinionated/select.tsx +101 -0
  169. package/src/opinionated/separator.tsx +11 -0
  170. package/src/opinionated/sheet.tsx +120 -0
  171. package/src/opinionated/sidebar.tsx +68 -0
  172. package/src/opinionated/skeleton.tsx +246 -0
  173. package/src/opinionated/slider.tsx +11 -0
  174. package/src/opinionated/sonner.tsx +15 -0
  175. package/src/opinionated/spacer.tsx +11 -0
  176. package/src/opinionated/stack.tsx +18 -0
  177. package/src/opinionated/switch.tsx +11 -0
  178. package/src/opinionated/table.tsx +11 -0
  179. package/src/opinionated/tabs.tsx +68 -0
  180. package/src/opinionated/textarea.tsx +11 -0
  181. package/src/opinionated/theme-injector.tsx +31 -0
  182. package/src/opinionated/toggle-group.tsx +63 -0
  183. package/src/opinionated/toggle.tsx +75 -0
  184. package/src/opinionated/token-config-panel/color-editor.tsx +85 -0
  185. package/src/opinionated/token-config-panel/helpers.ts +31 -0
  186. package/src/opinionated/token-config-panel/index.tsx +398 -0
  187. package/src/opinionated/token-config-panel/json-import-export.tsx +89 -0
  188. package/src/opinionated/token-config-panel/preset-manager.ts +31 -0
  189. package/src/opinionated/token-config-panel/presets-data.ts +23 -0
  190. package/src/opinionated/token-config-panel/spacing-editor.tsx +325 -0
  191. package/src/opinionated/token-config-panel/types.ts +39 -0
  192. package/src/opinionated/token-config-panel/typography-editor.tsx +145 -0
  193. package/src/opinionated/tooltip.tsx +62 -0
  194. package/src/opinionated/typography.tsx +7 -0
  195. package/src/scripts/lint-no-arbitrary.ts +155 -0
  196. package/src/styles/composable.css +68 -0
  197. package/src/styles/presets/brutalist.css +298 -0
  198. package/src/styles/presets/default.css +298 -0
  199. package/src/styles/presets/signal-pop.css +369 -0
  200. package/src/styles/presets-data/brutalist.ts +325 -0
  201. package/src/styles/presets-data/default.ts +315 -0
  202. package/src/styles/presets-data/index.ts +45 -0
  203. package/src/styles/presets-data/signal-pop.ts +393 -0
  204. package/src/styles/tokens/base.css +71 -0
  205. package/src/styles/tokens/components.css +150 -0
  206. package/src/styles/tokens/palette.css +795 -0
  207. package/src/styles/tokens/registry.ts +324 -0
  208. package/src/styles/tokens/semantic.css +266 -0
  209. package/src/styles/tokens/tailwind-theme.css +247 -0
@@ -0,0 +1,123 @@
1
+ import { ChevronDownIcon, ChevronUpIcon } from 'lucide-react'
2
+ import type * as React from 'react'
3
+ import {
4
+ CollapsibleContent,
5
+ Collapsible as CollapsiblePrimitive,
6
+ CollapsibleTrigger,
7
+ } from '../_internal/collapsible'
8
+ import { FOCUS_RING } from '../lib/utils'
9
+
10
+ /**
11
+ * Props for the opinionated Collapsible component.
12
+ *
13
+ * Pass `trigger` to use the opinionated API (styled trigger row with chevron icon).
14
+ * Pass `children` directly for full manual control over the trigger/content structure.
15
+ *
16
+ * @example
17
+ * ```tsx
18
+ * <Collapsible trigger="Advanced settings" defaultOpen>
19
+ * <FormInput label="API key" />
20
+ * </Collapsible>
21
+ *
22
+ * // Controlled
23
+ * <Collapsible trigger="Details" open={open} onOpenChange={setOpen}>
24
+ * <p>Some content here</p>
25
+ * </Collapsible>
26
+ * ```
27
+ */
28
+ export interface CollapsibleProps extends Omit<
29
+ React.ComponentProps<typeof CollapsiblePrimitive>,
30
+ 'children'
31
+ > {
32
+ /** Content rendered in the clickable trigger row. */
33
+ trigger?: React.ReactNode
34
+ /** Content revealed when the collapsible is open. */
35
+ children?: React.ReactNode
36
+ /** Whether the collapsible starts open (uncontrolled). */
37
+ defaultOpen?: boolean
38
+ /** Controlled open state. */
39
+ open?: boolean
40
+ /** Called when the open state changes. */
41
+ onOpenChange?: (open: boolean) => void
42
+ className?: string
43
+ /** Whether to render the chevron expand/collapse icon in the trigger. @default true */
44
+ showIcon?: boolean
45
+ }
46
+
47
+ function Collapsible({
48
+ trigger,
49
+ children,
50
+ defaultOpen,
51
+ open,
52
+ onOpenChange,
53
+ className,
54
+ showIcon = true,
55
+ ...collapsibleProps
56
+ }: CollapsibleProps) {
57
+ // If opinionated props are provided, use opinionated API
58
+ if (trigger !== undefined) {
59
+ return (
60
+ <CollapsiblePrimitive
61
+ open={open}
62
+ onOpenChange={onOpenChange}
63
+ defaultOpen={defaultOpen}
64
+ className={className}
65
+ {...collapsibleProps}
66
+ >
67
+ <CollapsibleTrigger
68
+ className={`group/collapsible-trigger flex w-full items-center justify-between gap-2 rounded-md border border-transparent px-2 py-1.5 text-left text-xs/relaxed font-medium transition-[opacity,box-shadow] outline-none hover:bg-muted/50 ${FOCUS_RING} disabled:pointer-events-none disabled:opacity-50 aria-expanded:bg-muted/50 [--active-scale:1]`}
69
+ >
70
+ <span className="flex-1">{trigger}</span>
71
+ {showIcon && (
72
+ <>
73
+ <ChevronDownIcon
74
+ data-slot="collapsible-trigger-icon"
75
+ className="pointer-events-none shrink-0 size-4 text-muted-foreground group-aria-expanded/collapsible-trigger:hidden"
76
+ />
77
+ <ChevronUpIcon
78
+ data-slot="collapsible-trigger-icon"
79
+ className="pointer-events-none hidden shrink-0 size-4 text-muted-foreground group-aria-expanded/collapsible-trigger:inline"
80
+ />
81
+ </>
82
+ )}
83
+ </CollapsibleTrigger>
84
+ <CollapsibleContent className="data-open:animate-accordion-down data-closed:animate-accordion-up overflow-hidden px-2 text-xs/relaxed">
85
+ <div className="pt-0 pb-4 [&_a]:hover:text-foreground h-(--accordion-panel-height) data-ending-style:h-0 data-starting-style:h-0 [&_a]:underline [&_a]:underline-offset-3 [&_p:not(:last-child)]:mb-4">
86
+ {children}
87
+ </div>
88
+ </CollapsibleContent>
89
+ </CollapsiblePrimitive>
90
+ )
91
+ }
92
+
93
+ // Fallback to children-based API for advanced use cases
94
+ if (children) {
95
+ return (
96
+ <CollapsiblePrimitive
97
+ open={open}
98
+ onOpenChange={onOpenChange}
99
+ defaultOpen={defaultOpen}
100
+ className={className}
101
+ {...collapsibleProps}
102
+ >
103
+ {children}
104
+ </CollapsiblePrimitive>
105
+ )
106
+ }
107
+
108
+ // If neither opinionated props nor children provided, return empty collapsible
109
+ return (
110
+ <CollapsiblePrimitive
111
+ open={open}
112
+ onOpenChange={onOpenChange}
113
+ defaultOpen={defaultOpen}
114
+ className={className}
115
+ {...collapsibleProps}
116
+ >
117
+ {null}
118
+ </CollapsiblePrimitive>
119
+ )
120
+ }
121
+
122
+ // Re-export all collapsible sub-components for convenience
123
+ export { CollapsibleContent, CollapsibleTrigger, Collapsible }
@@ -0,0 +1,123 @@
1
+ import * as React from 'react'
2
+
3
+ import {
4
+ Combobox as ComboboxPrimitive,
5
+ ComboboxChip,
6
+ ComboboxChips,
7
+ ComboboxChipsInput,
8
+ ComboboxCollection,
9
+ ComboboxContent,
10
+ ComboboxEmpty,
11
+ ComboboxGroup,
12
+ ComboboxInput,
13
+ ComboboxItem,
14
+ ComboboxLabel,
15
+ ComboboxList,
16
+ ComboboxSeparator,
17
+ ComboboxTrigger,
18
+ ComboboxValue,
19
+ useComboboxAnchor,
20
+ } from '../_internal/combobox'
21
+
22
+ export interface ComboboxOption {
23
+ label: string
24
+ value: string
25
+ disabled?: boolean
26
+ }
27
+
28
+ export interface ComboboxProps {
29
+ /** Currently selected value */
30
+ value?: string
31
+ /** Callback when value changes */
32
+ onValueChange?: (value: string) => void
33
+ /** List of selectable options */
34
+ options: ComboboxOption[]
35
+ /** Placeholder text when no value is selected */
36
+ placeholder?: string
37
+ /** Placeholder text for the search input */
38
+ searchPlaceholder?: string
39
+ /** Message shown when no options match the search */
40
+ emptyMessage?: string
41
+ /** Whether the combobox is disabled */
42
+ disabled?: boolean
43
+ /** Additional class names for the input */
44
+ className?: string
45
+ }
46
+
47
+ /**
48
+ * Opinionated Combobox component with simplified options array API.
49
+ * Use for standalone searchable select dropdowns (not form-bound).
50
+ * For form usage, see form-combobox.
51
+ *
52
+ * @example
53
+ * ```tsx
54
+ * const [value, setValue] = useState('')
55
+ *
56
+ * <Combobox
57
+ * value={value}
58
+ * onValueChange={setValue}
59
+ * options={[
60
+ * { label: 'Apple', value: 'apple' },
61
+ * { label: 'Banana', value: 'banana' },
62
+ * { label: 'Cherry', value: 'cherry' },
63
+ * ]}
64
+ * placeholder="Select a fruit"
65
+ * searchPlaceholder="Search fruits..."
66
+ * emptyMessage="No fruits found"
67
+ * />
68
+ * ```
69
+ */
70
+ function Combobox({
71
+ value,
72
+ onValueChange,
73
+ options,
74
+ placeholder = 'Select...',
75
+ searchPlaceholder = 'Search...',
76
+ emptyMessage = 'No results found',
77
+ disabled = false,
78
+ className,
79
+ }: ComboboxProps) {
80
+ const selectedOption = options.find((opt) => opt.value === value)
81
+
82
+ return (
83
+ <ComboboxPrimitive value={value ?? null} onValueChange={(v) => onValueChange?.(v ?? '')}>
84
+ <ComboboxInput
85
+ placeholder={selectedOption?.label ?? placeholder}
86
+ disabled={disabled}
87
+ className={className}
88
+ showClear={!!value}
89
+ />
90
+ <ComboboxContent>
91
+ <ComboboxInput placeholder={searchPlaceholder} disabled={disabled} />
92
+ <ComboboxList>
93
+ {options.map((option) => (
94
+ <ComboboxItem key={option.value} value={option.value} disabled={option.disabled}>
95
+ {option.label}
96
+ </ComboboxItem>
97
+ ))}
98
+ </ComboboxList>
99
+ <ComboboxEmpty>{emptyMessage}</ComboboxEmpty>
100
+ </ComboboxContent>
101
+ </ComboboxPrimitive>
102
+ )
103
+ }
104
+
105
+ // Re-export sub-components for advanced usage
106
+ export {
107
+ ComboboxChip,
108
+ ComboboxChips,
109
+ ComboboxChipsInput,
110
+ ComboboxCollection,
111
+ ComboboxContent,
112
+ ComboboxEmpty,
113
+ ComboboxGroup,
114
+ ComboboxInput,
115
+ ComboboxItem,
116
+ ComboboxLabel,
117
+ ComboboxList,
118
+ ComboboxSeparator,
119
+ ComboboxTrigger,
120
+ ComboboxValue,
121
+ useComboboxAnchor,
122
+ }
123
+ export { Combobox }
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Opinionated Container component.
3
+ * Re-exports the primitive as the API is already clean.
4
+ *
5
+ * @example
6
+ * ```tsx
7
+ * <Container size="md">
8
+ * <p>Centered content with max-width constraint</p>
9
+ * </Container>
10
+ * ```
11
+ */
12
+ export { Container, type ContainerProps, containerVariants } from '../_internal/container'
@@ -0,0 +1,124 @@
1
+ import type { Dialog as DialogPrimitiveBase } from '@base-ui/react/dialog'
2
+ import type * as React from 'react'
3
+
4
+ import {
5
+ DialogClose,
6
+ DialogContent,
7
+ DialogDescription,
8
+ DialogFooter,
9
+ DialogHeader,
10
+ DialogOverlay,
11
+ DialogPortal,
12
+ Dialog as DialogPrimitive,
13
+ DialogTitle,
14
+ DialogTrigger,
15
+ } from '../_internal/dialog'
16
+
17
+ /**
18
+ * Props for the opinionated Dialog component.
19
+ *
20
+ * Provides a high-level API for common modal patterns. When `trigger`, `title`,
21
+ * `description`, or `footer` are provided, the component assembles the full dialog
22
+ * structure automatically. Pass only `children` for full manual control.
23
+ *
24
+ * @example
25
+ * ```tsx
26
+ * // Opinionated API
27
+ * <Dialog
28
+ * trigger={<Button>Open</Button>}
29
+ * title="Confirm deletion"
30
+ * description="This action cannot be undone."
31
+ * footer={<Button variant="destructive">Delete</Button>}
32
+ * >
33
+ * <p>Are you sure you want to delete this item?</p>
34
+ * </Dialog>
35
+ *
36
+ * // Controlled
37
+ * <Dialog open={open} onOpenChange={setOpen} title="Settings">
38
+ * <FormInput label="Name" />
39
+ * </Dialog>
40
+ * ```
41
+ */
42
+ export interface DialogProps extends Omit<DialogPrimitiveBase.Root.Props, 'children'> {
43
+ /** Element that opens the dialog when clicked (rendered as a `DialogTrigger`). */
44
+ trigger?: React.ReactNode
45
+ /** Dialog heading rendered in the header. */
46
+ title?: React.ReactNode
47
+ /** Subtitle text rendered below the title. */
48
+ description?: React.ReactNode
49
+ /** Dialog body content. */
50
+ children?: React.ReactNode
51
+ /** Content rendered in the dialog footer. */
52
+ footer?: React.ReactNode
53
+ /** Whether to show the built-in close (×) button. @default true */
54
+ showCloseButton?: boolean
55
+ className?: string
56
+ }
57
+
58
+ function Dialog({
59
+ trigger,
60
+ title,
61
+ description,
62
+ children,
63
+ footer,
64
+ showCloseButton = true,
65
+ className,
66
+ open,
67
+ onOpenChange,
68
+ ...dialogProps
69
+ }: DialogProps) {
70
+ // If opinionated props are provided, use opinionated API
71
+ if (
72
+ trigger !== undefined ||
73
+ title !== undefined ||
74
+ description !== undefined ||
75
+ footer !== undefined
76
+ ) {
77
+ return (
78
+ <DialogPrimitive open={open} onOpenChange={onOpenChange} {...dialogProps}>
79
+ {trigger && <DialogTrigger>{trigger}</DialogTrigger>}
80
+ <DialogContent className={className} showCloseButton={showCloseButton}>
81
+ {(title || description) && (
82
+ <DialogHeader>
83
+ {title && <DialogTitle>{title}</DialogTitle>}
84
+ {description && <DialogDescription>{description}</DialogDescription>}
85
+ </DialogHeader>
86
+ )}
87
+ {children}
88
+ {footer && <DialogFooter>{footer}</DialogFooter>}
89
+ </DialogContent>
90
+ </DialogPrimitive>
91
+ )
92
+ }
93
+
94
+ // Fallback to children-based API for advanced use cases
95
+ if (children) {
96
+ return (
97
+ <DialogPrimitive open={open} onOpenChange={onOpenChange} {...dialogProps}>
98
+ {children}
99
+ </DialogPrimitive>
100
+ )
101
+ }
102
+
103
+ // If neither opinionated props nor children provided, return empty dialog
104
+ return (
105
+ <DialogPrimitive open={open} onOpenChange={onOpenChange} {...dialogProps}>
106
+ {null}
107
+ </DialogPrimitive>
108
+ )
109
+ }
110
+
111
+ // Re-export all dialog sub-components for convenience
112
+ export {
113
+ DialogClose,
114
+ DialogContent,
115
+ DialogDescription,
116
+ DialogFooter,
117
+ DialogHeader,
118
+ DialogOverlay,
119
+ DialogPortal,
120
+ DialogTitle,
121
+ DialogTrigger,
122
+ }
123
+
124
+ export { Dialog }
@@ -0,0 +1,6 @@
1
+ export {
2
+ DirectionProvider,
3
+ useDirection,
4
+ type DirectionProviderProps,
5
+ type TextDirection,
6
+ } from '../_internal/direction'
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Opinionated Divider component.
3
+ * Re-exports the primitive as the API is already clean.
4
+ *
5
+ * @example
6
+ * ```tsx
7
+ * <Divider />
8
+ * <Divider variant="dots" />
9
+ * <Divider variant="pills" />
10
+ * <Divider orientation="vertical" />
11
+ * ```
12
+ */
13
+ export { Divider, type DividerProps, dividerVariants } from '../_internal/divider'
@@ -0,0 +1,131 @@
1
+ import type * as React from 'react'
2
+
3
+ import {
4
+ DropdownMenu as DropdownMenuPrimitive,
5
+ DropdownMenuCheckboxItem,
6
+ DropdownMenuContent,
7
+ DropdownMenuGroup,
8
+ DropdownMenuItem,
9
+ DropdownMenuLabel,
10
+ DropdownMenuPortal,
11
+ DropdownMenuRadioGroup,
12
+ DropdownMenuRadioItem,
13
+ DropdownMenuSeparator,
14
+ DropdownMenuShortcut,
15
+ DropdownMenuSub,
16
+ DropdownMenuSubContent,
17
+ DropdownMenuSubTrigger,
18
+ DropdownMenuTrigger,
19
+ } from '../_internal/dropdown-menu'
20
+
21
+ export interface DropdownMenuItemData {
22
+ /** Display label for the menu item */
23
+ label: React.ReactNode
24
+ /** Click handler */
25
+ onClick?: () => void
26
+ /** Icon to display before the label */
27
+ icon?: React.ReactNode
28
+ /** Keyboard shortcut to display */
29
+ shortcut?: string
30
+ /** Whether the item is disabled */
31
+ disabled?: boolean
32
+ /** Set to true to render a separator instead of an item */
33
+ separator?: boolean
34
+ /** Variant for destructive actions */
35
+ variant?: 'default' | 'destructive'
36
+ }
37
+
38
+ export interface DropdownMenuProps {
39
+ /** Trigger element that opens the menu */
40
+ trigger: React.ReactNode
41
+ /** Array of menu items */
42
+ items?: DropdownMenuItemData[]
43
+ /** Menu alignment relative to trigger */
44
+ align?: 'start' | 'center' | 'end'
45
+ /** Side to position the menu */
46
+ side?: 'top' | 'right' | 'bottom' | 'left'
47
+ /** Additional class names for the content */
48
+ className?: string
49
+ /** Children for advanced usage (overrides items) */
50
+ children?: React.ReactNode
51
+ }
52
+
53
+ /**
54
+ * Opinionated DropdownMenu component with items array API.
55
+ *
56
+ * @example
57
+ * ```tsx
58
+ * <DropdownMenu
59
+ * trigger={<Button>Open Menu</Button>}
60
+ * items={[
61
+ * { label: 'Edit', icon: <EditIcon />, onClick: () => console.log('edit') },
62
+ * { label: 'Copy', shortcut: '⌘C', onClick: () => console.log('copy') },
63
+ * { separator: true },
64
+ * { label: 'Delete', variant: 'destructive', onClick: () => console.log('delete') },
65
+ * ]}
66
+ * />
67
+ * ```
68
+ */
69
+ function DropdownMenu({
70
+ trigger,
71
+ items,
72
+ align = 'start',
73
+ side = 'bottom',
74
+ className,
75
+ children,
76
+ }: DropdownMenuProps) {
77
+ // If children provided, use primitive API
78
+ if (children) {
79
+ return (
80
+ <DropdownMenuPrimitive>
81
+ <DropdownMenuTrigger render={<>{trigger}</>} />
82
+ {children}
83
+ </DropdownMenuPrimitive>
84
+ )
85
+ }
86
+
87
+ return (
88
+ <DropdownMenuPrimitive>
89
+ <DropdownMenuTrigger render={<>{trigger}</>} />
90
+ <DropdownMenuContent align={align} side={side} className={className}>
91
+ {items?.map((item, index) => {
92
+ if (item.separator) {
93
+ return <DropdownMenuSeparator key={index} />
94
+ }
95
+
96
+ return (
97
+ <DropdownMenuItem
98
+ key={index}
99
+ onClick={item.onClick}
100
+ disabled={item.disabled}
101
+ variant={item.variant}
102
+ >
103
+ {item.icon}
104
+ {item.label}
105
+ {item.shortcut && <DropdownMenuShortcut>{item.shortcut}</DropdownMenuShortcut>}
106
+ </DropdownMenuItem>
107
+ )
108
+ })}
109
+ </DropdownMenuContent>
110
+ </DropdownMenuPrimitive>
111
+ )
112
+ }
113
+
114
+ // Re-export sub-components for advanced usage
115
+ export {
116
+ DropdownMenuCheckboxItem,
117
+ DropdownMenuContent,
118
+ DropdownMenuGroup,
119
+ DropdownMenuItem,
120
+ DropdownMenuLabel,
121
+ DropdownMenuPortal,
122
+ DropdownMenuRadioGroup,
123
+ DropdownMenuRadioItem,
124
+ DropdownMenuSeparator,
125
+ DropdownMenuShortcut,
126
+ DropdownMenuSub,
127
+ DropdownMenuSubContent,
128
+ DropdownMenuSubTrigger,
129
+ DropdownMenuTrigger,
130
+ }
131
+ export { DropdownMenu }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Opinionated Dropzone component.
3
+ * Re-exports the primitive as the API is already clean.
4
+ * For form-bound usage, see form-dropzone.
5
+ *
6
+ * @example
7
+ * ```tsx
8
+ * <Dropzone
9
+ * onDrop={(files) => console.log(files)}
10
+ * accept={{ 'image/*': ['.png', '.jpg'] }}
11
+ * maxSize={5 * 1024 * 1024}
12
+ * >
13
+ * <DropzoneInput />
14
+ * <DropzoneContent>
15
+ * <DropzoneLabel>Drop files here or click to upload</DropzoneLabel>
16
+ * </DropzoneContent>
17
+ * </Dropzone>
18
+ * ```
19
+ */
20
+ export {
21
+ DropZone,
22
+ DropZone as Dropzone,
23
+ DropZoneContent,
24
+ DropZoneContent as DropzoneContent,
25
+ DropZoneInput,
26
+ DropZoneInput as DropzoneInput,
27
+ DropZoneArea,
28
+ DropZoneArea as DropzoneLabel,
29
+ DropZoneFile,
30
+ DropZoneFileList,
31
+ useDropZoneContext,
32
+ formatFileSize,
33
+ getAcceptDescription,
34
+ getRejectionMessage,
35
+ DEFAULT_MAX_SIZE,
36
+ DEFAULT_ACCEPT,
37
+ ACCEPT_PRESETS,
38
+ } from '../_internal/dropzone'
39
+ export type { DropZoneProps, DropZoneFileProps, Accept, FileRejection } from '../_internal/dropzone'