@cognitap/radiant 0.0.2 → 0.0.4

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 (230) hide show
  1. package/CHANGELOG.md +357 -0
  2. package/README.md +944 -29
  3. package/dist/library/Accordion.d.ts +56 -0
  4. package/dist/library/Accordion.d.ts.map +1 -0
  5. package/dist/library/Accordion.js +89 -0
  6. package/dist/library/Accordion.js.map +1 -0
  7. package/dist/library/Button.d.ts +25 -3
  8. package/dist/library/Button.d.ts.map +1 -1
  9. package/dist/library/Button.js +31 -3
  10. package/dist/library/Button.js.map +1 -1
  11. package/dist/library/Card.d.ts +31 -0
  12. package/dist/library/Card.d.ts.map +1 -0
  13. package/dist/library/Card.js +69 -0
  14. package/dist/library/Card.js.map +1 -0
  15. package/dist/library/Checkbox.d.ts +13 -0
  16. package/dist/library/Checkbox.d.ts.map +1 -0
  17. package/dist/library/Checkbox.js +77 -0
  18. package/dist/library/Checkbox.js.map +1 -0
  19. package/dist/library/Collapsible.d.ts +32 -0
  20. package/dist/library/Collapsible.d.ts.map +1 -0
  21. package/dist/library/Collapsible.js +99 -0
  22. package/dist/library/Collapsible.js.map +1 -0
  23. package/dist/library/Dialog.d.ts +50 -0
  24. package/dist/library/Dialog.d.ts.map +1 -0
  25. package/dist/library/Dialog.js +215 -0
  26. package/dist/library/Dialog.js.map +1 -0
  27. package/dist/library/Field.d.ts +68 -0
  28. package/dist/library/Field.d.ts.map +1 -0
  29. package/dist/library/Field.js +114 -0
  30. package/dist/library/Field.js.map +1 -0
  31. package/dist/library/Input.d.ts +10 -0
  32. package/dist/library/Input.d.ts.map +1 -0
  33. package/dist/library/Input.js +51 -0
  34. package/dist/library/Input.js.map +1 -0
  35. package/dist/library/Link.d.ts +27 -0
  36. package/dist/library/Link.d.ts.map +1 -0
  37. package/dist/library/Link.js +50 -0
  38. package/dist/library/Link.js.map +1 -0
  39. package/dist/library/RadioGroup.d.ts +27 -0
  40. package/dist/library/RadioGroup.d.ts.map +1 -0
  41. package/dist/library/RadioGroup.js +103 -0
  42. package/dist/library/RadioGroup.js.map +1 -0
  43. package/dist/library/ThemeScope.d.ts +10 -0
  44. package/dist/library/ThemeScope.d.ts.map +1 -0
  45. package/dist/library/ThemeScope.js +41 -0
  46. package/dist/library/ThemeScope.js.map +1 -0
  47. package/dist/library/actionStyles.d.ts +11 -0
  48. package/dist/library/actionStyles.d.ts.map +1 -0
  49. package/dist/library/actionStyles.js +75 -0
  50. package/dist/library/actionStyles.js.map +1 -0
  51. package/dist/library/cn.d.ts +1 -2
  52. package/dist/library/cn.d.ts.map +1 -1
  53. package/dist/library/cn.js +1 -8
  54. package/dist/library/cn.js.map +1 -1
  55. package/dist/library/color/colorFamilies.d.ts +3 -0
  56. package/dist/library/color/colorFamilies.d.ts.map +1 -0
  57. package/dist/library/color/colorFamilies.js +20 -0
  58. package/dist/library/color/colorFamilies.js.map +1 -0
  59. package/dist/library/color/generateColorWall.d.ts +54 -0
  60. package/dist/library/color/generateColorWall.d.ts.map +1 -0
  61. package/dist/library/color/generateColorWall.js +231 -0
  62. package/dist/library/color/generateColorWall.js.map +1 -0
  63. package/dist/library/color/index.d.ts +5 -0
  64. package/dist/library/color/index.d.ts.map +1 -0
  65. package/dist/library/color/index.js +3 -0
  66. package/dist/library/color/index.js.map +1 -0
  67. package/dist/library/color/oklch.d.ts +17 -0
  68. package/dist/library/color/oklch.d.ts.map +1 -0
  69. package/dist/library/color/oklch.js +79 -0
  70. package/dist/library/color/oklch.js.map +1 -0
  71. package/dist/library/color/recommendColorPalette.d.ts +65 -0
  72. package/dist/library/color/recommendColorPalette.d.ts.map +1 -0
  73. package/dist/library/color/recommendColorPalette.js +263 -0
  74. package/dist/library/color/recommendColorPalette.js.map +1 -0
  75. package/dist/library/controlStyles.d.ts +5 -0
  76. package/dist/library/controlStyles.d.ts.map +1 -0
  77. package/dist/library/controlStyles.js +15 -0
  78. package/dist/library/controlStyles.js.map +1 -0
  79. package/dist/library/index.d.ts +30 -1
  80. package/dist/library/index.d.ts.map +1 -1
  81. package/dist/library/index.js +14 -0
  82. package/dist/library/index.js.map +1 -1
  83. package/dist/library/internal/events.d.ts +8 -0
  84. package/dist/library/internal/events.d.ts.map +1 -0
  85. package/dist/library/internal/events.js +13 -0
  86. package/dist/library/internal/events.js.map +1 -0
  87. package/dist/library/internal/ids.d.ts +3 -0
  88. package/dist/library/internal/ids.d.ts.map +1 -0
  89. package/dist/library/internal/ids.js +6 -0
  90. package/dist/library/internal/ids.js.map +1 -0
  91. package/dist/library/internal/selection.d.ts +5 -0
  92. package/dist/library/internal/selection.d.ts.map +1 -0
  93. package/dist/library/internal/selection.js +18 -0
  94. package/dist/library/internal/selection.js.map +1 -0
  95. package/dist/library/presentation.d.ts +18 -0
  96. package/dist/library/presentation.d.ts.map +1 -0
  97. package/dist/library/presentation.js +2 -0
  98. package/dist/library/presentation.js.map +1 -0
  99. package/dist/library/react/useComposedRefs.d.ts +4 -0
  100. package/dist/library/react/useComposedRefs.d.ts.map +1 -0
  101. package/dist/library/react/useComposedRefs.js +28 -0
  102. package/dist/library/react/useComposedRefs.js.map +1 -0
  103. package/dist/library/react/useControllableState.d.ts +16 -0
  104. package/dist/library/react/useControllableState.d.ts.map +1 -0
  105. package/dist/library/react/useControllableState.js +29 -0
  106. package/dist/library/react/useControllableState.js.map +1 -0
  107. package/dist/library/react/useNativeOwner.d.ts +17 -0
  108. package/dist/library/react/useNativeOwner.d.ts.map +1 -0
  109. package/dist/library/react/useNativeOwner.js +17 -0
  110. package/dist/library/react/useNativeOwner.js.map +1 -0
  111. package/dist/library/reset.css +1 -0
  112. package/dist/library/styles.css +2 -1
  113. package/dist/library/themes/components.d.ts +217 -0
  114. package/dist/library/themes/components.d.ts.map +1 -0
  115. package/dist/library/themes/components.js +229 -0
  116. package/dist/library/themes/components.js.map +1 -0
  117. package/dist/library/themes/default.d.ts +2 -0
  118. package/dist/library/themes/default.d.ts.map +1 -0
  119. package/dist/library/themes/default.js +4 -0
  120. package/dist/library/themes/default.js.map +1 -0
  121. package/dist/library/themes/defineTheme.d.ts +33 -0
  122. package/dist/library/themes/defineTheme.d.ts.map +1 -0
  123. package/dist/library/themes/defineTheme.js +98 -0
  124. package/dist/library/themes/defineTheme.js.map +1 -0
  125. package/dist/library/themes/expressive.d.ts +2 -0
  126. package/dist/library/themes/expressive.d.ts.map +1 -0
  127. package/dist/library/themes/expressive.js +132 -0
  128. package/dist/library/themes/expressive.js.map +1 -0
  129. package/dist/library/themes/glass.d.ts +2 -0
  130. package/dist/library/themes/glass.d.ts.map +1 -0
  131. package/dist/library/themes/glass.js +132 -0
  132. package/dist/library/themes/glass.js.map +1 -0
  133. package/dist/library/themes/index.d.ts +18 -0
  134. package/dist/library/themes/index.d.ts.map +1 -0
  135. package/dist/library/themes/index.js +23 -0
  136. package/dist/library/themes/index.js.map +1 -0
  137. package/dist/library/themes/jelly.d.ts +2 -0
  138. package/dist/library/themes/jelly.d.ts.map +1 -0
  139. package/dist/library/themes/jelly.js +130 -0
  140. package/dist/library/themes/jelly.js.map +1 -0
  141. package/dist/library/themes/preset-values.d.ts +4 -0
  142. package/dist/library/themes/preset-values.d.ts.map +1 -0
  143. package/dist/library/themes/preset-values.js +5 -0
  144. package/dist/library/themes/preset-values.js.map +1 -0
  145. package/dist/library/themes/radiant.d.ts +2 -0
  146. package/dist/library/themes/radiant.d.ts.map +1 -0
  147. package/dist/library/themes/radiant.js +129 -0
  148. package/dist/library/themes/radiant.js.map +1 -0
  149. package/dist/library/themes/sharp-3d.d.ts +2 -0
  150. package/dist/library/themes/sharp-3d.d.ts.map +1 -0
  151. package/dist/library/themes/sharp-3d.js +142 -0
  152. package/dist/library/themes/sharp-3d.js.map +1 -0
  153. package/dist/library/themes/soft-squircle.d.ts +2 -0
  154. package/dist/library/themes/soft-squircle.d.ts.map +1 -0
  155. package/dist/library/themes/soft-squircle.js +131 -0
  156. package/dist/library/themes/soft-squircle.js.map +1 -0
  157. package/dist/library/themes/themeDocument.d.ts +16 -0
  158. package/dist/library/themes/themeDocument.d.ts.map +1 -0
  159. package/dist/library/themes/themeDocument.js +307 -0
  160. package/dist/library/themes/themeDocument.js.map +1 -0
  161. package/dist/library/themes/themeDocumentTypes.d.ts +69 -0
  162. package/dist/library/themes/themeDocumentTypes.d.ts.map +1 -0
  163. package/dist/library/themes/themeDocumentTypes.js +2 -0
  164. package/dist/library/themes/themeDocumentTypes.js.map +1 -0
  165. package/dist/library/themes/ticket.d.ts +2 -0
  166. package/dist/library/themes/ticket.d.ts.map +1 -0
  167. package/dist/library/themes/ticket.js +141 -0
  168. package/dist/library/themes/ticket.js.map +1 -0
  169. package/dist/library/themes/tokens.d.ts +100 -0
  170. package/dist/library/themes/tokens.d.ts.map +1 -0
  171. package/dist/library/themes/tokens.js +171 -0
  172. package/dist/library/themes/tokens.js.map +1 -0
  173. package/dist/library/themes/types.d.ts +2 -0
  174. package/dist/library/themes/types.d.ts.map +1 -0
  175. package/dist/library/themes/types.js +2 -0
  176. package/dist/library/themes/types.js.map +1 -0
  177. package/dist/library/themes/updateThemeAppearance.d.ts +29 -0
  178. package/dist/library/themes/updateThemeAppearance.d.ts.map +1 -0
  179. package/dist/library/themes/updateThemeAppearance.js +138 -0
  180. package/dist/library/themes/updateThemeAppearance.js.map +1 -0
  181. package/docs/accessibility.md +189 -0
  182. package/docs/system.md +231 -0
  183. package/docs/theming.md +804 -0
  184. package/package.json +34 -10
  185. package/src/Accordion.tsx +235 -0
  186. package/src/Button.tsx +95 -15
  187. package/src/Card.tsx +143 -0
  188. package/src/Checkbox.tsx +189 -0
  189. package/src/Collapsible.tsx +193 -0
  190. package/src/Dialog.tsx +333 -0
  191. package/src/Field.tsx +293 -0
  192. package/src/Input.tsx +82 -0
  193. package/src/Link.tsx +95 -0
  194. package/src/RadioGroup.tsx +255 -0
  195. package/src/ThemeScope.tsx +64 -0
  196. package/src/actionStyles.ts +90 -0
  197. package/src/cn.ts +1 -10
  198. package/src/color/colorFamilies.ts +19 -0
  199. package/src/color/generateColorWall.ts +358 -0
  200. package/src/color/index.ts +11 -0
  201. package/src/color/oklch.ts +95 -0
  202. package/src/color/recommendColorPalette.ts +375 -0
  203. package/src/controlStyles.ts +19 -0
  204. package/src/index.ts +130 -1
  205. package/src/internal/events.ts +17 -0
  206. package/src/internal/ids.ts +5 -0
  207. package/src/internal/selection.ts +20 -0
  208. package/src/presentation.ts +12 -0
  209. package/src/react/useComposedRefs.ts +32 -0
  210. package/src/react/useControllableState.ts +50 -0
  211. package/src/react/useNativeOwner.ts +33 -0
  212. package/src/styles.css +2 -14
  213. package/src/themes/baseline.css +116 -0
  214. package/src/themes/components.ts +249 -0
  215. package/src/themes/default.ts +4 -0
  216. package/src/themes/defineTheme.ts +145 -0
  217. package/src/themes/expressive.ts +132 -0
  218. package/src/themes/glass.ts +135 -0
  219. package/src/themes/index.ts +57 -0
  220. package/src/themes/jelly.ts +130 -0
  221. package/src/themes/preset-values.ts +5 -0
  222. package/src/themes/radiant.ts +129 -0
  223. package/src/themes/sharp-3d.ts +142 -0
  224. package/src/themes/soft-squircle.ts +131 -0
  225. package/src/themes/themeDocument.ts +340 -0
  226. package/src/themes/themeDocumentTypes.ts +76 -0
  227. package/src/themes/ticket.ts +141 -0
  228. package/src/themes/tokens.ts +262 -0
  229. package/src/themes/types.ts +10 -0
  230. package/src/themes/updateThemeAppearance.ts +172 -0
