@invoiceonline/ui-react 0.0.0 → 0.2.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 (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  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-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,378 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as SubjectLookupFieldStories from './SubjectLookupField.stories';
3
+
4
+ <Meta of={SubjectLookupFieldStories} tags={['autodocs']} />
5
+
6
+ # SubjectLookupField
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** `draft` (the spec is `draft` too)
12
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--bg-readonly`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--font-weight-semibold`, `--icon-brand`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--secondary`, `--secondary-active`, `--size-icon`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-link`, `--text-link-hover`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
13
+ - **Manifest version:** `2.3.1`
14
+ - **Storybook id:** `design-system-molecules-subjectlookupfield`
15
+ - **Last updated:** 2026-11-17
16
+
17
+ ## Overview
18
+
19
+ Use a **SubjectLookupField** wherever the user must **identify a Czech business subject** and have its
20
+ identity filled in for them — a customer (`Odběratel`) or a supplier
21
+ (`Dodavatel`). One query searches the user's **saved contacts and the business registry (ARES) at once**,
22
+ and picking a result hands the subject to the host, which autofills the identity block (name · IČO · DIČ ·
23
+ address) so nothing is retyped.
24
+
25
+ Do **not** use it for a type-to-narrow pick with **no registry autofill** (→ **ComboboxField** /
26
+ **Combobox**), a fixed set small enough to scan (→ **SelectField**), or short free-form text
27
+ (→ **TextField**). The signal is *"the answer exists in a registry and should arrive filled in"*.
28
+
29
+ **One component, two spec sources.** The trigger follows the manifest `subject-lookup-field` 2.1.0;
30
+ the panel it opens follows the **Subject Lookup** composition in `popover-patterns.md`. In the spec the panel
31
+ is a composition, not a component — here it is composed **inside** SubjectLookupField from
32
+ `AnchoredPanel` + `ListRow` + `Divider` (and `BottomSheet` below `sm`), the same way `Combobox` composes
33
+ its own, so a host gets one component.
34
+
35
+ **The host owns the data.** It debounces `query`, runs the contacts and registry searches, caps each group
36
+ and passes `groups` + `loading`. The component owns the field flow, the trailing group, the single status
37
+ node, the panel and the ↑/↓ ring.
38
+
39
+ <Canvas of={SubjectLookupFieldStories.Playground} />
40
+
41
+ ## Rationale
42
+
43
+ SubjectLookupField is the trigger for the one search in the product that ends in **autofill**: the user
44
+ types a fragment of a name or an IČO, and the chosen result fills the subject's identity block. The
45
+ constraint that shapes the rest of the component is that **a committed subject never rests in this field**
46
+ — on pick the field collapses and the subject summary card takes its place — so the component owns the
47
+ search only: it has no Selected state, and its clear `×` clears the query, never a subject.
48
+
49
+ ## Anatomy
50
+
51
+ The trigger is the **Text Field shell** (`textFieldShellVariants` / `textFieldValueVariants`, `md`), so a
52
+ shell fix lands here too. Part names below are the `data-fods-part` markers the FODS verifier measures.
53
+
54
+ - **Shell** (`root`) — outlined frame on `--bg-primary`, 1px border (`--border-width-100`), radius
55
+ `--radius-400`, horizontal padding `--space-500`. The surface is always `--bg-primary`.
56
+ - **Floating label** (`label`, optional) — rendered by `Field` when you pass `label`. `--text-secondary`;
57
+ `--status-success-tint-foreground` in Found only; `--status-danger` while the host passes `error`.
58
+ - **Helper** (`helper`, optional) — `helperText`, the shell's helper line in `--text-secondary`. Host
59
+ content, never a search outcome. While the host passes `error` it carries that message in
60
+ `--status-danger` instead (manifest `parts.helper.host-error`).
61
+ - **Input** (`value`) — a native `<input type="text" role="combobox" aria-autocomplete="list">`; the typed
62
+ query in `--text-primary`, the placeholder in `--text-placeholder`. **No leading glyph.**
63
+ - **Trailing group** — two positions, `--space-400` apart, every glyph in the `--size-icon` (24) box:
64
+ - **State glyph** (`trailing-state`, left) — `magic-wand` (`--icon-brand`) in Focused (empty) with the
65
+ panel open, `spinner` (`--text-secondary`) in Searching, the `check-circle` (`--status-success-solid`)
66
+ in Found; none otherwise.
67
+ - **Slot** (right-most), exactly one of three: the **panel toggle** (`panel-toggle`, `caret-up-small`,
68
+ `--icon-muted`) whenever the panel is open; the **clear ×** (`clear-button`, `x-small`,
69
+ `--text-secondary`) when the panel is closed and the input holds a query; the **magic-wand**
70
+ (`trailing-icon`, `--icon-brand`) when the panel is closed and the input is empty.
71
+ - **Status node** (`status`) — one visually hidden `role="status" aria-live="polite"` span; the only place
72
+ the search outcome is announced.
73
+ - **Panel** — an `AnchoredPanel` `role="listbox"` at trigger width, `md` rows:
74
+ - **Manual-entry row** (`manual-entry`) — a `ListRow variant="link"`, pinned in the panel header above
75
+ the results (on No match / no results it is the whole panel).
76
+ - **Group titles** — `Divider variant="line-label"` (`Nalezeno v kontaktech (N)` /
77
+ `Nalezeno v rejstříku (N)`, or `Vyberte ze svých kontaktů (N)` for an empty query), drawn only when
78
+ both sources matched or the query is empty; a plain `Divider` between two groups.
79
+ - **Result rows** (`option`) — `ListRow` with the subject name as label (the matched substring in
80
+ `font-semibold`) and a description: `IČO: … · DIČ: …` (numbers semibold) on every row, plus the
81
+ address as a second line on **registry rows only**. Missing identifiers are omitted, never
82
+ placeholdered.
83
+ - **„Dalších N“** (`show-more`) — `ListRow variant="link"` with a trailing `caret-down-small`, in the
84
+ panel footer outside the scroll region; drawn per group when `total` exceeds the items passed and
85
+ `onShowMore` is set.
86
+
87
+ ## Variants
88
+
89
+ <Canvas of={SubjectLookupFieldStories.Matrix} />
90
+
91
+ Two axes — **State × Panel**, **9 cells** (Default exists Closed only). The Matrix renders both statically:
92
+ `panelOpen` drives only the trigger (trailing caret vs wand / clear ×, `aria-expanded`), so no panel mounts.
93
+
94
+ <table>
95
+ <thead>
96
+ <tr><th>Axis</th><th>Values</th><th>In code</th></tr>
97
+ </thead>
98
+ <tbody>
99
+ <tr><td>State</td><td>Default · Focused (empty) · Searching · Found · No match</td><td>Derived at runtime from <code>query</code>, <code>loading</code>, <code>groups</code> and focus. The <code>state</code> prop (<code>default</code> · <code>focused</code> · <code>searching</code> · <code>found</code> · <code>no-match</code>) is a <strong>static override for stories and the verifier only</strong>.</td></tr>
100
+ <tr><td>Panel</td><td>Open · Closed</td><td>Follows the component's own open state (the input's <code>aria-expanded</code>). <code>panelOpen</code> is a static override of the trigger only — stories / verifier; it mounts no panel.</td></tr>
101
+ </tbody>
102
+ </table>
103
+
104
+ There is deliberately **no** Selected, Error or Success flow state: on pick the host swaps the field for
105
+ the subject summary card, and registry validation lives on the manual-entry TextFields. A **host form
106
+ error** (`error`, manifest 2.1.0 `properties[error]`, families `host-error`) is host-owned helper-line
107
+ content, **not a state of the flow axis** — it carries the host form's validation (e.g. a required
108
+ supplier) and takes the Text Field Error recipe: label and helper `--status-danger`, border
109
+ `--status-danger`, thickened to `--border-width-200` inside the shell while focused (`focus.errorFocus`,
110
+ never `--outline-focus`), the message replacing any `hint`, and the input `aria-invalid="true"` +
111
+ `aria-describedby` → helper. The trailing keeps the flow's glyphs — no warning-circle. It stays distinct
112
+ from No match, which is an outcome, not an error.
113
+
114
+ There is **no host-owned success**: **Found is the only success signal** (manifest 2.1.0). A host
115
+ verdict such as „Doplněno z rejstříku.“ goes on the neutral `helperText` line.
116
+
117
+ <Canvas of={SubjectLookupFieldStories.WithError} />
118
+
119
+ ## Sizes
120
+
121
+ <table>
122
+ <thead>
123
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Padding (X)</th><th>Gap</th><th style={{ textAlign: 'right' }}>Icon box</th><th style={{ textAlign: 'right' }}>Clear × / caret target</th><th>Radius</th><th>Panel rows</th></tr>
124
+ </thead>
125
+ <tbody>
126
+ <tr><td><code>md</code> (only)</td><td style={{ textAlign: 'right' }}>48</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td style={{ textAlign: 'right' }}>24 <code>--size-icon</code></td><td style={{ textAlign: 'right' }}>24 × 24</td><td><code>--radius-400</code></td><td><code>md</code> ListRows</td></tr>
127
+ </tbody>
128
+ </table>
129
+
130
+ **md (48) only** — the manifest has no other size, so there is no Sizes story and `size` accepts `'md'`
131
+ alone. Every live host is a full-width or near-full-width form field.
132
+
133
+ **Scroll cap.** The results run scrolls past **4 registry rows** (when a registry group is present) or
134
+ **5 contact rows**. The cap is a row count times the List Row Medium height, computed in CSS from the same
135
+ tokens the row is built from (`--space-400`, `--space-200`, `--font-size-base` × `--leading-relaxed`,
136
+ `--font-size-sm` × `--leading-loose`) — never a rounded pixel value — and clamped to the available panel
137
+ height. The manual-entry header and the „Dalších N“ footer sit outside it.
138
+
139
+ ## States
140
+
141
+ <Canvas of={SubjectLookupFieldStories.States} />
142
+
143
+ > **State is a FLOW, not a set of independent looks.** One search runs
144
+ > default → focused (empty) → searching → found | no-match. In the product the flow is derived; the canvas
145
+ > above forces each step statically with the data that step would really hold.
146
+
147
+ 1. **Default** — resting, closed. Border `--outline-default`, placeholder in `--text-placeholder`, the
148
+ `magic-wand` in the slot.
149
+ 2. **Focused (empty)** — the input has focus and nothing is typed; focusing **opens the panel on the saved
150
+ contacts** (`Vyberte ze svých kontaktů (N)`). Border swaps to `--outline-focus` (no ring). Panel open:
151
+ wand as the state glyph + caret toggle; panel closed: the wand alone in the slot.
152
+ 3. **Searching** — `loading` is set. The `spinner` turns as the state glyph, the input carries
153
+ `aria-busy="true"` and the status node reads `statusSearching`. Border `--outline-focus`. Set `loading`
154
+ on the first keystroke so one Searching state covers the debounce and the request. The spinner turns
155
+ once per `--duration-spin` on `--easing-linear` (`motion.loop`) and keeps turning under reduced motion.
156
+ 4. **Found** — a query with at least one non-empty group. The shell takes the Success border
157
+ (`--status-success-solid`, kept while the input holds focus), the `check-circle` is drawn **once on
158
+ mount** (`--duration-draw`, 0.8 s on today's scale; `motion-reduce:animate-none` shows the resting check) and the status node reads
159
+ `statusFound(N)`. The label takes the success ink **only when the component renders the label itself**
160
+ (`label` prop).
161
+ 5. **No match** — a query with no results. **No state glyph**, no red. Border `--outline-focus` while
162
+ focused, `--outline-default` once blurred. The panel is the single manual-entry line
163
+ (`noMatch(query)`, „… nenalezen, údaje zadám ručně“); the status node reads `statusNoMatch`.
164
+
165
+ <table>
166
+ <thead>
167
+ <tr><th>State</th><th>Border</th><th>State glyph</th><th>Slot · Panel open</th><th>Slot · Panel closed</th><th>Panel content</th></tr>
168
+ </thead>
169
+ <tbody>
170
+ <tr><td>Default</td><td><code>--outline-default</code></td><td>—</td><td><em>no Open cell</em></td><td><code>magic-wand</code> · <code>--icon-brand</code></td><td>—</td></tr>
171
+ <tr><td>Focused (empty)</td><td><code>--outline-focus</code></td><td><code>magic-wand</code> (open only)</td><td><code>caret-up-small</code> · <code>--icon-muted</code></td><td><code>magic-wand</code></td><td>saved contacts</td></tr>
172
+ <tr><td>Searching</td><td><code>--outline-focus</code></td><td><code>spinner</code> · <code>--text-secondary</code></td><td><code>caret-up-small</code></td><td>clear × · <code>--text-secondary</code></td><td>grouped results</td></tr>
173
+ <tr><td>Found</td><td><code>--status-success-solid</code></td><td><code>check-circle</code> · <code>--status-success-solid</code></td><td><code>caret-up-small</code></td><td>clear ×</td><td>grouped results</td></tr>
174
+ <tr><td>No match</td><td>focused <code>--outline-focus</code> · blurred <code>--outline-default</code></td><td>—</td><td><code>caret-up-small</code></td><td>clear ×</td><td>manual-entry line</td></tr>
175
+ </tbody>
176
+ </table>
177
+
178
+ ## Panel
179
+
180
+ <Canvas of={SubjectLookupFieldStories.Panel} />
181
+
182
+ Both sources matched: the manual-entry row pinned on top, contacts above registry under line-label titles
183
+ (contacts always come first, whatever order the host passes the groups in), „Dalších N“ rows in the footer
184
+ outside the scroll. Activating „Dalších N“ calls `onShowMore(source)` and the panel stays open. Result
185
+ names bold the **diacritics- and case-insensitive** match — `cesk` bolds „Česk“ in „Česká“ (exported as
186
+ `splitMatch`).
187
+
188
+ <Canvas of={SubjectLookupFieldStories.NoMatch} />
189
+
190
+ <Canvas of={SubjectLookupFieldStories.ShortQueryHint} />
191
+
192
+ A host that did not run the whole search — here the registry, skipped for a name under 3 characters —
193
+ passes `hint`. With no contact hit the flow stays Focused rather than No match: only the manual-entry row
194
+ (`manualEntry(query)`), the hint on the helper line and in the status node.
195
+
196
+ ### Below `sm` — bottom sheet
197
+
198
+ <Canvas of={SubjectLookupFieldStories.Mobile} />
199
+
200
+ Below `sm` the field is a read-only trigger (`role="combobox"` + `aria-haspopup="dialog"` + `aria-expanded`) that opens a
201
+ `BottomSheet`. The sheet's search input owns the combobox contract while it is open; result rows use the
202
+ `mobile` ListRow size; the manual-entry row moves to the sheet footer as a `role="button"` reached with
203
+ Tab. Open the story in the canvas — the docs column is wider than `sm`.
204
+
205
+ ## API
206
+
207
+ <Controls />
208
+
209
+ - **Required:** `query`, `onQueryChange`, `groups`, `onSelect`, `onManualEntry`, `labels`.
210
+ - **`labels`** — every string the component renders (`SubjectLookupFieldLabels`); it has no locale of its
211
+ own. Count strings are functions (`contactsGroup(n)`, `showMore(n)`, `statusFound(n)`, …).
212
+ - **`groups`** — `SubjectLookupGroup[]`; each group carries `source` (`'contacts'` or `'registry'`),
213
+ `items` (already capped by the host) and `total` (the full match count). For an empty query pass the saved contacts (browse).
214
+ - **`label`** — makes the component wrap its shell in `Field` itself. Prefer it over an outer `Field`: only
215
+ then does the Found label take the success ink — an outer `Field` cannot see the runtime flow.
216
+ - **`hint`** — a situational hint that pre-empts the search outcome, e.g. „Rejstřík se prohledá od 3 znaků“
217
+ while the host skips the registry for a short query (spec § Copy → Helper). While it is set and the
218
+ resolved query has no results, the flow stays **Focused** instead of No match: the panel shows only the
219
+ manual-entry row (`manualEntry(query)`, never `noMatch`), the shell keeps the focused look and the status
220
+ node announces the hint. It takes the helper line over from `helperText` (when `label` is set). Results
221
+ and Searching still win — it only replaces the No match outcome. Not a manifest axis.
222
+ - **`error`** — a host-owned error message on the helper line (`Field`'s `error`, with `label`), manifest
223
+ 2.1.0 `properties[error]`: label and helper take `--status-danger`, the input gets `aria-invalid="true"`
224
+ and `aria-describedby` on the helper, and the shell takes the Text Field Error border (`--status-danger`;
225
+ focus thickens it to `--border-width-200` inside the shell, never `--outline-focus` — `focus.errorFocus`),
226
+ e.g. „Dodavatel je povinný údaj“ from the host form's validation. It replaces `hint` and
227
+ `helperText` on the helper line and wins over Found's success border; the trailing keeps the flow's
228
+ glyphs. Not a flow state — `state` keeps its five values. Never registry validation: invalid IČO and
229
+ friends stay on the manual-entry TextFields.
230
+ - **No `success` prop** — Found is the only success signal (manifest 2.1.0). Put a host verdict such as
231
+ „Doplněno z rejstříku.“ on `helperText`.
232
+ - **Clear ×** calls `onQueryChange('')` and refocuses the input; the **host must cancel** its debounce /
233
+ in-flight request on an empty query.
234
+ - **Listbox name** — `panelLabelledBy` (id of visible text) wins; otherwise `panelLabel`, else `label`,
235
+ else `aria-label`. With none of them the component warns in development.
236
+ - **Static overrides (stories / verifier only):** `state`, `panelOpen`, `defaultOpen`. Leave them unset in
237
+ the product.
238
+ - `ref` forwards to the `<input>`.
239
+
240
+ ## Do / Don't
241
+
242
+ - ✅ Reach for it when the answer lives in **contacts or the registry** and picking it should **autofill the identity**.
243
+ - ✅ Pass `label` so the field wraps itself in `Field` and the Found label takes the success ink.
244
+ - ✅ Set `loading` on the first keystroke — one Searching state covers typing and fetching.
245
+ - ✅ Cancel the pending debounce / request when `onQueryChange('')` arrives from the clear ×.
246
+ - ✅ Keep **No match calm** — the ordinary focus border, value shown, the panel offers manual entry.
247
+ - ✅ On `onSelect`, **hand off to the summary card** and let the field collapse.
248
+ - ✅ Pass already-capped `groups` with the real `total`, so „Dalších N“ counts the rest.
249
+ - ❌ Don't use it for a plain type-to-narrow pick — that's **ComboboxField** / **Combobox**.
250
+ - ❌ Don't wrap it in an outer `Field` — the Found label then gets no success ink.
251
+ - ❌ Don't set `state`, `panelOpen` or `defaultOpen` in the product — they are static story / verifier overrides.
252
+ - ❌ Don't add a leading magnifier or a visible loading row; the trailing and the status node report the search.
253
+ - ❌ Don't turn No match red, add a warning glyph or shake the field.
254
+ - ❌ Don't add a Selected state or make the clear × clear a committed subject — that is the summary card's *Upravit údaje*.
255
+ - ❌ Don't put registry validation on the trigger — invalid IČO / verifying belong on the manual-entry TextFields.
256
+
257
+ ## Accessibility
258
+
259
+ - **Semantics** — a native `<input role="combobox" aria-autocomplete="list">` owning `aria-expanded`,
260
+ `aria-controls` (the panel id) and `aria-activedescendant` (the current row). The panel is
261
+ `role="listbox"`, named by `aria-labelledby` (`panelLabelledBy`) or `aria-label`; result rows are
262
+ `role="option"` with `aria-selected="false"`. Two-group panels wrap each group in `role="group"` labelled
263
+ by its title; the title dividers themselves are `aria-hidden`.
264
+ - **Keyboard** — typing searches · **↑ / ↓** move through one ring (wrapping): **manual entry first**, the
265
+ results in visual order, **„Dalších N“ last** · **Home / End** jump to the ends · **Enter** picks a result,
266
+ runs manual entry or „Dalších N“ · **Esc** closes the panel and keeps the query and focus in the input ·
267
+ **Tab** closes the panel and moves on — to the clear × when it is drawn. ↑ / ↓ on a closed panel open it.
268
+ - **Focus** — never leaves the input; rows are pointed at by `aria-activedescendant` and marked with the
269
+ ListRow highlight. The field shows focus by the border swap to `--outline-focus`, no additive ring. The
270
+ clear × is a real `<button>` in the Tab order with a `focus-visible` ring (`--outline-focus`); the caret
271
+ toggle is a `<button tabindex="-1">` with `aria-controls`, and pressing either keeps focus in the input.
272
+ - **Screen reader** — one `role="status" aria-live="polite"` node announces `statusSearching` →
273
+ `statusFound(N)` | `statusNoMatch`; the panel adds no second live region. While the bottom sheet is open
274
+ the node moves into the sheet footer, because the sheet makes the page behind inert. The wand, spinner
275
+ and check-circle are `aria-hidden="true"`; the clear × and the toggle are named by `labels.clear` /
276
+ `labels.hidePanel`.
277
+ - **Bottom sheet (below `sm`)** — the field becomes a `readOnly` combobox with `aria-haspopup="dialog"`; focus starts
278
+ in the sheet search (`role="combobox"`, named by the sheet title) and returns to the field on close. The
279
+ manual-entry action is a footer `role="button"` outside the ↑/↓ ring, activated by Enter / Space.
280
+ For the sheet's visually hidden close button, its name is the optional `sheetCloseLabel` (default «Zavřít»), which an app with more than one language version passes from its translations on every use; the full list of such props is in [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
281
+ - **Target** — the clear × and the caret toggle are each a full 24 × 24 icon box (WCAG 2.5.8).
282
+ - **Contrast & motion** — Found binds `--status-success-solid` on the check and border, the label
283
+ `--status-success-tint-foreground`. The idle wand's `--icon-brand` is an **accepted spec exception**
284
+ (decorative; the floating label carries the purpose). The Found draw honours `prefers-reduced-motion`;
285
+ the **spinner keeps turning** under reduced motion — it is the only visual sign of the request.
286
+
287
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
288
+
289
+ ## Copy
290
+
291
+ Voice: the Text Field field-copy voice holds unchanged — impersonal and neutral, clear over clever,
292
+ concise, specific and helpful, consistent terminology. Examples are Czech; the rules apply to every
293
+ language version, and lengths are guidance. Every string reaches the component through `labels`,
294
+ `label`, `placeholder` or `sheetCloseLabel`; the texts the panel renders (manual-entry row, group
295
+ titles, „Dalších N“, the no-match line) are canonical in `spec/06-patterns/popover-patterns.md`
296
+ § Subject Lookup.
297
+
298
+ - **Label** (`label`) — the subject role as a noun, sentence case, no colon: *Odběratel* or
299
+ *Dodavatel*, the same word the surrounding form and the summary card use. 1–2 words. Single line,
300
+ truncates, max 24 characters.
301
+ - **Value** — the user's own query: a name fragment or an IČO, nothing the component writes. Single
302
+ line; the input scrolls horizontally, no ellipsis. A committed subject name never appears here.
303
+ - **Placeholder** (`placeholder`) — the empty-state prompt naming both ways in, by name and by
304
+ identifier: *Zadejte jméno, název nebo IČO…*, the same prompt as ComboboxField. Do not shorten it
305
+ to a bare verb, repeat the label or turn it into a plea. Shown in Default and Focused (empty) only.
306
+ Single line, truncates, max 40 characters.
307
+ - **Sheet close label** (`sheetCloseLabel`, optional) — the accessible name of the visually hidden
308
+ close button of the bottom sheet below `sm`, default «Zavřít»; an app with more than one language
309
+ version passes it from its translations on every use. Never shown on desktop. Single line,
310
+ truncates, max 20 characters.
311
+
312
+ The two trailing buttons carry accessible names only, never visible text, and the **helper** is off
313
+ by default — the flow's states never use it. A host that switches it on writes a plain persistent
314
+ hint in the Text Field helper voice, never a search outcome (that outcome is the panel's job,
315
+ announced through the status node).
316
+
317
+ <table>
318
+ <thead>
319
+ <tr><th>Run</th><th>Prop</th><th>✅ Canonical</th><th>❌ Not</th></tr>
320
+ </thead>
321
+ <tbody>
322
+ <tr><td>Label</td><td><code>label</code></td><td>Odběratel · Dodavatel</td><td>Zadejte odběratele:</td></tr>
323
+ <tr><td>Placeholder</td><td><code>placeholder</code></td><td>Zadejte jméno, název nebo IČO…</td><td>Vyhledejte… · Odběratel · Zadejte prosím název firmy</td></tr>
324
+ <tr><td>Clear × name</td><td><code>labels.clear</code></td><td>Vymazat hledání</td><td>—</td></tr>
325
+ <tr><td>Panel toggle name</td><td><code>labels.hidePanel</code></td><td>Skrýt výsledky</td><td>—</td></tr>
326
+ <tr><td>Sheet close label</td><td><code>sheetCloseLabel</code></td><td>Zavřít (default)</td><td>—</td></tr>
327
+ <tr><td>Helper</td><td><code>helperText</code></td><td>Najdete v obchodním rejstříku</td><td>Nenašli jsme nic — zkuste to znovu</td></tr>
328
+ </tbody>
329
+ </table>
330
+
331
+ ## Usage
332
+
333
+ ```tsx
334
+ // Good — the host owns the data; the component owns the flow
335
+ <SubjectLookupField
336
+ label="Dodavatel"
337
+ placeholder="Zadejte jméno, název nebo IČO…"
338
+ query={query}
339
+ onQueryChange={setQuery} // '' from the clear × → cancel the request
340
+ groups={groups} // contacts + registry, already capped, with real totals
341
+ loading={isSearching} // true from the first keystroke
342
+ onSelect={subject => showSummaryCard(subject)}
343
+ onManualEntry={openManualFields}
344
+ onShowMore={source => loadMore(source)}
345
+ labels={labels} // from the translation layer — no defaults
346
+ />
347
+
348
+ // Don't — an outer Field cannot see the flow, so Found gets no success label ink
349
+ <Field label="Dodavatel">
350
+ <SubjectLookupField query={query} onQueryChange={setQuery} groups={groups} labels={labels} onSelect={pick} onManualEntry={manual} />
351
+ </Field>
352
+
353
+ // Don't — `state` / `panelOpen` are static story overrides
354
+ <SubjectLookupField state="found" panelOpen query={query} onQueryChange={setQuery} groups={groups} labels={labels} onSelect={pick} onManualEntry={manual} />
355
+ ```
356
+
357
+ ## Related
358
+
359
+ - **TextField** — the shell this trigger reuses (`textFieldShellVariants` / `textFieldValueVariants`).
360
+ - **Field** — the floating label / helper wrapper the component applies itself when `label` is set.
361
+ - **ComboboxField** / **Combobox** — the generic type-to-narrow trigger and organism, without registry
362
+ autofill; Combobox is the composition model this panel follows.
363
+ - **AnchoredPanel** — anchoring, dismissal and the virtual-focus listbox of the panel.
364
+ - **ListRow** — manual-entry, result and „Dalších N“ rows.
365
+ - **Divider** — group titles and the rule between groups.
366
+ - **BottomSheet** (internal) — the panel below `sm`.
367
+ - Spec: `spec/04-molecules/subject-lookup-field.md` · `spec/06-patterns/popover-patterns.md` § Subject Lookup
368
+
369
+ ## Migration notes
370
+
371
+ From the spec § Migration:
372
+
373
+ - **Manifest 2.2.1 → 2.3.0 (2026-11-17).** `motion.enter.duration` is `--duration-draw`, the new duration token for a glyph that draws itself once (800 ms); it replaces the `calc(var(--duration-normal) * 4)` multiplier. No visual change.
374
+ - **Manifest 2.2.0 → 2.2.1 (2026-11-13).** `motion.enter.duration` is `calc(var(--duration-normal) * 4)`: the Found draw is derived from the duration scale instead of a raw 0.8 s, with no token of its own for one use; the `gaps` entry is closed. No visual change.
375
+ - **Manifest 2.1.1 → 2.2.0 (2026-11-13).** Optional code-only `text.sheet-close-label` → `sheetCloseLabel`: the name of the hidden close button of the mobile bottom sheet, default «Zavřít». An app with more language versions passes it from its translations.
376
+ - **Manifest 2.1.0 → 2.1.1 — motion audit (2026-11-03).** `motion.loop` binds the spinner to `--duration-spin` + `--easing-linear` (it ran Tailwind's stock 1 s) — now one shared `animate-spin` (ui-system 0.17.0), no component change. The panel toggle (`caret-up-small`) stays a collapse button that exists only while the panel is open — it is not an open / closed caret and does not rotate. The Found draw is restated as ordered phases without raw seconds; the code keeps its 0.8 s timeline (duration recorded in the spec as a `gaps` entry).
377
+ - **Combobox Field (`spec/04-molecules/combobox-field.md`) stays the generic trigger.** Anything that needs type-to-narrow **without** registry autofill and without the collapse-to-card outcome stays on it; it keeps its caret-driven trailing, its Size axis and its Selected clear `×`. Moving a field between the two is a component swap, not a prop change — the axes do not line up.
378
+ - **Registry-validation states are not migrated onto this field.** The invalid-IČO / verifying / verified / retry states live on the **manual-entry Text Fields** the escape hatch opens, where a field autofilled from the registry carries the standard Text Field success state with the helper `Doplněno z rejstříku.` (`spec/06-patterns/popover-patterns.md` § Subject Lookup).