@invoiceonline/ui-react 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,194 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as SkeletonStories from './Skeleton.stories';
3
+
4
+
5
+ <Meta of={SkeletonStories} tags={['autodocs']} />
6
+
7
+ # Skeleton
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** stable
13
+ - **Tokens used:** `--bg-skeleton`, `--radius-200`, `--radius-full`, `--space-1000`, `--space-600`
14
+ - **Manifest version:** `1.3.2`
15
+
16
+ ## Overview
17
+
18
+ Skeleton is a loading placeholder — the block that stands in for content that has not arrived yet. Render one while real content is being fetched, in the shape and roughly the size of what will replace it, so the layout does not jump when it lands. Reach for it when the wait is long enough to notice **and** the shape of the result is known in advance: a list of rows, a card grid, an avatar plus two lines of text.
19
+
20
+ Do not use it as a spinner and do not use it as an empty state. A spinner says only that something is happening; a Skeleton says *where* the content will be. An empty state is a final answer; a Skeleton is a wait. Never use one to represent an error or an empty result, and never leave one on screen after the content resolves.
21
+
22
+ ## Rationale
23
+
24
+ A Skeleton reserves the space its content is about to occupy, so the page does not reflow when the data lands. Everything else about the wait belongs to the region around it: the placeholder itself is decorative, and the fill, the radius and the pulse are all it has. That narrowness is deliberate — it is why several Skeletons can be composed into the placeholder for a whole region without any of them claiming to be the region.
25
+
26
+ ## Anatomy
27
+
28
+ A single element. No children, no border, no text, no icon.
29
+
30
+ - **Block** — the placeholder itself. Fill <code>--bg-skeleton</code>, radius per shape. The fill sits at the same weight as the system's neutral hairline, so a placeholder never reads louder than the chrome it stands inside.
31
+ - **Pulse** — a looping opacity fade on the same element, held symmetric. The loop runs on <code>--duration-pulse</code> (2 s) and <code>--easing-standard</code>, infinite (manifest 1.3.2 <code>motion.loop</code>).
32
+ - **Size** — not part of the component. The consumer sets it, in px; each shape carries a default that applies when nothing is set.
33
+
34
+ Sibling placeholders in one region pulse **in sync, on one clock**. Staggering them turns a wait into an animation that travels down the page and pulls the eye along it.
35
+
36
+ Only one fill is specified, for skeletons on <code>--bg-primary</code> and on the <code>--bg-secondary</code> app shell. A Skeleton rendered on <code>--bg-inverse</code> chrome is not specified.
37
+
38
+ ## Variants
39
+
40
+ <Canvas of={SkeletonStories.Variants} />
41
+
42
+ One axis, three values (Figma calls it *Shape*).
43
+
44
+ <table>
45
+ <thead>
46
+ <tr><th>Variant</th><th>Stands in for</th><th>Radius</th><th>Default size</th></tr>
47
+ </thead>
48
+ <tbody>
49
+ <tr><td><code>text</code></td><td>a line of copy</td><td><code>--radius-200</code></td><td>300 × 16</td></tr>
50
+ <tr><td><code>circle</code></td><td>an avatar or a round marker</td><td><code>--radius-full</code></td><td>40 × 40 (square)</td></tr>
51
+ <tr><td><code>block</code></td><td>an image, a card, or any rectangular area</td><td><code>--radius-200</code></td><td>300 × 80</td></tr>
52
+ </tbody>
53
+ </table>
54
+
55
+ The fill is <code>--bg-skeleton</code> for all three; only the radius and the default size move along the axis.
56
+
57
+ A <code>block</code> may step its radius per instance when the content it stands in for has softer corners. <code>text</code> and <code>circle</code> do not step.
58
+
59
+ ## Sizes
60
+
61
+ <Canvas of={SkeletonStories.Matrix} />
62
+
63
+ There is **no size axis**. Every instance is sized by its consumer, in px, to match the content it replaces — a placeholder of the wrong size still lets the layout jump when the real content lands, which is the only reason to render one.
64
+
65
+ <table>
66
+ <thead>
67
+ <tr><th>Case</th><th>Behaviour</th></tr>
68
+ </thead>
69
+ <tbody>
70
+ <tr><td>Unsized</td><td>Renders the per-shape default, never zero. Width may be handed to the container (<code>className="w-full"</code>); <strong>height always resolves</strong>, because a height-filling placeholder inside an auto-height parent collapses to nothing and the wait shows as a gap.</td></tr>
71
+ <tr><td><code>circle</code></td><td>Constrains to a square — height follows width via <code>aspect-square</code>, so widening it keeps it round. Stretched into a line it is a pill, which reads as <code>text</code> and defeats the shape it was chosen for.</td></tr>
72
+ <tr><td>Consumer-set</td><td>Any <code>{'w-*'}</code> / <code>{'h-*'}</code> class on <code>className</code> replaces the default (tailwind-merge resolves the conflict).</td></tr>
73
+ </tbody>
74
+ </table>
75
+
76
+ ## States
77
+
78
+ <Canvas of={SkeletonStories.States} />
79
+
80
+ Skeleton has **no states**. It takes no input, holds no focus, and has no lifecycle of its own beyond being replaced by the content it stands in for — it is either rendered or it is not.
81
+
82
+ The one thing that varies at rest is motion, and it varies with the reader's OS setting rather than with a prop:
83
+
84
+ - **Default** — a symmetric opacity pulse, 1 → 0.5 → 1, over one <code>--duration-pulse</code> (2 s) loop on <code>--easing-standard</code>.
85
+ - **`prefers-reduced-motion: reduce`** — the pulse is **reduced, not stopped**. The loop keeps its clock and only the opacity range shallows. The pulse is what says "loading"; a placeholder frozen at rest is indistinguishable from a stalled one.
86
+
87
+ ## API
88
+
89
+ <Controls />
90
+
91
+ ## Do / Don't
92
+
93
+ - ✅ Match the shape **and** the size of the real content
94
+ - ✅ Compose several Skeletons to mirror the structure of the region
95
+ - ✅ Skeleton the **content** that is loading
96
+ - ✅ Announce the load once per region, and announce it resolving
97
+ - ✅ Keep sibling placeholders on one clock
98
+ - ✅ Swap the Skeleton out the moment the content resolves
99
+ - ✅ Use an empty state for "there is nothing", an error state for "it failed"
100
+ - ❌ Don't ship a generic grey box that reserves the wrong space
101
+ - ❌ Don't render one large `block` where the content is a list of rows
102
+ - ❌ Don't skeleton chrome — a border, a divider, or a control that is already interactive
103
+ - ❌ Don't rely on `aria-busy` alone, or let each placeholder announce itself
104
+ - ❌ Don't nest the `role="status"` node inside the `aria-busy` container — busy silences its own subtree
105
+ - ❌ Don't stagger the pulse down the page with an `animation-delay`
106
+ - ❌ Don't leave one on screen as a decorative texture
107
+ - ❌ Don't reuse a Skeleton to represent an empty result or an error
108
+
109
+ ## Accessibility
110
+
111
+ - **Keyboard** — none. Skeleton takes no input and never enters the tab order.
112
+ - **ARIA** — every Skeleton carries <code>aria-hidden="true"</code>. It has no role and no accessible name; the component sets this itself and it is not overridable in practice.
113
+ - **Screen reader** — the load is carried by a single visually-hidden <code>role="status"</code> (<code>aria-live="polite"</code>) text node **per loading region**, holding the consumer's own localised string. This package ships **no region wrapper**: the consumer marks its own container. A screen-reader user hears one announcement for the region, never a list of empty blocks.
114
+ - **`aria-busy` never alone** — it may ride on the container while the region is pending, but it is a state and not a message: it suppresses mutation announcements, and screen readers do not reliably speak it. On its own it ships no announcement at all.
115
+ - **`aria-busy` and the status node are siblings, never parent and child** — `aria-busy="true"` means *"hold back announcements from this subtree until I am done"*, which is the whole reason it is set. Nest the <code>role="status"</code> node inside the busy container and the one announcement the region has is suppressed for exactly the stretch it is supposed to speak; the reader then hears the wait only once it is already over, if at all. Put the status node **next to** the container that carries <code>aria-busy</code>. A region with no wrapper of its own may drop <code>aria-busy</code> altogether — it is a state, not a message, and the status text announces on its own.
116
+ - **Announce the end of the wait** — clear <code>aria-busy</code> and swap the status text when the content resolves. A reader who heard the wait begin and never hears it end has no way to know the content arrived.
117
+ - **Contrast** — the fill sits under the 3:1 non-text minimum, accepted on the same ground already recorded for <code>--outline-default</code>, which is the identical primitive: it is **never the sole cue**. The placeholder is non-interactive, hidden from assistive tech, and always paired with the live-region announcement. Do not darken the fill to clear the bar — that would make a placeholder louder than the content it stands in for.
118
+ - **Reduced motion** — the pulse is reduced, not stopped (see States). It is essential motion, preserved at lower intensity.
119
+ - **Flash safety** — the fade is shallow and the cycle slow, so a dense grid of placeholders reads as calm rather than strobing, nowhere near a flash threshold.
120
+
121
+ ## Usage
122
+
123
+ ```tsx
124
+ // Good — the region announces itself once; the placeholders stay decorative.
125
+ // The status node is a SIBLING of the aria-busy container, never a child of it:
126
+ // busy holds back announcements from its own subtree, so a status node inside it
127
+ // would be silenced for exactly as long as it has something to say.
128
+ {loading ? (
129
+ <>
130
+ <span className="sr-only" role="status" aria-live="polite">{t('invoices.loading')}</span>
131
+ <div aria-busy="true">
132
+ {[1, 2, 3].map(i => (
133
+ <div key={i} className="flex items-center gap-400">
134
+ <Skeleton variant="circle" />
135
+ <div className="flex flex-1 flex-col gap-200">
136
+ <Skeleton className="w-3/4" />
137
+ <Skeleton className="w-1/2" />
138
+ </div>
139
+ </div>
140
+ ))}
141
+ </div>
142
+ </>
143
+ ) : (
144
+ <InvoiceList invoices={invoices} />
145
+ )}
146
+ ```
147
+
148
+ ```tsx
149
+ // Good — width handed to the container, height left to the shape default
150
+ <Skeleton variant="block" className="w-full" />
151
+
152
+ // Don't — one big block where the content is a list of rows
153
+ <Skeleton variant="block" className="h-[400px] w-full" />
154
+
155
+ // Don't — aria-busy alone ships no announcement
156
+ <div aria-busy="true">
157
+ <Skeleton />
158
+ </div>
159
+
160
+ // Don't — the status node nested inside the busy container: aria-busy suppresses
161
+ // announcements from its own subtree, so this region announces nothing while it waits
162
+ <div aria-busy="true">
163
+ <span className="sr-only" role="status">{t('invoices.loading')}</span>
164
+ <Skeleton />
165
+ </div>
166
+
167
+ // Don't — staggering pulls the eye down the page
168
+ <Skeleton style={{ animationDelay: '150ms' }} />
169
+ ```
170
+
171
+ ## Related
172
+
173
+ - [Divider](?path=/docs/design-system-atoms-divider--docs) — the other static, decorative atom; separates content rather than standing in for it.
174
+ - [Badge](?path=/docs/design-system-atoms-badge--docs) — for a resolved status; a Skeleton is a wait, never a result.
175
+ - Spec: `spec/03-atoms/skeleton.md`
176
+
177
+ ## Migration notes
178
+
179
+ Skeleton already shipped in Storybook before the spec landed; this pair replaces that implementation. Three deltas:
180
+
181
+ <table>
182
+ <thead>
183
+ <tr><th>Before</th><th>Now</th><th>Why</th></tr>
184
+ </thead>
185
+ <tbody>
186
+ <tr><td>Fill <code>bg-gray-100</code> (Tailwind stock grey)</td><td>Fill <code>bg-background-skeleton</code> (<code>--bg-skeleton</code>)</td><td>The one code change the spec asks for. Existing placeholders become slightly more visible.</td></tr>
187
+ <tr><td>No shape prop — every instance hand-built from <code>className</code></td><td><code>variant="text" | "circle" | "block"</code>, each with a default size and radius</td><td>The manifest models Shape as <code>axes.variant</code>, so it becomes a prop. An unsized Skeleton is now always visible instead of collapsing to zero height.</td></tr>
188
+ <tr><td><code>animate-pulse</code> (Tailwind's own curve, its own clock)</td><td><code>animate-skeleton-pulse</code> on <code>--easing-standard</code>, reduced under <code>prefers-reduced-motion</code></td><td>Tailwind's <code>animate-pulse</code> ignores <code>prefers-reduced-motion</code> and is bound to a curve outside the system.</td></tr>
189
+ </tbody>
190
+ </table>
191
+
192
+ **Manifest 1.3.1 → 1.3.2 — motion audit (2026-11-03).** The pulse is now `motion.loop` and binds the `--duration-pulse` token (ui-system 0.16.0+) instead of the raw `calc(var(--duration-normal) * 10)`; same 2 s, same curve, same reduced-motion softening. No change to the component — the `animate-skeleton-pulse` / `-reduced` utilities (previously in a consuming app's `tailwind.config.js`, now in this package's `styles/theme.generated.css`) moved to the token.
193
+
194
+ The old API is a **subset** of the new one: `<Skeleton className="h-4 w-full" />` still works unchanged, because `className` wins over the shape default through tailwind-merge. Migrating a call site means replacing hand-rolled shape classes with the matching variant — `rounded-full` on a square becomes `variant="circle"`, a hand-sized image block becomes `variant="block"`.
@@ -0,0 +1,260 @@
1
+ import React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Skeleton } from './Skeleton';
4
+ import { Section, Showcase } from '../../storybook/Section';
5
+ import { componentDoc } from '../../storybook/componentDoc';
6
+
7
+ const VARIANTS = ['text', 'circle', 'block'] as const;
8
+
9
+ /**
10
+ * The announcement is the CONSUMER's, not the atom's — this package ships no region
11
+ * wrapper on purpose. Every story that shows a realistic loading region marks its own
12
+ * container the way an app should: `aria-busy` while pending PLUS a single
13
+ * visually-hidden `role="status"` node carrying the localised string. `aria-busy` alone
14
+ * is a state and not a message, and screen readers do not reliably speak it.
15
+ *
16
+ * The two are SIBLINGS, never parent and child (skeleton 1.3.1 § Accessibility):
17
+ * `aria-busy` exists to hold back announcements from its own subtree until the wait
18
+ * ends, so a status node nested inside it would be silenced for exactly the stretch it
19
+ * has something to say. A region with no wrapper of its own to carry `aria-busy` may
20
+ * drop it entirely — the status text still announces on its own.
21
+ */
22
+ function LoadingRegion({
23
+ label,
24
+ children,
25
+ }: {
26
+ label: string;
27
+ children: React.ReactNode;
28
+ }) {
29
+ return (
30
+ <>
31
+ <span className="sr-only" role="status" aria-live="polite">
32
+ {label}
33
+ </span>
34
+ <div aria-busy="true">{children}</div>
35
+ </>
36
+ );
37
+ }
38
+
39
+ const meta = {
40
+ title: 'Design System/Atoms/Skeleton',
41
+ component: Skeleton,
42
+ parameters: {
43
+ layout: 'padded',
44
+ docs: {
45
+ description: {
46
+ component: componentDoc({
47
+ summary:
48
+ 'A loading placeholder — the block that stands in for content that has not arrived yet. One element: fill --bg-skeleton, radius per shape (--radius-200 for Text and Block, --radius-full for Circle), and a symmetric 2 s opacity pulse on --easing-standard. Three shapes on one axis; no size axis and no states.',
49
+ useCases: [
50
+ '`text` — a line of copy (default 300 x 16)',
51
+ '`circle` — an avatar or a round marker (default 40 x 40, constrained square)',
52
+ '`block` — an image, a card, or any rectangular area (default 300 x 80)',
53
+ 'Composed — a Circle plus two Text lines for a user row; a Block plus a Text line for a card',
54
+ ],
55
+ bestPractices: [
56
+ 'Match the shape AND the size of the real content — a placeholder that reserves the wrong space still lets the layout jump',
57
+ 'Compose several Skeletons to mirror the structure of the region, not one large Block over a list of rows',
58
+ 'Skeleton the content, never the chrome — not a border, a divider, or a control that is already interactive',
59
+ 'Announce the load once per region with a visually-hidden role="status" node NEXT TO the aria-busy container, never inside it, and announce it resolving; never rely on aria-busy alone',
60
+ 'Keep sibling placeholders on one clock — never stagger the pulse with an animation-delay',
61
+ 'Use an empty state for "there is nothing" and an error state for "it failed" — never a Skeleton',
62
+ ],
63
+ knownIssues: [
64
+ 'The fill sits under the 3:1 non-text contrast minimum — accepted on the same ground already recorded for --outline-default, because a placeholder is non-interactive, aria-hidden, and never the sole cue. Do not darken it.',
65
+ 'The 2 s loop is the one raw value in the spec: the semantic --duration-* steps top out at 300 ms because they describe transitions, not loops. It is written as calc(var(--duration-normal) * 10) so it still moves with the scale.',
66
+ ],
67
+ docsLink: {
68
+ label: 'spec/03-atoms/skeleton.md',
69
+ },
70
+ }),
71
+ },
72
+ },
73
+ },
74
+ } satisfies Meta<typeof Skeleton>;
75
+
76
+ export default meta;
77
+ type Story = StoryObj<typeof meta>;
78
+
79
+ export const Playground: Story = {
80
+ args: {
81
+ variant: 'text',
82
+ },
83
+ argTypes: {
84
+ variant: { control: 'inline-radio', options: VARIANTS },
85
+ className: { control: 'text' },
86
+ },
87
+ };
88
+
89
+ /**
90
+ * Rows = the Shape axis, columns = the two sizings the spec distinguishes: the per-shape
91
+ * default that applies when the consumer sets nothing, and a consumer-set size. There is
92
+ * no size axis to put on the column axis — every instance is sized in px to match the
93
+ * content it replaces.
94
+ */
95
+ export const Matrix: Story = {
96
+ parameters: {
97
+ docs: {
98
+ description: {
99
+ story:
100
+ 'The full Shape axis against the only sizing distinction the spec makes: per-shape default vs. consumer-set. An unsized Skeleton is never zero.',
101
+ },
102
+ },
103
+ },
104
+ render: () => (
105
+ <div className="grid grid-cols-[auto_1fr_1fr] items-center gap-x-800 gap-y-600">
106
+ <span />
107
+ <span className="text-body-sm font-semibold text-text-secondary">Default (unsized)</span>
108
+ <span className="text-body-sm font-semibold text-text-secondary">Consumer-set</span>
109
+
110
+ {VARIANTS.map(variant => (
111
+ <React.Fragment key={variant}>
112
+ <span className="text-body-sm font-medium">{variant}</span>
113
+ <Skeleton variant={variant} />
114
+ <Skeleton
115
+ variant={variant}
116
+ className={
117
+ variant === 'circle'
118
+ ? 'w-1200'
119
+ : variant === 'text'
120
+ ? 'h-500 w-full'
121
+ : 'h-[calc(var(--space-1000)*3)] w-full'
122
+ }
123
+ />
124
+ </React.Fragment>
125
+ ))}
126
+ </div>
127
+ ),
128
+ };
129
+
130
+ /**
131
+ * Skeleton has NO states — it takes no input, holds no focus, and has no lifecycle of
132
+ * its own beyond being replaced. The only thing that varies at rest is the motion, and
133
+ * that varies with the READER's setting rather than with a prop, so both rows are
134
+ * rendered statically with the class the media query would apply.
135
+ */
136
+ export const States: Story = {
137
+ parameters: {
138
+ docs: {
139
+ description: {
140
+ story:
141
+ 'Skeleton has no interaction states. The one axis that moves at rest is motion: under `prefers-reduced-motion: reduce` the pulse is REDUCED, not stopped — the loop keeps its clock and only the opacity range shallows, because the pulse is the only signal that anything is coming. Both rows below are painted with the bare animation class so the difference is visible regardless of your OS setting.',
142
+ },
143
+ },
144
+ },
145
+ render: () => (
146
+ <Showcase>
147
+ <Section title="Default motion" layout="column">
148
+ <div className="block h-600 w-[calc(var(--space-1000)*7.5)] animate-skeleton-pulse rounded-200 bg-background-skeleton" />
149
+ </Section>
150
+ <Section
151
+ title="Reduced motion (prefers-reduced-motion: reduce)"
152
+ description="Same 2 s clock, shallower opacity range — reduced, never stopped."
153
+ layout="column"
154
+ >
155
+ <div className="block h-600 w-[calc(var(--space-1000)*7.5)] animate-skeleton-pulse-reduced rounded-200 bg-background-skeleton" />
156
+ </Section>
157
+ <Section
158
+ title="In sync, on one clock"
159
+ description="Sibling placeholders share the loop. Staggering them turns a wait into an animation that travels down the page."
160
+ layout="column"
161
+ >
162
+ <Skeleton className="w-full" />
163
+ <Skeleton className="w-full" />
164
+ <Skeleton className="w-full" />
165
+ </Section>
166
+ </Showcase>
167
+ ),
168
+ };
169
+
170
+ export const Variants: Story = {
171
+ parameters: {
172
+ docs: {
173
+ description: {
174
+ story:
175
+ 'One axis, three values. Pick the Shape that matches the real content. A Block may step its radius per instance when the content it stands in for has softer corners; Text and Circle do not step.',
176
+ },
177
+ },
178
+ },
179
+ render: () => (
180
+ <Showcase>
181
+ <Section title="Text — a line of copy" layout="column">
182
+ <Skeleton variant="text" />
183
+ </Section>
184
+ <Section title="Circle — an avatar or a round marker" description="Constrains to a square: height follows width.">
185
+ <Skeleton variant="circle" />
186
+ <Skeleton variant="circle" className="w-1200" />
187
+ <Skeleton variant="circle" className="w-[calc(var(--space-1200)*1.5)]" />
188
+ </Section>
189
+ <Section
190
+ title="Block — an image, a card, or any rectangular area"
191
+ description="Radius --radius-200 is canonical; a Block may step it when the real content has softer corners."
192
+ >
193
+ <Skeleton variant="block" />
194
+ <Skeleton variant="block" className="rounded-500" />
195
+ </Section>
196
+ </Showcase>
197
+ ),
198
+ };
199
+
200
+ export const Compositions: Story = {
201
+ parameters: {
202
+ docs: {
203
+ description: {
204
+ story:
205
+ 'Several Skeletons compose the placeholder for a whole region, mirroring the structure of what is coming. Each region marks itself — `aria-busy` plus ONE visually-hidden `role="status"` node **beside** it, never inside it — because the atom is decorative and this package ships no wrapper.',
206
+ },
207
+ },
208
+ },
209
+ render: () => (
210
+ <Showcase>
211
+ <Section title="User rows — a Circle plus two Text lines" layout="column">
212
+ <LoadingRegion label="Loading users">
213
+ <div className="flex w-[calc(var(--space-1000)*10)] flex-col gap-500">
214
+ {[1, 2, 3].map(i => (
215
+ <div key={i} className="flex items-center gap-400">
216
+ <Skeleton variant="circle" />
217
+ <div className="flex flex-1 flex-col gap-200">
218
+ <Skeleton className="w-3/4" />
219
+ <Skeleton className="w-1/2" />
220
+ </div>
221
+ </div>
222
+ ))}
223
+ </div>
224
+ </LoadingRegion>
225
+ </Section>
226
+
227
+ <Section title="Card — a Block plus a title and two lines" layout="column">
228
+ <LoadingRegion label="Loading card">
229
+ <div className="flex w-[calc(var(--space-1000)*8.75)] flex-col gap-400 rounded-300 border border-outline-default p-600">
230
+ <Skeleton variant="block" className="w-full" />
231
+ <div className="flex flex-col gap-300">
232
+ <Skeleton className="w-3/4" />
233
+ <Skeleton className="w-full" />
234
+ <Skeleton className="w-5/6" />
235
+ </div>
236
+ </div>
237
+ </LoadingRegion>
238
+ </Section>
239
+
240
+ <Section title="Table — a header row plus body rows" layout="column">
241
+ <LoadingRegion label="Loading table">
242
+ <div className="flex w-[calc(var(--space-1000)*15)] flex-col gap-400">
243
+ <div className="flex gap-400 border-b border-outline-default pb-400">
244
+ {[1, 2, 3, 4].map(i => (
245
+ <Skeleton key={i} className="w-1/4" />
246
+ ))}
247
+ </div>
248
+ {[1, 2, 3, 4].map(row => (
249
+ <div key={row} className="flex gap-400">
250
+ {[1, 2, 3, 4].map(col => (
251
+ <Skeleton key={col} className="w-1/4" />
252
+ ))}
253
+ </div>
254
+ ))}
255
+ </div>
256
+ </LoadingRegion>
257
+ </Section>
258
+ </Showcase>
259
+ ),
260
+ };
@@ -0,0 +1,107 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
4
+ import { cn } from '../../internal/utils';
5
+
6
+ /**
7
+ * Skeleton — a loading placeholder. The block that stands in for content that has
8
+ * not arrived yet, drawn in the shape and roughly the size of what will replace it,
9
+ * so the layout does not jump when the real content lands.
10
+ *
11
+ * It is NOT a spinner (a spinner says only that something is happening; a skeleton
12
+ * says WHERE the content will be) and NOT an empty state (an empty state is a final
13
+ * answer; a skeleton is a wait). Never use one for an error or an empty result, and
14
+ * never leave one on screen after the content resolves.
15
+ *
16
+ * Anatomy (upstream spec `03-atoms/skeleton.md`) — a single element, no children:
17
+ * - fill `--bg-skeleton`, at the same weight as the system's neutral hairline, so a
18
+ * placeholder never reads louder than the chrome it stands inside;
19
+ * - radius per shape — `--radius-200` for Text and Block, `--radius-full` for Circle;
20
+ * - a looping, symmetric opacity pulse on `--easing-standard`.
21
+ *
22
+ * Sizing is the consumer's, in px. Each shape carries a default (manifest
23
+ * `chrome.defaults`) that applies when nothing is set, so an unsized Skeleton is
24
+ * always visible — never zero. Width may be handed to the container (`className="w-full"`);
25
+ * HEIGHT always resolves, because a height-filling placeholder inside an auto-height
26
+ * parent collapses to nothing and the wait shows as a gap.
27
+ *
28
+ * Accessibility — the placeholder is decorative and always `aria-hidden`. The load is
29
+ * announced by the CONSUMER, once per loading region, via a visually-hidden
30
+ * `role="status"` (`aria-live="polite"`) text node carrying its own localised string.
31
+ * This package deliberately ships no region wrapper. `aria-busy="true"` may ride on
32
+ * that container while pending, but never alone: it is a state, not a message, and
33
+ * screen readers do not reliably speak it. The status node and the busy container are
34
+ * SIBLINGS, never parent and child (1.3.1) — `aria-busy` holds back announcements from
35
+ * its own subtree, so a status node nested inside it is silenced for exactly the stretch
36
+ * it has something to say; a region with no wrapper of its own may omit `aria-busy`
37
+ * entirely. Clear it and swap the status text when the content resolves, so the reader
38
+ * hears the wait end as well as begin.
39
+ *
40
+ * Sibling placeholders in one region pulse IN SYNC, on one clock — never stagger them
41
+ * with an animation-delay, which turns a wait into an animation that travels down the
42
+ * page and pulls the eye along it.
43
+ *
44
+ * Colour tokens are mapped 1:1 from the design system — no hardcoded values.
45
+ */
46
+ const skeletonVariants = tv({
47
+ // The pulse is reduced, not stopped, under prefers-reduced-motion — it is the only
48
+ // signal that anything is coming (spec → Accessibility § Reduced motion).
49
+ // No `shrink-0`: a placeholder inside a flex row must be able to give way exactly
50
+ // like the content it stands in for, or the wait overflows where the real thing
51
+ // would have wrapped. Consumers that need a fixed avatar add it themselves.
52
+ base: 'bg-background-skeleton animate-skeleton-pulse motion-reduce:animate-skeleton-pulse-reduced',
53
+ variants: {
54
+ variant: {
55
+ // 300 x 16 — a line of body copy. 300px = --space-1000 (40) x 7.5.
56
+ text: 'w-[calc(var(--space-1000)*7.5)] h-600 rounded-200',
57
+ // 40 x 40 — an avatar. No height class: `aspect-square` makes the height follow
58
+ // the width, so a consumer that widens the circle keeps it round. A Circle
59
+ // stretched to a line is a pill, which reads as Text.
60
+ circle: 'w-1000 aspect-square rounded-full',
61
+ // 300 x 80 — an image or card area. 80px = --space-1000 (40) x 2.
62
+ block: 'w-[calc(var(--space-1000)*7.5)] h-[calc(var(--space-1000)*2)] rounded-200',
63
+ },
64
+ },
65
+ defaultVariants: {
66
+ variant: 'text',
67
+ },
68
+ });
69
+
70
+ export type SkeletonVariant = 'text' | 'circle' | 'block';
71
+
72
+ export interface SkeletonProps
73
+ extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>,
74
+ VariantProps<typeof skeletonVariants> {
75
+ /**
76
+ * Shape of the content the placeholder stands in for.
77
+ * - `text` — a line of copy (default 300 x 16).
78
+ * - `circle` — an avatar or a round marker (default 40 x 40, constrained square).
79
+ * - `block` — an image, a card, or any rectangular area (default 300 x 80).
80
+ *
81
+ * Pick the shape that matches the real content; compose several Skeletons to mirror
82
+ * the structure of a whole region.
83
+ */
84
+ variant?: SkeletonVariant;
85
+ }
86
+
87
+ const Skeleton = React.forwardRef<HTMLDivElement, SkeletonProps>(
88
+ ({ className, variant = 'text', ...props }, ref) => (
89
+ <div
90
+ ref={ref}
91
+ className={cn(skeletonVariants({ variant }), className)}
92
+ // Before the spread, so a host that composes Skeleton into a larger part can
93
+ // re-label it — the FODS marker convention.
94
+ data-fods-component="skeleton"
95
+ data-fods-part="root"
96
+ {...props}
97
+ // AFTER the spread on purpose. A skeleton is a placeholder for content that is
98
+ // not there yet, so it must never reach the a11y tree — the announcement
99
+ // belongs to the consumer's `role="status"` node, and `aria-hidden` here is a
100
+ // contract, not a default a caller may switch off.
101
+ aria-hidden="true"
102
+ />
103
+ ),
104
+ );
105
+ Skeleton.displayName = 'Skeleton';
106
+
107
+ export { Skeleton, skeletonVariants };
@@ -0,0 +1 @@
1
+ export { Skeleton, skeletonVariants, type SkeletonProps, type SkeletonVariant } from './Skeleton';