@lucian-seo/lucian-ui 0.1.1

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 (401) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +227 -0
  3. package/dist/lib/Input-Bv7L1_wj.js +90 -0
  4. package/dist/lib/Input-Bv7L1_wj.js.map +1 -0
  5. package/dist/lib/Menu-B3G64GV4.js +321 -0
  6. package/dist/lib/Menu-B3G64GV4.js.map +1 -0
  7. package/dist/lib/Switch-BkMnC02l.js +999 -0
  8. package/dist/lib/Switch-BkMnC02l.js.map +1 -0
  9. package/dist/lib/Tag-Z8PjnJFt.js +60 -0
  10. package/dist/lib/Tag-Z8PjnJFt.js.map +1 -0
  11. package/dist/lib/TagInput-BaGz-QKU.js +372 -0
  12. package/dist/lib/TagInput-BaGz-QKU.js.map +1 -0
  13. package/dist/lib/Text-D7hoYpuZ.js +26 -0
  14. package/dist/lib/Text-D7hoYpuZ.js.map +1 -0
  15. package/dist/lib/ToggleButton-D6oEjMeF.js +238 -0
  16. package/dist/lib/ToggleButton-D6oEjMeF.js.map +1 -0
  17. package/dist/lib/Toolbar-DiP1iR_t.js +3088 -0
  18. package/dist/lib/Toolbar-DiP1iR_t.js.map +1 -0
  19. package/dist/lib/Tooltip-BJSUlXS2.js +117 -0
  20. package/dist/lib/Tooltip-BJSUlXS2.js.map +1 -0
  21. package/dist/lib/VisuallyHidden-DcE0EFpo.js +194 -0
  22. package/dist/lib/VisuallyHidden-DcE0EFpo.js.map +1 -0
  23. package/dist/lib/VoiceControlBar-CWDLR71w.js +3447 -0
  24. package/dist/lib/VoiceControlBar-CWDLR71w.js.map +1 -0
  25. package/dist/lib/Waveform-BIE2Ztc8.js +318 -0
  26. package/dist/lib/Waveform-BIE2Ztc8.js.map +1 -0
  27. package/dist/lib/components/common/AspectRatio/AspectRatio.d.ts +26 -0
  28. package/dist/lib/components/common/AspectRatio/index.d.ts +2 -0
  29. package/dist/lib/components/common/Avatar/Avatar.d.ts +58 -0
  30. package/dist/lib/components/common/Avatar/index.d.ts +2 -0
  31. package/dist/lib/components/common/Badge/Badge.d.ts +36 -0
  32. package/dist/lib/components/common/Badge/index.d.ts +2 -0
  33. package/dist/lib/components/common/Blockquote/Blockquote.d.ts +40 -0
  34. package/dist/lib/components/common/Blockquote/index.d.ts +2 -0
  35. package/dist/lib/components/common/Button/Button.d.ts +38 -0
  36. package/dist/lib/components/common/Button/index.d.ts +2 -0
  37. package/dist/lib/components/common/CalibratedPulse/CalibratedPulse.d.ts +63 -0
  38. package/dist/lib/components/common/CalibratedPulse/index.d.ts +2 -0
  39. package/dist/lib/components/common/Center/Center.d.ts +23 -0
  40. package/dist/lib/components/common/Center/index.d.ts +2 -0
  41. package/dist/lib/components/common/Checkbox/Checkbox.d.ts +35 -0
  42. package/dist/lib/components/common/Checkbox/index.d.ts +2 -0
  43. package/dist/lib/components/common/Code/Code.d.ts +37 -0
  44. package/dist/lib/components/common/Code/index.d.ts +2 -0
  45. package/dist/lib/components/common/Collapse/Collapse.d.ts +29 -0
  46. package/dist/lib/components/common/Collapse/index.d.ts +2 -0
  47. package/dist/lib/components/common/Container/Container.d.ts +28 -0
  48. package/dist/lib/components/common/Container/index.d.ts +2 -0
  49. package/dist/lib/components/common/Divider/Divider.d.ts +28 -0
  50. package/dist/lib/components/common/Divider/index.d.ts +2 -0
  51. package/dist/lib/components/common/FileInput/FileInput.d.ts +52 -0
  52. package/dist/lib/components/common/FileInput/index.d.ts +2 -0
  53. package/dist/lib/components/common/Flex/Flex.d.ts +35 -0
  54. package/dist/lib/components/common/Flex/index.d.ts +2 -0
  55. package/dist/lib/components/common/Glass/Glass.d.ts +35 -0
  56. package/dist/lib/components/common/Glass/index.d.ts +2 -0
  57. package/dist/lib/components/common/Glass/refraction.d.ts +24 -0
  58. package/dist/lib/components/common/Glass/rim.d.ts +37 -0
  59. package/dist/lib/components/common/Grid/Grid.d.ts +28 -0
  60. package/dist/lib/components/common/Grid/GridItem.d.ts +31 -0
  61. package/dist/lib/components/common/Grid/index.d.ts +4 -0
  62. package/dist/lib/components/common/Group/Group.d.ts +38 -0
  63. package/dist/lib/components/common/Group/index.d.ts +2 -0
  64. package/dist/lib/components/common/Highlight/Highlight.d.ts +63 -0
  65. package/dist/lib/components/common/Highlight/index.d.ts +2 -0
  66. package/dist/lib/components/common/Icon/Icon.d.ts +39 -0
  67. package/dist/lib/components/common/Icon/index.d.ts +2 -0
  68. package/dist/lib/components/common/IconButton/IconButton.d.ts +34 -0
  69. package/dist/lib/components/common/IconButton/index.d.ts +2 -0
  70. package/dist/lib/components/common/Indicator/Indicator.d.ts +51 -0
  71. package/dist/lib/components/common/Indicator/index.d.ts +2 -0
  72. package/dist/lib/components/common/Input/Input.d.ts +84 -0
  73. package/dist/lib/components/common/Input/index.d.ts +2 -0
  74. package/dist/lib/components/common/Kbd/Kbd.d.ts +34 -0
  75. package/dist/lib/components/common/Kbd/index.d.ts +2 -0
  76. package/dist/lib/components/common/Link/Link.d.ts +21 -0
  77. package/dist/lib/components/common/Link/index.d.ts +2 -0
  78. package/dist/lib/components/common/Mark/Mark.d.ts +38 -0
  79. package/dist/lib/components/common/Mark/index.d.ts +2 -0
  80. package/dist/lib/components/common/MultiSelect/MultiSelect.d.ts +54 -0
  81. package/dist/lib/components/common/MultiSelect/index.d.ts +2 -0
  82. package/dist/lib/components/common/PinInput/PinInput.d.ts +49 -0
  83. package/dist/lib/components/common/PinInput/index.d.ts +2 -0
  84. package/dist/lib/components/common/Progress/Progress.d.ts +30 -0
  85. package/dist/lib/components/common/Progress/index.d.ts +2 -0
  86. package/dist/lib/components/common/Radio/Radio.d.ts +45 -0
  87. package/dist/lib/components/common/Radio/index.d.ts +2 -0
  88. package/dist/lib/components/common/RingProgress/RingProgress.d.ts +40 -0
  89. package/dist/lib/components/common/RingProgress/index.d.ts +2 -0
  90. package/dist/lib/components/common/ScrollArea/ScrollArea.d.ts +33 -0
  91. package/dist/lib/components/common/ScrollArea/index.d.ts +2 -0
  92. package/dist/lib/components/common/Select/Select.d.ts +50 -0
  93. package/dist/lib/components/common/Select/index.d.ts +2 -0
  94. package/dist/lib/components/common/Select/listbox.d.ts +68 -0
  95. package/dist/lib/components/common/SimpleGrid/SimpleGrid.d.ts +30 -0
  96. package/dist/lib/components/common/SimpleGrid/index.d.ts +2 -0
  97. package/dist/lib/components/common/Skeleton/Skeleton.d.ts +23 -0
  98. package/dist/lib/components/common/Skeleton/index.d.ts +2 -0
  99. package/dist/lib/components/common/Slider/Slider.d.ts +55 -0
  100. package/dist/lib/components/common/Slider/index.d.ts +2 -0
  101. package/dist/lib/components/common/Space/Space.d.ts +29 -0
  102. package/dist/lib/components/common/Space/index.d.ts +2 -0
  103. package/dist/lib/components/common/Spinner/Spinner.d.ts +25 -0
  104. package/dist/lib/components/common/Spinner/index.d.ts +2 -0
  105. package/dist/lib/components/common/Stack/Stack.d.ts +41 -0
  106. package/dist/lib/components/common/Stack/index.d.ts +2 -0
  107. package/dist/lib/components/common/Switch/Switch.d.ts +28 -0
  108. package/dist/lib/components/common/Switch/index.d.ts +2 -0
  109. package/dist/lib/components/common/Text/Text.d.ts +57 -0
  110. package/dist/lib/components/common/Text/index.d.ts +2 -0
  111. package/dist/lib/components/common/Textarea/Textarea.d.ts +29 -0
  112. package/dist/lib/components/common/Textarea/index.d.ts +2 -0
  113. package/dist/lib/components/common/Tooltip/Tooltip.d.ts +33 -0
  114. package/dist/lib/components/common/Tooltip/index.d.ts +2 -0
  115. package/dist/lib/components/common/VisuallyHidden/VisuallyHidden.d.ts +20 -0
  116. package/dist/lib/components/common/VisuallyHidden/index.d.ts +2 -0
  117. package/dist/lib/components/common/Waveform/Waveform.d.ts +66 -0
  118. package/dist/lib/components/common/Waveform/index.d.ts +2 -0
  119. package/dist/lib/components/common/index.d.ts +44 -0
  120. package/dist/lib/components/common/index.js +7 -0
  121. package/dist/lib/components/composed/AppShell/AppShell.d.ts +95 -0
  122. package/dist/lib/components/composed/AppShell/index.d.ts +2 -0
  123. package/dist/lib/components/composed/Breadcrumb/Breadcrumb.d.ts +46 -0
  124. package/dist/lib/components/composed/Breadcrumb/index.d.ts +2 -0
  125. package/dist/lib/components/composed/BulkActionBar/BulkActionBar.d.ts +48 -0
  126. package/dist/lib/components/composed/BulkActionBar/index.d.ts +2 -0
  127. package/dist/lib/components/composed/Callout/Callout.d.ts +43 -0
  128. package/dist/lib/components/composed/Callout/index.d.ts +2 -0
  129. package/dist/lib/components/composed/Card/Card.d.ts +80 -0
  130. package/dist/lib/components/composed/Card/index.d.ts +2 -0
  131. package/dist/lib/components/composed/Carousel/Carousel.d.ts +52 -0
  132. package/dist/lib/components/composed/Carousel/index.d.ts +2 -0
  133. package/dist/lib/components/composed/Combobox/Combobox.d.ts +50 -0
  134. package/dist/lib/components/composed/Combobox/index.d.ts +2 -0
  135. package/dist/lib/components/composed/CommandPalette/CommandPalette.d.ts +51 -0
  136. package/dist/lib/components/composed/CommandPalette/index.d.ts +2 -0
  137. package/dist/lib/components/composed/DatePicker/Calendar.d.ts +49 -0
  138. package/dist/lib/components/composed/DatePicker/DatePicker.d.ts +36 -0
  139. package/dist/lib/components/composed/DatePicker/dates.d.ts +50 -0
  140. package/dist/lib/components/composed/DatePicker/index.d.ts +3 -0
  141. package/dist/lib/components/composed/DateRangePicker/DateRangePicker.d.ts +40 -0
  142. package/dist/lib/components/composed/DateRangePicker/index.d.ts +2 -0
  143. package/dist/lib/components/composed/Disclosure/Disclosure.d.ts +44 -0
  144. package/dist/lib/components/composed/Disclosure/index.d.ts +2 -0
  145. package/dist/lib/components/composed/Drawer/Drawer.d.ts +39 -0
  146. package/dist/lib/components/composed/Drawer/index.d.ts +2 -0
  147. package/dist/lib/components/composed/EmptyState/EmptyState.d.ts +43 -0
  148. package/dist/lib/components/composed/EmptyState/index.d.ts +2 -0
  149. package/dist/lib/components/composed/Field/Field.d.ts +63 -0
  150. package/dist/lib/components/composed/Field/index.d.ts +2 -0
  151. package/dist/lib/components/composed/FilterBar/FilterBar.d.ts +58 -0
  152. package/dist/lib/components/composed/FilterBar/index.d.ts +2 -0
  153. package/dist/lib/components/composed/FormSection/FormSection.d.ts +35 -0
  154. package/dist/lib/components/composed/FormSection/index.d.ts +2 -0
  155. package/dist/lib/components/composed/ListRow/ListRow.d.ts +83 -0
  156. package/dist/lib/components/composed/ListRow/index.d.ts +2 -0
  157. package/dist/lib/components/composed/Menu/Menu.d.ts +102 -0
  158. package/dist/lib/components/composed/Menu/index.d.ts +2 -0
  159. package/dist/lib/components/composed/Menu/scope.d.ts +15 -0
  160. package/dist/lib/components/composed/Modal/Modal.d.ts +65 -0
  161. package/dist/lib/components/composed/Modal/index.d.ts +2 -0
  162. package/dist/lib/components/composed/PageHeader/PageHeader.d.ts +46 -0
  163. package/dist/lib/components/composed/PageHeader/index.d.ts +2 -0
  164. package/dist/lib/components/composed/Pagination/Pagination.d.ts +48 -0
  165. package/dist/lib/components/composed/Pagination/index.d.ts +2 -0
  166. package/dist/lib/components/composed/Popover/Popover.d.ts +47 -0
  167. package/dist/lib/components/composed/Popover/index.d.ts +2 -0
  168. package/dist/lib/components/composed/PreferenceRow/PreferenceRow.d.ts +43 -0
  169. package/dist/lib/components/composed/PreferenceRow/index.d.ts +2 -0
  170. package/dist/lib/components/composed/Sheet/Sheet.d.ts +53 -0
  171. package/dist/lib/components/composed/Sheet/index.d.ts +2 -0
  172. package/dist/lib/components/composed/SidePanel/SidePanel.d.ts +34 -0
  173. package/dist/lib/components/composed/SidePanel/index.d.ts +2 -0
  174. package/dist/lib/components/composed/SidebarNav/SidebarNav.d.ts +85 -0
  175. package/dist/lib/components/composed/SidebarNav/index.d.ts +2 -0
  176. package/dist/lib/components/composed/Spotlight/Spotlight.d.ts +57 -0
  177. package/dist/lib/components/composed/Spotlight/index.d.ts +2 -0
  178. package/dist/lib/components/composed/Stepper/Stepper.d.ts +36 -0
  179. package/dist/lib/components/composed/Stepper/index.d.ts +2 -0
  180. package/dist/lib/components/composed/Table/Table.d.ts +142 -0
  181. package/dist/lib/components/composed/Table/index.d.ts +2 -0
  182. package/dist/lib/components/composed/Tabs/Tabs.d.ts +48 -0
  183. package/dist/lib/components/composed/Tabs/index.d.ts +2 -0
  184. package/dist/lib/components/composed/TimeInput/TimeInput.d.ts +41 -0
  185. package/dist/lib/components/composed/TimeInput/index.d.ts +3 -0
  186. package/dist/lib/components/composed/TimeInput/times.d.ts +47 -0
  187. package/dist/lib/components/composed/Toast/Toast.d.ts +37 -0
  188. package/dist/lib/components/composed/Toast/index.d.ts +2 -0
  189. package/dist/lib/components/composed/Toolbar/Toolbar.d.ts +45 -0
  190. package/dist/lib/components/composed/Toolbar/index.d.ts +2 -0
  191. package/dist/lib/components/composed/index.d.ts +33 -0
  192. package/dist/lib/components/composed/index.js +3 -0
  193. package/dist/lib/components/derived/AvatarGroup/AvatarGroup.d.ts +52 -0
  194. package/dist/lib/components/derived/AvatarGroup/index.d.ts +2 -0
  195. package/dist/lib/components/derived/ButtonGroup/ButtonGroup.d.ts +33 -0
  196. package/dist/lib/components/derived/ButtonGroup/index.d.ts +2 -0
  197. package/dist/lib/components/derived/ChoiceCard/ChoiceCard.d.ts +43 -0
  198. package/dist/lib/components/derived/ChoiceCard/index.d.ts +2 -0
  199. package/dist/lib/components/derived/InputGroup/InputGroup.d.ts +23 -0
  200. package/dist/lib/components/derived/InputGroup/index.d.ts +2 -0
  201. package/dist/lib/components/derived/MorphIcon/MorphIcon.d.ts +71 -0
  202. package/dist/lib/components/derived/MorphIcon/index.d.ts +2 -0
  203. package/dist/lib/components/derived/NumberFlow/NumberFlow.d.ts +47 -0
  204. package/dist/lib/components/derived/NumberFlow/index.d.ts +2 -0
  205. package/dist/lib/components/derived/NumberInput/NumberInput.d.ts +54 -0
  206. package/dist/lib/components/derived/NumberInput/index.d.ts +2 -0
  207. package/dist/lib/components/derived/PasswordInput/PasswordInput.d.ts +53 -0
  208. package/dist/lib/components/derived/PasswordInput/index.d.ts +2 -0
  209. package/dist/lib/components/derived/SearchInput/SearchInput.d.ts +33 -0
  210. package/dist/lib/components/derived/SearchInput/index.d.ts +2 -0
  211. package/dist/lib/components/derived/SegmentedControl/SegmentedControl.d.ts +44 -0
  212. package/dist/lib/components/derived/SegmentedControl/index.d.ts +2 -0
  213. package/dist/lib/components/derived/SplitButton/SplitButton.d.ts +42 -0
  214. package/dist/lib/components/derived/SplitButton/index.d.ts +2 -0
  215. package/dist/lib/components/derived/StatusDot/StatusDot.d.ts +31 -0
  216. package/dist/lib/components/derived/StatusDot/index.d.ts +2 -0
  217. package/dist/lib/components/derived/Tag/Tag.d.ts +47 -0
  218. package/dist/lib/components/derived/Tag/index.d.ts +2 -0
  219. package/dist/lib/components/derived/TagInput/TagInput.d.ts +28 -0
  220. package/dist/lib/components/derived/TagInput/index.d.ts +2 -0
  221. package/dist/lib/components/derived/TextCycle/TextCycle.d.ts +40 -0
  222. package/dist/lib/components/derived/TextCycle/index.d.ts +2 -0
  223. package/dist/lib/components/derived/ToggleButton/ToggleButton.d.ts +43 -0
  224. package/dist/lib/components/derived/ToggleButton/index.d.ts +2 -0
  225. package/dist/lib/components/derived/index.d.ts +16 -0
  226. package/dist/lib/components/derived/index.js +4 -0
  227. package/dist/lib/components/extended/ActivityList/ActivityList.d.ts +38 -0
  228. package/dist/lib/components/extended/ActivityList/index.d.ts +2 -0
  229. package/dist/lib/components/extended/AddressForm/AddressForm.d.ts +71 -0
  230. package/dist/lib/components/extended/AddressForm/index.d.ts +2 -0
  231. package/dist/lib/components/extended/ApprovalGate/ApprovalGate.d.ts +60 -0
  232. package/dist/lib/components/extended/ApprovalGate/index.d.ts +2 -0
  233. package/dist/lib/components/extended/BackgroundProgress/BackgroundProgress.d.ts +63 -0
  234. package/dist/lib/components/extended/BackgroundProgress/index.d.ts +2 -0
  235. package/dist/lib/components/extended/Citation/Citation.d.ts +61 -0
  236. package/dist/lib/components/extended/Citation/index.d.ts +2 -0
  237. package/dist/lib/components/extended/CommentThread/CommentThread.d.ts +61 -0
  238. package/dist/lib/components/extended/CommentThread/index.d.ts +2 -0
  239. package/dist/lib/components/extended/Composer/Composer.d.ts +57 -0
  240. package/dist/lib/components/extended/Composer/index.d.ts +2 -0
  241. package/dist/lib/components/extended/CouponField/CouponField.d.ts +59 -0
  242. package/dist/lib/components/extended/CouponField/index.d.ts +2 -0
  243. package/dist/lib/components/extended/DataGrid/DataGrid.d.ts +161 -0
  244. package/dist/lib/components/extended/DataGrid/DataGrid.state.d.ts +93 -0
  245. package/dist/lib/components/extended/DataGrid/index.d.ts +2 -0
  246. package/dist/lib/components/extended/Dropzone/Dropzone.d.ts +83 -0
  247. package/dist/lib/components/extended/Dropzone/index.d.ts +2 -0
  248. package/dist/lib/components/extended/FeedbackControl/FeedbackControl.d.ts +47 -0
  249. package/dist/lib/components/extended/FeedbackControl/index.d.ts +2 -0
  250. package/dist/lib/components/extended/FilterBuilder/FilterBuilder.d.ts +67 -0
  251. package/dist/lib/components/extended/FilterBuilder/index.d.ts +2 -0
  252. package/dist/lib/components/extended/FollowUpList/FollowUpList.d.ts +34 -0
  253. package/dist/lib/components/extended/FollowUpList/index.d.ts +2 -0
  254. package/dist/lib/components/extended/KanbanColumn/KanbanColumn.d.ts +62 -0
  255. package/dist/lib/components/extended/KanbanColumn/index.d.ts +2 -0
  256. package/dist/lib/components/extended/Message/Message.d.ts +43 -0
  257. package/dist/lib/components/extended/Message/index.d.ts +2 -0
  258. package/dist/lib/components/extended/MessageList/MessageList.d.ts +66 -0
  259. package/dist/lib/components/extended/MessageList/index.d.ts +2 -0
  260. package/dist/lib/components/extended/MetricCard/MetricCard.d.ts +60 -0
  261. package/dist/lib/components/extended/MetricCard/index.d.ts +2 -0
  262. package/dist/lib/components/extended/OrderSummary/OrderSummary.d.ts +70 -0
  263. package/dist/lib/components/extended/OrderSummary/index.d.ts +2 -0
  264. package/dist/lib/components/extended/PaymentMethodSelector/PaymentMethodSelector.d.ts +65 -0
  265. package/dist/lib/components/extended/PaymentMethodSelector/index.d.ts +2 -0
  266. package/dist/lib/components/extended/PresenceBar/PresenceBar.d.ts +49 -0
  267. package/dist/lib/components/extended/PresenceBar/index.d.ts +2 -0
  268. package/dist/lib/components/extended/PriceDisplay/PriceDisplay.d.ts +53 -0
  269. package/dist/lib/components/extended/PriceDisplay/index.d.ts +2 -0
  270. package/dist/lib/components/extended/ProductCard/ProductCard.d.ts +58 -0
  271. package/dist/lib/components/extended/ProductCard/index.d.ts +2 -0
  272. package/dist/lib/components/extended/QuantityStepper/QuantityStepper.d.ts +41 -0
  273. package/dist/lib/components/extended/QuantityStepper/index.d.ts +2 -0
  274. package/dist/lib/components/extended/ReasoningDisclosure/ReasoningDisclosure.d.ts +33 -0
  275. package/dist/lib/components/extended/ReasoningDisclosure/index.d.ts +2 -0
  276. package/dist/lib/components/extended/RecognitionFallback/RecognitionFallback.d.ts +57 -0
  277. package/dist/lib/components/extended/RecognitionFallback/index.d.ts +2 -0
  278. package/dist/lib/components/extended/RunStatusCard/RunStatusCard.d.ts +51 -0
  279. package/dist/lib/components/extended/RunStatusCard/index.d.ts +2 -0
  280. package/dist/lib/components/extended/SavedViewTabs/SavedViewTabs.d.ts +49 -0
  281. package/dist/lib/components/extended/SavedViewTabs/index.d.ts +2 -0
  282. package/dist/lib/components/extended/SourceChip/SourceChip.d.ts +37 -0
  283. package/dist/lib/components/extended/SourceChip/index.d.ts +2 -0
  284. package/dist/lib/components/extended/SourceChipRow/SourceChipRow.d.ts +54 -0
  285. package/dist/lib/components/extended/SourceChipRow/index.d.ts +2 -0
  286. package/dist/lib/components/extended/SourcePanel/SourcePanel.d.ts +46 -0
  287. package/dist/lib/components/extended/SourcePanel/index.d.ts +2 -0
  288. package/dist/lib/components/extended/StreamingText/StreamingText.d.ts +30 -0
  289. package/dist/lib/components/extended/StreamingText/index.d.ts +2 -0
  290. package/dist/lib/components/extended/ToolCallCard/ToolCallCard.d.ts +52 -0
  291. package/dist/lib/components/extended/ToolCallCard/index.d.ts +2 -0
  292. package/dist/lib/components/extended/TranscriptSync/TranscriptSync.d.ts +58 -0
  293. package/dist/lib/components/extended/TranscriptSync/index.d.ts +2 -0
  294. package/dist/lib/components/extended/TrustBlock/TrustBlock.d.ts +37 -0
  295. package/dist/lib/components/extended/TrustBlock/index.d.ts +2 -0
  296. package/dist/lib/components/extended/VoiceControlBar/VoiceControlBar.d.ts +77 -0
  297. package/dist/lib/components/extended/VoiceControlBar/index.d.ts +2 -0
  298. package/dist/lib/components/extended/index.d.ts +35 -0
  299. package/dist/lib/components/extended/index.js +2 -0
  300. package/dist/lib/fonts/pretendard/LICENSE.txt +94 -0
  301. package/dist/lib/fonts/pretendard/PretendardVariable.subset.0.woff2 +0 -0
  302. package/dist/lib/fonts/pretendard/PretendardVariable.subset.1.woff2 +0 -0
  303. package/dist/lib/fonts/pretendard/PretendardVariable.subset.10.woff2 +0 -0
  304. package/dist/lib/fonts/pretendard/PretendardVariable.subset.11.woff2 +0 -0
  305. package/dist/lib/fonts/pretendard/PretendardVariable.subset.12.woff2 +0 -0
  306. package/dist/lib/fonts/pretendard/PretendardVariable.subset.13.woff2 +0 -0
  307. package/dist/lib/fonts/pretendard/PretendardVariable.subset.14.woff2 +0 -0
  308. package/dist/lib/fonts/pretendard/PretendardVariable.subset.15.woff2 +0 -0
  309. package/dist/lib/fonts/pretendard/PretendardVariable.subset.16.woff2 +0 -0
  310. package/dist/lib/fonts/pretendard/PretendardVariable.subset.17.woff2 +0 -0
  311. package/dist/lib/fonts/pretendard/PretendardVariable.subset.18.woff2 +0 -0
  312. package/dist/lib/fonts/pretendard/PretendardVariable.subset.19.woff2 +0 -0
  313. package/dist/lib/fonts/pretendard/PretendardVariable.subset.2.woff2 +0 -0
  314. package/dist/lib/fonts/pretendard/PretendardVariable.subset.20.woff2 +0 -0
  315. package/dist/lib/fonts/pretendard/PretendardVariable.subset.21.woff2 +0 -0
  316. package/dist/lib/fonts/pretendard/PretendardVariable.subset.22.woff2 +0 -0
  317. package/dist/lib/fonts/pretendard/PretendardVariable.subset.23.woff2 +0 -0
  318. package/dist/lib/fonts/pretendard/PretendardVariable.subset.24.woff2 +0 -0
  319. package/dist/lib/fonts/pretendard/PretendardVariable.subset.25.woff2 +0 -0
  320. package/dist/lib/fonts/pretendard/PretendardVariable.subset.26.woff2 +0 -0
  321. package/dist/lib/fonts/pretendard/PretendardVariable.subset.27.woff2 +0 -0
  322. package/dist/lib/fonts/pretendard/PretendardVariable.subset.28.woff2 +0 -0
  323. package/dist/lib/fonts/pretendard/PretendardVariable.subset.29.woff2 +0 -0
  324. package/dist/lib/fonts/pretendard/PretendardVariable.subset.3.woff2 +0 -0
  325. package/dist/lib/fonts/pretendard/PretendardVariable.subset.30.woff2 +0 -0
  326. package/dist/lib/fonts/pretendard/PretendardVariable.subset.31.woff2 +0 -0
  327. package/dist/lib/fonts/pretendard/PretendardVariable.subset.32.woff2 +0 -0
  328. package/dist/lib/fonts/pretendard/PretendardVariable.subset.33.woff2 +0 -0
  329. package/dist/lib/fonts/pretendard/PretendardVariable.subset.34.woff2 +0 -0
  330. package/dist/lib/fonts/pretendard/PretendardVariable.subset.35.woff2 +0 -0
  331. package/dist/lib/fonts/pretendard/PretendardVariable.subset.36.woff2 +0 -0
  332. package/dist/lib/fonts/pretendard/PretendardVariable.subset.37.woff2 +0 -0
  333. package/dist/lib/fonts/pretendard/PretendardVariable.subset.38.woff2 +0 -0
  334. package/dist/lib/fonts/pretendard/PretendardVariable.subset.39.woff2 +0 -0
  335. package/dist/lib/fonts/pretendard/PretendardVariable.subset.4.woff2 +0 -0
  336. package/dist/lib/fonts/pretendard/PretendardVariable.subset.40.woff2 +0 -0
  337. package/dist/lib/fonts/pretendard/PretendardVariable.subset.41.woff2 +0 -0
  338. package/dist/lib/fonts/pretendard/PretendardVariable.subset.42.woff2 +0 -0
  339. package/dist/lib/fonts/pretendard/PretendardVariable.subset.43.woff2 +0 -0
  340. package/dist/lib/fonts/pretendard/PretendardVariable.subset.44.woff2 +0 -0
  341. package/dist/lib/fonts/pretendard/PretendardVariable.subset.45.woff2 +0 -0
  342. package/dist/lib/fonts/pretendard/PretendardVariable.subset.46.woff2 +0 -0
  343. package/dist/lib/fonts/pretendard/PretendardVariable.subset.47.woff2 +0 -0
  344. package/dist/lib/fonts/pretendard/PretendardVariable.subset.48.woff2 +0 -0
  345. package/dist/lib/fonts/pretendard/PretendardVariable.subset.49.woff2 +0 -0
  346. package/dist/lib/fonts/pretendard/PretendardVariable.subset.5.woff2 +0 -0
  347. package/dist/lib/fonts/pretendard/PretendardVariable.subset.50.woff2 +0 -0
  348. package/dist/lib/fonts/pretendard/PretendardVariable.subset.51.woff2 +0 -0
  349. package/dist/lib/fonts/pretendard/PretendardVariable.subset.52.woff2 +0 -0
  350. package/dist/lib/fonts/pretendard/PretendardVariable.subset.53.woff2 +0 -0
  351. package/dist/lib/fonts/pretendard/PretendardVariable.subset.54.woff2 +0 -0
  352. package/dist/lib/fonts/pretendard/PretendardVariable.subset.55.woff2 +0 -0
  353. package/dist/lib/fonts/pretendard/PretendardVariable.subset.56.woff2 +0 -0
  354. package/dist/lib/fonts/pretendard/PretendardVariable.subset.57.woff2 +0 -0
  355. package/dist/lib/fonts/pretendard/PretendardVariable.subset.58.woff2 +0 -0
  356. package/dist/lib/fonts/pretendard/PretendardVariable.subset.59.woff2 +0 -0
  357. package/dist/lib/fonts/pretendard/PretendardVariable.subset.6.woff2 +0 -0
  358. package/dist/lib/fonts/pretendard/PretendardVariable.subset.60.woff2 +0 -0
  359. package/dist/lib/fonts/pretendard/PretendardVariable.subset.61.woff2 +0 -0
  360. package/dist/lib/fonts/pretendard/PretendardVariable.subset.62.woff2 +0 -0
  361. package/dist/lib/fonts/pretendard/PretendardVariable.subset.63.woff2 +0 -0
  362. package/dist/lib/fonts/pretendard/PretendardVariable.subset.64.woff2 +0 -0
  363. package/dist/lib/fonts/pretendard/PretendardVariable.subset.65.woff2 +0 -0
  364. package/dist/lib/fonts/pretendard/PretendardVariable.subset.66.woff2 +0 -0
  365. package/dist/lib/fonts/pretendard/PretendardVariable.subset.67.woff2 +0 -0
  366. package/dist/lib/fonts/pretendard/PretendardVariable.subset.68.woff2 +0 -0
  367. package/dist/lib/fonts/pretendard/PretendardVariable.subset.69.woff2 +0 -0
  368. package/dist/lib/fonts/pretendard/PretendardVariable.subset.7.woff2 +0 -0
  369. package/dist/lib/fonts/pretendard/PretendardVariable.subset.70.woff2 +0 -0
  370. package/dist/lib/fonts/pretendard/PretendardVariable.subset.71.woff2 +0 -0
  371. package/dist/lib/fonts/pretendard/PretendardVariable.subset.72.woff2 +0 -0
  372. package/dist/lib/fonts/pretendard/PretendardVariable.subset.73.woff2 +0 -0
  373. package/dist/lib/fonts/pretendard/PretendardVariable.subset.74.woff2 +0 -0
  374. package/dist/lib/fonts/pretendard/PretendardVariable.subset.75.woff2 +0 -0
  375. package/dist/lib/fonts/pretendard/PretendardVariable.subset.76.woff2 +0 -0
  376. package/dist/lib/fonts/pretendard/PretendardVariable.subset.77.woff2 +0 -0
  377. package/dist/lib/fonts/pretendard/PretendardVariable.subset.78.woff2 +0 -0
  378. package/dist/lib/fonts/pretendard/PretendardVariable.subset.79.woff2 +0 -0
  379. package/dist/lib/fonts/pretendard/PretendardVariable.subset.8.woff2 +0 -0
  380. package/dist/lib/fonts/pretendard/PretendardVariable.subset.80.woff2 +0 -0
  381. package/dist/lib/fonts/pretendard/PretendardVariable.subset.81.woff2 +0 -0
  382. package/dist/lib/fonts/pretendard/PretendardVariable.subset.82.woff2 +0 -0
  383. package/dist/lib/fonts/pretendard/PretendardVariable.subset.83.woff2 +0 -0
  384. package/dist/lib/fonts/pretendard/PretendardVariable.subset.84.woff2 +0 -0
  385. package/dist/lib/fonts/pretendard/PretendardVariable.subset.85.woff2 +0 -0
  386. package/dist/lib/fonts/pretendard/PretendardVariable.subset.86.woff2 +0 -0
  387. package/dist/lib/fonts/pretendard/PretendardVariable.subset.87.woff2 +0 -0
  388. package/dist/lib/fonts/pretendard/PretendardVariable.subset.88.woff2 +0 -0
  389. package/dist/lib/fonts/pretendard/PretendardVariable.subset.89.woff2 +0 -0
  390. package/dist/lib/fonts/pretendard/PretendardVariable.subset.9.woff2 +0 -0
  391. package/dist/lib/fonts/pretendard/PretendardVariable.subset.90.woff2 +0 -0
  392. package/dist/lib/fonts/pretendard/PretendardVariable.subset.91.woff2 +0 -0
  393. package/dist/lib/foundation/focus.d.ts +10 -0
  394. package/dist/lib/foundation/josa.d.ts +4 -0
  395. package/dist/lib/index.d.ts +4 -0
  396. package/dist/lib/index.js +13 -0
  397. package/dist/lib/pretendard.css +940 -0
  398. package/dist/lib/reset.css +50 -0
  399. package/dist/lib/styles.css +3 -0
  400. package/dist/lib/tokens.css +1118 -0
  401. package/package.json +91 -0