package/src/Dialog.tsx ADDED
@@ -0,0 +1,333 @@
1
+ 'use client'
2
+
3
+ import type { ComponentProps, MouseEvent, ReactNode } from 'react'
4
+ import { createContext, useContext, useEffect, useId, useRef, useState } from 'react'
5
+ import { cva } from 'class-variance-authority'
6
+ import { Button, type ButtonProps, type ButtonRenderProps } from './Button.js'
7
+ import { cn } from './cn.js'
8
+ import { composeAction } from './internal/events.js'
9
+ import { joinIds } from './internal/ids.js'
10
+ import { useComposedRefs } from './react/useComposedRefs.js'
11
+ import { useControllableState } from './react/useControllableState.js'
12
+ import type { ThemeStyle } from './themes/defineTheme.js'
13
+
14
+ const colorMotionClass =
15
+ 'transition-colors duration-[var(--rad-motion-color-duration,150ms)] motion-reduce:transition-none'
16
+
17
+ const dialogVariants = cva([
18
+ colorMotionClass,
19
+ '[font-family:var(--rad-typography-family,system-ui,sans-serif)] [letter-spacing:var(--rad-typography-letter-spacing,-0.011em)] [font-size:var(--rad-typography-body-size,0.875rem)] [font-weight:var(--rad-typography-body-weight,400)]',
20
+ 'box-border text-start antialiased',
21
+ '[&:not([open])]:hidden',
22
+ 'open:m-auto open:grid open:overflow-auto open:overscroll-contain',
23
+ 'open:max-h-[min(40rem,calc(100dvh-2rem))]',
24
+ 'open:w-[min(calc(100%-2rem),var(--rad-dialog-width,32rem))]',
25
+ 'open:gap-[var(--rad-dialog-gap,var(--rad-surface-gap,1rem))]',
26
+ 'open:p-[var(--rad-dialog-padding,var(--rad-surface-padding,1.5rem))]',
27
+ 'rounded-[var(--rad-dialog-radius,var(--rad-surface-radius,0.75rem))]',
28
+ '[corner-shape:var(--rad-dialog-corner-shape,var(--rad-surface-corner-shape,round))]',
29
+ '[border-width:var(--rad-dialog-border-width,var(--rad-surface-border-width,1px))]',
30
+ '[border-style:var(--rad-dialog-border-style,var(--rad-surface-border-style,solid))]',
31
+ '[border-color:var(--rad-dialog-border-color,var(--rad-color-border,oklch(0.885_0.005_286)))]',
32
+ 'bg-[var(--rad-dialog-background,var(--rad-color-surface,oklch(1_0_0)))]',
33
+ '[backdrop-filter:var(--rad-dialog-backdrop-filter,none)]',
34
+ '[color:var(--rad-dialog-color,var(--rad-color-foreground,oklch(0.21_0.006_286)))]',
35
+ '[box-shadow:var(--rad-dialog-shadow,var(--rad-surface-overlay-shadow,0_24px_64px_-16px_rgb(0_0_0/0.3)))]',
36
+ 'backdrop:[background:var(--rad-dialog-backdrop,var(--rad-surface-backdrop,rgb(0_0_0/0.45)))]',
37
+ 'focus-visible:outline-solid',
38
+ 'focus-visible:[outline-color:var(--rad-dialog-focus-color,var(--rad-color-focus,oklch(0.55_0.13_255)))]',
39
+ 'focus-visible:[outline-width:var(--rad-dialog-focus-width,var(--rad-focus-width,2px))]',
40
+ 'focus-visible:[outline-offset:var(--rad-dialog-focus-offset,var(--rad-focus-offset,2px))]',
41
+ 'focus-visible:[outline-style:var(--rad-dialog-focus-style,var(--rad-focus-style,solid))]',
42
+ 'forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]',
43
+ 'forced-colors:backdrop:[background:CanvasText]'
44
+ ])
45
+
46
+ const dialogTitleVariants = cva([
47
+ colorMotionClass,
48
+ 'm-0 min-w-0 break-words leading-snug',
49
+ '[font-size:var(--rad-dialog-title-size,var(--rad-typography-heading-size,1.125rem))]',
50
+ '[font-weight:var(--rad-dialog-title-weight,var(--rad-typography-heading-weight,600))]',
51
+ 'forced-colors:text-[CanvasText]'
52
+ ])
53
+
54
+ const dialogDescriptionVariants = cva([
55
+ colorMotionClass,
56
+ 'm-0 min-w-0 break-words leading-snug',
57
+ '[color:var(--rad-dialog-description-color,var(--rad-color-muted-foreground,oklch(0.45_0.01_286)))]',
58
+ '[font-size:var(--rad-dialog-description-size,var(--rad-typography-small-size,0.8125rem))]',
59
+ 'forced-colors:text-[CanvasText]'
60
+ ])
61
+
62
+ export type DialogProps = (
63
+ | { open: boolean; defaultOpen?: never }
64
+ | { open?: undefined; defaultOpen?: boolean }
65
+ ) & {
66
+ onOpenChange?: (open: boolean) => void
67
+ /** `true` calls `showModal()`. `false` calls `show()` and leaves the rest of the page active. */
68
+ modal?: boolean
69
+ /** Modal only. A backdrop click is a click on the dialog whose point lies outside its border box. */
70
+ closeOnBackdrop?: boolean
71
+ /** Modal only. The browser closes a modal dialog on Escape unless the cancel event is cancelled. */
72
+ closeOnEscape?: boolean
73
+ children?: ReactNode
74
+ }
75
+
76
+ export type DialogState = {
77
+ open: boolean
78
+ setOpen: (open: boolean) => void
79
+ contentId: string
80
+ titleId: string
81
+ descriptionId: string
82
+ modal: boolean
83
+ closeOnBackdrop: boolean
84
+ closeOnEscape: boolean
85
+ controlled: boolean
86
+ }
87
+
88
+ export type DialogRenderProps = ButtonRenderProps
89
+
90
+ export type DialogTriggerProps = ButtonProps
91
+
92
+ export type DialogContentProps = Omit<ComponentProps<'dialog'>, 'open' | 'style'> & {
93
+ style?: ThemeStyle
94
+ }
95
+
96
+ export type DialogTitleProps = Omit<ComponentProps<'h2'>, 'style'> & { style?: ThemeStyle }
97
+
98
+ export type DialogDescriptionProps = Omit<ComponentProps<'p'>, 'style'> & { style?: ThemeStyle }
99
+
100
+ export type DialogCloseProps = DialogTriggerProps
101
+
102
+ const DialogContext = createContext<DialogState | null>(null)
103
+
104
+ export function useDialog(): DialogState | null {
105
+ return useContext(DialogContext)
106
+ }
107
+
108
+ function useDialogContext() {
109
+ const dialog = useDialog()
110
+ if (!dialog) throw new Error('Dialog parts must render inside Dialog.')
111
+ return dialog
112
+ }
113
+
114
+ export function Dialog({
115
+ open,
116
+ defaultOpen,
117
+ onOpenChange,
118
+ modal = true,
119
+ closeOnBackdrop = true,
120
+ closeOnEscape = true,
121
+ children
122
+ }: DialogProps) {
123
+ const contentId = useId()
124
+ const titleId = useId()
125
+ const descriptionId = useId()
126
+ const {
127
+ value: isOpen,
128
+ request: setOpen,
129
+ controlled
130
+ } = useControllableState({
131
+ name: 'Dialog',
132
+ value: open,
133
+ defaultValue: defaultOpen,
134
+ initialValue: false,
135
+ onChange: onOpenChange
136
+ })
137
+
138
+ return (
139
+ <DialogContext.Provider
140
+ value={{
141
+ open: isOpen,
142
+ setOpen,
143
+ contentId,
144
+ titleId,
145
+ descriptionId,
146
+ modal,
147
+ closeOnBackdrop,
148
+ closeOnEscape,
149
+ controlled
150
+ }}
151
+ >
152
+ {children}
153
+ </DialogContext.Provider>
154
+ )
155
+ }
156
+
157
+ function DialogAction({ action, ...props }: DialogTriggerProps & { action: 'open' | 'close' }) {
158
+ const dialog = useDialogContext()
159
+ const slot = action === 'open' ? 'button dialog-trigger' : 'button dialog-close'
160
+ const buttonProps: ButtonProps = {
161
+ ...props,
162
+ ...(action === 'open'
163
+ ? {
164
+ 'aria-haspopup': 'dialog',
165
+ 'aria-expanded': dialog.open,
166
+ 'aria-controls': dialog.contentId
167
+ }
168
+ : {}),
169
+ 'data-slot': slot,
170
+ onClick: composeAction(props.onClick, () => dialog.setOpen(action === 'open'))
171
+ }
172
+ return <Button {...buttonProps} />
173
+ }
174
+
175
+ export function DialogTrigger(props: DialogTriggerProps) {
176
+ return (
177
+ <DialogAction
178
+ {...props}
179
+ action="open"
180
+ />
181
+ )
182
+ }
183
+
184
+ export function DialogContent({
185
+ className,
186
+ onClick,
187
+ onCancel,
188
+ onClose,
189
+ ref,
190
+ ...props
191
+ }: DialogContentProps) {
192
+ const dialog = useDialogContext()
193
+ const nodeRef = useRef<HTMLDialogElement>(null)
194
+ const hostRef = useComposedRefs(nodeRef, ref)
195
+ const unmounting = useRef(false)
196
+ const previousModal = useRef(dialog.modal)
197
+ // Bumps after the browser closes a dialog whose controlled `open` value is still true.
198
+ const [generation, setGeneration] = useState(0)
199
+
200
+ useEffect(() => {
201
+ unmounting.current = false
202
+ const node = nodeRef.current
203
+ return () => {
204
+ unmounting.current = true
205
+ if (node) closeDialog(node)
206
+ }
207
+ }, [])
208
+
209
+ useEffect(() => {
210
+ const node = nodeRef.current
211
+ if (!node || generation < 0) return
212
+ if (previousModal.current !== dialog.modal) {
213
+ // The platform cannot change an already-open dialog's modal mode in place.
214
+ closeDialog(node)
215
+ previousModal.current = dialog.modal
216
+ }
217
+ if (dialog.open) {
218
+ if (!dialogIsOpen(node)) openDialog(node, dialog.modal)
219
+ return
220
+ }
221
+ if (dialogIsOpen(node)) closeDialog(node)
222
+ }, [dialog.modal, dialog.open, generation])
223
+
224
+ return (
225
+ // Backdrop clicks are pointer hit tests on the dialog element. Escape uses the cancel event.
226
+ // oxlint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-noninteractive-element-interactions
227
+ <dialog
228
+ {...props}
229
+ open={undefined}
230
+ ref={hostRef}
231
+ aria-describedby={joinIds(dialog.descriptionId, props['aria-describedby'])}
232
+ aria-labelledby={props['aria-label'] ? props['aria-labelledby'] : dialog.titleId}
233
+ className={cn(dialogVariants(), className)}
234
+ data-slot="dialog"
235
+ data-state={dialog.open ? 'open' : 'closed'}
236
+ id={dialog.contentId}
237
+ onCancel={event => {
238
+ // cancel and close bubble, so a nested dialog must not dismiss its parent.
239
+ if (event.target !== event.currentTarget) return
240
+ onCancel?.(event)
241
+ if (!dialog.closeOnEscape) event.preventDefault()
242
+ }}
243
+ onClick={composeAction(onClick, event => {
244
+ if (!dialog.modal || !dialog.closeOnBackdrop) return
245
+ if (!isBackdropClick(event)) return
246
+ dialog.setOpen(false)
247
+ })}
248
+ onClose={event => {
249
+ if (event.target !== event.currentTarget) return
250
+ onClose?.(event)
251
+ // close() queues its event. StrictMode cleanup or a consumer can reopen
252
+ // this same native dialog before that event arrives.
253
+ if (unmounting.current || !dialog.open || dialogIsOpen(event.currentTarget)) return
254
+ dialog.setOpen(false)
255
+ if (dialog.controlled) setGeneration(current => current + 1)
256
+ }}
257
+ />
258
+ )
259
+ }
260
+
261
+ export function DialogTitle({ className, children, ...props }: DialogTitleProps) {
262
+ const dialog = useDialogContext()
263
+ return (
264
+ <h2
265
+ {...props}
266
+ className={cn(dialogTitleVariants(), className)}
267
+ data-slot="dialog-title"
268
+ id={dialog.titleId}
269
+ >
270
+ {children}
271
+ </h2>
272
+ )
273
+ }
274
+
275
+ export function DialogDescription({ className, ...props }: DialogDescriptionProps) {
276
+ const dialog = useDialogContext()
277
+ return (
278
+ <p
279
+ {...props}
280
+ className={cn(dialogDescriptionVariants(), className)}
281
+ data-slot="dialog-description"
282
+ id={dialog.descriptionId}
283
+ />
284
+ )
285
+ }
286
+
287
+ export function DialogClose(props: DialogCloseProps) {
288
+ return (
289
+ <DialogAction
290
+ {...props}
291
+ action="close"
292
+ />
293
+ )
294
+ }
295
+
296
+ function dialogIsOpen(node: HTMLDialogElement) {
297
+ return node.hasAttribute('open')
298
+ }
299
+
300
+ function openDialog(node: HTMLDialogElement, modal: boolean) {
301
+ if (dialogIsOpen(node)) return
302
+ if (modal && typeof node.showModal === 'function') {
303
+ node.showModal()
304
+ return
305
+ }
306
+ if (!modal && typeof node.show === 'function') {
307
+ node.show()
308
+ return
309
+ }
310
+ // jsdom does not implement the dialog methods. The attribute still marks it open.
311
+ node.setAttribute('open', '')
312
+ }
313
+
314
+ function closeDialog(node: HTMLDialogElement) {
315
+ if (!dialogIsOpen(node)) return
316
+ if (typeof node.close === 'function') {
317
+ node.close()
318
+ return
319
+ }
320
+ node.removeAttribute('open')
321
+ }
322
+
323
+ function isBackdropClick(event: MouseEvent<HTMLDialogElement>) {
324
+ if (event.target !== event.currentTarget) return false
325
+ const box = event.currentTarget.getBoundingClientRect()
326
+ if (box.width === 0 && box.height === 0) return false
327
+ return (
328
+ event.clientX < box.left ||
329
+ event.clientX > box.right ||
330
+ event.clientY < box.top ||
331
+ event.clientY > box.bottom
332
+ )
333
+ }
package/src/Field.tsx ADDED
@@ -0,0 +1,293 @@
1
+ 'use client'
2
+
3
+ import { createContext, useContext, useId } from 'react'
4
+ import type { ComponentProps, ReactNode } from 'react'
5
+ import { cva } from 'class-variance-authority'
6
+ import { cn } from './cn.js'
7
+ import { joinIds } from './internal/ids.js'
8
+ import type { ThemeStyle } from './themes/defineTheme.js'
9
+ import type { PartStyle } from './presentation.js'
10
+
11
+ const fieldVariants = cva(
12
+ [
13
+ '[font-family:var(--rad-typography-family,system-ui,sans-serif)] [letter-spacing:var(--rad-typography-letter-spacing,-0.011em)] [font-size:var(--rad-typography-body-size,0.875rem)] [font-weight:var(--rad-typography-body-weight,400)]',
14
+ 'grid min-w-0 [gap:var(--rad-field-gap,var(--rad-spacing-field-gap,0.375rem))]',
15
+ // Dim controls/labels once; help and error text must stay readable.
16
+ 'in-[[data-slot~=field][data-disabled]]:[--_rad-disabled-opacity:1]',
17
+ '[&[data-disabled]>:not([data-slot=field-description],[data-slot=field-error])]:opacity-[var(--_rad-disabled-opacity,var(--rad-field-disabled-opacity,var(--rad-state-disabled-opacity,0.5)))]',
18
+ 'forced-colors:[&[data-disabled]>:not([data-slot=field-description],[data-slot=field-error])]:opacity-100',
19
+ 'forced-colors:data-[disabled]:text-[GrayText] forced-colors:data-[disabled]:opacity-100'
20
+ ],
21
+ {
22
+ variants: {
23
+ layout: {
24
+ control: '',
25
+ group: 'm-0 border-0 p-0'
26
+ }
27
+ },
28
+ defaultVariants: { layout: 'control' }
29
+ }
30
+ )
31
+
32
+ const labelClass =
33
+ 'min-w-0 break-words p-0 [color:var(--rad-field-label-color,var(--rad-color-foreground,oklch(0.21_0.006_286)))] [font-size:var(--rad-field-label-size,var(--rad-typography-body-size,0.875rem))] [font-weight:var(--rad-field-label-weight,var(--rad-typography-label-weight,550))] leading-snug forced-colors:text-[CanvasText]'
34
+
35
+ const descriptionClass =
36
+ 'min-w-0 break-words [color:var(--rad-field-description-color,var(--rad-color-muted-foreground,oklch(0.45_0.01_286)))] [font-size:var(--rad-field-description-size,var(--rad-typography-small-size,0.8125rem))] leading-snug forced-colors:text-[CanvasText]'
37
+
38
+ const errorClass =
39
+ 'min-w-0 break-words [color:var(--rad-field-error-color,var(--rad-color-invalid,oklch(0.56_0.19_25)))] [font-size:var(--rad-field-error-size,var(--rad-typography-small-size,0.8125rem))] leading-snug forced-colors:text-[CanvasText]'
40
+
41
+ const requiredClass =
42
+ 'ms-[0.25em] [color:var(--rad-field-required-color,var(--rad-color-invalid,oklch(0.56_0.19_25)))] forced-colors:text-[CanvasText]'
43
+
44
+ export type FieldLayout = 'control' | 'group'
45
+
46
+ export type FieldControlProps = {
47
+ id: string
48
+ required?: boolean
49
+ disabled?: boolean
50
+ 'aria-invalid'?: boolean
51
+ 'aria-required'?: boolean
52
+ 'aria-describedby'?: string
53
+ }
54
+
55
+ export type FieldState = {
56
+ layout: FieldLayout
57
+ controlId: string
58
+ labelId: string
59
+ descriptionId?: string
60
+ errorId?: string
61
+ invalid: boolean
62
+ required: boolean
63
+ disabled: boolean
64
+ describedBy?: string
65
+ controlProps: FieldControlProps | null
66
+ }
67
+
68
+ type FieldOwn = {
69
+ /** Additional identities; Field always retains its base identity. */
70
+ 'data-slot'?: string
71
+ label: ReactNode
72
+ description?: ReactNode
73
+ error?: ReactNode
74
+ required?: boolean
75
+ disabled?: boolean
76
+ requiredIndicator?: ReactNode
77
+ style?: ThemeStyle
78
+ parts?: {
79
+ label?: PartStyle
80
+ description?: PartStyle
81
+ error?: PartStyle
82
+ required?: PartStyle
83
+ }
84
+ }
85
+
86
+ type FieldControl = FieldOwn &
87
+ Omit<ComponentProps<'div'>, 'children' | 'style'> & {
88
+ layout?: 'control'
89
+ form?: never
90
+ name?: never
91
+ controlId?: string
92
+ children?: ReactNode | ((control: FieldControlProps) => ReactNode)
93
+ }
94
+
95
+ type FieldGroup = FieldOwn &
96
+ Omit<ComponentProps<'fieldset'>, 'children' | 'style'> & {
97
+ layout: 'group'
98
+ controlId?: never
99
+ children?: ReactNode
100
+ }
101
+
102
+ export type FieldProps = FieldControl | FieldGroup
103
+
104
+ const FieldContext = createContext<FieldState | null>(null)
105
+
106
+ export function useField(): FieldState | null {
107
+ return useContext(FieldContext)
108
+ }
109
+
110
+ /** Private native-control adapter; Field keeps its owned relationships. */
111
+ export function useFieldControl({
112
+ id,
113
+ disabled,
114
+ required,
115
+ 'aria-invalid': ariaInvalid,
116
+ 'aria-required': ariaRequired,
117
+ 'aria-describedby': ariaDescribedBy
118
+ }: Pick<
119
+ ComponentProps<'input'>,
120
+ 'id' | 'disabled' | 'required' | 'aria-invalid' | 'aria-required' | 'aria-describedby'
121
+ >) {
122
+ const field = useField()
123
+ const control = field?.controlProps
124
+ const isRequired = control?.required || required
125
+ const invalid = control?.['aria-invalid'] || ariaInvalid
126
+ return {
127
+ id: control?.id ?? id,
128
+ disabled: field?.disabled || disabled,
129
+ required: isRequired,
130
+ 'aria-invalid': invalid,
131
+ 'data-invalid': invalid && invalid !== 'false' ? '' : undefined,
132
+ 'aria-required': isRequired ? true : ariaRequired,
133
+ 'aria-describedby': joinIds(control?.['aria-describedby'], ariaDescribedBy)
134
+ }
135
+ }
136
+
137
+ function hasContent(value: ReactNode) {
138
+ return value != null && value !== false && value !== ''
139
+ }
140
+
141
+ function definedProps(props: FieldControlProps): FieldControlProps {
142
+ return Object.fromEntries(
143
+ Object.entries(props).filter(([, value]) => value !== undefined)
144
+ ) as FieldControlProps
145
+ }
146
+
147
+ export function Field(props: FieldProps) {
148
+ const {
149
+ label,
150
+ description,
151
+ error,
152
+ required = false,
153
+ disabled: disabledProp = false,
154
+ requiredIndicator = '*',
155
+ children,
156
+ className,
157
+ parts,
158
+ 'aria-describedby': ariaDescribedBy,
159
+ 'aria-invalid': ariaInvalid,
160
+ 'data-slot': dataSlot,
161
+ ...rest
162
+ } = props
163
+ const parent = useField()
164
+ const disabled = parent?.disabled || disabledProp
165
+ const layout = rest.layout ?? 'control'
166
+ const generatedId = useId()
167
+ const controlId = rest.controlId ?? generatedId
168
+ const labelId = `${generatedId}-label`
169
+ const invalid = hasContent(error)
170
+ const descriptionId = hasContent(description) ? `${generatedId}-description` : undefined
171
+ const errorId = invalid ? `${generatedId}-error` : undefined
172
+ const describedBy = joinIds(descriptionId, errorId)
173
+ const controlProps = definedProps({
174
+ id: controlId,
175
+ required: required || undefined,
176
+ disabled: disabled || undefined,
177
+ 'aria-invalid': invalid || undefined,
178
+ 'aria-required': required || undefined,
179
+ 'aria-describedby': describedBy
180
+ })
181
+ const state: FieldState = {
182
+ layout,
183
+ controlId,
184
+ labelId,
185
+ descriptionId,
186
+ errorId,
187
+ invalid,
188
+ required,
189
+ disabled,
190
+ describedBy,
191
+ controlProps: layout === 'control' ? controlProps : null
192
+ }
193
+ const control: ReactNode =
194
+ typeof children === 'function'
195
+ ? layout === 'control'
196
+ ? children(controlProps)
197
+ : null
198
+ : children
199
+ const indicator = required && hasContent(requiredIndicator) && (
200
+ <span
201
+ aria-hidden="true"
202
+ className={cn(requiredClass, parts?.required?.className)}
203
+ style={parts?.required?.style}
204
+ data-slot="field-required"
205
+ >
206
+ {requiredIndicator}
207
+ </span>
208
+ )
209
+ const rootProps = {
210
+ 'aria-describedby':
211
+ layout === 'group' ? joinIds(describedBy, ariaDescribedBy) : ariaDescribedBy,
212
+ 'aria-invalid': layout === 'group' && invalid ? true : ariaInvalid,
213
+ className: cn(fieldVariants({ layout }), className),
214
+ 'data-disabled': disabled ? '' : undefined,
215
+ 'data-invalid': invalid ? '' : undefined,
216
+ 'data-layout': layout,
217
+ 'data-required': required ? '' : undefined,
218
+ 'data-slot': joinIds('field', dataSlot)
219
+ }
220
+ const body = (
221
+ <>
222
+ {layout === 'group' ? (
223
+ <legend
224
+ className={cn(labelClass, parts?.label?.className)}
225
+ style={parts?.label?.style}
226
+ data-slot="field-label"
227
+ id={labelId}
228
+ >
229
+ {label}
230
+ {indicator}
231
+ </legend>
232
+ ) : (
233
+ <label
234
+ className={cn(labelClass, parts?.label?.className)}
235
+ style={parts?.label?.style}
236
+ data-slot="field-label"
237
+ htmlFor={controlId}
238
+ id={labelId}
239
+ >
240
+ {label}
241
+ {indicator}
242
+ </label>
243
+ )}
244
+ {control}
245
+ {descriptionId ? (
246
+ <div
247
+ className={cn(descriptionClass, parts?.description?.className)}
248
+ style={parts?.description?.style}
249
+ data-slot="field-description"
250
+ id={descriptionId}
251
+ >
252
+ {description}
253
+ </div>
254
+ ) : null}
255
+ {errorId ? (
256
+ <div
257
+ className={cn(errorClass, parts?.error?.className)}
258
+ style={parts?.error?.style}
259
+ data-slot="field-error"
260
+ id={errorId}
261
+ role="alert"
262
+ >
263
+ {error}
264
+ </div>
265
+ ) : null}
266
+ </>
267
+ )
268
+
269
+ let root: ReactNode
270
+ if (rest.layout === 'group') {
271
+ const { layout: _layout, controlId: _controlId, ...nativeProps } = rest
272
+ root = (
273
+ <fieldset
274
+ {...nativeProps}
275
+ {...rootProps}
276
+ disabled={disabled || undefined}
277
+ >
278
+ {body}
279
+ </fieldset>
280
+ )
281
+ } else {
282
+ const { layout: _layout, controlId: _controlId, ...nativeProps } = rest
283
+ root = (
284
+ <div
285
+ {...nativeProps}
286
+ {...rootProps}
287
+ >
288
+ {body}
289
+ </div>
290
+ )
291
+ }
292
+ return <FieldContext.Provider value={state}>{root}</FieldContext.Provider>
293
+ }
package/src/Input.tsx ADDED
@@ -0,0 +1,82 @@
1
+ 'use client'
2
+
3
+ import type { ComponentProps } from 'react'
4
+ import { cva } from 'class-variance-authority'
5
+ import { cn } from './cn.js'
6
+ import { controlBorderClass, controlMetrics } from './controlStyles.js'
7
+ import { useNativeOwner, type ValueOwner } from './react/useNativeOwner.js'
8
+ import type { ThemeStyle } from './themes/defineTheme.js'
9
+ import type { ControlSize } from './presentation.js'
10
+ import { useFieldControl } from './Field.js'
11
+
12
+ const inputVariants = cva([
13
+ controlBorderClass,
14
+ 'box-border w-full min-w-0',
15
+ 'h-[var(--rad-input-height,var(--_rad-control-height))]',
16
+ 'px-[var(--rad-input-padding,var(--_rad-control-padding))]',
17
+ '[font-family:var(--rad-input-font-family,var(--rad-typography-family,system-ui,sans-serif))] [letter-spacing:var(--rad-typography-letter-spacing,-0.011em)]',
18
+ '[font-size:var(--rad-input-font-size,var(--_rad-control-font-size))]',
19
+ '[font-weight:var(--rad-input-font-weight,var(--rad-typography-body-weight,400))]',
20
+ '[color:var(--rad-input-color,var(--rad-color-foreground,oklch(0.21_0.006_286)))]',
21
+ 'bg-[var(--rad-input-background,var(--rad-color-surface,oklch(1_0_0)))]',
22
+ '[border-width:var(--rad-input-border-width,var(--rad-control-border-width,1px))]',
23
+ '[border-style:var(--rad-input-border-style,var(--rad-control-border-style,solid))]',
24
+ '[border-color:var(--rad-input-border-color,var(--_rad-control-border))]',
25
+ 'rounded-[var(--rad-input-radius,var(--rad-control-radius,0.5rem))]',
26
+ '[corner-shape:var(--rad-input-corner-shape,var(--rad-control-corner-shape,round))]',
27
+ '[box-shadow:var(--rad-input-shadow,none)]',
28
+ 'placeholder:[color:var(--rad-input-placeholder,var(--rad-color-placeholder,oklch(0.5_0.01_286)))]',
29
+ 'focus-visible:outline-solid',
30
+ 'focus-visible:[outline-color:var(--rad-input-focus-color,var(--rad-color-focus,oklch(0.55_0.13_255)))]',
31
+ 'focus-visible:[outline-width:var(--rad-input-focus-width,var(--rad-focus-width,2px))]',
32
+ 'focus-visible:[outline-offset:var(--rad-input-focus-offset,var(--rad-focus-offset,2px))]',
33
+ 'focus-visible:[outline-style:var(--rad-input-focus-style,var(--rad-focus-style,solid))]',
34
+ 'data-invalid:[border-color:var(--rad-input-invalid-border,var(--rad-color-invalid,oklch(0.56_0.19_25)))]',
35
+ 'disabled:cursor-not-allowed',
36
+ 'disabled:[background:var(--rad-input-disabled-background,var(--rad-color-disabled-background,oklch(0.96_0.005_286)))]',
37
+ 'forced-colors:border-[CanvasText] forced-colors:text-[CanvasText]',
38
+ 'forced-colors:disabled:bg-[Canvas] forced-colors:disabled:text-[GrayText]'
39
+ ])
40
+
41
+ export type InputProps = Omit<ComponentProps<'input'>, 'value' | 'defaultValue' | 'style'> &
42
+ ValueOwner<Exclude<ComponentProps<'input'>['value'], undefined>> & {
43
+ controlSize?: ControlSize
44
+ style?: ThemeStyle
45
+ }
46
+
47
+ export function Input({
48
+ className,
49
+ controlSize = 'medium',
50
+ type = 'text',
51
+ id,
52
+ disabled,
53
+ required,
54
+ 'aria-describedby': ariaDescribedBy,
55
+ 'aria-invalid': ariaInvalid,
56
+ 'aria-required': ariaRequired,
57
+ ...props
58
+ }: InputProps) {
59
+ const ownsValue = !['checkbox', 'radio', 'file'].includes(type)
60
+ useNativeOwner('Input', props.value, props.defaultValue, ownsValue)
61
+ if (ownsValue && props.value === null)
62
+ throw new TypeError('Input value cannot be null. Use an empty string.')
63
+ const control = useFieldControl({
64
+ id,
65
+ disabled,
66
+ required,
67
+ 'aria-invalid': ariaInvalid,
68
+ 'aria-required': ariaRequired,
69
+ 'aria-describedby': ariaDescribedBy
70
+ })
71
+
72
+ return (
73
+ <input
74
+ {...props}
75
+ {...control}
76
+ className={cn(inputVariants(), controlMetrics({ controlSize }), className)}
77
+ data-control-size={controlSize}
78
+ data-slot="input"
79
+ type={type}
80
+ />
81
+ )
82
+ }