@@ -0,0 +1,102 @@
1
+ import type { ReactElement, ReactNode } from "react";
2
+ import type { LucideIcon } from "lucide-react";
3
+ import "./Menu.css";
4
+ export type MenuSide = "top" | "right" | "bottom" | "left";
5
+ export type MenuAlign = "start" | "center" | "end";
6
+ export type MenuProps = {
7
+ /** The control that opens it. One element, and it must be able to take focus. */
8
+ children: ReactElement;
9
+ /** `MenuItem`, `MenuGroup`, `MenuSeparator` and friends. */
10
+ items: ReactNode;
11
+ side?: MenuSide;
12
+ align?: MenuAlign;
13
+ open?: boolean;
14
+ onOpenChange?: (open: boolean) => void;
15
+ /**
16
+ * Locks the trigger.
17
+ *
18
+ * `Button` and `IconButton` mark themselves `aria-disabled` and stop their own `onClick`,
19
+ * and Radix opens on `pointerdown` and `keydown` — so a disabled-looking trigger still
20
+ * opened the menu. Passed here, Radix refuses both.
21
+ */
22
+ disabled?: boolean;
23
+ /** The panel's `id`, for a trigger that points at it with `aria-controls`. */
24
+ id?: string;
25
+ className?: string;
26
+ };
27
+ /**
28
+ * A list of actions, opened from a control.
29
+ *
30
+ * Radix rather than hand-rolled. A menu is the control with the most keyboard behaviour of
31
+ * anything in this library: type-ahead, arrow keys that stop at either end, Home and End, submenus that
32
+ * open on hover behind a safe triangle and on ArrowRight, ArrowLeft closing one level and
33
+ * Escape closing all of them, focus returned to the trigger, and the whole page made inert
34
+ * while it is up. Rebuilt by hand, one of those is always missing.
35
+ *
36
+ * Not a `<select>`. A menu performs actions; a select chooses a value and submits it with a
37
+ * form. If the thing being pointed at is a value, it is `Select` or `SegmentedControl`.
38
+ *
39
+ * There is no `label` prop, and there was one until it turned out not to work. The menu is
40
+ * named by its trigger — `aria-labelledby` pointing at the button, which takes precedence
41
+ * over any `aria-label` written beside it — and that is the right name anyway: a reader who
42
+ * opened "보기 설정" is in the 보기 설정 menu. What it means is that the trigger has to be
43
+ * named well, which for an icon-only one `IconButton` already requires.
44
+ */
45
+ export declare function Menu({ children, items, side, align, open, onOpenChange, disabled, id, className, }: MenuProps): import("react").JSX.Element;
46
+ export type MenuItemProps = {
47
+ children: ReactNode;
48
+ icon?: LucideIcon;
49
+ /** The keystroke that does the same thing. Announced with the item, not instead of it. */
50
+ shortcut?: string;
51
+ /**
52
+ * The item that cannot be undone.
53
+ *
54
+ * Tone is never the only carrier — the label has to say what it deletes — but a destructive
55
+ * item that looks like the five above it is one a reader picks by accident.
56
+ */
57
+ destructive?: boolean;
58
+ disabled?: boolean;
59
+ onSelect?: () => void;
60
+ className?: string;
61
+ [key: `data-${string}`]: unknown;
62
+ };
63
+ export declare function MenuItem({ children, icon, shortcut, destructive, disabled, onSelect, className, ...rest }: MenuItemProps): import("react").JSX.Element;
64
+ export type MenuCheckboxItemProps = {
65
+ children: ReactNode;
66
+ checked: boolean;
67
+ onCheckedChange: (checked: boolean) => void;
68
+ disabled?: boolean;
69
+ className?: string;
70
+ [key: `data-${string}`]: unknown;
71
+ };
72
+ /** A setting that stays on. Announced as checked, which a plain item is not. */
73
+ export declare function MenuCheckboxItem({ children, checked, onCheckedChange, disabled, className, ...rest }: MenuCheckboxItemProps): import("react").JSX.Element;
74
+ export type MenuRadioGroupProps = {
75
+ children: ReactNode;
76
+ value: string;
77
+ onValueChange: (value: string) => void;
78
+ };
79
+ export declare function MenuRadioGroup({ children, value, onValueChange }: MenuRadioGroupProps): import("react").JSX.Element;
80
+ export type MenuRadioItemProps = {
81
+ children: ReactNode;
82
+ value: string;
83
+ disabled?: boolean;
84
+ className?: string;
85
+ [key: `data-${string}`]: unknown;
86
+ };
87
+ export declare function MenuRadioItem({ children, value, disabled, className, ...rest }: MenuRadioItemProps): import("react").JSX.Element;
88
+ export type MenuGroupProps = {
89
+ children: ReactNode;
90
+ /** A heading for the group. Announced when the reader enters it. */
91
+ label?: string;
92
+ };
93
+ export declare function MenuGroup({ children, label }: MenuGroupProps): import("react").JSX.Element;
94
+ export declare function MenuSeparator(): import("react").JSX.Element;
95
+ export type MenuSubProps = {
96
+ children: ReactNode;
97
+ label: ReactNode;
98
+ icon?: LucideIcon;
99
+ disabled?: boolean;
100
+ };
101
+ /** A menu inside a menu. Opens on ArrowRight and on hover; ArrowLeft closes this level, Escape closes the lot. */
102
+ export declare function MenuSub({ children, label, icon, disabled }: MenuSubProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { Menu, MenuItem, MenuCheckboxItem, MenuRadioGroup, MenuRadioItem, MenuGroup, MenuSeparator, MenuSub, } from "./Menu";
2
+ export type { MenuProps, MenuItemProps, MenuCheckboxItemProps, MenuRadioGroupProps, MenuRadioItemProps, MenuGroupProps, MenuSubProps, MenuSide, MenuAlign, } from "./Menu";
@@ -0,0 +1,15 @@
1
+ import { type ReactElement, type Ref } from "react";
2
+ declare const ATTRIBUTES: readonly ["data-theme", "data-brand", "data-density", "data-radius", "data-look"];
3
+ type Scope = Record<(typeof ATTRIBUTES)[number], string | undefined>;
4
+ /** Preserve built-in variation scopes without copying computed paint or moving the portal. */
5
+ export declare function useMenuScopes(): {
6
+ scopes: Scope[];
7
+ setTrigger: import("react").Dispatch<import("react").SetStateAction<HTMLElement | null>>;
8
+ };
9
+ export declare const MenuPortalScope: import("react").ForwardRefExoticComponent<{
10
+ scopes: Scope[];
11
+ children: ReactElement<{
12
+ ref?: Ref<HTMLDivElement>;
13
+ }>;
14
+ } & import("react").RefAttributes<HTMLDivElement>>;
15
+ export {};
@@ -0,0 +1,65 @@
1
+ import type { ReactElement, ReactNode } from "react";
2
+ import "./Modal.css";
3
+ export type ModalSize = "sm" | "md" | "lg";
4
+ /** What a dialog becomes when the window is too narrow to centre one. */
5
+ export type ModalNarrow = "centred" | "bottom";
6
+ export type ModalProps = {
7
+ open?: boolean;
8
+ onOpenChange?: (open: boolean) => void;
9
+ /** The control that opens it, when the modal owns its own state. */
10
+ trigger?: ReactElement;
11
+ /**
12
+ * What the dialog is about. Required.
13
+ *
14
+ * A dialog with no name is announced as "dialog" and nothing else: the reader is told they
15
+ * have arrived somewhere and not told where, with the rest of the page now inert behind
16
+ * them.
17
+ */
18
+ title: string;
19
+ description?: ReactNode;
20
+ children: ReactNode;
21
+ /** The actions. Convention is the safe one first, the committing one last. */
22
+ footer?: ReactNode;
23
+ size?: ModalSize;
24
+ /**
25
+ * What it does on a phone.
26
+ *
27
+ * `bottom` moves the dialog to the bottom edge, full width, with the top corners rounded —
28
+ * the shape a phone expects, and the one a thumb can reach the buttons of. `centred` keeps it
29
+ * in the middle at every width.
30
+ *
31
+ * **It stays a dialog.** `docs/최신-UI-신규-컴포넌트.md` 4.2 describes this as a dialog
32
+ * becoming a sheet, and building it that way would be wrong here: `Sheet` deliberately does
33
+ * not trap focus, does not make the page inert and has no scrim, because a sheet is an index
34
+ * to the page behind it. Swapping one for the other at a breakpoint would change what the
35
+ * component *is* halfway across a resize — a form that traps focus on a laptop and does not
36
+ * on a phone. This is a shape, not a second behaviour, so it is CSS and there is one DOM.
37
+ */
38
+ narrow?: ModalNarrow;
39
+ /**
40
+ * A decision rather than a task.
41
+ *
42
+ * `role="alertdialog"`, which tells a screen reader to read the description immediately
43
+ * instead of waiting to be asked, and turns off dismissal by clicking outside — a stray
44
+ * click should not answer a question the dialog was asked to put.
45
+ */
46
+ urgent?: boolean;
47
+ /**
48
+ * Clicking outside closes it. On by default, and worth turning off for a dialog holding
49
+ * anything the reader has typed: a misclick then costs them their work.
50
+ */
51
+ dismissOnOutside?: boolean;
52
+ className?: string;
53
+ [key: `data-${string}`]: unknown;
54
+ };
55
+ /**
56
+ * A window over the page, with the page inert behind it.
57
+ *
58
+ * Radix rather than hand-rolled. A dialog has to trap focus without trapping it forever,
59
+ * return it to whatever opened it, mark the rest of the document `aria-hidden`, lock the
60
+ * page's scroll without the layout jumping as the scrollbar goes, close on Escape, and
61
+ * portal to the end of the body so no ancestor's `overflow` or `transform` can clip or
62
+ * reposition it. Every one of those is invisible in a screenshot and wrong in most
63
+ * hand-written dialogs.
64
+ */
65
+ export declare function Modal({ open, onOpenChange, trigger, title, description, children, footer, size, narrow, urgent, dismissOnOutside, className, ...rest }: ModalProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { Modal } from "./Modal";
2
+ export type { ModalProps, ModalSize, ModalNarrow } from "./Modal";
@@ -0,0 +1,46 @@
1
+ import type { ReactNode } from "react";
2
+ import "./PageHeader.css";
3
+ export type PageHeaderRail = {
4
+ onRailToggle?: undefined;
5
+ railOpen?: undefined;
6
+ railLabel?: string;
7
+ railId?: undefined;
8
+ } | {
9
+ onRailToggle: () => void;
10
+ /** Whether the rail is showing right now. Names the button and sets `aria-expanded`. */
11
+ railOpen: boolean;
12
+ railLabel?: string;
13
+ /** The id of the rail the button opens, for `aria-controls`. `AppShell` takes `railId`. */
14
+ railId?: string;
15
+ };
16
+ export type PageHeaderProps = PageHeaderRail & {
17
+ title: string;
18
+ /** A `Breadcrumb`, usually. Sits above the title because that is where the reader looks for it. */
19
+ breadcrumb?: ReactNode;
20
+ /** One line under the title. Longer than that belongs in the page. */
21
+ description?: ReactNode;
22
+ /**
23
+ * What is true about this page right now — a `Badge`, a `StatusDot`, a saved-at time.
24
+ *
25
+ * Beside the title rather than in the actions, because a status is something the reader
26
+ * reads and an action is something they press, and a row that mixes the two makes the
27
+ * reader test each item to find out which it is.
28
+ */
29
+ status?: ReactNode;
30
+ /** The page's own buttons. The primary one goes last, where the reader's hand already is. */
31
+ actions?: ReactNode;
32
+ className?: string;
33
+ [key: `data-${string}`]: unknown;
34
+ };
35
+ /**
36
+ * The band at the top of a page that says where you are and what you can do here.
37
+ *
38
+ * Written because every demo in this repository was drawing its own: a title, a row of
39
+ * buttons, a divider, each with its own spacing and its own idea of what happens when the
40
+ * title is long. Eighty-one of those is not a design system, it is eighty-one headers.
41
+ *
42
+ * The title truncates and the actions do not. When the room runs out it is the sentence that
43
+ * gives way, never the buttons — a clipped label on a destructive action is how the wrong
44
+ * button gets pressed. On a phone the actions drop to their own row instead of competing.
45
+ */
46
+ export declare function PageHeader({ title, breadcrumb, description, status, actions, onRailToggle, railOpen, railId, railLabel, className, ...rest }: PageHeaderProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { PageHeader } from "./PageHeader";
2
+ export type { PageHeaderProps } from "./PageHeader";
@@ -0,0 +1,48 @@
1
+ import "./Pagination.css";
2
+ export type PaginationProps = {
3
+ page: number;
4
+ pageCount: number;
5
+ onPageChange: (page: number) => void;
6
+ /** What is being paged. "주문 목록", "검색 결과". Names the navigation. */
7
+ label: string;
8
+ /** How many page numbers to show either side of the current one. */
9
+ siblings?: number;
10
+ /** "1–20 / 137" above the numbers, for a reader who wants to know how far in they are. */
11
+ summary?: {
12
+ from: number;
13
+ to: number;
14
+ total: number;
15
+ };
16
+ size?: "sm" | "md";
17
+ className?: string;
18
+ [key: `data-${string}`]: unknown;
19
+ };
20
+ /**
21
+ * The page list, with gaps where the numbers were left out.
22
+ *
23
+ * Always the first and the last, always the current one and its neighbours, and an ellipsis
24
+ * standing in for the rest. Returned as data rather than rendered here so the gaps can be
25
+ * counted in a test.
26
+ *
27
+ * Always the same number of items, too — `siblings * 2 + 5`, or every page when there are
28
+ * fewer than that. The count used to depend on where the reader was standing: four items on
29
+ * page 1, five on page 2, seven in the middle. The list is centred in its row, so every one
30
+ * of those changes moved the whole row sideways, and the button a reader was aiming at was
31
+ * somewhere else by the time they reached it. Near an end the window widens instead — that
32
+ * is where the pages the reader can use are.
33
+ */
34
+ export declare function pageItems(page: number, pageCount: number, siblings?: number): (number | "gap")[];
35
+ /**
36
+ * Which page of how many.
37
+ *
38
+ * A `<nav>` with a name, because a page of results usually has two of these — one above the
39
+ * table and one below — and "navigation" twice tells a reader nothing about either.
40
+ *
41
+ * Every page in the list is a button, the current one included, and `aria-current="page"` is
42
+ * what says which. Pressing the current page does nothing — there is nowhere to go — but it
43
+ * stays a button so that pressing it is possible: as a `<span>` it left the tab order the
44
+ * instant it was clicked, which took the focus of the reader who had just clicked it with
45
+ * them. Their next Tab started at the top of the document, four pages from the list they
46
+ * were walking.
47
+ */
48
+ export declare function Pagination({ page, pageCount, onPageChange, label, siblings, summary, size, className, ...rest }: PaginationProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { Pagination, pageItems } from "./Pagination";
2
+ export type { PaginationProps } from "./Pagination";
@@ -0,0 +1,47 @@
1
+ import type { ReactElement, ReactNode } from "react";
2
+ import "./Popover.css";
3
+ export type PopoverSide = "top" | "right" | "bottom" | "left";
4
+ export type PopoverAlign = "start" | "center" | "end";
5
+ export type PopoverWidth = "auto" | "sm" | "md" | "lg";
6
+ export type PopoverProps = {
7
+ /** The control that opens it. One element, and it must be able to take focus. */
8
+ children: ReactElement;
9
+ content: ReactNode;
10
+ /**
11
+ * What the panel is. Becomes its heading and its accessible name.
12
+ *
13
+ * A popover is a `dialog` to assistive technology, and a dialog with no name is announced
14
+ * as "dialog" and nothing else — the reader is told they have arrived somewhere and not
15
+ * told where.
16
+ */
17
+ title: string;
18
+ /** Hide the heading from the screen and leave it as the name. */
19
+ titleHidden?: boolean;
20
+ description?: ReactNode;
21
+ side?: PopoverSide;
22
+ align?: PopoverAlign;
23
+ width?: PopoverWidth;
24
+ arrow?: boolean;
25
+ /** A close button in the corner. Escape always closes it either way. */
26
+ dismissible?: boolean;
27
+ open?: boolean;
28
+ defaultOpen?: boolean;
29
+ onOpenChange?: (open: boolean) => void;
30
+ className?: string;
31
+ [key: `data-${string}`]: unknown;
32
+ };
33
+ /**
34
+ * A panel anchored to a control.
35
+ *
36
+ * Radix rather than hand-rolled, for the same reasons `Tooltip` is: collision-aware
37
+ * positioning, portalling out of any ancestor with `overflow: hidden`, dismissal on Escape
38
+ * and on an outside pointer, focus moved in on open and returned to the trigger on close,
39
+ * and the rest of the page made inert to a screen reader while it is up. Every one of those
40
+ * is a place a hand-rolled popover is wrong, and none of them shows in a screenshot.
41
+ *
42
+ * What this file owns is the appearance and the name.
43
+ *
44
+ * Not a tooltip: a tooltip describes a control in a few words and cannot be interacted with.
45
+ * If the panel holds anything the reader can click or type into, it is this.
46
+ */
47
+ export declare function Popover({ children, content, title, titleHidden, description, side, align, width, arrow, dismissible, open, defaultOpen, onOpenChange, className, ...rest }: PopoverProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { Popover } from "./Popover";
2
+ export type { PopoverProps, PopoverSide, PopoverAlign, PopoverWidth } from "./Popover";
@@ -0,0 +1,43 @@
1
+ import type { ReactNode } from "react";
2
+ import "./PreferenceRow.css";
3
+ /**
4
+ * What the control on the right needs in order to be named by the text on the left.
5
+ *
6
+ * Handed over rather than cloned on, the same as `Field`. A switch with no name is announced
7
+ * as "switch, on" and a reader has no idea what is on.
8
+ */
9
+ export type PreferenceControl = {
10
+ "aria-labelledby": string;
11
+ "aria-describedby": string | undefined;
12
+ id: string;
13
+ };
14
+ export type PreferenceRowProps = {
15
+ title: ReactNode;
16
+ control: (preference: PreferenceControl) => ReactNode;
17
+ description?: ReactNode;
18
+ /** Something under the description that appears when the setting is on. */
19
+ children?: ReactNode;
20
+ icon?: ReactNode;
21
+ /**
22
+ * 아이콘이 없는 줄도 아이콘 칸을 비워 둡니다.
23
+ *
24
+ * 아이콘이 있는 줄과 없는 줄이 섞인 목록에서만 씁니다. 줄마다 자기 격자라 서로 폭을
25
+ * 맞추지 못하므로, 없는 쪽에 이걸 켜고 감싸는 요소에서 `--preference-row-lead`로 폭을
26
+ * 한 번 정합니다.
27
+ */
28
+ lead?: boolean;
29
+ /** The control goes under the text instead of beside it, for a long setting. */
30
+ stacked?: boolean;
31
+ disabled?: boolean;
32
+ className?: string;
33
+ [key: `data-${string}`]: unknown;
34
+ };
35
+ /**
36
+ * One setting: what it is, what it does, and the control that changes it.
37
+ *
38
+ * The row is not a label and does not become one. A `Switch` renders its own `<label>`, and a
39
+ * label inside a label is invalid HTML that browsers repair by choosing for themselves which
40
+ * input the outer one points at — so the text names the control by id instead, and the
41
+ * control's own hit area is the target.
42
+ */
43
+ export declare function PreferenceRow({ title, control, description, children, icon, lead, stacked, disabled, className, ...rest }: PreferenceRowProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { PreferenceRow } from "./PreferenceRow";
2
+ export type { PreferenceRowProps, PreferenceControl } from "./PreferenceRow";
@@ -0,0 +1,53 @@
1
+ import type { ReactNode } from "react";
2
+ import "./Sheet.css";
3
+ export type SheetDetent = "peek" | "half" | "full";
4
+ export type SheetProps = {
5
+ /** What the sheet is about. Named, for the same reason `Drawer`'s is. */
6
+ title: string;
7
+ children: ReactNode;
8
+ /** Which heights this sheet has, smallest first. Two is the common shape; three is the most. */
9
+ detents?: SheetDetent[];
10
+ /** Which one it is at. Controlled, because the page above it usually has an opinion. */
11
+ detent: SheetDetent;
12
+ onDetentChange: (detent: SheetDetent) => void;
13
+ /**
14
+ * The viewport, or the box it was put in.
15
+ *
16
+ * `AppShell` learned this one first: a panel with `100dvh` welded into it cannot be embedded,
17
+ * demonstrated, or put in a gallery. The decision is enumerated rather than assumed.
18
+ */
19
+ fit?: "viewport" | "container";
20
+ /** Under the body, out of the scroll — a confirm, a total, a pair of buttons. */
21
+ footer?: ReactNode;
22
+ className?: string;
23
+ [key: `data-${string}`]: unknown;
24
+ };
25
+ /**
26
+ * A panel from the bottom edge that stops at heights, over a page that keeps working.
27
+ *
28
+ * **This is not a `Drawer` with a `size` prop, and the difference is the page behind it.** A
29
+ * drawer is a dialog: it takes the focus, makes the page inert, and asks to be finished with.
30
+ * Every sheet in the reference set — Strava, Grab, Fi, Bump, Google Photos — sits over a map
31
+ * the reader is still panning, and the sheet is the *index* to that map rather than a thing
32
+ * interrupting it. Folding the two into one component would mean every use of it choosing
33
+ * between two unrelated behaviours, which is the same reason `SidePanel` and `Drawer` are two
34
+ * components.
35
+ *
36
+ * So: nothing here traps focus, nothing here goes inert, and there is no scrim. What a sheet
37
+ * has instead is heights.
38
+ *
39
+ * **The heights are enumerated and the drag between them is not.** `data-detent` is a discrete
40
+ * state and the stylesheet owns what each one is worth; `--sheet-pull` is the distance under a
41
+ * finger, which no attribute can hold. That is the third place a value may go, and this and
42
+ * `ListRow` are the two components that need it.
43
+ *
44
+ * **Only the handle drags.** A sheet whose body also dragged would be a sheet that cannot be
45
+ * scrolled: the two gestures are the same finger on the same box, and the rule that tells them
46
+ * apart — "drag the sheet only when the body is already scrolled to the top" — is a rule
47
+ * readers discover by failing at it. The handle is a target that means one thing.
48
+ *
49
+ * **The handle is a button.** It steps to the next height and says which one it will land on,
50
+ * so every detent is reachable without a pointer. A sheet that can only be resized by dragging
51
+ * is a sheet with one height for a keyboard.
52
+ */
53
+ export declare function Sheet({ title, children, detents, detent, onDetentChange, fit, footer, className, ...rest }: SheetProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { Sheet } from "./Sheet";
2
+ export type { SheetProps, SheetDetent } from "./Sheet";
@@ -0,0 +1,34 @@
1
+ import type { ReactNode } from "react";
2
+ import "./SidePanel.css";
3
+ export type SidePanelProps = {
4
+ /** What the panel is about. Required — an unnamed landmark is one a reader skips past. */
5
+ title: string;
6
+ /** A count, a status, a filter — whatever sits beside the title rather than under it. */
7
+ meta?: ReactNode;
8
+ children: ReactNode;
9
+ footer?: ReactNode;
10
+ /** Rendered only when given, so a panel that cannot be dismissed shows no button that lies. */
11
+ onClose?: () => void;
12
+ className?: string;
13
+ [key: `data-${string}`]: unknown;
14
+ };
15
+ /**
16
+ * A second column beside the work, not a layer over it.
17
+ *
18
+ * That sentence is the whole difference from `Drawer`, and it is a difference in what the
19
+ * reader is doing rather than in where the box sits. A drawer interrupts: the page behind it
20
+ * goes inert, the focus is trapped, and the reader is expected to finish and leave. A side
21
+ * panel is read *while* working — a source beside the answer it supports, the row you are
22
+ * editing beside the grid it came from — so nothing is trapped and nothing behind it is
23
+ * disabled.
24
+ *
25
+ * There is no `mode="overlay"`. It was in the plan and it collapsed on contact: a side panel
26
+ * that covers the work, traps the focus and dims what is behind is not a mode of this
27
+ * component, it is `Drawer`. What remains is the responsive fact — under `--bp-lg` there is
28
+ * no room for a second column, so the shell stacks the panel *below* the work rather than
29
+ * over it. It still pushes. It never covers.
30
+ *
31
+ * It brings no width of its own. The panel is whatever its container gives it, which is what
32
+ * lets `AppShell` own the track and this own the contents.
33
+ */
34
+ export declare function SidePanel({ title, meta, children, footer, onClose, className, ...rest }: SidePanelProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { SidePanel } from "./SidePanel";
2
+ export type { SidePanelProps } from "./SidePanel";
@@ -0,0 +1,85 @@
1
+ import type { MouseEvent, ReactNode } from "react";
2
+ import type { LucideIcon } from "lucide-react";
3
+ import "./SidebarNav.css";
4
+ export type SidebarNavItem = {
5
+ value: string;
6
+ label: string;
7
+ icon?: LucideIcon;
8
+ /** Where the item goes. Without one the item is drawn as a button rather than a link. */
9
+ href?: string;
10
+ /**
11
+ * The event is passed, so `preventDefault()` is reachable.
12
+ *
13
+ * The first version typed this `() => void`, which meant a router-driven item could not stop
14
+ * the anchor from navigating — and since the anchor fell back to `href="#"`, every click left
15
+ * a `#` on the URL that nothing the adopter could write would prevent.
16
+ */
17
+ onClick?: (event: MouseEvent<HTMLAnchorElement | HTMLButtonElement>) => void;
18
+ /** A count or a dot at the end of the row. Decorative — say what it means in the label. */
19
+ badge?: ReactNode;
20
+ disabled?: boolean;
21
+ };
22
+ export type SidebarNavGroup = {
23
+ /** Omitted for a run of items with no heading of their own. */
24
+ title?: string;
25
+ items: SidebarNavItem[];
26
+ /** The group can be folded away, and starts folded or not. */
27
+ collapsible?: boolean;
28
+ defaultOpen?: boolean;
29
+ /**
30
+ * One control at the end of the heading — "새 모음", "가져오기".
31
+ *
32
+ * A heading is where a reader looks for what to do with the whole group, and a rail with a
33
+ * "Collections" heading and no way to add one sends them to a settings page to do it. One,
34
+ * and at the end: two is a toolbar, and a toolbar wants a row of its own.
35
+ *
36
+ * Never on a collapsible heading. That heading is already a button, and a button inside a
37
+ * button is invalid HTML that browsers repair by dropping one of the two.
38
+ */
39
+ action?: ReactNode;
40
+ };
41
+ export type SidebarNavEmphasis = "soft" | "solid";
42
+ export type SidebarNavIconStyle = "bare" | "tile";
43
+ export type SidebarNavVariant = "plain" | "outlined" | "filled" | "elevated";
44
+ export type SidebarNavProps = {
45
+ groups: SidebarNavGroup[];
46
+ /** Which item the reader is on. Becomes `aria-current="page"`. */
47
+ value?: string;
48
+ /** What this navigation is. "주요 메뉴", "설정". A page has more than one `<nav>`. */
49
+ label: string;
50
+ /** Icons only, with the labels moved into tooltips. */
51
+ collapsed?: boolean;
52
+ /**
53
+ * How loudly the current item is marked.
54
+ *
55
+ * `soft` is a tinted row and reads as "you are here" among peers. `solid` fills it with the
56
+ * accent and puts the reverse ink on it, which is what a rail that is the whole navigation
57
+ * of a product needs — a tint on a page with a tinted table and a tinted badge is not the
58
+ * loudest thing on screen, and the one place a reader is standing has to be.
59
+ */
60
+ emphasis?: SidebarNavEmphasis;
61
+ /**
62
+ * Whether an icon sits on a ground of its own.
63
+ *
64
+ * `tile` is the difference between a rail and a list of words. A bare glyph beside a label
65
+ * is read as punctuation; the same glyph on a tinted square is read as the thing the row is
66
+ * about. It costs the row four pixels of height and it is why a product rail looks like one.
67
+ */
68
+ icons?: SidebarNavIconStyle;
69
+ /** How the navigation container is separated from its surroundings. */
70
+ variant?: SidebarNavVariant;
71
+ className?: string;
72
+ [key: `data-${string}`]: unknown;
73
+ };
74
+ /**
75
+ * The side of the page: groups, items, and where the reader is.
76
+ *
77
+ * `aria-current="page"` and not a class alone. A rail drawn down the left of the chosen item
78
+ * tells a reader who can see it where they are and tells everyone else nothing; the
79
+ * attribute is the part that is read.
80
+ *
81
+ * Collapsed, the labels move into tooltips *and stay in the accessibility tree*. A tooltip
82
+ * cannot be reached by touch and cannot be selected, so an item whose name exists only in
83
+ * its tooltip has no name on a phone — the visible text goes, the accessible name does not.
84
+ */
85
+ export declare function SidebarNav({ groups, value, label, collapsed, emphasis, icons, variant, className, ...rest }: SidebarNavProps): import("react").JSX.Element;
@@ -0,0 +1,2 @@
1
+ export { SidebarNav } from "./SidebarNav";
2
+ export type { SidebarNavProps, SidebarNavGroup, SidebarNavItem, SidebarNavEmphasis, SidebarNavIconStyle, SidebarNavVariant, } from "./SidebarNav";
@@ -0,0 +1,57 @@
1
+ import type { ReactNode } from "react";
2
+ import "./Spotlight.css";
3
+ export type SpotlightSide = "top" | "bottom";
4
+ export type SpotlightStep = {
5
+ /** This step's own name. Reaches the DOM as `data-step`, so a page can style or test one step. */
6
+ id: string;
7
+ /**
8
+ * The mark on the thing this step is about — `data-spotlight="filters"` on that element.
9
+ *
10
+ * A mark rather than a selector. A selector is a string that can match anything on the page,
11
+ * and the failure mode of the wrong one is a hole cut somewhere nobody meant: it does not
12
+ * throw, it just highlights the wrong thing. A mark is opt-in on the target, greppable, and
13
+ * a step whose mark is not on the page is a step this component can see is unanchored.
14
+ */
15
+ target: string;
16
+ title: string;
17
+ body?: ReactNode;
18
+ side?: SpotlightSide;
19
+ };
20
+ export type SpotlightProps = {
21
+ steps: SpotlightStep[];
22
+ /** Which step, by index. `null` is closed. Controlled, because a tour is the page's state. */
23
+ step: number | null;
24
+ onStepChange: (step: number | null) => void;
25
+ /** What the tour is. "새 기능 안내". Names the dialog. */
26
+ label: string;
27
+ /** The last step's button. "완료", "시작하기". */
28
+ finishLabel?: string;
29
+ className?: string;
30
+ [key: `data-${string}`]: unknown;
31
+ };
32
+ /**
33
+ * One thing on the page, lit, with a sentence about it.
34
+ *
35
+ * **The counter is not decoration.** Three of the five reference screens print "3 of 3" or
36
+ * "2/3", and the two that did not are the ones that feel endless. A coach mark is an
37
+ * interruption the reader did not ask for, and an interruption is bearable exactly as long as
38
+ * its end is visible. So the count is required — there is no prop to turn it off.
39
+ *
40
+ * **The hole is measured, and the measurement is the third place a value may go.** An
41
+ * arbitrary element's rectangle is four numbers that cannot be enumerated and have no element
42
+ * attribute to live in, so the component writes them as its own custom properties and the
43
+ * stylesheet decides what to do with them. Nothing here paints from a `style` attribute.
44
+ *
45
+ * **The scrim takes the presses.** Every reference dims the page and none of them lets the
46
+ * highlighted control be used — a coach mark explains, and a reader who can press the thing
47
+ * being explained is a reader halfway into a flow the tour was about to describe. Escape
48
+ * leaves, which is the same door the skip button opens.
49
+ *
50
+ * **And because the scrim takes the presses, the focus has to stay off the page.** The bubble
51
+ * is `aria-modal`, which tells a screen reader that everything outside it is hidden; a Tab that
52
+ * walked out of it landed on controls the scrim will not let anyone press, so the reading order
53
+ * and the focus disagreed and the keyboard reader was the one left holding nothing. Focus moves
54
+ * into the bubble when a step opens, cycles inside it, and goes back to whatever opened the tour
55
+ * when it closes.
56
+ */
57
+ export declare function Spotlight({ steps, step, onStepChange, label, finishLabel, className, ...rest }: SpotlightProps): import("react").JSX.Element | null;
@@ -0,0 +1,2 @@
1
+ export { Spotlight } from "./Spotlight";
2
+ export type { SpotlightProps, SpotlightStep, SpotlightSide } from "./Spotlight";